<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" 
"dtd/kdex.dtd" [
  <!ENTITY kappname "&kpackage;">
  <!ENTITY package "kdeadmin">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Portuguese "INCLUDE"
> <!-- change language only here -->
]>

<book lang="&language;">
<bookinfo>
<title
>O Manual do &kpackage;</title>
<authorgroup>
<author
><firstname
>Toivo</firstname
> <surname
>Pedaste</surname
> <affiliation
> <address
><email
>toivo@ucs.uwa.edu.au</email
></address>
</affiliation>
</author>

<othercredit role="reviewer"
><firstname
>Lauri</firstname
> <surname
>Watts</surname
> <affiliation
> <address
><email
>lauri@kde.org</email
></address>
</affiliation>
<contrib
>Revisão</contrib>
</othercredit>
<othercredit role="translator"
><firstname
>José</firstname
><surname
>Pires</surname
><affiliation
><address
><email
>jncp@netcabo.pt</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
> 
</authorgroup>

<copyright>
<year
>2000</year>
<holder
>Toivo Pedaste</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2006-12-04</date>
<releaseinfo
>3.5.5</releaseinfo>

<abstract
><para
>O &kpackage; é uma interface gráfica para os gestores de pacotes <acronym
>RPM</acronym
>, Debian, Slackware e BSD.</para
></abstract>

<keywordset>
<keyword
>kpackage</keyword>
<keyword
>pacote</keyword>
<keyword
>gestor de pacotes</keyword>
<keyword
>RPM</keyword>
<keyword
>deb</keyword>
</keywordset>
</bookinfo>

<chapter id="introduction">
<title
>Introdução</title>

<para
>O &kpackage; é uma interface gráfica para os gestores de pacotes <acronym
>RPM</acronym
>, Debian, Slackware e <acronym
>BSD</acronym
>. O &kpackage; faz parte do Ambiente de Trabalho K e, por consequência, está desenhado para se integrar no gestor de ficheiros do &kde;. </para>

</chapter>

<chapter id="onscreen-fundamentals">

<title
>Fundamental da Interface</title>

<para
>O &kpackage; tem dois painéis. O painel esquerdo mostra uma árvore com os pacotes instalados e disponíveis, enquanto o painel direito mostra alguma informação sobre os pacotes.</para>


<sect1 id="the-main-window-left">
<title
>A Janela Principal - Árvore de Pacotes</title>

<para
>Quando o &kpackage; é iniciado normalmente (isto é, não foi invocado através de arrastamento para o mesmo e não lhe foi indicado nenhum parâmetro), ele mostra dois painéis com a árvore de pacotes à esquerda; esta árvore mostra os pacotes instalados e pode mostrar também os pacotes novos e actualizados.</para>

<screenshot>
<screeninfo
>O Painel Esquerdo do &kpackage;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="left.png" format="PNG"/> </imageobject>
<textobject>
<phrase
>Painel Esquerdo - Árvore de Pacotes</phrase>
</textobject>
<caption>
<para
>Painel Esquerdo - Árvore de Pacotes</para>
</caption>
</mediaobject>
</screenshot>

<para
>O painel à esquerda mostra a lista dos pacotes e as páginas em cima determinam quais os pacotes que são mostrados:</para>

<itemizedlist>

<listitem
><para
><guilabel
>Instalados</guilabel
> - Mostra os pacotes instalados</para
></listitem>

<listitem
><para
><guilabel
>Actualizados</guilabel
> - Mostra os pacotes para os quais estão disponíveis novas versões</para
></listitem>

<listitem
><para
><guilabel
>Novos</guilabel
> - Mostra os pacotes não instalados</para
></listitem>

<listitem
><para
><guilabel
>Todos</guilabel
> - Todos os pacotes</para
></listitem>

</itemizedlist>
<para
>Por baixo das páginas, encontra-se a linha <guilabel
>Procurar</guilabel
>, que filtra a árvore de pacotes, de modo que só os pacotes, cujo nome ou resumo contenha o texto procurado, sejam apresentados.</para>

<para
>A árvore de pacotes baseia-se nas secções da distribuição e mostra uma informação de resumo sobre os pacotes:</para>
<itemizedlist>

<listitem
><para
><guilabel
>Pacote</guilabel
> - Nome do pacote</para
></listitem>
<listitem
><para
><guilabel
>Marcado</guilabel
> - Mostra um sinal se o pacote foi marcado. A marcação permite instalar ou desinstalar vários pacotes de uma vez, usando os botões por baixo da árvore de pacotes.</para
></listitem>
<listitem
><para
><guilabel
>Resumo</guilabel
> - Uma breve descrição do pacote.</para
></listitem>
<listitem
><para
><guilabel
>Tamanho</guilabel
>- O tamanho do pacote</para
></listitem>
<listitem
><para
><guilabel
>Versão</guilabel
> - A versão do pacote</para
></listitem>
<listitem
><para
><guilabel
>Versão Antiga</guilabel
> - Se o pacote actualiza a versão antiga de um pacote</para
></listitem>

</itemizedlist>

<para
>Os pacotes têm legendas gráficas para indicar o seu estado, uma imagem que represente o tipo de pacote significa que o pacote está instalado, um <guilabel
>D</guilabel
> indica um pacote disponível e um <guilabel
>A</guilabel
> corresponde a um pacote que pode actualizar um outro já instalado.</para>

