<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<para><guilabel>Substituir os Ficheiros</guilabel> - Instala os pacotes mesmo que estes substituam os ficheiros de outros pacotes já instalados.</para>
<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>
<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>
<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>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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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 &tdesu;.</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>
<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>
<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>
<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>
<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>
<listitem><para>O <command>apt</command> é extremamente restrito acerca das dependências, tentando corrigir os problemas de dependências</para></listitem>
<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>
<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>
<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>
<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>
<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>
&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>
<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>
