<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN">
<book lang="pt-BR">

<bookinfo>
<title>Manual do Gerenciador de Janelas</title>
<authorgroup>
<author>
<surname>O Time KDE</surname>
</author>
</authorgroup>
<date>24/06/1998</date>
<releaseinfo>0.11.13</releaseinfo>
<abstract>
<para>Esta documentação foi atualizada pela última vez para o Kwm versão 0.11.13.
Queira dirigir comentários e adições ao autor.</para>
</abstract>
<keywordset>
<keyword>KDE</keyword>
<keyword>KWM</keyword>
<keyword>window manager</keyword>
</keywordset>
</bookinfo>

<chapter id="introducao">
<title>Introdução</title>

<para>Este documento contém informações gerais sobre o <emphasis>Kwm</emphasis>, uma referência
de recursos, e informações técnicas úteis a desenvolvedores do 
<emphasis>módulo de controle do Kwm</emphasis> e do <emphasis>módulo de sons do sistema</emphasis>.</para>

<para>Para maiores informações sobre como customizar o Kwm em baixo nível 
(interessa somente aos desenvolvedores do kwinconfig), queira consultar
o arquivo <link linkend="kwmrc">kwmrc</link> e o código-fonte.</para>

<para> 
Para todos os programadores: verifiquem o arquivo <literal remap="tt">kwm.h</literal> na
biblioteca libkdecore para informar-se sobre como usar o Kwm para seus
propósitos. No caso dos módulos, a classe <literal remap="tt">KWMModuleApplication</literal>
é um bom exemplo sobre como escrever módulos.</para>
<sect1 id="Features">
<title>Recursos</title>

<para><emphasis>Kwm</emphasis> é o gerenciador de janelas ideal para o KDE. Entre outras coisas, ele
oferece:</para>

<para><itemizedlist>
<listitem>
<para>Integração completa com o KDE.
</para>
</listitem>
<listitem>
<para>Controle completo do <link linkend="shortcuts">teclado</link>;
</para>
</listitem>
<listitem>
<para>Interface moderna com títulos de janela e ícones exclusivos e que não
precisam ser definidos em arquivos crípticos de recursos;
</para>
</listitem>
<listitem>
<para>Uma  <link linkend="minicli">mini-janela de linha de comando</link>
com histórico;
</para>
</listitem>
<listitem>
<para>Habilidade de ser reconfigurado em tempo de execução sem precisar 
reiniciar;
</para>
</listitem>
<listitem>
<para>Gerenciador de janelas de segunda geração, o Kwm usa uma ferramenta 
moderna de interface gráfica para seus controles (botões, menus, caixas de
listagem etc.) ao invés de empanturrar o código com uma implementação 
proprietária ou medíocre do Xlib.
</para>
</listitem>
<listitem>
<para>Excelente manipulação do foco, mesmo que você trabalhe em diferentes 
ambientes virtuais (nada mais de comutar-ambiente-e-perder-foco) como é o 
padrão em outros gerenciadores de janelas);
</para>
</listitem>
<listitem>
<para>Inclui gerenciamento de sessão e um proxy de gerenciamento de sessão
funcional para aplicações de legado. Esse proxy pode restaurar suas aplicações
a seu estado anterior, incluindo propriedades de janela (maximizada, pregada,
iconificada etc.) e no ambiente de trabalho correto;
</para>
</listitem>
<listitem>
<para>Moderno conceito de módulos que utiliza o servidor X onde é possível.
Os módulos do Kwm também são bastante independentes: podem ser iniciados antes
ou depois do Kwm. O Kwm pode ser reiniciado enquando os módulos continuam 
rodando, e irá reconectar-se a eles automaticamente;
</para>
</listitem>
<listitem>
<para>Oferece algumas extensões ao servidor X em <literal remap="tt">kwm.h</literal>: Agora as
aplicações podem maximizar a si mesmas (ou pregar-se ou decorar-se ou 
o que for), e definir mini-ícones. Isto funciona também para janelas visíveis.</para>
</listitem>
</itemizedlist>
</para>
</sect1>
</chapter>

<chapter id="UsandooemphasisKwmemphasis">
<title>Usando o <emphasis>Kwm</emphasis></title>

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

<para>O <emphasis>Kwm</emphasis> oferece as seguintes opções de linha de comando:</para>

