[DERBY-4875] cross-manual xref problems after doc build change

• Type: Bug
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 10.7.1.1
• Fix Version/s: 10.7.1.1
• Component/s: Documentation
• Assignee: Richard N. Hillegas
• Reporter: Dag H. Wanvik
• Created: 29/Oct/10 03:17
• Updated: 13/Jan/11 17:28
• Resolved: 02/Nov/10 13:12

Description

See thread http://old.nabble.com/Problems-with-docs-build-tt30078424.html#a30078424

Possible cause (http://old.nabble.com/forum/Permalink.jtp?root=30078424&post=30082083&page=y)

> After the patch, there is a new preprocessing step, that puts the
> sources in a temp directory (from doc.properties):
>
> temp.source=${basedir}/temp_source

One problem is that after preprocessing of "ref", the references to
devguide are assumed to be present as ../devguide, cf. the generated
dita.list (snippet below). But the way the preprocessing is currently
done, there is only one manual at a time inside temp_source.

Presumably, since refs were not resolved, the devguide directory is also
missing as observed.

Dag

Snippet of trunk/temp/dita.list (seen while processing html.ref, inside
target "debug" of DITA../pretargets.xml, which calls module
DebugAndFilter):

rrefsqlj30540.dita,../devguide/cdevcsecuregrantrevokeaccess.dita,rrefjdbc37352.dita

and then I see this warning:

[xslt]
/export/home/dag/java/sb/docs/trunk/DITA-OT1.1.2.1/xsl/preprocess/topicpull.xsl:410:27:
Warning! Can not load requested doc:
/export/home/dag/java/sb/docs/trunk/temp/../devguide/cdevcsecuregrantrevokeaccess.dita
(No such file or directory)

Issue Links

• is related to: DERBY-4882 Stop dropping docs build artifacts in the subversion-controlled source tree
• relates to: DERBY-4851 Parameterize documentation sources so that release-time variables (like copyright year and release id) can be plugged in when we build a release