updating pt_BR docs

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

1 files changed, 143 insertions, 55 deletions

diff --git a/trunk/doc/README.pt_BR b/trunk/doc/README.pt_BR
index fc03e94..f5d73db 100644
--- a/trunk/doc/README.pt_BR
+++ b/trunk/doc/README.pt_BR
@@ -4,21 +4,16 @@ Simplepkg: gerenciamento de instalações e pacotes
 Autor: Silvio Rhatto <rhatto at riseup.net>
 Licença: GPL
 
-O simplepkg é um sistema de gerenciamento de pacotes que roda sobre o pkgtool. Ele é composto
-por vários scripts que desempenham funções de administração e desenvolvimento de sistemas
-do tipo Slackware, procurando fechar um circuito de produção, envolvendo a construção, a
-instalação de pacotes e até mesmo a instalação do sistema de forma automatizada.
+O simplepkg é um sistema de gerenciamento de sistemas slackware que roda sobre o pkgtool.
+Ele é composto por vários scripts que desempenham funções de administração e desenvolvimento de
+sistemas do tipo Slackware, procurando fechar um circuito de produção, envolvendo a construção,
+a instalação de pacotes e até mesmo a instalação do sistema de forma automatizada.
 
 Do lado do desenvolvedor/a, ele ajuda na criação de SlackBuilds e construção de pacotes.
 Do lado do administrador/a, ele possibilita a instalação automatizada de sistemas, instalação
 de pacotes e a criação de "templates" de instalação -- que contém todos os arquivos de configuração,
 informações de permissões e scripts de pós-instalação de uma dada máquina ou jaula.
 
-Ele trabalha com templates -- listas com pacotes instalados, scripts e arquivos de configuração
--- permitindo criar perfis de instalação que podem ser então usados para instalar o sistema numa
-outra partição, criar um chroot específico ou até trabalhar com o conceito de metapacotes: uma
-lista de pacotes que pode ser instalada e removida com apenas um comando.
-
 Documentação
 ------------
 
@@ -46,13 +41,17 @@ comando instalar o template numa partição. Além do template, você precisa config
 para obter pacotes de um repositório local ou remoto.
 
 Gerenciar instalações e pacotes não é tudo o que o simplepkg faz. Ele pode ser usado até na
-criação de jaula e vservers.
+criação de jaula e vservers, podendo manter toda a configuração das máquinas num repositório
+Subversion.
+
+O simplepkg funciona não apenas com o Slackware mas com qualquer port (oficial ou não) que
+siga minimamente os padrões oficiais.
 
 Arquitetura
 -----------
 
-O simplepkg é um conjunto de scripts escritos com a filosofia KISS em mente. Ele é um sistema muito
-simples, composto pelos seguintes comandos:
+O simplepkg é um conjunto de scripts escritos com a filosofia KISS (Keep It Simple, Stupid) em mente.
+Ele é um sistema muito simples, composto pelos seguintes comandos:
 
    - mkjail: constrói uma jaula/instalação de slackware numa pasta
    - templatepkg: criar ou adiciona pacotes a um template
@@ -61,74 +60,158 @@ simples, composto pelos seguintes comandos:
    - jail-commit: atualiza o template
    - rebuildpkg: reconstrói um pacote a partir de sua entrada no /var/log/packages
    - simplaret: obtém pacotes de repositórios locais ou remotos
-   - createpkg: baixa, compila e empacota software de acordo com http://slack.sarava.org/slackbuilds
+   - createpkg: baixa, compila e empacota software de acordo com scripts presentes num repositório
    - repos: cria e mantém repositórios
    - mkbuild: cria scripts de construção de pacotes
 
 Instalando o simplepkg
 ----------------------
 
-Para baixar o pacote do simplepkg, vá em http://slack.sarava.org/packages/noarch/.
+Para baixar o pacote do simplepkg, vá em http://slack.sarava.org/packages/noarch/. Depois, basta usar
+o comando
 
   installpkg simplepkg-VERSAO-noarch-BUILD.tgz
 
