[oclug] Topics for upcoming meetings
sandy at storm.ca
Thu Feb 22 02:14:04 EST 2001
Richard Guy Briggs wrote:
> > > - Developing documentation using DocBook: DocBook has become the
> > > documentation format used by many different free software and
> > > open source projects, including among many the Linux Documentation
> > > Project (LDP) - what is it? how do you use it? what
> > > tools are out there? what are the advantages? why should you care?
> DocBook is something that I would like to learn, but haven't put
> aside the time to do. Sandy Harris, would you be willing to do a
> presentation about DocBook in conjunction with Dan?
That would be problematic. I've never actually used it.
I think DocBook is a fine idea, and it's what I'd use for any new doc project
I was starting. I've read the O'Reilly DocBook book (www.docbook.org), gone to
OLS discussions of it, ... At one point I was going to convert all the FreeS/WAN
docs from HTML to DocBook; I even had some of the sh/sed scripts written.
However, I started the FreeS/WAN docs (www.freeswan.org) in HTML which seemed
the best idea at the time, and I've found a GPLd tool, htmldoc (www.easysw.com),
that will take a bunch of HTML files and produce:
HTML with next/top/previous links plus a global table of contents
one big HTML file
Given that, it no longer seems necessary to convert the FreeS/WAN docs to
More information about the OCLUG