summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorLudovic Courtès <ludo@gnu.org>2022-02-14 16:27:52 +0100
committerLudovic Courtès <ludo@gnu.org>2022-02-27 18:06:14 +0100
commitbc8bea1739294f2c939f3dbb663d834a4d1d5856 (patch)
tree8c72c5c1687741c2a93ac95e703fbbc51abaf60c /doc
parent85a5110de79f4fe9fd822ede3915654ee699d6c5 (diff)
downloadguix-patches-bc8bea1739294f2c939f3dbb663d834a4d1d5856.tar
guix-patches-bc8bea1739294f2c939f3dbb663d834a4d1d5856.tar.gz
pull: '--news' no longer shows package lists.
* guix/scripts/pull.scm (display-channel-news): Return #t when news were displayed. (display-news): Add #:profile-news? parameter and honor it. Print something there were no news. (process-query): For 'display-news', call 'display-channel-news' directly. * doc/guix.texi (Invoking guix pull): Adjust accordingly.
Diffstat (limited to 'doc')
-rw-r--r--doc/guix.texi17
1 files changed, 9 insertions, 8 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index a6437729ff..7596b0567b 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -4486,13 +4486,13 @@ information.
@cindex channel news
@item --news
@itemx -N
-Display the list of packages added or upgraded since the previous
-generation, as well as, occasionally, news written by channel authors
-for their users (@pxref{Channels, Writing Channel News}).
+Display news written by channel authors for their users for changes made
+since the previous generation (@pxref{Channels, Writing Channel News}).
+When @option{--details} is passed, additionally display new and upgraded
+packages.
-The package information is the same as displayed upon @command{guix
-pull} completion, but without ellipses; it is also similar to the output
-of @command{guix pull -l} for the last generation (see below).
+You can view that information for previous generations with
+@command{guix pull -l}.
@item --list-generations[=@var{pattern}]
@itemx -l [@var{pattern}]
@@ -4507,8 +4507,9 @@ revision as well as the corresponding news entries. If you pass
upgraded in each generation compared to the previous one.
@item --details
-Instruct @option{--list-generations} to display more information about
-the differences between subsequent generations---see above.
+Instruct @option{--list-generations} or @option{--news} to display more
+information about the differences between subsequent generations---see
+above.
@item --roll-back
@cindex rolling back