<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
 <!ENTITY % Portuguese "INCLUDE">
 <!ENTITY konsole "<application>Konsole</application>">
 <!ENTITY % addindex "IGNORE">
 <![ %addindex; [ <!ENTITY docindex SYSTEM "docindex.docbook"> ]]>
 <!ENTITY % ents PUBLIC "-//KDE//ENTITIES Application-Variable Entities V1.0//EN">
 %ents;
 <![ %addindex; [ <!ENTITY kdedocindex SYSTEM "docindex.docbook"> ]]>
]>

<book lang="pt">

<bookinfo>
<title>Manual da &konsole;</title>
<authorgroup>
<author>
<firstname>Jonathan</firstname>
<surname>Singer</surname>
<affiliation><address><email>jsinger@genome.wi.mit.edu</email></address></affiliation>
</author>
<othercredit role="developer">
<firstname>Lars</firstname>
<surname>D&ouml;lle</surname>
<contrib>Desenvolvimento</contrib>
<affiliation><address><email>lars.doelle@on-line.de</email></address></affiliation>
</othercredit>
<othercredit role="reviewer">
<firstname>Michael</firstname>
<surname>McBride</surname>
<contrib>Revisão</contrib>
<affiliation><address><email>mmcbride@ematic.com</email></address></affiliation>
</othercredit>
<othercredit role="reviewer">
<firstname>Lauri</firstname>
<surname>Watts</surname>
<contrib>Revisão</contrib>
<affiliation><address><email>vampyr@atconnex.net</email></address></affiliation>
</othercredit>
<othercredit role="translator">
<firstname>Nuno</firstname>
<surname>Pinhão</surname>
<affiliation><address><email>n.pinhao@mail.telepac.pt</email></address>
</affiliation>
<contrib>Tradução</contrib>
</othercredit>
</authorgroup>
<copyright>
<year>2000</year>
<holder>Jonathan Singer</holder>
</copyright>
<copyright>
<year>2000</year>
<holder>Nuno Pinhão</holder>
</copyright>

<legalnotice>&FDLNotice;</legalnotice>

<date>03/06/2000</date>
<releaseinfo>0.09.15</releaseinfo>
<!-- CVS :1.6: -->

<abstract><para>Este documento é o manual de utilização da aplicação 
&konsole;.</para>
<para>&konsole; é um emulador de terminal X para o KDE 2.0</para></abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>konsole</keyword>
<keyword>kdebase</keyword>
<keyword>comando</keyword>
<keyword>linha</keyword>
</keywordset>

</bookinfo>

<chapter id="introducao">
<title>Introdução à &konsole;</title>

<para>&konsole; é um emulador de terminal X fornecendo uma interface de linha de 
comando (<abbrev>ILC</abbrev>) quando se está a usar o Ambiente Gráfico de Desktop K.
 A &konsole; facilita a organização da área de trabalho do utilizador mantendo sessões 
múltiplas numa única janela (isto é, uma área de trabalho menos "atafulhada").</para>

<para>Por entre as funcionalidades avançadas incluie-se a facilidade de configuração e a 
capacidade de usar múltiplas "shell"s de terminal numa única janela.</para>

<para>Através da &konsole; um utilizador pode iniciar:</para>
<itemizedlist>	
<listitem><para>sessões de consola do Linux;</para></listitem>
<listitem><para>sessões do gestor de ficheiros Midnight Commander;</para></listitem> 
<listitem><para>sessões de "shell";</para></listitem>
<listitem><para>sessões de consola como "root";</para></listitem>
</itemizedlist>
    
<para>O nome destas sessões pode ser mudado, ajudando à sua organização, ou 
podem ser-lhes enviados sinais (STOP, CONT, HUP, INT, TERM, KILL).</para>
    
<para>O utilizador pode controlar o aspecto da &konsole; 
através de:</para>
<itemizedlist>
<listitem><para>mostrar/esconder as barras de menus, ferramentas e/ou moldura;</para></listitem>
<listitem><para>selecionar as dimensões da janela, a fonte, o esquema de cores e a tabela de 
chaves do teclado da &konsole;;</para></listitem>
<listitem><para>alterar a posição da barra de deslizamento ou escondê-la.</para></listitem>
</itemizedlist>
    
<para>Se forem guardadas, todas as opções alteradas podem passar a ser as opções utilizadas 
por defeito nas sessões posteriores.</para>
    
<sect1 id="historia">
<title>História</title>

