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

2024-04-20 Thread Matt
On Fri, 19 Apr 2024 22:56:13 +0200 pelzflorian (Florian Pelz) wrote --- > Hello Matt, pushed as 86fb0e039bf30cf85e2066401f9a384427c47ea8. > > I was bold enough to retain the xref change in (Setting Up the Daemon) > prompted by Ludo, because starting a sentence with @xref is

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

2024-04-19 Thread pelzflorian (Florian Pelz)
Hello Matt, pushed as 86fb0e039bf30cf85e2066401f9a384427c47ea8. I was bold enough to retain the xref change in (Setting Up the Daemon) prompted by Ludo, because starting a sentence with @xref is recommended in the Texinfo manual and its examples, while @pxref at the start of a phrase is not

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

2024-04-18 Thread Matt
On Tue, 16 Apr 2024 08:43:23 +0200 pelzflorian (Florian Pelz) wrote --- > Hi Matt. When triple checking, I read in “info "(texinfo)@pxref"”: > >In past versions of Texinfo, it was not allowed to write punctuation > after a '@pxref', so it could be used _only_ before a right

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

2024-04-17 Thread Maxim Cournoyer
Hi Matt, Matt writes: > On Mon, 15 Apr 2024 14:58:50 +0200 pelzflorian (Florian Pelz) wrote > --- > > > Do you agree that I should commit your docs correction with @pxref? > > I believe it is an improvement over current “see @ref”, even though it > > looks different in the info

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

2024-04-16 Thread pelzflorian (Florian Pelz)
Hi Matt. When triple checking, I read in “info "(texinfo)@pxref"”: In past versions of Texinfo, it was not allowed to write punctuation after a '@pxref', so it could be used _only_ before a right parenthesis. This is no longer the case. The effect of '@pxref{NODE-NAME}' is similar to that of

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

2024-04-15 Thread Matt
On Mon, 15 Apr 2024 14:58:50 +0200 pelzflorian (Florian Pelz) wrote --- > Do you agree that I should commit your docs correction with @pxref? > I believe it is an improvement over current “see @ref”, even though it > looks different in the info reader. Yes, I agree and thank you for

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

2024-04-15 Thread pelzflorian (Florian Pelz)
Matt writes: > The problem is that the Emacs Info reader incorrectly renders > cross-references by default. I was reading the Texinfo documentation > in Emacs. I believe the Emacs errors are historical; looking at Emacs 29.3 as packaged in Guix, Emacs-Info displays xref properly as See.

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

2024-04-14 Thread Matt
On Sat, 13 Apr 2024 13:26:39 +0200 pelzflorian (Florian Pelz) wrote --- > @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

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

2024-04-14 Thread pelzflorian (Florian Pelz)
Matt writes: > The attached change updates "Libera Chat" to the "Libera.Chat" stylization. Pushed as df7b569b464c05036871f23d37ba319be78e5f64. Thanks! Regards, Florian

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

2024-04-13 Thread Christian Miller
Hello, I just want to mention that I am still in CC and my mail server is going offline. Need to optimize my budget and don't have any time for GNU anymore because of university. -- Christian Miller Am 10/04/2024 um 16:05 schrieb Matt: We're working through a list of feedback one item at

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

2024-04-13 Thread pelzflorian (Florian Pelz)
Matt writes: > #+begin_quote > 3.7 After System Installation > L27 Libera_Chat, why the underscore. It is colored as well for me so > I guess this is a special char. Should be anways just Libera Chat > #+end_quote > > "Libera_Chat" is not, or no longer, in the docs (d3fe763fe3). > However, there

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

2024-04-13 Thread pelzflorian (Florian Pelz)
Hello Matt. Thank you for fixing the oversight. However: Matt writes: > From: Matthew Trzcinski > 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"

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

2024-04-13 Thread Matt
On Fri, 12 Apr 2024 22:16:39 +0200 Ludovic Courtès wrote --- > > See @ref{Substitutes} for how to allow the daemon to download pre-built > > binaries. > > Nitpick: this works but I believe the recommended approach is > “@xref{Substitutes} for how…”. > > >

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

2024-04-12 Thread Ludovic Courtès
Hi, Matt skribis: > See @ref{Substitutes} for how to allow the daemon to download pre-built > binaries. Nitpick: this works but I believe the recommended approach is “@xref{Substitutes} for how…”. https://www.gnu.org/software/texinfo/manual/texinfo/html_node/Cross-Reference-Commands.html

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

2024-04-12 Thread Matt
We're working through a list of feedback one item at a time: https://lists.gnu.org/archive/html/guix-devel/2024-01/msg00117.html We have completed the first three items. The next item reported is: #+begin_quote 3.7 After System Installation L27 Libera_Chat, why the underscore. It is colored as

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

2024-04-12 Thread pelzflorian (Florian Pelz)
Pushed as cd557e2d1c83839dd587016279900d31f053efc8. Matt writes: > The next item reported is: > > #+begin_quote > 2.4 Setting up the deamon > > Seems like an issue with info. Have seen this in the Emacs manual as well. > There is also sometimes see see (doc) > > L15 See also see Substitutes.

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

2024-04-10 Thread Matt
We're working through a list of feedback one item at a time: https://lists.gnu.org/archive/html/guix-devel/2024-01/msg00117.html We have completed the first two items. The next item reported is: #+begin_quote 2.4 Setting up the deamon Seems like an issue with info. Have seen this in the Emacs