Generate man pages for awscli
Classified in : Homepage, Debian, Command line, To remember
No man pages, but almost
The AWS Command Line Interface, which is available in Debian,
provides no man page. Instead, that tool has an integrated help system,
which allows you to run commands such as aws rds
help, that, for what I have seen, generates some
reStructuredText, then converts it to a man page in troff format, then
calls troff to convert it to text with basic formatting, and eventually
passes it to a pager. Since this is close to what man does, the
result looks like a degraded man page, with some features missing such
as the adaptation to the terminal width.
Well, this is better than nothing, and better than what many
under-documented tools can offer, but for several reasons, it still
sucks: most importantly, it does not respect administrators' habits and
it does not integrate with the system man database. You it does not
allow you to use commands such as apropos,
and you will get no man page name auto-completion from your shell since
there is no man page.