No subject

of the structural markup languages (DocBook or LaTeX) as an
"intermediate format".  Write translators from each of your source
formats, and have them emit DocBook or LaTex.  Then, you can have
independent output chains for the different formats you want.  I
believe this is already what you have planned, but it's not quite
clear.

(Aside: as a developer, I have a personal preference for documentation
that is *not* in a WYSIWYG format, even machine-readable like PDF.
PDF still requires dedicated tools -- text-based formats allow me to
use common tools such as grep and friends.  Having good HTML or SGML
formats is therefore a worthwhile goal, even if the managers don't
think so right now -- you said this stuff is going to be used by
developers for years; make sure it's in a format that they can use
easily.)

Thinking about all this a little more, and I think that rather than =
going directly to latex you might want to consider going to an =
intermediate form like xml.  Then you can write xslt macros to convert =
the xml to latex, html, pdf, info, etc.  The poin being that xml is =
designed to be easily processed into something else, but latex is only =
well designed to be processed into dvi.  Given that most of the word =
processors are going into an xml format, you could probably even convert =
to staroffice or abiword format pretty easily.

--Michael


------_=_NextPart_001_01C2A245.6E708AB8
Content-Type: application/ms-tnef;
	name="winmail.dat"
Content-Transfer-Encoding: base64

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
1HMa0DkANTEJwb8zQDryA1AIkC+xNzFIJcENK1FnNFAl8EhUTUz5NIJTR1pAOgtD8jIBS3HrBbBK
kncXwWgtcAMQLhD/WdAHQE+VBpAx8wOBHzE4UfFMUG4ndE0mC4A0cC7R/R5xaAVARrAH4FQxMEIf
IPcl4UOzMkB1ASBD8lnQK0LPMNEukDDyJfBieSwESZf3QFQiABPxOzLhMBFXsFxh30ZjTmM2xDHx
ZwNlRJA98g8xASwEONAAkGx5Lin/LAojcF/hK0IBoD+RVYJDpP9JcC/wAkBQ4QRgGCA61EpA/1/E
TYMrwFvyZyIDoGKUNmD/GCApoGjgMMI4EQ7AMDM74P9gcjCGBaAAgSeSYpcDkTX/sS/keG1sPSU9
p3c3c/54OAAFQADBA2Bb0XCjLgD/ACAx83OBbwcvMGCAc5AvMGhwZGYvMW4CEE+RdP5jPSRFgGKh
YxFisy2CdsL/Q9EuMR6ARdFi5WikS1E0IP8fAS6hchEu4C7QB4Bfwitgf0NAFBBGBG9EQ9ECIG7h
d29DQAMges18LWQl0DcxR/5pT8JNgwRgMkA5EjICXLH/JfB8JThCCsBdQitCfMMDkf92wk82PbMn
YnwSVLACYESQ/0+zdgd88QGQA2ABIA3gMSH7BcABoGmDM2bFS2ECQIche2i0HVxNDeAT4ENALAR9
AYywAB4ANRABAAAAQQAAADwzNDMwQjlBNjBFOTM1NjRGQUIzQjU4NjEzMzVDQkRDRjM4OTNDOUBn
ZXJtYW5pdW0ubnVtZXRob2RzLmNvbT4AAAAAHgBHEAEAAAAPAAAAbWVzc2FnZS9yZmM4MjIAAAsA
8hABAAAAHwDzEAEAAABKAAAAUgBFACUAMwBBACAAWwBsAHUAZwBdACAAVAB5AHAAZQBzAGUAdAB0
AGkAbgBnACAAUAByAG8AZwByAGEAbQBzAC4ARQBNAEwAAAAAAAsA9hAAAAAAQAAHMJAP2etEosIB
QAAIMPT/hW5FosIBAwDeP+QEAAADAPE/CQAAAB4A+D8BAAAADwAAAE1pY2hhZWwgSGlyc2NoAAAC
Afk/AQAAAGAAAAAAAAAA3KdAyMBCEBq0uQgAKy/hggEAAAAAAAAAL089TlVNRVRIT0RTL09VPUZJ
UlNUIEFETUlOSVNUUkFUSVZFIEdST1VQL0NOPVJFQ0lQSUVOVFMvQ049TUhJUlNDSAAeAPo/AQAA
ABUAAABTeXN0ZW0gQWRtaW5pc3RyYXRvcgAAAAACAfs/AQAAAB4AAAAAAAAA3KdAyMBCEBq0uQgA
Ky/hggEAAAAAAAAALgAAAAMA/T/kBAAAAwAZQAAAAAADABpAAAAAAAMAHUAAAAAAAwAeQAAAAAAe
ADBAAQAAAAgAAABNSElSU0NIAB4AMUABAAAACAAAAE1ISVJTQ0gAHgAyQAEAAAAPAAAAdGtpbEBz
Y3J5ZS5jb20AAB4AM0ABAAAADwAAAHRraWxAc2NyeWUuY29tAAAeADhAAQAAAAgAAABNSElSU0NI
AB4AOUABAAAAAgAAAC4AAAALACkAAAAAAAsAIwAAAAAAAwAGEI0FuygDAAcQFwUAAAMAEBAAAAAA
AwAREAAAAAAeAAgQAQAAAGUAAAAtLS0tLU9SSUdJTkFMTUVTU0FHRS0tLS0tRlJPTTpUS0lMTUFJ
TFRPOlRLSUxAU0NSWUVDT01TRU5UOlRIVTEyLzEyLzIwMDI1OjQ3UE1UTzpEQVZJRE1PUlJJU0ND
OkJPVUxEAAAAAAIBfwABAAAAQQAAADwzNDMwQjlBNjBFOTM1NjRGQUIzQjU4NjEzMzVDQkRDRjM4
OTNDOUBnZXJtYW5pdW0ubnVtZXRob2RzLmNvbT4AAAAARhw=

------_=_NextPart_001_01C2A245.6E708AB8--