diff --git a/cap08/cap08_dt.Rmd b/cap08/cap08_dt.Rmd index 93611419eef8807d0793f61abb6a4877bff40a0e..aaa0de262f2e2b44f1abb955684381e269ff66ca 100644 --- a/cap08/cap08_dt.Rmd +++ b/cap08/cap08_dt.Rmd @@ -12,10 +12,14 @@ header-includes: Dicionário de Termos ==================== +\begin{center} + \textbf{\Huge{A}} +\end{center} + \noindent \textbf{\large{Add}} \begin{quotation} -\noindent adiciona (envia) os arquivos para a stagin area, para que +\noindent Adiciona (envia) os arquivos para a stagin area, para que possa ser marcado no tempo por um commit. \end{quotation} @@ -25,10 +29,15 @@ possa ser marcado no tempo por um commit. git add * ``` +\begin{center} + \textbf{\Huge{B}} +\end{center} + + \noindent \textbf{\large{Bisect}} \begin{quotation} -\noindent realiza uma pesquisa binária (binary search) a procura de +\noindent Realiza uma pesquisa binária (binary search) a procura de erros. Para que a pesquisa ocorra, é necessário um ponto no tempo em que o código esteja funcionando e outro que não esteja. \end{quotation} @@ -47,7 +56,7 @@ git bisect good commit1 \noindent \textbf{\large{Blame}} \begin{quotation} -\noindent é usado para pesquisar qual `commit` modificou determinado arquivo, +\noindent É usado para pesquisar qual `commit` modificou determinado arquivo, com o objetivo de encontrar quem e quando um erro foi inserido. Esse método também é chamado de anotação de arquivo. \end{quotation} @@ -61,7 +70,7 @@ git blame teste.tex \noindent \textbf{\large{Branch}} \begin{quotation} -\noindent é como uma cópia dos arquivos do ultimo commit +\noindent É como uma cópia dos arquivos do ultimo commit para um ambiente de desenvolvimento paralelo, o que permite que as modificações em um `branch` não afete os arquivos em outro. Os branchs também são chamados de ramos de desenvolvimento. Veja com mais @@ -74,10 +83,14 @@ detalhes no capitulos dos worksflows. git branch novoBranch ``` +\begin{center} + \textbf{\Huge{C}} +\end{center} + \noindent \textbf{\large{Checkout}} \begin{quotation} -\noindent serve para transitar entre branchs e commits. +\noindent Serve para transitar entre branchs e commits. Usando o checkout é possível voltar a commits anteriores. \end{quotation} @@ -90,7 +103,7 @@ git checkout teste \noindent \textbf{\large{Clone}} \begin{quotation} -\noindent é usado quando deseja-se clonar um repositório que está +\noindent É usado quando deseja-se clonar um repositório que está disponível em um servidor remoto para o servidor local. Depois da clonagem, estará disponível todos os arquivos e todo o histórico de controle de versões sem a necessidade de uso da internet. @@ -112,7 +125,7 @@ git remote \noindent \textbf{\large{Commit}} \begin{quotation} -\noindent marca os arquivos da stagin area como uma versão definitiva, +\noindent Marca os arquivos da stagin area como uma versão definitiva, para que posteriormente, caso algum erro ocorra, possamos voltar nos commits anteriores onde o código está em pleno funcionamento. \end{quotation} @@ -126,7 +139,7 @@ git commit -m "Meu primeiro commit" \begin{quotation} -\noindent é um comando usado para ajustar as configurações padrão do git. +\noindent É um comando usado para ajustar as configurações padrão do git. Há duas configurações básicas a serem feitas: a inclusão do e-mail e do nome do usuário Git. Todas as configurações definidas como globais ficam armazenadas em um @@ -142,10 +155,14 @@ git config --global user.name "Ezio Auditore" git config --global user.email ezio.auditore@exemple.com ``` +\begin{center} + \textbf{\Huge{F}} +\end{center} + \noindent \textbf{\large{Fetch}} \begin{quotation} -\noindent atualiza o repositório local com as alterações do remoto, porém +\noindent Atualiza o repositório local com as alterações do remoto, porém não realiza o merge dos arquivos, deixando isso para ser feito manualmente. \end{quotation} @@ -155,10 +172,14 @@ não realiza o merge dos arquivos, deixando isso para ser feito manualmente. git fetch origin ``` +\begin{center} + \textbf{\Huge{H}} +\end{center} + \noindent \textbf{\large{HEAD}} \begin{quotation} -\noindent é um arquivo que contém um apontador para o `branch` atual. +\noindent É um arquivo que contém um apontador para o `branch` atual. Quando o `checkout` é executado para a mudança do `branch`, esse arquivo é automaticamente modificado, apontando agora para o novo local, e assim permitindo que, quando o computador for desligado e @@ -168,8 +189,8 @@ depois de reniciado o Git ainda esteja trabalhando com o mesmo `branch`. \noindent \textbf{\large{Help}} \begin{quotation} -\noindent é a ajuda do git. Todo comando Git tem um manual de ajuda que pode ser exibido na tela -com o comando `--help`. +\noindent É a ajuda do git. Todo comando Git tem um manual de ajuda que pode +ser exibido na telacom o comando `--help`. \end{quotation} **Exemplo:** @@ -178,11 +199,14 @@ com o comando `--help`. git status --help ``` +\begin{center} + \textbf{\Huge{M}} +\end{center} \noindent \textbf{\large{Merge}} \begin{quotation} -\noindent faz a fusão de dois ramos em um. +\noindent Faz a fusão de dois ramos em um. Quando se trabalha em ramos diferentes (diferentes branchs) e precisa-se posteriormente juntar o trabalho, o `merge` (fundir) é usado, @@ -202,7 +226,7 @@ git merge novoBranch \noindent \textbf{\large{Mv}} \begin{quotation} -\noindent é usado para mover ou renomeiar arquivos. +\noindent É usado para mover ou renomeiar arquivos. Caso a mudança seja feita sem o `git mv`, o Git entende que o arquivo foi deletado e que um novo arquivo foi criado, deixando de fora, @@ -215,11 +239,14 @@ por exemplo, a ligação existente entre o arquivo e seus commits. git mv teste.tex arquivo1.tex ``` +\begin{center} + \textbf{\Huge{P}} +\end{center} \noindent \textbf{\large{Pull}} \begin{quotation} -\noindent é semelhante ao comando `fetch`, porém, puxa os +\noindent É semelhante ao comando `fetch`, porém, puxa os arquivos do servidor remoto fazendo merge. Caso haja algum conflito de merge, estes deverão ser resolvidos manualmente. \end{quotation} @@ -234,7 +261,7 @@ git pull origin \noindent \textbf{\large{Push}} \begin{quotation} -\noindent é usado para "empurrar" os arquivos do repositório local +\noindent É usado para "empurrar" os arquivos do repositório local para o servidor remoto. \end{quotation} @@ -244,11 +271,14 @@ para o servidor remoto. git push origin master ``` +\begin{center} + \textbf{\Huge{R}} +\end{center} \noindent \textbf{\large{Rebase}} \begin{quotation} -\noindent é usado para modificar `commits` antigos. Ele refaz a árvore +\noindent É usado para modificar `commits` antigos. Ele refaz a árvore de `commits`, sendo assim não é uma boa ideia fazer um `push` da alteração, pois modificará a árvore do servidor afetando todos os desenvolvedores. @@ -267,7 +297,7 @@ git rebase teste \noindent \textbf{\large{Rm}} \begin{quotation} -\noindent de forma mais prática, serve para remover um arquivo deixando +\noindent De forma mais prática, serve para remover um arquivo deixando de ser gerenciado pelo Git e seja excluído do disco rígido. Também é possível que o arquivo deixe de ser gerenciado e permaneça no disco. @@ -288,7 +318,7 @@ git rm --cached teste.tex \noindent \textbf{\large{Remote}} \begin{quotation} -\noindent é servidor remoto onde os arquivos Git estão hospedados. +\noindent É o servidor remoto onde os arquivos Git estão hospedados. O remote padrão geralmente é criado com o nome de `origin`, mas é possível adicioná-lo utilizando outros nomes e até mesmo adicionar outros servidores remotos juntamente ao `origin`. \end{quotation} @@ -302,7 +332,7 @@ git remote add origin "git@gitlab.c3sl.ufpr.br:pet-estatistica/apostila-git.git" \noindent \textbf{\large{Repositório}} \begin{quotation} -\noindent é uma pasta gerenciada pelo git. A partir +\noindent É uma pasta gerenciada pelo git. A partir da criação desta, usufruimos dos sistema de versionamento, sendo possível transitar entre as diferentes versões a medida que necessário. \end{quotation} @@ -328,10 +358,14 @@ ao estado de não commitado (--soft). git reset --hard HEAD~1 ``` +\begin{center} + \textbf{\Huge{S}} +\end{center} + \noindent \textbf{\large{SSH Key}} \begin{quotation} -\noindent é uma chave de autenticação baseada em criptografia de chave pública +\noindent É uma chave de autenticação baseada em criptografia de chave pública (chave assimétrica). Essa criptografia torna o processo de transferência de arquivos entre o cliente e o servidor mais segura. @@ -350,7 +384,7 @@ ssh-keygen \noindent \textbf{\large{Stagin Area}} \begin{quotation} -\noindent é um espaço temporário na pasta gerenciada pelo Git. É +\noindent É um espaço temporário na pasta gerenciada pelo Git. É o local em que ficam os arquivos antes de serem marcados como uma versão definitiva. Em tradução livre, stagin area é área de estágio, podemos assim imaginar que o arquivo está estagiando antes de ser promovido a um @@ -360,7 +394,7 @@ arquivo definitivo. \noindent \textbf{\large{Stash}} \begin{quotation} -\noindent é um comando usado para não ser necessário fazer um `commit` +\noindent É um comando usado para não ser necessário fazer um `commit` para mudar de `branch`. Ao executá-lo, os arquivos modificados ficam salvos em uma pilha de modificações inacabadas, sendo possível transitar entre @@ -378,7 +412,7 @@ git stash list \noindent \textbf{\large{Status}} \begin{quotation} -\noindent exibe a diferença entre o estado atual dos arquivos e o estado +\noindent Exibe a diferença entre o estado atual dos arquivos e o estado do último `commit` do mesmo `branch`. São três estados possíveis: consolidado (committed), modificado (modified) e preparado (staged). \end{quotation} @@ -389,10 +423,14 @@ consolidado (committed), modificado (modified) e preparado (staged). git status ``` +\begin{center} + \textbf{\Huge{T}} +\end{center} + \noindent \textbf{\large{Tag}} \begin{quotation} -\noindent é usada para marcar pontos específicos do desenvolvimento. +\noindent É usada para marcar pontos específicos do desenvolvimento. Geralmente tags são usadas para marcar versões definitivas, como a v1.0, v2.0 e assim por diante. diff --git a/cap08/cap08_dt.pdf b/cap08/cap08_dt.pdf index c581c875537cad4b9cd58b65cd18c33cb7e3e4ca..fe913cb251207ea6c8d8e63c715783fa6e97e37d 100644 Binary files a/cap08/cap08_dt.pdf and b/cap08/cap08_dt.pdf differ diff --git a/cap08/cap08_dt.tex b/cap08/cap08_dt.tex index 48dd01cedc140bcf53acf2c5ba1f4aecfbdb37e9..404a5298fcd43749793a2db4a4df6e7ead30ade4 100644 --- a/cap08/cap08_dt.tex +++ b/cap08/cap08_dt.tex @@ -102,10 +102,14 @@ \section{Dicionário de Termos}\label{dicionario-de-termos} +\begin{center} + \textbf{\Huge{A}} +\end{center} + \noindent \textbf{\large{Add}} \begin{quotation} -\noindent adiciona (envia) os arquivos para a stagin area, para que +\noindent Adiciona (envia) os arquivos para a stagin area, para que possa ser marcado no tempo por um commit. \end{quotation} @@ -118,10 +122,14 @@ possa ser marcado no tempo por um commit. \end{Highlighting} \end{Shaded} +\begin{center} + \textbf{\Huge{B}} +\end{center} + \noindent \textbf{\large{Bisect}} \begin{quotation} -\noindent realiza uma pesquisa binária (binary search) a procura de +\noindent Realiza uma pesquisa binária (binary search) a procura de erros. Para que a pesquisa ocorra, é necessário um ponto no tempo em que o código esteja funcionando e outro que não esteja. \end{quotation} @@ -143,7 +151,7 @@ o código esteja funcionando e outro que não esteja. \noindent \textbf{\large{Blame}} \begin{quotation} -\noindent é usado para pesquisar qual `commit` modificou determinado arquivo, +\noindent É usado para pesquisar qual `commit` modificou determinado arquivo, com o objetivo de encontrar quem e quando um erro foi inserido. Esse método também é chamado de anotação de arquivo. \end{quotation} @@ -160,7 +168,7 @@ Esse método também é chamado de anotação de arquivo. \noindent \textbf{\large{Branch}} \begin{quotation} -\noindent é como uma cópia dos arquivos do ultimo commit +\noindent É como uma cópia dos arquivos do ultimo commit para um ambiente de desenvolvimento paralelo, o que permite que as modificações em um `branch` não afete os arquivos em outro. Os branchs também são chamados de ramos de desenvolvimento. Veja com mais @@ -176,10 +184,14 @@ detalhes no capitulos dos worksflows. \end{Highlighting} \end{Shaded} +\begin{center} + \textbf{\Huge{C}} +\end{center} + \noindent \textbf{\large{Checkout}} \begin{quotation} -\noindent serve para transitar entre branchs e commits. +\noindent Serve para transitar entre branchs e commits. Usando o checkout é possível voltar a commits anteriores. \end{quotation} @@ -195,7 +207,7 @@ Usando o checkout é possível voltar a commits anteriores. \noindent \textbf{\large{Clone}} \begin{quotation} -\noindent é usado quando deseja-se clonar um repositório que está +\noindent É usado quando deseja-se clonar um repositório que está disponível em um servidor remoto para o servidor local. Depois da clonagem, estará disponível todos os arquivos e todo o histórico de controle de versões sem a necessidade de uso da internet. @@ -219,7 +231,7 @@ histórico de controle de versões sem a necessidade de uso da internet. \noindent \textbf{\large{Commit}} \begin{quotation} -\noindent marca os arquivos da stagin area como uma versão definitiva, +\noindent Marca os arquivos da stagin area como uma versão definitiva, para que posteriormente, caso algum erro ocorra, possamos voltar nos commits anteriores onde o código está em pleno funcionamento. \end{quotation} @@ -236,7 +248,7 @@ commits anteriores onde o código está em pleno funcionamento. \begin{quotation} -\noindent é um comando usado para ajustar as configurações padrão do git. +\noindent É um comando usado para ajustar as configurações padrão do git. Há duas configurações básicas a serem feitas: a inclusão do e-mail e do nome do usuário Git. Todas as configurações definidas como globais ficam armazenadas em um @@ -255,10 +267,14 @@ do usuário. \end{Highlighting} \end{Shaded} +\begin{center} + \textbf{\Huge{F}} +\end{center} + \noindent \textbf{\large{Fetch}} \begin{quotation} -\noindent atualiza o repositório local com as alterações do remoto, porém +\noindent Atualiza o repositório local com as alterações do remoto, porém não realiza o merge dos arquivos, deixando isso para ser feito manualmente. \end{quotation} @@ -271,10 +287,14 @@ não realiza o merge dos arquivos, deixando isso para ser feito manualmente. \end{Highlighting} \end{Shaded} +\begin{center} + \textbf{\Huge{H}} +\end{center} + \noindent \textbf{\large{HEAD}} \begin{quotation} -\noindent é um arquivo que contém um apontador para o `branch` atual. +\noindent É um arquivo que contém um apontador para o `branch` atual. Quando o `checkout` é executado para a mudança do `branch`, esse arquivo é automaticamente modificado, apontando agora para o novo local, e assim permitindo que, quando o computador for desligado e @@ -284,8 +304,8 @@ depois de reniciado o Git ainda esteja trabalhando com o mesmo `branch`. \noindent \textbf{\large{Help}} \begin{quotation} -\noindent é a ajuda do git. Todo comando Git tem um manual de ajuda que pode ser exibido na tela -com o comando `--help`. +\noindent É a ajuda do git. Todo comando Git tem um manual de ajuda que pode +ser exibido na telacom o comando `--help`. \end{quotation} \textbf{Exemplo:} @@ -297,10 +317,14 @@ com o comando `--help`. \end{Highlighting} \end{Shaded} +\begin{center} + \textbf{\Huge{M}} +\end{center} + \noindent \textbf{\large{Merge}} \begin{quotation} -\noindent faz a fusão de dois ramos em um. +\noindent Faz a fusão de dois ramos em um. Quando se trabalha em ramos diferentes (diferentes branchs) e precisa-se posteriormente juntar o trabalho, o `merge` (fundir) é usado, @@ -323,7 +347,7 @@ gerente de projetos decidir que parte do código deve permanecer. \noindent \textbf{\large{Mv}} \begin{quotation} -\noindent é usado para mover ou renomeiar arquivos. +\noindent É usado para mover ou renomeiar arquivos. Caso a mudança seja feita sem o `git mv`, o Git entende que o arquivo foi deletado e que um novo arquivo foi criado, deixando de fora, @@ -339,10 +363,14 @@ por exemplo, a ligação existente entre o arquivo e seus commits. \end{Highlighting} \end{Shaded} +\begin{center} + \textbf{\Huge{P}} +\end{center} + \noindent \textbf{\large{Pull}} \begin{quotation} -\noindent é semelhante ao comando `fetch`, porém, puxa os +\noindent É semelhante ao comando `fetch`, porém, puxa os arquivos do servidor remoto fazendo merge. Caso haja algum conflito de merge, estes deverão ser resolvidos manualmente. \end{quotation} @@ -359,7 +387,7 @@ merge, estes deverão ser resolvidos manualmente. \noindent \textbf{\large{Push}} \begin{quotation} -\noindent é usado para "empurrar" os arquivos do repositório local +\noindent É usado para "empurrar" os arquivos do repositório local para o servidor remoto. \end{quotation} @@ -372,10 +400,14 @@ para o servidor remoto. \end{Highlighting} \end{Shaded} +\begin{center} + \textbf{\Huge{R}} +\end{center} + \noindent \textbf{\large{Rebase}} \begin{quotation} -\noindent é usado para modificar `commits` antigos. Ele refaz a árvore +\noindent É usado para modificar `commits` antigos. Ele refaz a árvore de `commits`, sendo assim não é uma boa ideia fazer um `push` da alteração, pois modificará a árvore do servidor afetando todos os desenvolvedores. @@ -397,7 +429,7 @@ fluxo de trabalho linear. \noindent \textbf{\large{Rm}} \begin{quotation} -\noindent de forma mais prática, serve para remover um arquivo deixando +\noindent De forma mais prática, serve para remover um arquivo deixando de ser gerenciado pelo Git e seja excluído do disco rígido. Também é possível que o arquivo deixe de ser gerenciado e permaneça no disco. @@ -421,7 +453,7 @@ commitada. \noindent \textbf{\large{Remote}} \begin{quotation} -\noindent é servidor remoto onde os arquivos Git estão hospedados. +\noindent É o servidor remoto onde os arquivos Git estão hospedados. O remote padrão geralmente é criado com o nome de `origin`, mas é possível adicioná-lo utilizando outros nomes e até mesmo adicionar outros servidores remotos juntamente ao `origin`. \end{quotation} @@ -438,7 +470,7 @@ remotos juntamente ao `origin`. \noindent \textbf{\large{Repositório}} \begin{quotation} -\noindent é uma pasta gerenciada pelo git. A partir +\noindent É uma pasta gerenciada pelo git. A partir da criação desta, usufruimos dos sistema de versionamento, sendo possível transitar entre as diferentes versões a medida que necessário. \end{quotation} @@ -470,10 +502,14 @@ ao estado de não commitado (--soft). \end{Highlighting} \end{Shaded} +\begin{center} + \textbf{\Huge{S}} +\end{center} + \noindent \textbf{\large{SSH Key}} \begin{quotation} -\noindent é uma chave de autenticação baseada em criptografia de chave pública +\noindent É uma chave de autenticação baseada em criptografia de chave pública (chave assimétrica). Essa criptografia torna o processo de transferência de arquivos entre o cliente e o servidor mais segura. @@ -495,7 +531,7 @@ caso contrário, é exibido um erro e a conexão é interrompida. \noindent \textbf{\large{Stagin Area}} \begin{quotation} -\noindent é um espaço temporário na pasta gerenciada pelo Git. É +\noindent É um espaço temporário na pasta gerenciada pelo Git. É o local em que ficam os arquivos antes de serem marcados como uma versão definitiva. Em tradução livre, stagin area é área de estágio, podemos assim imaginar que o arquivo está estagiando antes de ser promovido a um @@ -505,7 +541,7 @@ arquivo definitivo. \noindent \textbf{\large{Stash}} \begin{quotation} -\noindent é um comando usado para não ser necessário fazer um `commit` +\noindent É um comando usado para não ser necessário fazer um `commit` para mudar de `branch`. Ao executá-lo, os arquivos modificados ficam salvos em uma pilha de modificações inacabadas, sendo possível transitar entre @@ -526,7 +562,7 @@ pilha de modificações inacabadas, sendo possível transitar entre \noindent \textbf{\large{Status}} \begin{quotation} -\noindent exibe a diferença entre o estado atual dos arquivos e o estado +\noindent Exibe a diferença entre o estado atual dos arquivos e o estado do último `commit` do mesmo `branch`. São três estados possíveis: consolidado (committed), modificado (modified) e preparado (staged). \end{quotation} @@ -540,10 +576,14 @@ consolidado (committed), modificado (modified) e preparado (staged). \end{Highlighting} \end{Shaded} +\begin{center} + \textbf{\Huge{T}} +\end{center} + \noindent \textbf{\large{Tag}} \begin{quotation} -\noindent é usada para marcar pontos específicos do desenvolvimento. +\noindent É usada para marcar pontos específicos do desenvolvimento. Geralmente tags são usadas para marcar versões definitivas, como a v1.0, v2.0 e assim por diante.