<para><variablelist>
<varlistentry>
<term> -version</term>
<listitem>
<para>Mostra a versão, inclusive o <emphasis>patchlevel</emphasis>; não inicia o Kwm.</para>
</listitem>
</varlistentry>
<varlistentry>
<term> -nosession</term>
<listitem>
<para>Inicia o <emphasis>Kwm</emphasis> sem restaurar a seção anterior.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>
<sect1 id="shortcuts">
<title>Atalhos de teclado</title>

<para><variablelist>
<varlistentry>
<term>Alt-Esc ou Control-Esc </term>
<listitem>
<para>Gerenciador da "Sessão Corrente" com botão de
logout</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Alt-Tab and Alt-Shift-Tab </term>
<listitem>
<para>Navega pelas janelas do ambiente de trabalho
corrente</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Ctrl-Tab e Ctrl-Shift-Tab </term>
<listitem>
<para>Navega pelos ambientes virtuais 
(pode ser desligado em <link linkend="kwmrc">kwmrc</link>)</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Alt-F2 </term>
<listitem>
<para>Abrir a <link linkend="minicli">mini-janela de linha  de comando</link></para>
</listitem>
</varlistentry>
<varlistentry>
<term>Alt-F3 </term>
<listitem>
<para>Menu de operações de janela</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Alt-F4 </term>
<listitem>
<para>Fechar janela</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Ctrl-F&lsqb;1..8&rsqb; </term>
<listitem>
<para>Comutar para o ambiente virtual de número correspondente</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Ctrl-Alt-Esc </term>
<listitem>
<para>Modo de destruição de janela (cursor torna-se uma caveira)</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>

<sect1 id="controle-do-mouse">
<title>Controle do mouse</title>

<para><emphasis remap="bf">Clique sobre a borda ou sobre a barra de título</emphasis>
<itemizedlist>
<listitem>
<para>  <emphasis>botão esquerdo do mouse</emphasis> ativa e traz a janela ao primeiro plano</para>
</listitem>
<listitem>
<para>  <emphasis>botão central do mouse</emphasis> ativa e coloca a janela em segundo plano</para>
</listitem>
<listitem>
<para>  <emphasis>botão direito do mouse</emphasis> mostra o menu de operações de janela se
ela estiver ativa, do contrário ativa-a sem colocá-la em primeiro plano.</para>
</listitem>
</itemizedlist>

<emphasis remap="bf">Clique duplo na barra de título comuta a maximização</emphasis></para>

<para><emphasis remap="bf">Arrasto da barra de título</emphasis>
<itemizedlist>
<listitem>
<para> <emphasis>botão esquerdo do mouse</emphasis> move a janela e traz a mesma para ao primeiro
plano</para>
</listitem>
<listitem>
<para> <emphasis>botão central do mouse</emphasis> move a janela sem trazê-la ao primeiro
plano</para>
</listitem>
</itemizedlist>
</para>

<para><emphasis remap="bf">Arrasto das bordas ou cantos</emphasis>
<itemizedlist>
<listitem>
<para> <emphasis>botão esquerdo do mouse</emphasis> redimensiona a janela e traz a mesma para o
primeiro plano</para>
</listitem>
<listitem>
<para> <emphasis>botão central do mouse</emphasis> redimensiona a janela sem trazê-la para
o primeiro plano</para>
</listitem>
</itemizedlist>
</para>

<para><emphasis remap="bf">A janela inteira</emphasis>
<itemizedlist>
<listitem>
<para> <emphasis>Alt-botão esquerdo do mouse</emphasis> move a janela</para>
</listitem>
<listitem>
<para> <emphasis>Alt-botão central do mouse</emphasis> coloca a janela em segundo plano
se estiver em primeiro plano</para>
</listitem>
<listitem>
<para> <emphasis>Alt-botão direito do mouse</emphasis> redimensiona a janela</para>
</listitem>
</itemizedlist>
</para>

