1 files changed, 60 insertions, 50 deletions

diff --git a/fichiers/03-grep-bash.tex b/fichiers/03-grep-bash.tex
index 291e6c9..8b9c78e 100644
--- a/fichiers/03-grep-bash.tex
+++ b/fichiers/03-grep-bash.tex
@@ -15,7 +15,12 @@
 \usepackage{capt-of}
 \usepackage{soul}
 \makeindex[name=cmds, intoc, title={Liste des commandes et
-  instructions}]
+  instructions}, options={-s \jobname.ist}]
+
+\NewDocumentCommand{\commande}{s m O{}}{
+  \IfBooleanTF{#1}{\index[cmds]{#2@\texttt{#2}|#3textbf}}
+  {\index[cmds]{#2@\texttt{#2}#3}}
+}
 
 \begin{document}
 \maketitle
@@ -28,13 +33,13 @@
 \listoftables
 
 \chapter{grep, les expressions régulières}
-\label{cha:grep-les-expressions}\index[cmds]{grep}
+\label{cha:grep-les-expressions}\commande{grep}
 Les expressions régulières se rapprochent des \emph{wildcards} ou
 \enquote{métacaractères} qui ont été présentés dans
-\href{https://notabug.org/ralessi/courses/src/master/fichiers/01-ligne-de-commande.tex#L714}{le
-  cours sur la ligne de commande}. C'est une technique commune à pour
-ainsi dire tous les langages de programmation qui permet de construire
-des \enquote{modèles}, en anglais \emph{patterns}, susceptibles de
+\href{./01-ligne-de-commande.pdf#lnk_wildcards}{le cours sur la ligne
+  de commande}. C'est une technique commune à pour ainsi dire tous les
+langages de programmation qui permet de construire des
+\enquote{modèles}, en anglais \emph{patterns}, susceptibles de
 capturer des chaînes de caractères.
 
 Par exemple, soit le fichier suivant:
@@ -113,7 +118,8 @@ symboles suivants\footnote{Cette liste n'est pas exhaustive.}:
 \end{xltabular}
 
 \paragraph{grep, egrep}
-\index[cmds]{grep|textbf}\index[cmds]{egrep|see{grep}}
+\commande*{grep}
+\commande{egrep}[|see{\texttt{grep}}]
 À la place de \verb|grep|, on peut saisir à la ligne de commande
 \verb|egrep| ou \verb|grep -E| pour \emph{extended regular
   expressions}. Quelle est la différence? Retenez ici simplement que
@@ -144,8 +150,9 @@ d'options. Parmi ces options, retenons celles-ci:
 \end{description}
 
 \paragraph{Exemples}
-Les exemples ci-dessous utilisent \href{https://notabug.org/ralessi/courses/src/master/fichiers/01-ligne-de-commande.tex#L737}{la
-    technique de la redirection}.
+Les exemples ci-dessous utilisent
+\href{./01-ligne-de-commande.pdf#lnk_redirection}{la technique de la
+  redirection}.
 \begin{minted}{text}
 [robert@kiddo courses]$ cat /usr/share/dict/cracklib-small | grep '\<s.*m\>' | grep 'ea'
 scream
@@ -354,7 +361,7 @@ Pour un exemple de code commenté, voir le \vref{lst:copyten}.
 \label{sec:execution}
 Il faut ici approfondir la notion de \emph{permissions} sur les
 fichiers qui a été présentée dans le cours sur la
-\href{https://notabug.org/ralessi/courses/src/master/fichiers/01-ligne-de-commande.tex#L454}{ligne
+\href{./01-ligne-de-commande.pdf#lnk_permissions}{ligne
   de commande}. Nous avons en effet étudié trois types de permissions
 sur les fichiers: en lecture, en écriture et en exécution. Revenons
 sur les permissions données par défaut au script \verb|backup.sh|:
@@ -370,7 +377,7 @@ Soit:
 \end{itemize}
 
 \paragraph{chmod}
-\index[cmds]{chmod|textbf}
+\commande*{chmod}
 La commande qui permet de changer les droits s'appelle
 \verb|chmod|. Pour comprendre comment l'utiliser, il faut savoir que
 les permissions sont traduites par des valeurs numériques, à savoir:
@@ -405,7 +412,7 @@ où \verb|xyz| sont les trois chiffres qui représentent les permissions.
   \begin{enumerate}
   \item La commande \verb|chmod| a été entrée à la ligne 1.
   \item À la ligne 2, nous avons lancé la commande
-    \index[cmds]{ls}\mintinline{text}|ls -l --color| sur le fichier
+    \commande{ls}\mintinline{text}|ls -l --color| sur le fichier
     \verb|backup.sh|: les droits listés à la ligne 3 montrent bien que
     la valeur \verb|x| a été ajoutée aux trois endroits possibles. On
     voit enfin que l'option \verb|--color| affiche en vert les
@@ -451,7 +458,7 @@ _preamble_bbl.tex  _preamble-ed.tex  _preamble.tex  README.tex
 \begin{quoting}
   \textbf{Commentaire:}
   \begin{itemize}
-  \item lignes 1--11: la commande \index[cmds]{ls}\verb|ls -l --color|
+  \item lignes 1--11: la commande \commande{ls}\verb|ls -l --color|
     donne l'état du dossier \emph{avant} l'exécution du script
     \verb|backup.sh|;
   \item lignes 12--17: exécution du script et messages du terminal;
@@ -486,7 +493,7 @@ caché.
 Les variables sont des informations temporaires qui peuvent être
 stockées et rappelées à tout moment. L'exemple qui suit va donner
 l'occasion d'étudier une nouvelle commande,
-\index[cmds]{echo}\verb|echo|, dont le rôle est justement de retourner
+\commande{echo}\verb|echo|, dont le rôle est justement de retourner
 au terminal la chaîne de caractères qu'on lui passe en argument:
 \begin{minted}[linenos]{text}
 [robert@kiddo courses]$ mysystem="Linux"
@@ -507,7 +514,7 @@ Mon système est Linux.
   \end{description}
   \begin{mdframed}[backgroundcolor=Cyan]
     Observez la différence dans l'usage des guillemets!
-    \href{https://notabug.org/ralessi/courses/src/master/fichiers/01-ligne-de-commande.tex#L558}{Comme
+    \href{./01-ligne-de-commande.pdf#lnk_guillemets}{Comme
       on le sait}, les guillemets servent à indiquer au \emph{shell}
     que les espaces ne sont pas des caractères actifs. Il y a
     cependant une grande différence entre les guillemets simples et
@@ -543,7 +550,7 @@ echo "et l'archive $backupdir.zip a été créée."
 
 \paragraph{read}
 \label{ref:read}
-\index[cmds]{read|textbf} Cette nouvelle commande est expliquée dans
+\commande*{read} Cette nouvelle commande est expliquée dans
 le commentaire qui suit\footnote{Voir aussi plus loin
   \vpageref{ref:read-plus}.}:
 \begin{quoting}
@@ -605,9 +612,9 @@ précédées du signe $=$. Exemple:
 \begin{quoting}
   \textbf{Commentaire:}
   \begin{enumerate}
-  \item À la ligne~1, la commande \index[cmds]{ls}\verb|ls| liste les
+  \item À la ligne~1, la commande \commande{ls}\verb|ls| liste les
     fichiers, puis son résultat est interprété par
-    \index[cmds]{wc}\verb|wc -l| qui compte le nombre de fichiers
+    \commande{wc}\verb|wc -l| qui compte le nombre de fichiers
     retournés.
   \item La variable \verb|$nbre| contient donc ce dernier résultat.
   \end{enumerate}
@@ -670,20 +677,20 @@ fi
   \begin{enumerate}
   \item Observez la structure de la condition:
     \begin{itemize}
-    \item ligne 1: \index[cmds]{if|textbf}\mintinline{bash}|if|
+    \item ligne 1: \commande*{if}\mintinline{bash}|if|
       $\rightarrow$ \emph{si <condition>} où la condition est posée
       entre crochets. Dans l'expression entre les crochets, %
       \verb|-d "$backupdir"|, \verb|-d| signifie: \verb|$backupdir|
       existe \emph{et} est un répertoire;
-    \item ligne 2: \index[cmds]{then|textbf}\mintinline{bash}|then|
+    \item ligne 2: \commande*{then}\mintinline{bash}|then|
       $\rightarrow$ \emph{alors, passez à la ligne suivante};
-    \item ligne 6: \index[cmds]{else|textbf}\mintinline{bash}|else|
+    \item ligne 6: \commande*{else}\mintinline{bash}|else|
       $\rightarrow$ \emph{autrement, passez à la ligne suivante};
-    \item ligne 8: \index[cmds]{fi|textbf}\mintinline{bash}|fi|
+    \item ligne 8: \commande*{fi}\mintinline{bash}|fi|
       $\rightarrow$ \emph{fin de la condition} (en fait les deux
       lettres de la conjonction \verb|if| écrite à l'envers).
     \end{itemize}
-  \item À la ligne 5, la commande \index[cmds]{exit}\verb|exit 1|
+  \item À la ligne 5, la commande \commande{exit}\verb|exit 1|
     ordonne au programme de se terminer immédiatement et de renvoyer
     la valeur \verb|1| comme numéro d'état (\emph{status number}). Par
     convention, \verb|0| est pour \emph{true} (le programme a bien été
@@ -723,7 +730,7 @@ Supposons que le répertoire de sauvegarde ait été supprimé mais que
 l'archive \verb|.zip| correspondante ne l'ait pas été. Dans ce cas, le
 script \verb|backup.sh| l'écraserait. Pour éviter cela, nous pouvons
 utiliser dans le script l'instruction
-\index[cmds]{elif|textbf}\verb|elif| qui permet de construire des
+\commande*{elif}\verb|elif| qui permet de construire des
 conditions en série. Littéralement, \verb|elif| est pour \emph{else
   if}, \enquote{ou autrement, si\ldots}. Voici donc ce qu'il faut
 ajouter:
@@ -802,14 +809,14 @@ droits comme le montre la ligne~7 du \vref{lst:if-then-else}.
 \end{xltabular}
 
 \paragraph{test}
-\index[cmds]{test|textbf} À l'intérieur du script \verb|bash|, les
+\commande*{test} À l'intérieur du script \verb|bash|, les
 crochets renvoient en fait à une commande par ailleurs disponible:
 \verb|test|. La commande \verb|test| renvoie en fait la sortie
 \verb|0| si le résultat est \emph{vrai} et \verb|1| si le résultat est
 \emph{faux}. Le terminal ne retourne pas le resultat, mais celui-ci
 est associé à une variable
 \verb|$?| que l'on peut afficher par la commande:
-\index[cmds]{echo}\mintinline{bash}|echo $?|. En voici quelques
+\commande{echo}\mintinline{bash}|echo $?|. En voici quelques
 exemples:
 \begin{minted}[linenos]{text}
 [robert@kiddo courses]$ ls
@@ -845,8 +852,8 @@ code différentes profondeurs de marge à gauche de façon à distinguer
 clairement des blocs logiques. Les lignes 7--20 du
 \vref{lst:if-then-else} en donnent un exemple. L'indentation permet de
 faire apparaître clairement ce qui dépend de l'instruction
-\index[cmds]{if}\verb|if| (l.~7), puis \index[cmds]{elif}\verb|elif|
-(l.~12) et enfin \index[cmds]{else}\verb|else| (l.~18).
+\commande{if}\verb|if| (l.~7), puis \commande{elif}\verb|elif|
+(l.~12) et enfin \commande{else}\verb|else| (l.~18).
 
 Cette technique est commune à tous les langages informatiques et tous
 les programmeurs l'utilisent. En Python, que nous étudierons plus
@@ -898,7 +905,7 @@ fi
 \end{minted}
 
 \subsection{case}
-\label{sec:case}\index[cmds]{case|textbf}
+\label{sec:case}\commande*{case}
 \verb|case| est une instruction qui permet d'exécuter différentes
 actions en fonction de la valeur d'une variable. Elle est intéressante
 à étudier ici car elle fait appel à la fois à la notion de variable et
@@ -951,7 +958,7 @@ esac
   \textbf{Commentaire:}
   \begin{enumerate}
   \item À la ligne 4, l'utilisateur est invité à entrer une
-    réponse. L'instruction \index[cmds]{read}\verb|read| associe la
+    réponse. L'instruction \commande{read}\verb|read| associe la
     réponse à la variable \verb|animal|.
   \item À la ligne 6, l'instruction \verb|case| reprend la variable
     qui est donc préfixée par le signe \verb|$|.
@@ -968,7 +975,7 @@ esac
 \begin{quoting}
   \textbf{Remarque:} à la place de l'instruction \verb|case|, on
   recommande aujourd'hui d'utiliser une nouvelle instruction,
-  \index[cmds]{switch}\verb|switch|, dont la syntaxe, plus complexe,
+  \commande{switch}\verb|switch|, dont la syntaxe, plus complexe,
   n'est pas étudiée ici.
 \end{quoting}
 
@@ -976,11 +983,12 @@ esac
 \label{sec:boucles}
 Les boucles (en anglais: \emph{loops}) servent à indiquer qu'une série
 d'instructions doit reprendre et continuer à s'exécuter aussi
-longtemps qu'une condition donnée n'est pas remplie.
+longtemps qu'une condition donnée est remplie ou n'est pas remplie.
 
 Prenons un exemple simple. Nous avons dans un répertoire plusieurs
-centaines d'images et nous souhaitons convertir au format \verb|.png|
-toutes les images qui sont enregistrées au format \verb|.tiff|.
+centaines d'images de différents formats et nous souhaitons convertir
+au format \verb|.png| toutes les images qui sont enregistrées au
+format \verb|.tiff|.
 
 Pour convertir une seule image, nous pouvons utiliser l'outil en ligne
 de commande \verb|convert| fourni par le programme
@@ -995,10 +1003,10 @@ répertoire qui en compte des centaines enregistrées dans des formats
 différents?
 
 \paragraph{basename}
-\index[cmds]{basename|textbf}Avant de continuer, il faut dire un mot
-de la commande \verb|basename| que nous allons utiliser ici. Cette
-commande permet de dépouiller un nom de fichier de son chemin d'accès
-et de son extension. La syntaxe est la suivante:
+\commande*{basename}Avant de continuer, il faut dire un mot de la
+commande \verb|basename| que nous allons utiliser ici. Cette commande
+permet de dépouiller un nom de fichier de son chemin d'accès et de son
+extension. La syntaxe est la suivante:
 \begin{minted}[escapeinside=||]{text}
 basename -s .|\emph{ext}| |\emph{file}|
 \end{minted}
@@ -1021,14 +1029,15 @@ total 252
 \end{minted}
 
 \paragraph{for-do-done}
-\index[cmds]{for|textbf}\index[cmds]{do|textbf}\index[cmds]{done|textbf}
+\commande*{for}\commande*{do}\commande*{done}
 La boucle que nous allons utiliser fait appel à trois instructions:
 \begin{enumerate}
 \item \verb|for| prend comme argument un nom qui sera ensuite traité
   comme une variable. Le nom de la variable est suivi de l'instruction
-  \verb|in| et d'un nom de fichier qui contient des données séparées
-  par des espaces ou bien d'une expression dans laquelle on a placé
-  des \emph{wildcards}.
+  \commande{in}\verb|in| et d'un nom de fichier qui contient des
+  données séparées par des espaces ou bien d'une expression dans
+  laquelle on a placé des
+  \href{./01-ligne-de-commande.pdf#lnk_wildcards}{\emph{wildcards}}.
 \item \verb|do| est suivi des commandes qu'il faut exécuter sur chaque
   élément retourné par l'instruction \verb|for| \ldots{} \verb|in|.
 \item \verb|done| marque la fin de la boucle.
@@ -1068,7 +1077,7 @@ done
 \end{quoting}
 
 \paragraph{while}
-\index[cmds]{while|textbf} L'expression \verb|while| exécute les
+\commande*{while} L'expression \verb|while| exécute les
 lignes de code qui suivent aussi longtemps qu'un test donné retourne
 un résultat positif (\enquote{vrai}, en anglais \emph{true}). Le
 script \verb|countlines.sh|, donné dans le \cref{lst:countlines}
@@ -1105,7 +1114,7 @@ fi
 \captionof{listing}{bash: \texttt{while}\label{lst:countlines}}
 
 \paragraph{read}
-\label{ref:read-plus}\index[cmds]{read|textbf}
+\label{ref:read-plus}\commande*{read}
 On a déjà présenté plus haut \vpageref{ref:read} cette
 instruction. Pour bien comprendre le \cref{lst:countlines}, il faut
 savoir que la fonction de \verb|read| est de \emph{lire une ligne},
@@ -1128,7 +1137,7 @@ par un \emph{retour charriot} (\emph{carriage return}).
 Étudions de près les lignes~13--17 du \cref{lst:countlines}:
 l'instruction \verb|while| (l.~13) se termine à la ligne~17 par
 \verb|done|. Et aussitôt à ce moment,
-\href{https://notabug.org/ralessi/courses/src/master/fichiers/01-ligne-de-commande.tex#L749}{l'opérateur
+\href{./01-ligne-de-commande.pdf#lnk_redirection}{l'opérateur
   de redirection} \mintinline{bash}|<| lit le contenu du fichier dont
 le nom correspond à la variable \verb|file| et le passe en argument à
 la boucle \verb|while ... done|.
@@ -1165,7 +1174,7 @@ Votre fichier makefile compte 21 lignes.
 \end{minted}
 
 \paragraph{until}
-\index[cmds]{until|textbf}À la différence de \verb|while|,
+\commande*{until}À la différence de \verb|while|,
 \verb|until| exécute les instructions qui suivent jusqu'au moment où
 le résultat du test associé à \verb|until| devient \emph{positif}
 (\emph{true}). Pour prendre un exemple très simple, le script suivant,
@@ -1192,8 +1201,8 @@ done
   \textbf{Commentaire:}
   \begin{enumerate}
   \item La condition posée à la ligne~8 se comprend ainsi:
-    \enquote{faites ce qui suit jusqu'à ce que le compteurs de
-      rugissements atteingne une valeur supérieure à celle définie par
+    \enquote{faites ce qui suit jusqu'à ce que le compteur de
+      rugissements atteigne une valeur supérieure à celle définie par
     l'utilisateur. Si la valeur est supérieure, sortez de la boucle.}
 \item À la ligne~11, on demande à \emph{bash} d'attendre une seconde.
 \item À la ligne~12, on incrémente de 1 la valeur du compteur de
@@ -1213,7 +1222,7 @@ Raaaaaaaaahhhhhhhhhhhh! (3)
 \end{minted}
 
 \paragraph{break}
-\index[cmds]{break|textbf} \verb|break| est une instruction qui
+\commande*{break} \verb|break| est une instruction qui
 ordonne de quitter immédiatement la boucle dans laquelle on se
 trouve. Supposons par exemple que l'on écrive un programme dans lequel
 on souhaite limiter une action telle que la copie de
@@ -1288,7 +1297,7 @@ Terminé. 10 fichiers au maximum ont été copiés dans Houba.
 \end{minted}
 
 \paragraph{continue}
-\index[cmds]{continue|textbf} À l'inverse de \verb|break|,
+\commande*{continue} À l'inverse de \verb|break|,
 \verb|continue| demande à \emph{bash} d'interrompre l'itération
 courante mais sans quitter la boucle, puis de reprendre la boucle à
 partir de l'itération suivante. C'est une façon de prévoir des
@@ -1417,6 +1426,7 @@ if [ $numline -le 1  ]
     echo "Votre fichier $file compte $numline lignes."
 fi
 \end{minted}
+\enlargethispage{2\baselineskip}
 \captionof{listing}{bash: exemple de
   fonction\label{lst:countlines-mk2}}