Derby
  1. Derby
  2. DERBY-4995

Docs build creates extraneous devguide directory

    Details

    • Type: Bug Bug
    • Status: Closed
    • Priority: Minor Minor
    • Resolution: Fixed
    • Affects Version/s: 10.7.1.1
    • Fix Version/s: 10.8.1.2
    • Component/s: Documentation
    • Labels:
      None

      Description

      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.

      1. japanese.diff
        3 kB
        Knut Anders Hatlen
      2. rrefsqljrevoke.html
        23 kB
        Kim Haase
      3. rrefsqlj41360.html
        9 kB
        Kim Haase
      4. DERBY-4995.stat
        0.1 kB
        Kim Haase
      5. DERBY-4995.diff
        2 kB
        Kim Haase

        Issue Links

          Activity

          Hide
          Kim Haase added a comment -

          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.

          Show
          Kim Haase added a comment - 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.
          Hide
          Kim Haase added a comment -

          Committed patch DERBY-4995.diff to documentation trunk at revision 1066640.

          Show
          Kim Haase added a comment - Committed patch DERBY-4995 .diff to documentation trunk at revision 1066640.
          Hide
          Knut Anders Hatlen added a comment -

          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.

          Show
          Knut Anders Hatlen added a comment - 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.
          Hide
          Kim Haase added a comment -

          Thank you so much, Knut, for catching and fixing this.

          Show
          Kim Haase added a comment - Thank you so much, Knut, for catching and fixing this.

            People

            • Assignee:
              Kim Haase
              Reporter:
              Kim Haase
            • Votes:
              0 Vote for this issue
              Watchers:
              0 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved:

                Development