INSTALL.pt

   1                 Instruções de Instalação do Window Maker
   2
   3
   4 PLATAFORMAS SUPORTADAS
   5 ======================
   6 (obs: fiquei sabendo que conseguiram compilar nesses sistemas...)
   7
   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)
  35
  36 Patches que possibilitem a execução em outras plataformas serão bem-vindos.
  37
  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.
  40
  41
  42 REQUERIMENTOS
  43 =============
  44
  45 Os softwares a seguir são necessários para o uso do Window Maker:
  46
  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:
  55
  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.
  62
  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.
  67
  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.
  77
  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.
  83
  84
  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.
  91
  92
  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.
  98
  99 - libpng 0.96 ou mais atual e zlib
 100         Para suporte a imagens PNG.
 101
 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.
 105
 106 - libjpeg 6.0.1 ou mais atual
 107         Para suporte a imagens JPEG.
 108
 109 - libgif 2.2 ou libungif
 110         Para suporte a imagens tipo GIF.
 111
 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
 116
 117 A maioria dos pacotes citados pode ser encontrado em ftp.uu.net/pub/graphics
 118
 119
 120
 121 OPÇÕES DE CONFIGURAÇÃO
 122 ======================
 123
 124 Estas opções podem ser passadas ao script de configuração para ativar/desativar algumas
 125 opções do Window Maker. Exemplo:
 126
 127 ./configure --enable-kde --enable-gnome
 128
 129 irá configurar o Window Maker para que seja compilado com suporte ao KDE e GNOME.
 130
 131
 132 Para obter uma lista com outras opcoes, execute ./configure --help:
 133
 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"
 138
 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"
 143
 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>
 149
 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.
 154
 155 --disable-motif
 156         Desativa compatibilidade com gerenciador de janelas mwm.
 157
 158 --enable-openlook
 159         Ativa compatibilidade com gerenciador de janelas OPEN LOOK(tm).
 160
 161 --enable-gnome
 162         Ativa compatibilidade com gerenciador de janelas GNOME.
 163
 164 --enable-kde
 165         Ativa compatibilidade com gerenciador de janelas kde/kwm.
 166
 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.
 174
 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.
 178
 179 --enable-sound
 180         Ativa o suporte ao módulo de efeitos sonoros.
 181
 182 --disable-xpm
 183         Desativa o uso da biblioteca XPM mesmo se esta estiver disponível no seu sistema.
 184
 185 --disable-png
 186         Desativa o uso da biblioteca PNG
 187
 188 --disable-tiff
 189         Desativa o uso da biblioteca TIFF
 190
 191 --disable-gif
 192         Desativa o uso da biblioteca GIF
 193
 194 --disable-jpeg
 195         Desativa o uso da biblioteca JPEG
 196
 197 --disable-shape
 198         Desativa o uso das shaped windows (para oclock, xeyes etc.).
 199
 200 --enable-debug
 201         Não use esta opção a não ser que saiba realmente o que está fazendo
 202
 203
 204
 205 NOTAS ESPECÍFICAS PARA AS PLATAFORMAS
 206 =====================================
 207
 208 - máquinas DEC/Alpha
 209         Você provavelmente precisará usar a flag --disable-shm para configurar,
 210         como ./configure --disable-shm
 211
 212 - SCO Unix - execute o configure tal como
 213         CFLAGS="-belf -DANSICPP" ./configure
 214
 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.
 229
 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.
 235
 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á:
 239
 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.
 242
 243         * certifique-se de que você não possui as variáveis de ambiente LANG e LINGUAS
 244         configuradas como en_RN;
 245
 246         * certifique-se de que você possui /usr/local/bin na variável PATH;
 247
 248         * certifique-se de que você tem /usr/local/lib no /etc/ld.conf.so antes de
 249         executar o ldconfig;
 250
 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;
 254
 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.
 258
 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)
 262
 263         * certifique-se de que você tem o /lib/cpp apontando para o programa cpp.
 264
 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).
 269
 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.
 273
 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.
 277
 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.
 282
 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.
 288
 289 INSTALAÇÃO:
 290 ===========
 291
 292 Desempacote o WindowMaker-extra-<numero-da-versao>.tar.gz no /usr/local/share.
 293
 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.
 298
 299
 300 Compilando o Window Maker
 301 -------------------------
 302         Se você quer fazer de modo rápido e simples, digite o seguinte no seu prompt:
 303
 304         ./configure
 305         make
 306
 307 depois entre como root e digite:
 308
 309         make install
 310         ldconfig
 311
 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:
 314
 315         make install-strip
 316         ldconfig
 317
 318 Estes comandos irão compilar e instalar o Window Maker com parâmetros padrões.
 319
 320 Se você deseja configurar algumas opções de compilação, você pode fazer o seguinte:
 321
 322         1.(opcional) Olhe na seção OPÇÕES DE CONFIGURAÇÃO acima para ver as
 323         opções disponíveis. Execute também:
 324
 325         ./configure --help
 326
 327         para obter uma lista completa das outras opções.
 328
 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:
 331
 332         ./configure --enable-kde
 333
 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
 336
 337         4. Compile. Só digite:
 338
 339         make
 340
 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:
 343
 344                 su root
 345                 make install
 346
 347
 348 Configurações Específicas
 349 -------------------------
 350
 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.
 354
 355 Todo usuário no seu sistema que desejar rodar o Window Maker deverá fazer o seguinte:
 356
 357         1. Instalar os arquivos de configuração do Window Maker no diretório home.
 358 Digite:
 359         wmaker.inst
 360
 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.
 363
 364         É isso!
 365
 366         Você pode digitar "man wmaker" para ver uma ajuda geral sobre configuração
 367 e outras coisas.
 368
 369 Leia o Manual do Usuário para explicações mais profundas sobre o Window Maker.
 370
 371 Você deve dar uma olhada no FAQ também.
 372
 373
 374
 375 Eu não tenho a senha de root
 376 ----------------------------
 377
 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:
 384
 385 ./configure --prefix=/home/jshmoe --with-appspath=/home/jshmoe/GNUstep/Apps
 386
 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
 389
 390 É claro, substitua /home/jshome com o seu diretório home.
 391
 392
 393 UPGRADE
 394 =======
 395
 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.
 402
 403 TROUBLESHOOTING
 404 ===============
 405
 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.
 410
 411 == Erro ao carregar as fontes, mesmo quando elas existem
 412
 413 Tente reconstruir sem suporte NLS.
 414
 415 == Erro ao configurar
 416
 417 ltconfig: unrecognized option `--no-reexec'
 418 Try `ltconfig --help' for more information.
 419 configure: error: libtool configure failed
 420
 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
 428
 429 Note que não deve ser libtool 1.2b, deve ser libtool 1.3.
 430
 431 == Não acha a proplist.h ou libPropList.algumacoisa
 432
 433 Baixe e instale a libPropList dos sites já citados neste arquivo.
 434
 435 == o configure não detecta a libtiff, ou outras bibliotecas gráficas.
 436
 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.
 445
 446 == o configure não detecta libXpm.
 447
 448 * Confira se você possui um vínculo simbólico da libXpm.so.4.9 para libXpm.so
 449
 450
 451 == Segmentation fault na inicialização
 452
 453 * Confira se a versão da libXPM é a 4.7 ou mais atual
 454
 455 * Confira se você tem uma versão atualizada do ~/GNUstep/Defaults/WindowMaker
 456
 457 Se você não tem certeza, tente renomear ~/GNUstep para ~/GNUtmp e depois rode
 458 o wmaker.inst
 459
 460 == "...: your machine is misconfigured. gethostname() returned (none)"
 461
 462 * o hostname da sua máquina está definido incorretamente. Execute um man hostname
 463 para obter informações de como resolver isto.
 464
 465 == O menu do root possui só 2 entradas. ("XTerm" e "Exit...")
 466
 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.
 470
 471 == checking lex output file root... configure: error: cannot find output from
 472 true; giving up
 473
 474 * Leia a seção REQUERIMENTOS deste arquivo.
 475
 476
 477 LOCALES/INTERNACIONALIZAÇÃO
 478 ===========================
 479
 480 o Window Maker tem suporte a linguagem nacional. Para ativar esse suporte,
 481 você precisa compilar o Window Maker com parâmetros adicionais.
 482
 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
 485
 486 Os passos 1,2 e 3 podem ser pulados se você usa o script Install.
 487
 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:
 490
 491 setenv LINGUAS "pt ja de"
 492 na csh
 493
 494 ou
 495
 496 export LINGUAS;LINGUAS="pt ja de"
 497 na sh
 498
 499 A lista dos locales suportados pode ser achado no arquivo po/README.
 500 O inglês é a língua oficial.
 501
 502 Leia o arquivo po/README se você deseja traduzir e manter os arquivos
 503 locales para outras linguagens.
 504
 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
 508
 509 3 - Configure, compile e instale o Window Maker normalmente.
 510
 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
 514
 515 setenv LANG pt
 516
 517 na csh ou
 518
 519 export LANG; LANG=pt
 520
 521 nas Bourne sh e similares
 522
 523 Nota: Se você tem a variável de ambiente LC_CTYPE definida, você deve
 524 indefiní-la antes de rodar o wmaker.
 525
 526 O Window Maker procura os arquivos de definições de menu na seguinte
 527 ordem (para o português brasileiro, neste caso):
 528
 529 menu.pt_BR
 530 menu.pt
 531 menu
 532
 533
 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.
 541
 542 Por exemplo, você pode especificar o seguinte no ~/G/D/WindowMaker:
 543
 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-*";
 550
 551 e no ~/G/D/WMGLOBAL:
 552
 553 SystemFont = "-*-*-medium-r-normal-*-%d-*-*-*-*-*-*-*";
 554 BoldSystemFont = "-*-*-medium-r-normal-*-%d-*-*-*-*-*-*-*";
 555
 556
 557 As duas fontes acima são usadas somente por aplicações que
 558 usem WINGs (o Window Maker e WPrefs.app)
 559
 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.
 563
 564
 565
 566 Traduzido por Ricardo Sartori <sartori@inf.ufsc.br>