<para
>Pode seleccionar um único pacote se carregar no seu nome. Se carregar no ponto na coluna <guilabel
>Marca</guilabel
>, assinala o pacote, enquanto que ao carregar segunda vez remove a marca; para além disso o <keycombo action="simul"
>&Shift;<mousebutton
>botão esquerdo</mousebutton
> </keycombo
> pode ser usado para seleccionar um conjunto de pacotes e o <keycombo action="simul"
>&Ctrl;<mousebutton
>esquerdo</mousebutton
></keycombo
> poderá também ser usado para adicionar e remover marcas nos pacotes.</para>

<para
>Ao seleccionar um pacote na árvore obtém as suas informações no painel direito.</para>

</sect1>

<sect1 id="package-information-panel">
<title
>A Janela Principal - Painel de Informação do Pacote</title>

<para
>O painel direito tem botões para apresentar dois tipos diferentes de informação acerca dos pacotes seleccionados </para>

<itemizedlist>
<listitem>
<screenshot>
<screeninfo
>O Painel Direito do &kpackage; - Propriedades</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="right-prop.png" format="PNG"/> </imageobject>
<textobject>
<phrase
>Painel Direito - Propriedades do Pacote</phrase>
</textobject>
<caption>
<para
>O botão <guilabel
>Propriedades</guilabel
>, que mostra algumas informações sobre o pacote seleccionado. Na informação de dependências existem hiperligações para os pacotes listados, em que os pacotes instalados estão representados com uma letra normal, os não instalados estão em itálico e as dependências que não estejam disponíveis em texto normal.</para>
</caption>
</mediaobject>
</screenshot>
</listitem>

<listitem>

<screenshot>
<screeninfo
>O Painel Direito do &kpackage; - Propriedades</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="right-files.png" format="PNG"/> </imageobject>
<textobject>
<phrase
>Painel Direito - Os Ficheiros no Pacote</phrase>
</textobject>
<caption>
<para
>O botão <guilabel
>Lista de Ficheiros</guilabel
> mostra os ficheiros no pacote e para os pacotes instalados mostra o estado dos ficheiros. Os ficheiros existentes tem uma marca de confirmação, os que faltarem têm uma cruz.</para>

</caption>
</mediaobject>
</screenshot>

</listitem>

<listitem>
<screenshot>
<screeninfo
>O Painel Direito do &kpackage; - Propriedades</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="right-change.png" format="PNG"/> </imageobject>
<textobject>
<phrase
>Painel Direito - Os Ficheiros no Pacote</phrase>
</textobject>
<caption>
<para
>O botão <guilabel
>Registo de Alterações</guilabel
> mostra o texto do registo de alterações do pacote.</para>
</caption>
</mediaobject>
</screenshot>

</listitem>

</itemizedlist>

</sect1>

<sect1 id="installing-packages">
<title
>Instalar Pacotes</title>

<para
>Para instalar um pacote, poderá</para>
<itemizedlist>
<listitem>
<para
>localizar o pacote que deseja instalar no &konqueror; e arrastá-lo para uma instância a correr do &kpackage;</para>
</listitem>
<listitem>
<para
>carregar num ficheiro de pacote no &konqueror; e iniciar uma nova instância do &kpackage;</para>
</listitem>
<listitem>
<para
>usar os itens do menu <guimenu
>Abrir</guimenu
> no &kpackage;</para>
</listitem>
<listitem>
<para
>seleccionar um pacote disponível na árvore de pacotes</para>
</listitem>
</itemizedlist>

<para
>Para um pacote seleccionado, usando os botões no painel direito, o botão <guibutton
>Obter</guibutton
> irá obter o pacote de uma fonte remota e mostrar a informação sobre o mesmo; o botão <guibutton
>Instalar</guibutton
> abrirá a janela de instalação. </para>

<para
>Para os pacotes marcados, usando os botões no painel esquerdo, o botão <guibutton
>Instalar os Marcados</guibutton
> faz aparecer a janela de instalação.</para>

<screenshot>
<screeninfo
>Janela de instalação do &kpackage;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="install.png" format="PNG"/> </imageobject>
<textobject>
<phrase
>Janela de Instalação</phrase>
</textobject>
<caption>
<para
>Janela de Instalação</para>
</caption>
</mediaobject>
</screenshot>

<para
>A janela de instalação indica os pacotes que podem ser seleccionados para ser instalados num painel em cima e à esquerda; se o <acronym
>APT</acronym
> da Debian estiver a ser usado, também são mostrados os pacotes necessários para satisfazer todas as dependências. Por baixo disto existe um conjunto de opções que configuram o programa de instalação. Para os pacotes <acronym
>RPM</acronym
> as opções são:</para>
<itemizedlist>
<listitem>
<para
><guilabel
>Actualizar</guilabel
> - Irá actualizar qualquer pacote já instalado.</para>
</listitem>
<listitem>
<para
><guilabel
>Substituir os Ficheiros</guilabel
> - Instala os pacotes mesmo que estes substituam os ficheiros de outros pacotes já instalados.</para>
</listitem>
<listitem>
<para
><guilabel
>Verificar as Dependências</guilabel
> - Analisa as dependências existentes.</para>
</listitem>
<listitem>
<para
><guilabel
>Testar (não instalar)</guilabel
></para>
</listitem>
</itemizedlist>

