updating pt_BR docs

git-svn-id: svn+slack://slack.fluxo.info/var/svn/simplepkg@372 04377dda-e619-0410-9926-eae83683ac58

1 files changed, 105 insertions, 21 deletions

diff --git a/trunk/doc/README.pt_BR b/trunk/doc/README.pt_BR
index f5d73db..f6f48a3 100644
--- a/trunk/doc/README.pt_BR
+++ b/trunk/doc/README.pt_BR
@@ -101,15 +101,17 @@ A construção de um template é feita através do programa templatepkg. Para criar
 A opção -c (ou --create) criará a pasta /etc/simplepkg/templates/meu-slackware, que conterá os
 seguintes componentes:
 
-  - /etc/simplepkg/templates/meu-slackware/meu-slackware.template: lista de pacotes
   - /etc/simplepkg/templates/meu-slackware/meu-slackware.d: cópia de arquivos de configuração
   - /etc/simplepkg/templates/meu-slackware/meu-slackware.s: scripts de pós-instalação
+  - /etc/simplepkg/templates/meu-slackware/meu-slackware.perms: informações sobre arquivos
+  - /etc/simplepkg/templates/meu-slackware/meu-slackware.template: lista de pacotes
 
-Esses três componentes são suficientes para armazenar todas as características de uma instalação
+Esses quatro componentes são suficientes para armazenar todas as características de uma instalação
 de slackware: a lista de pacotes controla o software instalado (a partir do conteúdo da pasta
 /var/log/packages), a cópia dos arquivos de configuração controla as personalizações feitas para o uso
 dos aplicativos e os scripts de pós-instalação cuidam de qualquer rotina que precisa ser realizada
-exatamente após a instalação do sistema.
+exatamente após a instalação do sistema. Já o arquivo de informações sobre arquivos contém as permissões,
+o dono/a e grupo de cada arquivo de configuração presente no template.
 
 Se você quiser criar um template a partir de uma instalação de slackware presente numa outra partição
 do sistema que não seja a raíz, basta usar um comando do tipo
@@ -117,8 +119,13 @@ do sistema que não seja a raíz, basta usar um comando do tipo
   templatepkg -c meu-slackware /mnt/slackware
 
 onde /mnt/slackware é o local onde o sistema alternativo está instalado. Após criado, o template possuirá
-apenas a lista de pacotes contendo o nome dos aplicativos instalados no seu sistema. Para adicionar um
-arquivo de configuração, basta dar um comando como
+apenas a lista de pacotes contendo o nome dos aplicativos instalados no seu sistema. Como a pasta
+/var/log/packages não preserva a ordem de instalação dos pacotes, então talvez você queira editar manualmente
+a lista de pacotes de um template. Para isso, use o comando
+
+  templatepkg -e meu-slackware
+
+Para adicionar um arquivo de configuração no seu novo template, basta dar um comando como
 
   templatepkg -a meu-slackware /etc/hosts
 
@@ -158,60 +165,131 @@ com alguns templates padrões, presentes em /etc/simplepkg/defaults/template.
 Scripts de pós-instalação
 -------------------------
 
-  templatepkg -b nome-do-script.sh
+Opcionalmente, é possível manter scripts de pós-instalação num template. Tais script são executados exatamente
+após a instalação de uma jaula e cópia de arquivos de configuração pelo mkjail. Para criar ou editar um script
+de pós-instalação, use um comando como
+
+  templatepkg -b meu-slackware nome-do-script.sh
+
+Isso adicionará o script nome-do-script.sh no template "meu-slackware". O mkjail passa dois argumentos para
+cada script de pós-instalação: a pasta superior e o nome da jaula ("/mnt" e "hda2" no nosso exemplo anterior).
+Assim, um exemplo de script seria algo como
+
+  #!/bin/bash
+  chroot $1/$2/ sbin/ldconfig
 
 Listando o conteúdo de um template
 ----------------------------------
 
+Para listar os templates disponíveis ou o conteúdo de um template, use comandos como
+
   templatepkg -l
+  templatepkg -l meu-slackware
 
 Removendo arquivos de um template
 ---------------------------------
 
-  templatepkg -d
+Analogamente à forma como se adicona arquivos num template, removê-los pode ser feito com o seguinte comando:
+
+  templatepkg -d meu-slackware /etc/hosts
+
+Isso remove o arquivo /etc/hosts do template "meu-slackware".
 
 Apagando um template
 --------------------
 
-  templatepkg -r
+Para apagar um template, basta utilizar um comando como
+
+  templatepkg -r meu-slackware
 
 Atualizando um template
 -----------------------
 
-  jail-commit
+Agora que já abordamos as opções do templatepkg, é hora de visitarmos um outro aplicativo, desta vez utilizado
+para manter um template atualizado. O jail-commit é um script que copia as alterações dos arquivos (conteúdo,
+propriedade e permissões) de um template a partir do conteúdo de uma jaula ou instalação.
+
+Por exemplo, caso se queira copiar as alterações da jaula /mnt/hda2 no template "meu-slackware", basta usar o
+comando
+
+  jail-commit /mnt/hda2 meu-slackware
 
