[aspectj-users] __AJDECLID in docs produced by ajdoc and a couple of oth

["Antti Karanta" <antti.karanta@xxxxxxx>]

                             Hi!

  When I generate documentation w/ ajdoc, the generated html files
contain something like this for each documented entity (class, field,
method) whether or not it is affected by an aspect: __AJDECLID:21:__,
here's an example method doc:

isEmpty(java.lang.String s) 
          __AJDECLID:135:__ Returns true if string is null, of zero
length or consists only of whitespace.



  Is this a bug, a feature, or me missing something?



  Here's info about my environment:

D:\work\napa\jnapa\commons\utils>ajdoc -v
ajdoc version 1.5.0

D:\work\napa\jnapa\commons\utils>ajc -v
AspectJ Compiler 1.5.0 built on Tuesday Dec 20, 2005 at 12:05:54 GMT

D:\work\napa\jnapa\commons\utils>java -version
java version "1.5.0_06"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_06-b05)
Java HotSpot(TM) Client VM (build 1.5.0_06-b05, mixed mode, sharing)

OS: win xp pro sp 2



  Here's the command I used to generate docs:

ajdoc.bat -source 1.5 -d D:\work\napa\jnapa\commons\utils\build\doc
-author -package -argfile
D:\work\napa\jnapa\commons\utils\jnapafilelist26974.lst

  and here's contents of the argfile:

D:\work\napa\jnapa\commons\utils\src\fi\napa\util\CollectionUtils.java
D:\work\napa\jnapa\commons\utils\src\fi\napa\util\Converter.java
D:\work\napa\jnapa\commons\utils\src\fi\napa\util\MapComparator.java
D:\work\napa\jnapa\commons\utils\src\fi\napa\util\PiledMap.java
D:\work\napa\jnapa\commons\utils\src\fi\napa\util\RecursiveMap.java
D:\work\napa\jnapa\commons\utils\src\fi\napa\util\StringArrayIterator.ja
va
D:\work\napa\jnapa\commons\utils\src\fi\napa\util\StringUtils.java
D:\work\napa\jnapa\commons\utils\src\fi\napa\util\aspects\ArgumentCheckA
spect.aj
D:\work\napa\jnapa\commons\utils\src\fi\napa\util\aspects\CachingAspect.
aj
D:\work\napa\jnapa\commons\utils\src\fi\napa\util\aspects\OnceAspect.aj


  Any help will be greatly appreciated. Thanks.


  BTW, is there going to be an ajdoc ant task?

  Also, the ajdoc documentation in the devguide says: "The ajdoc
implementation builds on Sun's javadoc command line tool, and you use it
in the same way with many of the same options (javadoc options are not
documented here; for more information on javadoc usage, see the Javadoc
homepage.)"
  Where can I find what these "many of the same options as javadoc" are?
I wouldn't like to go for trial and error - I already discovered that
e.g. -use -windowtitle and -bottom are not supported, but it would be
easier to just see a list of the supported options.



        -Antti-