<para><emphasis remap="bf">Botões da barra de título (configuráveis)</emphasis>
<itemizedlist>
<listitem>
<para> <emphasis>Menu</emphasis> mostra uma lista de operações de janela</para>
</listitem>
<listitem>
<para> <emphasis>Pregar</emphasis> liga/desliga o modo Pregado (que é quando a janela 
permanece na tela mesmo ao se trocar de ambiente de trabalho)</para>
</listitem>
<listitem>
<para> <emphasis>Criar ícone / Minimizar</emphasis> esconde a janela sem eliminá-la</para>
</listitem>
<listitem>
<para> <emphasis>Maximizar</emphasis>
<itemizedlist>
<listitem>
<para> <emphasis>botão esquerdo do mouse</emphasis> maximiza</para>
</listitem>
<listitem>
<para> <emphasis>botão central do mouse</emphasis> maximiza verticalmente</para>
</listitem>
<listitem>
<para> <emphasis>botão direito do mouse</emphasis> maximiza horizontalmente</para>
</listitem>
</itemizedlist>
</para>
</listitem>
<listitem>
<para> <emphasis>Fechar</emphasis> fecha a janela (algumas aplicações podem perguntar se
devem salvar documentos abertos etc.)</para>
</listitem>
</itemizedlist>
</para>
</sect1>
<sect1 id="minicli">
<title>Mini-janela de linha de comando</title>

<para>Pressione <literal remap="tt">Alt-F2</literal> para mostrar uma pequena janela de linha de comando.
Digite um comando do Unix (a variável de ambiente SHELL é utilizada para 
determinar que interpretador -- shell -- executará o comando), ou:
<itemizedlist>
<listitem>
<para> Digite uma URL para abrir uma janela do <emphasis>Kfm</emphasis> contendo a URL 
informada. Você pode omitir o prefixo http:// ou ftp:// se o nome do servidor
começa com www ou ftp, respectivamente.
</para>
</listitem>
<listitem>
<para> Digite <command>man:</command> comando para abrir uma janela <emphasis>kfm</emphasis>
mostrando a página <literal remap="tt">man</literal> correspondente ao <emphasis>comando</emphasis>.</para>
</listitem>
</itemizedlist>
</para>

<para>Você pode usar a seta para cima para voltar a comandos previamente utilizados.
Além disso, você pode usar a tecla Tab para completar nomes de arquivo
parcialmente digitados, do mesmo modo que na maioria dos avisos de comando 
em modo texto.</para>
</sect1>

<sect1 id="comandos">
<title>Comandos</title>

<para>Você pode mandar comandos ao kwm das seguintes formas:</para>

<para><literal remap="tt"> KWM::sendKWMCommand(QString)</literal> (de dentro das aplicações KDE)
ou
<command>kwmcom</command> comando (da linha de comando)</para>

<para>Isso é de interesse especial dos desenvolvedores do KGlobalShortcut.</para>

<para>No momento o <emphasis>kwm</emphasis> entende os seguintes comandos:
<itemizedlist>
<listitem>
<para><emphasis remap="bf">refreshScreen</emphasis> atualiza a tela.</para>
</listitem>
<listitem>
<para><emphasis remap="bf">darkenScreen</emphasis> escurece a tela. Cuidado: esse comando deixa o ambiente
insensível ao teclado/mouse.</para>
</listitem>
<listitem>
<para><emphasis remap="bf">logout</emphasis> mostra a janela de logout.</para>
</listitem>
<listitem>
<para><emphasis remap="bf">commandLine</emphasis> abre a <link linkend="minicli">mini-janela de linha de comando</link></para>
</listitem>
<listitem>
<para><emphasis remap="bf">taskManager</emphasis> mostra o gerenciador de sessão</para>
</listitem>
<listitem>
<para><emphasis remap="bf">configure</emphasis> recarrega a configuração do arquivo
<link linkend="kwmrc">kwmrc</link>.</para>
</listitem>
<listitem>
<para><emphasis remap="bf">winMove
winResize
winRestore
winIconify
winClose
winShade
winSticky
winOperations</emphasis>
Estes comandos afetam a janela ativa e fazem o que se espera deles.
(<literal remap="tt">winOperations</literal> mostra o menu de operações de janela.)</para>
</listitem>
<listitem>
<para><emphasis remap="bf">deskUnclutter
deskCascade</emphasis>
Estes comandos reorganizam as janelas no ambiente.</para>
</listitem>
<listitem>
<para><emphasis remap="bf">desktop<emphasis>&lsqb;1-8&rsqb;</emphasis></emphasis> muda para o ambiente de trabalho
especificado.</para>
</listitem>
<listitem>
<para><emphasis remap="bf">desktop+1
desktop+2
desktop-1
desktop-2
desktop&percnt;2</emphasis>
Estes comandos comutam entre ambientes de trabalho. A chave
<literal remap="tt">desktop&percnt;2</literal> comuta entre um ambiente ímpar e o próximo ambiente par. Isso
significa comutar entre 1 e 2 ou entre 3 e 4. Isso é útil para emular 
"Acima" e "Abaixo" numa matriz virtual n*2, que é usada pelo pager do KDE.
Similarmente, <literal remap="tt">desktop+2</literal> significa "Direita"; <literal remap="tt">desktop-1</literal> significa
"Esquerda".</para>
</listitem>
</itemizedlist>
</para>
</sect1>
</chapter>

