Andreas Enge <andr...@enge.fr> skribis:
> On Wed, Mar 09, 2016 at 12:02:44PM +0300, Alex Kost wrote:
>> I think this should be rephrased, because after this change, makeinfo
>> complains:
>> ./doc/guix.texi:5937: warning: `.' or `,' must follow @xref
>> And in the generated guix.info there is a dot before "and".
>
> Fixed in commit 6e6a04016d292991dcae02bbbe5a3bde616b9092, thanks for
> the report!
-@xref{Invoking guix system} and
-@file{gnu/system/install.scm} in the source tree for more information
+Have a look at @file{gnu/system/install.scm} in the source tree,
+and see also @ref{Invoking guix system} for more information
about the installation image.
No big deal, but in general I think it’s best to just leave the comma
after the closing brace. Quoth the manual (info "(texinfo) @ref"):
The '@ref' command can tempt writers to express themselves in a
manner that is suitable for a printed manual but looks awkward in the
Info format. […]
Ludo’.
