From 4e23908b1d7c67602188b61b4e1d2802eca67523 Mon Sep 17 00:00:00 2001 From: rhatto Date: Tue, 17 Apr 2007 19:22:15 +0000 Subject: done simplaret pt_BR documentation git-svn-id: svn+slack://slack.fluxo.info/var/svn/simplepkg@354 04377dda-e619-0410-9926-eae83683ac58 --- trunk/conf/simplepkg.conf.new | 6 +- trunk/doc/README.simplaret.pt_BR | 142 +++++++++++++++++---------------------- trunk/lib/common.sh | 2 +- 3 files changed, 66 insertions(+), 84 deletions(-) diff --git a/trunk/conf/simplepkg.conf.new b/trunk/conf/simplepkg.conf.new index 6a3c687..927d870 100644 --- a/trunk/conf/simplepkg.conf.new +++ b/trunk/conf/simplepkg.conf.new @@ -34,7 +34,7 @@ SIMPLARET_DOWNLOAD_FROM_NEXT_REPO="1" # Wheter delete also patches when simplaret --purge is called; # to enable it, set to "1" or "yes" -SIMPLARET_PURGE_PATCHES="0" +SIMPLARET_PURGE_PATCHES="1" # Whether delete each package rigth after its installation; # to enable it, set to "1" or "yes" @@ -55,11 +55,11 @@ PASSIVE_FTP="1" # Http retrieval tool; # available parameters are "wget" or "curl" -HTTP_TOOL="wget" +HTTP_TOOL="curl" # Ftp retrieval tool; # available parameters are "wget", "curl" or "ncftpget" -FTP_TOOL="wget" +FTP_TOOL="curl" # Set connection timeout in seconds CONNECT_TIMEOUT="20" 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 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? ------------------------ diff --git a/trunk/lib/common.sh b/trunk/lib/common.sh index 5c53a09..47bd037 100644 --- a/trunk/lib/common.sh +++ b/trunk/lib/common.sh @@ -222,7 +222,7 @@ function eval_config { SIMPLARET_DELETE_DOWN="`eval_boolean_parameter SIMPLARET_DELETE_DOWN 1`" SIMPLARET_UPDATE="`eval_boolean_parameter SIMPLARET_UPDATE 0`" SIMPLARET_DELETE_DURING="`eval_boolean_parameter SIMPLARET_DELETE_DURING 0`" - SIMPLARET_PURGE_PATCHES="`eval_boolean_parameter SIMPLARET_PURGE_PATCHES 0`" + SIMPLARET_PURGE_PATCHES="`eval_boolean_parameter SIMPLARET_PURGE_PATCHES 1`" SIMPLARET_DOWNLOAD_FROM_NEXT_REPO="`eval_boolean_parameter SIMPLARET_DOWNLOAD_FROM_NEXT_REPO 1`" PASSIVE_FTP="`eval_boolean_parameter PASSIVE_FTP 0`" WARNING="`eval_boolean_parameter WARNING 0`" -- cgit v1.2.3