removed WErrorCode
[wmaker-crm.git] / README.pt
blob2a51d702683af4495d13ed4f4cff924bb56afa0b
3                             GNU Window Maker
4                         Gerenciador de Janelas X11
5         
6                           <http://windowmaker.org>
7                          <ftp://ftp.windowmaker.org>
9                                      por
11                                 Alfredo K. Kojima 
13                                    Dan Pascu
15                                  Matthew Hawkins
17                                         ]d
20                                     Web/FTP Master
22                                     Phillip Smith
26                 Parabéns! Você acabou de adquirir um dispositivo muito
27       bom que lhe proporcionaria milhares de anos de uso sem problemas,
28       exceto por que, você, com vai certeza destruí-lo com algum procedimento
29       idiota típico dos consumidores. Por isso nós pedimos POR FAVOR,
30       PELO AMOR DE DEUS LEIA O MANUAL DO DONO COM MUITA ATENÇÃO ANTES
31       DE DESEMBRULHAR O DISPOSITIVO. VOCÊ JÁ O DESEMPACOTOU, NÃO FOI?
32       VOCÊ DESEMPACOTOU-O, CONECTOU-O, LIGOU-O E ENCHEU-O DE COISAS,
33       E AGORA A SUA CRIANÇA, A MESMA CRIANÇA QUE UMA VEZ ENFIOU UMA
34       SALSICHA NO SEU VIDEOCASSETE E APERTOU NO "FAST FORWARD", ESTA
35       CRIANÇA ESTÁ BRINCANDO COM OS BOTÕES TAMBÉM CERTO? E SÓ AGORA VOCÊ
36       ESTÁ COMEÇANDO A LER AS INSTRUÇÕES CERTO??? NÓS PODEMOS ENTÃO QUEBRAR 
37       ESTES DISPOSITIVOS NA FÁBRICA ANTES DE DESPACHÁ-LOS, VOCÊ
38       SABIA DISSO?
39                                 -- Dave Barry, "Read This First!"
42 Descrição
43 =========
45 O Window Maker é o gerenciador de janelas GNU para o X Window System. Ele foi
46 desenvolvido para emular o visual e a sensação de parte da GUI NEXTSTEP(tm).
47 Procura ser relativamente rápido e pequeno, rico em opções, fácil de 
48 configurar e usar, com uma aparência simples e elegante emprestada do
49 NEXTSTEP(tm).
51 O Window Maker foi projetado tendo em mente a integração com o GNUStep e
52 é o gerenciador de janelas "oficial" dele. É ainda parte do projeto GNU
53 (www.gnu.org).
54 Leia mais sobre o GNUstep neste arquivo.
56 Hints (informações dadas pelas aplicações para que se integrem bem com o 
57 gerenciador de janelas) para Motif(tm), OPEN LOOK(tm), KDE e GNOME também
58 são suportados. Logo, você pode substituir os gerenciadores de janela desses
59 ambientes pelo Window Maker e manter muito, senão toda a funcionalidade do 
60 gerenciador de janelas nativo.
62 O Window Maker antes se chamava WindowMaker.
64 O Window Maker não tem relação com o Windowmaker, o software para construção
65 de janelas e portas.
68 Documentação
69 ============
71 Leia antes de perguntar.
73 * Os arquivos README distribuídos por toda a árvore dos fontes contêm
74   informações relacionadas ao conteúdo dos diretórios.
76 * O INSTALL possui instruções para instalação e algumas dicas quando há 
77   algum problema. Você deveria lê-lo antes da instalação. Ele não foi escrito
78   somente para ocupar espaço no pacote...
80 * FAQ: Frequently Asked Questions. LEIA! O FAQ.I18N é sobre questões 
81   relacionadas à internacionalização.
83 * NEWS: lista as mudanças de uma versão para outra e que são visíveis ao
84   usuário. Leia-o se você estiver fazendo uma atualização.
86 * MIRRORS: alguns locais alternativos onde você pode pegar o Window Maker, 
87   incluindo pacotes do Window Maker específicos para certas plataformas.
89 * BUGFORM: use-o para enviar relatos de bug. Use-o por favor.
91 * ChangeLog: o que foi mudado a partir da última versão?
93 * BUGS: lista dos bugs conhecidos
96 *** Guia do Usuário
98 O Guia do Usuário Window Maker pode ser baixado do ftp oficial ou por 
99 sites web. Pode ser visto ainda no formato HTML no:
100 http://people.delphi.com/crc3419/WMUserGuide/index.htm
102 O Guia do Usuário explica como usar o Window Maker, fala sobre os 
103 arquivos de configuração e as opções.
105 *** man pages
107 Digite "man wmaker" no prompt da shell para obter uma ajuda geral sobre
108 o Window Maker.
111 Diretórios & Arquivos na Árvore dos Fontes
112 ==========================================
114 * O Install é um script para configurar e compilar o Window Maker de 
115   um modo fácil (não que o modo normal seja difícil, mas...).
117 * AUTHORS: os créditos
119 * TODO: planos para o futuro
121 * O contrib/ possui alguns patches enviados e que não foram suportados 
122   pelo Window Maker por entrarem em conflito com a filosofia de projeto dos 
123   desenvolvedores ou por algum outro motivo.
125 * O util/ possui vários programas utilitários.
127 * O WPrefs.app/ é o programa de configuração. 
129 * O src/wconfig.h possui opções de compilação que você pode mudar para 
130   selecionar algumas opções/aspectos e outras coisas mais.
132 * O WINGs/ é a biblioteca de widget NEXTSTEP lookalike
134 * A wrlib/ é a biblioteca de processamento de imagens
136 * O po/ possui catálogos de mensagens, que são versões traduzidas das 
137   mensagens mostradas pelo Window Maker
139 * A docklib-x.x.tar.gz é a biblioteca para desenvolvimento de dockapps
142 SOCORRO!!!
143 ==========
145 Há uma lista de discussão para debate de questões sobre o Window Maker
146 no wm-user@windowmaker.org. Para inscrever-se, mande uma mensagem
147 contendo:
148         subscribe
149 no campo de assunto da mensagem para wm-user-request@windowmaker.org
151 Se você tiver algum problema, pergunte lá (somente depois de ter lido os
152 documentos, é claro). As pessoas da lista estão mais preparadas para 
153 resolver o seu problema do que nós. Para relatar BUGS, use o BUGFORM.
155 Se você tiver problemas com uma versão pré-compilada do Window
156 Maker (rpm, deb etc), primeiro questione a pessoa que criou o pacote.
158 NOTA IMPORTANTE: quando for pedir ajuda (seja na lista de discussão ou 
159 diretamente aos desenvolvedores) *sempre* envie informações sobre o sistema
160 que você está usando. Você pode usar a seção system information no final
161 do BUGFORM como guia. Outra coisa: não mande mensagens em HTML.
163 Há ainda o canal de IRC #windowmaker na EFNET. Para entrar lá, conecte
164 seu cliente de irc no irc.concentric.net, irc.prison.net ou outro 
165 servidor dessa rede.
168 GNUstep
169 =======
171 O GNUstep é um completo sistema de desenvolvimento orientado a objetos,
172 baseado na especificação OpenStep lançada pela NeXT(tm) (agora Apple(tm) e
173 Sun(tm)). Ele irá fornecer tudo que é necessário para desenvolver aplicações
174 orientadas a objetos,  gráficas (e não gráficas), cross-platform; fornecendo,
175 dentre outras coisas, bibliotecas bases do sistema, uma estrutura de alto
176 nível para aplicações GUI que usa um modelo de imagens do tipo Display
177 PostScript(tm), objetos para acesso a bancos de dados relacional, objetos
178 distribuídos e um ambiente de desenvolvimento gráfico, com ferramentas como
179 um modelador de interfaces, um projeto de gerenciamento de sistema (central
180 de projetos) e outras ferramentas.
182 O sistema de desenvolvimento GNUstep será usado para criar um ambiente
183 de usuário, com tudo necessário para uma interface gráfica, tais como
184 visualizador de arquivos, editores de texto e outras aplicações. Note que o
185 ambiente do usuário (ou "ambiente desktop") é somente uma pequena parte de
186 todo o projeto GNUstep e não "compete" com projetos como o KDE e o GNOME,
187 simplesmente por que eles são coisas completamente diferentes.
189 Para mais informação sobre o projeto GNUstep, visite http://www.gnustep.org
190 e http://gnustep.current.nu
193 Executando múltiplas instâncias do Window Maker
194 ===============================================
196 Não é uma boa idéia rodar mais de uma instância do Window Maker sob
197 um mesmo usuário ao mesmo tempo (já que o wmaker usa os mesmos arquivos 
198 de configuração). Você pode obter comportamentos inesperados quando o 
199 Window Maker atualizar os seus arquivos de configuração.
202 Suporte para som
203 ================
205 O Som é suportado nos sistemas Linux e FreeBSD com o uso de módulos
206 distribuídos separadamente. Você pode baixá-los no: 
207 http://www.frontiernet.net/~southgat/wmsound
209 Observe que você deve compilar o Window Maker usando o configure com a
210 flag --enable-sound e definindo a opção DisableSound para NO.
213 Suporte ao OpenL**k
214 ===================
216 Acredito que muitos usuários, principalmente os do mundo acadêmico,
217 tenham que usar aplicações escritas em toolkits OpenL**k, então o suporte
218 para estes aplicativos deve ser de algum uso.
220 Para ativar, use o --enable-openlook quando rodar o configure. Note
221 que nem tudo está implementado.
223 As opções implementadas incluem hints de decoração e o push-pin.
224 Coisas não implementadas incluem _SUN_WINDOW_STATE (the compose led 
225 state stuff), coisas relacionadas ao "drag and drop", cabeçalho (não 
226 tenho certeza do que é) e o string footer.
228 Por favor me dêem retorno se algo não funcionar. Se a opção já está
229 implementada, mas não está funcionando por causa de um bug, eu tentarei
230 corrigí-la. Se é uma característica ainda não implementada e você mencionar
231 que é importante (ie: não somente cosmética), eu considerarei a sua 
232 implementação.
234 O estado "out" do pushpin é emulado como um botão de fechar pressionado.
235 Clique no botão para fazer com que ele fique despressionado, o que 
236 corresponde ao estado "pinned-in" do pushpin. Se você pressionar de novo
237 o botão de fechar despressionado, ele vai agir como um botão de fechar
238 normal: vai fechar a janela.
241 Ajuste da Performance
242 ====================
244 Se você deseja diminuir o uso de memória pelo Window Maker, aumentar a 
245 performance, e ainda manter uma boa aparência e funcionalidade, siga os
246 itens abaixo:
248 - use texturas sólidas para tudo, barras de títulos e menus. Se você quer
249   um desktop com um belo visual, use o estilo "Traditional".
250 - desligue o "NewStyle" e o "Superfluous"
251 - não vincule muitos atalhos ao seu menu e guarde somente coisas essenciais
252   no menu
253 - ative o "DisableClip"
254 - edite o wconfig.h e desative o NUMLOCK_HACK e as opções que você não
255   usa mesmo (tenha em mente que alguns dos #defines podem não funcionar,
256   já que eles não estão completamente suportados). Certifique-se de sempre
257   manter o NumLock e o ScrollLock desligados.
258 - ligue a opção "DisableAnimations". Você pode também usar o #undefine
259   ANIMATIONS no arquivo config.h
260 - verifique as entradas padrão "IconPath" e "PixmapPath" para que contenham
261   somente os paths que você realmente possua no seu sistema.
262 - não use imagens grandes no seu background root
263 - remova o suporte para formatos de imagens que você não usa
264 - para reduzir o uso de memória, desative o cache de ícones, definindo a
265   variável de ambiente RIMAGE_CACHE para 0. Se você deseja melhorar o
266   desempenho perdendo só um pouco de memória, defina essa variável para
267   o valor correspondente ao número de ícones que você usa.
270 Controle de Mouse pelo Teclado
271 ==============================
273 Muitas pessoas perguntam sobre adicionar o controle do mouse pelo teclado,
274 como no fvwm, mas o Window Maker não possui tal opção. A extensão XKB
275 suporta a simulação do mouse pelo teclado, de uma maneira muito mais 
276 poderosa do que qualquer outra simulação realizada por um gerenciador de 
277 janelas.
279 Para ativá-la, aperte a combinação Control+Shift+NumLock ou Shift+NumLock.
280 Você deve então ouvir um beep. Para desativá-la, faça a mesma coisa.
282 Para controlar com o mouse, use as seguintes teclas do keypad:
283 - 4 (seta esquerda), 7 (Home), 8 (seta para cima), 9 (PgUp), 6 (seta direita), 
284 3 (PgDn), 2 (seta para baixo) e 1 (End) move o mouse para as direções
285 correspondentes;
286 - segurar as teclas acima e depois segurar a tecla 5 vai fazer o ponteiro
287 se mover mais rápido;
288 - / vai selecionar o primeiro botão do mouse (botão esquerdo);
289 - * vai selecionar o segundo botão do mouse (botão do meio);
290 - - vai selecionar o terceiro botão do mouse (botão direito);
291 - 5 vai fazer um clique com o botão do mouse que foi selecionado;
292 - + vai fazer um duplo-clique com o botão do mouse que foi selecionado;
293 - 0 (Ins) vai clicar e segurar o botão do mouse selecionado;
294 - . (Del) vai liberar o botão do mouse selecionado que foi previamente
295 clicado com a tecla 0 (Ins).
297 Os valores das teclas acima funcionam com um servidor X XFree86 3.2 (X11R6.1)
298 mas nosso alcance pode variar.
301 Como fazer um backtrace com o gdb
302 =================================
304 Os backtraces nos ajudam a arrumar bugs que fazem com que o Window Maker
305 trave. Se você achar um bug que trave o Window Maker, por favor envie o
306 backtrace com o relato do bug.
308 Para fazer um backtrace útil, você precisa de um arquivo core
309 com informações de depuração produzidas pelo Window Maker quando ele
310 travar.  O padrão do Window Maker é iniciar um outro gerenciador
311 de janelas quando ele travar, o que não gerará um arquivo core. Você
312 precisa editar o arquivo src/wconfig.h *depois* de ter rodado o configure
313 e mudar a linha que se parece com o seguinte:
315 #undef NO_EMERGENCY_AUTORESTART
317 para:
319 #define NO_EMERGENCY_AUTORESTART
321 Depois, no diretório src, digite:
322 make clean
323 make CFLAGS=-g
324 make install
326 e espere o Window Maker ser instalado.
328 Depois de instalado o Window Maker, inicie o X e reproduza o bug fazendo
329 com que o Window Maker trave. Quando ele travar, vá até o diretório
330 onde você compilou o wmaker e digite o seguinte comando na sua shell:
332 script
333 cd src
334 gdb .libs/wmaker path_ao_arquivo_core
336 Depois, no prompt do gdb, digite "bt". Saia do gdb digitando "quit"
337 e depois no prompt da shell, digite "exit".
339 O arquivo chamado typescript conterá o backtrace.
343 Direitos Autorais & Disclaimers
344 ===============================
346 O Window Maker é registrado por Alfredo K. Kojima e é licenciado pela Licença
347 Pública Geral GNU. Leia o arquivo COPYING para ler a licença completa.
349 Os ícones que são distribuídos com esse programa foram criados por Marco
350 van Hylckama Vlieg são licenciados pela OpenContent License. Leia o
351 arquivo COPYING.OPL para a licença completa.
353 NeXT, OpenStep e NEXTSTEP são marcas da NeXT Computer, Inc.
354 Todas as outras marcas são propriedade dos respectivos donos.
356 Os autores se reservam no direito de fazer alterações no software sem
357 qualquer aviso prévio.
360 Autores
361 =======
363 Alfredo K. Kojima <kojima@windowmaker.org>
364 Dan Pascu <dan@windowmaker.org>
365 ]d <id@windowmaker.org>
367 Por favor não nos perguntem coisas antes de ler a documentação (o FAQ,
368 este arquivo e os arquivos INSTALL), ou sobre coisas "legais" que você
369 viu em screenshots de desktops.
371 O arquivo AUTHORS contem uma lista de pessoas que contribuíram com o projeto.
372 O nome das pessoas que ajudaram com a tradução pode ser achado no po/README e
373 Window Maker/README
375 Se você tem algum comentário, correção ou deseja relatar bugs (junto com
376 o BUGFORM) mande-os para developers@windowmaker.org
379 Traduzido por: Ricardo Sartori <sartori@inf.ufsc.br>