<para
>Para o <acronym
>APT</acronym
> da Debian, as opções são:</para>
<itemizedlist>
<listitem>
<para
><guilabel
>Obter apenas</guilabel
> - Transfere os pacotes mas não os instala.</para>
</listitem>
<listitem>
<para
><guilabel
>Sem transferir</guilabel
> - Só usa os pacotes que estão disponível localmente</para>
</listitem>
<listitem>
<para
><guilabel
>Ignorar em falta</guilabel
> - Faz a instalação mesmo que faltem alguns pacotes</para>
</listitem>
<listitem>
<para
><guilabel
>Ignorar em espera</guilabel
> - Ignora as esperas que foram colocadas nos pacotes</para>
</listitem>
<listitem>
<para
><guilabel
>Permitir Não Autenticados</guilabel
> - Ignora os requisitos de assinatura dos pacotes.</para>
</listitem>
<listitem>
<para
><guilabel
>Assumir que sim</guilabel
> - Responde que sim a todas as perguntas que o programa de instalação faça.</para>
</listitem>
<listitem>
<para
><guilabel
>Testar (não instalar)</guilabel
></para>
</listitem>
</itemizedlist>

<para
>O botão <guibutton
>Instalar</guibutton
> irá iniciar a instalação de facto. Normalmente a janela de instalação será fechada após uma instalação com sucesso mas, se a opção <guibutton
>Manter esta janela</guibutton
> estiver seleccionada, a janela irá permanecer.</para>

<para
>O painel à direita é uma janela de terminal integrada, na qual os programas de instalação são corridos; para os programas de instalação interactiva esta interacção é feita nesta janela. </para>

</sect1>

<sect1 id="uninstalling-packages">
<title
>Desinstalar Pacotes</title>

<para
>Um pacote seleccionado pode ser desinstalado se usar o botão <guibutton
>Desinstalar</guibutton
> no painel direito; o botão <guibutton
>Desinstalar os Marcados</guibutton
> no painel direito poderá ser usado para desinstalar os pacotes marcados. Os botões fazem aparecer a janela de desinstalação.</para>

<screenshot>
<screeninfo
>Janela de instalação do &kpackage;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="uninstall.png" format="PNG"/> </imageobject>
<textobject>
<phrase
>Janela de Desinstalação</phrase>
</textobject>
<caption>
<para
>Janela de Desinstalação</para>
</caption>
</mediaobject>
</screenshot>

<para
>O botão <guibutton
>Desinstalar</guibutton
> na janela fará com que os pacotes sejam desinstalados; o painel direito disponibiliza uma janela de terminal integrada para os programas de desinstalação.</para>

<para
>Para os pacotes <acronym
>RPM</acronym
> as opções são:</para>
<itemizedlist>
<listitem>
<para
><guilabel
>Usar os programas</guilabel
> - Executa todos os programas de desinstalação</para>
</listitem>
<listitem>
<para
><guilabel
>Verificar as Dependências</guilabel
> - Analisa as dependências existentes.</para>
</listitem>
<listitem>
<para
><guilabel
>Testar (não desinstalar)</guilabel
></para>
</listitem>
</itemizedlist>

<para
>Para o <acronym
>APT</acronym
> da Debian, as opções são:</para>
<itemizedlist>
<listitem>
<para
><guilabel
>Limpar a Configuração</guilabel
> - Remove todos os ficheiros de configuração do pacote.</para>
</listitem>
<listitem>
<para
><guilabel
>Assumir que sim</guilabel
> - Responde que sim a todas as perguntas que o programa de instalação faça.</para>
</listitem>
<listitem>
<para
><guilabel
>Testar (não desinstalar)</guilabel
></para>
</listitem>
</itemizedlist>


</sect1>

<sect1 id="integrating-available-packages-in-the-tree">
<title
>Integrar os pacotes disponíveis na árvore</title>

<para
>O acesso aos pacotes disponíveis é definido através das opções do menu <menuchoice
><guimenu
>Configuração</guimenu
><guimenuitem
>Configurar o &kpackage;....</guimenuitem
></menuchoice
>. </para>


<screenshot>
<screeninfo
>Janela de instalação do &kpackage;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="handle.png" format="PNG"/> </imageobject>
<textobject>
<phrase
>Painel do Gestor de Pacotes</phrase>
</textobject>
<caption>
<para
>Painel do Gestor de Pacotes </para>
</caption>
</mediaobject>
</screenshot>

<para
>A parte de cima do painel tem a opção <guilabel
>Máquina Remota</guilabel
> que permite ao &kpackage; lidar com os pacotes numa máquina remota; esta funcionalidade necessita do <command
>ssh</command
> e só está disponível ao usar o APT da Debian. O nome do computador remoto é indicado na lista e o &kpackage; irá aceder a este quando a opção <guilabel
>Usar uma máquina remota</guilabel
> estiver seleccionada.</para>

<para
>O resto do painel permite a activação e desactivação dos vários tipos de pacotes que o &kpackage; consegue tratar. Se um determinado tipo de pacote estiver activo o botão  <guibutton
>Localização dos Pacotes</guibutton
> fará aparecer uma janela onde se poderá indicar a localização dos pacotes disponíveis. Se os programas necessários para lidar com um determinado tipo de pacote não estiver disponível, o tipo de pacote ficará automaticamente desactivado. </para>

<screenshot>
<screeninfo
>Janela de instalação do &kpackage;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="rpmloc.png" format="PNG"/> </imageobject>
<textobject>
<phrase
>Janela de Localização do RPM</phrase>
</textobject>
<caption>
<para
>Janela de Localização do RPM</para>
</caption>
</mediaobject>
</screenshot>