<chapter id="Configurao">
<title>Configuração</title>

<para>O <emphasis>Kwm</emphasis> pode ser configurado usando-se o Centro de Controle do KDE
(<emphasis remap="bf">menu Iniciar &gt; Centro de Controle KDE</emphasis>). Abra a árvore Janelas para
ver as várias opções de configuração. Para configurar os ambientes virtuais,
abra a árvore Aplicações e escolha Painel.</para>

<para>Para os que preferem editar um arquivo de configuração, esta seção explica
as opções do arquivo <literal remap="tt">kwmrc</literal>, localizado em  
&tilde;/.kde/share/config.</para>
<sect1 id="kwmrc">
<title>Kwmrc</title>

<para>A configuração do kwmrc é dividida nas seguintes seções:
<itemizedlist>
<listitem>
<para><link linkend="confButtons">Botões</link></para>
</listitem>
<listitem>
<para><link linkend="confGeneral">Geral</link></para>
</listitem>
<listitem>
<para><link linkend="confSession">Sessão</link></para>
</listitem>
<listitem>
<para><link linkend="confDesktop">Ambiente de Trabalho</link></para>
</listitem>
<listitem>
<para><link linkend="confDecoration">Decoração</link></para>
</listitem>
<listitem>
<para><link linkend="confFocus">Foco</link></para>
</listitem>
</itemizedlist>
</para>
<sect2 id="confButtons">
<title>&lsqb;Botões&rsqb;</title>

<para>Esta seção controla o posicionamento dos botões de janela na barra de título.
Contém linhas na forma
Button<emphasis>X</emphasis>=<emphasis>nome-de-botão</emphasis>
onde <emphasis>X</emphasis> é uma letra A-F, e <emphasis>nome-de-botão</emphasis> pode ser <literal remap="tt">Menu,
Sticky, Iconify, Maximize, Close, Off</literal>. Botões A, B e C aparecem do lado
esquerdo do título da janela, e D, E e F aparecem do lado direito.</para>
</sect2>
<sect2 id="confGeneral">
<title>&lsqb;Geral&rsqb;</title>

