On 2007-03-19, Joerg van den Hoff <[EMAIL PROTECTED]> wrote:
> question: what are the ideas for achieving formatting? should this be written 
> as a troff
> manpage like the real manpage (might be OK)? or what else? 

If it is written in troff/*, then definitely as an additional
'ion3tutorial' man page. 

One option might be to use markdown, which generates HTML. That's
what the Ion README, the site, etc. are written in these days. You
can obviously turn that into a text file with e.g. lynx -dump, and
maybe into PDF too in some automated way. The sucky thing is the
extra dependencies, if it's included in the Ion distribution. (I do
not like ReST etc.; markdown seems to be the only one of these ASCII
markup language with at least a bit of moderation on the amount of
special syntax.) But maybe having it as a man page would be better...

But, no, Mod1+F1 should not be changed from displaying the reference
man page. F12 -> 'tutorial' should suffice -- and displaying this
tutorial and how to get to it in the welcome message.

-- 
Tuomo

Reply via email to