incubator-stdcxx-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Marc Betz <>
Subject RE: stdcxx documentation format (was Re: stdcxx)
Date Thu, 25 Aug 2005 15:57:30 GMT

The current conversion process goes like this:

FrameMaker => SGML(or XML, if you prefer) => whatever

So, you see, we already produce XML. The output was based on the docbook
SGML standard of many years ago. I have made changes over the years that did
not necessarily stick to docbook, so I am sure the current output, although
still close to docbook, is not altogether compliant.

If the community would like to see the XML output we currently produce, that
would be fine.


-----Original Message-----
From: Martin Sebor [] 
Sent: Thursday, August 25, 2005 8:51 AM
To: Marc Betz
Subject: stdcxx documentation format (was Re: stdcxx)

Alessio Marchetti wrote:
> Martin Sebor wrote:
>> FYI: The docs were generated from the original FrameMaker master 
>> sources.  There might be other formats that FrameMaker can generate 
>> but I believe HTML was considered the easiest one of them for the 
>> community to work with. If you have a suggestion for a different 
>> format that we could generate from the master sources that would 
>> easier to work with, let me know so we can regenerate them now before 
>> any changes have been made.
> my suggestion is to generate XML docbook 4.3
> don't know how easy would that be to move form your FrameMaker MIF 
> file
> to XML with the tools that you have available, but XML docbook is 
> definitely a pretty standard approach

Let me pass this on the Marc, our techdocs person, to see what he thinks
about the idea (if it's even possible). Marc?


View raw message