<para>Esta seção define uma miscelânea de itens de configuração:
<itemizedlist>
<listitem>
<para><emphasis remap="bf">AltTabStyle=<literal remap="tt">KDE&verbar;CDE</literal> (padrão é <emphasis>KDE</emphasis>)</emphasis> 
Recurso AltTab no estilo do CDE, para ser utilizado com a política de foco
clássica. O estilo CDE é o padrão com a política clássica de foco, já que
o estilo do KDE não faz muito sentido nessas circunstâncias. Para todas as
outras políticas de foco, você pode escolher o estilo. 
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">AutoRaise=<emphasis>valor</emphasis> (em milissegundos)</emphasis> 
Se <literal remap="tt">FocusPolicy</literal> é igual a <literal remap="tt">FocusFollowMouse</literal>, este item determina o
tempo entre o momento em que a janela ganha o foco e o momento em que a janela
é trazida para o primeiro plano.
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">BorderSnapZone=<emphasis>valor</emphasis> (em pixels) </emphasis> 
Quando o usuário está posicionado uma janela, e uma das bordas aproxima-se da
borda do ambiente, a janela irá fixar-se à borda; <emphasis>valor</emphasis> determina quão
perto a janela tem de estar da borda do ambiente para isso acontecer.
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Button3Grab=<literal remap="tt">on&verbar;off</literal></emphasis>
Quando desligado <literal remap="tt">(off)</literal>, as operações de janela envolvendo o botão direito
do mouse são desligadas, de modo que as aplicações possam receber os eventos
de botão direito do mouse.
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">ControlTab=<literal remap="tt">on&verbar;off</literal></emphasis>  
Quando ligado <literal remap="tt">(on)</literal>, permite ao usuário pressionar 
<literal remap="tt">Ctrl+Tab</literal> para comutar entre ambientes virtuais.
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">ElectricBorder=<emphasis>valor</emphasis> (em milissegundos)</emphasis>
Se você tem mais de um ambiente virtual, o recurso ElectricBorder permite
a você mover-se entre os ambientes movendo o mouse para a borda da tela.
O parâmetro <emphasis>value</emphasis> especifica o tempo que você deve manter o ponteiro
encostado na borda até que o ambiente mude.
Um <emphasis>valor</emphasis> de -1 desliga esse recurso.
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">ElectricBorderPointerWarp=<literal remap="tt">NoWarp&verbar;MiddleWarp&verbar;FullWarp</literal></emphasis> 
Se a opção <literal remap="tt">ElectricBorder</literal> for igual a <literal remap="tt">on</literal>, configure esta
opção para que o ponteiro do mouse mova-se à posição desejada quando o ambiente
muda.
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">ElectricBorderNumberOfPushes=<emphasis>valor</emphasis> (padrão é 5 passos)</emphasis>
O número de passos do mouse dentro do tempo especificado pela propriedade
<literal remap="tt">ElectricBorder</literal> para mudar para outro ambiente virtual sem estar
arrastando uma janela.
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">FocusPolicy=<literal remap="tt">ClickToFocus&verbar;FocusFollowMouse&verbar;ClassicFocusFollowsMouse&verbar;ClassicSloppyFocus</literal></emphasis> 
<literal remap="tt">ClickToFocus</literal> requer que o usuário clique uma janela paa lhe dar o foco.
<literal remap="tt">FocusFollowMouse</literal> dá sempre o foco para a janela sob o ponteiro do mouse.
Com <literal remap="tt">ClassicFocusFollowsMouse</literal>, a janela não ganha o foco se o ponteiro não
estiver sobre ela.
O <literal remap="tt">focusFollowMouse</literal> do <literal remap="tt">Kwm</literal> costumava dar o foco para novas janelas ou Alt-tab 
para permitir m elhor controle via teclado.
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">MaximizeOnlyVertically=<literal remap="tt">off&verbar;on</literal></emphasis> 
Quando ligado <literal remap="tt">(on)</literal>, essa item restringe a maximização de janela à direção
vertical.
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">ResizeAnimation</emphasis>=<literal remap="tt">1..10</literal> (velocidade máxima)
Quando ligado <literal remap="tt">(on)</literal>, minimização e maximização envolvem animação gráfica.
(padrão é <emphasis>1</emphasis>)
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">RstartProtocol</emphasis>=<literal remap="tt">...</literal> (padrão é <command>rstart -v</command>) 
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">ShapeMode=<literal remap="tt">off&verbar;on</literal></emphasis> 
Quando ShapeMode está ligado <literal remap="tt">(on)</literal>, o <emphasis>Kwm</emphasis> usa os pixmaps definidos
pelo usuário para as bordas de janela ao invés do padrão (veja abaixo).
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">ShapePixmapTop=<emphasis>pixmap</emphasis>  
ShapePixmapBottom=<emphasis>pixmap</emphasis> 
ShapePixmapLeft=<emphasis>pixmap</emphasis> 
ShapePixmapRight=<emphasis>pixmap</emphasis> 
ShapePixmapTopLeft=<emphasis>pixmap</emphasis> 
ShapePixmapTopRight=<emphasis>pixmap</emphasis> 
ShapePixmapBottomLeft=<emphasis>pixmap</emphasis> 
ShapePixmapBottomRight=<emphasis>pixmap</emphasis> </emphasis>
Estas opções especificam que imagens serão mostradas nos respectivos
lados/cantos das janelas quando <literal remap="tt">ShapeMode</literal> for igual a <literal remap="tt">on</literal>. O
<emphasis>pixmap</emphasis> deve ser o nome de um arquivo de pixmap (.xpm), que deve estar
localizado em share/apps/kwm/pics.
</para>
<para>Os fontes do Kwm incluem uma subpasta "images", que é um exemplo para as
extensões de aparência.</para>
</listitem>
<listitem>
<para><emphasis remap="bf">TitlebarLook=<literal remap="tt">shaded&verbar;plain&verbar;pixmap</literal></emphasis> 
Esta opção determina a aparência das barras de título da janela. Escolha
<literal remap="tt">pixmap</literal> para fazer o <emphasis>Kwm</emphasis> mostrar uma imagem definida pelo usuário
na barra de título, conforme especifico nos itens a seguir.
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">TitlebarPixmapActive=<emphasis>pixmap</emphasis></emphasis>
<emphasis remap="bf">TitlebarPixmapInactive=<emphasis>pixmap</emphasis></emphasis>
Estas opções especificam que imagens são mostradas nas barras de título de
janelas ativas e inativas, respectivamente, quando TitleBarLook for igual a
<literal remap="tt">pixmap</literal>.
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">TitleAnimation=<emphasis>valor</emphasis> (em milissegundos) </emphasis>
Habilitar TitleAnimation diz ao <emphasis>kwm</emphasis> para fazer oscilar lateralmente os 
títulos de janela longos,
que não caibam inteiros na área colorida da barra de título, 
O <emphasis>valor</emphasis> especifica a velocidade da oscilação. Zero desliga a oscilação.

