# O Manual do &kpackage;

## Introdução

O &kpackage; é uma interface gráfica para os gestores de pacotes RPM, Debian, Slackware e BSD. 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.

### A Janela Principal - Árvore de Pacotes

Quando o &kpackage; é iniciado normalmente (isto é, não foi invocado através de arrastar e largar 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.

O Painel Esquerdo do &kpackage; Painel Esquerdo - Árvore de Pacotes

Painel Esquerdo - Árvore de Pacotes

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

- Instalados - Mostra os pacotes instalados

- Actualizados - Mostra os pacotes para os quais estão disponíveis novas versões

- Novos - Mostra os pacotes não instalados

- Todos - Todos os pacotes

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

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

- Pacote - Nome do pacote

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

- Resumo - Uma breve descrição do pacote.

- Tamanho- O tamanho do pacote

- Versão - A versão do pacote

- Versão Antiga - Se o pacote actualiza a versão antiga de um pacote

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 D indica um pacote disponível e um A corresponde a um pacote que pode actualizar um outro já instalado.

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 e o &Ctrl;esquerdo poderá também ser usado para adicionar e remover marcas nos pacotes.

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

### A Janela Principal - 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 Painel Direito do &kpackage; - Propriedades Painel Direito - Propriedades do Pacote

  O botão Propriedades 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.

- O Painel Direito do &kpackage; - Propriedades Painel Direito - Os Ficheiros no Pacote

  O botão Lista de Ficheiros 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.

- O Painel Direito do &kpackage; - Propriedades Painel Direito - Os Ficheiros no Pacote

  O botão Registo de Alterações mostra o texto do registo de alterações do pacote.

### 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 os Marcados faz aparecer a janela de instalação.

Janela de instalação do &kpackage; Janela de Instalação

Janela de Instalação

A janela de instalação indica os pacotes que podem ser seleccionados para ser instalados num painel em cima e à esquerda; se o APT 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 RPM as opções são:

- Actualizar - Irá actualizar qualquer pacote já instalado.

- Substituir os Ficheiros - Instala os pacotes mesmo que estes substituam os ficheiros de outros pacotes já instalados.

- Verificar as Dependências - Analisa as dependências existentes.

- Testar - Não faz a instalação

Para o APT da Debian, as opções são:

- Obter apenas - Transfere os pacotes mas não os instala.

- Sem transferir - Só usa os pacotes que estão disponível localmente

- Ignorar em falta - Faz a instalação mesmo que faltem alguns pacotes

- Ignorar em espera - Ignora as esperas que foram colocadas nos pacotes

- Assumir que sim - Responde que sim a todas as perguntas que o programa de instalação faça.

- Testar - Não faz a instalação

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

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.

### Desinstalar Pacotes

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

Janela de instalação do &kpackage; Janela de Desinstalação

Janela de Desinstalação

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.

Para os pacotes RPM as opções são:

- Usar os 'scripts' - Executa todos os 'scripts' de desinstalação

- Verificar as Dependências - Analisa as dependências existentes.

- Testar - Não faz a instalação

Para o APT da Debian, as opções são:

- Limpar a Configuração - Remove todos os ficheiros de configuração do pacote.

- Assumir que sim - Responde que sim a todas as perguntas que o programa de instalação faça.

- Testar - Não faz a instalação

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

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

Janela de instalação do &kpackage; Painel do Gestor de Pacotes

Painel do Gestor de Pacotes

A parte de cima do painel tem a opção Máquina Remota que permite ao &kpackage; lidar com os pacotes numa máquina remota; esta funcionalidade necessita do `ssh` 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 Usar uma máquina remota estiver seleccionada.

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 Localização dos Pacotes fará aparecer uma janela onde se poderá indicar a localização dos pacotes disponíveis.

Janela de instalação do &kpackage; Janela de Localização do RPM

Janela de Localização do RPM

Para os pacotes RPM o &kpackage; pode ler uma pasta 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 pastas locais seja lido cada um dos pacotes; isto é mais lento mas obtém-se uma descrição completa.

A janela de localizações do RPM permite a indicação das pastas que contêm os pacotes RPM; é 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 Usar 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 `FTP`. A opção Sub-pastas indica se são procurados pacotes nas suas subpastas. O botão ... fará aparecer uma janela de selecção das pastas.

Janela de instalação do &kpackage; Janela de Localização do APT da Debian

Janela de Localização do APT da Debian

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

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

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

Janela de instalação do &kpackage; Janela de Localização do DPKG da Debian: painéis L e P

Janela de Localização do DPKG da Debian: painéis L e P

DPKG: Debian significa que os pacotes 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.

- 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

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

- O painel "D" indica as pastas de pacotes podem ser tratadas da mesma maneira que os pacotes RPM.

Janela de instalação do &kpackage; Janela de Localização do Slackware

Janela de Localização do Slackware

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.

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

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

- Os painéis "D" são para as pastas que não têm um ficheiro `PACKAGES.TXT` correspondente

Janela de instalação do &kpackage; Janela de Localização do BSD

Janela de Localização do BSD

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

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

O painel "Pacotes" permite indicar a localização das pastas de pacotes, ou seja, aquelas que contêm ficheiros `INDEX`

Para as pastas 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 pastas em `~/.kpackage/dir`.

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

### Pesquisa

#### Linha de Procura de Pacotes

Linha de Procura do &kpackage; Linha de Procura

Linha de Procura

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.

#### Procurar Pacote

Procurar um Pacote do &kpackage; Procurar um Pacote

Procurar um Pacote

A janela para Procurar um Pacote pesquisa os nomes dos pacotes na árvore e salta para o próximo pacote correspondente. Se o Sub-texto não estiver assinalado, então só serão apresentadas correspondências exactas para os nomes dos pacotes. Se a opção Procura geral não estiver activada, a procura não dará a volta no caso de chegar ao fim da árvore de pacotes.

#### Procurar um Ficheiro

Procurar um Ficheiro do &kpackage; Procurar um Ficheiro

Procurar um Ficheiro

A janela para Procurar um Ficheiro pesquisa nos ficheiros as ocorrências que contenham o texto de procura. As colunas apresentadas são:

- Instalados - Assinalado se for um pacote instalado.

- Tipo - O tipo do pacote.

- Pacote - O nome do pacote.

- Nome do ficheiro - O nome do ficheiro correspondente

Só os ficheiros nos pacotes instalados é que são mostrados, a menos que a opção Também procurar pacotes não instalados esteja activa; isto só irá funcionar com os pacotes do APT da Debian e só se o comando `apt-file` estiver instalado. A base de dados utilizada pelo comando `apt-file` for actualizado pelo item do menu Actualização de ficheiro Apt.

### Diversos

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

#### Arrastar e Largar

O &kpackage; recorre ao protocolo do KDE de Arrastar e Largar. 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.

## 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 um 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 Recuar

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

&Alt;Seta Direita Pacotes Avançar

- Um botão para avançar na navegação pelas hiperligaçõ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

Pacotes Marcar Tudo

- Marca todos os pacotes que sejam membros da janela seleccionada

Pacotes Instalar

- Instalar o pacote seleccionado no momento

Pacotes Instalar os Marcados

- Instala todos os pacotes marcados

Pacotes Desinstalar

- Desinstala o pacote seleccionado no momento

Pacotes Desinstalar os Marcados

- Desinstala todos os pacotes marcados

### O menu Cache

Os itens no menu 'Cache' são:

'Cache'Limpar a 'Cache' das Pastas de Pacotes

- Apaga as cópias em 'cache' das pastas 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.

Actualizar

- 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

Apt-file update

- A procura dos ficheiros de desinstalação usa o comando `apt-file`, o qual actualiza a base de dados que o `apt-file` usa.

### O menu Configuração

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

Configuração Mostrar a Barra de Ferramentas

- Liga ou desliga a barra de ferramentas

Configuração Gravar a Configuração...

- Grava as opções imediatamente

Configuração Configurar os Atalhos...

- A janela normal do &kde; para configurar as teclas de atalho

Configuração Configurar as 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. Também indica se deve aceder a uma máquina remota para o APT da Debian.

'Cache'

- Controla a utilização da 'cache' nas pastas e ficheiros Package remotos (por &FTP;).

  Usar a 'Cache' para as Pastas dos Pacotes Remotos

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

Usar a 'Cache' para os Pacotes Remotos

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

Pasta da 'Cache'

- Onde colocar a 'cache' dos ficheiros e pastas de pacotes

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 pacotes locais

- Se estiver assinalado 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.

### O menu Ajuda

Os itens no menu Ajuda são:

&help.menu.documentation;

### Barra de Ferramentas

- Abrir

- Recuar

- Avançar

- Expandir a Árvore de Pacotes

- Compactar a Árvore de Pacotes

- Procurar um Pacote

- Procurar um Ficheiro

- Actualizar

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

- &Qt; 3 e o &kde; 3

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:

- `rpm`

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