Tony Lambregts wrote:
Vincent Béron wrote:
Hi guys,
Alexandre just committed my patch concerning the documentation building process. Could you verify it works for you?
I am sure it is something on my end but I get the following when I "make html", "make everything"
docbook2html -d ./default.dsl -o wine-devel wine-devel.sgml Using catalogs: /etc/sgml/sgml-docbook-3.1.cat Using stylesheet: ./default.dsl Working on: /usr/local/src/wine/documentation/wine-devel.sgml jade:E: cannot find "./default.dsl"; tried "./default.dsl", "/usr/share/sgml/./default.dsl" jade:E: specification document does not have the DSSSL architecture as a base architecture ..... spews out sgml ....
It must be something I've done but I have no idea what, since db2html -d ./faq-plain.dsl wine-faq.sgml jade:E: cannot find "./faq-plain.dsl"; tried "./faq-plain.dsl", "/usr/share/sgml/./faq-plain.dsl" jade:E: specification document does not have the DSSSL architecture as a base architecture
same thing. WTF.
Ok heres what I have found. "db2html -d ../faq-plain.dsl wine-faq.sgml " works, However if I use "db2html -d ./faq-plain.dsl wine-faq.sgml " it blows chunks. as I reported.
So the change to two dots works, which makes sense, therfore I changed the Makefile so that SRCDIR = .. and re-ran "make html" and produces the html beautifully.
So all that tells me is "There is something wrong here" ./ should work (right?)
Le sam 23/11/2002 à 11:55, Tony Lambregts a écrit :
Ok heres what I have found. "db2html -d ../faq-plain.dsl wine-faq.sgml " works, However if I use "db2html -d ./faq-plain.dsl wine-faq.sgml " it blows chunks. as I reported.
So the change to two dots works, which makes sense, therfore I changed the Makefile so that SRCDIR = .. and re-ran "make html" and produces the html beautifully.
So all that tells me is "There is something wrong here" ./ should work (right?)
Could you send me both your docbook2html and db2html please, along with /usr/bin/jw, and tell me what distro/package they come from? Thank you.
Seems all those scripts don't handle the location of stylesheets the same way...
Vincent
Vincent Béron wrote:
Could you send me both your docbook2html and db2html please, along with /usr/bin/jw, and tell me what distro/package they come from? Thank you.
Seems all those scripts don't handle the location of stylesheets the same way...
The packages are for RedHat 7.2 from Ximian (Gnome)
Le sam 23/11/2002 à 16:19, Tony Lambregts a écrit : /usr/bin/jw:
\040 -d|--dsl <file>|default|none:\t Specify an alternate style sheet\n\ \040 -s|--sgmlbase <path>: \t Change base directory for SGML distribution\n\
Here's the use of -d and -s for Tony's jw. They are the same as mine. Joerg's are different (-d for DVI output, -s for the style sheet). So we cannot use db2html (or docbook2html), because each of them call jw. We'll have to call jade directly (probably similar to what's in db2html-winehq, if not that file).
-d|--dsl) SGML_STYLESHEET=$2 shift 2 ;;
-d|--dsl) case "$2" in /*|none|default) SGML_STYLESHEET="$2" ;; *) SGML_STYLESHEET="$SGML_CURRENT_DIRECTORY/$2" ;; esac
Top is Tony's (docbook-utils-0.6.9), bottom is mine (docbook-utils-0.6.11). You see that the first one directly uses whatever stylesheet we gave it, while the second makes sure there's a path component. In conjunction with the cd's below, it explains why it doesn't work for Tony while it works for me. This is easy to fix: just feed it an absolute path rather than a relative.
cd $SGML_OUTPUT_DIRECTORY
...
cd $SGML_CURRENT_DIRECTORY
Pair of cd's, explaining the need for an absolute path for the style sheet.
I just need to find a way to work with Suse (as I haven't heard anything else for other distributions).
Vincent
On Sat, Nov 23, 2002 at 09:55:32AM -0700, Tony Lambregts wrote:
Ok heres what I have found. "db2html -d ../faq-plain.dsl wine-faq.sgml " works, However if I use "db2html -d ./faq-plain.dsl wine-faq.sgml " it blows chunks. as I reported.
So the change to two dots works, which makes sense, therfore I changed the Makefile so that SRCDIR = .. and re-ran "make html" and produces the html beautifully.
Fails for me too:
jmayer@alice:~/work/wine/wine/documentation> make everything db2html -d ./default.dsl -o wine-devel wine-devel.sgml Filename suffix "dsl" ambiguous: ./default.dsl make: *** [wine-devel/index.html] Fehler 1
----------------------------------------------
jmayer@alice:~/work/wine/wine/documentation> db2html --version db2html - docbook-toys 0.61.0
----------------------------------------------
jmayer@alice:~/work/wine/wine/documentation> rpm -qilf /usr/bin/db2html Name : docbook-toys Relocations: (not relocateable) Version : 0.61.0 Vendor: SuSE Linux AG, Nuernberg, Germany Release : 173 Build Date: Mon 09 Sep 2002 22:13:46 CEST Install date: Sam 05 Okt 2002 15:48:07 CEST Build Host: amdsim5.suse.de Group : Productivity/Publishing/DocBook Source RPM: docbook-toys-0.61.0-173.src.rpm Size : 97902 License: GPL Packager : http://www.suse.de/feedback URL : http://www.suse.de/~ke/docbook-toys/ Summary : DocBook Tools Description : A shell script to convert SGML documents which are based on the DocBook DTD.
For usage information read:
/usr/share/doc/packages/docbook-toys/README
Authors: -------- Karl Eichwalder ke@suse.de Mark Galassi rosalia@cygnus.com Distribution: SuSE Linux 8.1 (i386) /usr/bin/db2dvi /usr/bin/db2fot /usr/bin/db2html /usr/bin/db2mif /usr/bin/db2pdf /usr/bin/db2ps /usr/bin/db2rtf /usr/bin/db2tex /usr/bin/db2x.sh /usr/bin/db2xml /usr/bin/dbnochunks /usr/share/doc/packages/docbook-toys /usr/share/doc/packages/docbook-toys/AUTHORS /usr/share/doc/packages/docbook-toys/COPYING /usr/share/doc/packages/docbook-toys/ChangeLog /usr/share/doc/packages/docbook-toys/NEWS /usr/share/doc/packages/docbook-toys/README /usr/share/doc/packages/docbook-toys/README.SuSE /usr/share/doc/packages/docbook-toys/THANKS /usr/share/doc/packages/docbook-toys/TODO /usr/share/doc/packages/docbook-toys/test /usr/share/doc/packages/docbook-toys/test/Makefile /usr/share/doc/packages/docbook-toys/test/Makefile.am /usr/share/doc/packages/docbook-toys/test/Makefile.in /usr/share/doc/packages/docbook-toys/test/Makefile.tips /usr/share/doc/packages/docbook-toys/test/art.dsl /usr/share/doc/packages/docbook-toys/test/test.sgml /usr/share/doc/packages/docbook-toys/test/tips.sgml /usr/share/doc/packages/docbook-toys/texmf.conf.diff /usr/share/sgml/docbook/docbook-toys /usr/share/sgml/docbook/docbook-toys/docbook-sloppy.dcl /usr/share/sgml/docbook/docbook-toys/gdp-both.dsl /usr/share/sgml/docbook/docbook-toys/suse-both.dsl
----------------------------------------------
jmayer@alice:~/work/wine/wine/documentation> db2html --help Usage: db2html [OPTION]... FILE.sgml Run a DocBook SGML document FILE.sgml through various programs.
If a long option shows an argument as mandatory, then it is mandatory for the equivalent short option also. Similarly for optional arguments.
Options: --help display this help and exit -v, --version output version information and exit
-x trace the shell script
Output formats: -d, --dvi output DVI -f, --fot output FOT -h, --html output HTML -m, --mif output MIF --pdf output PDF -p, --ps, --postscript output PostScript -r, --rtf output RTF -t, --tex output TeX -X, --xml output XML (DocBook) --xencoding VAR set XML output encoding (default: iso-8859-1) --xoptions VAR add XML output options; e.g., "-xempty -xlower" (default)
HTML: --nochunks don't produce HTML subdocuments; output to stdout
General options: -S, --strict use the SGML declaration coming with the DocBook DTDs (no minimizations are allowed) -j, --jade VAR... set "jade" variables; e.g., "-V %shade-verbatim%" -c, --catalog FILE use FILE as the catalog -s, --style FILE use FILE as driver style -V, --validate validate (sloppy); without "--strict" allow minimizations -W, --validate-strict validate (strict); implies "--strict" -o, --use-openjade use OpenJade binaries
Only the last specified output format will be produced.
The script will automatically use FILE.dsl as a driver style if it is found in the same directory as FILE.sgml.
DocBook XML version 4 input files will be properly processed, too.
Please, report bugs to Karl Eichwalder keichwa@gmx.net.
----------------------------------------------
Ciao JÖrg -- Joerg Mayer jmayer@loplof.de I found out that "pro" means "instead of" (as in proconsul). Now I know what proactive means.
Le sam 23/11/2002 à 12:58, Joerg Mayer a écrit :
On Sat, Nov 23, 2002 at 09:55:32AM -0700, Tony Lambregts wrote:
Ok heres what I have found. "db2html -d ../faq-plain.dsl wine-faq.sgml " works, However if I use "db2html -d ./faq-plain.dsl wine-faq.sgml " it blows chunks. as I reported.
So the change to two dots works, which makes sense, therfore I changed the Makefile so that SRCDIR = .. and re-ran "make html" and produces the html beautifully.
Fails for me too:
jmayer@alice:~/work/wine/wine/documentation> make everything db2html -d ./default.dsl -o wine-devel wine-devel.sgml Filename suffix "dsl" ambiguous: ./default.dsl make: *** [wine-devel/index.html] Fehler 1
Do'h!
-d, --dvi output DVI -s, --style FILE use FILE as driver style
Comes from this. -d is used for DVI output for your db2html, while -d is used to specify the style file in my db2html (RH).
Seems we don't have much choice but to skip db2html and directly drive either jw (another jade wrapper) or even jade.
I'll try to gather what I can on the specifics of each distro. Expect a patch in the next few days.
Vincent