diff mbox series

[bug#57460,v3,18/18] doc: Describe how to update to a specific version.

Message ID 2b905274a868aa9f0d015b8b688e1526172a63da.1671527962.git.h.goebel@crazy-compilers.com
State New
Headers show
Series Refresh to specific version | expand

Commit Message

Hartmut Goebel Dec. 20, 2022, 9:34 a.m. UTC
---
 doc/guix.texi | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

Comments

Ludovic Courtès Dec. 23, 2022, 10:42 p.m. UTC | #1
Hartmut Goebel <h.goebel@crazy-compilers.com> skribis:

> ---
>  doc/guix.texi | 19 +++++++++++++++++++
>  1 file changed, 19 insertions(+)

Please add a commit log.

> +If for some reason you don't want to update to the latest version,
> +you can update to a specific version
> +by appending an equal-sign and the desired version number
> +to the package specification.
> +However, not all updaters support this.

s/equal-sign/equal sign/

(You might want to “fill” the paragraph too, to avoid those spurious
line breaks.)

Maybe replace the last sentence with something more practical like:

  Note that not all updaters support this; an error is reported when an
  updater cannot refresh to the specified version.

Ludo’.
diff mbox series

Patch

diff --git a/doc/guix.texi b/doc/guix.texi
index c031c8d880..8bca0e1098 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -13932,6 +13932,25 @@  gnu/packages/multiprecision.scm:40:12: 6.1.2 is already the latest version of gm
 
 @end table
 
+If for some reason you don't want to update to the latest version,
+you can update to a specific version
+by appending an equal-sign and the desired version number
+to the package specification.
+However, not all updaters support this.
+
+@example
+$ guix refresh trytond-party
+gnu/packages/guile.scm:392:2: guile would be upgraded from 3.0.3 to 3.0.5
+$ guix refresh -u guile=3.0.4
+@dots{}
+gnu/packages/guile.scm:392:2: guile: updating from version 3.0.3 to version 3.0.4...
+@dots{}
+$ guix refresh -u guile@@2.0=2.0.12
+@dots{}
+gnu/packages/guile.scm:147:2: guile: updating from version 2.0.10 to version 2.0.12...
+@dots{}
+@end example
+
 Sometimes the upstream name differs from the package name used in Guix,
 and @command{guix refresh} needs a little help.  Most updaters honor the
 @code{upstream-name} property in package definitions, which can be used