Folks,
Thank you for the great package. The tool has proved very useful in
helping us converting XML-based manual draft into PDF, and html files.
However, there was one perplexing behavior which confused me
very much when I tried specify customized dsl file using "-d" option.
It took me a long while to figure this out and I found the solution
just before I thought I would submit a bug report.
For a seasoned veteran, it may not be an issue, still
you may want to add something similar below in the manual section
where "-d" option is discussed.
I hope the paragraphs below explain the symptom and remedy for
unsuspecting users.
Hope this helps
---- begin quote ----
Note: When you create a customized dsl file by copying a
system-wide dsl file under a public directory and modify it, note the
following. When you specify your own custom dsl file by using "-d"
option, be sure to attach "#html" or similar target string which
your invocation of the command such as "docbook2html" would add to the
end of the system-wide dsl file such as
/usr/share/docbook-utils/docbook-utils.dsl#html (in the case of XML-HTML
conversion under of Debian GNU/Linux using docbook2html).
WITHOUT the target string (such as #html), the desired effect may NOT
happen at all.
For example, in the case of docbook2html usage, if you copy
system-wide /usr/share/docbook-utils/docbook-utils.dsl to
mycustomized.dsl and specify -d mycustomized.dsl on the command line
directly, the result of conversion to HTML file by docbook2html would
not be what you expect. Specify it as "-d mycustomized.dsl#html" with
the target string at the end.
(Some novice users may want the command to add such target string
automatically to the argument file name just as it would for default
dsl files.)
Note further that "#" is often a comment starting character in various
command shells, and make's description file, and so you may need to
escape it by preceding it with a backslash as \#.
---- end quote ----
TIA and Happy Hacking
CI