<para
>Para os pacotes <acronym
>RPM</acronym
>, o &kpackage; pode ler uma pasta que contenha pacotes e adiciona-os à árvore de pacotes, quer como pacotes novos quer como actualizados. É possível examiná-los ou instalá-los a partir da árvore de pacotes. Por omissão, a informação sobre os pacotes é extraída a partir do formato normal dos nomes dos ficheiros e assim é necessário usar o botão <guibutton
>Examinar</guibutton
> para ver a descrição completa. Contudo, é possível definir uma opção de maneira que, para as pastas locais, seja lido cada um dos pacotes; isto é mais lento mas obtém-se uma descrição completa.</para>

<para
>A janela de localizações do <acronym
>RPM</acronym
> permite a indicação das pastas que contêm os pacotes <acronym
>RPM</acronym
>; é dividida num conjunto de painéis em páginas para uma maior conveniência de gestão. Cada linha do painel corresponde a uma pasta, e se a opção <guilabel
>Usar</guilabel
> estiver seleccionada, a pasta é usada; caso contrário, é ignorada. O campo de texto poderá conter a referência a uma pasta ou um URL de <command
>FTP</command
>. A opção <guilabel
>Sub-pastas</guilabel
> indica se são procurados pacotes nas suas subpastas. O botão <guibutton
>...</guibutton
> fará aparecer uma janela de selecção das pastas.</para>


<screenshot>
<screeninfo
>Janela de instalação do &kpackage;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="debaptloc.png" format="PNG"/> </imageobject>
<textobject>
<phrase
>Janela de Localização do APT da Debian</phrase>
</textobject>
<caption>
<para
>Janela de Localização do APT da Debian</para>
</caption>
</mediaobject>
</screenshot>

<para
>O <guilabel
>APT: Debian</guilabel
> significa que os pacotes da Debian são tratados usando o comando <command
>deb-apt</command
>, o qual poderá ir buscar automaticamente os pacotes dos repositórios e resolver as dependências.</para>

<para
>A localização dos repositórios pacotes não instalados pode ser definida no painel "A"; este é usado para gravar o ficheiro <filename
>/etc/apt/sources.list</filename
>, o qual controla onde o <command
>deb-apt</command
> irá procurar por pacotes, e onde cada registo corresponde a uma linha do ficheiro; se a opção <guilabel
>Usar</guilabel
> não estiver assinalada, a linha é comentada.</para>

<para
>O painel "D" permite especificar a localização das pastas que contenham pacotes da Debian.</para>

<screenshot>
<screeninfo
>Janela de instalação do &kpackage;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="debloc.png" format="PNG"/> </imageobject>
<textobject>
<phrase
>Janela de Localização do DPKG da Debian: painéis L e P</phrase>
</textobject>
<caption>
<para
>Janela de Localização do DPKG da Debian: painéis L e P</para>
</caption>
</mediaobject>
</screenshot>


<para
>DPKG: Debian significa que os pacotes são geridos através do <command
>dpkg</command
>; existem três maneiras de aceder aos pacotes disponíveis, em que estes podem ser seleccionados a partir de três painéis de tipos de localização. </para>

<itemizedlist>
<listitem>
<para
>O painel "I" indica a localização da árvore de pacotes da Debian e selecciona a distribuição e arquitectura. O &kpackage; irá procurar nos locais normais pelos ficheiros Package que descrevem os pacotes disponíveis, e então estes pacotes são então adicionados à respectiva árvore e podem assim ser examinados ou instalados</para>
</listitem
> 
<listitem>
<para
>O painel "P" indica a localização da distribuição Debian, assim como os ficheiros Packages para os componentes de interesse da distribuição. Se o programa <command
>dselect</command
> for usado, então o ficheiro <filename
>/var/lib/dpkg/available</filename
> pode ser usado como um ficheiro <filename
>Packages</filename
> que descreve a distribuição que o <command
>dselect</command
> usa.</para>
</listitem>
<listitem
><para
>O painel "D" indica as pastas de pacotes podem ser tratadas da mesma maneira que os pacotes <acronym
>RPM</acronym
>.</para
></listitem>
</itemizedlist>

<screenshot>
<screeninfo
>Janela de instalação do &kpackage;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="slackloc.png" format="PNG"/> </imageobject>
<textobject>
<phrase
>Janela de Localização do Slackware</phrase>
</textobject>
<caption>
<para
>Janela de Localização do Slackware</para>
</caption>
</mediaobject>
</screenshot>

<para
>Para os pacotes da Slackware existe pouca informação armazenada nos pacotes instalados, mas é possível usar um ficheiro <filename
>PACKAGE.TXT</filename
> como uma fonte de informação acerca dos pacotes instalados. O ficheiro <filename
>PACKAGES.TXT</filename
> é o equivalente de um ficheiro Packages da Debian e as distribuições da Slackware são estruturadas numa árvore de pacotes contendo os pacotes <literal role="extension"
>.tgz</literal
> e um ficheiro <filename
>PACKAGES.TXT</filename
> que descreve os pacotes.</para>

<para
>Assim como nas distribuições da Debian, os pacotes numa distribuição Slackware podem ser integrados na árvore de pacotes. Infelizmente, os pacotes do Slackware não trazem informação sobre a versão, de maneira que não é possível determinar se um pacote disponível é mais recente que outro que esteja instalado.</para>

