docs(client): add more clarity to limit:set
docs(client): more clarity on limit:set options
docs(reference): add deis limit autodocs
ref(client): rename limit to limits

'limits' follows our other commands' syntax much better i.e. apps:list,
releases:rollback etc.
docs(client): more clarity on limits:set
ref(client): move options from argument list
fix(client): move options list before arguments

Docopt does not allow additional commands after ellipsis as it's hard
to determine when they end (e.g. is this argument an arg or an option?).