</para>
</listitem>
<listitem>
<para><emphasis remap="bf">TitlebarDoubleClickCommand=<literal remap="tt">winMaximize &verbar; winShade &verbar; winMove &verbar;
winResize &verbar; winRestore &verbar; winIconify &verbar; winClose &verbar; winSticky &verbar;
winOperations</literal> </emphasis> 
Esta opção permite especiicar que comportamento de janela deve ocorrer quando
o usuário clica duas vezes a barra de título.
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">TraverseAll=<literal remap="tt">on&verbar;off</literal></emphasis>  
Quando ligado (<literal remap="tt">on</literal>), a operação <literal remap="tt">Alt-tab</literal> faz o ciclo por todas as
janelas em todos os ambientes. Quando desligado (<literal remap="tt">off</literal>), <literal remap="tt">Alt-tab</literal> faz
o ciclo pelas janelas do ambiente atual.
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">WindowMoveType=<literal remap="tt">Opaque&verbar;Transparent</literal></emphasis> 
Esta opção controla o efeito visual que ocorre enquanto o usuário arrasta uma
janela. <literal remap="tt">Transparent</literal> mostra somente uma borda durante o arrasto, enquanto
<literal remap="tt">Opaque</literal> mostra a janela inteira.
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">WindowsPlacement=<literal remap="tt">cascade&verbar;interactive&verbar;manual&verbar;random&verbar;smart</literal></emphasis>  
Esta opção determina como o <emphasis>kwm</emphasis> posiciona as janelas no ambiente de
trabalho quando são criadas; <literal remap="tt">manual</literal> permite ao usuário posicionar a 
janela; <literal remap="tt">interactive</literal> toma um valor adicional de percentagem, como no
exemplo a seguir:
<literal remap="tt">WindowsPlacement=interactive,25</literal>
Com posicionamento interativo <literal remap="tt">(interactive)</literal>, o <emphasis>kwm</emphasis> usa o algoritmo de
posicionamento inteligente, a não ser que a posição cubra janelas preexistentes
em mais do que a porcentagem especificada, caso em que o posicionamento
<literal remap="tt">manual</literal> é usado para permitir ao usuário posicionar a janela. A porcentagem
pode ser maior que 100.

As outras opções dão autonomia ao <emphasis>kwm</emphasis> para posicionar a janela.
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">WindowSnapZone=<emphasis>valor</emphasis> (em pixels) </emphasis> 
Quando o usuário está posicionando uma janela, e uma das bordas aproxima-se
da borda de outra janela, a borda da primeira irá grudar à da segunda;
<emphasis>valor</emphasis> determina quão perto a janela em movimento deve estar da outra para
que esse efeito aconteça.
</para>
</listitem>
</itemizedlist>
</para>
</sect2>
<sect2 id="confSession">
<title>&lsqb;Sessão&rsqb;</title>