<para>Para aqueles interessados na taxonomia dos terminais X livres, existem 
mais dois emuladores de terminais de destaque: o original, <application>xterm</application>,
escrito mesmo antes do sistema X (um mês ou dois), e <application>xvt</application>, um 
clone do <application>xterm</application> e no qual a maior parte de outros emuladores  
actualmente disponíveis (em particular <application>eterm</application>) se vieram a 
basear.</para>

<para>Ao fim de uma década, &konsole; é a primeira reescrita 
completa de um emulador de terminal. Enquanto que a modificação do 
<application>xterm</application> foi definitivamente abandonada (o seu 
<filename>README</filename> inicia-se com a frase "Abandon All Hope, 
Ye Who Enter Here"), a &konsole; oferece uma nova abordagem 
usando as tecnologias e a visão contemporâneas do sistema X.</para>

</sect1>
</chapter>

<chapter id="instalacao">
<title>Instalação</title>

<para>A &konsole; faz parte do pacote base do KDE 2.0. Será 
instalada automaticamente com a instalação do KDE e requer a sua versão 2.0 para funcionar.</para>
<para>Para mais informações deve visitar o web do KDE em 
<ulink url="http://www.kde.org/">http://www.kde.org/</ulink></para>

<para>Caso queira obter a &konsole; separadamente, ela faz parte do 
pacote kdebase e deve ser compilada e instalada como indicado na directoria principal de 
instalação do pacote. As novas versões do kdebase podem ser obtidas em 
<ulink url="ftp://ftp.kde.org/pub/">ftp://ftp.kde.org/pub/</ulink></para> 

<para>Comandos a executar para compilar a &konsole;:</para>

<screen>
<prompt>$</prompt>  <command>cd <filename>kdebase/konsole</filename></command>
<prompt>$</prompt>  <command>./configure</command>
<prompt>$</prompt>  <command>make</command>
<lineannotation>Por fim, como root:</lineannotation>
<prompt>#</prompt>  <command>make install</command>
</screen>

</chapter>

<chapter id="utilizacao-da-konsole">
<title>Utilização da &konsole;</title>

<sect1 id="inicio">
<title>Início</title>

<para>Quando invocada a &konsole; inicia uma aplicação (que por omissão é  
uma "shell" UNIX) activa na janela. O utilizador só tem que escrever na linha
de comando.</para>

</sect1>

<sect1 id="historial">
<title>Historial</title>

<para>Se a opção <link linkend="options-menu">"Historial"</link> estiver activa,  
as linhas que desaparecem do ecran poderão ser novamente vistas movendo a barra 
de deslizamento para cima ou para baixo, ou usando as teclas 
<keycombo><keycap>Shift</keycap><keycap>Page Up</keycap></keycombo> (para andar 
para trás uma página), <keycombo><keycap>Shift</keycap><keycap>Page
Down</keycap></keycombo> (para andar para a frente uma página),
<keycombo><keycap>Shift</keycap><keycap>Up</keycap></keycombo> (para andar para 
trás uma linha) e <keycombo><keycap>Shift</keycap><keycap>Down</keycap></keycombo> 
(para andar para a frente uma linha).</para>
</sect1>

<sect1 id="botoes-do-rato">

<title>Botões do Rato</title>

<variablelist>

<varlistentry>

<term><mousebutton>Esquerdo</mousebutton></term> <listitem><para>Se a aplicação activa no 
terminal aceitar sinais do rato, ao pressionar o botão <mousebutton>esquerdo</mousebutton> 
do rato esse sinal é-lhe transmitido. A &konsole; indica que um programa aceita sinais 
do rato mostrando um cursor na forma de seta. Caso contrário, é mostrado um cursor 
com a forma de um I (barra).</para>

<para>Mantendo o botão <mousebutton>esquerdo</mousebutton> pressionado e arrastando o
cursor sobre a janela numa aplicação que aceite sinais do rato, marcará uma região de 
texto. Enquanto arrastar o cursor, tem informação visual do texto marcado, sendo este mostrado  
em cor invertida. Quando o botão é libertado, o texto selecionado é copiado para a área 
de transferência para uso posterior na &konsole; ou noutra aplicação.</para>

<para>Normalmente, são inseridos caracteres de mudança de linha no fim de cada linha 
selecionada. Este procedimento é o mais adequado para "cortar e colar" código fonte, 
ou o resultado de um comando. Para texto corrente, as mudança de linha não são em geral 
importantes. No entanto pode preferir que o texto seja uma sequência contínua de caracteres 
que sejam automaticamente re-formatados quando passados para outra aplicação. Para
selecionar este modo de sequência contínua de texto, mantenha pressionado a tecla 
<keycap>Ctrl</keycap> enquanto marca texto.</para>

<para>Se as margens superior ou inferior do texto forem tocadas enquanto estiver a proceder
à marcação, a &konsole; deslizará o texto para cima ou para baixo,
expondo texto da àrea de "história". Esse deslizamento para quando o rato para.</para>

<para>Após o botão do rato ser libertado, a &konsole; tenta manter 
o texto passado para a área de transferência visível mantendo o texto marcado em cor invertida.
 A área marcada volta à cor normal assim que o conteúdo da área de transferência é alterado, 
 o texto na área marcada é modificado ou o botão <mousebutton>esquerdo</mousebutton> é 
pressionado.</para>

<para>Para marcar texto numa aplicação que aceite sinais do rato, a tecla <keycap>Shift</keycap> 
tem de ser pressionada em simultâneo com o botão do rato.</para>
    
</listitem>
</varlistentry>

<varlistentry>
<term><mousebutton>Central</mousebutton></term> <listitem><para>Pressionando o botão
<mousebutton>central</mousebutton> o texto presente na área de transferência é inserido.</para>
<note><para>Se tiver um rato só com dois botões, pressionando ambos os botões 
<mousebutton>esquerdo</mousebutton> e <mousebutton>direito</mousebutton> em 
simultâneo simula-se o botão <mousebutton>central</mousebutton> de um rato com três 
botões.</para></note>
</listitem>
</varlistentry>

<varlistentry>
<term><mousebutton>Direito</mousebutton></term> <listitem><para>O botão 
<mousebutton>direito</mousebutton>activa o menu <guimenu>"Opções"</guimenu>. 
A combinação <keycombo><keycap>Ctrl</keycap></keycombo> + botão 
<mousebutton>direito</mousebutton> faz aparecer o menu <guimenu>"Ficheiro"</guimenu>, 
enquanto que a combinação <keycombo><keycap>Shift</keycap></keycombo> + botão 
<mousebutton>direito</mousebutton> button activa o menu 
<guimenu>"Sessões"</guimenu>.</para></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="barra-de-menu">
<title>Barra de Menu</title>

<para>A barra de menu apresenta-se no topo da janela da &konsole;. 
Pode ser escondida ou tornada visível comutando a opção 
<guimenuitem>"Mostrar Barra de Menu"</guimenuitem> do menu <guimenu>"Opções"</guimenu>. 
Quando o menu está escondido, a opção <guimenuitem>"Mostrar Barra de Menu"</guimenuitem> 
pode ser activada pressionando o botão <mousebutton>direito</mousebutton> do rato sobre a
janela.</para>

<sect2 id="file-menu">
<title>O menu <guimenu>Ficheiro</guimenu></title>
<variablelist>
<varlistentry>
<term><menuchoice><guimenu>Ficheiro</guimenu><guimenuitem>Consola do Linux
</guimenuitem></menuchoice></term>
<listitem><para><action> Abre uma nova sessão emulando um sistema Linux só em modo 
de texto.</action></para><para>
(Consulte o documento <filename>README.linux.console</filename> para informações detailhadas 
em como a consola de Linux difere de uma consola típica de  UNIX.)</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Ficheiro</guimenu><guimenuitem>Midnight Commander</guimenuitem></menuchoice></term>
<listitem><para><action>Abre uma nova sessão com o navegador gráfico de ficheiros 
<application>Midnight Commander</application>.</action></para></listitem>
</varlistentry>
<varlistentry>

<term><menuchoice><guimenu>Ficheiro</guimenu><guimenuitem>Shell</guimenuitem></menuchoice></term>
<listitem><para><action>Abre uma nova sessão com uma "shel" de terminal.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Ficheiro</guimenu><guimenuitem>Consola de root</guimenuitem></menuchoice></term>
<listitem><para><action>Abre uma nova sessão com uma "shell" de terminal, como utilizador "root".
</action></para><para> Após ser pedida a palavra-chave de "root", aparece a "prompt" 
<prompt>#</prompt>, indicando que o utilizador tem privilégios de "root". 
Isto é frequentemente necessário para instalar novo software ou outras operações de 
manutenção do sistema, mas deve-se cuidados acrescidos para evitar danos acidentais.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Ficheiro</guimenu><guimenuitem>Sair</guimenuitem></menuchoice></term>
<listitem><para><action>Sai da &konsole;, encerrando todas as sessões e 
qualquer aplicação lançada a partir destas.</action></para></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="session-menu">
<title>O Menu <guimenu>Sessões</guimenu></title>

<variablelist>
<varlistentry>
<term><menuchoice><guimenu>Sessões</guimenu><guimenuitem>Envia Sinal</guimenuitem></menuchoice></term>
<listitem><para><action>Envia Sinal - Envia o sinal indicado ao processo da "shell", 
ou a outro processo que tenha sido lançado quando a nova sessão foi iniciada.
</action></para><para>Os sinais disponíveis são:</para>
<informaltable frame=none>
<tgroup cols=3>
<tbody>
<row><entry>Stop</entry><entry>-</entry> <entry>para o processo</entry></row>
<row><entry>Cont</entry> <entry>-</entry><entry>continua se parado</entry></row>
<row><entry>HUP</entry> <entry>-</entry>
<entry>hangup detectado no terminal de controlo, ou fim do processo de controlo</entry></row>
<row><entry>Int</entry> <entry>-</entry><entry>interrupção proveniente do teclado</entry></row>
<row><entry>Term</entry> <entry>-</entry><entry>sinal de términus</entry></row>
<row><entry>Kill</entry> <entry>-</entry><entry>sinal de fim</entry></row>
</tbody></tgroup>
</informaltable>
<para>Consulte as páginas do manual do seu sistema para mais detalhes dando o comando 
<command>man 7 signal</command></para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Sessões</guimenu><guimenuitem>Mudar o nome da Sessão</guimenuitem></menuchoice></term>
<listitem><para><action>Muda o nome da sessão activa</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Opções</guimenu><guimenuitem>Icons da sessão...</guimenuitem></menuchoice></term>
<listitem><para>Na base do menu é indicada uma lista das sessões disponíveis. Selecionando uma, 
activa essa sessão.</para></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="options-menu">
<title>O menu <guimenu>Opções</guimenu></title>

<variablelist>
<varlistentry>
<term><menuchoice><guimenu>Opções</guimenu><guimenuitem>Mostra a barra de menu</guimenuitem></menuchoice></term>
<listitem><para><action>Mostra ou esconde a barra de menu</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Opções</guimenu><guimenuitem>Mostra a barra de ferramentas</guimenuitem></menuchoice></term>
<listitem><para><action>Mostra ou esconde a barra de ferramentas</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Opções</guimenu><guimenuitem>Mostra a moldura</guimenuitem></menuchoice></term>
<listitem><para><action>Mostra ou esconde a moldura em torno da janela</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Opções</guimenu><guimenuitem>Barra de deslizamento</guimenuitem></menuchoice></term>
<listitem><para><action>Controla a localização da barra de deslizamento: nenhuma, à esquerda ou à direita</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Opções</guimenu><guimenuitem>Ecran completo</guimenuitem></menuchoice></term>
<listitem><para><action>Comuta a janela entre o ecran completo e o tamanho normal</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Option</guimenu><guimenuitem>Tamanho</guimenuitem></menuchoice></term>
<listitem><para><action>Define o tamanho da àrea de texto (indicado em colunas x linhas)</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Opções</guimenu><guimenuitem>Letra</guimenuitem></menuchoice></term>
<listitem><para><action>Define a dimensão da letra</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Opções</guimenu><guimenuitem>Esquema</guimenuitem></menuchoice></term>
<listitem><para><action>Controla a cor do texto e do fundo</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Opções</guimenu><guimenuitem>Historial</guimenuitem></menuchoice></term>
<listitem><para><action>Comuta a opção de guardar as linhas que saíram dos limites da janela</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Opções</guimenu><guimenuitem>Codec</guimenuitem></menuchoice></term>
<listitem><para><action>Ainda não implementado</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Opções</guimenu><guimenuitem>Teclado</guimenuitem></menuchoice></term>
<listitem><para><action>Seleciona o mapa de teclado desejado</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Opções</guimenu><guimenuitem>Guarda as Opções</guimenuitem></menuchoice></term>
<listitem><para><action>Guarda a selecção corrente de opções como os novos valores por defeito</action></para></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="help-menu">
<title>O menu de <guimenu>Ajuda</guimenu></title>

<variablelist>
<varlistentry>
<term><menuchoice><guimenu>Ajuda</guimenu><guimenuitem>Assuntos</guimenuitem></menuchoice></term>
<listitem><para><action>Mostra o índice de assuntos deste documento</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Ajuda</guimenu><guimenuitem>Referência Técnica</guimenuitem></menuchoice></term>
<listitem><para><action>Informação detalhada sobre a emulação de terminal e a &konsole;</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Ajuda</guimenu><guimenuitem>Relatório de Erro</guimenuitem></menuchoice></term>
<listitem><para><action>Apresenta um relatório de erro ou a sugestão de uma nova funcionalidade para a &konsole;</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Ajuda</guimenu><guimenuitem>Sobre a Konsole</guimenuitem></menuchoice></term>
<listitem><para><action>Informações sobre o autor da &konsole;</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Ajuda</guimenu><guimenuitem>Sobre o KDE</guimenuitem></menuchoice></term>
<listitem><para><action>Informações sobre o projecto KDE</action></para></listitem>
</varlistentry>
</variablelist>

</sect2>

</sect1>

<sect1 id="barra-de-ferramentas">
<title>A barra de ferramentas</title>

<para>A barra de ferramentas localiza-se na base da janela da &konsole;.</para>
<para>Pode ser escondida e reactivada comutando a opção 
<guimenuitem>"Mostrar a barra de ferramentas"</guimenuitem> do menu 
<guimenu>"Opções"</guimenu> ou pressionando a "handle" no lado da barra. 
A barra contem um ícone <guiicon>"Nova"</guiicon> e ícones para a sessão corrente. 
Pressionando <guiicon>"Nova"</guiicon> abre uma nova sessão de "Shell".</para>

<para>Pressionando o ícone de uma sessão já existente torna-a activa.</para>

</sect1>

<sect1 id="opcoes-da-linha-de-comando">
<title>Opções da linha de comando</title>

<para>Quando a &konsole; é iniciada a partir da linha de comando, podem ser indicadas diversas opções para alterar
o seu comportamento habitual.</para>
<variablelist>
<varlistentry>
<term><option>--help</option></term>
<listitem><para><action>lista as opções disponíveis</action></para></listitem>
</varlistentry>
<varlistentry>
<term><option>--name</option></term>
<listitem><para><action>Altera o nome que surge na barra de título</action></para></listitem>
</varlistentry>
<varlistentry>
<term><option>--ls</option></term>
<listitem><para><action>Inicia uma shell de login</action></para></listitem>
</varlistentry>
<varlistentry>
<term><option>--nowelcome</option></term>
<listitem><para><action>Omite a mensagem de "Bemvindo à &konsole;" que normalmente aparece na barra de título</action></para></listitem>
</varlistentry>
<varlistentry>
<term><option>--nohist</option></term>
<listitem><para><action>Desactiva a função de historial das linhas que saiem da área activa da janela.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><option>--vt_sz <replaceable>CCxLL</replaceable></option></term>
<listitem><para><action>Mostra uma janela de terminal com CC colunas e LL linhas</action></para></listitem>
</varlistentry>
<varlistentry>
<term><option> -e <replaceable>&lt;command&gt;</replaceable></option></term>
<listitem><para><action>Executa a instrução &lt;command&gt; em vez da "shell"</action></para></listitem>
</varlistentry>
</variablelist>
<para>Exemplo:</para>
<informalexample>
<screen>
<prompt>bash$</prompt> <command>konsole <replaceable>--vt_sz 90x25 --nohist</replaceable></command>
</screen><para> Mostra uma janela da &konsole; com 90 colunas e 25 linhas, sem a função de historial</para>
      </informalexample>
<para>A &konsole; também aceita opções genéricas do QT de do KDE:</para>
<variablelist>
<varlistentry>
<term><option>--author</option></term>
<listitem><para><action>Mostra o(s) nome(s) do(s) autor(es)</action></para></listitem>
</varlistentry>
<varlistentry>
<term><option>--V</option></term>
<listitem><para><action>Mostra o número da versão</action></para></listitem>
</varlistentry>
<varlistentry>
<term><option>--help-qt</option></term>
<listitem><para><action>Lista as opções específicas do Qt</action></para></listitem>
</varlistentry>
<varlistentry>
<term><option>--help-kde</option></term>
<listitem><para><action>Lista as opções específicas do KDE</action></para></listitem>
</varlistentry>
<varlistentry>
<term><option>--help-all</option></term>
<listitem><para><action>Lista todas as opções</action></para></listitem>
</varlistentry>
</variablelist>

</sect1>

</chapter>

<chapter id="creditos">
<title>Créditos e Copyright</title>

<para>A aplicação &konsole; <trademark class="copyright">copyright 1997-2000
Lars Doelle</trademark> <email>lars.doelle@on-line.de</email></para>

<para>Este documento foi escrito por Jonathan Singer
<email>jsinger@genome.wi.mit.edu</email></para>

<para>Convertido para o DocBook SGML por Michael McBride
<email>mmcbride@ematic.com</email> e Lauri Watts
<email>vampyr@atconnex.net</email></para>

&underFDL;
&underGPL;
</chapter>
  
<![ %addindex; [ &docindex; ]]>

</book>
