2
Instructions pour l'installation de Window Maker
8
(c.�.d. : j'ai entendu dire que la compilation a �t� r�alis�e avec succ�s sur..)
10
- Intel GNU/Linux Conectiva 5.9 (beta)
11
- Intel GNU/Linux Slackware
12
- Intel GNU/Linux Debian
13
- Intel GNU/Linux (autres)
14
- Sparc GNU/Linux RedHat 5.1
16
- Alpha GNU/Linux RedHat 5.1
21
- Solaris 2.5.1, 2.5.2
24
- Solaris 2.8 sur Ultra Sparc 10 et E450
30
- AIX 4.1.4 / IBM PowerPC
31
- AIX 4.3.1 / IBM CC compiler
32
- AIX 4.3.2 / IBM PowerPC
34
- DEC Alpha/Digital UNIX 4.x
38
- PowerMac / Power MachTen 4.1.1 sous MacOS
39
- Amiga 3000 sous RedHat Linux 5.1 (Rawhide)
40
- IBM S/390 sous Linux
41
- IBM S/390 sous Conectiva Linux (experimental)
43
- Windows NT sous Cygwin/XFree86
44
- Sony PlayStation2 sous Linux
46
Toutes les marques d�pos�es sont la propri�t� de leur propri�taire.
48
Tout patch qui pourrait faciliter l'adaptation � d'autres plateformes
55
Les logiciels suivants sont n�cessaires � l'utilisation de Window Maker :
58
Window Maker peut �tre compil� avec des versions plus anciennes de X,
59
comme X11R5 (Solaris) ou X11R4 (OpenWindows), mais il ne fonctionnera
60
pas correctement � 100%.
61
Avec ces serveurs X, les ic�nes des applications n'appara�trons pas,
62
et vous aurez des probl�mes � l'utilisation du dock. La mise � jour
63
des librairies c�t� client (Xlib, Xt, etc.) pourront am�liorer les
64
choses si vous ne pouvez pas mettre � jour le serveur.
66
Les �l�ments suivants sont n�cessaires � la compilation de Window Maker :
69
Pour compiler Window Maker, assurez-vous que gcc (ou tout autre
70
compilateur de C ANSI) ainsi que les fichiers d'en-t�tes de X sont
71
install�s. D�butants sous Linux : vous devez installer les paquetages
72
de d�veloppement de X ainsi que ceux de la suite gcc. Le cas contraire,
73
vous ne pourrez jamais compiler aucun programme pr�vu pour X, y compris
76
- autoconf, automake et libtool
77
Ces outils ne sont pas indispensables, mais si au moins l'un d'eux
78
est install� sur votre syst�me, assurez-vous que TOUS le sont, et
79
que les versions de ces outils sont exactement :
83
Si les versions install�es sur votre syst�me diff�rent, d�sactivez-les
84
provisoirement, par exemple en les renommant, ou en les d�sinstallant
85
de votre syst�me. Si vous ne d�veloppez ni de compilez de logiciels,
86
vous n'en avez pas besoin et leur d�sinstallation n'est donc pas un
93
Ces librairies ne sont pas n�cessaires pour utiliser Window Maker, mais
94
elles sont support�es, au cas o� vous souhaiteriez les utiliser. Les
95
versions ci-dessous sont celles dont je dispose (et du coup, il est
96
garanti qu'elles fonctionnent), mais des versions diff�rentes peuvent
97
fonctionner aussi bien.
100
- libXPM 4.7 ou plus r�cent
101
Les versions plus anciennes peuvent ne pas fonctionner !!!
102
Disponible sur ftp://sunsite.unc.edu/pub/Linux/libs/X/
104
Le support des fichiers XPM est int�gr�, mais il ne prendra
105
pas en compte les images dont le format est exotique.
107
- libpng 0.96 ou plus r�cent, et zlib
108
Pour pouvoir utiliser les images au format PNG.
109
http://www.cdrom.com/pub/png/
111
- libtiff 3.4 ou plus r�cent
112
Pour pouvoir utiliser les images au format TIFF.
113
Vous trouverez �a ici : ftp://ftp.sgi.com/graphics/tiff
115
- libjpeg 6.0.1 ou plus r�cent
116
Pour pouvoir utiliser les images au format JPEG.
119
- libgif 2.2 ou libungif
120
Pour pouvoir utiliser les images au format GIF.
121
ftp://prtr-13.ucsc.edu/pub/libungif/
124
Si vous voulez disposer des traductions en d'autres langues, GNU gettext
125
est n�cessaire. Les autres versions de gettext sont incompatibles et ne
127
Vous trouverez la version GNU sur ftp://ftp.gnu.org
130
OPTIONS DE CONFIGURATION
131
========================
133
Ces options peuvent �tre pass�es au script de configuration afin d'activer
134
ou d�sactiver des fonctionnalit�s de Window Maker. Par exemple :
136
./configure --enable-kde --enable-gnome
138
configurera Window Maker avec le support int�gr� pour KDE et GNOME.
141
Afin d'obtenir la liste des autres options, ex�cutez ./configure --help
144
ajoute des chemins d'acc�s pour la recherche des librairies.
145
L'option -L doit pr�c�der chaque chemin d'acc�s, comme suit :
146
--with-libs-from="-L/opt/libs -L/usr/local/lib"
149
ajoute des chemins d'acc�s pour la recherche des fichiers d'en-t�te.
150
L'option -I doit pr�c�der chaque chemin d'acc�s, comme suit :
151
--with-incs-from="-I/opt/headers -I/usr/local/include"
154
active le regroupement des toutes les appicons des WM_CLASS et WM_INSTANCE
155
en une seule ic�ne. Aucun support n'est offert par les d�veloppeurs pour
156
cette fonctionnalit�. Si vous avez des probl�mes avec celle-ci, contactez
158
Christopher Seawood <cls@seawood.org>
161
d�sactive l'utilisation de l'extension "MIT shared memory". Cela ralentira
162
un petit peu la g�n�ration des textures, mais il semble que cela soit
163
n�cessaire dans certains cas pour �viter un bogue se manifestant au niveau
164
des ic�nes et des textures.
167
d�sactive le support pour les fonctionnalit�s en rapport avec le gestionnaire
171
d�sactive des fonctionnalit�s d�j� prises en compte par les gestionnaires de
172
bureau tels que KDE et GNOME. Cel� concerne : la liste de fen�tres, le menu
173
des applications, la s�lection multiple de fen�tres. Attention : vous ne
174
pourrez plus sortir de Window Maker autrement qu'en utilisant kill avec le
175
signal SIGTERM ou en quittant � l'aide de KDE. Il n'est pas conseill�
176
d'utiliser cette option.
179
active le support pour le verrouillage du "XKB language status". Si vous ne
180
savez pas de quoi il retourne, c'est probablement que vous n'en avez pas
184
active le support pour le module de gestion des effets sonores.
187
d�sactive l'utilisation de la librairie XPM m�me si elle est pr�sente
191
d�sactive l'utilisation de la librairie PNG.
194
d�sactive l'utilisation de la librairie TIFF.
197
d�sactive l'utilisation de la librairie GIF.
200
d�sactive l'utilisation de la librairie JPEG.
203
d�sactive l'utilisation de "shaped windows" (pour oclock, xeyes, etc.).
206
NOTES SP�CIFIQUES AUX PLATEFORMES
207
=================================
212
De : Anton Ivanov <aivanov@eu.level3.net>
213
A : Marcelo E. Magallon <mmagallo@debian.org>
214
Sujet : Re : Est-ce que le paquetage WindowMaker fonctionne correctement sur Alpha?
218
> Je lisais la doc contenue dans l'archive de WindowMaker, quand je suis
221
> | - machines DEC/Alpha
222
> | Il est possible que vous deviez utiliser l'option --disable-shm pour
223
> | configurer la compilation, comme suit :
224
> | ./configure --disable-shm
226
> est-ce que quelqu'un a eu des probl�mes avec WindowMaker sur Alpha? Est-ce
227
> que quelqu'un peut tester cela? Doit-on vraiment utiliser cette option
228
> pour compiler sur Alpha?
230
Notez bien : les Alphas dont je me sers ne sont jamais sous X et ne sont pas pr�s
233
Bien souvent, la configuration des Alphas n'inclut qu'un volume ridiculement
234
petit de m�moire partag�e. Aussi il n'est pas �tonnant qu'un grand nombre
235
d'applications comme cdrecord ou mysql server plantent carr�ment.
237
V�rifiez ces r�glages sur votre syst�me et modifiez-les en cons�quent :
238
pour cela, manipulez l'entr�e appropri�e dans /proc ou modifiez le fichier
239
/usr/src/linux/include/asm/shmparam.h.
241
En dehors de ce cas, la m�moire partag�e sous Alpha est sens�e ne pas
242
poser de probl�me et je ne vois aucune raison de la d�sactiver.
243
Pour ma part, elle est � 32 ou plus sur la pluspart des machines.
245
De plus, si ma m�moire est exacte, les commentaires dans ce fichier
246
sont tout � fait inexacts. La valeur n'est pas exprim�e en octets, mais en
247
mots, d�pendant de la machine. Pour les Alphas, c'est donc *8.
249
Je rappelle que je n'utilise pas X sur ces machines, donc ce que j'indique
250
est soumis � toutes les r�serves habituelles. (#include "standard_disclaimer.h")
255
Lancez configure comme suit :
256
CFLAGS="-belf -DANSICPP" ./configure
259
Si gcc est install�, lancez configure comme suit :
260
CPP_PATH="gcc -E -x c" ./configure
261
Le cpp de Sun ne dispose pas de certaines fonctionnalit�s n�cessaire pour
262
Window Maker et cela peut occasionner des probl�mes avec l'utilisation des
263
fichiers de configuration.
264
Il peut �tre aussi n�cessaire d'indiquer le chemin d'acc�s � la librairie
265
libtiff en utilisant les options --with-libs-from et --with-incs-from
267
Quelqu'un m'a rapport� qu'il est n�cessaire de faire figurer /usr/local/lib
268
en premier dans la variable d'environnement LD_LIBRARY_PATH.
270
Si vous utilisez un Ultra Creator 3D ou une autre machine graphique
271
de haut niveau, faites en sorte de d�marrer le serveur X avec le mode
272
graphique par d�faut � 24bpp sinon vous pourriez constaer des probl�mes
273
au niveau des couleurs.
274
C'est une bogue r�pertori� au niveau de Window Maker, il sera corrig�.
276
- GNU/Linux en g�n�ral
277
Assurez-vous que /usr/local/lib figure dans /etc/ld.so.conf et que vous
278
avez lanc� ldconfig apr�s l'installation.
279
D�sinstallez tout pr�c�dent paquetage de Window Maker avant d'installer
280
une nouvelle version.
283
Il peut y avoir plusieurs probl�mes ennuyeux sur les syst�mes RedHat.
284
Voici la marche � suivre sous peine de ne pouvoir utiliser Window Maker
287
* si la version de Window Maker livr�e avec RedHat est install�e,
288
d�sinstallez-la avant de mettre � jour votre syst�me;
290
* assurez-vous que ni la variable d'environnement LANG ni LINGUAS ne
293
* v�rifiez que /usr/local/bin est pr�sent dans votre variable d'environnement
296
* il faut que /usr/local/lib soit dans /etc/ld.so.conf avant de lancer
299
* si vous rencontrez des messages d'erreur en rapport avec "--no-reexec",
300
d�sinstallez libtool-1.2b et installez libtool-1.3.
301
libtool-1.3 peut �tre trouv� sur ftp.gnu.org.
302
Consultez aussi la section PROBL�MES;
304
* si vous aviez auparavant install� le paquetage de Window Maker livr�
305
avec RedHat et que vous voulez installer maintenant manuellement une nouvelle
306
version, vous devez au pr�alable d�sinstaller le paquetage provenant de la
309
* assurez-vous qu'il existe un lien symbolique de from /usr/include/X11 vers
310
/usr/X11R6/include/X11 (le cas �ch�ant, lancez cette commande :
311
ln -s /usr/X11R6/include/X11 /usr/include/X11);
313
* assurez-vous que /lib/cpp pointe bien vers le programme cpp
315
Si vous avez un doute concernant quoi que ce soit de relatif � l'installation
316
de Window Maker sur une RedHat, n'h�sitez pas � contacter le support
317
utilisateur de RedHat. Ils vous renseigneront toujours et tenteront de vous
318
d�panner dans l'utilisation et la configuration de votre syst�me RedHat.
319
D'un autre c�t�, ils sont plus au fait que nous pour tout ce qui est relatif
320
aux RedHat (nous n'en utilisons pas).
323
Installez la version la plus r�cente de Xpmac. Les versions plus
324
anciennes semblent contenir un bogue qui est susceptible de bloquer
328
Si vous voulez b�n�ficier du support des fichier JPEG et TIFF,
329
assurez-vous que les paquetages libtiff-dev et libjpeg-dev sont install�s.
332
D�sinstallez tout pr�c�dent paquetage de Window Maker avant d'installer
333
une nouvelle version. Le cas �ch�ant, vous pourriez rencontrer des
336
- MetroX (version ind�termin�e)
337
MetroX contient un bogue qui corrompt les pixmaps utilis�es en fond
338
de fen�tres. Si vous utilisez MetroX et rencontrer des probl�mes
339
avec les textures, n'utilisez pas les textures dans les barres de titre,
340
ou bien utilisez un autre serveur X.
346
Compiler Window Maker
347
---------------------
348
Pour aller vite, tapez ce qui suit dans un prompt shell :
353
puis, loguez-vous en tant que root and tapez :
358
ou, si vous voulez �ter les infos de d�bogage des ex�cutables et ainsi les
359
rendre plus petits, tapez plut�t :
364
Tout ceci compile et installe Window Maker avec les r�glages par d�faut.
366
Maintenant, si vous voulez personnaliser des options de compilation, vous
369
1. (optionnel) Consulter la section OPTIONS DE CONFIGURATION
370
dans ce m�me fichier. Ex�cutez aussi :
374
pour avoir la liste des autres options disponibles.
376
2. Lancez configure avec les options choisies. Par exemple, si vous voulez
377
utiliser l'option --enable-kde, tapez :
379
./configure --enable-kde
381
3. (optionnel) �ditez src/wconfig.h avec votre �diteur de texte favori et
382
et modifiez sont contenu � votre guise.
384
4. Compilez. Il faut juste taper :
388
5. Loguez-vous en tant que root (si vous ne pouvez pas le faire, lisez le
389
paragraphe "Je n'ai pas le mot de passe de root :-(") et installez
390
Window Maker sur votre syst�me :
395
R�glages pour un utilisateur
396
----------------------------
398
Ces instructions suivantes ne sont pas n�cessaires si vous mettez � jour
399
Window Maker � partir d'une version plus ancienne, � moins que ce soit
400
pr�cis� dans le fichier NEWS.
402
Chaque utilisateur qui veut utiliser Window Maker sur votre syst�me doit
405
1. Installer les fichiers de configuration de Window Maker dans son
406
r�pertoire personnel.
408
Pour ceci, il doit taper :
411
wmaker.inst installera les fichiers de configuration de Window Maker
412
pour l'utilisateur et configurera ses param�tres de X de fa�on � ce que
413
Window Maker soit automatiquement lanc� au d�marrage de X.
417
Vous pouvez aussi taper "man wmaker" afin d'obtenir plus de renseignements
418
sur la configuration et d'autres sujets.
420
Consultez le Guide de l'utilisateur afin d'obtenir des informationss plus
421
en d�tail sur Window Maker.
423
Pourquoi ne pas aussi jeter un oeil aux FAQs..
427
Installation du paquetage additionnel
428
-------------------------------------
430
D�compressez WindowMaker-extra-<version-number>.tar.gz dans /usr/local/share
432
Vous trouverez le fichier sur ftp://ftp.windowmaker.org. Ce paquetage est optionnel,
433
il contient des ic�nes et des th�mes suppl�mentaires. V�rifiez que vous avez
434
bien la derniere version de ce paquetage.
435
Il y a aussi un fichier WindowMaker-extra.readme qui indique comment proc�der �
436
l'installation de ce paquetage.
440
Je n'ai pas le mot de passe de root :-(
441
---------------------------------------
443
Si vous n'avez pas acc-s aux privil�ges du super-utilisateur (root), vous pouvez
444
installer Window Maker dans votre r�pertoire personnel. Pour ce faire, ajoutez
445
l'option --prefix correctement renseign�e au moment de l'ex�cution de ./configure
446
(�tape 2 de la compilation de Window Maker).
447
Il est aussi n�cessaire d'utiliser l'option --with-appspath, afin de pr�ciser
448
le chemin d'acc�s � WPrefs.app. Par exemple :
450
./configure --prefix=/home/jshmoe --with-appspath=/home/jshmoe/GNUstep/Applications
453
Puis, faites en sorte que /home/jshmoe/bin soit inclus dans votre PATH, ajoutez
454
/home/jshmoe/lib � votre variable d'environnement LD_LIBRARY_PATH puis lancez
457
Bien s�r, /home/jshmoe est suppos� �tre remplac� par votre r�pertoire personnel.
463
Si vous mettez � jour une version plus ancienne de Window Maker :
465
1. Configurez et compilez Window Maker comme d'habitude
466
2. Installez Window Maker (mais n'ex�cutez pas wmaker.inst)
467
3. Consultez le fichier NEWS et mettez � jour vos fichiers de configuration
474
Si vous rencontrez des probl�mes pendant la phase de configuration, comme par
475
exemple l'impossibilit� d'utiliser une librairie de manipulation de format
476
graphique alors que vous pensez qu'elle est install�e, jetez un oeil au contenu
477
du fichier config.log, vous y trouverez peut-�tre des indices pour r�soudre
481
== erreur de chargement de polices, alors qu'elles existent
483
Essayez de recompiler sans le support pour le NLS.
486
== erreur � la configuration
488
ltconfig: unrecognized option `--no-reexec'
489
Try `ltconfig --help' for more information.
490
configure: error: libtool configure failed
492
Otez l'option --no-reexec du fichier aclocal.m4 et relancer la configuration.
493
Assurez vous aussi que les versions d'autoconf et d'automake correspondent bien
499
Notez bien que ce ne doit PAS �tre libtool 1.2b, mais libtool bien 1.3,
500
disponible sur les sites GNU.
503
== configure ne trouve pas libtiff ou une autre librairie graphique
505
Effacez le fichier config.cache, et ex�cutez � nouveau configure avec les options
506
suivantes (en plus des options que vous utilisiez d�j�) :
507
--with-libs-from="-L/usr/local/lib"
508
--with-incs-from="-I/usr/local/include -I/usr/local/include/tiff"
509
Ins�rez les chemins d'acc�s aux librairies graphiques et � leurs fichiers d'en-t�te.
510
Plusieurs chemins d'acc�s peuvent �tre ajout�s pour chacune de ces options,
511
comme montr� pour --with-incs-from. S�parez-les juste par un espace.
514
== configure ne trouve pas libXpm
516
* V�rifiez que vous avez un lien sympbolique de libXpm.so.4.9 vers libXpm.so
519
== segmentation fault au d�marrage
521
* V�rifiez que la version de libXPM qui est install�e est au moins 4.7.
523
* V�rifiez que votre fichier ~/GNUstep/Defaults/WindowMaker est � jour.
525
Si vous n'en �tes pas s�r, renommez ~/GNUstep en ~/GNUtmp et lancez wmaker.inst.
528
== "...: your machine is misconfigured. gethostname() returned (none)"
530
* Le nom d'h�te de votre machine n'est pas indiqu� ou est invalide (il commence
531
par une parenth�se par exemple). Consultez les pages du manuel (man hostname) pour
532
savoir comment le positionner correctement.
535
== Le menu des applications ne contient que 2 entr�es ("XTerm" et "Exit...")
537
* Window Maker ne trouve pas cpp (le preprocesseur de C). Si votre cpp n'est pas situ�
538
dans /lib/cpp, editez src/config.h et modifiez le chemin d'acc�s dans CPP_PATH en cons�quent.
540
== checking lex output file root... configure: error: cannot find output from true; giving up
542
* Consultez la section PRE-REQUIS dans ce m�me fichier.
545
LOCALES/INTERNATIONALISATION
546
============================
548
Window Maker supporte les langues �trang�res. Pour activer cette fonctionalit�,
549
vous devez compiler Window Maker avec des param�tres suppl�mentaires.
552
0 - GNU gettext doit �tre install�. Il peut �tre trouv� ici :
553
ftp://prep.ai.mit.edu/pub/gnu/gettext-nnn.tar.gz
555
Vous pouvez passer � l'�tape 4 si vous utilisez le script Install.
557
1 - Il vous faut choisir les langues que vous voulez rendre disponible. Modifiez
558
pour cela la liste des codes de nationalit� dans LINGUAS. L'anglais est inclus
559
de fa�on implicite dans cette liste. Par exemple :
561
setenv LINGUAS "pt ja de"
566
export LINGUAS;LINGUAS="pt ja de"
569
La liste de tous les codes de nationalit� peut �tre trouv�e dans po/README.
570
L'anglais est la langue par d�fault.
572
Lisez po/README si vous souhaitez traduire ou maintenir les fichiers propres
573
� d'autres adaptations nationales.
575
2 - De plus, si votre langue utilise des caract�res multi-octets, comme
576
le japonais ou le cor�en, vous devez vous assurer que l'option MultiByteText est � YES
577
dans ~/GNUstep/Defaults/WMGLOBAL.
579
3 - Configurez, compilez et installez Window Maker normalement.
581
4 - Pour choisir une langue particuli�re � l'ex�cution, vous devez positionner la variable
582
d'environnement LANG avec la valeur correspondant au code de nationalit� ad�quat.
583
Par exemple, si vous voulez utiliser le portugais, vous devez faire :
591
sous Bourne sh et apparent�s
593
Note : si la variable d'environnement LC_CTYPE est positionn�e, vous devez l'�ter de
594
l'environnement (unset LC_CTYPE), avant d'ex�cuter Window Maker.
596
En ce qui concerne les fichiers de configuration des menus, Window Maker proc�de
597
� une recherche suivant cet ordre (pour le portugais br�silien, dans ce cas) :
604
5 - Si vous choisissez une langue qui utilise les caract�res multi-octets, vous
605
devez configurer les polices de fa�on ad�quate. Consultez pour cela les pages
606
de manuel de XCreateFontSet. Vous devez modifier dans votre fichier ~/G/D/WindowMaker
607
les polices utilis�es dans les titres, menus et autres. En ce qui concerne les polices
608
utilis�es dans les bo�te de dialogue, modifiez ~/G/D/WMGLOBAL.
609
Le %d dans la d�finition des polices ne doit PAS �tre enlev�. Vous pouvez aussi utiliser
610
le script wsetfont, fourni � ces fins.
611
Consultez le script lui-m�me pour en conna�tre les instructions.
613
Par exemple, vous pouvez mettre ceci dans ~/G/D/WindowMaker :
615
WindowTitleFont = "-*-helvetica-bold-r-normal-*-12-*,-*-*-medium-r-normal-*-14-*";
616
MenuTitleFont = "-*-helvetica-bold-r-normal-*-12-*,-*-*-medium-r-normal-*-14-*";
617
MenuTextFont = "-*-helvetica-medium-r-normal-*-12-*,-*-*-medium-r-normal-*-14-*";
618
IconTitleFont = "-*-helvetica-medium-r-normal-*-8-*,-*-*-medium-r-normal-*-12-*";
619
ClipTitleFont = "-*-helvetica-bold-r-normal-*-10-*,-*-*-medium-r-normal-*-12-*";
620
DisplayFont = "-*-helvetica-medium-r-normal-*-12-*,-*-*-medium-r-normal-*-12-*";
622
et dans ~/G/D/WMGLOBAL :
624
SystemFont = "-*-*-medium-r-normal-*-%d-*-*-*-*-*-*-*";
625
BoldSystemFont = "-*-*-medium-r-normal-*-%d-*-*-*-*-*-*-*";
627
Les 2 polices ci-dessus sont uniquement utilis�es par les applications qui utilisent
628
WINGs (Window Maker et WPrefs.app).
630
Le script wsetfont inclus vous permettra de changer les r�glages des polices de
631
fa�on plus ais�e. Consultez-le afin d'obtenir plus d'informations.