Doc BoF at EuroBSDCon

Ceri Davies ceri at submonkey.net
Mon Nov 29 11:08:21 UTC 2004


On Mon, Nov 29, 2004 at 06:03:20AM +0000, Nik Clayton 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)
> > 
> >   - des agreed to make a script for the actual conversion of the files
> >     from SGML to XML.
> > 
> >   - With SGML -> XML conversion we will loose the "IGNORE"
> >     functionality from SGML, but it is not widely used, and where such
> >     functionality is needed it can e.g. be handled in other ways.
> >     This is used to be able to build sub directories in the Handbook,
> >     but this has been broken for a while and nobody has complained
> >     about that yet...
> 
> In case you're not aware, 'xml' is a supported output FORMAT.  You
> should be able to do
> 
>     make FORMAT=xml
> 
> in any of the document directories and get book.xml or article.xml
> generated as appropriate.
> 
> I strongly recommend that you do this and experiment with getting an
> XML/XSL toolchain in place *before* doing a full cutover to XML.
> 
> You are also aware of doc/share/xsl, right?  And that you can do:
> 
>     make STYLESHEET_TYPE=xsl ...
> 
> ?

It doesn't work properly.

Ceri
-- 
Only two things are infinite, the universe and human stupidity, and I'm
not sure about the former.			  -- Einstein (attrib.)
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
URL: <http://lists.freebsd.org/pipermail/freebsd-doc/attachments/20041129/d7bbee99/attachment.sig>


More information about the freebsd-doc mailing list