Re: [avrdude-dev] avrdude documentation

[Brian Dean]

On Tue, Feb 25, 2003 at 04:50:19PM -0700, E. Weddington wrote:

> His doc has been in the process of being rolled into avr-libc. :-)

Do you guys have his markup source?  It may make things a bit easier
for me to get started to go by example.

> As a last thought, what are the tools used to convert to HTML and 
> PDF?

Looking at how the FreeBSD documentation is produced, the doc folks
provide us with a nice 'docproj' port that installs all the necessary
stuff.  I think the primary tool used is called 'jade', to which you
specify a '-t' option to generate the different output types.  For an
example of this, see:

  
http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/examples-formatted.html

The following seems to be an excellent tutorial on using DocBook:

  http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/index.html

This appears to be what new FreeBSD documentation contributers are
indoctrinated with :-), but I'm sure most of it applies to DocBook in
general.

> I've been in the process of writing up the raw material for the 
> Windows specific portions. Right now it's just plain text.

Should be easy enough to mark up into docbook.  I can help, once I
learn, myself :-)

-Brian
-- 
Brian Dean
address@hidden
http://www.bsdhome.com/
http://www.bdmicro.com/