+Usando o simplepkg
+------------------
+
+As três principais aplicações desse conjunto são:
+
+  - Gerenciamento de pacotes
+  - Criação e manutenção de jaulas
+  - Criação de pacotes
+
+O gerencamento de pacotes é feito através do simplaret, e por ser algo bem específico está detalhado
+no artigo correspondente. As seções a seguir mostrarão como o simplepkg pode ser utilizado para criar
+e manter jaulas, assim como também criar pacotes.
+
+Criando templates de instalação
+-------------------------------
+
+Originalmente, o simplepkg foi desenvolvido para ajudar na automatização de instalações de sistemas
+slackware. Para isso, ele trabalha com templates -- listas com pacotes instalados, scripts e arquivos
+de configuração -- permitindo criar perfis de instalação que podem ser então usados para instalar o
+sistema numa outra partição ou criar um chroot.
+
+A construção de um template é feita através do programa templatepkg. Para criar um template de nome
+"meu-slackware" contendo a lista de pacotes atualmente instalados no seu sistema, digite
+
+  templatepkg -c meu-slackware
+
+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
+
+Esses três 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.
+
+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
+
+  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
+
+  templatepkg -a meu-slackware /etc/hosts
+
+Isso adicionará o arquivo /etc/hosts no template "meu-slackware". Além de salvar o arquivo e copiá-lo
+automaticamente quando você instalar seu sistema, o simplepkg ainda pode tomar conta de qualquer alteração
+que o /etc/hosts sofrer no sistema, seja mudança no conteúdo do arquivo, dono ou permissão. Se você ainda
+estiver armazenando seus templates num repositório svn (o que veremos a seguir), o simplepkg pode ainda
+manter um histórico completo das alterações do arquivo.
+
+ATENÇÂO: evite ao máximo deixar arquivos contendo senhas ou chaves privadas num template. O lugar mais
+adequado para deixar esse tipo de coisa é num backup seguro.
+
 Criando jaulas e replicando instalações
 ---------------------------------------
 
-  templatepkg meu-slackware
-  mkjail jaula meu-slackware
+Uma vez que um template foi criado com uma lista de pacotes e opcionalmente com arquivos de configuração
+e scripts de pós-instalação (que serão detalhados a seguir), você pode replicar sua instalação de slackware
+utilizando o comando
 
-Isso cria o template meu-slackware a partir da sua lista de pacotes em /var/log/packages e cria uma nova árvore
-com esses pacotes na pasta /vservers/jaula (dependendo de qual o valor da variável JAIL_ROOT do simplepkg.conf, é claro).
+  mkjail jaula meu-slackware
 
-Se você quiser que alguns arquivos de configuração e executar scripts após a instalação dessa jaula, basta colocarmos na
-pasta /etc/simplepkg/meu-slackware.d/ os arquivos de configuração (dentro da hierarquia de pastas do sistema, isto é,
-/etc/simplepkg/meu-slackware.d/etc/apache/httpd.conf) e os script em /etc/simplepkg/meu-slackware.s/. O template vserver,
-que já vem no mkjail contém um exemplo de script.
+Isso cria uma nova árvore do slackware em /vserver/jaula contendo todos os pacotes e arquivos de configuração
+do template "meu-slackware". A instalação dos pacotes será feita pelo aplicativo simplaret, que deve estar
+configurado corretamente e cuja configuração padrão deve funcionar para a maioria dos casos.
 
-Você pode especificar também destinos alternativos para sua jaula, através de um comando do tipo
+Se você quiser instalar essa jaula em outro local que não seja a pasta /vservers (esse local padrão pode ser
+mudado pelo arquivo de configuração do simplepkg), basta usar um comando do tipo
 
   ROOT=/mnt mkjail hda2 meu-slackware
 
-O comando acima faz exatamente o que você está pensando: replica sua instalação slackware em /mnt/hda2, dispensando
-totalmente o programa de instalação do slackware!
+O comando acima faz exatamente o que você está pensando: replica sua instalação slackware em /mnt/hda2,
+dispensando totalmente o programa de instalação do slackware!
 
-Caso nenhum template for especificado, o mkjail utiliza o template /etc/simplepkg/default.template.
+Caso nenhum template for especificado, o mkjail utiliza o template /etc/simplepkg/default. O simplepkg já vem
+com alguns templates padrões, presentes em /etc/simplepkg/defaults/template.
 
