Re: [TCLCORE] nroff (was Re: gsoc ideas)

[Larry M. <lm...@bi...>]

On Fri, Mar 09, 2012 at 06:21:38AM +1000, Steve Bennett wrote:
> On 09/03/2012, at 5:27 AM, Larry McVoy wrote:
> 
> >> However, the one real limitation I found is 
> >> that it can't handle screenshots.  This makes Tk docs much less 
> >> friendly.  In the same manner that adding examples to the Tcl docs was a 
> >> real boon for the user, we've never been able to pictorialize for Tk.
> >> 
> >> I'd be up for switching to a doc format that could manage that well. 
> >> Maybe the rest format would satisfy?
> > 
> > groff can handle screenshots just fine but people seem to have a tough time
> > with that.
> > 
> > What about pod?  I whipped up a somewhat pod compat tool in L (which runs
> > on tcl) that produces stuff like this:
> > 
> > http://www.mcvoy.com/lm/L/l.html
> > 
> > input was this:
> > 
> > http://www.mcvoy.com/lm/L/l.pod
> 
> asciidoc is another option.
> 
> http://jim.tcl.tk/fossil/doc/trunk/Tcl_shipped.html
> 
> generated from:
> 
> http://jim.tcl.tk/fossil/doc/trunk/jim_tcl.txt

The bummer is that you have to do the index in that format, or at least
that's how your example came.  Pod can generate that for you automagically,
at least mine can.
-- 
---
Larry McVoy                lm at bitmover.com           http://www.bitkeeper.com