3.0 shell args

Document changes to shell args and subcommands.

Fixes #1328