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.

17 files changed, 776 insertions, 2 deletions

diff --git a/doc/fr/.cvsignore b/doc/fr/.cvsignore
new file mode 100644
index 000000000..5686791c7
--- /dev/null
+++ b/doc/fr/.cvsignore
@@ -0,0 +1,10 @@
+apt-cdrom.fr.8
+apt-config.fr.8
+apt-extracttemplates.fr.1
+apt-ftparchive.fr.1
+apt-sortpkgs.fr.1
+apt.conf.fr.5
+apt_preferences.fr.5
+manpage.links
+manpage.refs
+sources.list.fr.5
diff --git a/doc/fr/apt-cache.8.fr.sgml b/doc/fr/apt-cache.fr.8.sgml
index 6670127bb..6670127bb 100644
--- a/doc/fr/apt-cache.8.fr.sgml
+++ b/doc/fr/apt-cache.fr.8.sgml
diff --git a/doc/fr/apt-cdrom.8.fr.sgml b/doc/fr/apt-cdrom.fr.8.sgml
index 11ba0ec63..11ba0ec63 100644
--- a/doc/fr/apt-cdrom.8.fr.sgml
+++ b/doc/fr/apt-cdrom.fr.8.sgml
diff --git a/doc/fr/apt-config.8.fr.sgml b/doc/fr/apt-config.fr.8.sgml
index 788bed89f..788bed89f 100644
--- a/doc/fr/apt-config.8.fr.sgml
+++ b/doc/fr/apt-config.fr.8.sgml
diff --git a/doc/fr/apt-extracttemplates.1.fr.sgml b/doc/fr/apt-extracttemplates.fr.1.sgml
index 25f375106..25f375106 100644
--- a/doc/fr/apt-extracttemplates.1.fr.sgml
+++ b/doc/fr/apt-extracttemplates.fr.1.sgml
diff --git a/doc/fr/apt-ftparchive.1.fr.sgml b/doc/fr/apt-ftparchive.fr.1.sgml
index 98fc5ac83..98fc5ac83 100644
--- a/doc/fr/apt-ftparchive.1.fr.sgml
+++ b/doc/fr/apt-ftparchive.fr.1.sgml
diff --git a/doc/fr/apt-sortpkgs.1.fr.sgml b/doc/fr/apt-sortpkgs.fr.1.sgml
index 8e964f6b8..8e964f6b8 100644
--- a/doc/fr/apt-sortpkgs.1.fr.sgml
+++ b/doc/fr/apt-sortpkgs.fr.1.sgml
diff --git a/doc/fr/apt.conf.5.fr.sgml b/doc/fr/apt.conf.fr.5.sgml
index 3e104203e..3e104203e 100644
--- a/doc/fr/apt.conf.5.fr.sgml
+++ b/doc/fr/apt.conf.fr.5.sgml
diff --git a/doc/fr/apt.ent.fr b/doc/fr/apt.ent.fr
index f11b97537..527fe0e74 100644
--- a/doc/fr/apt.ent.fr
+++ b/doc/fr/apt.ent.fr
@@ -114,7 +114,7 @@ commande &bug;.
 <!ENTITY manauthor "
  <RefSect1><Title>Auteur</>
    <para>
-   APT a été écrit par l'équipe APT <email>apt@packages.debian.org</>.
+   APT a été écrit par l'équipe APT <email>apt@packages.debian.org.</>
  </RefSect1>
 ">
 
@@ -122,7 +122,7 @@ commande &bug;.
 <!ENTITY deux-traducteurs "
 <RefSect1><Title>Traduction</>
 <para>
-Jérôme Marant. 2000&thinsp;; mise à jour : Philippe Batailler. 2001.
+Jérôme Marant. 2000&thinsp;; mise à jour : Philippe Batailler. 2001.</>
 </RefSect1>
 ">
 
