> >JDK1.4's javadoc tool prints warnings when it encounters unknown @tags. > >You have to list all your non-standard tags with -tag option, if you > >don't want to get lost in the noise of those warnings. But -tag >receives > >a : separated list of tags! So we can't list are namespace:tagname tags > >with this option!! And actually Sun recommends dotted notation. So > >hereafter dotted notation is supported and if you're using JDK1.4 I > >recommend you to use the dotted notation. > > Presumably, this won't be an issue once we switch to xjavadoc. However, > if > Sun recommend the dotted notation, are we going to continue recommending > it > also, even then?
It's still an issue even for xjavadoc. You're going to use javadoc.exe to generate docs from your source code, right? Do you want to drawn in the "unknown tag" noise? No, so you'd better use the dotted syntax if one day you're going to use JDK1.4's javadoc tool. So to make it clear: @namespace.tag is the recommended syntax for users, but you write your template files with the old namespace:tag syntax so that the old syntax is also supported. Andrew, please make it item #1 in 1.1.2's changes.txt. Ara. _________________________________________________________ Do You Yahoo!? Get your free @yahoo.com address at http://mail.yahoo.com _______________________________________________ Xdoclet-devel mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/xdoclet-devel