<para><itemizedlist>
<listitem>
<para><emphasis remap="bf">proxyignore=<literal remap="tt">xemacs,xterm,...,</literal></emphasis> 
Lista delimitada por vírgulas das aplicações (não-KDE) cujo estado não deve
ser salvo quando o usuário sai do KDE. Lista o nome da aplicação com quaisquer
argumentos de linhas de comando.
</para>
</listitem>
</itemizedlist>
</para>
</sect2>
<sect2 id="confDesktop">
<title>&lsqb;Ambiente de trabalho&rsqb;</title>

<para>Esta seção define o número de ambientes virtuais, seus nomes e posições.
Contém linhas como as seguintes:</para>

<para><itemizedlist>
<listitem>
<para><emphasis remap="bf">NumberOfDesktops=<emphasis>value</emphasis> </emphasis>
Especifica o número de ambientes virtuais. Hoje o <emphasis>kwm</emphasis> suporta até 8
ambientes.
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Desktop<emphasis>&num;</emphasis>&lsqb;<emphasis>idioma</emphasis>&rsqb;=<emphasis>nome</emphasis> </emphasis>
Especifica o <emphasis>nome</emphasis> do ambiente <emphasis>&num;</emphasis>, por exemplo,
<literal remap="tt">Desktop1[pt&lowbar;BR]=Um</literal>
Os ambientes são numerados de 1 a 8.
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Desktop<emphasis>&num;</emphasis>Region=<emphasis>geometry</emphasis> </emphasis>
Especifica a geometria do ambiente <emphasis>&num;</emphasis>; por exemplo,
<literal remap="tt">Desktop1Region=101+0+923+722</literal>
</para>
</listitem>
</itemizedlist>
</para>
</sect2>
<sect2 id="confDecoration">
<title>&lsqb;Decoração&rsqb;</title>

<para><itemizedlist>
<listitem>
<para><emphasis remap="bf">noDecorationTitles=,</emphasis></para>
</listitem>
<listitem>
<para><emphasis remap="bf">tinyDecorationTitles=,</emphasis></para>
</listitem>
<listitem>
<para><emphasis remap="bf">noDecorationClasses=,</emphasis></para>
</listitem>
<listitem>
<para><emphasis remap="bf">tinyDecorationClasses=,</emphasis></para>
</listitem>
</itemizedlist>
</para>
</sect2>
<sect2 id="confFocus">
<title>&lsqb;Foco&rsqb;</title>

<para><itemizedlist>
<listitem>
<para><emphasis remap="bf">noFocusTitles=,</emphasis></para>
</listitem>
<listitem>
<para><emphasis remap="bf">noFocusClasses=,</emphasis></para>
</listitem>
</itemizedlist>

Cada propriedade permite especificar uma lista delimitada por vírgulas de
expressões regulares. Uma janela cujo título ou classe fecha com uma 
determinada expressão será decorada apropriadamente. 
<emphasis>Nota:</emphasis> Essas dicas afetam somente as janelas NOVAS. Não esqueça de
chamar <literal remap="tt">kwmcom</literal> <emphasis>configure</emphasis> ou reiniciar <literal remap="tt">Kwm</literal> depois de mudar
o arquivo <literal remap="tt">kwmrc</literal>.</para>
</sect2>
</sect1>
</chapter>

<chapter id="EventosdeSom">
<title>Eventos de Som</title>

<para>O Kwm gera alguns eventos de som, que podem ser usados num módulo de sons
de sistema. No presente momento, os seguintes eventos de som estão
implementados:
<itemizedlist>
<listitem>
<para>Iconificar (minimizar) janela</para>
</listitem>
<listitem>
<para>Restaurar (desminimizar, desiconificar) janela</para>
</listitem>
<listitem>
<para>Maximizar janela</para>
</listitem>
<listitem>
<para>Desmaximizar janela</para>
</listitem>
<listitem>
<para>Pregar janela</para>
</listitem>
<listitem>
<para>Despregar janela</para>
</listitem>
<listitem>
<para>Nova janela</para>
</listitem>
<listitem>
<para>Apagar Janela</para>
</listitem>
<listitem>
<para>Novo Trans</para>
</listitem>
<listitem>
<para>Deletar Trans</para>
</listitem>
<listitem>
<para>Shade Up</para>
</listitem>
<listitem>
<para>Shade Down</para>
</listitem>
<listitem>
<para>Sair</para>
</listitem>
<listitem>
<para>Mensagem de saída</para>
</listitem>
</itemizedlist>
</para>
</chapter>

