Documentation volunteer(s) needed

[Holly Bostick]

Dimi Paun schreef:
> On Tue, 2005-09-20 at 23:30 +0200, Holly Bostick wrote:
> 
>> But in any case, I'm having another problem somewhat more
>> relevant-- the docs don't compile as html for me:
> 
> 
> It should be fixed now, just get the latest version.
> 

Just a quick note-- I deleted the previous docs source dir, checked out
the current one an hour ago.

I will first say that I did get the docs to compile (so now I can read
and edit them), *but* I had to compile all formats to do so.

I was unable to compile just the html (which would have been preferable
to me, since I have no use for .ps or.pdf files), because make html
consistently failed with the following error:

 ./configure; make html
checking whether make sets $(MAKE)... yes
checking for docbook2html... docbook2html
checking for docbook2pdf... docbook2pdf
checking for docbook2ps... docbook2ps
checking for docbook2txt... docbook2txt
checking for nsgmls... nsgmls
configure: creating ./config.status
config.status: creating Make.rules
config.status: creating Makefile
config.status: creating en/Makefile
config.status: creating fr/Makefile

Configure finished.  Do 'make' to compile the documentation.

make[1]: Entering directory `/usr/local/src/docs/en'
docbook2html -u winedev-guide.sgml
Using catalogs: /etc/sgml/sgml-docbook-3.1.cat
Using stylesheet:
/usr/share/sgml/docbook/utils-0.6.14/docbook-utils.dsl#html
Working on: /usr/local/src/docs/en/winedev-guide.sgml
Done.
docbook2html -u wineusr-guide.sgml
Using catalogs: /etc/sgml/sgml-docbook-3.1.cat
Using stylesheet:
/usr/share/sgml/docbook/utils-0.6.14/docbook-utils.dsl#html
Working on: /usr/local/src/docs/en/wineusr-guide.sgml
Done.
docbook2html -u winelib-guide.sgml
Using catalogs: /etc/sgml/sgml-docbook-3.1.cat
Using stylesheet:
/usr/share/sgml/docbook/utils-0.6.14/docbook-utils.dsl#html
Working on: /usr/local/src/docs/en/winelib-guide.sgml
Done.
docbook2html -u wine-faq.sgml
Using catalogs: /etc/sgml/sgml-docbook-3.1.cat
Using stylesheet:
/usr/share/sgml/docbook/utils-0.6.14/docbook-utils.dsl#html
Working on: /usr/local/src/docs/en/wine-faq.sgml
Done.
make[1]: Leaving directory `/usr/local/src/docs/en'
make[1]: Entering directory `/usr/local/src/docs/fr'
PERLLIB=../po4a/lib perl ../po4a/po4a-translate -v -f sgml -m
../en/wineusr-guide.sgml -p ./wineusr-guide.po -l wineusr-guide.sgml -k 1
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: msgid skipped to help translators (contains only tags)
po4a::sgml: nsgmls is missing or non-functional
make[1]: *** [wineusr-guide.sgml] Fout 2
make[1]: Leaving directory `/usr/local/src/docs/fr'
make: *** [fr/__html__] Fout 2

I also tried make html en (since I have no use for the French version
either); that also failed with the same error, but that may not be a
valid command -- the README doesn't really say that I can combine the
<type> and <lang> switches, but I thought I'd try.

I already had docbook-sgml-utils, opensp, openjade, and tetex installed,
so I as far as the README goes, I had all the dependencies. So I
additionally installed docbook-sgml and sgmltools-lite just to cover any
possible missed bases), and then thought to just run make en, which
succeeded.

So I have no idea whether installing docbook-sgml and sgmltools-lite had
any effect, or whether make html is just not properly working for some
reason, but I thought I should report the experience.

Holly