Re: règle pour écrire les "usage: ..."

In article <tab00r$v6d7$1@dont-email.me>, ST <st@unices.org> wrote:

On 2022-07-08, Thomas <fantome.forums.tDeContes@free.fr.invalid> wrote:

bonjour :-)
>
>
est-ce qu'on peut trouver qqpart une règle pour écrire les "usage: ..." ?
>
par ex, je sais que [] indique qqch de facultatif, mais il y a plein
d'autres choses que je ne connais pas / pas bien.
>
>
par ex, si j'écris :
>
usage: rapid [-v] (gui_file | -ni [-od dir] gui_file...)
>
est-ce que tout le monde comprend, sans ambiguité ?
>

 
"-v" est optionnel
 
Le "|" marque est un choix entre ce qui est à gauche et ce qui est à
droite, dans lequel "-od dir" est optionnel.

je me posais des questions notamment sur :
- () que je ne me rappelle pas avoir vu (j'ai utilisé ça comme le
symbole mathématique)
- ... que j'ai déjà vu, mais ça me donne une sensation de non-rigoureux
(donc je posais la question en même temps, ça coute rien ...)
- je crois qu'on utilise qqfois {}, mais je ne me rappelle plus ce que
ça veut dire.




en passant, je viens de m'apercevoir qu'avant on avait :

$ ls -z
ls: illegal option -- z
usage: ls [-ABCFGHLOPRSTUWabcdefghiklmnopqrstuwx1] [file ...]
$ mkdir -a
mkdir: illegal option -- a
usage: mkdir [-pv] [-m mode] directory ...


et maintenant :

$ ls -z
ls : option invalide -- 'z'
Saisissez « ls --help » pour plus d'informations.
$ mkdir -a
mkdir : option invalide -- 'a'
Saisissez « mkdir --help » pour plus d'informations.


est-ce que le "usage: ..." serais tombé en désuétude ?

--
RAPID maintainer
http://savannah.nongnu.org/projects/rapid/