<itemizedlist>
<listitem
><para
>O painel "I" é a localização dum ficheiro <filename
>PACKAGES.TXT</filename
> que é usado para fornecer informações sobre os pacotes instalados</para
></listitem>
<listitem
><para
>Os painéis "P" podem ser usados para indicar a localização das distribuições com a árvore de pastas que contêm os ficheiros <filename
>.tgz</filename
> e a localização do ficheiro <filename
>PACKAGES.TXT</filename
> correspondente.</para
></listitem>
<listitem
><para
>Os painéis "D" são para as pastas que <emphasis
>não</emphasis
> têm um ficheiro <filename
>PACKAGES.TXT</filename
> correspondente</para
></listitem>
</itemizedlist>

<screenshot>
<screeninfo
>Janela de instalação do &kpackage;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="bsdloc.png" format="PNG"/> </imageobject>
<textobject>
<phrase
>Janela de Localização do BSD</phrase>
</textobject>
<caption>
<para
>Janela de Localização do BSD</para>
</caption>
</mediaobject>
</screenshot>

<para
>Para os pacotes do <acronym
>BSD</acronym
>, o &kpackage; irá procurar por uma pasta da distribuição que contenha um ficheiro <filename
>INDEX</filename
> (que descreve todos os pacotes) e que contém também uma pasta <filename
>All</filename
> (com todos os ficheiros de pacotes nela). </para>

<para
>O painel "Portos" indica a localização da árvore dos portos no sistema de ficheiros </para>
<para
>O painel "Pacotes" permite indicar a localização das pastas de pacotes, ou seja, aquelas que contêm ficheiros <filename
>INDEX</filename
></para>

<para
>Para as pastas e ficheiros de pacotes remotos (ou seja, aqueles obtidos por &FTP;) o &kpackage; irá usar uma 'cache', onde os pacotes são colocados em <filename
>~/.kpackage</filename
> e as pastas em <filename
>~/.kpackage/dir</filename
>.</para>

<note
><para
>Para o tratamento de pastas remotas (&FTP;) funcionar, poderá ser necessário desligar a opção <guilabel
>'Proxy' de FTP </guilabel
> nas Opções do Navegador.</para
></note>

</sect1>

<sect1 id="Searching">
<title
>Pesquisa</title>
<sect2>
<title
>Linha de Procura de Pacotes</title>

<screenshot>
  <screeninfo
>Linha de Procura do &kpackage;</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="searchl.png" format="PNG"/> </imageobject>
    <textobject>
      <phrase
>Linha de Procura</phrase>
    </textobject>
    <caption>
      <para
>Linha de Procura</para>
    </caption>
  </mediaobject>
</screenshot>

<para
>A linha de Procura filtra a árvore de pacotes, de modo a que só os pacotes, cujo nome ou resumo contenha o texto procurado, sejam apresentados.</para>
</sect2>


<sect2>
  <title
>Procurar um Pacote</title>
  
  <screenshot>
    <screeninfo
>Procurar um Pacote do &kpackage;</screeninfo>
    <mediaobject>
      <imageobject>
	<imagedata fileref="search.png" format="PNG"/> </imageobject>
      <textobject>
	<phrase
>Procurar um Pacote</phrase>
      </textobject>
      <caption>
	<para
>Procurar um Pacote</para>
	</caption>
      </mediaobject>
    </screenshot>
    
    <para
>A janela para <guilabel
>Procurar um Pacote</guilabel
> pesquisa os nomes dos pacotes na árvore e salta para o próximo pacote correspondente. Se o <guilabel
>Sub-texto</guilabel
> não estiver assinalado, então só serão apresentadas correspondências exactas para os nomes dos pacotes. Se a opção <guilabel
>Procura geral</guilabel
> não estiver activada, a procura não dará a volta no caso de chegar ao fim da árvore de pacotes. </para>
</sect2>

<sect2>
  <title
>Procurar um Ficheiro</title>
  
  <screenshot>
    <screeninfo
>Procurar um Ficheiro do &kpackage;</screeninfo>
    <mediaobject>
      <imageobject>
	<imagedata fileref="searchf.png" format="PNG"/> </imageobject>
      <textobject>
	<phrase
>Procurar um Ficheiro</phrase>
      </textobject>
      <caption>
	<para
>Procurar um Ficheiro</para>
      </caption>
    </mediaobject>
  </screenshot>
  
  <para
>A janela para <guilabel
>Procurar um Ficheiro</guilabel
> pesquisa nos ficheiros as ocorrências que contenham o texto de procura. As colunas apresentadas são:</para>
    <itemizedlist>
      <listitem>
	<para
><guilabel
>Instalados</guilabel
> - Assinalado se for um pacote instalado.</para>
      </listitem>
      <listitem>
	<para
><guilabel
>Tipo</guilabel
> - O tipo do pacote.</para>
      </listitem>
      <listitem>
	<para
><guilabel
>Pacote</guilabel
> - O nome do pacote</para>
      </listitem>
      <listitem>
	<para
><guilabel
>Nome do ficheiro</guilabel
> - O nome do ficheiro correspondente</para>
      </listitem>
    </itemizedlist>
    <para
>Só os ficheiros nos pacotes instalados é que são mostrados, a menos que a opção <guilabel
>Também procurar pacotes não instalados</guilabel
> esteja activa; isto só irá funcionar com os pacotes do APT da Debian e só se o comando <command
>apt-file</command
> estiver instalado. A base de dados utilizada pelo comando <command
>apt-file</command
> é actualizada pelo item do menu <guimenuitem
>Actualização de ficheiro Apt</guimenuitem
>. </para>

