Some menu entry beautification
[wmaker-crm.git] / INSTALL.pt
blobaed1a069b82cb2936c84e6f9e32cebc1e9ad6253
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.org/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.13
72                 automake 1.4
73                 libtool 1.3
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-openlook
159         Ativa compatibilidade com gerenciador de janelas OPEN LOOK(tm).
161 --enable-gnome
162         Ativa compatibilidade com gerenciador de janelas GNOME.
164 --enable-kde
165         Ativa compatibilidade com gerenciador de janelas kde/kwm.
167 --enable-lite
168         Remove coisas que já são suportadas em ambientes desktops como o KDE
169         e o GNOME. As opções desativadas são: lista de janelas (window list), menu de
170         aplicações root (root applications menu), seleção múltipla de janelas
171         (multiple window selection). Note que não será mais possível sair do Window
172         Maker de dentro; você terá que usar o kill com o sinal SIGTERM ou sair do KDE.
173         Não é aconselhado ativar essa opção.
175 --enable-modelock
176         Suporte ao bloqueio de status de linguagem do XKB. Se você não sabe o que
177         é isto, você provavelmente não precisa.
179 --enable-sound
180         Ativa o suporte ao módulo de efeitos sonoros.
182 --disable-xpm
183         Desativa o uso da biblioteca XPM mesmo se esta estiver disponível no seu sistema.
185 --disable-png
186         Desativa o uso da biblioteca PNG
188 --disable-tiff
189         Desativa o uso da biblioteca TIFF
191 --disable-gif
192         Desativa o uso da biblioteca GIF
194 --disable-jpeg
195         Desativa o uso da biblioteca JPEG
197 --disable-shape
198         Desativa o uso das shaped windows (para oclock, xeyes etc.).
200 --enable-debug
201         Não use esta opção a não ser que saiba realmente o que está fazendo
205 NOTAS ESPECÍFICAS PARA AS PLATAFORMAS
206 =====================================
208 - máquinas DEC/Alpha
209         Você provavelmente precisará usar a flag --disable-shm para configurar,
210         como ./configure --disable-shm
212 - SCO Unix - execute o configure tal como
213         CFLAGS="-belf -DANSICPP" ./configure
215 - SunOS, Solaris
216         Se você possui o gcc instalado, execute o configure como abaixo:
217         CPP_PATH="gcc -E -x c" ./configure
218         O cpp da Sun não possui agumas funções necessárias ao Window Maker e pode
219         causar problemas quando analisados os arquivos de configuração.
220         Você pode ainda precisar usar --with-libs-from e --with-incs-from
221         para fornecer o diretório onde a libtiff está localizada.
222         Alguem me mandou um email dizendo que você precisará deixar o /usr/local/lib
223         como primeiro caminho (path) no LD_LIBRARY_PATH para que funcione.
224         
225         Se você tem uma Ultra Creator 3D ou outra máquina com gráficos high-end,
226         certifique-se de iniciar o servidor X com o visual padrão definido em 24bpp
227         ou você poderá ter problemas com cores desfiguaradas. Isto é um bug do
228         wmaker e será consertado.
230 - GNU/Linux em geral
231         Confira se você possui /etc/local/lib no /etc/ld.so.conf e rode ldconfig
232         após a instalação.
233         Remova qualquer versão em pacote do Window Maker antes de instalar uma versão
234         mais atual.
236 - RedHat GNU/Linux
237         Os sistemas RedHat apresentam vários incômodos. Se você usa, certifique-se
238         de seguir os passos abaixo ou o Window Maker não funcionará:
240         * se você instalou o Window Maker que vem junto com o Red Hat, desinstale-o
241         antes de instalar uma versão mais atual.
243         * certifique-se de que você não possui as variáveis de ambiente LANG e LINGUAS
244         configuradas como en_RN;
246         * certifique-se de que você possui /usr/local/bin na variável PATH;
248         * certifique-se de que você tem /usr/local/lib no /etc/ld.conf.so antes de
249         executar o ldconfig;
251         * se você tiver problemas que mencionem uma mensagem de erro com o
252         --no-reexec, remova a libtool-1.2b e instale a libtool-1.3. A libtool-1.3
253         pode ser encontrada em ftp.gnu.org. Também leia a seção TROUBLESHOOTING;
255         * se você instalou o pacote Window Maker do RedHat e está instalando uma
256         nova versão na mão (você mesmo está compilando), remova o pacote Window
257         Maker do seu sistema RedHat antes.
259         * certifique-se de que você possua o vínculo simbólico do /usr/include/X11
260         ao /usr/X11R6/include/X11 (se não, digite ln -s /usr/X11R6/include/X11
261         /usr/include/X11)
263         * certifique-se de que você tem o /lib/cpp apontando para o programa cpp.
265         Se você possui alguma dúvida quanto a realizar qualquer uma das tarefas acima,
266         por favor não hesite em contatar o suporte ao usuário RedHat. Eles gentilmente
267         irão responder a todas as suas dúvidas relacionadas ao sistema. Eles sabem
268         muito mais sobre o sistema deles do que nós (nós não usamos RedHat).
270 - PowerPC MkLinux
271         Você terá que possuir a última versão do Xpmac. Versões mais antigas
272         parecem ter bugs que fazem com que o sistema trave.
274 - Debian GNU/Linux
275         Se você deseja suporte a JPEG e TIFF, certifique-se que no seu sistema estão
276         instaladas as bibliotecas libtiff-dev e libjpeg-dev.
278 - SuSE GNU/Linux
279         Se você instalou o pacote Window Maker do SuSE, certifique-se de
280         removê-lo do seu sistema antes de compilar o wmaker ou você poderá
281         ter problemas.
283 - MetroX (versão desconhecida)
284         O MetroX possui uma falha que corrompe os pixmaps que são definidos
285         como backgrounds de janelas. Se você usa MetroX e está tendo problemas
286         estranhos com texturas, não use texturas nas titlebars. Ou use
287         um servidor X diferente.
289 INSTALAÇÃO:
290 ===========
292 Desempacote o WindowMaker-extra-<numero-da-versao>.tar.gz no /usr/local/share. 
294 Você pode pegar o arquivo no site ftp://ftp.windowmaker.org. Este arquivo
295 é opcional e possui alguns ícones e temas. Procure pelo último <número-da-versão>
296 disponível.
297 Ainda há o WindowMaker-extra.readme para instruí-lo sobre onde o pacote deve ir.
300 Compilando o Window Maker
301 -------------------------
302         Se você quer fazer de modo rápido e simples, digite o seguinte no seu prompt:
304         ./configure
305         make
307 depois entre como root e digite:
309         make install
310         ldconfig
312 ou se você quiser remover os símbolos de depuração dos seus binários para
313 que eles se tornem menores, você pode digitar:
315         make install-strip
316         ldconfig
318 Estes comandos irão compilar e instalar o Window Maker com parâmetros padrões. 
320 Se você deseja configurar algumas opções de compilação, você pode fazer o seguinte:
322         1.(opcional) Olhe na seção OPÇÕES DE CONFIGURAÇÃO acima para ver as
323         opções disponíveis. Execute também:
325         ./configure --help
327         para obter uma lista completa das outras opções.
329         2. Rode o configure com as opções que você deseja. Por exemplo, se
330         deseja usar a opção --enable-kde, você deve digitar:
332         ./configure --enable-kde
334         3. (opcional) Edite o arquivo src/wconfig.h com seu editor de texto
335         preferido e procure por alguma opção que deseja mudar
337         4. Compile. Só digite:
339         make
341         5. Entre como root (se você não pode fazer isso, leia a seção "Eu não tenho a
342         senha de root") e instale o Window Maker no seu sistema:
344                 su root
345                 make install
348 Configurações Específicas
349 -------------------------
351 Estas instruções não precisam ser seguidas quando for feito o upgrade do
352 Window Maker em cima de uma versão antiga, a menos que o arquivo NEWS diga
353 algo diferente.
355 Todo usuário no seu sistema que desejar rodar o Window Maker deverá fazer o seguinte:
357         1. Instalar os arquivos de configuração do Window Maker no diretório home.
358 Digite:
359         wmaker.inst
361         wmaker.inst vai instalar os arquivos de configuração do Window Maker e fazer
362         com que o X rode o Window Maker quando executado.
364         É isso!
366         Você pode digitar "man wmaker" para ver uma ajuda geral sobre configuração
367 e outras coisas.
369 Leia o Manual do Usuário para explicações mais profundas sobre o Window Maker.
371 Você deve dar uma olhada no FAQ também.
375 Eu não tenho a senha de root
376 ----------------------------
378 Se você não pode obter privilégios de super-usuário (não pode ser root) você
379 pode instalar o wmaker no seu diretório home. Para isso, forneça a opção
380 --prefix quando for rodar o configure, como explicado no passo 2 da seção
381 Compilando o Window Maker.
382 Você ainda precisará fornecer a opção --with-appspath, para especificar o
383 caminho do WPrefs.app. Exemplo:
385 ./configure --prefix=/home/jshmoe --with-appspath=/home/jshmoe/GNUstep/Apps
387 Depois faça com que /home/jshome/bin seja incluído na variável PATH, adicione
388 /home/jshome/lib na variável de ambiente LD_LIBRARY_PATH e rode bin/wmaker.inst
390 É claro, substitua /home/jshome com o seu diretório home.
393 UPGRADE
394 =======
396 Se você está fazendo um upgrade de uma versão antiga do Window maker:
397         
398         1. Configure e compile o Window Maker como sempre
399         2. Instale o Window Maker (mas não rode o wmaker.inst)
400         3. Leia o arquivo NEWS e atualize seus arquivos de configuração,
401         se necessário.
403 TROUBLESHOOTING
404 ===============
406 Quando você tiver problemas na configuração (enquanto roda o configure),
407 tal como não conseguir usar uma biblioteca de gráficos que você acha que tem
408 instalada, olhe no arquivo config.log para obter dicas sobre o que pode estar
409 errado.
411 == Erro ao carregar as fontes, mesmo quando elas existem
413 Tente reconstruir sem suporte NLS.
415 == Erro ao configurar
417 ltconfig: unrecognized option `--no-reexec'
418 Try `ltconfig --help' for more information.
419 configure: error: libtool configure failed
421 remova a opção --no-reexec do aclocal.m4 e da libPropList/aclocal.m4
422 e reconfigure.
423 Também verifique se as versões do autoconf e do automake que você tem
424 instaladas são:
425 autoconf 2.13
426 automake 1.4
427 libtool 1.3
429 Note que não deve ser libtool 1.2b, deve ser libtool 1.3.
431 == Não acha a proplist.h ou libPropList.algumacoisa
433 Baixe e instale a libPropList dos sites já citados neste arquivo.
435 == o configure não detecta a libtiff, ou outras bibliotecas gráficas.
437 Delete o config.cache, depois rode de novo o configure adicionando as
438 seguintes opções ao configure (e as outras opções que você usa):
439 --with-libs-from="-L/usr/local/lib"
440 --with-incs-from="-I/usr/local/include -I/usr/local/include/tiff"
441 Substitua o caminho para onde estão localizadas as suas bibliotecas gráficas
442 e os correspondentes arquivos de cabeçalho. Você pode colocar caminhos múltiplos
443 em qualquer uma dessas opções, como no exemplo do --with-incs-from. Só ponha um
444 espaço entre eles.
446 == o configure não detecta libXpm. 
448 * Confira se você possui um vínculo simbólico da libXpm.so.4.9 para libXpm.so
451 == Segmentation fault na inicialização
453 * Confira se a versão da libXPM é a 4.7 ou mais atual
455 * Confira se você tem uma versão atualizada do ~/GNUstep/Defaults/WindowMaker
457 Se você não tem certeza, tente renomear ~/GNUstep para ~/GNUtmp e depois rode
458 o wmaker.inst
460 == "...: your machine is misconfigured. gethostname() returned (none)"
462 * o hostname da sua máquina está definido incorretamente. Execute um man hostname
463 para obter informações de como resolver isto.
465 == O menu do root possui só 2 entradas. ("XTerm" e "Exit...")
467 * O Window Maker não está achando o cpp (o pré-processador C). Se o seu cpp
468 não está localizado em /lib/cpp, edite src/config.h e corrija o caminho
469 no CPP_PATH.
471 == checking lex output file root... configure: error: cannot find output from
472 true; giving up
474 * Leia a seção REQUERIMENTOS deste arquivo.
477 LOCALES/INTERNACIONALIZAÇÃO
478 ===========================
480 o Window Maker tem suporte a linguagem nacional. Para ativar esse suporte,
481 você precisa compilar o Window Maker com parâmetros adicionais.
483 0 - Você deve Ter o pacote do GNU gettext instalado. Este pode ser obtido
484 pelo ftp://prep.ai.mit.edu/pub/gnu/gettext-nnn.tar.gz
486 Os passos 1,2 e 3 podem ser pulados se você usa o script Install.
488 1 - Você deve selecionar as linguagens que deseja suportar. Defina a LINGUAS
489 para a lista dos locales que você deseja. O Inglês é sempre suportado. Exemplo:
491 setenv LINGUAS "pt ja de"
492 na csh
496 export LINGUAS;LINGUAS="pt ja de"
497 na sh
499 A lista dos locales suportados pode ser achado no arquivo po/README.
500 O inglês é a língua oficial.
502 Leia o arquivo po/README se você deseja traduzir e manter os arquivos 
503 locales para outras linguagens.
505 2 - Adicionalmente, se a sua linguagem usa caracteres multi-bytes, tais 
506 como as línguas japonesas e koreanas, você deve definir a opção MultiByteText
507 para YES nos arquivos ~/GNUstep/Defaults/WMGLOBAL e ~/GNUstep/Defaults/WindowMaker
509 3 - Configure, compile e instale o Window Maker normalmente.
511 4 - Para selecionar um locale particular você deve definir a variável de
512 ambiente LANG para o locale que você quer. Por exemplo, se você quer definir o
513 locale português, você deve rodar
515 setenv LANG pt
517 na csh ou
519 export LANG; LANG=pt
521 nas Bourne sh e similares
523 Nota: Se você tem a variável de ambiente LC_CTYPE definida, você deve
524 indefiní-la antes de rodar o wmaker.
526 O Window Maker procura os arquivos de definições de menu na seguinte
527 ordem (para o português brasileiro, neste caso):
529 menu.pt_BR
530 menu.pt
531 menu
534 5 -  Se você escolheu uma linguagem que usa caracteres multi-bytes, você
535 deve configurar as fontes adequadamente. Leia a página de manual para o
536 XcreateFontSet para obter mais detalhes sobre isto. Você deve mudar o arquivo
537 ~/G/D/WindowMaker para as fontes usadas nas barras de título, menus e
538 outras coisas. Para as fontes usadas nas janelas de diálogo, mude o arquivo
539 ~/G/D/WMGLOBAL. O %d no font names não deve ser removido. Você pode ainda usar
540 o wsetfont script para esta tarefa. Leia o próprio script para maiores instruções.
542 Por exemplo, você pode especificar o seguinte no ~/G/D/WindowMaker:
544 WindowTitleFont = "-*-helvetica-bold-r-normal-*-12-*,-*-*-medium-r-normal-*-14-*";
545 MenuTitleFont = "-*-helvetica-bold-r-normal-*-12-*,-*-*-medium-r-normal-*-14-*";
546 MenuTextFont = "-*-helvetica-medium-r-normal-*-12-*,-*-*-medium-r-normal-*-14-*";
547 IconTitleFont = "-*-helvetica-medium-r-normal-*-8-*,-*-*-medium-r-normal-*-12-*";
548 ClipTitleFont = "-*-helvetica-bold-r-normal-*-10-*,-*-*-medium-r-normal-*-12-*";
549 DisplayFont = "-*-helvetica-medium-r-normal-*-12-*,-*-*-medium-r-normal-*-12-*";
551 e no ~/G/D/WMGLOBAL:
553 SystemFont = "-*-*-medium-r-normal-*-%d-*-*-*-*-*-*-*";
554 BoldSystemFont = "-*-*-medium-r-normal-*-%d-*-*-*-*-*-*-*";
557 As duas fontes acima são usadas somente por aplicações que
558 usem WINGs (o Window Maker e WPrefs.app)
560 O script wsetfont que é fornecido vai permitir com que você mude as
561 definições de fonte do modo mais fácil. Dê uma olhada no script para maiores
562 detalhes sobre o uso.
566 Traduzido por Ricardo Sartori <sartori@inf.ufsc.br>