Re: [Refdb-devel] Docs failing to build

[David N. <dav...@sw...>]

Hi Markus,
>> More specifically, the error is caused by the inclusion of '../doc/' in
>> specifying the stylesheet.  It makes no difference whether included or
>> not in the source xml file name.

As so often happens, this problem has self-corrected after another 
system update.  I have no idea what the offending package was, nor the 
underlying cause.

For what it's worth, here is the current situation regarding 
stylesheets.  You will see I experimented with putting all stylesheets 
in the 'doc' directory rather than the 'include' subdirectory.  This 
makes a difference.

TOPSRCDIR?  USE SUBDIR?       RESULT
----------  -----------       ------
Yes         Yes          -->  SUCCEEDED   [../doc/include/manual-fo.xsl]
Yes         No           -->  FAILED      [../doc/manual-fo.xsl]
No          Yes          -->  FAILED      [include/manual-fo.xsl]
No          No           -->  SUCCEEDED   [manual-fo.xsl]

The results are perplexing.  Using '../doc/' as part of the stylesheet 
filepath works when stylesheets are in a subdirectory but not when they 
are in the current directory.  If you remove the '../doc/' construct the 
situation reverses: success when stylesheets are in the current 
directory but failure when they are in the subdirectory.  Passing 
strange indeed.

In any event, the command used in the refdb makefile happens to be of a 
form now recognised by xsltproc -- so we are in the clear for now.  If, 
however, a problem building the manual should arise in the future it 
will be worth remembering the fragility of xsltproc's command line.

Regards,
David.