[PATCH] Documentation: Update `guix challenge` diffing

  • Done
  • quality assurance status badge
Details
2 participants
  • Ludovic Courtès
  • mikadoZero
Owner
unassigned
Submitted by
mikadoZero
Severity
normal

Debbugs page

mikadoZero wrote 6 years ago
(address . guix-patches@gnu.org)
20190223012931.GA17575@z.z
Attached is a patch that updates the manual sections `Invoking guix challenge` and `Invoking guix archive`. The update involves changing a command in both sections to one that I verified worked as part of my submission of `guix challenge` diffs for bug#34597. The commands that are replaces did not work for me. There is also a cross reference added to the `Invoking guix challenge` in the relevant part of `Invoking guix archive`.
From ea59d81de86fd5179eebf9782fbe66213ed59397 Mon Sep 17 00:00:00 2001
From: mikadoZero <mikadozero@yandex.com>
Date: Fri, 22 Feb 2019 18:24:20 -0500
Subject: [PATCH] Documentation: Update `guix challenge` diffing.

Add /gzip/ part into url which has the benefit of matching the output of
`guix challenge`. Change the commands to include gunzip in the pipeline as
they are working on gzipped files. Add reference to `guix challenge` in `guix
archive` section where talking about challenging.
---
doc/guix.texi | 12 +++++++-----
1 file changed, 7 insertions(+), 5 deletions(-)

Toggle diff (46 lines)
diff --git a/doc/guix.texi b/doc/guix.texi
index 9fb5cff06..43c12cd72 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -58,6 +58,7 @@ Copyright @copyright{} 2018 Gábor Boskovits@*
Copyright @copyright{} 2018 Florian Pelz@*
Copyright @copyright{} 2018 Laura Lazzati@*
Copyright @copyright{} 2018 Alex Vong@*
+Copyright @copyright{} 2019 mikadoZero@*
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
@@ -4204,8 +4205,8 @@ served by @code{@value{SUBSTITUTE-SERVER}} to @file{/tmp/emacs}:
@example
$ wget -O - \
- https://@value{SUBSTITUTE-SERVER}/nar/@dots{}-emacs-24.5 \
- | bunzip2 | guix archive -x /tmp/emacs
+ https://@value{SUBSTITUTE-SERVER}/nar/gzip/@dots{}-emacs-24.5 \
+ | gunzip | guix archive -x /tmp/emacs
@end example
Single-item archives are different from multiple-item archives produced
@@ -4215,7 +4216,8 @@ and they do @emph{not} embed a signature. Thus this operation does
unsafe.
The primary purpose of this operation is to facilitate inspection of
-archive contents coming from possibly untrusted substitute servers.
+archive contents coming from possibly untrusted substitute servers
+(@pxref{Invoking guix challenge}).
@end table
@@ -9559,8 +9561,8 @@ To find out what is wrong with this Git binary, we can do something along
these lines (@pxref{Invoking guix archive}):
@example
-$ wget -q -O - https://@value{SUBSTITUTE-SERVER}/nar/@dots{}-git-2.5.0 \
- | guix archive -x /tmp/git
+$ wget -q -O - https://@value{SUBSTITUTE-SERVER}/nar/gzip/@dots{}-git-2.5.0 \
+ | gunzip | guix archive -x /tmp/git
$ diff -ur --no-dereference /gnu/store/@dots{}-git.2.5.0 /tmp/git
@end example
--
2.20.1
Ludovic Courtès wrote 5 years ago
(name . mikadoZero)(address . mikadozero@yandex.com)(address . 34625-done@debbugs.gnu.org)
87y2qtal01.fsf@gnu.org
Hi!

mikadoZero <mikadozero@yandex.com> skribis:

Toggle quote (10 lines)
>>From ea59d81de86fd5179eebf9782fbe66213ed59397 Mon Sep 17 00:00:00 2001
> From: mikadoZero <mikadozero@yandex.com>
> Date: Fri, 22 Feb 2019 18:24:20 -0500
> Subject: [PATCH] Documentation: Update `guix challenge` diffing.
>
> Add /gzip/ part into url which has the benefit of matching the output of
> `guix challenge`. Change the commands to include gunzip in the pipeline as
> they are working on gzipped files. Add reference to `guix challenge` in `guix
> archive` section where talking about challenging.

I changed the 2nd example to /lzip, adjusted the commit log to match our
conventions, and applied.

Thanks!

Ludo’.
Closed
?
Your comment

This issue is archived.

To comment on this conversation send an email to 34625@debbugs.gnu.org

To respond to this issue using the mumi CLI, first switch to it
mumi current 34625
Then, you may apply the latest patchset in this issue (with sign off)
mumi am -- -s
Or, compose a reply to this issue
mumi compose
Or, send patches to this issue
mumi send-email *.patch
You may also tag this issue. See list of standard tags. For example, to set the confirmed and easy tags
mumi command -t +confirmed -t +easy
Or, remove the moreinfo tag and set the help tag
mumi command -t -moreinfo -t +help