Re: [corrector(s) needed] doc/lispref/internals.texi tweaks

[Eli Zaretskii]

> Date: Wed, 14 Nov 2012 20:30:57 +0400
> From: Dmitry Antipov <address@hidden>
> CC: Emacs development discussions <address@hidden>
> 
> >> Date: Mon, 12 Nov 2012 15:20:47 +0400
> >> From: Dmitry Antipov <address@hidden>
> >>
> >> There are some bits for doc/lispref/internals.texi, which looks a bit
> >> outdated and incomplete...
> >
> > Thanks, some comments below.
> 
> Great thanks! Do you have the patience for one more round?

Yep.

> address@hidden returns a list with information on amount of space
> +in use, where each entry has the form @samp{(name size used)} or
> address@hidden(name size used free)}.  In the entry, @samp{name} is a symbol

Here, "name", "size", "used", etc. stand for something else, so they
should be in @var, both inside @samp and in the text that describes
them.

> address@hidden cons-size
> +Internal size of a cons cell, e.g. @code{sizeof (struct Lisp_Cons)}.

If you have a period that doesn't end a sentence and is followed by a
space, put a @: between the period and the space, so that the
typesetter will know this isn't the end of a sentence, and typesets
the space correctly.  IOW, "e.g.@:".  And I think you mean "i.e.", not
"e.g." here (and elsewhere in this table).

> +when the threshold is exhausted, but only the next time the Lisp evaluator
> +is called.

"Lisp interpreter", I think.

> +bits is the value itself.  Integer values are immediate, e.g. directly
                                                            ^^^^
"i.e.@:"

> +it's equal to the width of an underlying platform pointer (e.g. 32-bit on
                                                              ^^^^
"i.e.@:"

Thanks.