Prefácio

Foram seguidas as seguintes regras de orientação ao compilar este documento.

	Atenção
	Espera-se que se esforce a procurar respostas por si próprio e para além desta documentação. Este documento apenas oferece pontos de arranque eficientes.

Tem de procurar a solução por si a partir de fontes primárias.

Este documento fornece informação através do seguinte estilo de apresentação simplificado com exemplos de comandos de shell bash(1).

# command-in-root-account
$ command-in-user-account

Estas 'prompts' da shell distinguem a conta utilizada e correspondem a definir variáveis de ambiente como: "PS1='\$'" e "PS2=' '". Estes valores são escolhidos para bem da legibilidade deste documento e não são típicos do sistema instalado.

Todos os exemplos de comando são executados na localidade em inglês "LANG=en_US.UTF8". Por favor, não espere que as strings de espaço reservado, como command-in-root-accout e command-in-user-account sejam traduzidos em exemplos de comando.

	Nota
	Veja o significado das variáveis de ambiente "$PS1" e "$PS2" em bash(1).

A ação necessária do administrador do sistema é escrita em sentido imperativo, p.e. "Carregue na tecla Enter após escrever cada cadeia de comando na shell."

A coluna descrição e semelhantes na tabela podem conter um sintagma nominal seguido da convenção de descrição curta do pacote que deixa cair os artigos como "um" e "o". Pode em alternativa conter uma frase no infinitivo tal como um sintagma nominal sem o antecedente "para" a seguir a convenção de descrição curta de comando das 'manpages'. Isto pode parecer esquisito para algumas pessoas mas são as minhas escolhas intencionais de estilo para manter esta documentação o mais simples possível. Estes sintagmas nominais não começam por maiúscula nem terminam com ponto final a seguir esta convenção de descrição curta.

Um bloco de comandos citado num parágrafo de texto é referido pelo tipo de letra de dactilografia entre aspas, tal como "aptitude safe-upgrade".

Os dados em texto de um ficheiro de configuração citados num parágrafo de texto são referidos em tipo de letra de máquina de escrever entre aspas, tal como "deb-src".

Um comando é referenciado pelo seu nome em tipo de letra de máquina de escrever seguido opcionalmente pelo número de secção da manpage em parêntesis, tal como bash(1). É encorajado a obter informação ao escrever o seguinte.

$ man 1 bash

Uma manpage é referida pelo seu nome em tipo de letra de máquina de escrever seguido pelo número de secção dele da manpage em parêntesis, tal como sources.list(5). É encorajado a obter informação ao escrever o seguinte.

$ man 5 sources.list

Uma página info é referenciada pelo seu comando em tipo de letra de máquina de escrever entre aspas, tal como "info make". É encorajado a obter informação ao escrever o seguinte.

$ info make

Um nome de ficheiro é referenciado em tipo de letra de máquina de escrever entre aspas, tal como "/etc/passwd". Para os ficheiros de configuração, é encorajado a obter informação ao escrever o seguinte.

$ sensible-pager "/etc/passwd"

Um nome de diretório é referenciado em tipo de letra de máquina de escrever entre aspas, tal como "/etc/apt/". É encorajado a explorar o conteúdo dele ao escrever o seguinte.

$ mc "/etc/apt/"

Um nome de pacote é referenciado pelo nome dele em tipo de letra de máquina de escrever, tal como vim. É encorajado a obter informação ao escrever o seguinte.

$ dpkg -L vim
$ apt-cache show vim
$ aptitude show vim

Uma documentação pode indicar a localização dela pelo nome de ficheiro em tipo de letra de dactilografia entre aspas, tal como "/usr/share/doc/base-passwd/users-and-groups.txt.gz" e "/usr/share/doc/base-passwd/users-and-groups.html"; ou pelo seu URL, tal como https://iwawocd.cewmufwd.tk. É encorajado a ler a documentação ao escrever o seguinte.

$ zcat "/usr/share/doc/base-passwd/users-and-groups.txt.gz" | sensible-pager
$ sensible-browser "/usr/share/doc/base-passwd/users-and-groups.html"
$ sensible-browser "https://iwawocd.cewmufwd.tk"

Uma variável de ambiente é referenciada pelo seu nome com um "$" inicial em tipo de letra de máquina de escrever, entre aspas, tal como "$TERM". É encorajado a obter o valor atual dele ao escrever o seguinte.

$ echo "$TERM"

Os dados popcon são apresentados como a medida objectiva da popularidade de cada pacote. Foi descarregado em 2024-03-03 11:51:37 UTC e contém a submissão total de 237734 relatórios sobre 198687 pacotes binários e 27 arquitecturas.

O número de popcon precedido de "V:" para "votos" é calculado por "1000 * (as submissões popcon para o pacote executado recentemente no PC) / (o total de submissões de popcon)".

O número de popcon precedido de "I:" para "instalações" é calculado por "1000 * (as submissões popcon para o pacote instalado no PC) / (o total de submissões de popcon)".

Os dados de tamanho do pacote são também apresentados como a medida objectiva para cada pacote. São baseados no "Installed-Size:" reportado pelo comando "apt-cache show" ou pelo "aptitude show" (atualmente na amd64 arquitectura para o lançamento unstable). O tamanho reportado está em KB (Kilobyte = unidade para 1024 bytes).

Se encontrar quaisquer problemas neste documento por favor preencha um relatório de bug contra o pacote debian-reference a utilizar o reportbug(1) . Por favor inclua sugestões de correção com "diff -u" sobre a versão de texto ou código-fonte.