guix-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Fix grammar and markup (was Re: Feedback of the GNU Guix manual)


From: pelzflorian (Florian Pelz)
Subject: Re: Fix grammar and markup (was Re: Feedback of the GNU Guix manual)
Date: Sat, 13 Apr 2024 13:26:39 +0200
User-agent: Gnus/5.13 (Gnus v5.13)

Hello Matt.  Thank you for fixing the oversight.  However:

Matt <matt@excalamus.com> writes:
> From: Matthew Trzcinski <matt@excalamus.com>
> Date: Sat, 13 Apr 2024 10:12:05 +0200
> Subject: [PATCH] doc: Fix cross-references
>
> * doc/guix.texi (Setting Up the Daemon): use @xref to start sentence.
> (Build Systems): capitalize "python" and start parenthesized reference with
> @pxref.
> (Linux Services): use @xref to start phrase.

@xref produces a capital See instead of see.  This should be @pxref.
See the Texinfo manual “info texinfo” or the Web manual Ludo points to.

In info, this will use the word *note instead of *see, but it’s still
right, if Matt you agree.

> (Configuring the Shell): use @xref to start phrase.

This should be @pxref.

Additionally, the commit message’s first sentence should end with a
period.  The sentences in the commit message describing a section should
start with a capital letter.

Regards,
Florian



reply via email to

[Prev in Thread] Current Thread [Next in Thread]