diff --git a/doc/fr/apt_preferences.5.fr.sgml b/doc/fr/apt_preferences.fr.5.sgml
index f910ef4f1..f910ef4f1 100644
--- a/doc/fr/apt_preferences.5.fr.sgml
+++ b/doc/fr/apt_preferences.fr.5.sgml
diff --git a/doc/fr/makefile b/doc/fr/makefile
new file mode 100644
index 000000000..4e6aafb9e
--- /dev/null
+++ b/doc/fr/makefile
@@ -0,0 +1,12 @@
+# -*- make -*-
+BASE=../..
+SUBDIR=doc/fr
+
+# Bring in the default rules
+include ../../buildlib/defaults.mak
+
+SOURCE = apt-cdrom.fr.8 apt-config.fr.8 apt-extracttemplates.fr.1 \
+         apt-ftparchive.fr.1 apt-sortpkgs.fr.1 apt.conf.fr.5 \
+         apt_preferences.fr.5
+INCLUDES = apt.ent.fr
+include $(SGML_MANPAGE_H)
diff --git a/doc/fr/sources.list.5.fr.sgml b/doc/fr/sources.list.fr.5.sgml
index e2c48079c..e2c48079c 100644
--- a/doc/fr/sources.list.5.fr.sgml
+++ b/doc/fr/sources.list.fr.5.sgml
diff --git a/doc/makefile b/doc/makefile
index 6fef0cc6e..67236784c 100644
--- a/doc/makefile
+++ b/doc/makefile
@@ -1,6 +1,7 @@
 # -*- make -*-
 BASE=..
 SUBDIR=doc
+SUBDIRS= fr pt_BR
 
 # Bring in the default rules
 include ../buildlib/defaults.mak
@@ -22,3 +23,12 @@ SOURCE = examples/apt.conf examples/sources.list examples/configure-index
 TO = $(DOC)
 TARGET = doc
 include $(COPY_H)
