Repair wgethomedir(), broken a little while back
[wmaker-crm.git] / README.pt
blob4600b1a40e2a6ebe5377c4fbf9905856aabfbfe4
3                             GNU Window Maker
4                         Gerenciador de Janelas X11
5         
6                           <http://windowmaker.info>
7                          <ftp://ftp.windowmaker.info>
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.info. Para inscrever-se, mande uma mensagem
147 contendo:
148         subscribe
149 no campo de assunto da mensagem para wm-user-request@windowmaker.info
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 Ajuste da Performance
214 ====================
216 Se você deseja diminuir o uso de memória pelo Window Maker, aumentar a 
217 performance, e ainda manter uma boa aparência e funcionalidade, siga os
218 itens abaixo:
220 - use texturas sólidas para tudo, barras de títulos e menus. Se você quer
221   um desktop com um belo visual, use o estilo "Traditional".
222 - desligue o "NewStyle" e o "Superfluous"
223 - não vincule muitos atalhos ao seu menu e guarde somente coisas essenciais
224   no menu
225 - ative o "DisableClip"
226 - edite o wconfig.h e desative o NUMLOCK_HACK e as opções que você não
227   usa mesmo (tenha em mente que alguns dos #defines podem não funcionar,
228   já que eles não estão completamente suportados). Certifique-se de sempre
229   manter o NumLock e o ScrollLock desligados.
230 - ligue a opção "DisableAnimations". Você pode também usar o #undefine
231   ANIMATIONS no arquivo config.h
232 - verifique as entradas padrão "IconPath" e "PixmapPath" para que contenham
233   somente os paths que você realmente possua no seu sistema.
234 - não use imagens grandes no seu background root
235 - remova o suporte para formatos de imagens que você não usa
236 - para reduzir o uso de memória, desative o cache de ícones, definindo a
237   variável de ambiente RIMAGE_CACHE para 0. Se você deseja melhorar o
238   desempenho perdendo só um pouco de memória, defina essa variável para
239   o valor correspondente ao número de ícones que você usa.
242 Controle de Mouse pelo Teclado
243 ==============================
245 Muitas pessoas perguntam sobre adicionar o controle do mouse pelo teclado,
246 como no fvwm, mas o Window Maker não possui tal opção. A extensão XKB
247 suporta a simulação do mouse pelo teclado, de uma maneira muito mais 
248 poderosa do que qualquer outra simulação realizada por um gerenciador de 
249 janelas.
251 Para ativá-la, aperte a combinação Control+Shift+NumLock ou Shift+NumLock.
252 Você deve então ouvir um beep. Para desativá-la, faça a mesma coisa.
254 Para controlar com o mouse, use as seguintes teclas do keypad:
255 - 4 (seta esquerda), 7 (Home), 8 (seta para cima), 9 (PgUp), 6 (seta direita), 
256 3 (PgDn), 2 (seta para baixo) e 1 (End) move o mouse para as direções
257 correspondentes;
258 - segurar as teclas acima e depois segurar a tecla 5 vai fazer o ponteiro
259 se mover mais rápido;
260 - / vai selecionar o primeiro botão do mouse (botão esquerdo);
261 - * vai selecionar o segundo botão do mouse (botão do meio);
262 - - vai selecionar o terceiro botão do mouse (botão direito);
263 - 5 vai fazer um clique com o botão do mouse que foi selecionado;
264 - + vai fazer um duplo-clique com o botão do mouse que foi selecionado;
265 - 0 (Ins) vai clicar e segurar o botão do mouse selecionado;
266 - . (Del) vai liberar o botão do mouse selecionado que foi previamente
267 clicado com a tecla 0 (Ins).
269 Os valores das teclas acima funcionam com um servidor X XFree86 3.2 (X11R6.1)
270 mas nosso alcance pode variar.
273 Como fazer um backtrace com o gdb
274 =================================
276 Os backtraces nos ajudam a arrumar bugs que fazem com que o Window Maker
277 trave. Se você achar um bug que trave o Window Maker, por favor envie o
278 backtrace com o relato do bug.
280 Para fazer um backtrace útil, você precisa de um arquivo core
281 com informações de depuração produzidas pelo Window Maker quando ele
282 travar.  O padrão do Window Maker é iniciar um outro gerenciador
283 de janelas quando ele travar, o que não gerará um arquivo core. Você
284 precisa editar o arquivo src/wconfig.h *depois* de ter rodado o configure
285 e mudar a linha que se parece com o seguinte:
287 #undef NO_EMERGENCY_AUTORESTART
289 para:
291 #define NO_EMERGENCY_AUTORESTART
293 Depois, no diretório src, digite:
294 make clean
295 make CFLAGS=-g
296 make install
298 e espere o Window Maker ser instalado.
300 Depois de instalado o Window Maker, inicie o X e reproduza o bug fazendo
301 com que o Window Maker trave. Quando ele travar, vá até o diretório
302 onde você compilou o wmaker e digite o seguinte comando na sua shell:
304 script
305 cd src
306 gdb .libs/wmaker path_ao_arquivo_core
308 Depois, no prompt do gdb, digite "bt". Saia do gdb digitando "quit"
309 e depois no prompt da shell, digite "exit".
311 O arquivo chamado typescript conterá o backtrace.
315 Direitos Autorais & Disclaimers
316 ===============================
318 O Window Maker é registrado por Alfredo K. Kojima e é licenciado pela Licença
319 Pública Geral GNU. Leia o arquivo COPYING para ler a licença completa.
321 Os ícones que são distribuídos com esse programa foram criados por Marco
322 van Hylckama Vlieg são licenciados pela GPL. 
324 NeXT, OpenStep e NEXTSTEP são marcas da NeXT Computer, Inc.
325 Todas as outras marcas são propriedade dos respectivos donos.
327 Os autores se reservam no direito de fazer alterações no software sem
328 qualquer aviso prévio.
331 Autores
332 =======
334 Alfredo K. Kojima <kojima@windowmaker.info>
335 Dan Pascu <dan@windowmaker.info>
336 ]d <id@windowmaker.info>
338 Por favor não nos perguntem coisas antes de ler a documentação (o FAQ,
339 este arquivo e os arquivos INSTALL), ou sobre coisas "legais" que você
340 viu em screenshots de desktops.
342 O arquivo AUTHORS contem uma lista de pessoas que contribuíram com o projeto.
343 O nome das pessoas que ajudaram com a tradução pode ser achado no po/README e
344 Window Maker/README
346 Se você tem algum comentário, correção ou deseja relatar bugs (junto com
347 o BUGFORM) mande-os para developers@windowmaker.info
350 Traduzido por: Ricardo Sartori <sartori@inf.ufsc.br>