From ff3f9c66eedf7c5ae9d864f56843412b18e3063a Mon Sep 17 00:00:00 2001 From: Philippe Dosch <Philippe.Dosch@loria.fr> Date: Sun, 5 Jan 2014 18:44:35 +0100 Subject: [PATCH] Introduces minor improvements about basis commands --- maincommands.tex | 35 +++++++++++++++++++---------------- 1 file changed, 19 insertions(+), 16 deletions(-) diff --git a/maincommands.tex b/maincommands.tex index 468c1ae..3f26b9d 100644 --- a/maincommands.tex +++ b/maincommands.tex @@ -37,8 +37,7 @@ \framesubtitle{\gitcrea} \begin{itemize} \item - Création d'un dépôt local à partir d'un dépôt existant (local ou - distant) + Création d'un dépôt local à partir d'un dépôt existant \item Met à jour la configuration du dépôt local pour garder une référence vers le dépôt distant @@ -95,7 +94,7 @@ \item Cela permet de créer par la suite des \emph{commits} séparés \item - Typiquement : un \emph{commit} = ensemble atomique de + Typiquement : un \emph{commit} = un ensemble atomique de modifications \end{itemize} } @@ -117,8 +116,8 @@ \ex{git commit} : un éditeur externe sera lancé pour la saisie du message \item - \ex{git commit -m "xxx"} : le message est fourni en ligne de - commande + \ex{git commit -m "\emph{xxx}"} : le message est fourni en ligne + de commande \end{itemize} \end{itemize} @@ -202,8 +201,8 @@ La commande \ex{git commit -a} permet \begin{enumerate} \item - d'indexer automatiquement tous les fichiers qui ont déjà été - indexés au moins une fois + d'indexer automatiquement tous les fichiers modifiés qui ont + déjà été indexés au moins une fois \item de répercuter l'index dans le dépôt local \end{enumerate} @@ -225,7 +224,7 @@ Affiche, pour chaque \emph{commit}, son identifiant, l'auteur, la date et la première ligne du log \item - \ex{git log commit1...commit2} : affiche les logs entre 2 + \ex{git log \emph{commit1...commit2}} : affiche les logs entre 2 \emph{commits} spécifiques (le premier \emph{commit} fourni doit être le plus récent) \end{itemize} @@ -301,8 +300,8 @@ Sans paramètre, affiche les différences de contenu entre le répertoire de travail et l'index \item - \ex{git diff commit1...commit2} : affiche les changements de - contenus entre 2 \emph{commits} spécifiques (le premier + \ex{git diff \emph{commit1...commit2}} : affiche les changements + de contenus entre 2 \emph{commits} spécifiques (le premier \emph{commit} fourni doit être le plus récent) \item \ex{git diff --cached} : différences entre l'index et le dernier @@ -328,8 +327,8 @@ \item Associe une balise (une étiquette textuelle) à un \emph{commit} \item - \ex{git tag xxx} : associe le tag \ex{xxx} au dernier - \emph{commit} réalisé + \ex{git tag \emph{xxx}} : associe le tag \ex{\emph{xxx}} au + dernier \emph{commit} réalisé \item \ex{git tag} : liste tous les tags existants \item @@ -337,6 +336,9 @@ qu'à partir de sa signature SHA-1 \item Exemples typiques de balises : v1.0, prod2.0, 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 \end{itemize} } @@ -356,8 +358,9 @@ À utiliser avec précaution, certaines suppressions deviennent irrévocables... \item - Peut souvent être remplacé avantageusement par un nouveau - \emph{commit}... + \textbf{Il est souvent plus approprié de faire un nouveau + \emph{commit} annulant le \emph{commit} concerné (voir \ex{git + revert})} \item Un exemple utile toutefois pour rétablir l'état du répertoire de travail au dernier \emph{commit} effectué (et supprimer ainsi @@ -391,7 +394,7 @@ \begin{itemize} \item Efface un fichier ou un répertoire physiquement, ainsi qu'au - niveau du suivi Git + niveau du suivi par Git \item À utiliser plutôt qu'un simple \ex{rm} système qui n'informerait pas Git de la suppression @@ -454,7 +457,7 @@ \begin{itemize} \item \ex{simple} : seule la branche courante est concernée - (conseillé) + (conseillé en général) \item \ex{matching} : toutes les branches locales sont concernées % si elles existent sur le serveur -- GitLab