Jack Carroll wrote:
So, being the person who sparked a lot of this debate, I figured I'd chime in. I don't know DocBook or LaTex either. And quite frankly I don't care to learn either one so I'm not going to weigh in on the debate of which we should use. Actually, that's not entirely true. If I had to choose between the two, it would be DocBook. As a side note, here is a good list of DocBook authoring tools: http://wiki.docbook.org/topic/DocBookAuthoringTools. I'll pick up enough of the chosen on to be able to contribute to the documentation of this project.The discussion the other day sounded as though a consensus was emerging that the preferred authoring format should be either DocBook or LaTex. My biases... I don't know either DocBook or LaTex. If I have to learn one or the other, I'd rather learn DocBook. It looks to have more of a future, and it appears to be more versatile just because it's built from the ground up to tag for structure rather than layout. Also, LDP has gone that way, and there's an argument for doing what LDP does just because LDP is doing it. They have massive experience at multiple-author documentation, and could save us from having to re-invent some wheels. Their solution to importing Wiki directly into DocBook is an example.
A couple examples of the end goals of all this documentation (Intel MCS251 series docs):
ftp://download.intel.com/design/mcs51/MANUALS/27313802.pdf
ftp://download.intel.com/design/mcs51/MANUALS/27261701.pdf
Patrick M
_______________________________________________ Open-graphics mailing list [email protected] http://lists.duskglow.com/mailman/listinfo/open-graphics List service provided by Duskglow Consulting, LLC (www.duskglow.com)
