[Top][All Lists]

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

[bug#43482] [PATCH 3/3] doc: Reorder the "Channels" section.

From: zimoun
Subject: [bug#43482] [PATCH 3/3] doc: Reorder the "Channels" section.
Date: Thu, 24 Sep 2020 17:13:02 +0200


Thank you for the review.

On Thu, 24 Sep 2020 at 16:59, Ludovic Courtès <> wrote:

> > * doc/guix.texi (Channels): Reorder the section.
> > Minor tweaks to keep uniformity.
> > Update the master menu.
> It would be nice if you could better describe what’s moved where since
> looking at the diff doesn’t help understand it.

I will try to do my best. :-)

> > +@node Writing custom channels
> > +@subsection Writing custom channels
> Should be “Writing Custom Channels”.
> Maybe “Creating a Channel” is more to the point actually?


> > +Last, as a channel author, you may want to run an authenticated channel
> > +(@pxref{Channel Authentication}), then @pxref{Specifying Channel
> > +Authorizations} for details.
> Maybe something like:
>   As a channel author, consider bundling authentication material with
>   your channel so that users can authenticate it.  @xref{Channel
>   Authentication}, and @ref{Specifying Channel Authorizations}, for
>   info on how to do it.


> (Note: @pxref cannot be used in the middle of a sentence like you did
> above.  I always end up re-reading the Texinfo manual to find which
> cross-reference command to use in which context…)

Thanks for the explanations.

> Could you send updated patches?



reply via email to

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