I may be coming into this a bit late, but I don't think I saw this
suggested - why not do the docs, one-and-for-all in XML? This is exactly
the kind of problem that XML (or rather SGML) was invented to solve, and is
the most elegant and flexible solution (IMHO).
That way one could more or less easily write filters to generate:
1. HTML
2. PDF
3. WinHelp ( which is being phased out anyway in favor of (4) )
4. MS/HTML Help
5. RTF for printing
In addition, you could:
1. use sgmltools under Linux/Unix to generate gnu info, etc.
2. write intelligent grep'ing tools
3. write (for example) a nice (cross-platform) Java program to browse and
search the docs, using one of the many excellent XML parsing toolkits
available
By using XML, the docs would be represented in the least "proprietary"
format and one that is could be easily converted to whatever output format
you want, and nobody feels "left out".
Another nice thing would be if Palm put a searchable (and cross-referenced)
API ref on the web, so those of us lucky enough to have good connectivity
could search that (instead of PDF's, or whatever). But perhaps this would
best be left for another discussion ;-)
