Date: Thu, 17 Jun 1999 18:24:19 -0400 (EDT) From: Spidey <beaupran@jsp.umontreal.ca> To: Nik Clayton <nik@nothing-going-on.demon.co.uk> Cc: freebsd-doc@freebsd.org Subject: Re: Problems making the handbook in stable Message-ID: <14185.30099.185492.37652@freed.dyn.ez-ip.net> References: <199906152359.AAA10668@lonmailhost.lehman.com> <19990616104716.U15628@lehman.com> <14183.47288.83543.419499@freed.dyn.ez-ip.net> <19990616191359.B14519@catkin.nothing-going-on.org> <14184.26980.72039.621126@freed.dyn.ez-ip.net> <19990617195200.B26011@catkin.nothing-going-on.org>
next in thread | previous in thread | raw e-mail | index | archive | help
--- Big Brother told Nik Clayton to write, at 19:52 of June 17:
> On Wed, Jun 16, 1999 at 11:20:04PM -0400, Spidey wrote:
> > --- Big Brother told Nik Clayton to write, at 19:13 of June 16:
> > > On Wed, Jun 16, 1999 at 10:46:16AM -0400, Spidey wrote:
> > > >
> > > > isn't there something missing????? There's only _ONE_ section to the
> > > > handbook, and it's "getting started".
> > >
> > > I can't reproduce that here. What does the HTML.manifest file contain?
> > > It should be a list of all the .html files generated.
> >
> > Ok...
> >
> > HTML.manifest:
> > ==============
> > index.html
> > p33.html
> > introduction.html
> > history.html
> > goals.html
> > development.html
>
> That's far too small. Is that how many .html files were produced as
> well?
Yes. Exactly.
> Which version of the dsssl stylesheets are you using? I've got
> v1.40 installed here, which generates ~ 120 .html files from the
> Handbook.
Hum.. How do I know???
> Out of interest (and to save you time) try doing
>
> % cd doc/en/tutorials/docproj-primer
> % make DOC_PREFIX=../../..
>
> and see what happens then. The Primer is much shorter, so will build
> much faster.
root@freed [06:19pm] spidey# cd /usr/doc/en/tutorials/docproj-primer/
root@freed [06:19pm] docproj-primer# make DOC_PREFIX=../../..
/usr/local/bin/jade -V html-manifest -ioutput.html -c ../../../share/sgml/catalog -c /usr/local/share/sgml/docbook/dsssl/modular/catalog -c /usr/local/share/sgml/docbook/catalog -c /usr/local/share/sgml/jade/catalog -d ../../../share/sgml/freebsd.dsl -t sgml book.sgml
tidy -i -m -f /dev/null *.html
*** Error code 1 (ignored)
/usr/local/bin/jade -ioutput.html -V nochunks -c ../../../share/sgml/catalog -c /usr/local/share/sgml/docbook/dsssl/modular/catalog -c /usr/local/share/sgml/docbook/catalog -c /usr/local/share/sgml/jade/catalog -d ../../../share/sgml/freebsd.dsl -t sgml book.sgml > book.html
tidy -i -m -f /dev/null book.html
*** Error code 1 (ignored)
gzip -9 -c book.html > book.html.gz
root@freed [06:22pm] docproj-primer# ls
HTML.manifest writing-style.html
Makefile x100.html
book.html x110.html
book.html.gz x1184.html
book.sgml x1210.html
chapter.decl x1910.html
chapters.ent x1927.html
doctype-declaration.html x1936.html
elements.html x1946.html
f30.html x1953.html
index.html x1972.html
overview/ x2015.html
overview.html x2041.html
psgml-mode/ x2170.html
psgml-mode.html x2179.html
see-also/ x2188.html
see-also.html x219.html
sgml-escape.html x2194.html
sgml-markup/ x2196.html
sgml-markup.html x2205.html
sgml-primer/ x2214.html
sgml-primer.html x2220.html
stylesheets/ x51.html
stylesheets.html x517.html
the-faq/ x558.html
the-faq.html x641.html
the-handbook/ x644.html
the-handbook-converting.html x685.html
the-handbook.html x731.html
the-website/ x771.html
the-website.html x861.html
tools/ x876.html
tools.html x913.html
writing-style/ x944.html
root@freed [06:22pm] docproj-primer#
> > This is when I "make DOC_LANG=en" but I get a BIG (2Mb?!) handbook
> > compiled if I do "make DOC_LANG=en FORMATS=html".. and it is the
> > complete handbook... but in one file!
>
> As expected. "FORMATS=html" is the "everything in one big file" setting,
> "FORMATS=html-split" is with things split into multiple files.
Yes, but:
root@freed [06:23pm] doc# make DOC_LANG=en FORMATS=html-split
===> FAQ
sgmlfmt -f html-split -links /usr/doc/FAQ/FAQ.sgml
"html-split" is an unknown output format.
Usage:
sgmlfmt [-d <doctype>] -f <format> [-i <namea> ...] [-links]
[-e encoding] [-hdr file] [-ftr file] file
where <doctype> is one of: linuxdoc (default), docbook.
and <format> is one of: ascii, html, koi8-r, latin1, ps, roff
*** Error code 1
Stop.
*** Error code 1
Stop.
root@freed [06:23pm] doc#
ants.
> You can (obviously) combine these, with "FORMATS=html html-split" if you
> want both.
>
> N
> --
> [intentional self-reference] can be easily accommodated using a blessed,
> non-self-referential dummy head-node whose own object destructor severs
> the links.
> -- Tom Christiansen in <375143b5@cs.colorado.edu>
--
Stop the bombings.
Stop the murders.
Anti-war.
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?14185.30099.185492.37652>