Re: PuTTY's days are numbered
As far as I can tell, examples are not used in
man pages for commands anywhere in linux (which is odd because they're recommended in the style guide for man). Many commands don't even include a simple description in the DESCRIPTION part of their
man file (for example,
less, which proudly informs you that it is similar to
more but has 'many more features'. Alas, nowhere does it mention that it's a program for displaying the contents of a file).
So I suspect that even if I did show up with some new documentation containing lovely examples of how commands should, and can be used, they'd be thrown out as 'not being in the spirit'.
Compare and contrast when practicality rather than ideology is the driver between writing documentation, eg.