diff --git a/maincommands.tex b/maincommands.tex index 8804352851c2b216d39218d6adfff0bcfeeb4ffc..5c892bb9e6702de1c86b7a9cd0a21f468be08234 100644 --- a/maincommands.tex +++ b/maincommands.tex @@ -41,7 +41,7 @@ %====================================================================== -\frame{\frametitle{Niveaux de stockage et commandes Git} +\frame{\frametitle{Niveaux de stockage et commandes \ex{git}} \framesubtitle{Quelques flux courants} \begin{center} \includegraphics[width=10cm]{princindex.eps} @@ -56,10 +56,11 @@ \item Création d'un dépôt local vide \item - Peut suffire pour gérer l'historique d'un projet pour un seul - utilisateur... + Initialisation déjà suffisante pour gérer l'historique d'un projet + pour un seul utilisateur... \item - Crée une \emph{branche} par défaut, appelée \ex{master} + Crée une \emph{branche} par défaut, appelée \ex{master} (ou + \ex{main}) \item Penser à ajouter un fichier \ex{README} décrivant succinctement le projet @@ -97,14 +98,14 @@ Indexe le \emph{contenu} des fichiers du répertoire courant passés en paramètre \item - Rappel : Git travaille sur les contenus, pas sur les fichiers + Rappel : \ex{git} travaille sur les contenus, pas sur les fichiers \item Conséquence : si des fichiers sont modifiés après leur indexation, - c'est la version indexée qui sera répercutée dans le dépôt (et - donc pas celle du répertoire courant) + c'est la version indexée qui sera répercutée dans le dépôt\\ + (et donc pas celle du répertoire courant) \item Un fichier qui a été indexé au moins une fois est ensuite suivi - par Git (typiquement par \ex{git status}) + par \ex{git} (typiquement par \ex{git status}) \item Mais l'indexation de chaque nouvelle version de ce fichier doit être réalisée par un nouveau \ex{git add} @@ -129,7 +130,7 @@ modifications \item On peut aussi faire des ajouts plus fins à l'intérieur d'un - fichier(les \emph{chunks}) \emph{via} \ex{git add -p} + fichier (les \emph{chunks}) \emph{via} \ex{git add -p} \end{itemize} } @@ -155,8 +156,8 @@ \end{itemize} \end{itemize} \begin{codebox} - \mygitplus{git add README}\\ - \mygit{git commit -m "New feature described"}{gitcommit.txt} + \mygitplus{git add README.md}\\ + \mygit{git commit -m "Adds documentation"}{gitcommit.txt} \end{codebox} } @@ -299,7 +300,7 @@ \framesubtitle{\gitinter} \begin{itemize} \item - Affiche le détail d'un \emph{commit} (ou d'autres entités Git) + Affiche le détail d'un \emph{commit} (ou d'autres entités \ex{git}) \item L'identifiant (court\,/\,long) correspondant doit être fourni en paramètre, sinon c'est le dernier \emph{commit} qui est @@ -313,6 +314,10 @@ \item \textcolor{red}{lignes supprimées} : préfixées par un \ex{-} \end{itemize} + \item + Voir aussi \ex{gitk}, qui cumule les informations de \ex{git + log}\\ + et \ex{git show} dans une interface graphique \end{itemize} } @@ -334,11 +339,27 @@ Affiche des informations sur l'état du répertoire de travail et de l'index \item - Permet de savoir ce que contient l'index (et donc ce qui sera - concerné par le prochain \emph{commit}) + Permet d'avoir des informations + \begin{itemize} + \item + sur ce que contient l'index\\ + (et donc ce qui sera concerné par le prochain \emph{commit}) + \item + sur les fichiers qui sont suivis par \ex{git} et ceux qui ne le + sont pas + \end{itemize} \item - Permet de savoir quels fichiers sont suivis par Git et quels sont - ceux qui ne le sont pas + Le message résultat «~\ex{rien à valider, la copie de travail est + propre}~» indique + \begin{itemize} + \item + qu'aucune modification n'est détectée + \item + qu'aucun contenu n'est dans l'index + \item + et donc que le répertoire de travail est identique au dernier + commit réalisé + \end{itemize} \end{itemize} } @@ -397,7 +418,8 @@ Intérêt : identifier un \emph{commit} particulier plus facilement qu'à partir de sa signature SHA-1 \item - Exemples typiques de balises : v1.0, prod2.0, final4.4... + Exemples typiques de balises : \ex{v1.0}, \ex{prod2.0}, + \ex{final4.4}... \item Attention : les tags ne sont pas transférés \emph{par défaut} lors des synchronisations avec les dépôts distants\\ @@ -446,15 +468,15 @@ \item Commande permettant de créer un \emph{contre-commit} \item - Ce \emph{contre-commit} est un commit venant exactement annuler + Ce \emph{contre-commit} est un commit venant exactement inverser les modifications introduites par un commit particulier \item En cas d'erreur introduite par un commit \begin{itemize} \item - seul sur un dépôt : à privilégier + si seul sur un dépôt : à privilégier \item - travail collaboratif : quasi-obligatoire (problème de + si travail collaboratif : quasi-obligatoire (problème de synchronisation sinon) \end{itemize} \item @@ -476,7 +498,7 @@ À utiliser plutôt qu'un simple \ex{mv} système qui ne permet pas la conservation de l'historique \item - Le changement est répercuté dans l'index (et nécessite ensuite + Le changement est ajouté à l'index (et nécessite ensuite d'être répercuté par un \emph{commit}) \end{itemize} } @@ -487,13 +509,13 @@ \framesubtitle{\gitop} \begin{itemize} \item - Efface un fichier ou un répertoire physiquement, ainsi qu'au - niveau du suivi par Git + Efface un fichier ou un répertoire au niveau du suivi par + \ex{git}, ainsi que physiquement par défaut \item À utiliser plutôt qu'un simple \ex{rm} système qui n'informerait - pas Git de la suppression + pas \ex{git} de la suppression \item - Le changement est répercuté dans l'index (et nécessite ensuite + Le changement est ajouté à l'index (et nécessite ensuite d'être répercuté par un \emph{commit}) \end{itemize} }