fix: make clearer help usage

help.txt

@@ -1,65 +1,81 @@
-MANAGE PLUGINS
-asdf plugin add <name> [<git-url>] Add a plugin from the plugin repo OR,
- add a Git repo as a plugin by
- specifying the name and repo url
-asdf plugin list [--urls] [--refs] List installed plugins. Optionally show
- git urls and git-ref
-asdf plugin list all List plugins registered on asdf-plugins
- repository with URLs
-asdf plugin remove <name> Remove plugin and package versions
-asdf plugin update <name> [<git-ref>] Update a plugin to latest commit on
- default branch or a particular git-ref
-asdf plugin update --all Update all plugins to latest commit on
- default branch
+* CONTEXT PACKAGES
+---------------------
+ asdf current Display current version set or being
+ used for all packages
+ asdf current <name> Display current version set or being
+ used for package
+ asdf global <name> <version> Set the package global version
+ asdf global <name> latest[:<version>] Set the package global version to the
+ latest provided version
+ asdf local <name> <version> Set the package local version
+ asdf local <name> latest[:<version>] Set the package local version to the
+ latest provided version
+ asdf shell <name> <version> Set the package version to
+ `ASDF_${LANG}_VERSION` in the current shell
 
+ asdf where <name> [<version>] Display install path for an installed
+ or current version
+ asdf which <command> Display the path to an executable
 
-MANAGE PACKAGES
-asdf current Display current version set or being
- used for all packages
-asdf current <name> Display current version set or being
- used for package
-asdf global <name> <version> Set the package global version
-asdf global <name> latest[:<version>] Set the package global version to the
- latest provided version
-asdf help <name> [<version>] Output documentation for plugin and tool
-asdf install Install all the package versions listed
- in the .tool-versions file
-asdf install <name> Install one tool at the version
- specified in the .tool-versions file
-asdf install <name> <version> Install a specific version of a package
-asdf install <name> latest[:<version>] Install the latest stable version of a
- package, or with optional version,
- install the latest stable version that
- begins with the given string
-asdf latest <name> [<version>] Show latest stable version of a package
-asdf latest --all Show latest stable version of all the
- packages and if they are installed
-asdf list <name> [version] List installed versions of a package and
- optionally filter the versions
-asdf list all <name> [<version>] List all versions of a package and
- optionally filter the returned versions
-asdf local <name> <version> Set the package local version
-asdf local <name> latest[:<version>] Set the package local version to the
- latest provided version
-asdf shell <name> <version> Set the package version to
- `ASDF_${LANG}_VERSION` in the current shell
-asdf uninstall <name> <version> Remove a specific version of a package
-asdf where <name> [<version>] Display install path for an installed
- or current version
-asdf which <command> Display the path to an executable
 
+* MANAGE PACKAGES
+---------------------
+ asdf help <name> [<version>] Output documentation for plugin and tool
 
-UTILS
-asdf exec <command> [args...] Executes the command shim for current version
-asdf env <command> [util] Runs util (default: `env`) inside the
- environment used for command shim execution.
-asdf info Print OS, Shell and ASDF debug information.
-asdf reshim <name> <version> Recreate shims for version of a package
-asdf shim-versions <command> List the plugins and versions that
- provide a command
-asdf update Update asdf to the latest stable release
-asdf update --head Update asdf to the latest on the master branch
+ asdf list <name> [version] List installed versions of a package and
+ optionally filter the versions
+ asdf list all <name> [<version>] List all versions of a package and
+ optionally filter the returned versions
 
-RESOURCES
+ asdf latest <name> [<version>] Show latest stable version of a package
+ asdf latest --all Show latest stable version of all the
+ packages and if they are installed
+ asdf install Install all the package versions listed
+ in the .tool-versions file
+ asdf install <name> Install one tool at the version
+ specified in the .tool-versions file
+ asdf install <name> <version> Install a specific version of a package
+ asdf install <name> latest[:<version>] Install the latest stable version of a
+ package, or with optional version,
+ install the latest stable version that
+ begins with the given string
+ asdf uninstall <name> <version> Remove a specific version of a package
+
+
+* MANAGE PLUGINS
+---------------------
+ asdf plugin list [--urls] [--refs] List installed plugins. Optionally show
+ git urls and git-ref
+ asdf plugin list all List plugins registered on asdf-plugins
+ repository with URLs
+ asdf plugin add <name> [<git-url>] Add a plugin from the plugin repo OR,
+ add a Git repo as a plugin by
+ specifying the name and repo url
+ asdf plugin remove <name> Remove plugin and package versions
+ asdf plugin update <name> [<git-ref>] Update a plugin to latest commit on
+ default branch or a particular git-ref
+ asdf plugin update --all Update all plugins to latest commit on
+ default branch
+
+
+* UTILS
+---------------------
+ asdf exec <command> [args...] Executes the command shim for current version
+ asdf env <command> [util] Runs util (default: `env`) inside the
+ environment used for command shim execution.
+ asdf reshim <name> <version> Recreate shims for version of a package
+ asdf shim-versions <command> List the plugins and versions that
+ provide a command
+ asdf info Print OS, Shell and ASDF debug information.
+ asdf update Update asdf to the latest stable release
+ asdf update --head Update asdf to the latest on the master branch
+
+
+* RESOURCES
+---------------------
 GitHub: https://github.com/asdf-vm/asdf
 Docs: https://asdf-vm.com
+
+
+* PLUGINS
+---------------------