Skip to content
This repository was archived by the owner on May 12, 2021. It is now read-only.

Generate Perl POD from public methods#18

Merged
asfgit merged 18 commits intoapache:masterfrom
nwellnhof:perl_pod
Aug 30, 2015
Merged

Generate Perl POD from public methods#18
asfgit merged 18 commits intoapache:masterfrom
nwellnhof:perl_pod

Conversation

@nwellnhof
Copy link
Contributor

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.

All public Analyzer methods are now documented in the Perl API:

- Transform
- TransformText
- Split
- Load
- Dump
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.
Methods that weren't documented in the Perl bindings are made private.
Methods that weren't documented in the Perl bindings are made private.
Document FieldType setters in Perl bindings. Other Methods that weren't
documented are made private.
Methods that weren't documented in the Perl bindings are made private.
Methods that weren't documented in the Perl bindings are made private.
Needed for C bindings.
The Inverter parameter isn't public.
RangeCompiler isn't public.
The DocVector parameter isn't public.
@asfgit asfgit merged commit 181ed13 into apache:master Aug 30, 2015
asfgit pushed a commit that referenced this pull request Aug 30, 2015
@nwellnhof nwellnhof deleted the perl_pod branch August 30, 2015 17:29
@asfbot
Copy link

asfbot commented Sep 9, 2015

Marvin Humphrey on dev@lucy.apache.org replies:

I reviewed a diff of the generated POD before and after merging this branch
(and the corresponding Clownfish branch). A summary of the changes is below my
sig.

Unsurprisingly for a change of this magnitude, there were a few glitches.
These are the ones I think we should to attend to:

  • Restore documentation for several methods IndexSearcher inherits
    from Searcher. Same with PolySearcher (though it's a less important
    class).
  • Restore Doc#add_fields.
  • IndexReader#offsets became IndexReader#_offsets and should be restored.
  • The PostingList methods Next, Advance, and Get_Doc_ID should become
    public.
  • Restore BitCollector#collect
  • Restore ANDQuery#add_child and ORQuery#add_child.

Marvin Humphrey

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants