GitHub user nwellnhof opened a pull request:
https://github.com/apache/lucy/pull/18
Generate Perl POD from public methods
The Clownfish branch `perl_pod` adds POD for public novel methods by
default, making it possible to remove the POD "whitelists".
This branch also adds Perl documentation for Analyzer, Inversion, and
Token, which is needed to write custom analyzers. It also removes documentation
for some methods taking private classes as parameters.
You can merge this pull request into a Git repository by running:
$ git pull https://github.com/nwellnhof/lucy perl_pod
Alternatively you can review and apply these changes as the patch at:
https://github.com/apache/lucy/pull/18.patch
To close this pull request, make a commit to your master/trunk branch
with (at least) the following in the commit message:
This closes #18
----
commit e4ecf75b1808c7d87fd738c21ac33d12fffa93d1
Author: Nick Wellnhofer <[email protected]>
Date: 2015-08-20T19:08:11Z
Make Serialize/Deserialize methods private
commit ebe182155189ef4e7a6cbc4010d0b6c2281d9065
Author: Nick Wellnhofer <[email protected]>
Date: 2015-08-20T18:51:14Z
Remove Analysis POD whitelist
All public Analyzer methods are now documented in the Perl API:
- Transform
- TransformText
- Split
- Load
- Dump
commit c198e10f3e492d18b2ba5ae2e312095f81119d6e
Author: Nick Wellnhofer <[email protected]>
Date: 2015-08-20T18:57:25Z
Remove Highlighter POD whitelist
commit 753300094f6a70c998318712d61608477fad0156
Author: Nick Wellnhofer <[email protected]>
Date: 2015-08-20T19:49:13Z
Remove Document POD whitelist
Additional Document methods added to the Perl API:
- Store
- Get_Size
- Extract
- Field_Names
These methods are needed for the C bindings but they aren't really
useful from Perl. They can be blacklisted later.
commit 21252a9dbe50f0df5ea4c1cc95a88516b3a28df6
Author: Nick Wellnhofer <[email protected]>
Date: 2015-08-20T20:31:03Z
Remove Index POD whitelist
Methods that weren't documented in the Perl bindings are made private.
commit 8323f974e3811c44facfd5fed4756ed63b9631dd
Author: Nick Wellnhofer <[email protected]>
Date: 2015-08-20T20:34:58Z
Remove Object POD whitelist
Methods that weren't documented in the Perl bindings are made private.
commit 9a3a96c12b6626483e8e090920763799421b2829
Author: Nick Wellnhofer <[email protected]>
Date: 2015-08-20T20:55:52Z
Remove Plan POD whitelist
Document FieldType setters in Perl bindings. Other Methods that weren't
documented are made private.
commit 345fa59440213c049528efdfc1910d80d4dfd8a3
Author: Nick Wellnhofer <[email protected]>
Date: 2015-08-23T11:04:19Z
Remove Search POD whitelist
Methods that weren't documented in the Perl bindings are made private.
commit 920a7dd81912ad6240d60a5e62ba2f87add9ecf9
Author: Nick Wellnhofer <[email protected]>
Date: 2015-08-23T11:36:33Z
Remove Store POD whitelist
Methods that weren't documented in the Perl bindings are made private.
commit fb6e42a79f6f5e6b5cb77d53d71ed8af481f6fbd
Author: Nick Wellnhofer <[email protected]>
Date: 2015-08-23T11:38:19Z
Remove Simple POD whitelist
commit 3e6b05ef81759581d822be4b26733f5149f58368
Author: Nick Wellnhofer <[email protected]>
Date: 2015-08-23T11:58:41Z
Remove LucyX POD whitelist
commit c6682c67a825b23f862c53880668e770bb13707c
Author: Nick Wellnhofer <[email protected]>
Date: 2015-08-23T13:00:03Z
Create Perl POD for Inversion
commit 04f1edf807ef11af0d956135042c8a6899bd98e0
Author: Nick Wellnhofer <[email protected]>
Date: 2015-08-23T13:46:14Z
Make I32Array public
Needed for C bindings.
commit 06b46a0dff6aaf224b6a2afe25181caefcfbc0c4
Author: Nick Wellnhofer <[email protected]>
Date: 2015-08-23T13:46:47Z
Make DataWriter_Add_Inverted_Doc private
The Inverter parameter isn't public.
commit f50a2fd58c864c926b07aaddb382fff68f0ae84a
Author: Nick Wellnhofer <[email protected]>
Date: 2015-08-23T13:47:52Z
Return Compiler instead of RangeCompiler
RangeCompiler isn't public.
commit 0e31a39d017060da75325ea05f8760545d3b69f9
Author: Nick Wellnhofer <[email protected]>
Date: 2015-08-23T13:48:56Z
Make Compiler_Highlight_Spans private
The DocVector parameter isn't public.
commit e3d1047fd399a2fb79995d37b26bc2817e27719e
Author: Nick Wellnhofer <[email protected]>
Date: 2015-08-25T10:07:28Z
Make Lucy::Analysis::Token public
commit 181ed13f0cb03ac8e7b9a9f59ab018bceb1cb086
Author: Nick Wellnhofer <[email protected]>
Date: 2015-08-25T10:16:04Z
Remove links to private classes
----
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at [email protected] or file a JIRA ticket
with INFRA.
---
