<para>O &kpackage; é uma interface &GUI; para os gerenciadores de pacotes <acronym>RPM</acronym>, Debian, Slackware e BSD. O &kpackage; é parte do KDE e, como resultado, é desenvolvido para integrar-se com o gerenciador de arquivos do &kde;. </para>
<para>O &kpackage; possui dois painéis. O painel esquerdo mostra uma árvore dos pacotes instalados e disponíveis, enquanto o painel direito mostra informações dos pacotes.</para>
<para>Quando o &kpackage; é iniciado normalmente (ou seja, não foi chamdo através de arrastar-e-soltar e não lhe foi passado parâmetros) ele mostra dois painéis, com a árvore de pacotes a esquerda; esta árvore mostra os pacotes instalados e também, opcionalmente, pacotes novos e atualizáveis.</para>
<para>Abaixo 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>Marcar</guilabel> - Mostra uma marca se o pacote foi marcado. As marcações permitem que múltiplos pacotes sejam instalados ou desinstalados de uma vez usando os botões localizados abaixo da árvore de pacotes</para></listitem>
<listitem><para><guilabel>Resumo</guilabel> - Uma pequena 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 atualiza um pacote instalado, mostra a versão do pacote antigo</para></listitem>
<para>Os pacotes possuem marcas gráficas para indicar seu estado, sendo que uma imagem ao lado de um pacote significa que ele está instalado, um <guilabel>N</guilabel> indica um pacote disponível para instalação e um <guilabel>U</guilabel> indica que o pacote pode ser atualizado</para>
<para>Um pacote é selecionado clicando no seu nome. Clicando na marca (ponto) ao lado do pacote, na coluna correpondente a aba <guilabel>Marcar</guilabel> marca o pacote com um traço, e um segundo clique desmarca-o, enquanto apertando <keycombo action="simul">&Shift;<mousebutton>Botão esquerdo</mousebutton></keycombo> pode ser usado para marcar um conjunto de pacotes num intervalo e clicando <keycombo action="simul">&Ctrl;<mousebutton>Botão esquerdo</mousebutton></keycombo> pode ser usado para adicionar e remover marcas dos pacotes.</para>
<para>Selecionando um pacote da árvore mostra informações sobre ele no painel a direita</para>
<para>A aba <guilabel>Propriedades </guilabel> mostra informações sobre o pacote selecionado. Nas informações de dependências hiper-ligações para os pacotes listados, pacotes instalados estão na fonte padrão, pacotes não instalados mas disponíveis estão em itálico e com dependências não diponíveis são mostrados com texto normal</para>
<para>A aba <guilabel>Lista de Arquivos</guilabel> mostra os arquivos no pacote, e, para os pacotes instalados (desde que a informação esteja disponível) mostra o estado dos arquivos. Arquivos que existem estão marcados com um traço, e aqueles que não existem estão marcados com um X</para>
<para>Para um determinado pacote, use os botões no painel direito, O botão <guibutton>Buscar</guibutton> irá buscar o pacote a partir de um repositório remoto e vai mostrar informações detalhadas. o botão <guibutton>Instalar</guibutton> abre a janela de instalação. </para>
<para>A janela de instalação lista os pacotes que serão selecionados paraserem instalados num painel no canto superior esquerdo, e se o mecanismo<acronym>APT</acronym> do DEbian está sendo usado mostra também os pacotes necessários para satisfazer as dependências. Abaixo deste há um conjunto de caixas de verificação com opções para o programa a ser instalado. Para pacotes <acronym>RPM</acronym> as opções são:</para>
<para>O botão <guibutton>Instalar</guibutton> irá iniciar a instalação de fato. 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 selecionada, a janela irá permanecer.</para>
<para>O painel à direita é uma janela de terminal integrada na qual os programas de instalação são rodados; para os programas de instalação interativa esta interação é feita nesta janela. </para>
<para>Um pacote selecionado pode ser desinstalado usando o botão <guibutton>Desinstalar</guibutton> no painel direito; o botão <guibutton>Desinstalar 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 <guimenu>Localização</guimenu> para cada tipo de pacote dentro do menu <guimenu>Configurações</guimenu>.</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 é inserido na lista e o &kpackage; irá acessá-lo quando a opção <guilabel>Usar máquina remota</guilabel> estiver selecionada.</para>
<para>O resto do painel permite a ativação e desativação dos vários tipos de pacotes que o &kpackage; consegue manipular. Se um determinado tipo de pacote estiver ativo o botão <guibutton>Localização dos Pacotes</guibutton> fará aparecer um diálogo onde você poderá inserir a localização dos pacotes disponíveis. </para>
<para>Para os pacotes <acronym>RPM</acronym> o &kpackage; pode ler uma pasta que contenha pacotes e adicionar estes à árvore de pacotes quer como pacotes novos ou atualizados. É possível examiná-los ou instalá-los a partir da árvore de pacotes. Por padrão as informações sobre os pacotes são extraídas a partir do formato normal dos nomes dos arquivos 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 gerenciamento. Cada linha do painel corresponde a uma pasta, e se a opção <guilabel>Usar</guilabel> estiver selecionada, 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 sub-pastas. O botão <guibutton>...</guibutton> fará aparecer um diálogo janela de seleçã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>, que poderá 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"; ele é usado para gravar o arquivo <filename>/etc/apt/sources.list</filename>, que controla onde o <command>deb-apt</command> irá procurar por pacotes, e onde cada registro corresponde a uma linha do arquivo; 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 manipulados através do <command>dpkg</command>; existem três maneiras para acessar aos pacotes disponíveis, onde eles podem ser selecionados de três painéis de configuração de localização. </para>
<para>O painel "I" indica a localização da árvore de pacotes da Debian e seleciona a distribuição e arquitetura. O &kpackage; irá procurar nos locais padrão pelos arquivos 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 arquivos Packages para os componentes de interesse da distribuição. Se o programa <command>dselect</command> for usado então o arquivo <filename>/var/lib/dpkg/available</filename> pode ser usado como um arquivo <filename>Packages</filename> que descreve a distribuição que o <command>dselect</command> usa.</para>
<listitem><para>O painel "D" indica as pastas de pacotes que podem ser tratadas da mesma maneira que os pacotes <acronym>RPM</acronym>.</para></listitem>
<para>Para os pacotes da Slackware existe pouca informação armazenada nos pacotes instalados, mas é possível usar um arquivo <filename>PACKAGE.TXT</filename> como uma fonte de informação sobre os pacotes instalados. O arquivo <filename>PACKAGES.TXT</filename> é o equivalente ao arquivo 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 arquivo <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, assim 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 arquivo <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 especificar a localização das distribuições com a árvore de pastas que contém os arquivos <filename>.tgz</filename> e a localização do arquivo <filename>PACKAGES.TXT</filename> correspondente.</para></listitem>
<listitem><para>Os painéis "D" são para as pastas que <emphasis>não</emphasis> possuem um arquivo <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 arquivo <filename>INDEX</filename> (que descreve todos os pacotes) e que contém também uma pasta <filename>All</filename> (com todos os arquivos de pacotes nela). </para>
<para>O painel "Portas" indica a localização da árvore das portas no sistema de arquivos </para>
<para>O painel "Pacotes" permite indicar a localização das pastas de pacotes, ou seja, aquelas que contém arquivos <filename>INDEX</filename></para>
<para>Para as pastas e arquivos de pacotes remotos (ou seja, aqueles obtidos por &FTP;) o &kpackage; irá realizar 'caching', os pacotes são colocados nessa cache 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 somente os pacotes, cujo nome ou resumo contenha o texto procurado, sejam apresentados.</para>
<para>O diálogo <guilabel>Procurar 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 exatas para os nomes dos pacotes. Se a opção <guilabel>Procura geral</guilabel> não estiver ativada, a procura não irá para o início no caso de chegar ao fim da árvore de pacotes. </para>
<para>O diálogo para <guilabel>Procurar Arquivo</guilabel> pesquisa nos arquivos as ocorrências que contenham o texto de procura. As colunas apresentadas são:</para>
<para>Só os arquivos nos pacotes instalados são mostrados, a menos que a opção <guilabel>Também procurar pacotes não instalados</guilabel> esteja ativa; 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> é atualizada pelo item do menu <guimenuitem>Atualizar arquivo Apt</guimenuitem>. </para>
<para>O &kpackage; precisa de acesso como <systemitem class="username">root</systemitem> para instalar/desinstalar os pacotes; isto pode ser feito rodando o &kpackage; como <systemitem class="username">root</systemitem>, por exemplo, através do &tdesu;.</para>
<para>Em alternativa, se o &kpackage; está rodando com um usuário normal ele irá tentar rodar os programas de instalação/desinstalação como root logando-se através dum pseudo-terminal, em que usa o <command>su</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 digitada. Para isto funcionar a linha de comando do <systemitem class="username">root</systemitem> tem que terminar em <prompt>#</prompt>.</para>
<para>O &kpackage; usa o protocolo do KDE de 'Arrastar e Soltar'. Isto significa que você pode arrastar e soltar pacotes no &kpackage; para abrí-los. Ao soltar um arquivo no diálogo <guilabel>Procurar Arquivo</guilabel> ele irá procurar o pacote que contém o arquivo.</para>
<listitem><para>Produz uma lista de pacotes que contém o nome de arquivo inserido, onde selecionando uma linha apresentará as informações sobre esse pacote. Isto comporta-se de maneira ligeiramente diferente para o <acronym>RPM</acronym> (onde você tem que indicar o nome do arquivo exato) e para o <acronym>DEB</acronym> (onde você pode inserir uma expressão regular).</para></listitem>
<listitem><para>Um botão para voltar atrás para navegar pelas hiper-ligações nas entradas de <guilabel>Propriedades</guilabel> no painel direito.</para></listitem>
<listitem><para>Um botão para avançar na navegação pelas hiper-ligações nas entradas de <guilabel>Propriedades</guilabel> no painel direito.</para></listitem>
<listitem><para>Ao procurar por arquivos de desinstalação usa o comando <command>apt-file</command>, que atualiza a base de dados que o <command>apt-file</command> usa.</para></listitem>
<listitem><para>Quais os tipos de pacotes a manipular; na Debian o uso do DPKG e do APT estão separados, não é uma boa ideia ativá-los ao mesmo tempo. Isto também indica se deve acessar a uma máquina remota para o APT da Debian.</para></listitem>
<term><guilabel>Ler as informações de todos os arquivos de pacotes locais</guilabel></term>
<listitem><para>Se estiver assinalado todos os arquivos duma pasta de pacotes (local) são lidos em vez de só se usar os nomes dos arquivos; 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, veja <ulink url="http://www.kde.org/install-source.html">http://www.kde.org/install-source.html</ulink></para>
<para>Existem 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 corretamente com os pacotes <acronym>RPM</acronym>, a base de dados do <acronym>RPM</acronym> precisa 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 você deve executar <userinput><command>rpm <option>--rebuilddb</option></command></userinput>.</para>