-Se você manter uma jaula em JAIL_ROOT com o mesmo nome que um template, é possível ainda usar o script jail-update
-para copiar todas as alterações de arquivos da jaula na pasta de arquivos do seu template (/etc/simplepkg/nome-da-jaula.d).
-Assim, basta que você copie todos os arquivos de configuração que você editou para essa pasta e deixar o jail-update numa
-crontab para que você tenha sempre um template atualizado e baseado nas jaulas / instalações que você tem rodando e que
-estiverem listadas no arquivo /etc/simplepkg/jailist:
+Scripts de pós-instalação
+-------------------------
 
-  jail-update
- 
-Para adicionar ou remover pacotes de um template, basta editar o arquivo de template. Uma outra forma de adicionar
-arquivos é usando o templatepkg com a opção -a, que adiciona apenas novos pacotes ao template. Se você quiser que o
-templatepkg crie um template a partir de uma jaula, simplesmente use
+  templatepkg -b nome-do-script.sh
 
-  templatepkg jaula /vservers/jaula
- 
-Upgrade de jaulas
------------------
+Listando o conteúdo de um template
+----------------------------------
+
+  templatepkg -l
 
-O upgrade de jaulas que estejam em JAIL_ROOT pode ser efetuado com o comando jail-upgrade. Simplesmente coloque
-os patches em PATCHES_DIR e dê o comando
+Removendo arquivos de um template
+---------------------------------
 
-  jail-upgrade
+  templatepkg -d
 
-Se você quiser atualizar apenas uma das jaulas que estão em JAIL_ROOT, use
+Apagando um template
+--------------------
 
-  jail-upgrade nome-da-jaula
- 
-Para especificar uma pasta contendo patches diferente de PATCHES_DIR (útil quando você possui jaulas com
-diferentes versões do slackware), simplesmente use
+  templatepkg -r
 
-  PATCHES=/local/dos/patches jail-upgrade nome-da-jaula
- 
-De modo análogo ao mkjail, é possível indicar ao jail-upgrade uma outra pasta onde a jaula está armazenada:
+Atualizando um template
+-----------------------
+
+  jail-commit
+
+Para atualizar apenas a lista de pacotes de um template, use
+
+  templatepkg -u meu-template
+
+Editando manualmente a lista de pacotes
+---------------------------------------
 
-  ROOT=/otherroot jail-upgrade
+  templatepkg -e nome-do-template
+
+Restaurando arquivos de configuração numa jaula
+-----------------------------------------------
+
+  jail-update
+
+Armazenando as configurações no repositório Subversion
+------------------------------------------------------
+
+  svnadmin create /var/svn/simplepkg --fs-type fsfs
+  templatepkg -e file:///var/svn/simplepkg
+
+  jail-commit
+  jail-commit --all
+  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.
 
 Arquiteturas e versões diferentes
 ---------------------------------
@@ -159,9 +242,14 @@ da arquitetura e versão da mesma, usando para isso o simplaret (veja a documenta
 Desse modo, mesmo que você tenha jaulas de versões e arquiteturas diversas, usar o comando "jail-upgrade"
 faz a atualização sem problemas, desde que seus patches estejam organizados por arquitetura e versão,
 conforme é detalhado na documentação do simplaret, em http://slack.sarava.org/node/16.
+
+Criando um pacote de um template
+--------------------------------
+
+  templatepkg -p nome-do-template
  
-Aplicativos auxiliares: rebuildpkg e createpkg
-----------------------------------------------
+Aplicativos auxiliares: rebuildpkg, createpkg, lspkg e repos
+------------------------------------------------------------
 
 O simplepkg acompanha ainda um aplicativo auxiliar que ajuda a recuperar pacotes instalados cujo tgz original
 foi perdido. O comando rebuildpkg reconstrói um pacote a partir de uma entrada no /var/log/packages. O comando
@@ -179,7 +267,7 @@ http://slack.sarava.org/slackbuilds, basta utilizar o createpkg:
 Parâmetros de configuração
 --------------------------
 
-A escrever...
+  /etc/simplepkg/simplepkg.conf
 
 Fonte
 -----