Re: gEDA-user: file format documentation section of manual

[sdb@xxxxxxxxxx (Stuart Brorson)]

> > BTW: I don't mind of the PCB maintainers put my doc on their website,
> > or create a link to it.
> 
> Could you be convinced to help improve the pcb documentation itself?
> No sense maintaining multiple repositories of information, if it can
> be avoided.

Sure!  However, I'll warn you first that I'd take a buzz-saw to the
current documentation.  It would look radically different were I to
work on it.

My style of technical documentation relies heavily on tables,
bullet-item lists, and drawings.  I try to avoid prose as much as
possible since verbosity doesn't improve clarity.  I hope you get that
impression from the newlib footprint doc. 

I'd also jettison .tex and write it in OOWriter, and export .pdf.  You
could include both the .sxw and the .pdf files in your distribution
tarballs. 

Can you and Dan and Harry live with radical changes to your doc?  I do
believe I would improve it, but it would look a lot different.

Stuart