Hi all!

Here’s a v2 of the patches, where I tried to take your feedback into
account.  Changes:

  • Categories that appear in uses of ‘define-command’ are now validated
    at macro-expansion time.

  • (guix scripts) contains an alist of the known categories and
    ‘show-help’ traverses it.

  • Changed the label for development commands to “commands for
    development”, and changed “advanced” to “plumbing”.

  • Added a “packaging” category.

  • Fixed the typos you reported.

The end result is:

--8<---------------cut here---------------start------------->8---
Usage: guix COMMAND ARGS...
Run COMMAND with ARGS.

COMMAND must be one of the sub-commands listed below:

  main commands
    deploy        deploy operating systems on a set of machines
    describe      describe the channel revisions currently used
    gc            invoke the garbage collector
    install       install packages
    package       manage packages and profiles
    pull          pull the latest revision of Guix
    remove        remove installed packages
    search        search for packages
    show          show information about packages
    system        build and deploy full operating systems
    time-machine  run commands from a different revision
    upgrade       upgrade packages to their latest version
    weather       report on the availability of pre-built package binaries

  software development commands
    container    run code in containers created by 'guix environment -C'
    environment  spawn one-off software environments
    pack         create application bundles

  packaging commands
    build      build packages or derivations without installing them
    challenge  challenge substitute servers, comparing their binaries
    download   download a file to the store and print its hash
    edit       view and edit package definitions
    graph      view and query package dependency graphs
    hash       compute the cryptographic hash of a file
    import     import a package definition from an external repository
    lint       validate package definitions
    publish    publish build results over HTTP
    refresh    update existing package definitions
    size       profile the on-disk size of packages

  plumbing commands
    archive    manipulate, export, and import normalized archives (nars)
    copy       copy store items remotely over SSH
    git        operate on Git repositories
    offload    set up and operate build offloading
    processes  list currently running sessions
    repl       read-eval-print loop (REPL) for interactive programming

Report bugs to: bug-guix@gnu.org.
GNU Guix home page: <https://www.gnu.org/software/guix/>
General help using Guix and GNU software: <https://guix.gnu.org/help/>
--8<---------------cut here---------------end--------------->8---

Let me know what you think!

Thanks,
Ludo’.