[wiki] Bash : Le caractère pour commenter

agp91 · 23-06-2024 16:43:58

Suivit de la page : Bash : Le caractère pour commenter

Bash : Le caractère pour commenter a écrit :

Ce tuto propose d'expliquer l'usage des commentaires dans l'interpréteur de commande ''Bash''.\\
Seront aussi montrés, l'écriture de pseudos (qui n'en sont pas) commentaires multi-lignes.

Ce tuto fait parti de la refonte du projet Bash, par les caractères initié par @Hypathie
https://debian-facile.org/viewtopic.php?id=8804

Suivit : Relecture - à-tester

Dernière modification par agp91 (26-06-2024 10:41:47)

agp91 · 23-06-2024 17:53:36

Ajout dans la section [Conclusion] d'une note expliquant le bon usage des pseudos commentaires muti-lignes.

Philou92 · 23-06-2024 20:21:41

Hello,

Merci pour ce tuto enrichissant

J’ai modifié, à la section « Usages », les deux mots « de commentarisation » par « marquant le début d’un commentaire ».

Dernière modification par Philou92 (23-06-2024 20:22:37)

ubub · 23-06-2024 20:29:53

dommage

il existe ce mot, spécial informatik, et puis il est rigolo ...
https://www.lalanguefrancaise.com/dicti … tarisation

Philou92 · 23-06-2024 22:01:08

Certes ce mot est « rigolo » mais il n’est pas d’un usage très fréquent. Ce mot est absent des dictionnaires académiques ou institutionnels. C’est aussi le cas pour sa forme verbale commentariser.
Perso je préfère dire « Commente ce code» au lieu de « Commentarise» à un interlocuteur.

zen of python a écrit :

Explicit is better than implicit

Après ce n’est que mon avis personnel.

vv222 · 23-06-2024 23:19:40

Je suis développeur depuis plus de 10 ans. Je n’avais littéralement jamais croisé ce mot "commentarisation" avant de lire cet échange.

agp91 · 24-06-2024 09:27:09

Lors de l’écriture du tuto, je n'avais pas pensé à la note expliquant l'usage des pseudos commentaires , car j'en ai pas usage.
Ce n'est qu'à la relecture que je me suis demander quel était le(s) point(s) positif(s) de leurs usage
Étant vimiste, commenter un grand bloc de code ne me pose pas de problème :

Je me positionne sur la première ligne du bloc, puis
[ESC] (passage en mode normal)
[Shift]+[V] (ce qui fait entrer dans le mode VISUEL LIGNE)
Avec la [Flèche bas] je descend jusqu'à la dernière ligne du bloc à commenter (je sélectionne le bloc)
Et j'annonce l'écriture d'une commande avec : (2 points)
Automatiquement vim y ajoute les adresses de la sélection :'<,'>
Il me reste plus qu'à écrire la commande de substitution (provenant de la syntaxe de sed) s/^/# /
Et appuyer sur la touche[Entrée]
Voila le bloc commenté avec le caractère de commentarisation marquant le début d’un commentaire.

Maintenant je me demande si je ne devrais pas préciser cela dans le tuto.
Mais il manquerait, alors, la correspondance pour emacs que je ne connais pas.

Dernière modification par agp91 (24-06-2024 18:45:38)

agp91 · 24-06-2024 18:47:35

Dans [Conclusions]
Ajout du conseil vim pour commenter/dé-commenter un bloc de ligne

zbig · 24-06-2024 19:36:30

salut agp91
Je suis encore un débutant en vi/vim, c'est pourquoi je m'adresse à un expert. N'est-il pas plus simple d'utiliser les méthodes suivantes ?

1.
1.1 mettre l'option :set relativenumber
1.2 aller à la première ligne du bloc
1.3 taper la commande :.,+ms/^/# /
où :
. - représente la ligne en cours
m - est le numéro de ligne relatif de la fin du bloc (vers la fin du fichier)
e.g.
:.,+5s/^/# /

2.
2.1 mettre l'option :set number
2.2 taper la commande :n,ms/^/# /
où :
n - numéro de ligne du début du bloc
m - numéro de ligne de la fin du bloc
e.g.
:2,10s/^/# /

Les deux méthodes fonctionnent également avec "busybox vi" (à l'exception des points 1.1 et 2.1)

P.S..
Je comprends le dicton, "l'habitude est une seconde nature pour l'homme" ;-)

Dernière modification par zbig (24-06-2024 19:45:48)

Philou92 · 24-06-2024 19:50:08

Pour commentariser commenter du code

avec vim il une manière simple :

1 - Se déplacer sur le premier caractère de la première ligne de code à commenter
2 - taper CTRL + V
3 - taper J autant de fois qu’il y a de ligne à commenter
3 - taper MAJ + I
4 - taper #
5 - taper ESC

C’est tout.

agp91 · 24-06-2024 20:37:46

