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 "Kim Haase (JIRA)" <ji...@apache.org> on 2011/02/01 21:31:28 UTC
[jira] Created: (DERBY-4995) Docs build creates extraneous devguide
directory
Docs build creates extraneous devguide directory
------------------------------------------------
Key: DERBY-4995
URL: https://issues.apache.org/jira/browse/DERBY-4995
Project: Derby
Issue Type: Bug
Components: Documentation
Affects Versions: 10.7.1.1
Reporter: Kim Haase
Assignee: Kim Haase
Priority: Minor
Whenever we build the reference manual, a directory called "devguide" is created at the trunk level, containing 13 developer's guide source files.
It seems that the reason for this is that there are a couple of direct cross-references to developer's guide topics in the reference manual, one in the map file to "../devguide/cdevcsecuregrantrevokeaccess.dita" and one in rrefsqlj41360.dita to "../devguide/tdevconcepts41704.dita". If these are removed, the devguide directory and files are not created.
I plan to remove these links to create a cleaner docs build.
--
This message is automatically generated by JIRA.
-
For more information on JIRA, see: http://www.atlassian.com/software/jira
[jira] Resolved: (DERBY-4995) Docs build creates extraneous
devguide directory
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-4995?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Kim Haase resolved DERBY-4995.
------------------------------
Resolution: Fixed
Fix Version/s: 10.8.0.0
Committed patch DERBY-4995.diff to documentation trunk at revision 1066640.
> Docs build creates extraneous devguide directory
> ------------------------------------------------
>
> Key: DERBY-4995
> URL: https://issues.apache.org/jira/browse/DERBY-4995
> Project: Derby
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 10.7.1.1
> Reporter: Kim Haase
> Assignee: Kim Haase
> Priority: Minor
> Fix For: 10.8.0.0
>
> Attachments: DERBY-4995.diff, DERBY-4995.stat, rrefsqlj41360.html, rrefsqljrevoke.html
>
>
> Whenever we build the reference manual, a directory called "devguide" is created at the trunk level, containing 13 developer's guide source files.
> It seems that the reason for this is that there are a couple of direct cross-references to developer's guide topics in the reference manual, one in the map file to "../devguide/cdevcsecuregrantrevokeaccess.dita" and one in rrefsqlj41360.dita to "../devguide/tdevconcepts41704.dita". If these are removed, the devguide directory and files are not created.
> I plan to remove these links to create a cleaner docs build.
--
This message is automatically generated by JIRA.
-
For more information on JIRA, see: http://www.atlassian.com/software/jira
[jira] Updated: (DERBY-4995) Docs build creates extraneous devguide
directory
Posted by "Knut Anders Hatlen (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-4995?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Knut Anders Hatlen updated DERBY-4995:
--------------------------------------
Attachment: japanese.diff
The same cross-references are present in the Japanese translation of the reference manual, and now "ant all" fails like this:
[xslt] /code/derby/docs/trunk/DITA-OT1.1.2.1/xsl/preprocess/topicpull.xsl:327:75: Warning! Can not load requested doc: /code/derby/docs/trunk/temp/../devguide/cdevcsecuregrantrevokeaccess.dita (No such file or directory)
[xslt] /code/derby/docs/trunk/DITA-OT1.1.2.1/xsl/common/output-message.xsl:43:16: Warning! ------------------------------------------------------------------
[xslt] IDXS059E Error: (File = /code/derby/docs/trunk/temp_source/ja_JP/ref/refderby.ditamap, Element = topicref:4)
[xslt] The file file:///code/derby/docs/trunk/temp/../devguide/cdevcsecuregrantrevokeaccess.dita is
[xslt] not available to resolve link information. Either the file could not
[xslt] be found, or a DITAVAL file was used to remove the file's contents.
[xslt] Be aware that the path information above may not match the link in
[xslt] your topic.
[xslt] /code/derby/docs/trunk/DITA-OT1.1.2.1/xsl/preprocess/topicpull.xsl:410:27: Warning! Can not load requested doc: /code/derby/docs/trunk/temp/../devguide/cdevcsecuregrantrevokeaccess.dita (No such file or directory)
[xslt] /code/derby/docs/trunk/DITA-OT1.1.2.1/xsl/preprocess/topicpull.xsl:1423:21: Warning! Can not load requested doc: /code/derby/docs/trunk/temp/../devguide/cdevcsecuregrantrevokeaccess.dita (No such file or directory)
[xslt] /code/derby/docs/trunk/DITA-OT1.1.2.1/xsl/preprocess/topicpull.xsl:1423:21: Warning! Can not load requested doc: /code/derby/docs/trunk/temp/../devguide/cdevcsecuregrantrevokeaccess.dita (No such file or directory)
(...)
[xslt] /code/derby/docs/trunk/DITA-OT1.1.2.1/xsl/xslfo/dita2fo-links.xsl:154:57: Warning! Can not load requested doc: /code/derby/docs/trunk/devguide/tdevconcepts41704.dita (No such file or directory)
(...)
BUILD FAILED
/code/derby/docs/trunk/build.xml:414: The following error occurred while executing this line:
/code/derby/docs/trunk/src/ja_JP/build.xml:71: The following error occurred while executing this line:
/code/derby/docs/trunk/build.xml:231: The following error occurred while executing this line:
/code/derby/docs/trunk/DITA-OT1.1.2.1/conductor.xml:209: The following error occurred while executing this line:
/code/derby/docs/trunk/DITA-OT1.1.2.1/ditatargets.xml:78: javax.xml.transform.TransformerException: org.apache.fop.fo.ValidationException: file:/code/derby/docs/trunk/out/ja_JP/ref/refderby.fo:866:4909: Error(866/4909): fo:basic-link, Missing attribute: Either external-destination or internal-destination must be specified.
Total time: 14 minutes 47 seconds
The attached patch (japanese.diff) makes similar changes to the Japanese translation of the reference manual, and that made "ant all" succeed again in my environment.
Committed revision 1067899.
> Docs build creates extraneous devguide directory
> ------------------------------------------------
>
> Key: DERBY-4995
> URL: https://issues.apache.org/jira/browse/DERBY-4995
> Project: Derby
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 10.7.1.1
> Reporter: Kim Haase
> Assignee: Kim Haase
> Priority: Minor
> Fix For: 10.8.0.0
>
> Attachments: DERBY-4995.diff, DERBY-4995.stat, japanese.diff, rrefsqlj41360.html, rrefsqljrevoke.html
>
>
> Whenever we build the reference manual, a directory called "devguide" is created at the trunk level, containing 13 developer's guide source files.
> It seems that the reason for this is that there are a couple of direct cross-references to developer's guide topics in the reference manual, one in the map file to "../devguide/cdevcsecuregrantrevokeaccess.dita" and one in rrefsqlj41360.dita to "../devguide/tdevconcepts41704.dita". If these are removed, the devguide directory and files are not created.
> I plan to remove these links to create a cleaner docs build.
--
This message is automatically generated by JIRA.
-
For more information on JIRA, see: http://www.atlassian.com/software/jira
[jira] Commented: (DERBY-4995) Docs build creates extraneous
devguide directory
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-4995?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12991401#comment-12991401 ]
Kim Haase commented on DERBY-4995:
----------------------------------
Thank you so much, Knut, for catching and fixing this.
> Docs build creates extraneous devguide directory
> ------------------------------------------------
>
> Key: DERBY-4995
> URL: https://issues.apache.org/jira/browse/DERBY-4995
> Project: Derby
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 10.7.1.1
> Reporter: Kim Haase
> Assignee: Kim Haase
> Priority: Minor
> Fix For: 10.8.0.0
>
> Attachments: DERBY-4995.diff, DERBY-4995.stat, japanese.diff, rrefsqlj41360.html, rrefsqljrevoke.html
>
>
> Whenever we build the reference manual, a directory called "devguide" is created at the trunk level, containing 13 developer's guide source files.
> It seems that the reason for this is that there are a couple of direct cross-references to developer's guide topics in the reference manual, one in the map file to "../devguide/cdevcsecuregrantrevokeaccess.dita" and one in rrefsqlj41360.dita to "../devguide/tdevconcepts41704.dita". If these are removed, the devguide directory and files are not created.
> I plan to remove these links to create a cleaner docs build.
--
This message is automatically generated by JIRA.
-
For more information on JIRA, see: http://www.atlassian.com/software/jira
[jira] Closed: (DERBY-4995) Docs build creates extraneous devguide
directory
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-4995?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Kim Haase closed DERBY-4995.
----------------------------
> Docs build creates extraneous devguide directory
> ------------------------------------------------
>
> Key: DERBY-4995
> URL: https://issues.apache.org/jira/browse/DERBY-4995
> Project: Derby
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 10.7.1.1
> Reporter: Kim Haase
> Assignee: Kim Haase
> Priority: Minor
> Fix For: 10.8.0.0
>
> Attachments: DERBY-4995.diff, DERBY-4995.stat, japanese.diff, rrefsqlj41360.html, rrefsqljrevoke.html
>
>
> Whenever we build the reference manual, a directory called "devguide" is created at the trunk level, containing 13 developer's guide source files.
> It seems that the reason for this is that there are a couple of direct cross-references to developer's guide topics in the reference manual, one in the map file to "../devguide/cdevcsecuregrantrevokeaccess.dita" and one in rrefsqlj41360.dita to "../devguide/tdevconcepts41704.dita". If these are removed, the devguide directory and files are not created.
> I plan to remove these links to create a cleaner docs build.
--
This message is automatically generated by JIRA.
-
For more information on JIRA, see: http://www.atlassian.com/software/jira
[jira] Updated: (DERBY-4995) Docs build creates extraneous devguide
directory
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-4995?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Kim Haase updated DERBY-4995:
-----------------------------
Attachment: rrefsqljrevoke.html
rrefsqlj41360.html
DERBY-4995.stat
DERBY-4995.diff
Attaching DERBY-4995.diff, DERBY-4995.stat, and rrefsqlj41360.html, the SELECT statement topic. The change to that topic is that the devguide topic is referred to by title rather than by a link.
The change to the map file means only that a link to the "Using SQL standard authorization" topic no longer appears at the bottom of the REVOKE statement topic. However, that topic is referred to by title near the beginning of the topic.
I'll commit this patch in a day or so unless I hear objections.
> Docs build creates extraneous devguide directory
> ------------------------------------------------
>
> Key: DERBY-4995
> URL: https://issues.apache.org/jira/browse/DERBY-4995
> Project: Derby
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 10.7.1.1
> Reporter: Kim Haase
> Assignee: Kim Haase
> Priority: Minor
> Attachments: DERBY-4995.diff, DERBY-4995.stat, rrefsqlj41360.html, rrefsqljrevoke.html
>
>
> Whenever we build the reference manual, a directory called "devguide" is created at the trunk level, containing 13 developer's guide source files.
> It seems that the reason for this is that there are a couple of direct cross-references to developer's guide topics in the reference manual, one in the map file to "../devguide/cdevcsecuregrantrevokeaccess.dita" and one in rrefsqlj41360.dita to "../devguide/tdevconcepts41704.dita". If these are removed, the devguide directory and files are not created.
> I plan to remove these links to create a cleaner docs build.
--
This message is automatically generated by JIRA.
-
For more information on JIRA, see: http://www.atlassian.com/software/jira