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

In article <tahkuf$6ob$1@cabale.usenet-fr.net>,
 Olivier Miakinen <om+news@miakinen.net> wrote:

Le 11/07/2022 18:43, Thomas répondait à Alain Ketterlin :

 
Personnellement je préfère éviter |, ce qui évite aussi les parenthèses
en général. Par exemple, chez moi la page de man de sort indique
 
       sort [OPTION]... [FILE]...
       sort [OPTION]... --files0-from=F

 
bonne idée :-)
 
je préfère ta proposition que celle d'Olivier

 
Ça tombe très bien, parce que moi aussi. :-)
 
Il se trouve simplement que je n'y avais pas pensé, mais cette méthode me
semble aussi éminemment préférable

j'ai ajouté une option, et je vais diviser rapid en 2,
ce qui donnera :

d'un coté :
Usage: ./rapid [-v] [gui_file]

de l'autre coté :
Usage: ./rapid-cli [-v] [-od output_directory] gui_file ...
       ./rapid-cli [-v] -ug gui_file ...


ce que je voudrai peut-être faire plus tard, c'est pouvoir faire les 2
actions de rapid-cli en même temps.
pour ça je nomme la 1ere en la laissant facultative pour la
compatibilité :

Usage: ./rapid-cli [-v] [-ga] [-od output_directory] gui_file ...
       ./rapid-cli [-v] -ug gui_file ...

ensuite j'ajoute la possibilité de combiner les 2 :

Usage: ./rapid-cli [-v] [-ga] [-od output_directory] gui_file ...
       ./rapid-cli [-v] -ug gui_file ...
       ./rapid-cli [-v] -ga -ug [-od output_directory] gui_file ...


est-ce que c'est bien de les présenter comme ça ?
ce qui me gêne, c'est que ça ne représente pas un 3eme état différent,
c'est juste l'union des 2 1ers.

le pb c'est que je ne vois pas comment faire une combinaison de tout ça
qui soit bien propre.

./rapid-cli [-v] [[-ga] [-ug] | [-ga [-ug]] -od output_directory]
gui_file ...

il me semble que de cette manière, il est impossible d'avoir à la fois
-od, -ug, et pas -ga.
mais bon, ça fait un peu usine à gaz ...



PS :
je ne sais pas si c'est utile de faire un msg supplémentaire pour ça,
pour info voilà ce que j'ai codé :
http://svn.savannah.gnu.org/viewvc/rapid/branches/gtkada-2.24/src/app/ada
/rapid_main.adb?view=markup&pathrev=278 ( https://urlpetite.net/?75y )

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