<commit_before>gittutorial(7)
==============

NAME
----
gittutorial - Um tutorial de introdução ao git (para versão 1.5.1 ou mais nova)

SYNOPSIS
--------
git *

DESCRIPTION
-----------

Este tutorial explica como importar um novo projeto para o git,
adicionar mudanças a ele, e compartilhar mudanças com outros
desenvolvedores.

Se, ao invés disso, você está interessado primariamente em usar git para
obter um projeto, por exemplo, para testar a última versão, você pode
preferir começar com os primeiros dois capítulos de
link:user-manual.html[O Manual do Usuário Git].

Primeiro, note que você pode obter documentação para um comando como
`git log --graph` com:

------------------------------------------------
$ man git-log
------------------------------------------------

ou:

------------------------------------------------
$ git help log
------------------------------------------------

Com a última forma, você pode usar o visualizador de manual de sua
escolha; veja linkgit:git-help[1] para maior informação.

É uma boa idéia informar ao git seu nome e endereço público de email
antes de fazer qualquer operação. A maneira mais fácil de fazê-lo é:

------------------------------------------------
$ git config --global user.name "<NAME>"
$ git config --global user.email <EMAIL>
------------------------------------------------


Importando um novo projeto
-----------------------

Assuma que você tem um tarball project.tar.gz com seu trabalho inicial.
Você pode colocá-lo sob controle de revisão git da seguinte forma:

------------------------------------------------
$ tar xzf project.tar.gz
$ cd project
$ git init
------------------------------------------------

Git irá responder

------------------------------------------------
Initialized empty Git repository in .git/
------------------------------------------------

Você agora iniciou seu diretório de trabalho--você deve ter notado um
novo diretório criado, com o nome de ".git".

A seguir, diga ao git para gravar um instantâneo do conteúdo de todos os
arquivos sob o diretório corrente (note o '.'), com 'git-add':

------------------------------------------------
$ git add .
------------------------------------------------

Este instantâneo está agora armazenado em uma área temporária que o git
chama de "index" ou índice. Você pode armazenar permanentemente o
conteúdo do índice no repositório com 'git-commit':

------------------------------------------------
$ git commit
------------------------------------------------

Isto vai te pedir por uma mensagem de commit. Você agora gravou sua
primeira versão de seu projeto no git.

Fazendo mudanças
--------------

Modifique alguns arquivos, e, então, adicione seu conteúdo atualizado ao
índice:

------------------------------------------------
$ git add file1 file2 file3
------------------------------------------------

Você está agora pronto para fazer o commit. Você pode ver o que está
para ser gravado usando 'git-diff' com a opção --cached:

------------------------------------------------
$ git diff --cached
------------------------------------------------

(Sem --cached, o comando 'git-diff' irá te mostrar quaisquer mudanças
que você tenha feito mas ainda não adicionou ao índice.) Você também
pode obter um breve sumário da situação com 'git-status':

------------------------------------------------
$ git status
# On branch master
# Changes to be committed:
#   (use "git reset HEAD <file>..." to unstage)
#
#	modified:   file1
#	modified:   file2
#	modified:   file3
#
------------------------------------------------

Se você precisar fazer qualquer outro ajuste, faça-o agora, e, então,
adicione qualquer conteúdo modificado ao índice. Finalmente, grave suas
mudanças com:

------------------------------------------------
$ git commit
------------------------------------------------

Isto irá novamente te pedir por uma mensagem descrevendo a mudança, e,
então, gravar a nova versão do projeto.

Alternativamente, ao invés de executar 'git-add' antes, você pode usar

------------------------------------------------
$ git commit -a
------------------------------------------------

o que irá automaticamente notar quaisquer arquivos modificados (mas não
novos), adicioná-los ao índices, e gravar, tudo em um único passo.

Uma nota em mensagens de commit: Apesar de não ser exigido, é uma boa
idéia começar a mensagem com uma simples e curta (menos de 50
caracteres) linha sumarizando a mudança, seguida de uma linha em branco
e, então, uma descrição mais detalhada. Ferramentas que transformam
commits em email, por exemplo, usam a primeira linha no campo de
cabeçalho Subject: e o resto no corpo.

Git rastreia conteúdo, não arquivos
----------------------------

Muitos sistemas de controle de revisão provêem um comando `add` que diz
ao sistema para começar a rastrear mudanças em um novo arquivo. O
comando `add` do git faz algo mais simples e mais poderoso: 'git-add' é
usado tanto para arquivos novos e arquivos recentemente modificados, e
em ambos os casos, ele tira o instantâneo dos arquivos dados e armazena
o conteúdo no índice, pronto para inclusão do próximo commit.

Visualizando história do projeto
-----------------------

Em qualquer ponto você pode visualizar a história das suas mudanças
usando

------------------------------------------------
$ git log
------------------------------------------------

Se você também quer ver a diferença completa a cada passo, use

------------------------------------------------
$ git log -p
------------------------------------------------

Geralmente, uma visão geral da mudança é útil para ter a sensação de
cada passo

------------------------------------------------
$ git log --stat --summary
------------------------------------------------

Gerenciando "branches"/ramos
-----------------

Um simples repositório git pode manter múltiplos ramos de
desenvolvimento. Para criar um novo ramo chamado "experimental", use

------------------------------------------------
$ git branch experimental
------------------------------------------------

Se você executar agora

------------------------------------------------
$ git branch
------------------------------------------------
<commit_msg>Documentation: update pt-BR<commit_after>gittutorial(7)
==============

NOME
----
gittutorial - Um tutorial de introdução ao git (para versão 1.5.1 ou mais nova)

SINOPSE
--------
git *

