# O Manual do &kpackage;

## Introdução

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

## Fundamental da Interface

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

### Arrastar e Largar

O &kpackage; recorre ao protocolo do KDE de 'Drag and Drop'. Isto significa que podes arrastar e largar pacotes no &kpackage; para os abrires. Ao largares um ficheiro na janela "Procurar Ficheiro" ela irá procurar o pacote que contém o ficheiro.

### O Painel da Árvore de Pacotes

Quando o &kpackage; é iniciado normalmente (isto é, não foi invocado através de 'drag and drop' 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.

Os botões por cima do painel seleccionam se se devem mostrar os pacotes instalados, actualizados, disponíveis ou todos os pacotes.

A árvore de pacotes mostra o nome do pacote, o seu tamanho, a versão e (no caso dum pacote disponível que iria actualizar um já instalado) a versão do pacote já instalado.

Ao seleccionar um pacote na árvore, obtêm-se informações sobre ele no painel direito e isto permite:

- Mostrar a informação de estado do pacote

- Ver que ficheiros estão incluídos num pacote instalado; ao seleccionar um ficheiro na lista este será aberto usando o gestor de ficheiros

- Verificar os ficheiros num pacote; os ficheiros que existem são assinalados; os ficheiros que não existem são marcados com uma cruz.

- Desinstalar um pacote instalado

- Instalar um pacote disponível

Selecciona-se um único pacote carregando no seu nome. Carregando no ponto na coluna Marca assinala o pacote, enquanto que ao carregar segunda vez remove a marca; para além disso o &Shift;botão esquerdo pode ser usado para seleccionar um conjunto de pacotes.

### Integrar os pacotes disponíveis na árvore

O acesso aos pacotes disponíveis é definido através das entradas do menu "Localização" para cada tipo de pacote dentro do menu "Opções".

Para os pacotes RPM o &kpackage; pode ler uma directoria que contenha pacotes e adiciona estes à árvore de pacotes quer como pacotes novos ou 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 Examinar para ver a descrição completa. Contudo, é possível definir uma opção de maneira a que para as directorias locais seja lido cada um dos pacotes; isto é mais lento mas obtém-se uma descrição completa.

Para os pacotes da Debian, que são geridos através do `dpkg`, existem três maneiras de acederes aos pacotes disponíveis, em que estes podem ser seleccionados de três painéis de tipos de localização.

- Especifica 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

- Especifica a localização da distribuição Debian assim como os ficheiros Packages para os componentes de interesse da distribuição. Se o programa `dselect` for usado então o ficheiro `/var/lib/dpkg/available` pode ser usado como um ficheiro Packages que descreve a distribuição que o `dselect` usa.

- As directorias de pacotes podem ser tratadas da mesma maneira que os pacotes RPM.

Para os pacotes da Debian que são tratados com o APT a localização do repositório dos pacotes desinstalados é definida num ficheiro `/etc/apt/sources.list`; o menu Localização pode à mesma ser usado para as directorias que contêm os pacotes da Debian. Estes pacotes são obtidos e postos em 'cache' pelo apt em si, não pelo &kpackage;

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

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 os pacotes do BSD o &kpackage; irá procurar por uma directoria da distribuição que contenha um ficheiro `INDEX` (que descreve todos os pacotes) e que contém também uma directoria `All` (com todos os ficheiros de pacotes nela).

Para as directorias e ficheiros de pacotes remotos (ou seja, aqueles obtidos por &FTP;) o &kpackage; irá realizar 'caching', os pacotes são colocados nessa 'cache' em `~/.kpackage` e as directorias em `~/.kpackage/dir`

Para o tratamento de directorias remotas (&FTP;) funcionar poderá ser necessário desligar a opção 'Proxy' de FTP nas Opções do Navegador.

### Painel de Informação do Pacote

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

- O botão Propriedades que mostra algumas informações sobre o pacote seleccionado. Na informação de dependências existem hiper-ligações para os pacotes listados, em que os pacotes instalados estão representados com uma letra normal, e os não instalados estão em itálico.

- O botão Lista de Ficheiros mostra os ficheiros no pacote e para os pacotes instalados mostra o estado dos ficheiros.

### Acesso de Root

O &kpackage; precisa de acesso como `root` para instalar/desinstalar os pacotes; isto pode ser feito correndo o &kpackage; como `root`, por exemplo, através do &kdesu;.

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, em que usa o `su` ou o `ssh` para fazer isto. Se necessário fará aparecer uma janela de terminal onde a senha de `root` pode ser escrita. Para isto funcionar a linha de comandos do root tem de acabar em `#`.

Isto não funciona para os pacotes RPM, porque estes são geridos internamente pelo &kpackage;.

### Instalar Pacotes

Para instalares um pacote podes

- localizar o pacote que queres instalar no konqueror e arrastá-lo para uma instância a correr do &kpackage;

- carregar num ficheiro de pacote no konqueror e iniciar uma nova instância do &kpackage;

- usar os itens do menu Abrir no &kpackage;

- seleccionar um pacote disponível na árvore de pacotes

Para um pacote seleccionado, usando os botões no painel direito, o botão Obter irá obter o ficheiro de pacote duma fonte remota e mostrar a informação sobre o pacote; o botão Instalar abrirá a janela de instalação.

Para os pacotes marcados, usando os botões no painel esquerdo, o botão Instalar Pacotes Marcados invoca uma janela de opções de instalação.

A janela de instalação lista os pacotes a instalar e permite definir as opções de instalação. 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.

Os pacotes RPM são tratados de maneira ligeiramente diferente dos outros tipos de pacotes, dado que a instalação é feita directamente pelo &kpackage;, o painel da direita só é usado para as mensagens de erro.

### Desinstalar Pacotes

Um pacote seleccionado pode ser desinstalado usando o botão Desinstalar no painel direito; isto fará aparecer uma janela com as opções de desinstalação, em que o botão Desinstalar na janela fará com que os pacotes sejam desinstalados; o painel direito disponibiliza uma janela de terminal integrada para os programas de desinstalação.

Os pacotes marcados podem ser desinstalados usando o botão Desinstalar pacotes marcados no painel esquerdo.

## Menus

Isto descreve os menus do &kpackage;.

### O menu Ficheiro

Os itens no menu Ficheiro são:

&Ctrl;O Ficheiro Abrir

- Invoca o selector de ficheiros para os ficheiros locais e de &FTP;

Ficheiro Abrir Recente

- Uma lista com os ficheiros de pacotes abertos mais recentemente

&Ctrl;F Ficheiro Procurar Pacote

- Procura na lista de pacotes instalados por um pacote cujo nome contenha o texto introduzido

Ficheiro Procurar Ficheiro

- Produz uma lista de pacotes que contêm o nome de ficheiro indicado, em que seleccionando uma linha irá apresentar a informação sobre esse pacote. Isto comporta-se de maneira ligeiramente diferente para o RPM (onde tens de indicar o nome do ficheiro exacto) e para o DEB (onde podes introduzir uma expressão regular).

F5 Ficheiro Recarregar

- Relê os dados dos pacotes e reconstrói a árvore de pacotes

&Ctrl;Q Ficheiro Sair

- Sai do &kpackage;

### O menu Pacotes

Os itens no menu Pacotes são:

&Alt;Seta Esquerda Pacotes Voltar

- Um botão para voltar atrás para navegar pelas hiper-ligações nas entradas de Propriedades no painel direito.

&Alt;Seta Direita Pacotes Avançar

- Um botão para avançar na navegação pelas hiper-ligações nas entradas de Propriedades no painel direito.

Pacotes Expandir a Árvore

- Expande completamente a árvore de pacotes

Pacotes Compactar a Árvore

- Fecha a árvore de pacotes de maneira a que só a estrutura em árvore é visível

Pacotes Limpar os Marcados

- Retira as marcas de todos os pacotes

### O menu Cache

Os itens no menu 'Cache' são:

'Cache' Limpar a 'Cache' da Directoria de Pacotes

- Apaga as cópias em 'cache' das directorias de pacotes remotos e os ficheiros Packages

'Cache'Limpar a 'Cache' de Pacotes

- Apaga as cópias em 'cache' dos ficheiros de pacotes remotos que foram transferidos para a máquina local

### O menu Especial

O menu Especial contém as acções específicas de cada tipo de pacote:

Especial APT: Debian

- Actualizar

- Actualiza os índices `apt` dos repositórios de pacotes.

Actualização da Instalação

- Actualiza a instalação da Debian para as últimas versões de todos os pacotes.

Corrigir

- O `apt` é extremamente estrito acerca das dependências; tenta corrigir os problemas de dependências

### O menu Configuração

Os itens no menu Configuração são:

Configuração Mostrar Barra de Ferramentas

- Liga ou desliga a barra de ferramentas

Configuração Gravar a Configuração

- Grava as opções imediatamente

Configuração Configurar Teclas

- A janela normal do KDE para configurar as teclas de atalho

Configuração Configurar Barras de Ferramentas

- A janela normal do KDE para configurar as barras de ferramentas

Configuração Configurar o KPackage

- Tipos

- 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.

'Cache' de Directorias

- Definir se se faz 'cache' das directorias e ficheiros Package remotos (por &FTP;).

'Cache' de Pacotes

- Definir se se faz 'cache' dos pacotes remotos que foram transferidos para a máquina local.

diversos

- Usar o SSH para os comandos privilegiados

- Usar o `ssh` em vez do `su` para correr os comandos privilegiados

Verificar a lista de ficheiros

- e estiver assinalado a lista de ficheiros no pacote é analisada para ver se eles estão realmente instalados

Ler a informação de todos os ficheiros de pacote

- Se estiver assinalado todos os ficheiros duma directoria de pacote (local) são lidos em vez de só se usar os nomes dos ficheiros; isto é mais lento mas mostra mais informações.

Configuração Localização dos pacotes disponíveis

- Localização RPM

- Isto indica a localização das directorias de pacotes (quer os locais quer os de &FTP;), em que cada linha inclui uma entrada onde o &URL; ou nome da directoria pode ser indicado, um botão ... que traz um selector de ficheiros e um botão de opção Usar que determina se a directoria indicada na linha é para ser usada ou não. O botão SubDirs indica se se deve entrar pelas sub-directorias dentro. Os painéis múltiplos são só por conveniência.

Localização BSD

- O primeiro painel indica a localização da árvore dos portos no sistema de ficheiros

  O outro painel permite especificar a localização das directorias de pacotes, ou seja, aquelas que contêm ficheiros `INDEX`

Localização DEB

- Existem três tipos diferentes de painéis.

  - Os três primeiros painéis têm uma entrada para a localização da árvore da distribuição da Debian, uma lista para o nome da distribuição e outra para a arquitectura

  - Os próximos dois painéis permitem especificar uma árvore da distribuição Debian e a localização dos ficheiros Packages nessa distribuição.

  - Os últimos três painéis especificam as directorias da mesma maneira que para os RPMs.

Localização SLACK

- Para os pacotes do Slackware existem três tipos de painéis

  - O primeiro painel é a localização dum ficheiro `PACKAGES.TXT` que é usado para fornecer informações sobre os pacotes instalados

  - Os próximos quatro painéis podem ser usados para especificar a localização das distribuições com a árvore de directorias que contêm os ficheiros `.tgz` e a localização do ficheiro `PACKAGES.TXT` correspondente.

  - Os últimos dois painéis são para as directorias que não têm um ficheiro `PACKAGES.TXT` correspondente

### O menu Ajuda

Os itens no menu Ajuda são:

&help.menu.documentation;

### Barra de Ferramentas

- Abrir

- Voltar

- Avançar

- Expandir a Árvore de Pacotes

- Compactar a Árvore de Pacotes

- Procurar Pacote

- Procurar Ficheiro

- Recarregar

- Sair

## Créditos e Licenças

&kpackage;

Programa copyright 1999-2000 Damyan Pepper, Toivo Pedaste

Documentação copyright 2000 Toivo Pedaste toivo@ucs.uwa.edu.au

Tradução de José Nuno Pires jncp@netcabo.pt

&underFDL; &underGPL;

## Instalação

### Como obter o &kpackage;

&install.intro.documentation;

Para mais informações sobre como obtê-lo e compilá-lo, convém ver o URL http://www.kde.org/install-source.html

Existe mais informação sobre como compilar em http://www.kde.org/compilationfaq.html

Existe uma página Web em http://www.general.uwa.edu.au/u/toivo/kpackage

### Requisitos

Para instalar o &kpackage; é necessário:

- O &Qt; 3.x e o &kde; 3.1

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

- o gestor de pacotes `dpgk`

- o `apt-get` e o `apt-cache`

Para os pacotes do BSD precisas dos programas de gestão de pacotes:

- `pkg_info`

- `pkg_add`

- `pkg_delete`

Para os pacotes do Slackware precisas do:

- installpkg

- removepkg

Para gerir os pacotes da Redhat é necessário:

- O RPM e o RPM-DEVEL: 3.0 ou 4.0

- As mesmas bibliotecas necessárias para compilar o RPM. Estas são:

  - `libdb` - a biblioteca de bases de dados da Berkeley

  - `libz` e `libz-dev` - uma biblioteca de compressão

  - O RPM precisa da rotina gettext que existe na `libc6` ou na `libintl`

  - O RPM 3.0 pode precisar do pacote `popt`.

Para o &kpackage; funcionar correctamente com os pacotes RPM , a base de dados do RPM precisa de ser inicializada. Se ao executar ```rpm `-qa```' ocorrer um erro do tipo ``unable to open....`` então deves executar ```rpm `--rebuilddb```'.