Date: Wed, 01 Nov 2000 16:08:28 -0800 From: David Johnson <djohnson@acuson.com> To: Brian Raynes <brian_raynes@dnr.state.ak.us> Cc: freebsd newbies <freebsd-newbies@freebsd.org> Subject: Re: A sample category Message-ID: <3A00B07C.1692EA57@acuson.com> References: <39FF634E.48ADADF3@acuson.com> <39FF6DA5.6A9F28BF@dnr.state.ak.us> <3A006787.C170BFAC@acuson.com> <3A006FCC.B78140FA@dnr.state.ak.us> <3A008601.4E984627@acuson.com> <3A00A4F3.74C2C615@dnr.state.ak.us> <3A00A8C8.2F1D32F3@acuson.com> <3A00AD9C.33D30721@dnr.state.ak.us>
next in thread | previous in thread | raw e-mail | index | archive | help
Brian Raynes wrote: > After a little thought, I think the DocBook idea is a little better. > I don't know much about DocBook, but isn't it easy to create html, pdf > and ps files from DocBook format? I've really liked the way the > handbook and a few other docs have been distributed this way. I'm not > sure I've ever seen comments handled in document form, but for all the > other information the document format seems easier to setup than a > website and might require fewer resources (hardware & bandwidth). The FDP (FreeBSD Documentation Project) has a great manual on using DocBook. I used it for my own documentation on one of my projects and it was pretty slick. Using jade and dsssl, I created my html doc in 5 seconds. I didn't have TeX installed at the time, or I could have created dvi, ps and pdf just as easily. Read the FDP documentation, as the docs of Jade are pretty dense and incomplete. The O'Reilly DocBook book is wonderful, and if you don't want the dead tree version, it's also online for free. David To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-newbies" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?3A00B07C.1692EA57>