From 3dded9f4866e073088efe4dc9ca3994dc7bef553 Mon Sep 17 00:00:00 2001 From: Arch Librarian Date: Mon, 20 Sep 2004 17:02:46 +0000 Subject: * Patch to update pt_BR man page for apt_preferences(5)... Author: mdz Date: 2003-08-08 23:53:24 GMT * Patch to update pt_BR man page for apt_preferences(5) from Andre Luis Lopes (Closes: #202245) --- debian/changelog | 4 +- doc/pt_BR/apt_preferences.pt_BR.5.sgml | 465 +++++++++++++++++---------------- 2 files changed, 244 insertions(+), 225 deletions(-) diff --git a/debian/changelog b/debian/changelog index da82fc20a..eac78da81 100644 --- a/debian/changelog +++ b/debian/changelog @@ -23,8 +23,10 @@ apt (0.5.9) unstable; urgency=low package which suggests/recommends them (Closes: #200102) * Patch from Otavio Salvador to avoid listing suggests/recommends which are Provided by a package which is already installed (Closes: #200395) + * Patch to update pt_BR man page for apt_preferences(5) from Andre Luis + Lopes (Closes: #202245) - -- Matt Zimmerman Fri, 8 Aug 2003 19:47:19 -0400 + -- Matt Zimmerman Fri, 8 Aug 2003 19:52:49 -0400 apt (0.5.8) unstable; urgency=medium diff --git a/doc/pt_BR/apt_preferences.pt_BR.5.sgml b/doc/pt_BR/apt_preferences.pt_BR.5.sgml index 63eda7675..212c43b66 100644 --- a/doc/pt_BR/apt_preferences.pt_BR.5.sgml +++ b/doc/pt_BR/apt_preferences.pt_BR.5.sgml @@ -20,146 +20,147 @@ Arquivo de controle de preferências para o APT -Descrição</> +<RefSect1> +<Title>Descrição O arquivo de preferências do APT /etc/apt/preferences -pode ser usado para controlar qual versão de um pacote será -selecionada para instalação. +pode ser usado para controlar quais versões de pacotes serão +selecionadas para instalação. -Diversas versões de um pacote podem estar disponíveis para + +Diversas versões de um pacote podem estar disponíveis para instalação quando o arquivo &sources-list; contém referências para mais de uma distribuição (por exemplo, stable e -testing); além disso, diversas instâncias da mesma -versão de um pacote podem estar disponíveis quando o arquivo contém -referências para mais de um site para download para uma distribuição -específica. O APT atribui uma "prioridade" para cada instância que -esteja disponível. (No que se segue, uma "instância" será uma instância -de um pacote que esteja disponível de acordo com o arquivo -&sources-list;.) -Sujeito a obstáculos de dependências, o apt-get -instala a instância com a prioridade mais alta. Caso duas instâncias -possuam a mesma prioridade o APT irá instalar a instância mais recente, -ou seja, aquela com o maior número de versão. +testing). O APT atribui uma prioridade para cada +versão que esteja disponível. Sujeito a obstáculos de dependências, o +apt-get seleciona para instalação a versão com a +maior prioridade. +O arquivo de preferências do APT sobrepoe as prioridades que o APT +atribui a cada versão de pacote por padrão, dando assim ao usuário +controle sobre qual versão do pacote é selecionada para instalação. - -O arquivo de preferências do APT sobrepõe as prioridades que o -APT atribui por padrão a instâncias de pacote, dando portanto ao usuário -controle sobre qual pacote é eslecionado para instalação. + +Diversas instâncias da mesma versão de um pacote pode estar disponíveis +quando o arquivo &sources-list; contém referências a mais de uma fonte. +Nesse caso, o apt-get faz o download da instância +listada antes no arquivo &sources-list; . +O arquivo de preferências do APT não afeta a escolha da instância. Atribuições de Prioridade Padrão do APT</> -<para>Caso não exista um arquivo de preferências ou caso não exista uma +<para> +Caso não exista um arquivo de preferências ou caso não exista uma entrada no arquivo que se aplique a uma instância em particular, a prioridade atribuída a essa instância é a prioridade da distribuição para a qual a instância pertence. É possível selecionar uma distribuição, -conhecida como a "versão alvo" (target release), a qual recebe uma -prioridade maior do que as outras distribuições. A versão alvo pode ser -definida na linha de comando do <command>apt-get</command> ou no arquivo -de configuração do APT <filename>/etc/apt/apt.conf</filename>. Por -exemplo, - +conhecida como "a versão alvo" (the target release), que recebe uma +prioridade maior do que as outras distribuições. +A versão alvo pode ser definida na linha de comando do +<command>apt-get</command> ou no arquivo de configuração do APT +<filename>/etc/apt/apt.conf</filename>. +Por exemplo, <programlisting> -# Comando para instalar a versão <literal/testing/ do pacote <replaceable>algum-pacote</replaceable> <command>apt-get install -t testing <replaceable>algum-pacote</replaceable></command> </programlisting> - <programlisting> -# Configuração que torna <literal/stable/ a versão alvo APT::Default-Release "stable"; </programlisting> </para> -<para>Caso um aversão alvo tenha sido especificada o APT usará o -seguinte algoritmo para definir as prioridades das instâncias de um -pacote. Atribuirá : - +<para> +Caso uma versão alvo tenha sido especificada o APT usará o seguinte +algoritmo para definir as prioridades das instâncias de um pacote. +Atribuirá : <variablelist> <varlistentry> <term>prioridade 100</term> -<listitem><simpara>para a instância que já esteja instalada (caso exista). -</simpara></listitem> +<listitem><simpara>para a instância que já esteja instalada (caso exista).</simpara></listitem> </varlistentry> <varlistentry> <term>prioridade 500</term> -<listitem><simpara>para as instâncias que não estã instaladas e que não -pertencem a versão alvo. -</simpara></listitem> +<listitem><simpara>para as instâncias que não estã instaladas e que não pertencem a versão alvo.</simpara></listitem> </varlistentry> <varlistentry> <term>prioridade 990</term> -<listitem><simpara>para as instâncias que não estejam instaladas e pertençãm -a versão alvo. -</simpara></listitem> +<listitem><simpara>para as instâncias que não estejam instaladas e pertençam a versão alvo.</simpara></listitem> </varlistentry> </variablelist> </para> -<para>Caso nenhuma versão alvo tenha sido especificada o APT simplesmente -irá atribuir a prioridade 100 para todos as instâncias de pacotes instalados -e a prioridade 500 para todas as instâncias de pacotes não instalados. +<para> +Caso nenhuma versão alvo tenha sido especificada, o APT simplesmente +irá atribuir a prioridade 100 para todas as instâncias de pacotes instaladas +e a prioridade 500 para todas as instâncias de pacotes não instaladas. </para> -<para>O APT aplica as regras a seguir, listadas em ordem de precedência, -para determinar qual instância de um pacote instalar. - +<para> +O APT aplica as regras a seguir, listadas em ordem de precedência, para +determinar qual instância de um pacote instalar. <itemizedlist> <listitem><simpara>Nunca faz um downgrade a menos que a prioridade de -uma instância disponível exceda 1000. (Fazer um "dowgrade" é instalar uma +uma instância disponível exceda 1000. (Fazer um "downgrade" é instalar uma versão menos recente de um pacote no lugar de uma versão mais recente. Note que nenhuma das prioridades padrão do APT excede 1000; prioridades altas -como essa podem ser definidas somente no arquivo de preferências.) -</simpara></listitem> -<listitem><simpara>Instala a instância de prioridade mais alta. -</simpara></listitem> +como essa podem ser definidas somente no arquivo de preferências. Note +também que fazer um "downgrade" pode ser arriscado.)</simpara></listitem> +<listitem><simpara>Instala a instância de prioridade mais alta.</simpara></listitem> <listitem><simpara>Caso duas ou mais instâncias possuam a mesma prioridade, -instalar a instância mais recente. -</simpara></listitem> -<listitem><simpara>Caso duas ou mais instâncias possuam o mesmo número de -versão, instalar a instância a qual a fonte esteja listada no &sources-list;. -(A instância instalada, caso exista, é sempre a preferida em uma comparação -como essa a menos que o comando <command>apt-get --reinstall</command> seja -usado.) -</simpara></listitem> +instala a instância mais recente (ou seja, aquela com o maior número de +versão).</simpara></listitem> +<listitem><simpara>Caso duas ou mais instâncias possuam a mesma prioridade +e número de versão mas os pacotes sejam diferentes em alguns de seus +metadados ou a opção <literal/--reinstall/ seja fornecida, instala aquela +desinstalada.</simpara></listitem> </itemizedlist> </para> -<para>Em uma situação típica, a instância instalada de um pacote -(prioridade 100) não é tão recente quanto uma das instâncias disponíveis +<para> +Em uma situação típica, a instância instalada de um pacote +(prioridade 100) não é tão recente quanto uma das versões disponíveis nas fontes listadas no arquivo &sources-list; (prioridade 500 ou 990). -Então o pacote será atualizado com o comando : -<command>apt-get install</command> ou <command>apt-get dist-upgrade</command>. +Então o pacote será atualizado quando os comandos +<command>apt-get install <replaceable>algum-pacote</replaceable></command> +ou <command>apt-get dist-upgrade</command> forem executados. </para> -<para>Raramente, a instância instalada de um pacote é <emphasis/mais/ -recente do que qualquer uma das outras instâncias disponíveis. O dowgrade -do pacote não será feito. +<para> +Mais raramente, a versão instalada de um pacote é <emphasis/mais/ +recente do que qualquer uma das outras versões disponíveis. O dowgrade +do pacote não será feito quando os comandos +<command>apt-get install <replaceable>algum-pacote</replaceable></command> +ou <command>apt-get upgrade</command> forem executados. </para> -<para>Algumas vezes a instância instalada de um pacote é mais recente -que a versão que pertence a versçao alvo, mas não tão recente quanto a -versão que pertence a alguma outra distribuição. Um pacote como esse -será realmente atualizado, devido a pelo menos <emphasis/uma/ das -instâncias disponíveis possuir uma prioridade maior do que a instância -instalada. +<para> +Algumas vezes a versão instalada de um pacote é mais recente que a versão +que pertence a versão alvo, mas não tão recente quanto a versão que +pertence a alguma outra distribuição. Um pacote como esse será na verdade +atualizado quando os comandos +<command>apt-get install <replaceable>algum-pacote</replaceable></command> +ou <command>apt-get upgrade</command> forem executados, devido a pelo +menos <emphasis/uma/ das versões disponíveis possuir uma prioridade maior +do que a versão instalada. </para> </RefSect2> <RefSect2><Title>O Efeito das Preferências do APT</> -<para>O arquivo de preferências do APT permite ao administrador do -sistema personalizar as prioridades. O arquivo consiste de um ou mais -registro de múltiplas linhas separados por linhas em branco. Registros -podem possuir uma ou duas formas, uma forma específica e uma forma -geral. +<para> +O arquivo de preferências do APT permite ao administrador do +sistema personalizar prioridades. O arquivo consiste de um ou mais +registros de múltiplas linhas separados por linhas em branco. Registros +podem possuir uma das duas formas, uma forma específica e uma forma geral. <itemizedlist> <listitem> -<simpara>A forma "específica" pina uma prioridade (um "Pin-Priority") +<simpara> +A forma específica atribui uma uma prioridade (uma "Pin-Priority") para um pacote e versão ou faixa de versão especificados. Por exemplo, -o registro a seguir pina uma prioridade alta para todas as versões do -pacote <filename/perl/ as quais o número de versão inicia com <literal/5.8/". +o registro a seguir atribui uma prioridade alta para todas as versões do +pacote <filename/perl/ os quais tenham seus números de versão iniciando +com "<literal/5.8/". </simpara> <programlisting> @@ -170,16 +171,17 @@ Pin-Priority: 1001 </listitem> <listitem><simpara> -O forma "geral" pina uma prioridade para todas as versões de pacotes em -uma dada distribuição (isto é, para toda as versões de pacotes que estão -em um certo arquivo <filename/Release/) ou para todas as instâncias de -pacotes que vêm de um site Internet em particular, como identificado -por seu nome de domínio totalmente qualificado. +O forma geral atribui uma prioridade para todas as versões de pacotes em +uma dada distribuição (isto é, para toda as versões de pacotes que estejam +em um certo arquivo <filename/Release/) ou para todas as versões de +pacotes que provenientes de um site Internet em particular, como +identificado pelo nome de domínio totalmente qualificado do site Internet. </simpara> -<simpara>Essa entrada de forma geral no arquivo de preferências do APT +<simpara> +Essa entrada de forma geral no arquivo de preferências do APT aplica-se somente a grupos de pacotes. Por exemplo, o registro a seguir -faz com que o APT atribua uma prioridade alta para todas as instâncias +faz com que o APT atribua uma prioridade alta para todas as versões de pacotes disponíveis no site local. </simpara> @@ -189,19 +191,19 @@ Pin: origin "" Pin-Priority: 999 </programlisting> -<simpara>Uma nota de aviso : a palavra-chave usada aqui é -"<literal/origin/". Esta não deve ser confundida com com a origem -("Origin:") de uma distribuição como especificado em um arquivo -<filename/Release/. O que segue a tag "Origin:" em um arquivo -<filename/Release/ normalmente não é um endereço de site Internet -mas sim nome de autor ou distribuidor (vendor), como "Debian" ou -"Ximian". +<simpara> +Uma nota de aviso : a palavra-chave usada aqui é "<literal/origin/". +Esta palavra não deve ser confundida com a origem ("Origin:") de uma +distribuição como especificado em um arquivo <filename/Release/. O que +segue a tag "Origin:" em um arquivo <filename/Release/ não é um endereço +de site Internet mas sim nome de autor ou distribuidor (vendor), como +"Debian" ou "Ximian". </simpara> -<simpara>O registro a seguir faz com que o APT atribua uma prioridade -baixa para todas as versões de pacote que pertençam a qualquer -distribuição a qual o nome do "Archive" (<literal/a/) seja -"<literal/unstable/". +<simpara> +O registro a seguir atribui uma prioridade baixa para todas as versões +de pacote que pertençam a qualquer distribuição cujo nome do Repositório +seja "<literal/unstable/". </simpara> <programlisting> @@ -210,11 +212,10 @@ Pin: release a=unstable Pin-Priority: 50 </programlisting> -<simpara>O registro a seguir faz com que o APT atribua uma prioridade -alta para todas as versões de pacotes que pertencem a qualquer versão -a qual o nome do repositório ("Archive") (<literal/a/) seja -"<literal/stable/" e a qual o número de versão ("Version") -(<literal/v/) seja "<literal/3.0/". +<simpara> +O registro a seguir atribui uma prioridade alta para todas as versões de +pacotes que pertençam a qualquer versão cujo nome do Repositório seja +"<literal/stable/" e cujo número de versão seja "<literal/3.0/". </simpara> <programlisting> @@ -228,57 +229,61 @@ Pin-Priority: 50 </RefSect2> -<RefSect2><Title>Como o APT Interpreta Prioridades + +Como o APT Interpreta Prioridades -Prioridades (P) atribuídas no arquivo de preferências do APT -devem ser inteiros positivos ou negativos. Eles são interpretados como -a seguir (a grosso modo): + +Prioridades (P) atribuídas no arquivo de preferências do APT devem ser +números inteiros positivos ou negativos. Eles são interpretados como a +seguir (a grosso modo): -P > 1000 + +P > 1000 faz com que uma instância seja instalada -mesmo caso isso constitua um dowgrade do pacote - +mesmo caso isso constitua um dowgrade do pacote -990 < P <=1000 -faz com que uma instância seja instalada + +990 < P <=1000 +faz com que uma versão seja instalada mesmo caso a mesma não venha de uma versão alvo, -a menos que a instância instalada seja mais recente - +a menos que a versão instalada seja mais recente -500 < P <=990 -faz com que uma instância seja instalada -a menos que exista uma instância disponível pertencente a versão -alvo ou a versão instalada seja mais recente - + +500 < P <=990 +faz com que uma versão seja instalada +a menos que exista uma versão disponível pertencente a versão +alvo ou a versão instalada seja mais recente -100 < P <=500 -faz com que uma instância seja instalada -a menos que exista uma instância disponível pertencente a alguma -outra distribuição ou a versão instalada seja mais recente - -0 <= P <=100 -faz com que uma instância seja instalada -somente caso não exista uma instância instalada do pacote - + +100 < P <=500 +faz com que uma versão seja instalada +a menos que exista uma versão disponível pertencente a alguma +outra distribuição ou a versão instalada seja mais recente + +0 <= P <=100 +faz com que uma versão seja instalada +somente caso não exista uma versão instalada do pacote -P < 0 -impede a instância de ser instalada - + +P < 0 +impede a versão de ser instalada -Caso um dos registro de forma específica descritos acima caso com -uma instância disponível de pacote, tal registro determina a prioridade -da instância. Caso dois registros de forma específica casem com uma -instância disponível, o primeiro registro encontrado determina a -prioridade. Caso dois registros de forma geral casem com uma instância -disponível, o primeiro registro encontrado determina a prioridade. + +Caso um dos registro de forma específica descritos acima case (match) com +uma versão disponível do pacote então o primeiro desses registros +encontrados determinará a prioridade da versão do pacote. Na falha desse +cenário, caso quaisquer registros de forma genérica casem (match) com uma +versão do pacote disponível então o primeiro desses registros encontrado +determinará a prioridade da versão do pacote. -Por exemplo, suponha que o arquivo de preferências do APT contenha -os três registrsos apresentados anteriormente : + +Por exemplo, suponha que o arquivo de preferências do APT contenha +os três registros apresentados anteriormente : Package: perl @@ -303,29 +308,31 @@ vers de -Uma instância de qualquer pacote que não Uma versão de qualquer pacote diferente de + -Uma instância de um pacote a qual a origem não seja -o sistema local mas sim algum outro site listado n &sources-list; e a -qual pertença a uma distribuição "Uma versão de um pacote cuja origem não seja o sistema +local mas sim algum outro site listado no arquivo &sources-list; e que +pertença a uma distribuição -Determinação da Versão do Pacote e Propriedades de Distribuição + +Determinação da Versão do Pacote e Propriedades da Distribuição -As localidades listadas em um arquivo &sources-list; de um sistema -devem fornecer arquivos Package e -Release para descrever as instâncias de pacote -disponíveis nestas localidades. + +As localidades listadas em um arquivo &sources-list; devem fornecer +arquivos Packages e Release para +descrever os pacotes disponíveis nessas localidades. -O arquivo Packages é nromalmente encontrado no + +O arquivo Packages é normalmente encontrado no diretório .../dists/nome-distribuição/componente/arquitetura : por exemplo, .../dists/stable/main/binary-i386/Packages. O arquivo consiste de uma série de registros de múltiplas linhas, uma para @@ -343,28 +350,29 @@ s -O arquivo Release é normalmente encontrado no + +O arquivo Release é normalmente encontrado no diretório .../dists/nome-distribuição : por exemplo, .../dists/stable/Release, ou .../dists/woody/Release. O arquivo consiste de um registro de múltiplas linhas o qual se aplica a - a linha -dá nome ao repositório para o qual as instâncias de -pacote na àrvore de diretório pertencem. Por exemplo, a linha -dá nome ao repositório para o qual todos os pacotes +na àrvore de diretório pertencem. Por exemplo, a linha +"Archive: stable" +especifica que todos os pacotes na àrvore de diretório +abaixo do diretório pai do arquivo - Pin: release a=stable @@ -373,12 +381,12 @@ Pin: release a=stable a linha -dá nome a versão da distribuição. Por exemplo, as -instâncias de pacote na àrvore podem pertencer a distribuição Debian -GNU/Linux versão 3.0. Normalmente não existe número de versão para as -distribuições "testing" e "unstable" devido as mesmas não terem sido -lançadas ainda. Especificar isso no arquivo de preferências do APT -iria requerer uma das linhas a seguir. +dá nome a versão da distribuição. Por exemplo, os +pacote na àrvore podem pertencer a distribuição Debian GNU/Linux versão +3.0. Note que normalmente não existe número de versão para as +distribuições @@ -393,15 +401,13 @@ Pin: release 3.0 a linha dá nome ao componente de licenciamento associado com -as instâncias de pacote na àrvore de diretório do arquivo - - Pin: release c=main @@ -410,12 +416,11 @@ Pin: release c=main a linha -dá nome ao produtor das instâncias de pacote na -àrvore de diretório do arquivo dá nome ao produtor dos pacotes na àrvore de diretório +do arquivo - Pin: release o=Debian @@ -424,12 +429,11 @@ Pin: release o=Debian a linha -parece redundante. -seems redundant. O mais comum é esse valor ser dá nome ao rótulo (label) dos pacotes na árvore de +diretório. O mais comum é esse valor ser - Pin: release l=Debian @@ -438,7 +442,8 @@ Pin: release l=Debian -Todos os arquivos Packages e + +Todos os arquivos Packages e Release obtidos das localidades listadas no arquivo &sources-list; são mantidos no diretório /var/lib/apt/lists ou no arquivo indicado pela variável @@ -452,15 +457,17 @@ arquivos do componente -Linhas Opcionais em um Registro de Preferências do APT + +Linhas Opcionais em um Registro de Preferências do APT -Cada registro em um arquivo de preferências do APT pode -opcionalmente iniciar com uma ou mais linhas iniciadas com a palavra - +Cada registro em um arquivo de preferências do APT pode opcionalmente +iniciar com uma ou mais linhas iniciadas com a palavra + -A linha +A linha -Exemplos</> -<RefSect2><Title>Acompanhando a Stable + +Exemplos + +Acompanhando a Stable -O arquivo de preferências do APT a seguir fará com que o APT -atribua uma prioridade maior do que a prioridade padrão (500) para todos -as versões de pacote pertencentes a distribuição +O arquivo de preferências do APT a seguir fará com que o APT atribua uma +prioridade maior do que a prioridade padrão (500) para todas as versões +de pacotes pertencentes a distribuição +Explanation: Desinstala ou não instala nenhuma versão de pacote originada +Explanation: do Debian a não ser aquelas na distribuição stable Package: * Pin: release a=stable Pin-Priority: 900 -Explanation: Desinstala ou não instala nenhuma instância originada do -Explanation: Debian a não ser aquelas na distribuição stable Package: * Pin: release o=Debian Pin-Priority: -10 @@ -502,22 +512,26 @@ apt-get dist-upgrade -O comando a seguir fará com que o APT atualize o pacote + +O comando a seguir fará com que o APT atualize o pacote especificado para a última versão da distribuição apt-get install pacote/testing - Acompanhando a Testing + +Acompanhando a Testing -O arquivo de preferências do APT a seguir fará com que o -APT atribua uma prioridade maior para versões de pacote da distribuição - +O arquivo de preferências do APT a seguir fará com que o APT atribua uma +prioridade maior para versões de pacote da distribuição Package: * @@ -535,9 +549,9 @@ Pin-Priority: -10 -Com o arquivo de preferências o APT acima, quaisquer dos -comandos a seguir farão com que o APT atualize para a(s) -última(s) versão(ões) apt-get install nome-pacote @@ -546,11 +560,14 @@ apt-get dist-upgrade -O comando a seguir fará com que o APT atualize o pacote -especificado para a última versão da distribuição apt-get dist-upgrade e os outros - +O comando a seguir fará com que o APT atualize o pacote especificado para +a última versão da distribuição apt-get upgrade irá atualizar o pacote para a versão + apt-get install pacote/unstable @@ -560,13 +577,13 @@ apt-get install pacote/unstable - Consulte também</> +<RefSect1> +<Title>Consulte também &apt-get; &apt-cache; &apt-conf; &sources-list; - + + &manbugs; &manauthor; &ptbr-mantranslator; - - -- cgit v1.2.3-70-g09d2