Subject: Re: 2.0 Guide
To: Jason R. Fink <jrf@NetBSD.org>
From: Hubert Feyrer <hubert@feyrer.de>
List: netbsd-docs
Date: 04/10/2004 12:54:54
On Sat, 10 Apr 2004, Jason R. Fink wrote:
> 1) Should we branch or just include a 2.0 compliant version
> of the guide at shipping time? I do not know the best answer,
> but, many of our CD makers are shipping the Guide. That really
> pushes me towards branching (which cracks me up, 2 years ago I
> would have been dead set against it but we are getting popular!).

Don't branch - too much maintenance effort, and it's not like there's
constant updates. We can always do it if someone wants to do a major
rewrite for 2.1/3.0.


> 2) Problems
> Hubert's network page is still broke, the next link does not work.

Um, dunno what that is, because i have another issue:

3) the build process is not very transparent.
when typing 'make', it should be checked if the pkgs needed to do the
translation are installed, and if not a warning with instructions should
be printed.

right now I'm getting:

	miyu% cd /usr/cvs/htdocs/guide/en/
	miyu% make
	env SGML_CATALOG_FILES= XML_CATALOG_FILES=/usr/pkg/share/xml/catalog /usr/pkg/bin/xsltproc --nonet --catalogs   --param manifest "'HTML.manifest'" --param toc.section.depth "'1'" --param toc.max.depth "'8'" --param generate.section.toc.level "'0'" --param section.autolabel "'1'" --param section.label.includes.component.label "'1'" --param netbsd.url.image.bsddaemon "'../../images/BSD-daemon.jpg'" --param netbsd.url.disclaimer "''" --param html.stylesheet "'/NetBSD.css'" --param use.id.as.filename "'1'" --param citerefentry.link "'1'" --param root.filename "'index'" --param html.ext "'.html'" --param chunk.first.sections "'0'" --param chunk.section.depth "'0'" --param generate.manifest "'1'"  /usr/cvs/htdocs/guide/en/share/default-html-chunk.xsl default-chunk.xml
	warning: failed to load external entity "/usr/pkg/share/xsl/docbook/html/chunk.xsl"
	compilation error: file /usr/cvs/htdocs/guide/en/master-chunk.xsl line 11 element import
	xsl:import : unable to load /usr/pkg/share/xsl/docbook/html/chunk.xsl
	*** Error code 5

	Stop.
	make: stopped in /usr/cvs/htdocs/guide/en
	miyu% ls -la "/usr/pkg/share/xsl/docbook/html/chunk.xsl
	ls: /usr/pkg/share/xsl/docbook/html/chunk.xsl: No such file or directory

It would be nice to know which pkg to install now...


 - Hubert

-- 
Hubert Feyrer <hubert@feyrer.de>