You are viewing a plain text version of this content. The canonical link for it is here.
Posted to derby-dev@db.apache.org by "Rick Hillegas (JIRA)" <ji...@apache.org> on 2008/04/03 19:30:26 UTC
[jira] Created: (DERBY-3592) The Java 5 javadoc tool generates a
spurious output line when digesting the doctitle element for the public api
The Java 5 javadoc tool generates a spurious output line when digesting the doctitle element for the public api
---------------------------------------------------------------------------------------------------------------
Key: DERBY-3592
URL: https://issues.apache.org/jira/browse/DERBY-3592
Project: Derby
Issue Type: Bug
Components: Javadoc
Affects Versions: 10.4.1.0
Reporter: Rick Hillegas
Assignee: Rick Hillegas
The Java 5 javadoc tool seems to have a bug. This bug seems to be fixed in Java 6. The issue is discussed in the following email thread: http://www.nabble.com/some-comments-on-the-10.4-beta-distribution-td16408536.html#a16408536 which puts forward the following theory:
"The exact same javadoc directive is used to build the jdbc3 and jdbc4 public apis. The spurious line turns up in the jdbc3 javadoc but not the jdbc4 javadoc. The jdbc3 javadoc is built with the Java 5 javadoc tool and the jdbc4 javadoc is built with the Java 6 javadoc tool. I think that the Java 5 javadoc tool may have a bug that was corrected in Java 6.
What we're trying to do in this <doctitle> element is a bit tricky. We are trying to generate javadoc whose overview page has a title consisting of the Derby logo followed by some useful text. The <doctitle> element does not allow nested image elements, and we appear to have hacked around this by stuffing the image and text into a CDATA section. That CDATA section survives the Java 6 javadoc tool but is munged by the Java 5 javadoc tool.
I can get rid of the spurious line at the cost of removing the Derby logo. That is, I get rid of the CDATA section and just put text inside the <doctitle> element like so:
<Doctitle> Apache Derby ${major}.${minor} API Documentation</Doctitle>
I miss the pretty logo, but I think that the output without the logo looks better than the output with both the logo and the spurious line."
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Assigned: (DERBY-3592) The Java 5 javadoc tool generates a
spurious output line when digesting the doctitle element for the public api
Posted by "Rick Hillegas (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-3592?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Rick Hillegas reassigned DERBY-3592:
------------------------------------
Assignee: (was: Rick Hillegas)
I am unassigning myself from this issue. I think the current behavior is better than the behavior in the beta. But if someone else would like to improve on this, they are welcome to.
> The Java 5 javadoc tool generates a spurious output line when digesting the doctitle element for the public api
> ---------------------------------------------------------------------------------------------------------------
>
> Key: DERBY-3592
> URL: https://issues.apache.org/jira/browse/DERBY-3592
> Project: Derby
> Issue Type: Bug
> Components: Javadoc
> Affects Versions: 10.4.1.0
> Reporter: Rick Hillegas
> Attachments: derby-3592-01-removeImgTag.diff
>
>
> The Java 5 javadoc tool seems to have a bug. This bug seems to be fixed in Java 6. The issue is discussed in the following email thread: http://www.nabble.com/some-comments-on-the-10.4-beta-distribution-td16408536.html#a16408536 which puts forward the following theory:
> "The exact same javadoc directive is used to build the jdbc3 and jdbc4 public apis. The spurious line turns up in the jdbc3 javadoc but not the jdbc4 javadoc. The jdbc3 javadoc is built with the Java 5 javadoc tool and the jdbc4 javadoc is built with the Java 6 javadoc tool. I think that the Java 5 javadoc tool may have a bug that was corrected in Java 6.
> What we're trying to do in this <doctitle> element is a bit tricky. We are trying to generate javadoc whose overview page has a title consisting of the Derby logo followed by some useful text. The <doctitle> element does not allow nested image elements, and we appear to have hacked around this by stuffing the image and text into a CDATA section. That CDATA section survives the Java 6 javadoc tool but is munged by the Java 5 javadoc tool.
> I can get rid of the spurious line at the cost of removing the Derby logo. That is, I get rid of the CDATA section and just put text inside the <doctitle> element like so:
> <Doctitle> Apache Derby ${major}.${minor} API Documentation</Doctitle>
> I miss the pretty logo, but I think that the output without the logo looks better than the output with both the logo and the spurious line."
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Reopened: (DERBY-3592) The Java 5 javadoc tool generates a
spurious output line when digesting the doctitle element for the public api
Posted by "Daniel John Debrunner (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-3592?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Daniel John Debrunner reopened DERBY-3592:
------------------------------------------
I'm not sure this is a valid approach without some more investigation.
The nightly builds of the javadoc do not seem to have any problem for the jdbc 3 pages so could this not be a problem specific to the environment used to create the beta?
Or is is a bug on some specific jdk release?
I added the logo and never saw any problems with generation of the pages.
> The Java 5 javadoc tool generates a spurious output line when digesting the doctitle element for the public api
> ---------------------------------------------------------------------------------------------------------------
>
> Key: DERBY-3592
> URL: https://issues.apache.org/jira/browse/DERBY-3592
> Project: Derby
> Issue Type: Bug
> Components: Javadoc
> Affects Versions: 10.4.1.0
> Reporter: Rick Hillegas
> Assignee: Rick Hillegas
> Attachments: derby-3592-01-removeImgTag.diff
>
>
> The Java 5 javadoc tool seems to have a bug. This bug seems to be fixed in Java 6. The issue is discussed in the following email thread: http://www.nabble.com/some-comments-on-the-10.4-beta-distribution-td16408536.html#a16408536 which puts forward the following theory:
> "The exact same javadoc directive is used to build the jdbc3 and jdbc4 public apis. The spurious line turns up in the jdbc3 javadoc but not the jdbc4 javadoc. The jdbc3 javadoc is built with the Java 5 javadoc tool and the jdbc4 javadoc is built with the Java 6 javadoc tool. I think that the Java 5 javadoc tool may have a bug that was corrected in Java 6.
> What we're trying to do in this <doctitle> element is a bit tricky. We are trying to generate javadoc whose overview page has a title consisting of the Derby logo followed by some useful text. The <doctitle> element does not allow nested image elements, and we appear to have hacked around this by stuffing the image and text into a CDATA section. That CDATA section survives the Java 6 javadoc tool but is munged by the Java 5 javadoc tool.
> I can get rid of the spurious line at the cost of removing the Derby logo. That is, I get rid of the CDATA section and just put text inside the <doctitle> element like so:
> <Doctitle> Apache Derby ${major}.${minor} API Documentation</Doctitle>
> I miss the pretty logo, but I think that the output without the logo looks better than the output with both the logo and the spurious line."
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Updated: (DERBY-3592) The Java 5 javadoc tool generates a
spurious output line when digesting the doctitle element for the public api
Posted by "Tiago R. Espinha (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-3592?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Tiago R. Espinha updated DERBY-3592:
------------------------------------
Priority: Minor (was: Major)
Issue & fix info: [Workaround attached]
Triaged for 10.5.2.
- Lowered priority.
- Checked workaround attached.
This seems rather fixed and should probably be closed.
> The Java 5 javadoc tool generates a spurious output line when digesting the doctitle element for the public api
> ---------------------------------------------------------------------------------------------------------------
>
> Key: DERBY-3592
> URL: https://issues.apache.org/jira/browse/DERBY-3592
> Project: Derby
> Issue Type: Bug
> Components: Javadoc
> Affects Versions: 10.4.1.3
> Reporter: Rick Hillegas
> Priority: Minor
> Attachments: derby-3592-01-removeImgTag.diff
>
>
> The Java 5 javadoc tool seems to have a bug. This bug seems to be fixed in Java 6. The issue is discussed in the following email thread: http://www.nabble.com/some-comments-on-the-10.4-beta-distribution-td16408536.html#a16408536 which puts forward the following theory:
> "The exact same javadoc directive is used to build the jdbc3 and jdbc4 public apis. The spurious line turns up in the jdbc3 javadoc but not the jdbc4 javadoc. The jdbc3 javadoc is built with the Java 5 javadoc tool and the jdbc4 javadoc is built with the Java 6 javadoc tool. I think that the Java 5 javadoc tool may have a bug that was corrected in Java 6.
> What we're trying to do in this <doctitle> element is a bit tricky. We are trying to generate javadoc whose overview page has a title consisting of the Derby logo followed by some useful text. The <doctitle> element does not allow nested image elements, and we appear to have hacked around this by stuffing the image and text into a CDATA section. That CDATA section survives the Java 6 javadoc tool but is munged by the Java 5 javadoc tool.
> I can get rid of the spurious line at the cost of removing the Derby logo. That is, I get rid of the CDATA section and just put text inside the <doctitle> element like so:
> <Doctitle> Apache Derby ${major}.${minor} API Documentation</Doctitle>
> I miss the pretty logo, but I think that the output without the logo looks better than the output with both the logo and the spurious line."
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Resolved: (DERBY-3592) The Java 5 javadoc tool generates a
spurious output line when digesting the doctitle element for the public api
Posted by "Dag H. Wanvik (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-3592?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Dag H. Wanvik resolved DERBY-3592.
----------------------------------
Resolution: Won't Fix
Resolving this to "won't fix". Rick, feel free to reopen if you still want to persue this.
> The Java 5 javadoc tool generates a spurious output line when digesting the doctitle element for the public api
> ---------------------------------------------------------------------------------------------------------------
>
> Key: DERBY-3592
> URL: https://issues.apache.org/jira/browse/DERBY-3592
> Project: Derby
> Issue Type: Bug
> Components: Javadoc
> Affects Versions: 10.4.1.3
> Reporter: Rick Hillegas
> Priority: Minor
> Attachments: derby-3592-01-removeImgTag.diff
>
>
> The Java 5 javadoc tool seems to have a bug. This bug seems to be fixed in Java 6. The issue is discussed in the following email thread: http://www.nabble.com/some-comments-on-the-10.4-beta-distribution-td16408536.html#a16408536 which puts forward the following theory:
> "The exact same javadoc directive is used to build the jdbc3 and jdbc4 public apis. The spurious line turns up in the jdbc3 javadoc but not the jdbc4 javadoc. The jdbc3 javadoc is built with the Java 5 javadoc tool and the jdbc4 javadoc is built with the Java 6 javadoc tool. I think that the Java 5 javadoc tool may have a bug that was corrected in Java 6.
> What we're trying to do in this <doctitle> element is a bit tricky. We are trying to generate javadoc whose overview page has a title consisting of the Derby logo followed by some useful text. The <doctitle> element does not allow nested image elements, and we appear to have hacked around this by stuffing the image and text into a CDATA section. That CDATA section survives the Java 6 javadoc tool but is munged by the Java 5 javadoc tool.
> I can get rid of the spurious line at the cost of removing the Derby logo. That is, I get rid of the CDATA section and just put text inside the <doctitle> element like so:
> <Doctitle> Apache Derby ${major}.${minor} API Documentation</Doctitle>
> I miss the pretty logo, but I think that the output without the logo looks better than the output with both the logo and the spurious line."
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Commented: (DERBY-3592) The Java 5 javadoc tool generates a
spurious output line when digesting the doctitle element for the public api
Posted by "Rick Hillegas (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-3592?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12585204#action_12585204 ]
Rick Hillegas commented on DERBY-3592:
--------------------------------------
Merged 644417 from trunk to 10.4 branch at subversion revision 644419.
> The Java 5 javadoc tool generates a spurious output line when digesting the doctitle element for the public api
> ---------------------------------------------------------------------------------------------------------------
>
> Key: DERBY-3592
> URL: https://issues.apache.org/jira/browse/DERBY-3592
> Project: Derby
> Issue Type: Bug
> Components: Javadoc
> Affects Versions: 10.4.1.0
> Reporter: Rick Hillegas
> Assignee: Rick Hillegas
> Attachments: derby-3592-01-removeImgTag.diff
>
>
> The Java 5 javadoc tool seems to have a bug. This bug seems to be fixed in Java 6. The issue is discussed in the following email thread: http://www.nabble.com/some-comments-on-the-10.4-beta-distribution-td16408536.html#a16408536 which puts forward the following theory:
> "The exact same javadoc directive is used to build the jdbc3 and jdbc4 public apis. The spurious line turns up in the jdbc3 javadoc but not the jdbc4 javadoc. The jdbc3 javadoc is built with the Java 5 javadoc tool and the jdbc4 javadoc is built with the Java 6 javadoc tool. I think that the Java 5 javadoc tool may have a bug that was corrected in Java 6.
> What we're trying to do in this <doctitle> element is a bit tricky. We are trying to generate javadoc whose overview page has a title consisting of the Derby logo followed by some useful text. The <doctitle> element does not allow nested image elements, and we appear to have hacked around this by stuffing the image and text into a CDATA section. That CDATA section survives the Java 6 javadoc tool but is munged by the Java 5 javadoc tool.
> I can get rid of the spurious line at the cost of removing the Derby logo. That is, I get rid of the CDATA section and just put text inside the <doctitle> element like so:
> <Doctitle> Apache Derby ${major}.${minor} API Documentation</Doctitle>
> I miss the pretty logo, but I think that the output without the logo looks better than the output with both the logo and the spurious line."
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Updated: (DERBY-3592) The Java 5 javadoc tool generates a
spurious output line when digesting the doctitle element for the public api
Posted by "Rick Hillegas (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-3592?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Rick Hillegas updated DERBY-3592:
---------------------------------
Attachment: derby-3592-01-removeImgTag.diff
Attaching derby-3592-01-removeImgTag.diff. This removes the derby logo from the doctitle of the public api and eliminates the spurious line in the jdbc3 javadoc. Committed at subversion revision 644417.
> The Java 5 javadoc tool generates a spurious output line when digesting the doctitle element for the public api
> ---------------------------------------------------------------------------------------------------------------
>
> Key: DERBY-3592
> URL: https://issues.apache.org/jira/browse/DERBY-3592
> Project: Derby
> Issue Type: Bug
> Components: Javadoc
> Affects Versions: 10.4.1.0
> Reporter: Rick Hillegas
> Assignee: Rick Hillegas
> Attachments: derby-3592-01-removeImgTag.diff
>
>
> The Java 5 javadoc tool seems to have a bug. This bug seems to be fixed in Java 6. The issue is discussed in the following email thread: http://www.nabble.com/some-comments-on-the-10.4-beta-distribution-td16408536.html#a16408536 which puts forward the following theory:
> "The exact same javadoc directive is used to build the jdbc3 and jdbc4 public apis. The spurious line turns up in the jdbc3 javadoc but not the jdbc4 javadoc. The jdbc3 javadoc is built with the Java 5 javadoc tool and the jdbc4 javadoc is built with the Java 6 javadoc tool. I think that the Java 5 javadoc tool may have a bug that was corrected in Java 6.
> What we're trying to do in this <doctitle> element is a bit tricky. We are trying to generate javadoc whose overview page has a title consisting of the Derby logo followed by some useful text. The <doctitle> element does not allow nested image elements, and we appear to have hacked around this by stuffing the image and text into a CDATA section. That CDATA section survives the Java 6 javadoc tool but is munged by the Java 5 javadoc tool.
> I can get rid of the spurious line at the cost of removing the Derby logo. That is, I get rid of the CDATA section and just put text inside the <doctitle> element like so:
> <Doctitle> Apache Derby ${major}.${minor} API Documentation</Doctitle>
> I miss the pretty logo, but I think that the output without the logo looks better than the output with both the logo and the spurious line."
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Closed: (DERBY-3592) The Java 5 javadoc tool generates a
spurious output line when digesting the doctitle element for the public api
Posted by "Rick Hillegas (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-3592?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Rick Hillegas closed DERBY-3592.
--------------------------------
> The Java 5 javadoc tool generates a spurious output line when digesting the doctitle element for the public api
> ---------------------------------------------------------------------------------------------------------------
>
> Key: DERBY-3592
> URL: https://issues.apache.org/jira/browse/DERBY-3592
> Project: Derby
> Issue Type: Bug
> Components: Javadoc
> Affects Versions: 10.4.1.3
> Reporter: Rick Hillegas
> Priority: Minor
> Attachments: derby-3592-01-removeImgTag.diff
>
>
> The Java 5 javadoc tool seems to have a bug. This bug seems to be fixed in Java 6. The issue is discussed in the following email thread: http://www.nabble.com/some-comments-on-the-10.4-beta-distribution-td16408536.html#a16408536 which puts forward the following theory:
> "The exact same javadoc directive is used to build the jdbc3 and jdbc4 public apis. The spurious line turns up in the jdbc3 javadoc but not the jdbc4 javadoc. The jdbc3 javadoc is built with the Java 5 javadoc tool and the jdbc4 javadoc is built with the Java 6 javadoc tool. I think that the Java 5 javadoc tool may have a bug that was corrected in Java 6.
> What we're trying to do in this <doctitle> element is a bit tricky. We are trying to generate javadoc whose overview page has a title consisting of the Derby logo followed by some useful text. The <doctitle> element does not allow nested image elements, and we appear to have hacked around this by stuffing the image and text into a CDATA section. That CDATA section survives the Java 6 javadoc tool but is munged by the Java 5 javadoc tool.
> I can get rid of the spurious line at the cost of removing the Derby logo. That is, I get rid of the CDATA section and just put text inside the <doctitle> element like so:
> <Doctitle> Apache Derby ${major}.${minor} API Documentation</Doctitle>
> I miss the pretty logo, but I think that the output without the logo looks better than the output with both the logo and the spurious line."
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Closed: (DERBY-3592) The Java 5 javadoc tool generates a
spurious output line when digesting the doctitle element for the public api
Posted by "Rick Hillegas (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-3592?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Rick Hillegas closed DERBY-3592.
--------------------------------
Resolution: Fixed
> The Java 5 javadoc tool generates a spurious output line when digesting the doctitle element for the public api
> ---------------------------------------------------------------------------------------------------------------
>
> Key: DERBY-3592
> URL: https://issues.apache.org/jira/browse/DERBY-3592
> Project: Derby
> Issue Type: Bug
> Components: Javadoc
> Affects Versions: 10.4.1.0
> Reporter: Rick Hillegas
> Assignee: Rick Hillegas
> Attachments: derby-3592-01-removeImgTag.diff
>
>
> The Java 5 javadoc tool seems to have a bug. This bug seems to be fixed in Java 6. The issue is discussed in the following email thread: http://www.nabble.com/some-comments-on-the-10.4-beta-distribution-td16408536.html#a16408536 which puts forward the following theory:
> "The exact same javadoc directive is used to build the jdbc3 and jdbc4 public apis. The spurious line turns up in the jdbc3 javadoc but not the jdbc4 javadoc. The jdbc3 javadoc is built with the Java 5 javadoc tool and the jdbc4 javadoc is built with the Java 6 javadoc tool. I think that the Java 5 javadoc tool may have a bug that was corrected in Java 6.
> What we're trying to do in this <doctitle> element is a bit tricky. We are trying to generate javadoc whose overview page has a title consisting of the Derby logo followed by some useful text. The <doctitle> element does not allow nested image elements, and we appear to have hacked around this by stuffing the image and text into a CDATA section. That CDATA section survives the Java 6 javadoc tool but is munged by the Java 5 javadoc tool.
> I can get rid of the spurious line at the cost of removing the Derby logo. That is, I get rid of the CDATA section and just put text inside the <doctitle> element like so:
> <Doctitle> Apache Derby ${major}.${minor} API Documentation</Doctitle>
> I miss the pretty logo, but I think that the output without the logo looks better than the output with both the logo and the spurious line."
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.