question about documentation

[David Collier-Brown]

Gerald (Jerry) Carter wrote
> >Can I bring up the issue of writing docs in
> >YODL format again?  Will I be punished openly
> >for doing so?  :-)
> 
Fredrik Viklund wrote:
> For this task, a format that is potent of generating text, html and man
> pages would be enough.
> Why not POD? Another way that would work is to use a HTML-template

	If you do **information preserving** translations,
	it really doesn't matter what you write in as long
	as you can translate it to the lingua fraca of a site.

	If someone wants to write in gronk* and translate to
	YODL, send me a gronk manual and I'll send you an
	awk script back, for you to improve on... hacking
	the translate script will probably teach you enough
	YODL you can write natively in it after a few days.

-- dave
[* Gronk: the noise the caveman makes in BC.  Not **currently** a
   scripting language.]
-- 
David Collier-Brown,  | Always do right. This will gratify some people
185 Ellerslie Ave.,   | and astonish the rest.        -- Mark Twain
Willowdale, Ontario   | //www.oreilly.com/catalog/samba/author.html
Work: (905) 415-2849 Home: (416) 223-8968 Email: davecb at canada.sun.com