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.info/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-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.
 165
 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.
 169
 170 --enable-sound
 171         Ativa o suporte ao módulo de efeitos sonoros.
 172
 173 --disable-xpm
 174         Desativa o uso da biblioteca XPM mesmo se esta estiver disponível no seu sistema.
 175
 176 --disable-png
 177         Desativa o uso da biblioteca PNG
 178
 179 --disable-tiff
 180         Desativa o uso da biblioteca TIFF
 181
 182 --disable-gif
 183         Desativa o uso da biblioteca GIF
 184
 185 --disable-jpeg
 186         Desativa o uso da biblioteca JPEG
 187
 188 --disable-shape
 189         Desativa o uso das shaped windows (para oclock, xeyes etc.).
 190
 191 --enable-debug
 192         Não use esta opção a não ser que saiba realmente o que está fazendo
 193
 194
 195
 196 NOTAS ESPECÍFICAS PARA AS PLATAFORMAS
 197 =====================================
 198
 199 - máquinas DEC/Alpha
 200         Você provavelmente precisará usar a flag --disable-shm para configurar,
 201         como ./configure --disable-shm
 202
 203 - SCO Unix - execute o configure tal como
 204         CFLAGS="-belf -DANSICPP" ./configure
 205
 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.
 220
 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.
 226
 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á:
 230
 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.
 233
 234         * certifique-se de que você não possui as variáveis de ambiente LANG e LINGUAS
 235         configuradas como en_RN;
 236
 237         * certifique-se de que você possui /usr/local/bin na variável PATH;
 238
 239         * certifique-se de que você tem /usr/local/lib no /etc/ld.conf.so antes de
 240         executar o ldconfig;
 241
 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;
 245
 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.
 249
 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)
 253
 254         * certifique-se de que você tem o /lib/cpp apontando para o programa cpp.
 255
 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).
 260
 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.
 264
 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.
 268
 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.
 273
 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.
 279
 280 INSTALAÇÃO:
 281 ===========
 282
 283 Desempacote o WindowMaker-extra-<numero-da-versao>.tar.gz no /usr/local/share.
 284
 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.
 289
 290
 291 Compilando o Window Maker
 292 -------------------------
 293         Se você quer fazer de modo rápido e simples, digite o seguinte no seu prompt:
 294
 295         ./configure
 296         make
 297
 298 depois entre como root e digite:
 299
 300         make install
 301         ldconfig
 302
 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:
 305
 306         make install-strip
 307         ldconfig
 308
 309 Estes comandos irão compilar e instalar o Window Maker com parâmetros padrões.
 310
 311 Se você deseja configurar algumas opções de compilação, você pode fazer o seguinte:
 312
 313         1.(opcional) Olhe na seção OPÇÕES DE CONFIGURAÇÃO acima para ver as
 314         opções disponíveis. Execute também:
 315
 316         ./configure --help
 317
 318         para obter uma lista completa das outras opções.
 319
 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:
 322
 323         ./configure --enable-kde
 324
 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
 327
 328         4. Compile. Só digite:
 329
 330         make
 331
 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:
 334
 335                 su root
 336                 make install
 337
 338
 339 Configurações Específicas
 340 -------------------------
 341
 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.
 345
 346 Todo usuário no seu sistema que desejar rodar o Window Maker deverá fazer o seguinte:
 347
 348         1. Instalar os arquivos de configuração do Window Maker no diretório home.
 349 Digite:
 350         wmaker.inst
 351
 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.
 354
 355         É isso!
 356
 357         Você pode digitar "man wmaker" para ver uma ajuda geral sobre configuração
 358 e outras coisas.
 359
 360 Leia o Manual do Usuário para explicações mais profundas sobre o Window Maker.
 361
 362 Você deve dar uma olhada no FAQ também.
 363
 364
 365
 366 Eu não tenho a senha de root
 367 ----------------------------
 368
 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:
 375
 376 ./configure --prefix=/home/jshmoe --with-appspath=/home/jshmoe/GNUstep/Applications
 377
 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
 380
 381 É claro, substitua /home/jshome com o seu diretório home.
 382
 383
 384 UPGRADE
 385 =======
 386
 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.
 393
 394 TROUBLESHOOTING
 395 ===============
 396
 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.
 401
 402 == Erro ao carregar as fontes, mesmo quando elas existem
 403
 404 Tente reconstruir sem suporte NLS.
 405
 406 == Erro ao configurar
 407
 408 ltconfig: unrecognized option `--no-reexec'
 409 Try `ltconfig --help' for more information.
 410 configure: error: libtool configure failed
 411
 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
 419
 420 Note que não deve ser libtool 1.2b, deve ser libtool 1.3.
 421
 422 == Não acha a proplist.h ou libPropList.algumacoisa
 423
 424 Baixe e instale a libPropList dos sites já citados neste arquivo.
 425
 426 == o configure não detecta a libtiff, ou outras bibliotecas gráficas.
 427
 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.
 436
 437 == o configure não detecta libXpm.
 438
 439 * Confira se você possui um vínculo simbólico da libXpm.so.4.9 para libXpm.so
 440
 441
 442 == Segmentation fault na inicialização
 443
 444 * Confira se a versão da libXPM é a 4.7 ou mais atual
 445
 446 * Confira se você tem uma versão atualizada do ~/GNUstep/Defaults/WindowMaker
 447
 448 Se você não tem certeza, tente renomear ~/GNUstep para ~/GNUtmp e depois rode
 449 o wmaker.inst
 450
 451 == "...: your machine is misconfigured. gethostname() returned (none)"
 452
 453 * o hostname da sua máquina está definido incorretamente. Execute um man hostname
 454 para obter informações de como resolver isto.
 455
 456 == O menu do root possui só 2 entradas. ("XTerm" e "Exit...")
 457
 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.
 461
 462 == checking lex output file root... configure: error: cannot find output from
 463 true; giving up
 464
 465 * Leia a seção REQUERIMENTOS deste arquivo.
 466
 467
 468 LOCALES/INTERNACIONALIZAÇÃO
 469 ===========================
 470
 471 o Window Maker tem suporte a linguagem nacional. Para ativar esse suporte,
 472 você precisa compilar o Window Maker com parâmetros adicionais.
 473
 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
 476
 477 Os passos 1,2 e 3 podem ser pulados se você usa o script Install.
 478
 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:
 481
 482 setenv LINGUAS "pt ja de"
 483 na csh
 484
 485 ou
 486
 487 export LINGUAS;LINGUAS="pt ja de"
 488 na sh
 489
 490 A lista dos locales suportados pode ser achado no arquivo po/README.
 491 O inglês é a língua oficial.
 492
 493 Leia o arquivo po/README se você deseja traduzir e manter os arquivos
 494 locales para outras linguagens.
 495
 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
 499
 500 3 - Configure, compile e instale o Window Maker normalmente.
 501
 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
 505
 506 setenv LANG pt
 507
 508 na csh ou
 509
 510 export LANG; LANG=pt
 511
 512 nas Bourne sh e similares
 513
 514 Nota: Se você tem a variável de ambiente LC_CTYPE definida, você deve
 515 indefiní-la antes de rodar o wmaker.
 516
 517 O Window Maker procura os arquivos de definições de menu na seguinte
 518 ordem (para o português brasileiro, neste caso):
 519
 520 menu.pt_BR
 521 menu.pt
 522 menu
 523
 524
 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.
 532
 533 Por exemplo, você pode especificar o seguinte no ~/G/D/WindowMaker:
 534
 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-*";
 541
 542 e no ~/G/D/WMGLOBAL:
 543
 544 SystemFont = "-*-*-medium-r-normal-*-%d-*-*-*-*-*-*-*";
 545 BoldSystemFont = "-*-*-medium-r-normal-*-%d-*-*-*-*-*-*-*";
 546
 547
 548 As duas fontes acima são usadas somente por aplicações que
 549 usem WINGs (o Window Maker e WPrefs.app)
 550
 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.
 554
 555
 556
 557 Traduzido por Ricardo Sartori <sartori@inf.ufsc.br>