docs(nix-env): summarize of each subcommand in --help

This should have been there from the beginning. As much as nix-env is a
pile of problems we don't need trivial docs papercuts like this adding
to it.

Change-Id: I0c53e4b146af2fefdd0e4743d850672729cb2194

doc/manual/src/command-ref/nix-env.md

@@ -25,17 +25,17 @@ individual users can switch between different environments.
 `nix-env` takes exactly one *operation* flag which indicates the
 subcommand to be performed. The following operations are available:
 
-- [`--install`](./nix-env/install.md)
+- [`--install`](./nix-env/install.md) - add packages to user environment
-- [`--upgrade`](./nix-env/upgrade.md)
+- [`--upgrade`](./nix-env/upgrade.md) - upgrade packages in user environment
-- [`--uninstall`](./nix-env/uninstall.md)
+- [`--uninstall`](./nix-env/uninstall.md) - remove packages from user environment
-- [`--set`](./nix-env/set.md)
+- [`--set`](./nix-env/set.md) - set profile to contain a specified derivation
-- [`--set-flag`](./nix-env/set-flag.md)
+- [`--set-flag`](./nix-env/set-flag.md) - modify meta attributes of installed packages
-- [`--query`](./nix-env/query.md)
+- [`--query`](./nix-env/query.md) - display information about packages
-- [`--switch-profile`](./nix-env/switch-profile.md)
+- [`--switch-profile`](./nix-env/switch-profile.md) - set user environment to a given profile
-- [`--list-generations`](./nix-env/list-generations.md)
+- [`--list-generations`](./nix-env/list-generations.md) - list profile generations
-- [`--delete-generations`](./nix-env/delete-generations.md)
+- [`--delete-generations`](./nix-env/delete-generations.md) - delete profile generations
-- [`--switch-generation`](./nix-env/switch-generation.md)
+- [`--switch-generation`](./nix-env/switch-generation.md) - set user environment to a given profile generation
-- [`--rollback`](./nix-env/rollback.md)
+- [`--rollback`](./nix-env/rollback.md) - set user environment to previous generation
 
 These pages can be viewed offline: