rlalfo / google-http-java-client

Automatically exported from code.google.com/p/google-http-java-client
0 stars 0 forks source link

Doclava #130

Open GoogleCodeExporter opened 9 years ago

GoogleCodeExporter commented 9 years ago
See:
http://code.google.com/p/doclava/

It is the doclet that Android and Guide use:
http://developer.android.com/reference/packages.html
http://google-guice.googlecode.com/git/javadoc/packages.html

Compare it to our JavaDoc:
http://javadoc.google-http-java-client.googlecode.com/hg/1.10.2-beta/index.html

Coolest feature is probably the search feature.

Setup instructions:
http://code.google.com/p/doclava/wiki/GettingStarted#Using_Doclava_with_Maven

However, they don't support @since tag:
http://code.google.com/p/doclava/wiki/JavadocTags

Instead, they are using a different approach of "Filter by API Level".  The 
trick appears to be to use the "-apixml" option to generate an XML file that 
describes each version of "API level".

Example from Guice:
http://google-guice.googlecode.com/git/build.xml

Thus, the command-line args for doclava would look something like:

doclava ... -since apis/1.1.0-beta.xml 1.1.0-beta -since apis/1.2.0-beta.xml 
1.2.0-beta ... -apiversion 1.10.0-beta

Original issue reported on code.google.com by yan...@google.com on 16 Jun 2012 at 5:32

GoogleCodeExporter commented 9 years ago

Original comment by yan...@google.com on 2 Aug 2012 at 2:28

GoogleCodeExporter commented 9 years ago

Original comment by rmis...@google.com on 14 Jan 2013 at 3:26

GoogleCodeExporter commented 9 years ago

Original comment by yan...@google.com on 14 Jan 2013 at 4:03

GoogleCodeExporter commented 9 years ago

Original comment by ai...@google.com on 29 Jul 2013 at 5:34