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