@Philou92 : Yep c'est pour cela que j'ai indiqué le lien vers un autre tuto... Je ne l'ai pas retenu car cette façon de faire ne permet pas de dé-commenter.
@zbig : L'usage 2 y est aussi montré (il y manque tout de même set number)

Ici comme ailleurs, on ne peut que citer la devise de perl : Il y a plus d'une façon de le faire

Ce qui serait bien c'est qu'un emacsiste passe par là

Dernière modification par agp91 (24-06-2024 20:43:50)

Philou92 · 24-06-2024 21:06:12

agp91 a écrit :

Je ne l'ai pas retenu car cette façon de faire ne permet pas de dé-commenter.

Pour dé-commentariser dé-commenter du code avec vim il une manière encore plus simple :

1 - Se déplacer sur le premier caractère (#) de la première ligne de code à commenter
2 - taper CTRL + V
3 - taper J autant de fois qu’il y a de ligne à dé-commenter
3 - taper X

C’est tout.

PS : évidemment cela ne fonctionne que si tous les caractères # sont verticalement alignés ce qui est le cas si on commente avec cette méthode.

agp91 · 24-06-2024 21:20:49

zbig a écrit :

Je comprends le dicton, "l'habitude est une seconde nature pour l'homme" ;-)

Je suis plutôt lvisuel au point de préfère le mode visuel ligne au mode visuel bloc, alors Shift-V est devenu une habitude
J'ai aussi pris la mauvaise habitude d'utiliser les flèches au point d'en avoir oublié les touches h, k, l, j

Dans le tuto :
Ajout de la touche J
Ajout d'un lien menant ici pour l'adressage par n° ligne

Dernière modification par agp91 (24-06-2024 21:21:43)

agp91 · 24-06-2024 21:22:37

@Philou92

Dernière modification par agp91 (24-06-2024 21:24:01)

enicar · 24-06-2024 23:32:43

Salut,
dans vim il y a une extension sympa pour commenter/dé-commenter : nerd-commenter
C'est dans debian dans le paquet vim-script. Il doit en exister d'autres, c'est juste celui que
j'ai utilisé.

Dans emacs, il y a déjà des commandes pour commenter/dé-commenter. Celle que j'utilise est
comment-dwim (dwim = do what I mean), qui va choisir la méthode la plus appropriée en fonction du contexte.
Quand cette commande est appelée lorsque qu'une région est active (équivalent à une sélection avec v par exemple)
elle commente toute la région ou la dé-commente (si toute la région est un ou plusieurs commentaires).

L'avantage de nerd-commenter dans vim ou de comment-dwwim dans emacs, c'est qu'on a même pas besoin de connaître
le caractère à utiliser pour commenter. La seule chose c'est d'avoir la commande lié à une combinaison de touches.

Non, commenter ou dé-commenter n'est plus une opération fastidieuse ;-)

agp91 · 25-06-2024 08:07:35

enicar, j'avais oublié l’existence de vim-script.

enicar a écrit :

Non, commenter ou dé-commenter n'est plus une opération fastidieuse ;-)

Peut-être alors supprimer cette remarque du tuto, ainsi que tout le blalba sur vim qui suit.

agp91 · 26-06-2024 10:30:12

... Pas d'objection... Alors hop

Supprimer.

Debian-facile

#1 23-06-2024 16:43:58

[wiki] Bash : Le caractère pour commenter

#2 23-06-2024 17:53:36

Re : [wiki] Bash : Le caractère pour commenter

#3 23-06-2024 20:21:41

Re : [wiki] Bash : Le caractère pour commenter

#4 23-06-2024 20:29:53

Re : [wiki] Bash : Le caractère pour commenter

#5 23-06-2024 22:01:08

Re : [wiki] Bash : Le caractère pour commenter

#6 23-06-2024 23:19:40

Re : [wiki] Bash : Le caractère pour commenter

#7 24-06-2024 09:27:09

Re : [wiki] Bash : Le caractère pour commenter

#8 24-06-2024 18:47:35

Re : [wiki] Bash : Le caractère pour commenter

#9 24-06-2024 19:36:30

Re : [wiki] Bash : Le caractère pour commenter

#10 24-06-2024 19:50:08

Re : [wiki] Bash : Le caractère pour commenter

#11 24-06-2024 20:37:46

Re : [wiki] Bash : Le caractère pour commenter

#12 24-06-2024 21:06:12

Re : [wiki] Bash : Le caractère pour commenter

#13 24-06-2024 21:20:49

Re : [wiki] Bash : Le caractère pour commenter

#14 24-06-2024 21:22:37

Re : [wiki] Bash : Le caractère pour commenter

#15 24-06-2024 23:32:43

Re : [wiki] Bash : Le caractère pour commenter

#16 25-06-2024 08:07:35

Re : [wiki] Bash : Le caractère pour commenter

#17 26-06-2024 10:30:12

Re : [wiki] Bash : Le caractère pour commenter

Pied de page des forums