From 9975c27866fd2f7b9a7f5ec44b5ca5ee70f947b2 Mon Sep 17 00:00:00 2001 From: Arch Librarian Date: Mon, 20 Sep 2004 17:01:13 +0000 Subject: Add pt_BR translation of apt_preferences(5). Also, bui... Author: doogie Date: 2003-04-27 00:25:57 GMT Add pt_BR translation of apt_preferences(5). Also, build fr manpages. --- doc/pt_BR/apt_preferences.pt_BR.5.sgml | 572 +++++++++++++++++++++++++++++++++ 1 file changed, 572 insertions(+) create mode 100644 doc/pt_BR/apt_preferences.pt_BR.5.sgml (limited to 'doc/pt_BR/apt_preferences.pt_BR.5.sgml') diff --git a/doc/pt_BR/apt_preferences.pt_BR.5.sgml b/doc/pt_BR/apt_preferences.pt_BR.5.sgml new file mode 100644 index 000000000..63eda7675 --- /dev/null +++ b/doc/pt_BR/apt_preferences.pt_BR.5.sgml @@ -0,0 +1,572 @@ + + +%aptent; + +]> + + + &apt-docinfo; + + + apt_preferences + 5 + + + + + apt_preferences + Arquivo de controle de preferências para o APT + + +Descrição</> +<para> +O arquivo de preferências do APT <filename>/etc/apt/preferences</> +pode ser usado para controlar qual versão de um pacote será +selecionada para instalação. +</para> + +<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, <literal>stable</literal> e +<literal>testing</literal>); 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 <command>apt-get</command> +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. +</para> + +<para>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. +</para> + +<RefSect2><Title>Atribuições de Prioridade Padrão do APT</> + +<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, + +<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á : + +<variablelist> +<varlistentry> +<term>prioridade 100</term> +<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> +</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> +</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> + +<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 +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> +<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> +</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 +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>. +</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> + +<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> + +</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. +<itemizedlist> +<listitem> +<simpara>A forma "específica" pina uma prioridade (um "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/". +</simpara> + +<programlisting> +Package: perl +Pin: version 5.8* +Pin-Priority: 1001 +</programlisting> +</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. +</simpara> + +<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 +de pacotes disponíveis no site local. +</simpara> + +<programlisting> +Package: * +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> + +<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> + +<programlisting> +Package: * +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> + +<programlisting> +Package: * +Pin: release a=unstable, v=3.0 +Pin-Priority: 50 +</programlisting> +</listitem> +</itemizedlist> +</para> + +</RefSect2> + +<RefSect2><Title>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): + + +P > 1000 +faz com que uma instância seja instalada +mesmo caso isso constitua um dowgrade do pacote + + +990 < P <=1000 +faz com que uma instância seja instalada +mesmo caso a mesma não venha de uma versão alvo, +a menos que a instância 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 + + +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 + + +P < 0 +impede a instância 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. + + +Por exemplo, suponha que o arquivo de preferências do APT contenha +os três registrsos apresentados anteriormente : + + +Package: perl +Pin: version 5.8* +Pin-Priority: 1001 + +Package: * +Pin: origin "" +Pin-Priority: 999 + +Package: * +Pin: release unstable +Pin-Priority: 50 + + +Então : + + +A versão mais recente disponível do pacote + +Uma instância de qualquer pacote que não +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 " + + + + +Determinação da Versão do Pacote e Propriedades de 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. + + +O arquivo Packages é nromalmente 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 +cada pacote disponível no diretório. Somente duas linhas em cada registro +são relevantes para definir prioridades do APT : + + +a linha +informa o nome do pacote + + +a linha +informa o número de versão do pacote + + + + +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 + + + +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. + + + +Pin: release v=3.0 +Pin: release a=stable v=3.0 +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 + + + + + +a linha +dá nome ao produtor das instâncias de pacote na +àrvore de diretório do arquivo + + +Pin: release o=Debian + + + + + +a linha +parece redundante. +seems redundant. O mais comum é esse valor ser + + +Pin: release l=Debian + + + + + + +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 +debian.lcs.mit.edu_debian_dists_unstable_contrib_binary-i386_Release +contém o arquivo Release obtido do site + + + + +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 + + +A linha + + + +Exemplos</> +<RefSect2><Title>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 +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 + + + + +Com um arquivo &sources-list; apropriado e o arquivo de preferências +acima, quaisquer um dos comandos a seguir farão com que o APT atualize +para a(s) ulítma(s) versão(ôes) +apt-get install nome-pacote +apt-get upgrade +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 install pacote/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 + +Package: * +Pin: release a=testing +Pin-Priority: 900 + +Package: * +Pin: release a=unstable +Pin-Priority: 800 + +Package: * +Pin: release o=Debian +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 +apt-get upgrade +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 + +apt-get install pacote/unstable + + + + + + + Consulte também</> +<para> +&apt-get; &apt-cache; &apt-conf; &sources-list; + </RefSect1> + + &manbugs; + &manauthor; + &ptbr-mantranslator; + +</refentry> -- cgit v1.2.3