Export to GitHub

doclava - issue #63

Document how to use -since command line argument


Posted on Aug 28, 2013 by Grumpy Dog

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.

Status: New

Labels:
Type-Defect Priority-Medium