+
+#.PHONY: headers library clean veryclean all binary program doc doc.pt_BR doc.fr
+doc: doc.fr doc.pt_BR
+
+doc.fr: %.fr:
+	$(MAKE) -C fr $*
+
+doc.pt_BR: %.pt_BR:
+	$(MAKE) -C pt_BR $*
diff --git a/doc/pt_BR/.cvsignore b/doc/pt_BR/.cvsignore
new file mode 100644
index 000000000..8d11bcc88
--- /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 000000000..636805b13
--- /dev/null
+++ b/doc/pt_BR/apt.ent.pt_BR
@@ -0,0 +1,157 @@
+<!-- -*- mode: sgml; mode: fold -*- -->
+
+<!-- Some common paths.. -->
+<!ENTITY docdir "/usr/share/doc/apt/">
+<!ENTITY configureindex "<filename>&docdir;examples/configure-index.gz</>">
+<!ENTITY aptconfdir "<filename>/etc/apt.conf</>">
+<!ENTITY statedir "/var/lib/apt">
+<!ENTITY cachedir "/var/cache/apt">
+
+<!-- Cross references to other man pages -->
+<!ENTITY apt-conf "<CiteRefEntry>
+    <RefEntryTitle><filename/apt.conf/</RefEntryTitle>
+    <ManVolNum/5/
+  </CiteRefEntry>">
+
+<!ENTITY apt-get "<CiteRefEntry>
+    <RefEntryTitle><command/apt-get/</RefEntryTitle>
+    <ManVolNum/8/
+  </CiteRefEntry>">
+
+<!ENTITY apt-config "<CiteRefEntry>
+    <RefEntryTitle><command/apt-config/</RefEntryTitle>
+    <ManVolNum/8/
+  </CiteRefEntry>">
+
+<!ENTITY apt-cdrom "<CiteRefEntry>
+    <RefEntryTitle><command/apt-cdrom/</RefEntryTitle>
+    <ManVolNum/8/
+  </CiteRefEntry>">
+
+<!ENTITY apt-cache "<CiteRefEntry>
+    <RefEntryTitle><command/apt-cache/</RefEntryTitle>
+    <ManVolNum/8/
+  </CiteRefEntry>">
+
+<!ENTITY apt-preferences "<CiteRefEntry>
+    <RefEntryTitle><command/apt_preferences/</RefEntryTitle>
+    <ManVolNum/5/
+  </CiteRefEntry>">
+
+<!ENTITY sources-list "<CiteRefEntry>
+    <RefEntryTitle><filename/sources.list/</RefEntryTitle>
+    <ManVolNum/5/
+  </CiteRefEntry>">
+
+<!ENTITY reportbug "<CiteRefEntry>
+    <RefEntryTitle><command/reportbug/</RefEntryTitle>
+    <ManVolNum/1/
+  </CiteRefEntry>">
+
+<!ENTITY dpkg "<CiteRefEntry>
+    <RefEntryTitle><command/dpkg/</RefEntryTitle>
+    <ManVolNum/8/
+  </CiteRefEntry>">
+
+<!ENTITY dpkg-buildpackage "<CiteRefEntry>
+    <RefEntryTitle><command/dpkg-buildpackage/</RefEntryTitle>
+    <ManVolNum/1/
+  </CiteRefEntry>">
+
+<!ENTITY gzip "<CiteRefEntry>
+    <RefEntryTitle><command/gzip/</RefEntryTitle>
+    <ManVolNum/1/
+  </CiteRefEntry>">
+
+<!ENTITY dpkg-scanpackages "<CiteRefEntry>
+    <RefEntryTitle><command/dpkg-scanpackages/</RefEntryTitle>
+    <ManVolNum/8/
+  </CiteRefEntry>">
+
+<!ENTITY dpkg-scansources "<CiteRefEntry>
+    <RefEntryTitle><command/dpkg-scansources/</RefEntryTitle>
+    <ManVolNum/8/
+  </CiteRefEntry>">
+
+<!ENTITY dselect "<CiteRefEntry>
+    <RefEntryTitle><command/dselect/</RefEntryTitle>
+    <ManVolNum/8/
+  </CiteRefEntry>">
+    
+<!-- Boiler plate docinfo section -->
+<!ENTITY apt-docinfo "
+ <docinfo>
+   <address><email>apt@packages.debian.org</></address>
+   <author><firstname>Jason</> <surname>Gunthorpe</></>
+   <copyright><year>1998-2001</> <holder>Jason Gunthorpe</></>
+   <date>12 Março 2001</>
+ </docinfo>
+"> 
+
+<!-- Boiler plate Bug reporting section -->
+<!ENTITY manbugs "
+ <RefSect1><Title>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 000000000..63eda7675
--- /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</Title>
+
+<para>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):
+
+<variablelist>
+<varlistentry><term>P &gt; 1000</term>
+<listitem><simpara>faz com que uma instância seja instalada
+mesmo caso isso constitua um dowgrade do pacote
+</simpara></listitem>
+</varlistentry>
+<varlistentry><term>990 &lt; P &lt;=1000</term>
+<listitem><simpara>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
+</simpara></listitem>
+</varlistentry>
+<varlistentry><term>500 &lt; P &lt;=990</term>
+<listitem><simpara>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
+</simpara></listitem>
+</varlistentry>
+<varlistentry><term>100 &lt; P &lt;=500</term>
+<listitem><simpara>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
+</simpara></listitem>
+<varlistentry><term>0 &lt;= P &lt;=100</term>
+<listitem><simpara>faz com que uma instância seja instalada
+somente caso não exista uma instância instalada do pacote
+</simpara></listitem>
+</varlistentry>
+<varlistentry><term>P &lt; 0</term>
+<listitem><simpara>impede a instância de ser instalada
+</simpara></listitem>
+</varlistentry>
+</variablelist>
+</para>
+
+<para>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.
+</para>
+
+<para>Por exemplo, suponha que o arquivo de preferências do APT contenha
+os três registrsos apresentados anteriormente :
+
+<programlisting>
+Package: perl
+Pin: version 5.8*
+Pin-Priority: 1001
+
+Package: *
+Pin: origin ""
+Pin-Priority: 999
+
+Package: *
+Pin: release unstable
+Pin-Priority: 50
+</programlisting>
+
+Então :
+
+<itemizedlist>
+<listitem><simpara>A versão mais recente disponível do pacote
+<literal/perl/ será instalado, contanto que esse número de versão da
+versão inicie com "<literal/5.8/".  Caso <emphasis/qualquer/ versão 5.8*
+de <literal/perl/ esteja disponível e a versão instalada seja 5.9*, será
+feito um downgrade do <literal/perl/.
+</simpara></listitem>
+<listitem><simpara>Uma instância de qualquer pacote que não <literal/perl/
+que esteja disponível no sistema local possui prioridade sobre outras
+instâncias, mesmo instâncias pertencentes a versão alvo.
+</simpara></listitem>
+<listitem><simpara>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 "<literal/unstable/" é instalada somente
+caso a mesma seja selecionada para instalação e nenhuma instância do
+pacote já esteja instalada.
+</simpara></listitem>
+</itemizedlist>
+</para>
+</RefSect2>
+
+<RefSect2><Title>Determinação da Versão do Pacote e Propriedades de Distribuição</Title>
+
+<para>As localidades listadas em um arquivo &sources-list; de um sistema
+devem fornecer arquivos <filename>Package</filename> e
+<filename>Release</filename> para descrever as instâncias de pacote
+disponíveis nestas localidades.
+</para>
+
+<para>O arquivo <filename>Packages</filename> é nromalmente encontrado no
+diretório <filename>.../dists/<replaceable>nome-distribuição</replaceable>/<replaceable>componente</replaceable>/<replaceable>arquitetura</replaceable></filename> :
+por exemplo, <filename>.../dists/stable/main/binary-i386/Packages</filename>.
+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 :
+<variablelist>
+<varlistentry>
+<term>a linha <literal/Package:/</term>
+<listitem><simpara>informa o nome do pacote</simpara></listitem>
+</varlistentry>
+<varlistentry>
+<term>a linha <literal/Version:/</term>
+<listitem><simpara>informa o número de versão do pacote</simpara></listitem>
+</varlistentry>
+</variablelist>
+</para>
+
+<para>O arquivo <filename>Release</filename> é normalmente encontrado no
+diretório
+<filename>.../dists/<replaceable>nome-distribuição</replaceable></filename> :
+por exemplo, <filename>.../dists/stable/Release</filename>,
+ou <filename>.../dists/woody/Release</filename>.
+O arquivo consiste de um registro de múltiplas linhas o qual se aplica a
+<emphasis/todas/ as instâncias de pacote na àrvore de diretórios abaixo
+de seu diretório pai. Diferente do arquivo <filename/Packages/, quase
+todas as linhas em um arquivo <filename/Release/ são relevantes para a
+definição de prioridades do APT :
+
+<variablelist>
+<varlistentry>
+<term>a linha <literal/Archive:/</term>
+<listitem><simpara>dá nome ao repositório para o qual as instâncias de
+pacote na àrvore de diretório pertencem. Por exemplo, a linha
+<literal/Archive: stable/ especifica que todos os pacotes na àrvore de
+diretório abaixo do diretório pai do arquivo <filename/Release/ estão
+no respositório <literal/stable/.  Especificar esse valor no arquivo de
+preferências do APT iria requerer a linha :
+</simpara>
+
+<programlisting>
+Pin: release a=stable
+</programlisting>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>a linha <literal/Version:/</term>
+<listitem><simpara>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.
+</simpara>
+
+<programlisting>
+Pin: release v=3.0
+Pin: release a=stable v=3.0
+Pin: release 3.0
+</programlisting>
+
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>a linha <literal/Component:/</term>
+<listitem><simpara>dá nome ao componente de licenciamento associado com
+as instâncias de pacote na àrvore de diretório do arquivo
+<filename/Release/. Por exemplo, a linha <literal/Component: main/
+especifica que todas as instâncias na àrvore de diretório são do
+componente <literal/main/, o que significa que as mesmas estão
+licenciadas sob os termos da Linhas Guias Debian para o Software Livre
+(a DFSG). Especificar esse componente no arquivo de preferências do APT
+iria requerer a linha :
+</simpara>
+
+<programlisting>
+Pin: release c=main
+</programlisting>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>a linha <literal/Origin:/</term>
+<listitem><simpara>dá nome ao produtor das instâncias de pacote na
+àrvore de diretório do arquivo <filename/Release/. O mais comum é esse
+valor ser <literal/Debian/.  Especificar essa origem no arquivo de
+preferências do APT iria requerer a linha :
+</simpara>
+
+<programlisting>
+Pin: release o=Debian
+</programlisting>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>a linha <literal/Label:/</term>
+<listitem><simpara>parece redundante. 
+seems redundant. O mais comum é esse valor ser <literal/Debian/.
+Especificar esse rótulo (label) no arquivo de preferências do APT
+iria requerer a linha :
+</simpara>
+
+<programlisting>
+Pin: release l=Debian
+</programlisting>
+</listitem>
+</varlistentry>
+</variablelist>
+</para>
+
+<para>Todos os arquivos <filename>Packages</filename> e
+<filename>Release</filename> obtidos das localidades listadas no arquivo
+&sources-list; são mantidos no diretório
+<filename>/var/lib/apt/lists</filename> ou no arquivo indicado pela variável
+<literal/Dir::State::Lists/ no arquivo <filename/apt.conf/.
+Por exemplo, o arquivo
+<filename>debian.lcs.mit.edu_debian_dists_unstable_contrib_binary-i386_Release</filename>
+contém o arquivo <filename>Release</filename> obtido do site
+<literal/debian.lcs.mit.edu/ para a arquitetura <literal/binary-i386/,
+arquivos do componente <literal/contrib/ da distribuição <literal/unstable/.
+</para>
+
+</RefSect2>
+
+<RefSect2><Title>Linhas Opcionais em um Registro de Preferências do APT</Title>
+
+<para>Cada registro em um arquivo de preferências do APT pode
+opcionalmente iniciar com uma ou mais linhas iniciadas com a palavra
+<literal/Explanation:/. Isto oferece uma oportunidade de se comentar
+sobre o registro.
+</para>
+
+<para>A linha <literal/Pin-Priority:/ em cada registro de preferências do
+APT é opcional. Caso omitida, o APT atribuirá uma prioridade de 1 menos o
+último valor especificado em uma linha iniciando com
+<literal/Pin-Priority: release .../.
+</para>
+</RefSect2>
+</RefSect1>
+
+<RefSect1><Title>Exemplos</>
+<RefSect2><Title>Acompanhando a Stable</Title>
+
+<para>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 <literal/stable/ e uma
+prioridade proibitivamente baixa para versões de pacotes pertencentes a
+outras distribuições <literal/Debian/.
+
+<programlisting>
+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
+</programlisting>
+</para>
+
+<para>
+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) <literal/stable/.
+
+<programlisting>
+apt-get install <replaceable>nome-pacote</replaceable>
+apt-get upgrade
+apt-get dist-upgrade
+</programlisting>
+</para>
+
+<para>O comando a seguir fará com que o APT atualize o pacote
+especificado para a última versão da distribuição <literal/testing/;
+porém, atualizações futuras não irão ocorrer automaticamente.
+
+<programlisting>
+apt-get install <replaceable>pacote</replaceable>/testing
+</programlisting>
+</RefSect2>
+
+ <RefSect2><Title>Acompanhando a Testing</Title>
+
+<para>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
+<literal/testing/, uma prioridade menor para versões de pacotes da
+distribuição <literal/unstable/ e uma prioridade proibitivamente baixa
+para versões de pacotes de outras distribuições <literal/Debian/.
+
+<programlisting>
+Package: *
+Pin: release a=testing
+Pin-Priority: 900
+
+Package: *
+Pin: release a=unstable
+Pin-Priority: 800
+
+Package: *
+Pin: release o=Debian
+Pin-Priority: -10
+</programlisting>
+</para>
+
+<para>
+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) <literal/testing/.
+
+<programlisting>
+apt-get install <replaceable>nome-pacote</replaceable>
+apt-get upgrade
+apt-get dist-upgrade
+</programlisting>
+</para>
+
+<para>O comando a seguir fará com que o APT atualize o pacote
+especificado para a última versão da distribuição <literal/unstable/.
+Assim, o comando <command>apt-get dist-upgrade</command> e os outros
+<emphasis/farão/ com que o pacote seja atualizado para a última versão
+<literal/unstable/.
+
+<programlisting>
+apt-get install <replaceable>pacote</replaceable>/unstable
+</programlisting>
+</para>
+
+</RefSect2>
+</RefSect1>
+
+ <RefSect1><Title>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 000000000..4c9ea6293
--- /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)