Re: Twitter

[...] mv(1) ont quelques exemples sur OpenBSD. Après, ces commandes sont particulièrement simples, [...]

Les exemples donnés ne font qu'illustrer mon propos : c'est déjà dans le synopsis... Ainsi, pour moi :

mv -f foo bar

n'apporte rien de plus que ce qui est marqué tout au début :

mv [-fiv] source target

mais il y en a d'autres (chmod, find, cut, paste) où je trouve que ça peut être une porte d'entrée utile pour guider notre lecture du reste de la page de manuel ...

Sous OpenBSD toujours, il y a une section d'exemples aussi pour cut, paste, find, chmod, etc.
Mais pour moiTM, ça aide autant que d'aller copier des commandes sur le net sans trop comprendre... En prenant la cas du changement de permission de fichier, je préfère savoir que la forme est

chmod [-h] [-R [-H | -L | -P]] mode file

et comprendre comment trouver le mode qui me convient en suivant la recette donnée (il se trouve qu'avec le pot que j'ai, ce qu'il me faut est rarement ce qui dans les exemples qui du coup sont inutiles en plus d'être redondants.)
De même, les exemples de cut ne meTM parlent pas tant que je n'ai pas vu les options et surtout lu :

List is a comma or whitespace separated set of numbers and/or number ranges. 
Number ranges consist of a number, a dash (‘-’), and a second number which 
select the fields or columns from the first number to the second, inclusive. 
Numbers or number ranges may be preceded by a dash, which selects all fields 
or columns from 1 to the first number. Numbers or number ranges may be 
followed by a dash, which selects all fields or columns from the last number 
to the end of the line. Numbers and number ranges may be repeated, 
overlapping, and in any order. It is not an error to select fields or columns 
not present in the input line.

...or une fois que j'ai ces informations, les exemples donnés ne me servent plus à rien, voir ne sont pas ceux que j'aurais choisi.

... ou se rafraîchir vite-fait la mémoire.

C'est ce que fait le synopsis, et c'est juste pour ça que j'utilise man pour des commandes simples/basiques (j'avais marqué que ça me permet de retrouver l'ordre des arguments positionnels, mais j'ai oublié d'indiquer que ça me montre la liste des bascules disponibles) Pour cette raison, je pesterai plutôt contre les formulations de type wtf suivant (ça fait vraiment doc bâclée où on a juste copié-collé le modèle sans faire le taf) :

cut OPTION... [FILE]...

Par contre j'aime bien comment est présentée la notion de liste pour les drapeaux

Use one, and only one of -b, -c or -f. Each LIST is made up of one range, or 
many ranges separated by commas. Selected input is written in the same order 
that it is read, and is written exactly once. Each range is one of:
N
 N'th byte, character or field, counted from 1 
N-
 from N'th byte, character or field, to end of line 
N-M
 from N'th to M'th (included) byte, character or field 
-M
 from first to M'th (included) byte, character or field

"It is seldom that liberty of any kind is lost all at once." ― David Hume