Hi,

Months ago I proposed some improvements to the manual.  With a gentle
reminder from Andy Wingo, I have finally started breaking up my original
giant patch into some manageable patches.  The first patch is nearly
trivial, and the second is simple changes to many files.

The second patch tries to make the usage of variable names more
consistent and goes after simple, blatant cases.  A hypothetical
example is

@deffn {Scheme Procedure} bitvector-ref vec idx
@deffnx {C Function} scm_bitvector_ref (vec, idx)
Return the element at index @var{idx} of the bit vector
@var{vector}.
@end deffn

We change "vector" to "vec" or vice versa.  There are a few cases where
names that are consistently used *within* a definition are still changed
to conform with usage in surrounding function definitions.

One way I plan to shorten patches is based on the kind of files to be
patched, .texinfo, .scm, .c, etc.  Thus, the next patches I will send
will be similar changes for docstrings in .scm and .c files.

Thanks for any comments!

Bake