Mock-up html manual page



--- "Vadim V. Zhytnikov"  wrote:
> Looks really nice!

Thank you for your kind words. I appreciate it.

> I suggest to boldface not a whole input lines including
> (%i) prompts but only the input which user really types.  

That makes good sense. Doubtless the format can be further polished.

> And now one big question.  If we are going to adopt
> this nice style then the whole Maxima manual need
> a major rewrite.  Are we going to do this?  When?

Well, let me try to address this and the similar concern
voiced by Viktor Toth. 

By far the most time consuming part of editing the texinfo
files is attempting to piece together the available evidence
(texinfo, other docs, source code, mailing list remarks) to
form a coherent picture of each topic. Any formatting project
is a much smaller undertaking.

The major change to the texinfo files to support an html format
project would be to reorganize the topics. We would have to 
work out a suitable categorization and then edit the texinfo's 
accordingly. This reorganization is needed whether or not there 
is any new html format.

I would propose that a script or scripts (maybe just a texi2html
configuration) to munge texinfo into a nicer html format be 
developed independently of the texinfo files themselves. 
Once the formatting has progressed enough, we replace the 
existing texi2html and everybody's happy.

As to resource allocation, my only question is, if appropriate
stuff were written, would the project refuse it? I hope not.

For what it's worth,
Robert Dodier



		
__________________________________ 
Do you Yahoo!? 
Yahoo! Mail - now with 250MB free storage. Learn more.
http://info.mail.yahoo.com/mail_250