Do not change workspace during deiconify animation
[wmaker-crm.git] / INSTALL.pt
blob061a962ea673d6dd17f41f6b435f8feeaf2769df
1                 Instruções de Instalação do Window Maker
4 PLATAFORMAS SUPORTADAS
5 ======================
6 (obs: fiquei sabendo que conseguiram compilar nesses sistemas...)
8 - Intel GNU/Linux Slackware 3.5 (plataforma primária)
9 - outras distribuições do Intel GNU/Linux 
10 - Sparc GNU/Linux RedHat 5.1
11 - PowerPC GNU/MkLinux
12 - Alpha GNU/Linux RedHat 5.1
13 - FreeBSD
14 - NetBSD
15 - OpenBSD
16 - BSDI 4.0
17 - Solaris 2.5.1, 2.5.2
18 - Solaris 2.6.0
19 - Solaris 2.7beta
20 - SCO Unix
21 - SGI Irix 5.x, 6.5
22 - OSF/1
23 - HP-UX
24 - AIX 3.2.5
25 - AIX 4.1.4 / IBM PowerPC
26 - AIX 4.3.1 / IBM CC compiler
27 - AIX 4.3.2 / IBM PowerPC
28 - AIX 5.3
29 - DEC Alpha/Digital UNIX 4.x
30 - XFree86 / OS/2
31 - Corel NetWinder
32 - SunOS 4.x
33 - PowerMac / Power MachTen 4.1.1 em MacOS
34 - Amiga 3000 rodando RedHat Linux 5.1 (Rawhide)
36 Patches que possibilitem a execução em outras plataformas serão bem-vindos.
38 Se a última versão não funcionou para você, tente a 0.53.0,
39 que é conhecida por ser bastante estável em várias plataformas.
42 REQUERIMENTOS
43 =============
45 Os softwares a seguir são necessários para o uso do Window Maker:
47 - X11R6.x       
48         O Window Maker pode ser compilado em versões mais antigas do X, como X11R5
49         (Solaris) ou X11R4 (OpenWindows) mas não funcionará 100% corretamente. Em
50         tais servidores não existirão ícones de aplicações e você terá problemas
51         usando o dock. Fazer upgrades das bibliotecas (Xlib Xt etc) ajudará se você
52         não pode fazer upgrade do servidor.
53         
54 Para compilar o Window Maker você precisará do seguinte:
56 - Requerimentos básicos e óbvios
57         Se você vai compilar o Window Maker, tenha certeza de que você possui o gcc
58         (ou outro compilador ANSI) e os arquivos headers do X. Especialmente para
59         os iniciantes em Linux: você deve instalar todos os pacotes de desenvolvimento
60         do X e a suite gcc. Do contrário você não será capaz de compilar nenhum
61         programa X, incluindo o Window Maker.
63 - libPropList 
64         Você pode achar esta biblioteca em ftp://ftp.windowmaker.info/pub/libs ou
65         ftp://ftp.gnome.org/pub/libPropList. Você deve instalar corretamente
66         esta biblioteca antes de instalar o Window Maker.
68 - autoconf, automake and libtool
69         Estes pacotes não são necessários, mas se você tiver um ou mais deles instalados,
70         verifique se todos eles são das seguintes versões:
71                 autoconf 2.54
72                 automake 1.4
73                 libtool 1.4.2
74         Se você possui uma versão diferente, desative-os mudando os nomes dos arquivos
75         para outra coisa ou removendo-os do seu sistema. Se você não desenvolve
76         software você não precisa deles, logo, você pode desinstalá-los com segurança.
78 - lex (ou flex) e yacc (ou bison)
79         São usados pelo libPropList. O lex não seria necessário, já que o seu 
80         arquivo de saída é incluído, mas como ou eu ou o automake é um pouco
81         burro, o script de configuração para o libPropList simplesmente
82         abortará sem motivo caso o lex não seja achado.
85 OPCIONAL:
86 =========
87 Estas bibliotecas não são necessárias para que o Window Maker funcione, mas elas
88 são suportadas caso você deseje usá-las. Os números das versões são os que eu
89 possuo (e portanto quase certamente funcionarão), mas outras versões devem funcionar
90 também.
93 - libXPM 4.7 ou mais atual
94         Versões antigas podem não funcionar.
95         Disponível em ftp://sunsite.unc.edu/pub/Linux/libs/X/
96         Há suporte nativo para arquivos XPM, mas ele não carregará imagens em
97         algumas formatos incomuns.
99 - libpng 0.96 ou mais atual e zlib
100         Para suporte a imagens PNG.
102 - libtiff 3.4 ou mais atual
103         Para suporte a imagens TIFF. Você pode baixar o libtiff em
104         ftp://ftp.sgi.com/graphics/tiff.
106 - libjpeg 6.0.1 ou mais atual
107         Para suporte a imagens JPEG.
109 - libgif 2.2 ou libungif
110         Para suporte a imagens tipo GIF.
112 - GNU xgettext
113         Se você deseja usar mensagens traduzidas, será necessário o GNU gettext. Outras
114         versões do gettext não são compatíveis e não funcionarão. Baixe a versão
115         GNU através do site ftp://ftp.gnu.org
117 A maioria dos pacotes citados pode ser encontrado em ftp.uu.net/pub/graphics
121 OPÇÕES DE CONFIGURAÇÃO
122 ======================
124 Estas opções podem ser passadas ao script de configuração para ativar/desativar algumas
125 opções do Window Maker. Exemplo:
127 ./configure --enable-kde --enable-gnome
129 irá configurar o Window Maker para que seja compilado com suporte ao KDE e GNOME.
132 Para obter uma lista com outras opcoes, execute ./configure --help:
134 --with-libs-from
135         Especifica diretórios (paths) adicionais onde se deve achar as bibliotecas.
136         A flag -L deve preceder cada caminho, tal como:
137         --with-libs-from="-L/opt/libs -L/usr/local/lib"
139 --with-incs-from
140         Especifica diretórios adicionais para os arquivos de cabeçalho (header files)
141         que serão procurados. A flag -l deve preceder cada caminho descrito, tal como:
142         --with-incs-from="-I/opt/headers -I/usr/local/include"
144 --enable-single-icon
145         Permite o agrupamento de todas as aplicações com a mesma WM_CLASS+WM_INSTANCE em
146         uma só. Esta opção não é suportada por todos os desenvolvedores. Se você tiver algum
147         problema com essa opção, escreva para o seu autor: Christopher Seawood
148         <cls@seawood.org>
150 --disable-shm
151         Desativa o uso da extensão de memória compartilhada do MIT. Isto reduzirá
152         um pouco a geração de texturas, mas em alguns casos se mostrará necessário
153         em virtude de um bug que se manifesta quando manipulam-se ícones e texturas.
155 --disable-motif
156         Desativa compatibilidade com gerenciador de janelas mwm.
158 --enable-lite
159         Remove coisas que já são suportadas em ambientes desktops como o KDE
160         e o GNOME. As opções desativadas são: lista de janelas (window list), menu de
161         aplicações root (root applications menu), seleção múltipla de janelas
162         (multiple window selection). Note que não será mais possível sair do Window
163         Maker de dentro; você terá que usar o kill com o sinal SIGTERM ou sair do KDE.
164         Não é aconselhado ativar essa opção.
166 --enable-modelock
167         Suporte ao bloqueio de status de linguagem do XKB. Se você não sabe o que
168         é isto, você provavelmente não precisa.
170 --enable-sound
171         Ativa o suporte ao módulo de efeitos sonoros.
173 --disable-xpm
174         Desativa o uso da biblioteca XPM mesmo se esta estiver disponível no seu sistema.
176 --disable-png
177         Desativa o uso da biblioteca PNG
179 --disable-tiff
180         Desativa o uso da biblioteca TIFF
182 --disable-gif
183         Desativa o uso da biblioteca GIF
185 --disable-jpeg
186         Desativa o uso da biblioteca JPEG
188 --disable-shape
189         Desativa o uso das shaped windows (para oclock, xeyes etc.).
191 --enable-debug
192         Não use esta opção a não ser que saiba realmente o que está fazendo
196 NOTAS ESPECÍFICAS PARA AS PLATAFORMAS
197 =====================================
199 - máquinas DEC/Alpha
200         Você provavelmente precisará usar a flag --disable-shm para configurar,
201         como ./configure --disable-shm
203 - SCO Unix - execute o configure tal como
204         CFLAGS="-belf -DANSICPP" ./configure
206 - SunOS, Solaris
207         Se você possui o gcc instalado, execute o configure como abaixo:
208         CPP_PATH="gcc -E -x c" ./configure
209         O cpp da Sun não possui agumas funções necessárias ao Window Maker e pode
210         causar problemas quando analisados os arquivos de configuração.
211         Você pode ainda precisar usar --with-libs-from e --with-incs-from
212         para fornecer o diretório onde a libtiff está localizada.
213         Alguem me mandou um email dizendo que você precisará deixar o /usr/local/lib
214         como primeiro caminho (path) no LD_LIBRARY_PATH para que funcione.
215         
216         Se você tem uma Ultra Creator 3D ou outra máquina com gráficos high-end,
217         certifique-se de iniciar o servidor X com o visual padrão definido em 24bpp
218         ou você poderá ter problemas com cores desfiguaradas. Isto é um bug do
219         wmaker e será consertado.
221 - GNU/Linux em geral
222         Confira se você possui /etc/local/lib no /etc/ld.so.conf e rode ldconfig
223         após a instalação.
224         Remova qualquer versão em pacote do Window Maker antes de instalar uma versão
225         mais atual.
227 - RedHat GNU/Linux
228         Os sistemas RedHat apresentam vários incômodos. Se você usa, certifique-se
229         de seguir os passos abaixo ou o Window Maker não funcionará:
231         * se você instalou o Window Maker que vem junto com o Red Hat, desinstale-o
232         antes de instalar uma versão mais atual.
234         * certifique-se de que você não possui as variáveis de ambiente LANG e LINGUAS
235         configuradas como en_RN;
237         * certifique-se de que você possui /usr/local/bin na variável PATH;
239         * certifique-se de que você tem /usr/local/lib no /etc/ld.conf.so antes de
240         executar o ldconfig;
242         * se você tiver problemas que mencionem uma mensagem de erro com o
243         --no-reexec, remova a libtool-1.2b e instale a libtool-1.3. A libtool-1.3
244         pode ser encontrada em ftp.gnu.org. Também leia a seção TROUBLESHOOTING;
246         * se você instalou o pacote Window Maker do RedHat e está instalando uma
247         nova versão na mão (você mesmo está compilando), remova o pacote Window
248         Maker do seu sistema RedHat antes.
250         * certifique-se de que você possua o vínculo simbólico do /usr/include/X11
251         ao /usr/X11R6/include/X11 (se não, digite ln -s /usr/X11R6/include/X11
252         /usr/include/X11)
254         * certifique-se de que você tem o /lib/cpp apontando para o programa cpp.
256         Se você possui alguma dúvida quanto a realizar qualquer uma das tarefas acima,
257         por favor não hesite em contatar o suporte ao usuário RedHat. Eles gentilmente
258         irão responder a todas as suas dúvidas relacionadas ao sistema. Eles sabem
259         muito mais sobre o sistema deles do que nós (nós não usamos RedHat).
261 - PowerPC MkLinux
262         Você terá que possuir a última versão do Xpmac. Versões mais antigas
263         parecem ter bugs que fazem com que o sistema trave.
265 - Debian GNU/Linux
266         Se você deseja suporte a JPEG e TIFF, certifique-se que no seu sistema estão
267         instaladas as bibliotecas libtiff-dev e libjpeg-dev.
269 - SuSE GNU/Linux
270         Se você instalou o pacote Window Maker do SuSE, certifique-se de
271         removê-lo do seu sistema antes de compilar o wmaker ou você poderá
272         ter problemas.
274 - MetroX (versão desconhecida)
275         O MetroX possui uma falha que corrompe os pixmaps que são definidos
276         como backgrounds de janelas. Se você usa MetroX e está tendo problemas
277         estranhos com texturas, não use texturas nas titlebars. Ou use
278         um servidor X diferente.
280 INSTALAÇÃO:
281 ===========
283 Desempacote o WindowMaker-extra-<numero-da-versao>.tar.gz no /usr/local/share. 
285 Você pode pegar o arquivo no site ftp://ftp.windowmaker.info. Este arquivo
286 é opcional e possui alguns ícones e temas. Procure pelo último <número-da-versão>
287 disponível.
288 Ainda há o WindowMaker-extra.readme para instruí-lo sobre onde o pacote deve ir.
291 Compilando o Window Maker
292 -------------------------
293         Se você quer fazer de modo rápido e simples, digite o seguinte no seu prompt:
295         ./configure
296         make
298 depois entre como root e digite:
300         make install
301         ldconfig
303 ou se você quiser remover os símbolos de depuração dos seus binários para
304 que eles se tornem menores, você pode digitar:
306         make install-strip
307         ldconfig
309 Estes comandos irão compilar e instalar o Window Maker com parâmetros padrões. 
311 Se você deseja configurar algumas opções de compilação, você pode fazer o seguinte:
313         1.(opcional) Olhe na seção OPÇÕES DE CONFIGURAÇÃO acima para ver as
314         opções disponíveis. Execute também:
316         ./configure --help
318         para obter uma lista completa das outras opções.
320         2. Rode o configure com as opções que você deseja. Por exemplo, se
321         deseja usar a opção --enable-kde, você deve digitar:
323         ./configure --enable-kde
325         3. (opcional) Edite o arquivo src/wconfig.h com seu editor de texto
326         preferido e procure por alguma opção que deseja mudar
328         4. Compile. Só digite:
330         make
332         5. Entre como root (se você não pode fazer isso, leia a seção "Eu não tenho a
333         senha de root") e instale o Window Maker no seu sistema:
335                 su root
336                 make install
339 Configurações Específicas
340 -------------------------
342 Estas instruções não precisam ser seguidas quando for feito o upgrade do
343 Window Maker em cima de uma versão antiga, a menos que o arquivo NEWS diga
344 algo diferente.
346 Todo usuário no seu sistema que desejar rodar o Window Maker deverá fazer o seguinte:
348         1. Instalar os arquivos de configuração do Window Maker no diretório home.
349 Digite:
350         wmaker.inst
352         wmaker.inst vai instalar os arquivos de configuração do Window Maker e fazer
353         com que o X rode o Window Maker quando executado.
355         É isso!
357         Você pode digitar "man wmaker" para ver uma ajuda geral sobre configuração
358 e outras coisas.
360 Leia o Manual do Usuário para explicações mais profundas sobre o Window Maker.
362 Você deve dar uma olhada no FAQ também.
366 Eu não tenho a senha de root
367 ----------------------------
369 Se você não pode obter privilégios de super-usuário (não pode ser root) você
370 pode instalar o wmaker no seu diretório home. Para isso, forneça a opção
371 --prefix quando for rodar o configure, como explicado no passo 2 da seção
372 Compilando o Window Maker.
373 Você ainda precisará fornecer a opção --with-appspath, para especificar o
374 caminho do WPrefs.app. Exemplo:
376 ./configure --prefix=/home/jshmoe --with-appspath=/home/jshmoe/GNUstep/Applications
378 Depois faça com que /home/jshome/bin seja incluído na variável PATH, adicione
379 /home/jshome/lib na variável de ambiente LD_LIBRARY_PATH e rode bin/wmaker.inst
381 É claro, substitua /home/jshome com o seu diretório home.
384 UPGRADE
385 =======
387 Se você está fazendo um upgrade de uma versão antiga do Window maker:
388         
389         1. Configure e compile o Window Maker como sempre
390         2. Instale o Window Maker (mas não rode o wmaker.inst)
391         3. Leia o arquivo NEWS e atualize seus arquivos de configuração,
392         se necessário.
394 TROUBLESHOOTING
395 ===============
397 Quando você tiver problemas na configuração (enquanto roda o configure),
398 tal como não conseguir usar uma biblioteca de gráficos que você acha que tem
399 instalada, olhe no arquivo config.log para obter dicas sobre o que pode estar
400 errado.
402 == Erro ao carregar as fontes, mesmo quando elas existem
404 Tente reconstruir sem suporte NLS.
406 == Erro ao configurar
408 ltconfig: unrecognized option `--no-reexec'
409 Try `ltconfig --help' for more information.
410 configure: error: libtool configure failed
412 remova a opção --no-reexec do aclocal.m4 e da libPropList/aclocal.m4
413 e reconfigure.
414 Também verifique se as versões do autoconf e do automake que você tem
415 instaladas são:
416 autoconf 2.13
417 automake 1.4
418 libtool 1.3
420 Note que não deve ser libtool 1.2b, deve ser libtool 1.3.
422 == Não acha a proplist.h ou libPropList.algumacoisa
424 Baixe e instale a libPropList dos sites já citados neste arquivo.
426 == o configure não detecta a libtiff, ou outras bibliotecas gráficas.
428 Delete o config.cache, depois rode de novo o configure adicionando as
429 seguintes opções ao configure (e as outras opções que você usa):
430 --with-libs-from="-L/usr/local/lib"
431 --with-incs-from="-I/usr/local/include -I/usr/local/include/tiff"
432 Substitua o caminho para onde estão localizadas as suas bibliotecas gráficas
433 e os correspondentes arquivos de cabeçalho. Você pode colocar caminhos múltiplos
434 em qualquer uma dessas opções, como no exemplo do --with-incs-from. Só ponha um
435 espaço entre eles.
437 == o configure não detecta libXpm. 
439 * Confira se você possui um vínculo simbólico da libXpm.so.4.9 para libXpm.so
442 == Segmentation fault na inicialização
444 * Confira se a versão da libXPM é a 4.7 ou mais atual
446 * Confira se você tem uma versão atualizada do ~/GNUstep/Defaults/WindowMaker
448 Se você não tem certeza, tente renomear ~/GNUstep para ~/GNUtmp e depois rode
449 o wmaker.inst
451 == "...: your machine is misconfigured. gethostname() returned (none)"
453 * o hostname da sua máquina está definido incorretamente. Execute um man hostname
454 para obter informações de como resolver isto.
456 == O menu do root possui só 2 entradas. ("XTerm" e "Exit...")
458 * O Window Maker não está achando o cpp (o pré-processador C). Se o seu cpp
459 não está localizado em /lib/cpp, edite src/config.h e corrija o caminho
460 no CPP_PATH.
462 == checking lex output file root... configure: error: cannot find output from
463 true; giving up
465 * Leia a seção REQUERIMENTOS deste arquivo.
468 LOCALES/INTERNACIONALIZAÇÃO
469 ===========================
471 o Window Maker tem suporte a linguagem nacional. Para ativar esse suporte,
472 você precisa compilar o Window Maker com parâmetros adicionais.
474 0 - Você deve Ter o pacote do GNU gettext instalado. Este pode ser obtido
475 pelo ftp://prep.ai.mit.edu/pub/gnu/gettext-nnn.tar.gz
477 Os passos 1,2 e 3 podem ser pulados se você usa o script Install.
479 1 - Você deve selecionar as linguagens que deseja suportar. Defina a LINGUAS
480 para a lista dos locales que você deseja. O Inglês é sempre suportado. Exemplo:
482 setenv LINGUAS "pt ja de"
483 na csh
487 export LINGUAS;LINGUAS="pt ja de"
488 na sh
490 A lista dos locales suportados pode ser achado no arquivo po/README.
491 O inglês é a língua oficial.
493 Leia o arquivo po/README se você deseja traduzir e manter os arquivos 
494 locales para outras linguagens.
496 2 - Adicionalmente, se a sua linguagem usa caracteres multi-bytes, tais 
497 como as línguas japonesas e koreanas, você deve definir a opção MultiByteText
498 para YES nos arquivos ~/GNUstep/Defaults/WMGLOBAL e ~/GNUstep/Defaults/WindowMaker
500 3 - Configure, compile e instale o Window Maker normalmente.
502 4 - Para selecionar um locale particular você deve definir a variável de
503 ambiente LANG para o locale que você quer. Por exemplo, se você quer definir o
504 locale português, você deve rodar
506 setenv LANG pt
508 na csh ou
510 export LANG; LANG=pt
512 nas Bourne sh e similares
514 Nota: Se você tem a variável de ambiente LC_CTYPE definida, você deve
515 indefiní-la antes de rodar o wmaker.
517 O Window Maker procura os arquivos de definições de menu na seguinte
518 ordem (para o português brasileiro, neste caso):
520 menu.pt_BR
521 menu.pt
522 menu
525 5 -  Se você escolheu uma linguagem que usa caracteres multi-bytes, você
526 deve configurar as fontes adequadamente. Leia a página de manual para o
527 XcreateFontSet para obter mais detalhes sobre isto. Você deve mudar o arquivo
528 ~/G/D/WindowMaker para as fontes usadas nas barras de título, menus e
529 outras coisas. Para as fontes usadas nas janelas de diálogo, mude o arquivo
530 ~/G/D/WMGLOBAL. O %d no font names não deve ser removido. Você pode ainda usar
531 o wsetfont script para esta tarefa. Leia o próprio script para maiores instruções.
533 Por exemplo, você pode especificar o seguinte no ~/G/D/WindowMaker:
535 WindowTitleFont = "-*-helvetica-bold-r-normal-*-12-*,-*-*-medium-r-normal-*-14-*";
536 MenuTitleFont = "-*-helvetica-bold-r-normal-*-12-*,-*-*-medium-r-normal-*-14-*";
537 MenuTextFont = "-*-helvetica-medium-r-normal-*-12-*,-*-*-medium-r-normal-*-14-*";
538 IconTitleFont = "-*-helvetica-medium-r-normal-*-8-*,-*-*-medium-r-normal-*-12-*";
539 ClipTitleFont = "-*-helvetica-bold-r-normal-*-10-*,-*-*-medium-r-normal-*-12-*";
540 DisplayFont = "-*-helvetica-medium-r-normal-*-12-*,-*-*-medium-r-normal-*-12-*";
542 e no ~/G/D/WMGLOBAL:
544 SystemFont = "-*-*-medium-r-normal-*-%d-*-*-*-*-*-*-*";
545 BoldSystemFont = "-*-*-medium-r-normal-*-%d-*-*-*-*-*-*-*";
548 As duas fontes acima são usadas somente por aplicações que
549 usem WINGs (o Window Maker e WPrefs.app)
551 O script wsetfont que é fornecido vai permitir com que você mude as
552 definições de fonte do modo mais fácil. Dê uma olhada no script para maiores
553 detalhes sobre o uso.
557 Traduzido por Ricardo Sartori <sartori@inf.ufsc.br>