</sect2>


</sect1>

<sect1 id="Misc">
  <title
>Diversos</title>
  <sect2>
    <title
>Acesso de Root</title>

    <para
>O &kpackage; precisa de acesso como <systemitem class="username"
>root</systemitem
> para instalar/desinstalar os pacotes; isto pode ser feito se correr o &kpackage; como <systemitem class="username"
>root</systemitem
>, por exemplo, através do &kdesu;.</para>

    <para
>Em alternativa, se o &kpackage; está a correr com um utilizador normal, ele irá tentar correr os programas de instalação/desinstalação como 'root', ligando-se através dum pseudo-terminal onde usa o <command
>su</command
>, o <command
>sudo</command
> ou o <command
>ssh</command
> para fazer isto. Se necessário, fará aparecer uma janela de terminal onde a senha de <systemitem class="username"
>root</systemitem
> pode ser escrita ou a chave de <command
>ssh</command
> ser fornecida. Para isto funcionar, a linha de comandos do <systemitem class="username"
>root</systemitem
> tem de acabar em <prompt
>#</prompt
>. A opção <guimenuitem
>Manter a senha</guimenuitem
> faz com que o &kpackage; recorde a senha introduzida. </para>
  <screenshot>
    <screeninfo
>Linha de senha do &kpackage;</screeninfo>
    <mediaobject>
      <imageobject>
	<imagedata fileref="root-prompt.png" format="PNG"/> </imageobject>
      <textobject>
	<phrase
>Linha de senha</phrase>
      </textobject>
      <caption>
	<para
>Linha de senha</para>
      </caption>
    </mediaobject>
  </screenshot>

  </sect2>


  <sect2>
    <title
>Arrastar e Largar</title>

    <para
>O &kpackage; recorre ao protocolo do KDE para Arrastar e Largar ('Drag-and-Drop'). Isto significa que o utilizador poderá arrastar e largar pacotes no &kpackage; para os abrir. Se largar um ficheiro na janela "<guilabel
>Procurar Ficheiro</guilabel
>", ela irá procurar o pacote que contém o ficheiro.</para>

  </sect2>
</sect1>

</chapter>
<chapter id="menus">

<title
>Menus</title>

<para
>Isto descreve os menus do &kpackage;. </para>

<sect1 id="file-menu">
<title
>O menu <guimenu
>Ficheiro</guimenu
></title>

<para
>Os itens no menu <guimenu
>Ficheiro</guimenu
> são:</para>

<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
> &Ctrl;<keycap
>O</keycap
></keycombo
></shortcut
> <guimenu
>Ficheiro</guimenu
> <guimenuitem
>Abrir...</guimenuitem
></menuchoice
></term>
<listitem
><para
>Invoca o selector de ficheiros para os ficheiros locais e de &FTP;</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Ficheiro</guimenu
> <guisubmenu
>Abrir um Recente</guisubmenu
></menuchoice
></term>
<listitem
><para
>Uma lista com os ficheiros de pacotes abertos mais recentemente</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
> &Ctrl;<keycap
>F</keycap
></keycombo
></shortcut
> <guimenu
>Ficheiro</guimenu
><guimenuitem
>Procurar Pacote...</guimenuitem
></menuchoice
></term>
<listitem
><para
>Procura na lista de pacotes instalados por um pacote cujo nome contenha o texto introduzido </para
> </listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Ficheiro</guimenu
> <guimenuitem
>Procurar Ficheiro...</guimenuitem
></menuchoice
></term>
<listitem
><para
>Produz uma lista de pacotes que contêm o nome de ficheiro indicado, em que, se seleccionar uma linha, irá apresentar a informação sobre esse pacote. Isto comporta-se de maneira ligeiramente diferente para o <acronym
>RPM</acronym
> (onde o utilizador terá de indicar o nome do ficheiro exacto) e para o <acronym
>DEB</acronym
> (onde poderá introduzir uma expressão regular).</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycap
>F5</keycap
></shortcut
> <guimenu
>Ficheiro</guimenu
> <guimenuitem
>Recarregar</guimenuitem
></menuchoice
></term>
<listitem
><para
>Relê os dados dos pacotes e reconstrói a árvore de pacotes</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
> &Ctrl;<keycap
>Q</keycap
></keycombo
></shortcut
> <guimenu
>Ficheiro</guimenu
> <guimenuitem
>Sair</guimenuitem
></menuchoice
></term>
<listitem
><para
>Sai do &kpackage; </para
></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="packages-menu">
<title
>O menu <guimenu
>Pacotes</guimenu
></title>

<para
>Os itens no menu <guimenu
>Pacotes</guimenu
> são:</para>

