From owner-freebsd-doc@FreeBSD.ORG Thu Dec 2 20:10:18 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 9914516A4CE for ; Thu, 2 Dec 2004 20:10:18 +0000 (GMT) Received: from zaphod.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id 2A00D43D31 for ; Thu, 2 Dec 2004 20:10:18 +0000 (GMT) (envelope-from simon@zaphod.nitro.dk) Received: by zaphod.nitro.dk (Postfix, from userid 3000) id 4171F11A5F; Thu, 2 Dec 2004 21:10:17 +0100 (CET) Date: Thu, 2 Dec 2004 21:10:17 +0100 From: "Simon L. Nielsen" To: Murray Stokely Message-ID: <20041202201016.GL753@zaphod.nitro.dk> References: <20041128202656.GL750@zaphod.nitro.dk> <20041128212851.GB48499@freebsdmall.com> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="pWJxWxNlJUNgDlXi" Content-Disposition: inline In-Reply-To: <20041128212851.GB48499@freebsdmall.com> User-Agent: Mutt/1.5.6i cc: freebsd-doc@freebsd.org Subject: Re: Doc BoF at EuroBSDCon X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 02 Dec 2004 20:10:18 -0000 --pWJxWxNlJUNgDlXi Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2004.11.28 13:28:51 -0800, Murray Stokely wrote: > On Sun, Nov 28, 2004 at 09:26:57PM +0100, Simon L. Nielsen wrote: > > - Changing doc from SGML to XML (yes, really do it this time) > >=20 > > - des agreed to make a script for the actual conversion of the files > > from SGML to XML. >=20 > What new applications do people have in mind that this enables? I must admit that I don't have any specific plans. > Is the plan to phase out DSSSL at this point? The stylesheet work > should be more difficult than converting SGML files to XML, but it's > not mentioned here. I have not personally looked into the specific toolchain issues. The last time I chekked DSSSL was still required for print (ps/pdf/etc.) output, though HTML could be done entirely with XSL. > The XSL support is partly broken. In general or just in the FreeBSD doc makefiles? > > - It was suggested to move chapter files to the main directory e.g. > > en_US.ISO8859-1/books/handbook/x11/chapter.sgml -> > > en_US.ISO8859-1/books/handbook/x11.sgml, since there does not seem > > to a big point in all the sub directories, and make does not like > > the sub directories well.. >=20 > You don't need a makefile in each subdirectory since you'll be > removing the ability to build only a single chapter, so there is no > make consideration here. The consideration is that make(1) (in my experience) is much simpler if you don't have a lot of "arbitrary" directories. In dependencies etc. you don't have to deal with directories. E.g. one of the currently broken things wrt. to OBJDIR support is the subdirectories for IMAGES_EN, which is a pain to fix (I have tried) since the image filenames contain a directory (it's a bit since I looked at it so I could be remembering the details incorrectly). > Directories aren't an issue if you just XInclude the > /chapter.xml from the root book.xml, When you get to that point I don't think it matters much (both for SGML and XML), it's mostly with regard to make(1) the diretories cause problems. > and the directories > provide a natural place for the language-specific image files for a > given chapter. Yes, that is a plus. A minus IMO is when dealing patches, you very often can't just "cd foo/bar/handbook ; patch I don't see any need to remove the directories. At least it seems > unrelated to the other goals. Certainly. I just think they are more painful than useful, which is why I brought it up as a possibility at the BOF. --=20 Simon L. Nielsen --pWJxWxNlJUNgDlXi Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.6 (FreeBSD) iD8DBQFBr3aoh9pcDSc1mlERAgMNAJ9VHistms1HxFow1NKpEhreUKiG8QCgv8oM 5i1eKnszGA1l6uarCmvmqi0= =N7WC -----END PGP SIGNATURE----- --pWJxWxNlJUNgDlXi--