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/.cvsignore | 3 + doc/pt_BR/apt.ent.pt_BR | 157 +++++++++ doc/pt_BR/apt_preferences.pt_BR.5.sgml | 572 +++++++++++++++++++++++++++++++++ doc/pt_BR/makefile | 10 + 4 files changed, 742 insertions(+) create mode 100644 doc/pt_BR/.cvsignore create mode 100644 doc/pt_BR/apt.ent.pt_BR create mode 100644 doc/pt_BR/apt_preferences.pt_BR.5.sgml create mode 100644 doc/pt_BR/makefile (limited to 'doc/pt_BR') diff --git a/doc/pt_BR/.cvsignore b/doc/pt_BR/.cvsignore new file mode 100644 index 00000000..8d11bcc8 --- /dev/null +++ b/doc/pt_BR/.cvsignore @@ -0,0 +1,3 @@ +apt_preferences.pt_BR.5 +manpage.links +manpage.refs diff --git a/doc/pt_BR/apt.ent.pt_BR b/doc/pt_BR/apt.ent.pt_BR new file mode 100644 index 00000000..636805b1 --- /dev/null +++ b/doc/pt_BR/apt.ent.pt_BR @@ -0,0 +1,157 @@ + + + + +&docdir;examples/configure-index.gz"> +/etc/apt.conf"> + + + + + + + "> + + + + "> + + + + "> + + + + "> + + + + "> + + + + "> + + + + "> + + + + "> + + + + "> + + + + "> + + + + "> + + + + "> + + + + "> + + + + "> + + + +
apt@packages.debian.org
+ Jason Gunthorpe + 1998-2001 Jason Gunthorpe + 12 Março 2001 + +"> + + +Bugs</> + <para> + Consulte a <ulink url='http://bugs.debian.org/apt'>página de bugs do APT</>. + Caso você queira relatar um bug no APT, por favor consulte o arquivo + <filename>/usr/share/doc/debian/bug-reporting.txt</> ou o comando &reportbug;. + </RefSect1> +"> + +<!-- Boiler plate Author section --> +<!ENTITY manauthor " + <RefSect1><Title>Author</> + <para> + O APT foi escrito pela equipe APT <email>apt@packages.debian.org</>. + </RefSect1> +"> + +<!-- Brazilian Portuguese Translation Credits section --> +<!ENTITY ptbr-mantranslator " + <RefSect1><Title>Tradução</> + <para> + Esta página de manual foi traduzida para o Português do Brasil por + André Luís Lopes <email>andrelop@ig.com.br</>. + </RefSect1> +"> + + +<!-- Should be used within the option section of the text to + put in the blurb about -h, -v, -c and -o --> +<!ENTITY apt-commonoptions " + <VarListEntry><term><option/-h/</><term><option/--help/</> + <ListItem><Para> + Exibe um pequeno resumo de uso. + </VarListEntry> + + <VarListEntry><term><option/-v/</><term><option/--version/</> + <ListItem><Para> + Exibe a versão do programa. + </VarListEntry> + + <VarListEntry><term><option/-c/</><term><option/--config-file/</> + <ListItem><Para> + Arquivo de Configuração; Especifica um arquivo de configuração + a ser usado. O programa irá ler o arquivo de configuração padrão + e então este arquivo de configuração. Consulte &apt-conf; para + informação de sintaxe. + </VarListEntry> + + <VarListEntry><term><option/-o/</><term><option/--option/</> + <ListItem><Para> + Defie uma Opção de Configuração; Esta opção irá definir uma opção + de configuração arbitrária. A sintaxe é <option>-o Foo::Bar=bar</>. + </VarListEntry> +"> + +<!-- Should be used within the option section of the text to + put in the blurb about -h, -v, -c and -o --> +<!ENTITY apt-cmdblurb " + <para> + Todas as opções de linha de comando podem ser definidas usando o + arquivo de configuração, as descrições indicam a opção de configuração + a ser definida. Para opções booleanas você pode sobrepor o arquivo de + configuração usando algo como <option/-f-/,<option/--no-f/, + <option/-f=no/ ou diversas outras variantes. + </para> +"> 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 00000000..63eda767 --- /dev/null +++ b/doc/pt_BR/apt_preferences.pt_BR.5.sgml @@ -0,0 +1,572 @@ +<!-- -*- mode: sgml; mode: fold -*- --> +<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [ + +<!ENTITY % aptent SYSTEM "apt.ent.pt_BR"> +%aptent; + +]> + +<refentry lang="pt_BR"> + &apt-docinfo; + + <refmeta> + <refentrytitle>apt_preferences</> + <manvolnum>5</> + </refmeta> + + <!-- Man page title --> + <refnamediv> + <refname>apt_preferences</> + <refpurpose>Arquivo de controle de preferências para o APT</> + </refnamediv> + +<RefSect1><Title>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> diff --git a/doc/pt_BR/makefile b/doc/pt_BR/makefile new file mode 100644 index 00000000..4c9ea629 --- /dev/null +++ b/doc/pt_BR/makefile @@ -0,0 +1,10 @@ +# -*- make -*- +BASE=../.. +SUBDIR=doc/pt_BR + +# Bring in the default rules +include ../../buildlib/defaults.mak + +SOURCE = apt_preferences.pt_BR.5 +INCLUDES = apt.ent.pt_BR +include $(SGML_MANPAGE_H) -- cgit v1.2.3