Re: [Geiser-users] Problems with references in Geiser/doc/repl.texi

[Mark Harig]

> > The new cross reference macros have improved the Info text in
> > many cases, but there are still some problems with some of them.
>
> Yes, that was work in progress (sorry for not sending a heads-up). 
I've
> pushed a patch that, i think, pushes all the issues you've detected.

Your latest changes have fixed almost all of the grammar problems with
cross references in Info text.  Here are a few remaining ones that I
found:

--- Texinfo source: (in parens.texi)

Thus, a common usage pattern will be for you to first call
@code{run-geiser} or one of its variants
(@pxref{choosing-impl,choosing implementations}), and then open some
Scheme files; but there's nothing wrong in first opening a couple
Scheme buffers and then starting the REPL (you can even find it more
convenient, since pressing @kbd{C-c C-z} in a Scheme buffer will start
the REPL for you).


Info text:

Thus, a common usage pattern will be for you to first call
`run-geiser' or one of its variants (see choosing implementations.),
and then open some Scheme files; but there's nothing wrong in first
opening a couple Scheme buffers and then starting the REPL (you can
even find it more convenient, since pressing `C-c C-z' in a Scheme
buffer will start the REPL for you).

Note the period inside the parenthetical expression:
  "...(see choosing implementations.),..."


--- Texinfo source: (in parens.texi)

If you've customized @code{geiser-active-implementations} so that it's a
single-element list (as explained @ref{choosing-impl,,here}), that
element is used as the chosen implementation.


Info text:

If you've customized `geiser-active-implementations' so that it's a
single-element list (as explained see here.), that
element is used as the chosen implementation.

Note the period inside the parenthetical expression, and the
extraneous "see":
  "... (as explained see here.),..."


--- Texinfo source: (in repl.texi)

If you've followed the indications in @ref{Setting it up}, your Emacs is
now ready to start playing.

Correction:

I think that you intended the word "instructions" where you used
"indications," correct?


> --
> If you could kick in the pants the person responsible for most of your
> trouble, you wouldn't sit for a month. — Theodore Roosevelt