[TCLCORE] Re: Documentation

[Jeffrey H. <jef...@aj...>]

As soon as we can get the effort rolling, we want to make XML the
base format for all docs, with converters to man/html/winhelp/etc.

Starting with pod is definitely not an alternative.  Note that
many perl'ers don't even like pod's limitations.  No need to waste
effort there when we can start fresh with XML.

Jeffrey Hobbs                     Tcl Ambassador
ho...@Aj...          Ajuba Solutions (nee Scriptics)

> -----Original Message-----
> From: Mo DeJong [mailto:md...@cy...]
	...
> On Thu, 3 Aug 2000, Larry W. Virden wrote:
> 
> > Re: what format for doc
> > 
> > The problem with choosing HTML is that currently that makes the 
> > doc unreadable by TkMan.  It would be much better to provide doc 
> > in one of the several formats that it reads.
> > 
> > Note that if one doesn't know *roff, there is always the pod2man 
> > filter that will convert from Perl's relatively simple format 
> > into a man page...
> 
> I thought the docs were going to be written in XML and then
> get converted to HTML or whatever. It seems that people are
> going to complain about any one format that is picked.

--
The TclCore mailing list is sponsored by Ajuba Solutions
To unsubscribe:  email tcl...@aj... with the 
                 word UNSUBSCRIBE as the subject.