[
https://issues.apache.org/jira/browse/DERBY-6900?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15386992#comment-15386992
]
Bryan Pendleton commented on DERBY-6900:
----------------------------------------
I changed refderby.ditamap:
{code}
Index: src/ref/refderby.ditamap
===================================================================
--- src/ref/refderby.ditamap (revision 1753624)
+++ src/ref/refderby.ditamap (working copy)
@@ -624,7 +624,7 @@
<relcell>
<topicref href="rrefsyscspeekidentity.dita"
navtitle="SYSCS_UTIL.SYSCS_PEEK_AT_IDENTITY system function"></topicref>
<topicref href="rrefsqljgenerationclause.dita"
navtitle="generationClause"></topicref>
-<topicref href="rrefjavstateautogen.dita" navtitle="Autogenerated
keys"></topicref>
+<topicref href="crefjavstateautogen.dita" navtitle="Autogenerated
keys"></topicref>
</relcell>
</relrow>
</reltable>
{code}
and re-built html.ref.
My build results no longer produce the warning about "file not found".
Moreover, in the new version I can see that the page for the IDENTITY_VAL_LOCAL
system function is slightly different. In the current production version at
{quote}
https://db.apache.org/derby/docs/10.12/ref/rrefidentityvallocal.html
{quote}
the bottom of that page shows a "Related information" which is a broken (HTML
404) link to
{quote}
https://db.apache.org/derby/docs/10.12/ref/rrefjavstateautogen.html
{quote}
In the new version, the page shows a "Related concepts" section with a
correctly-working
link to the Autogenerated keys concept page.
So I've persuaded myself that it was indeed a typo in revision 1643722, but
the symptoms were so extremely minor that we didn't notice.
> docs build for ref.html gives errors about rrefjavstateautogen.dita --
> possible typo?
> -------------------------------------------------------------------------------------
>
> Key: DERBY-6900
> URL: https://issues.apache.org/jira/browse/DERBY-6900
> Project: Derby
> Issue Type: Bug
> Components: Documentation
> Reporter: Bryan Pendleton
>
> When I run 'ant html.ref' in the docs trunk, I get this error:
> {quote}
> [xslt]
> /extra/derby/docs/trunk/DITA-OT1.1.2.1/xsl/preprocess/topicpull.xsl:327:75:
> Warning! Can not load requested doc:
> /extra/derby/docs/trunk/temp/rrefjavstateautogen.dita (No such file or
> directory)
> [xslt]
> /extra/derby/docs/trunk/DITA-OT1.1.2.1/xsl/common/output-message.xsl:43:16:
> Warning! ------------------------------------------------------------------
> [xslt] IDXS059E Error: (File =
> /extra/derby/docs/trunk/temp_source/ref/refderby.ditamap, Element =
> topicref:278)
> [xslt] The file
> file:///extra/derby/docs/trunk/temp/rrefjavstateautogen.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.
> {quote}
> Digging into the refderby.ditamap SVN history, it looks to me like the
> refrence to rrefjavstateautogen.dita was added by revision 1643722,
> as part of DERBY-6753.
> That revision also added a new file named crefjavstateautogen.dita,
> which seems to have a very similar, but not idential, name ('cref*'
> rather than 'rref*').
> I wonder if this is just a typo, and the changes in 1643722 should have
> been referring to crefjavstateautogen.dita, not rrefjavstateautogen.dita.
> Or, possibly, there were supposed to be two new files added by that
> revision (both rref and cref), and the revision ommitted an svn add for
> one of those files?
> More research is needed, but it seems like some follow-up work is
> probably worth doing here.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
