[oclug] Topics for upcoming meetings

[Sandy Harris]

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
	PDF
	Postscript
Given that, it no longer seems necessary to convert the FreeS/WAN docs to
DocBook.