[ https://issues.apache.org/jira/browse/LUCENE-1051?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Michael Busch updated LUCENE-1051: ---------------------------------- Attachment: lucene-1051-take2.patch Some small improvements: - Moved property "javadoc.link" to common-build.xml, so that the link is available in the contrib javadocs as well. - Linked the core, demo, and contrib javadocs with the combined javadocs, which makes these javadocs much nicer. - The combined javadocs now go into the same directory as before, so bookmarks will still work after we applied this patch. I also updated the preview. > Separate javadocs for core and contribs > --------------------------------------- > > Key: LUCENE-1051 > URL: https://issues.apache.org/jira/browse/LUCENE-1051 > Project: Lucene - Java > Issue Type: Improvement > Components: Javadocs > Reporter: Michael Busch > Assignee: Michael Busch > Priority: Minor > Fix For: 2.3 > > Attachments: lucene-1051-take2.patch, lucene-1051.patch > > > A while ago we had a discussion on java-dev about separating the javadocs > for the contrib modules instead of having only one big javadoc containing > the core and contrib classes. > This patch: > - Adds new targets to build.xml: > - "javadocs-all" Generates Javadocs for the core, demo, and contrib > classes > - "javadocs-core" Generates Javadocs for the core classes > - "javadocs-demo" Generates Javadocs for the demo classes > - "javadocs-contrib" Using contrib-crawl it generates the Javadocs for > all contrib modules, except "similarity" (currently empty) and gdata. > - Adds submenues to the Javadocs link on the Lucene site with links to > the different javadocs > - Includes the javadocs in the maven artifacts > Remarks: > - I removed the ant target "javadocs-internal", because I didn't want to > add corresponding targets for all new javadocs target. Instead I > defined a new property "javadoc.access", so now > "ant -Djavadoc.access=package" can be used in combination with any of > the javadocs targets. Is this ok? > - I didn't include gdata (yet) because it uses build files that don't > extend Lucenes standard build files. > > Here's a preview: > http://people.apache.org/~buschmi/site-preview/index.html > Please let me know what you think about these changes! -- This message is automatically generated by JIRA. - You can reply to this email to add a comment to the issue online. --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]