<variablelist>
<varlistentry>
<term>
<menuchoice
><shortcut
> <keycombo action="simul"
> &Alt;<keycap
>Esquerda</keycap
> </keycombo
></shortcut
> <guimenu
>Pacotes</guimenu
> <guimenuitem
>Recuar</guimenuitem
></menuchoice
></term>
<listitem
><para
>Um botão para voltar atrás para navegar pelas hiperligações nas entradas de <guilabel
>Propriedades</guilabel
> no painel direito.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
> &Alt;<keycap
>Direita</keycap
> </keycombo
></shortcut
> <guimenu
>Pacotes</guimenu
> <guimenuitem
>Avançar</guimenuitem
></menuchoice
></term>
<listitem
><para
>Um botão para avançar na navegação pelas hiperligações nas entradas de <guilabel
>Propriedades</guilabel
> no painel direito.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Pacotes</guimenu
> <guimenuitem
>Expandir a Árvore</guimenuitem
></menuchoice
></term>
<listitem
><para
>Expande completamente a árvore de pacotes</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Pacotes</guimenu
> <guimenuitem
>Compactar a Árvore</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Fecha a árvore de pacotes, de modo que só a estrutura em árvore fique visível</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Pacotes</guimenu
> <guimenuitem
>Limpar os Marcados</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Retira as marcas de todos os pacotes</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Pacotes</guimenu
> <guimenuitem
>Marcar Tudo</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Marca todos os pacotes que sejam membros da janela seleccionada</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Pacotes</guimenu
> <guimenuitem
>Instalar</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Instala o pacote seleccionado no momento</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Pacotes</guimenu
> <guimenuitem
>Instalar os Marcados</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Instala todos os pacotes marcados</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Pacotes</guimenu
> <guimenuitem
>Desinstalar</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Desinstala o pacote seleccionado no momento</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Pacotes</guimenu
> <guimenuitem
>Desinstalar os Marcados</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Desinstala todos os pacotes marcados</para>
</listitem>
</varlistentry>


</variablelist>

</sect1>

<sect1 id="cache-menu">
<title
>O menu <guimenu
>'Cache'</guimenu
></title>

<para
>Os itens no menu <guimenu
>'Cache'</guimenu
> são: </para>
<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>'Cache'</guimenu
><guimenuitem
>Limpar a 'Cache' das Pastas de Pacotes</guimenuitem
></menuchoice
></term>
<listitem
><para
>Apaga as cópias em 'cache' das pastas de pacotes remotos e os ficheiros Packages</para
> </listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>'Cache'</guimenu
><guimenuitem
>Limpar a 'Cache' de Pacotes</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Apaga as cópias em 'cache' dos ficheiros de pacotes remotos que foram transferidos para a máquina local</para
> </listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="special-menu">
<title
>O menu <guimenu
>Especial</guimenu
></title>

<para
>O menu <guimenu
>Especial</guimenu
> contém as acções específicas de cada tipo de pacote:</para>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Especial</guimenu
><guimenuitem
> APT: Debian</guimenuitem
> </menuchoice
></term>
<listitem>

<variablelist>

<varlistentry>
<term
><guilabel
>Actualizar</guilabel
></term>
<listitem
><para
>Actualiza os índices <command
>apt</command
> dos repositórios de pacotes.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Actualizar</guilabel
></term>
<listitem
><para
>Actualiza a instalação da Debian para as últimas versões de todos os pacotes.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Corrigir</guilabel
></term>
<listitem
><para
>O <command
>apt</command
> é extremamente restrito acerca das dependências, tentando corrigir os problemas de dependências</para
></listitem>
</varlistentry>

<varlistentry>
  <term
><guilabel
>Actualização de Ficheiro Apt</guilabel
></term>
  <listitem
><para
>A procura dos ficheiros de desinstalação usa o comando <command
>apt-file</command
>, o qual actualiza a base de dados que o <command
>apt-file</command
> usa.</para
></listitem>
</varlistentry>

</variablelist>

</listitem>

</varlistentry>
</variablelist>

</sect1>

<sect1 id="settings-menu">
<title
>O menu <guimenu
>Configuração</guimenu
></title>

<para
>Os itens no menu <guimenu
>Configuração</guimenu
> são:</para>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Configuração</guimenu
><guimenuitem
>Mostrar a Barra de Ferramentas</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Liga ou desliga a barra de ferramentas</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configuração</guimenu
><guimenuitem
>Gravar a Configuração</guimenuitem
></menuchoice
></term>
<listitem
><para
>Grava as opções imediatamente</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configuração</guimenu
><guimenuitem
>Configurar os Atalhos...</guimenuitem
></menuchoice
></term>
<listitem
><para
>A janela normal do &kde; para configurar as teclas de atalho</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configuração</guimenu
><guimenuitem
>Configurar as Barras de Ferramentas...</guimenuitem
></menuchoice
></term>
<listitem
><para
>A janela normal do &kde; para configurar as barras de ferramentas</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configuração</guimenu
> <guimenuitem
>Configurar o &kpackage;...</guimenuitem
></menuchoice
></term>
<listitem>

<variablelist>
<varlistentry>
<term
><guilabel
>Tipos</guilabel
></term>
<listitem
><para
>Quais os tipos de pacotes a tratar; na Debian o uso do DPKG e do APT estão separados, não é uma boa ideia activá-los ao mesmo tempo. Também indica se deve aceder a uma máquina remota para o APT da Debian.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>'Cache'</guilabel
></term>
<listitem
><para
>Controla a utilização da 'cache' nas pastas e ficheiros Package remotos (por &FTP;).</para>
<variablelist>

<varlistentry>
<term
><guilabel
>Usar a 'Cache' para as Pastas dos Pacotes Remotos</guilabel
></term>
<listitem
><para
>Definir se se faz 'cache' das pastas e ficheiros Package remotos (por &FTP;).</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Usar a 'Cache' para os Pacotes Remotos</guilabel
></term>
<listitem
><para
>Definir se se faz 'cache' dos pacotes remotos que foram transferidos para a máquina local. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Pasta da 'Cache'</guilabel
></term>
<listitem
><para
>Onde colocar a 'cache' dos ficheiros e pastas de pacotes </para
></listitem>
</varlistentry>