-Para atualizar apenas a lista de pacotes de um template, use
+Além da lista de pacotes do template "meu-slackware" ser atualizada de acordo com a lista de pacotes presente
+em /mnt/hda2/var/log/packages, todos os arquivos de configuração presentes no template "meu-slackware" serão
+comparados com os correspondentes da pasta /mnt/hda2 e as diferenças são copiadas para o template. Da mesma
+forma, as permissões e informação de dono/grupo dos arquivos também é atualizada no template.
+
+O comando jail-commit possibilita que um template sempre esteja atualizado e refletindo a configuração atual
+de uma instalação de slackware. Se você quiser atualizar apenas a lista de pacotes de um template, porém, use
 
   templatepkg -u meu-template
 
-Editando manualmente a lista de pacotes
----------------------------------------
+Para facilitar ainda mais o controle das alterações do sistema, existe ainda uma facilidade do arquivo
+/etc/simplepkg/jailist. Esse arquivo serve, além de outros propósitos descritos na documentação do simplaret,
+para que o jail-commit saiba de antemão quais são as instalações de sistema do tipo Slackware presentes numa
+máquina, além da instalação principal na raíz do sistema.
+
+Suponha que uma máquina possua duas instalações de slackware, além da principal (raíz):
+
+  - /mnt/slackware-1 usando o template "slackware-1"
+  - /mnt/slackware-2 usando o template "slackware-2"
 
-  templatepkg -e nome-do-template
+Se o arquivo /etc/simplepkg/jailist contiver as seguintes linhas,
+
+  /mnt/slackware-1
+  /mnt/slackware-2
+
+então o comando
+
+  jail-commit
+
+atualizará o template "slackware-1" de acordo com o conteúdo da jaula /mnt/slackware-1 e o template "slackware-2"
+com o conteúdo da jaula /mnt/slackware-2. Se, além desses dois templates, existir um outro de nome "main", então
+o jail-commit sem argumentos também copiará as atualizações da instalação raíz, deixando-as no template "main".
+
+Você pode inclusive colocar uma entrada no crontab do tipo
+
+  20 4 * * * jail-commit
+
+para que seus templates sejam atualizados diariamente. Se você ainda possui o envio de emails configurado na sua
+máquina, então a saída do jail-commit será enviada pelo cron diariamente para seu email, contendo diffs das alterações
+de arquivos de configuração a lista de pacotes adicionados ou removidos no sistema.
 
 Restaurando arquivos de configuração numa jaula
 -----------------------------------------------
 
-  jail-update
+A operação contrária ao que o jail-commit faz também é possível: suponha que você mexeu na configuração do sistema
+mas se arrependeu das alterações e deseja voltar a configuração para o modo como ela se encontra no seu template,
+basta usar o comando
+
+  jail-update /mnt/hda2 meu-slackware
 
 Armazenando as configurações no repositório Subversion
 ------------------------------------------------------
 
+Para aumentar ainda mais a flexibilidade e o controle do conteúdo dos templates, é possível armazená-los num
+repositório Subversion. Para isso, edite o arquivo /etc/simplepkg/simplepkg.conf e deixe o parâmetro de configuração
+TEMPLATES_UNDER_SVN com o valor "yes".
+
+Depois, crie um repositório subversion para armazenar seus templates, usando algo como
+
   svnadmin create /var/svn/simplepkg --fs-type fsfs
+
+Com o repositório criado, basta importar seus templates com o comando
+
   templatepkg -e file:///var/svn/simplepkg
 
-  jail-commit
-  jail-commit --all
+A partir daí, o comando jail-commit enviará automaticamente todas as alterações dos templates para o repositório
+subversion. Se, por outro lado, você quiser baixar as alterações dos templates que estão no repositório remoto
+para sua cópia local, use o comando
+
   templatepkg -s
 
 Atualização de jaulas
 ---------------------
 
-Existe ainda uma facilidade para que a obtenção e aplicação de atualizações seja feita de forma única,
-através do arquivo /etc/simplepkg/jailist. Esse arquivo serve, além de outros propósitos descritos na
-documentação do simplepkg, para que o simplaret saiba de antemão quais são as instalações de sistema
-do tipo Slackware presentes numa máquina, além da instalação principal na raíz do sistema. Veja a
-documentação do simplaret para mais detalhes.
+A atualização de jaulas e sistemas instalados é feita através do simplaret e também utiliza o arquivo
+/etc/simplepkg/jailist. Para mais informações a respeito, consulte a documentação do simplaret para mais detalhes.
 
 Arquiteturas e versões diferentes
 ---------------------------------
@@ -246,7 +324,13 @@ conforme é detalhado na documentação do simplaret, em http://slack.sarava.org/no
 Criando um pacote de um template
 --------------------------------
 
+Se, por algum motivo, você quiser construir um pacote com o conteúdo de um template, experimente
+o comando
+
   templatepkg -p nome-do-template
+
+No entanto, o simplepkg foi criado para que esse tipo de comportamento seja evitado, já que é mais
+simples manter templates de configuração do que pacotes contendo a configuração de uma instalação.
  
 Aplicativos auxiliares: rebuildpkg, createpkg, lspkg e repos
 ------------------------------------------------------------