stdcxx-dev mailing list archives

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

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.

Marc

-----Original Message-----
From: Martin Sebor [mailto:sebor@roguewave.com] 
Sent: Thursday, August 25, 2005 8:51 AM
To: Marc Betz
Cc: stdcxx-dev@incubator.apache.org
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?

Martin

Mime
View raw message