</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>diversos</guilabel
></term>
<listitem>
<variablelist>

<varlistentry>
<term
><guilabel
>Executar os Comandos Privilegiados Com</guilabel
></term>
<listitem
><para
>Usar o <command
>ssh</command
>, o <command
>sudo</command
> ou o <command
>su</command
> para correr os comandos privilegiados. Para o APT de Debian remoto, o <command
>ssh</command
> será sempre usado.</para
> </listitem
> 
</varlistentry>

<varlistentry>
<term
><guilabel
>Verificar a lista de ficheiros</guilabel
></term>
<listitem
><para
>Se a opção estiver assinalada, a lista de ficheiros no pacote é analisada para ver se eles estão realmente instalados</para
> </listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Ler a informação de todos os ficheiros de pacotes locais</guilabel
></term>
<listitem
><para
>Se a opção estiver assinalada, todos os ficheiros duma pasta de pacotes (local) são lidos em vez de só se usar os nomes dos ficheiros; isto é mais lento, mas mostra mais informações.</para
></listitem>
</varlistentry>

</variablelist>

</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>


</variablelist>
</sect1>

<sect1 id="help-menu">
<title
>O menu <guimenu
>Ajuda</guimenu
></title>

<para
>Os itens no menu <guimenu
>Ajuda</guimenu
> são: </para>
&help.menu.documentation; </sect1>

<sect1 id="toolbar">
<title
>Barra de Ferramentas</title>

<itemizedlist>
<listitem
><para
><guiicon
>Abrir</guiicon
></para
></listitem>
<listitem
><para
><guiicon
>Recuar</guiicon
></para
></listitem>
<listitem
><para
><guiicon
>Avançar</guiicon
></para
></listitem>
<listitem
><para
><guiicon
>Expandir a Árvore</guiicon
></para
></listitem>
<listitem
><para
><guiicon
>Compactar a Árvore</guiicon
></para
></listitem>
<listitem
><para
><guiicon
>Procurar um Pacote</guiicon
></para
></listitem>
<listitem
><para
><guiicon
>Procurar um Ficheiro</guiicon
></para
></listitem>
<listitem
><para
><guiicon
>Actualizar</guiicon
></para
></listitem>
</itemizedlist>
</sect1>
</chapter>

<chapter id="credits-and-licenses">
<title
>Créditos e Licenças</title>

<para
>&kpackage; </para>

<para
>Documentação copyright 2005 Toivo Pedaste <email
>toivo@ucs.uwa.edu.au</email
></para>
<para
>Tradução de José Nuno Pires <email
>jncp@netcabo.pt</email
></para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Instalação</title>

<sect1 id="how-to-obtain-kpackage">
<title
>Como obter o &kpackage;</title>
&install.intro.documentation; <para
>Para mais informações sobre como obtê-lo e compilá-lo, convém ver o URL <ulink url="http://www.kde.org/install-source.html"
>http://www.kde.org/install-source.html</ulink
></para>

<para
>Existe mais informação sobre como compilar em <ulink url="http://www.kde.org/compilationfaq.html"
>http://www.kde.org/compilationfaq.html</ulink
></para>

<para
>Existe uma página Web em <ulink url="http://www.general.uwa.edu.au/u/toivo/kpackage"
>http://www.general.uwa.edu.au/u/toivo/kpackage</ulink
></para>

</sect1>

<sect1 id="requirements">
<title
>Requisitos</title>

<para
>Para instalar o &kpackage; é necessário:</para>

<itemizedlist>
<listitem
><para
>&Qt; 3 e o &kde; 3</para
></listitem>
</itemizedlist>

<para
>Para listar os pacotes da Debian não é necessário outro 'software' mas, para instalar ou desinstalar os pacotes, é necessário:</para>

<itemizedlist>
<listitem
><para
>o gestor de pacotes <command
>dpkg</command
> ou</para
></listitem>

<listitem
><para
>o <command
>apt-get</command
> e o <command
>apt-cache</command
></para
></listitem>
</itemizedlist>

<para
>Para os pacotes do <acronym
>BSD</acronym
>, serão necessários os programas de gestão de pacotes: </para>

<itemizedlist>
<listitem
><para
><command
>pkg_info</command
></para
></listitem>
<listitem
><para
><command
>pkg_add</command
></para
></listitem>
<listitem
><para
><command
>pkg_delete</command
></para
></listitem>
</itemizedlist>

<para
>Para os pacotes do Slackware, é necessário: </para>

<itemizedlist>
<listitem
><para
><command
>installpkg</command
> </para
></listitem>
<listitem
><para
><command
>removepkg</command
></para
></listitem>
</itemizedlist>

<para
>Para gerir os pacotes da Redhat é necessário:</para>

<itemizedlist>

<listitem
><para
><command
>rpm</command
> </para
></listitem>
</itemizedlist>

<para
>Para o &kpackage; funcionar correctamente com os pacotes <acronym
>RPM</acronym
>, a base de dados do <acronym
>RPM</acronym
> precisa de ser inicializada. Se, ao executar `<userinput
><command
>rpm <option
>-qa</option
></command
></userinput
>', ocorrer um erro do tipo `<computeroutput
>unable to open....</computeroutput
>` então deverá executar `<userinput
><command
>rpm <option
>--rebuilddb</option
></command
></userinput
>'.</para>

</sect1>

</appendix>
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->