<chapter id="Perguntasmaisfreqentes">
<title>Perguntas mais freqüentes</title>

<sect1 id="por-que-eu-devo-usar-o-kwm">
<title>Por que eu devo usar o <emphasis>Kwm</emphasis>?</title>

<para>Eu perdi vários dias aprenndendo como configurar dez gerenciadores de janela
diferentes. Agora que eu tenho 678 linhas de arquivos de recurso fazendo 
exatamente o que eu quero, você vem e quer tirar meu gerenciador de janelas !</para>

<para><emphasis remap="bf">Resposta</emphasis>: Você não <emphasis>precisa</emphasis> abandonar seu gerenciador de janelas
atual, é só uma oferta gratuita. O KDE suporta todos os gerenciadores de
janela atualmente em uso, mas para obter todos os benefícios do KDE é 
recomendável usar o <emphasis>Kwm</emphasis>. Veja a lista de
<link linkend="Features">Recursos</link>.</para>
</sect1>

<sect1 id="por-que-eu-no-posso-definir-novos-atalhos-de">
<title>Por que eu não posso definir novos atalhos de teclado para iniciar aplicativos ?</title>

<para><emphasis remap="bf">Resposta</emphasis>: Porque isso não é tarefa do gerenciador de janelas.
Utilize <literal remap="tt">KGlobalShortcut</literal> para esse propósito.</para>
</sect1>

<sect1 id="por-que-o-kwm-parece-tanto-com-o-windows-95">
<title>Por que o <emphasis>Kwm</emphasis> parece tanto com o Windows 95?</title>

<para><emphasis remap="bf">Resposta</emphasis>: Ops, deixe-me ver ... (Matthias tentando encontrar
alguém que tem Windows 95 pois ele não tem Windows 95 em nenhum de seus
computadores.... hmmmm, ninguém usa Windows 95 aqui. Bem, vamos pegar uma
distribuição Linux meio velha e instalar o fvwm95-2 ...) Não, não posso
confirmar isso. O Kwm tem melhor aparência e oferece mais funcionalidade
de gerenciamento de janelas.</para>
</sect1>

<sect1 id="possvel-adicionar-extenses-do-kde-a-outros">
<title>É possível adicionar extensões do KDE a outros gerenciadores de janelas ?</title>

<para><emphasis remap="bf">Resposta</emphasis>: Sim, é possível. Basta você estudar os programas
<literal remap="tt">kwm.h</literal> e <literal remap="tt">kwm.C</literal> do pacote <literal remap="tt">libkdecore</literal> e estender
seu gerenciador de janelas favorito para que responda corretamente às
estensões. Também é possível implementar um intermediário de requisição de
objetos em assembler x86. É só uma questão de relação investimento/resultado.</para>
</sect1>

<sect1 id="o-kwm-suporta-janelas-sombreadas-a-la-openst">
<title>O <emphasis>Kwm</emphasis> suporta janelas sombreadas a la <emphasis>OpenStep</emphasis>?</title>

<para><emphasis remap="bf">Resposta</emphasis>: Sim.</para>
</sect1>
</chapter>

<chapter id="Eplogo">
<title>Epílogo</title>

<sect1 id="desenvolvedor">
<title>Desenvolvedor</title>

<para><literal remap="tt"><ulink url="mailto:ettrich@kde.org">Matthias Ettrich</ulink></literal></para>
</sect1>

<sect1 id="autores">
<title>Autores</title>

<para><literal remap="tt"><ulink url="mailto:ettrich@kde.org">Matthias Ettrich</ulink></literal></para>

<para><literal remap="tt"><ulink url="mailto:sschaub@csmail.bju.edu">Stephen Schaub</ulink></literal> - Editor</para>

<para><literal remap="tt"><ulink url="mailto:kalle@kde.org">Kalle Dalheimer</ulink></literal> - Editor</para>

<para><literal remap="tt"><ulink url="mailto:rwilliams@kde.org">Robert Williams</ulink></literal> - Editor</para>

<para><literal remap="tt">Tradução para Português do Brasil: <ulink url="mailto:epx@netville.com.br">Elvis Pfützenreuter</ulink></literal></para>
</sect1>
</chapter>
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->