DESCRIÇÃO
-----------

Este tutorial explica como importar um novo projeto para o git,
adicionar mudanças a ele, e compartilhar mudanças com outros
desenvolvedores.

Se, ao invés disso, você está interessado primariamente em usar git para
obter um projeto, por exemplo, para testar a última versão, você pode
preferir começar com os primeiros dois capítulos de
link:user-manual.html[O Manual do Usuário Git].

Primeiro, note que você pode obter documentação para um comando como
`git log --graph` com:

------------------------------------------------
$ man git-log
------------------------------------------------

ou:

------------------------------------------------
$ git help log
------------------------------------------------

Com a última forma, você pode usar o visualizador de manual de sua
escolha; veja linkgit:git-help[1] para maior informação.

É uma boa idéia informar ao git seu nome e endereço público de email
antes de fazer qualquer operação. A maneira mais fácil de fazê-lo é:

------------------------------------------------
$ git config --global user.name "<NAME>"
$ git config --global user.email <EMAIL>
------------------------------------------------


Importando um novo projeto
-----------------------

Assuma que você tem um tarball project.tar.gz com seu trabalho inicial.
Você pode colocá-lo sob controle de revisão git da seguinte forma:

------------------------------------------------
$ tar xzf project.tar.gz
$ cd project
$ git init
------------------------------------------------

Git irá responder

------------------------------------------------
Initialized empty Git repository in .git/
------------------------------------------------

Agora que você iniciou seu diretório de trabalho, você deve ter notado que um
novo diretório foi criado com o nome de ".git".

A seguir, diga ao git para gravar um instantâneo do conteúdo de todos os
arquivos sob o diretório atual (note o '.'), com 'git-add':

------------------------------------------------
$ git add .
------------------------------------------------

Este instantâneo está agora armazenado em uma área temporária que o git
chama de "index" ou índice. Você pode armazenar permanentemente o
conteúdo do índice no repositório com 'git-commit':

------------------------------------------------
$ git commit
------------------------------------------------

Isto vai te pedir por uma mensagem de commit. Você agora gravou sua
primeira versão de seu projeto no git.

Fazendo mudanças
--------------

Modifique alguns arquivos, e, então, adicione seu conteúdo atualizado ao
índice:

------------------------------------------------
$ git add file1 file2 file3
------------------------------------------------

Você está agora pronto para fazer o commit. Você pode ver o que está
para ser gravado usando 'git-diff' com a opção --cached:

------------------------------------------------
$ git diff --cached
------------------------------------------------

(Sem --cached, o comando 'git-diff' irá te mostrar quaisquer mudanças
que você tenha feito mas ainda não adicionou ao índice.) Você também
pode obter um breve sumário da situação com 'git-status':

------------------------------------------------
$ git status
# On branch master
# Changes to be committed:
#   (use "git reset HEAD <file>..." to unstage)
#
#	modified:   file1
#	modified:   file2
#	modified:   file3
#
------------------------------------------------

Se você precisar fazer qualquer outro ajuste, faça-o agora, e, então,
adicione qualquer conteúdo modificado ao índice. Finalmente, grave suas
mudanças com:

------------------------------------------------
$ git commit
------------------------------------------------

Ao executar esse comando, ele irá te pedir uma mensagem descrevendo a mudança,
e, então, irá gravar a nova versão do projeto.

Alternativamente, ao invés de executar 'git-add' antes, você pode usar

------------------------------------------------
$ git commit -a
------------------------------------------------

o que irá automaticamente notar quaisquer arquivos modificados (mas não
novos), adicioná-los ao índices, e gravar, tudo em um único passo.

Uma nota em mensagens de commit: Apesar de não ser exigido, é uma boa
idéia começar a mensagem com uma simples e curta (menos de 50
caracteres) linha sumarizando a mudança, seguida de uma linha em branco
e, então, uma descrição mais detalhada. Ferramentas que transformam
commits em email, por exemplo, usam a primeira linha no campo de
cabeçalho "Subject:" e o resto no corpo.

Git rastreia conteúdo, não arquivos
----------------------------

Muitos sistemas de controle de revisão provêem um comando `add` que diz
ao sistema para começar a rastrear mudanças em um novo arquivo. O
comando `add` do git faz algo mais simples e mais poderoso: 'git-add' é
usado tanto para arquivos novos e arquivos recentemente modificados, e
em ambos os casos, ele tira o instantâneo dos arquivos dados e armazena
o conteúdo no índice, pronto para inclusão do próximo commit.

Visualizando a história do projeto
-----------------------

Em qualquer ponto você pode visualizar a história das suas mudanças
usando

------------------------------------------------
$ git log
------------------------------------------------

Se você também quiser ver a diferença completa a cada passo, use

------------------------------------------------
$ git log -p
------------------------------------------------

Geralmente, uma visão geral da mudança é útil para ter a sensação de
cada passo

------------------------------------------------
$ git log --stat --summary
------------------------------------------------

Gerenciando "branches"/ramos
-----------------

Um simples repositório git pode manter múltiplos ramos de
desenvolvimento. Para criar um novo ramo chamado "experimental", use

------------------------------------------------
$ git branch experimental
------------------------------------------------

Se você executar agora

------------------------------------------------
$ git branch
------------------------------------------------

{'fraction_non_alphanumeric': 0.32042648709315374, 'fraction_numerical': 0.002084335417668751, 'mean_word_length': 1.3493408662900188, 'pattern_counts': {'":': 0, '<': 9, '<?xml version=': 0, '>': 9, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6941186', 'n_tokens_mistral': 3303, 'n_tokens_neox': 3238, 'n_words': 1378}