Reply to post: Re: PuTTY's days are numbered

PuTTY in your hands: SSH client gets patched after RSA key exchange memory vuln spotted

phuzz Silver badge

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.

POST COMMENT House rules

Not a member of The Register? Create a new account here.

  • Enter your comment

  • Add an icon

Anonymous cowards cannot choose their icon

Biting the hand that feeds IT © 1998–2019