k4zy / doclava

Automatically exported from code.google.com/p/doclava
Apache License 2.0
0 stars 0 forks source link

Document how to use -since command line argument #63

Open GoogleCodeExporter opened 8 years ago

GoogleCodeExporter commented 8 years ago
The -since command line argument takes version.xml and name parameters.  How do 
you create a version.xml file?  Considering @since is not currently supported 
we need a way to provide information about when API features have been added. 

I have looked at source and SinceTagger class seems to be the class used 
whereby the parameters match the -since command line argument, but no 
description on how to create the required xml file.  The 
SinceTagger.addVersion() method implies that the XML file is generated from 
ApiCheck, but I cannot get that class to generate anything.  ApiCheck seems to 
want 2 parameters related to error levels, but all I get is 'Exception in 
thread "main" java.lang.IndexOutOfBoundsException: Index: 0, Size: 0' when I 
seem to get the parameters types correct.  

I see that android api ref has 'Added in API level X' and Google Guice has 
'Since: API Level X' and an added 'Filter by API level:' features. 

There are some requests on StackOverflow but I have yet to see an answer.  

Original issue reported on code.google.com by jdONeill...@gmail.com on 28 Aug 2013 at 1:51