3.6 Pedindo ajuda via `git help`

Ao trabalhar com Git, é impossível memorizar todos os comandos, opções e detalhes de uso. Felizmente, o próprio Git oferece um sistema de ajuda integrado, que pode ser acessado diretamente pelo terminal.

Esse sistema é ativado através do comando

git help

Ao executar esse comando, o Git exibe uma lista com os principais comandos disponíveis, organizados por categoria, além de uma breve descrição do que cada um faz. Na prática, é como se fosse o manual inicial do Git.

Como funciona o git help

O comando git help pode ser usado de duas formas principais:

1. Ajuda geral

Quando você executa apenas:

git help

o Git mostra uma visão geral, com:

• comandos mais utilizados;

• categorias de comandos;

• instruções de como obter ajuda mais específica.

Essa forma é útil quando você quer explorar o Git e descobrir o que é possível fazer com ele.

2. Ajuda de um comando específico

Você também pode pedir ajuda sobre um comando específico, informando seu nome como argumento:

git help comando

Por exemplo:

git help init

Nesse caso, o Git abre a documentação detalhada apenas do comando init, explicando:

• o que ele faz;

• quais opções existem;

• quais argumentos podem ser usados;

• exemplos de uso.

Ou seja, é como pedir:

“Git, me explica exatamente como funciona esse comando”.

Navegando na documentação do git help

Dependendo do sistema operacional, a forma como você visualiza e navega pelo conteúdo exibido pelo git help pode variar:

Linux e macOS

A documentação normalmente é aberta em um pager (geralmente o less). Nesse caso, você pode:

• Usar as setas ou Page Up / Page Down para rolar o texto;

• Pressionar q para sair e voltar ao terminal;

• Usar /palavra para buscar termos dentro do pager.

Windows

Na maioria das instalações, o comando git help abre diretamente a página em um navegador web, mostrando a documentação em formato HTML.

• Nesse caso, você navega como em qualquer página da web;

• É possível copiar textos, pesquisar no navegador e até traduzir se necessário.

Dessa forma, o git help se adapta ao seu sistema e oferece uma forma prática de acessar a documentação, seja no terminal ou no navegador.

Idioma da documentação

Dependendo da sua instalação do Git e do sistema operacional, a documentação exibida pelo git help pode aparecer em inglês.

Isso é completamente normal e não deve ser visto como um problema. Na prática, a maior parte da documentação técnica do mundo está em inglês, e aprender a lidar com isso faz parte do processo de desenvolvimento.

Se você não se sentir confortável lendo em inglês, uma boa estratégia é simplesmente copiar o texto exibido e colar em um tradutor, como o Google Tradutor. Assim, você consegue entender o conteúdo sem perder o contexto técnico.

Além disso, você também pode consultar a documentação oficial do Git em português diretamente pelo navegador, o que pode ser mais confortável para leitura. Uma versão em português está disponível no site oficial do Git:

Git - git Documentationgit-scm.com

Com o tempo, você vai perceber que muitos termos se repetem e a leitura da documentação em inglês se torna cada vez mais natural.

O git help é a documentação oficial

O conteúdo exibido pelo git help não é um material separado ou resumido: ele é, essencialmente, a própria documentação oficial do Git, acessada diretamente pelo terminal.

Ou seja, quando você executa:

git help comando

você está consultando a mesma documentação que está disponível no site oficial do Git, apenas em formato de texto no terminal.

Isso significa que:

• tudo o que você vê no git help é informação oficial;

• a documentação online e a do terminal são equivalentes;

• a diferença está apenas no formato de acesso.

Se preferir, você também pode acessar essa mesma documentação pelo navegador, inclusive em português, no site oficial do Git. A versão online costuma ser mais confortável para leitura, enquanto o git help é mais prático para consultas rápidas durante o uso do terminal.

Na prática, o git help é apenas a documentação do Git, onde você já está trabalhando: no terminal.

Outras formas de acessar a ajuda

Além de git help, existem duas variações muito comuns que fazem basicamente a mesma coisa:

git comando --help

e

git comando -h

A diferença importante aqui é que, nesses casos, --help e -h não são comandos novos. Eles são opções do próprio comando que queremos saber mais sobre.

Ou seja, quando você escreve:

git init --help

ou

git init -h

você não está chamando um comando diferente. Você está executando o comando init, mas pedindo para ele se comportar de um jeito específico: mostrar sua própria ajuda.

Nesse contexto:

• init é o comando;

• --help é uma opção que modifica o comportamento desse comando;

• -h é apenas uma forma abreviada (atalho) de --help.

Em outras palavras, git help init e git init --help são duas formas diferentes de fazer a mesma pergunta ao Git:

“me explique como funciona o comando init”.

Na prática, existe apenas uma diferença de formato na resposta:

• git help comando normalmente abre a documentação completa;

• git comando --help e -h costumam mostrar uma versão mais resumida.

O mais importante é entender que o sistema de ajuda faz parte do próprio Git e está integrado aos comandos. Sempre que você vir --help ou -h, pode assumir que está diante de uma opção que serve para pedir informações sobre aquele comando específico.

Por que isso é tão importante?

Saber usar o git help é mais importante do que decorar comandos.

Na prática, desenvolvedores experientes usam a ajuda o tempo todo, porque:

• ninguém memoriza tudo;

• o Git tem muitos comandos e opções;

• consultar a documentação faz parte do fluxo normal de trabalho.

Ou seja, usar git help não é sinal de falta de conhecimento, é sinal de que você sabe onde buscar informação.

---

O comando git help é o seu principal aliado para aprender Git. Sempre que surgir uma dúvida sobre como usar algum comando, a primeira reação deve ser pedir ajuda ao próprio Git. Assim, você se torna menos dependente de tutoriais externos e mais confiante para explorar a ferramenta por conta própria.

Esta é uma explicação simplificada para fins didáticos. Para explorar todas as possibilidades do comando git, consulte a documentação oficial.