[bug#47404,0/2] doc: Minor improvements

Message ID 20210326064931.32395-1-zimon.toutoune@gmail.com
Headers show
Series doc: Minor improvements | expand

Message

Simon Tournier March 26, 2021, 6:49 a.m. UTC
Hi,

The first patch is about keeping consistency with the previous Channels
reordering.

   <http://issues.guix.gnu.org/43482>


The second patch removes all the backtick substitutions by $() in shell
commands.  The POSIX is $() as explained:

<https://pubs.opengroup.org/onlinepubs/9699919799/utilities/V3_chap02.html#tag_18_06_03>
<https://pubs.opengroup.org/onlinepubs/9699919799/xrat/V4_xcu_chap02.html#tag_23_02_06_03>

This changed had already been discussed but I am not able to find where.
Well, at least it is mentioned here [1]:

        I propose to do a pass on that:
         - apply this rule: no-$ for only input and $ to distinguish between
        inputs and outputs.
         - backtick ` replaced by $(...) as discussed elsewhere
        and then send a "Fix typo" patch.  And maybe add a bullet in the
        Contributing Section.

i.e, the patch address the second point.

1: <https://yhetil.org/guix/CAJ3okZ3WfjR3tbgQX-B_WvihZFazvR7AfNquYYXE6+Hp5nOBzw@mail.gmail.com>


Cheers,
simon

zimoun (2):
  doc: Reorder "Channels with Substitutes".
  doc: Fix typos.

 doc/guix.texi | 84 +++++++++++++++++++++++++--------------------------
 1 file changed, 42 insertions(+), 42 deletions(-)


base-commit: 6e7ba45357078b31a369b23f8a9f38302dfcbb10