documentation



On Sunday 28 December 2008 07:04:01 Robert Dodier wrote:

> OK by me, if you want. A couple of comments. I would write
>
> blurf : mumble + 1 $
>
> i.e. put a space between the last bit and the dollar sign.

Yes, it is more readable for the "$" sign.

> Also, the existing examples were mostly generated with the
> global variable linel = 65. That helps examples stay within the
> text width for .info and .html output. I guess you have the default
> value.
>
> You might use the script doc/info/update_examples to regenerate
> the @example stuff. See: doc/info/README.update_examples
> You might discover the displayed results have diverged slightly
> since they were last generated; I guess bringing them up to date is
> a good idea.

OK, I'll do it with linel = 65 and update_examples.


Also I would replace something like

  @example
                                   inf
                                   ====   k
                                   \     z
                          Li (z) =  >    --
                            s      /      s
                                   ====  k
                                   k = 1
  @end example

with

  @tex
  $${\rm Li}_s \left(z\right) = \sum_{k=1}^\infty {z^k \over k^s}$$
  @end tex

  @ifnottex
  @example
                                   inf
                                   ====   k
                                   \     z
                          Li (z) =  >    --
                            s      /      s
                                   ====  k
                                   k = 1
  @end example
  @end ifnottex

if no one objects.


On Sunday 28 December 2008 14:34:53 Mario Rodriguez wrote:
> I also suggest to check how the output is rendered in the pdf
> documents. Sometimes the lines are too long for the available
> width.

I hope linel = 65 is enough.

-- 
Boomtime, Aftermath 70 YOLD 3174
Alexey Beshenov  http://beshenov.ru/