Recent changes to bugs

does not build with Sun Java 1.5

2007-04-19T23:38:56Z

Hi,

I am getting the following errors:

[javac] /home/twerner/debian/tarballs/pdfdoclet-1.0.2/src/main/com/tarsec/javadoc/pdfdoclet/filter/FilteredClassDoc.java:27: com.tarsec.javadoc.pdfdoclet.filter.FilteredClassDoc is not abstract and does not override abstract method enumConstants() in com.sun.javadoc.ClassDoc
[javac] public class FilteredClassDoc implements ClassDoc {
[javac] ^
[javac] /home/twerner/debian/tarballs/pdfdoclet-1.0.2/src/main/com/tarsec/javadoc/pdfdoclet/filter/FilteredPackageDoc.java:23: com.tarsec.javadoc.pdfdoclet.filter.FilteredPackageDoc is not abstract and does not override abstract method annotations() in com.sun.javadoc.PackageDoc
[javac] public class FilteredPackageDoc implements PackageDoc {
[javac] ^
[javac] /home/twerner/debian/tarballs/pdfdoclet-1.0.2/src/main/com/tarsec/javadoc/pdfdoclet/filter/FilteredRootDoc.java:25: com.tarsec.javadoc.pdfdoclet.filter.FilteredRootDoc is not abstract and does not override abstract method isAnnotationType() in com.sun.javadoc.Doc
[javac] public class FilteredRootDoc implements RootDoc {
[javac] ^

add support for

2006-12-14T18:51:40Z Please add support for <tt> as well as <code>.

filter tags allow inherited items regardless 2006-12-14T18:30:19Z Using filter tags allows classes, methods etc to be marked for inclusion, which is useful for creating synoptic documents. However, the output includes inherited items even though they are not tagged with a filter tag. Untagged inherited items should not be present in the output document. size for images tag 2006-09-14T10:18:41Z I have noticed that if you don't specify the size of an image (<img width="" height="" ...>), pdfDoclet will expand it to the size of the page, what is sometimes not very good. Just specifying the real size of the image in the <img> tag the problem is solved. But I consider it would be better that pdfDoclet could automatically get the image size (if not specified in the tag) misplaced image in overview.html & package.html 2006-09-14T10:11:20Z The problem is that sometimes some of the images are misplaced. It occurs when a image appears at the end of the page, and the application put some lines that should be after the image before it. I will try to ilustrate it with an example, it should be: "This is image 1" ---- end of page --- [IMG1] "This is image 2" [IMG2] but it is "translated" in something like this: "This is image 1" "This is image 2" ---- end of page --- [IMG1] [IMG2] Qualified package names missing 2006-08-07T01:52:44Z Currently, JavadocUtil does not correctly detect when qualified package names are necessary. Basically, whenever hyperlinks are not used and a referenced class is in a different package to the current class, the qualified package name should be rendered. The current logic does not detect the conditions correctly. The attached patch gives some guidance for better logic (i.e., works for me...). Note that the correct logic requires that PDFDoclet be patched to honour the "create.links" configuration properly. This is implied by "Configuration.hyperlinks" in the attached patch. create.index missing from documentation 2006-05-04T15:37:04Z The create.index property is missing from http:// pdfdoclet.sourceforge.net/configuration.html Custom tags are ignored 2006-05-04T15:27:16Z In PDFDoclet 1.0.1, custom tags are only processed for the class description---they aren't processed for field or method descriptions! (See also the mailing list query <http://sourceforge.net/forum/forum.php? thread_id=1322280&forum_id=185314>). There is a bug in TagLists.java's clearTagsFromList(String[]) where there is this series of comparisons: (names[i].equals(DOC_TAG_EXCEPTION) == false && names[i].equals(DOC_TAG_RETURN) == false ... && names[i].equals(DOC_TAG_PARAM) ) The fault is that the last comparison should be names[i].equals(DOC_TAG_PARAM) == false Thanks. Many config params not recognised in the command-line 2006-05-04T15:04:03Z The documentation for PDFDoclet states: "All other configuration values can be specified as an argument or in a property file." This is *not* the case. For instance, ARG_FILTER, ARG_LB_TAGS_PREFIX, etc, are not used in PDFDoclet.java. When using PDFDoclet with Ant, it is helpful to be able to pass configuration parameters using the syntax of: <doclet> <param .../> </doclet> This requires that configuration be possible via the command-line as claimed in the PDFDoclet documentation. create.links does not work, class derivation tree fails 2006-05-04T14:57:40Z With pdfdoclet 1.0.1, the default is create.links=yes. My understanding is that create.links=no disable PDF hyperlinks. However, setting create.links=no does /not/ disable the creation of PDF hyperlinks. Additionally, it causes the class names in every class's derivation tree to be blanked out. Observations: - Some areas of the code are directly checking ARGS_CREATE_LINKS instead of using Configuration.isLinksCreationActive() - When isLinksCreationActive()==false, various destinations are set to null or the empty string "", which causes the class derivation trees to fail. - To achieve the desired result with create.links=yes, I hacked up my own patch. I created a new variable create.hyperlinks and it is only used within LinkPhrase.java. Specifically, it is used for (a) the purpose of determining font style in the LinkPhrase constructors, (b) sets destination=null in LinkPhrase.init(...) but is NOT used to set destination="" in the LinkPhrase constructors. Hopefully this gives some guidance for your repairs.