TritonDataCenter / node-manta

Node.js SDK for Manta
75 stars 54 forks source link

mjob man page clarification. #223

Open bahamat opened 9 years ago

bahamat commented 9 years ago

The mjob man page has the following synopsis:

SYNOPSIS
       mjob [OPTION...] command [command-specific arguments]

A bit further down:

COMMON OPTIONS
       The following options are supported in all commands:

       -a, --account login
              Authenticate as account (login name).

Ordinarily users will be skimming the man page and miss "The following options are supported in all commands". Seeing that the synopsis states that options before the command are valid they may assume the following is correct:

mjob -a user create

The correct usage is:

mjob create -a user

The man page should be updated to remove [OPTIONS] before the subcommand.