summary refs log tree commit diff
path: root/doc
diff options
context:
space:
mode:
authorHerman Rimm <herman@rimm.ee>2024-09-02 20:58:05 +0200
committerLudovic Courtès <ludo@gnu.org>2024-09-03 13:59:33 +0200
commitc4ce31305258126e0f5809697e084bf97f31f77f (patch)
tree222f24899f6c27d665e2d0620b764693c5ce3753 /doc
parent52681a036a47168edc3380b89d3975ca70d54ab5 (diff)
downloadguix-c4ce31305258126e0f5809697e084bf97f31f77f.tar.gz
scripts: style: Add 'alphabetical-sort' option.
* guix/scripts/style.scm (show-help): Describe option.
(order-packages): Add procedure.
(format-whole-file): Add 'order?' argument.
(%options): Add 'alphabetical-sort' option.
(guix-style): Alphabetically order packages in files.
* tests/guix-style.sh: Test alphabetical ordering.
* doc/guix.texi (Invoking guix style): Document option.

Change-Id: I4aa7c0bd0b6d42529ae7d304587ffb10bf5f4006
Signed-off-by: Ludovic Courtès <ludo@gnu.org>
Diffstat (limited to 'doc')
-rw-r--r--doc/guix.texi7
1 files changed, 7 insertions, 0 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index 144adf327e..16c697586a 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -15227,6 +15227,13 @@ configuration (you need write permissions for the file):
 guix style -f /etc/config.scm
 @end example
 
+@item --alphabetical-sort
+@itemx -A
+Place the top-level package definitions in the given files in
+alphabetical order.  Package definitions with matching names are placed
+with versions in descending order.  This option only has an effect in
+combination with @option{--whole-file}.
+
 @item --styling=@var{rule}
 @itemx -S @var{rule}
 Apply @var{rule}, one of the following styling rules: