done simplaret pt_BR documentation

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

1 files changed, 62 insertions, 80 deletions

diff --git a/trunk/doc/README.simplaret.pt_BR b/trunk/doc/README.simplaret.pt_BR
index 7bb1186..672eb8e 100644
--- a/trunk/doc/README.simplaret.pt_BR
+++ b/trunk/doc/README.simplaret.pt_BR
@@ -329,100 +329,82 @@ Nesta seção os parâmetros do arquivo de configuração /etc/simplepkg/simplepkg.co
 simplaret estão descritos. Para uma lista completa de todos os parâmetros disponíveis, consulte o
 simplepkg.conf contido no pacote do simplepkg. Aqui estão descritos apenas os principais, que são:
 
-  # Default architecture: set this option if you dont want simplepkg
-  # to use the value from /etc/slackware-version
-  # DEFAULT_ARCH="i386"
+  - STORAGE: local de armazenameto dos pacotes baixados e das informações de repositório.
+    O valor padrão é /var/simplaret/packages.
   
-  # Default version: set this option if you dont want simplepkg;
-  # to use the value from /etc/slackware-version
-  # DEFAULT_VERSION="11.0"
+  - PATCHES_DIR: local de armazenamento de pacotes que são patches (atualizações), isto é, o
+    local de armazenamento de pacotes de repositórios do tipo PATCHES (e eventualmente de
+    patches encontrados em repositórios do tipo ROOT, como veremos a seguir). O valor padrão
+    é /var/simplaret/patches.
   
-  # Whether mkjail should clean the package cache before installation
-  # to enable it, set to "1" or "yes"
-  SIMPLARET_CLEAN="1"
+  - SIMPLARET_DOWNLOAD_FROM_NEXT_REPO: indica se o simplaret deve tentar baixar um pacote do
+    próximo repositório (caso exista) quando o download do repositório atual tiver falhado.
+    Valores possíveis são "1" ou "yes" para habilitar a opção (que é o comportamento padrão)
+    ou "0" ou "no" para desabilitá-la.
   
-  # whether mkjail should clean the package cache after the installation;
-  # to enable it, set to "1" or "yes"
-  SIMPLARET_DELETE_DOWN="1"
+  - SIMPLARET_PURGE_PATCHES: indica se o conteúdo da pasta de patches também deve ser apagado
+    quando o comando "simplaret --purge" é chamado. Use "yes" ou "1" para habilitar e "no" ou
+    "0" para desabilitar. O valor padrão é "1".
   
-  # Whether mkjail should issue a simplaret --update before install the jail;
-  # to enable it, set to "1" or "yes"
-  SIMPLARET_UPDATE="1"
+  - SIMPLARET_PURGE_WEEKS: controla o número de semanas a partir do qual o simplaret irá apagar
+    pacotes quando chamado com o comando "simplaret --purge", o que é equivalente a usar o
+    comando "simplaret --purge -w N". O valor padrão é "3". Para desabilitar essa opção, atribua
+    o valor "0".
   
-  # Wheter try to download from the next repository on failed download.
-  SIMPLARET_DOWNLOAD_FROM_NEXT_REPO="1"
+  - PASSIVE_FTP: Indica se o simplaret deve fazer as transferências de FTP no modo passivo.
+    O valor padrão é "1" (habilitado).
   
-  # Wheter delete also patches when simplaret --purge is called;
-  # to enable it, set to "1" or "yes"
-  SIMPLARET_PURGE_PATCHES="0"
+  - HTTP_TOOL: especifica qual a ferramenta para obtenção de arquivos via protocolo HTTP.
+    As opções disponíveis são "curl" e "wget", sendo que a opção padrão é "curl".
   
-  # Whether delete each package rigth after its installation;
-  # to enable it, set to "1" or "yes"
-  SIMPLARET_DELETE_DURING="0"
-  
-  # Delete packages older than N weeks from the cache
-  SIMPLARET_PURGE_WEEKS="3"
-  
-  # Where patches are placed
-  PATCHES_DIR="/var/simplaret/patches"
-  
-  # Place to store your packages
-  STORAGE="/var/simplaret/packages"
-  
-  # Whether to use passive ftp transfers;
-  # to enable it, set to "1" or "yes"
-  PASSIVE_FTP="1"
-  
-  # Http retrieval tool;
-  # available parameters are "wget" or "curl"
-  HTTP_TOOL="wget"
-  
-  # Ftp retrieval tool;
-  # available parameters are "wget", "curl" or "ncftpget"
-  FTP_TOOL="wget"
-  
-  # Set connection timeout in seconds
-  CONNECT_TIMEOUT="20"
+  - FTP_TOOL: especifica qual a ferramenta para obtenção de arquivos via protocolo FTP.
+    As opções disponíveis são "curl", "wget" e "ncftpget", sendo que a opção padrão é "curl".
+
+  - CONNECT_TIMEOUT: tempo máximo de espera para uma conexão de rede, dado em segundos.
+    O valor padrão é "20".
   
-  # ROOT repository package priority
-  ROOT_PRIORITY="patches slackware extra testing pasture"
+  - ROOT_PRIORITY: especifica a ordem de prioridades das pastas de repositórios do tipo
+    ROOT numa pesquisa. O valor padrão é "patches slackware extra testing pasture",
+    indicando que a pasta de patches tem precedência sobre todas as outras no repositório,
+    sendo seguida pela pasta slackware e depois pelas extra, testing e pasture. Como
+    podem existir nomes de pacotes idênticos nessas pastas, o estabelecimento de uma
+    ordem se faz necessária.
   
-  # REPOS repository package priority
-  REPOS_PRIORITY="patches slackware extra testing pasture"
+  - REPOS_PRIORITY: da mesma forma como repositorios ROOT necessitam de uma prioridade
+    de pesquisa em pastas, este parâmetro de configuração especifica a prioridade de
+    pastas em repositórios do tipo REPOS. O valor padrão é
+    "patches slackware extra testing pasture".
   
-  # Whether to check package signatures (you should have the repository
-  # maintainer key on your keyring)
-  SIGNATURE_CHECKING="0"
+  - SIGNATURE_CHECKING: indica se o simplaret deve checar pela assinatura dos pacotes
+    baixados, caso ela esteja disponível. Você deve ter a chave pública do distribuidor
+    dos pacotes no seu chaveiro. O valor padrão é "0" (desabilitado).
   
-  # Whether simplaret will try to solve dependencies by looking
-  # for packages' slack-required
-  DEPENDENCY_CHECKING="1"
+  - DEPENDENCY_CHECKING: indica se o simplaret deve trabalhar com a resuloção de dependências
+    caso ele encontre, no repositório, um arquivo slack-required correspondente ao pacote que
+    está sendo instalado. O valor padrão é "1" (habilitado).
   
-  # Enabling this option (i.e, setting to "1" or "yes"), simplaret will
-  # donwload even # already applied patches, a good option when you plan
-  # to keep local copies of all needed patches for your system
-  DOWNLOAD_EVEN_APPLIED_PATCHES="0"
+  - DOWNLOAD_EVEN_APPLIED_PATCHES: indica de o simplaret deve baixar todos os patches
+    disponíveis a uma dada instalação de sistema do tipo Slackware, mesmo que os mesmo
+    já se encontrem aplicados. Esta opção é útil se você quiser manter uma cópia local
+    das atualizações existentes para seu sistema. O valor padrão é "0" (desabilitado).
   
-  # Enabling this option (i.e, setting to "1" or "yes"), simplaret will
-  # look at your standard repositories for new packages; if it find a
-  # package with different version of your current installed package and
-  # also this package isnt in the packages folder, then the new package
-  # is applied; if in doubt, just say no or leave blank. Otherwise set it
-  # either to "yes" or "1" and remember that if enabling this feature can
-  # cause problems if you use more than one REPOS definition for each
-  # ARCH and VERSION. Also, this option can be very slow.
-  CONSIDER_ALL_PACKAGES_AS_PATCHES="0"
+  - CONSIDER_ALL_PACKAGES_AS_PATCHES: especifica se o simplaret deve, durante a obtenção
+    de pacotes de atualização, procurar por atualizações também nos tipos de repositórios
+    REPOS e NOARCH. Com essa opção, o simplaret faz uma pesquisa pelo pacote e, se sua versão
+    ou buildnumber da primeira ocorrência não bater com as do pacote atualmente instalado,
+    ele baixa e o aplica, mesmo que seja um pacote de repositórios do tipo REPOS ou NOARCH.
+    O valor padrão é "0" (desabilitado). O uso dessa opção não é muito recomendado por poder
+    causar confusão e deixar o simplaret mais lento, mas pode ser útil caso você esteja
+    usando um repositório não-oficial que sempre atualiza seus pacotes.
   
-  # Enabling this option (i.e, setting to "1" or "yes"), simplaret will
-  # store patches it finds on ROOT repositories on
-  #
-  #   $PATCHES_DIR/$ARCH/$VERSION/root-$repository_name.
-  #
-  # By default this option is turned off because it breaks the standard
-  # way to store packages and can cause some confusion, but its an useful
-  # feature if you like to see all patches apart from common packages and/or
-  # stored in the same tree.
-  STORE_ROOT_PATCHES_ON_PATCHES_DIR="0"
+  - STORE_ROOT_PATCHES_ON_PATCHES_DIR: controla se o simplaret deve armazenar os patches baixados
+    de repositórios do tipo ROOT na mesma pasta de armazenamento de patches provenientes de
+    repositórios do tipo PATCHES. É uma opção útil apenas se você quiser manter todos os patches
+    de repositórios ROOT e PATCHES num mesmo local. O valor padrão é "0" (desabilitado).
+
+Vale lembrar que todas as opções booleanas (isto é, que podem ser apenas habilitadas ou desabilitadas)
+do simplepkg.conf tem os seguintes valores permitidos: "1" e "yes" para habilitado e "0" ou "no" para
+desabilitado.
 
 Mas para quê serve isso?
 ------------------------