Re: documentation



On Sun, 2004-11-14 at 04:06, Vadim V. Zhytnikov wrote:
> I suggest the following scheme:
> 
> 1. Change all function and variable definitions, sample sessions,
> and in-text pieces of code to LC according to current Maxima CS
> convention.
> 
> 2. Put all in-text pieces of code into @code{}.  In printed
> material @code{foo} is rendered in fixed width typewriter
> font while in text mode (info/pinfo) foo is emphasized
> by surrounding quotes and if possible by brightness.
> IMHO It is very important to make clear distinction between
> common text and Maxima commands in the documentation.

I agree with your proposal.

> I also noticed that some session samples are too wide
> and get cropped from the right in printed material.
> Something have to be done with it.  Probably such
> sessions must be recreated with smaller linenum.
> 
> If nobody minds I'll start doing this together
> further .texi clean up (I mean removing or fixing
> outdated pieces).

Great. Please coordinate with Robert.

--Jim