Introduction

Git est livré avec une documentation intégrée extensive. Savoir l'invoquer rapidement vous épargnera des heures de tâtonnement. Cette page parcourt le système d'aide depuis les one-liners jusqu'aux manuels complets.

Trois façons de demander

Chaque commande supporte trois formes d'aide :

git help <command>     # page man complète dans votre pager
git <command> --help    # même chose
git <command> -h        # résumé court d'utilisation

Exemple :

git help commit
git commit --help
git commit -h

Lister les commandes

git help -a            # toutes les commandes
git help -g            # guides (gittutorial, gitcore-tutorial, etc.)
git help everyday      # le pense-bête Git du quotidien

git help everyday en particulier est l'une des meilleures références débutant-à-intermédiaire livrées avec Git.

Guides conceptuels

Git inclut des guides en prose comme pages man séparées :

git help gittutorial
git help gitcore-tutorial
git help gitglossary
git help gitworkflows
git help gitrevisions

gitrevisions est la référence canonique pour la syntaxe des refs (HEAD~3, main@{yesterday}, etc.).

Configurer le format de l'aide

Par défaut, git help ouvre une page man. Vous pouvez basculer vers HTML ou info :

git config --global help.format html
git config --global help.format info
git config --global help.format man   # par défaut

HTML ouvre la copie locale dans votre navigateur, utile sur les systèmes sans man.

Ressources en ligne

• git-scm.com/docs : manuel officiel miroité en ligne.
• Livre Pro Git de Chacon et Straub : gratuit, complet, régulièrement mis à jour.
• Archive de la liste de diffusion Git : lore.kernel.org/git pour les discussions de conception.

Rechercher dans la documentation

Si vous ne vous souvenez pas du nom d'une commande, man -k git (ou apropos git) liste chaque page man Git avec une description en une ligne. Pour chercher dans la documentation, redirigez vers grep :

man -k git
git help -a | grep -i merge
git help log | grep -A 2 'pickaxe'

Pour un apprentissage approfondi, le livre Pro Git est gratuit et fait autorité ; le Manuel de Référence Git sur git-scm.com/docs reflète les pages man avec des liens croisés. La page man gitfaq est une pépite sous-utilisée qui répond à de nombreuses questions du monde réel en prose claire.

Erreurs fréquentes

Chercher sur le web des réponses Stack Overflow obsolètes utilisant des commandes dépréciées comme git checkout pour le changement de branche alors que git switch existe. Vérifiez toujours avec git help pour votre version installée. Autre erreur : supposer que -h et --help se comportent identiquement ; ce n'est pas le cas. -h affiche un résumé d'un écran, tandis que --help ouvre la page man complète (ou le navigateur, selon help.format). Enfin, ne sautez pas git help glossary ; de nombreux termes Git « bizarres » (porcelain, plumbing, refspec, dangling object) y sont définis précisément en une seule courte page.