1 files changed, 173 insertions, 57 deletions

diff --git a/fichiers/03-grep-bash.tex b/fichiers/03-grep-bash.tex
index 3b685e3..65f01cf 100644
--- a/fichiers/03-grep-bash.tex
+++ b/fichiers/03-grep-bash.tex
@@ -21,6 +21,9 @@
   breaksymbolright=\small\carriagereturn}
 \setmintedinline{bgcolor=Lavender}
 \usepackage{soul}
+\makeindex[name=cmds, intoc, title={Liste des commandes et
+  instructions}]
+
 \begin{document}
 \maketitle
 \renewcommand{\contentsname}{Sommaire}
@@ -29,10 +32,10 @@
 \listoftables
 
 \chapter{grep, les expressions régulières}
-\label{cha:grep-les-expressions}
+\label{cha:grep-les-expressions}\index[cmds]{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#L709}{le
+\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
@@ -114,6 +117,7 @@ symboles suivants\footnote{Cette liste n'est pas exhaustive.}:
 \end{xltabular}
 
 \paragraph{grep, egrep}
+\index[cmds]{grep|textbf}\index[cmds]{egrep|see{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,7 +148,7 @@ 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#L732}{la
+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}.
 \begin{minted}{text}
 [robert@kiddo courses]$ cat /usr/share/dict/cracklib-small | grep '\<s.*m\>' | grep 'ea'
@@ -352,7 +356,7 @@ art dans le cadre de la programmation en
 \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#L451}{ligne
+\href{https://notabug.org/ralessi/courses/src/master/fichiers/01-ligne-de-commande.tex#L454}{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|:
@@ -368,6 +372,7 @@ Soit:
 \end{itemize}
 
 \paragraph{chmod}
+\index[cmds]{chmod|textbf}
 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:
@@ -402,11 +407,11 @@ 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
-    \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 fichiers qui sont
-    exécutables.
+    \index[cmds]{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
+    fichiers qui sont exécutables.
   \end{enumerate}
 \end{quoting}
 
@@ -448,8 +453,9 @@ _preamble_bbl.tex  _preamble-ed.tex  _preamble.tex  README.tex
 \begin{quoting}
   \textbf{Commentaire:}
   \begin{itemize}
-  \item lignes 1--11: la commande \verb|ls -l --color| donne l'état du
-    dossier \emph{avant} l'exécution du script \verb|backup.sh|;
+  \item lignes 1--11: la commande \index[cmds]{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;
   \item lignes 18--30: la commande \verb|ls -l --color| donne l'état du
     dossier \emph{après} l'exécution du script \verb|backup.sh|. On
@@ -481,9 +487,9 @@ caché.
 \label{sec:les-variables}
 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, \verb|echo|, dont le rôle
-est justement de retourner au terminal la chaîne de caractères qu'on
-lui passe en argument:
+l'occasion d'étudier une nouvelle commande,
+\index[cmds]{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"
 [robert@kiddo courses]$ echo 'Mon système est $mysystem.'
@@ -503,7 +509,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#L554}{Comme
+    \href{https://notabug.org/ralessi/courses/src/master/fichiers/01-ligne-de-commande.tex#L558}{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
@@ -538,6 +544,7 @@ echo "et l'archive $backupdir.zip a été créée."
 \end{minted}
 
 \paragraph{read}
+\index[cmds]{read|textbf}
 Cette nouvelle commande est expliquée dans le commentaire qui suit:
 \begin{quoting}
   \textbf{Commentaire:}
@@ -598,9 +605,10 @@ précédées du signe $=$. Exemple:
 \begin{quoting}
   \textbf{Commentaire:}
   \begin{enumerate}
-  \item À la ligne~1, la commande \verb|ls| liste les fichiers, puis
-    son résultat est interprété par \verb|wc -l| qui compte le nombre
-    de fichiers retournés.
+  \item À la ligne~1, la commande \index[cmds]{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
+    retournés.
   \item La variable \verb|$nbre| contient donc ce dernier résultat.
   \end{enumerate}
 \end{quoting}
@@ -662,24 +670,24 @@ fi
   \begin{enumerate}
   \item Observez la structure de la condition:
     \begin{itemize}
-    \item ligne 1: \mintinline{bash}|if| $\rightarrow$ \emph{si
-        <condition>} où la condition est posée entre crochets. Dans
-      l'expression entre les crochets, %
+    \item ligne 1: \index[cmds]{if|textbf}\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: \mintinline{bash}|then| $\rightarrow$ \emph{alors,
-        passez à la ligne suivante};
-    \item ligne 6: \mintinline{bash}|else| $\rightarrow$
-      \emph{autrement, passez à la ligne suivante};
-    \item ligne 8: \mintinline{bash}|fi| $\rightarrow$ \emph{fin de la
-      condition} (en fait les deux lettres de la conjonction \verb|if|
-    écrite à l'envers).
+    \item ligne 2: \index[cmds]{then|textbf}\mintinline{bash}|then|
+      $\rightarrow$ \emph{alors, passez à la ligne suivante};
+    \item ligne 6: \index[cmds]{else|textbf}\mintinline{bash}|else|
+      $\rightarrow$ \emph{autrement, passez à la ligne suivante};
+    \item ligne 8: \index[cmds]{fi|textbf}\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 \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é exécuté) et
-    \verb|1| est pour \emph{false} (il y a eu une erreur).
+  \item À la ligne 5, la commande \index[cmds]{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é
+    exécuté) et \verb|1| est pour \emph{false} (il y a eu une erreur).
   \end{enumerate}
 \end{quoting}
 
@@ -716,10 +724,11 @@ echo "et l'archive $backupdir.zip a été créée."
 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 \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:
+utiliser dans le script l'instruction
+\index[cmds]{elif|textbf}\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:
 \begin{minted}{bash}
 elif [ -e "$backupdir".zip ]
   then
@@ -797,13 +806,15 @@ droits comme le montre la ligne~7 du \vref{lst:if-then-else}.
 \end{xltabular}
 
 \paragraph{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
+\index[cmds]{test|textbf} À 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:
-\mintinline{bash}|echo $?|. En voici quelques exemples:
+\index[cmds]{echo}\mintinline{bash}|echo $?|. En voici quelques
+exemples:
 \begin{minted}[linenos]{text}
 [robert@kiddo courses]$ ls
 bibliography.bib  makefile           _preamble-ed.tex  _preamble.tex  README.tex
@@ -837,8 +848,9 @@ L'indentation est une technique qui consiste à donner aux lignes de
 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 \verb|if|
-(l.~7), puis \verb|elif| (l.~12) et enfin \verb|else| (l.~18).
+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).
 
 Cette technique est commune à tous les langages informatiques et tous
 les programmeurs l'utilisent. En Python, que nous étudierons plus
@@ -892,18 +904,18 @@ fi
 \end{minted}
 
 \subsection{case}
-\label{sec:case}
+\label{sec:case}\index[cmds]{case|textbf}
 \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
 aux expressions régulières. La syntaxe est la suivante:
-\begin{minted}[linenos,escapeinside=||]{text}
-case |\emph{variable}| in
-  |\emph{regexpr1}|)
-  |\emph{commandes ...}|
+\begin{minted}[linenos]{bash}
+case $var in
+  expr1)
+  <commandes ...>
   ;;
-  |\emph{regexpr2}|)
-  |\emph{commandes ...}|
+  expr2)
+  <commandes ...>
   ;;
 esac
 \end{minted}
@@ -920,7 +932,9 @@ esac
   \end{enumerate}
 \end{quoting}
 
-Voici un exemple facile à comprendre:
+Le \vref{lst:case} montre un exemple facile à comprendre de cette
+technique.
+\begin{listing}[H]
 \begin{minted}[linenos]{bash}
 #!/bin/bash
 
@@ -939,12 +953,15 @@ case $animal in
   ;;
 esac
 \end{minted}
+\caption{bash: instruction \texttt{case}}
+\label{lst:case}
+\end{listing}
 \begin{quoting}
   \textbf{Commentaire:}
   \begin{enumerate}
   \item À la ligne 4, l'utilisateur est invité à entrer une
-    réponse. L'instruction \verb|read| associe la réponse à la
-    variable \verb|animal|.
+    réponse. L'instruction \index[cmds]{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|$|.
   \item Aux lignes 7 et 10, on permet à l'utilisateur d'entrer soit le
@@ -960,10 +977,109 @@ esac
 \begin{quoting}
   \textbf{Remarque:} à la place de l'instruction \verb|case|, on
   recommande aujourd'hui d'utiliser une nouvelle instruction,
-  \verb|switch|, dont la syntaxe, plus complexe, n'est pas étudiée
-  ici.
+  \index[cmds]{switch}\verb|switch|, dont la syntaxe, plus complexe,
+  n'est pas étudiée ici.
+\end{quoting}
+
+\section{Boucles}
+\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.
+
+Prenons un exemple simple. Nous avons dans un répertoire plusieurs
+centaines d'images et que 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
+\emph{imagemagick}\footnote{\url{http://www.imagemagick.org}}. Pour
+convertir une seule image, la syntaxe est la suivante:
+\begin{minted}{bash}
+convert image.tiff image.png
+\end{minted}
+
+Mais comment faire pour en convertir un grand nombre pris dans un
+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:
+\begin{minted}[escapeinside=||]{text}
+basename -s .|\emph{ext}| |\emph{file}|
+\end{minted}
+où \emph{ext} est le nom de l'extension et \emph{file} le nom du
+fichier. Voici un exemple:
+\begin{minted}{text}
+[robert@kiddo fichiers]$ ls -l images/
+total 252
+-rw-r--r-- 1 robert robert 96404  2 juil. 18:32 02-ascii.png
+-rw-r--r-- 1 robert robert 33951 20 juin  19:59 02-donnees1.png
+-rw-r--r-- 1 robert robert 11503 20 juin  20:01 02-donnees2.png
+-rw-r--r-- 1 robert robert 17450  3 juil. 17:43 02-exercice_formats.png
+-rw-r--r-- 1 robert robert 87510 14 sept. 15:06 02-unicode.png
+[robert@kiddo fichiers]$ basename -s .png images/*
+02-ascii
+02-donnees1
+02-donnees2
+02-exercice_formats
+02-unicode
+\end{minted}
+
+\paragraph{for-do-done}
+\index[cmds]{for|textbf}\index[cmds]{do|textbf}\index[cmds]{done|textbf}
+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}.
+\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.
+\end{enumerate}
+
+Voici maintenant le script qui assure la conversion du format
+\verb|.tiff| vers le format \verb|.png|:
+\begin{listing}[H]
+\begin{minted}[linenos]{bash}
+#!/bin/bash
+for file in $(basename -s .tiff $(ls *.tiff))
+  do convert "$file".tiff "$file".png
+done
+\end{minted}
+\caption{bash: \texttt{for ... do ... done}}
+\end{listing}
+
+\begin{quoting}
+  \textbf{Commentaire:}
+  \begin{enumerate}
+  \item Comprendre ainsi le début de la ligne~2 %
+    (\mintinline{bash}|for file in|): \enquote{pour tout \texttt{file}
+      dans\ldots} où \verb|file| définit une variable dont la valeur
+    pourra ensuite être rappelée par \verb|$file|. Le reste de la
+    ligne est une \emph{double capture} (v.~\emph{supra},
+    \vref{sec:capt-et-subst}):
+    \begin{enumerate}
+    \item \verb|$(ls *.tiff)| liste et retourne tous les fichiers dont
+      l'extension est \verb|.tiff|
+    \item \verb|$(basename -s .tiff $(ls *.tiff))| demande à
+      \verb|basename| de dépouiller tous ces fichiers de leur
+      extension \verb|.tiff| et retourne la liste des noms seuls.
+    \end{enumerate}
+  \item La variable \verb|file| est donc une liste constituée des noms
+    de tous les fichiers \verb|.tiff| sans leur extension. La ligne~3
+    les convertit tous les uns après les autres vers le format
+    \verb|.png|.
+  \end{enumerate}
 \end{quoting}
 
 \hfill\verb|../..| à suivre
 
+\printindex[cmds]
 \end{document}