Le syst�me MGR Window
Vincent Broman
Edition 30 Mai 1996
1. Cet HOWTO
Copyright Vincent Broman 1995
Vous pouvez effectuer et distribuer
des copies selon les conditions de la GNU General Public License.
1.1 Archivage
Cet HOWTO est archiv� sur
ftp://archimedes.nosc.mil/pub/Mgr/MGR-HOWTO.sgml, et �galement sur
ftp://sunsite.unc.edu/pub/Linux/docs/HOWTO/MGR-HOWTO. Dans les
r�pertoires adjacents peuvent appara�tre des fichiers de formats
diff�rents tels que MGR-HOWTO.txt.
1.2 Authentification
Les copies de la distribution MGR dues � Broman doivent �tre
accompagn�es des fichiers de signature PGP, sign�es "Vincent Broman
<broman@nosc.mil>".
1.3 Cr�dits pour cet HOWTO
Bien que Vincent Broman ait �t� l'initiateur de cet HOWTO, la plupart
des informations et des textes furent obtenus � partir de FAQs,
READMEs, etc. �crits par Stephen Uhler, Michael Haardt, et d'autres
personnes ayant "l'esprit R�seau". Corrections et suggestions par
Email � broman@nosc.mil.
Uhler fut l'architecte principal de _MGR_ -- voir Remerciements plus
loin.
2. Qu'est-ce que MGR ?
2.1 Fonction
_MGR_(ManaGeR) est un syst�me de fen�tres graphiques. _MGR_ fournit un
gestionnaire int�gr� de fen�tres et un �mulateur de terminal graphique
sur des syst�mes bitmaps couleurs et monochromes. _MGR_ est
contr�lable par des menus pop-up activ�s par souris, par action du
clavier, et par des s�quences d'�chappement �crites par un client sur
des pseudo-terminaux.
_MGR_ fournit � chaque client une fen�tre avec : fonctions de contr�le
terminal en style termcap, primitives graphiques telles que dessins de
lignes et de cercles ; am�nagements pour manipuler les bitmaps,
fontes, ic�nes et menus pop-up ; commandes pour redessiner et
repositionner les fen�tres ; et un syst�me de passage de messages
permettant aux programmes-client d'�tablir des rendez-vous et
d'�changer des messages. Les programmes client peuvent demander � �tre
inform�s lorsqu'un changement dans le syst�me intervient, tel qu'une
fen�tre redessin�e, un clic de souris, ou un message envoy� � partir
d'un autre programme client. Ces changements sont appel�s �v�nements.
_MGR_ notifie un �v�nement � un programme client en envoyant une cha�ne
ASCII dans un format sp�cifi� par le programme client. Des
applications existantes peuvent �tre int�gr�es dans l'environnement
sans �tre modifi�es : _MGR_ imite des actions sur le clavier en
r�ponse � des s�lections du menu utilisateur ou d'autres �v�nements.
2.2 Conditions requises
_MGR_ tourne couramment sur Linux, FreeBSD, stations Sun 3/4 avec
SunOS, et Coherent. Certaines versions anciennes de _MGR_ tournent sur
Macintosh, Atari ST MiNT, Xenix, 386-Minix, DEC 3100, et 3b1 Unix-pc.
De nombreux petits syst�mes industriels en temps r�el sous OS9 et Lynx
utilisent en Europe (une autre variante de) Mgr comme interface.
L'interface de programmation est impl�ment�e en C et Elisp, cependant
des supports clients dans d'autres langages ne posent pas de
difficult�s.
_MGR_ requiert beaucoup moins de ressources que X, ou m�me gcc. Bien
s�r il n'a pas le r�pertoire de programmes, les biblioth�ques de haut
niveau de X ou MS-Windows, mais il est �l�gant et abordable.
On a dit que _MGR_ est � X ce que Unix est � Multics.
2.3 Quelles sont les diff�rences entre MGR, X11 et 8.5 ?
_MGR_ consiste en un serveur avec un gestionnaire de fen�tres et un
�mulateur de terminal, et des clients qui tournent dans cet �mulateur
en l'utilisant pour communiquer avec le serveur. Il n'y a pas de
multiplexage de ressources.
X11 est constitu� d'un serveur et de clients, qui sont habituellement
connect�s au serveur via un socket. Ce qui est visible � l'utilisateur
tels qu'�mulateurs de terminal, gestionnaires de fen�tres, etc., est
r�alis� en utilisant les clients.
8.5, le syst�me de fen�tre Plan 9, est un multiplexeur de ressources ;
tout processus tournant dans une fen�tre peut acc�der � /dev/bitblt,
/dev/mouse et /dev/kbd sous son propre nom. Ceux-ci sont multiplex�s �
/dev/bitblt, /dev/mouse et /dev/kbd de 8.5. Cette approche permet de
faire fonctionner 8.5 dans une fen�tre 8.5, de conception tr�s
soign�e. De plus 8.5 dispose d'un gestionnaire de fen�tres int�gr� et
un �mulateur de terminal.
3. Installer MGR
On peut charger la derni�re version sur
archimedesbugs.nosc.mil/pub/Mgr/69 et sous Mosaic depuis
http://archimedes.nosc.mil/Mgr/69. On peut le trouver aussi sur
ftp://sunsite.unc.edu/pub/Linux/apps/MGR et ses miroirs. Les versions
anciennes de Haardt peuvent se trouver sur tsx-11.mit.edu et peut-�tre
ailleurs. Des versions Pre-Linux de _MGR_ de Uhler et d'autres ont �t�
trouv�es sur bellcore.com/pub/mgr, mais je pense qu'elles n'y sont
plus. J'ai conserv� une copie de tout ce que j'ai vu concernant MGR
sur l'Internet, et je n'ai pas connaissance qu'il n'y ait quoi que ce
soit d'important qui puisse manquer dans cette distribution Linux/Sun.
Il y a eu un tas de versions et de mises en circulation de _MGR_, mais
la version *Linux* actuelle est 0.69. Cette version devrait passer �
1.0 quand un code VGA-256 stable pour Linux appara�tra (pour plusieurs
types de cartes vid�o). Les num�ros de version RCS sont pass�s de
Bellcore 4.3 jusqu'� 4.13 � ce jour.
Pour construire cette distribution de _MGR_ il faut m4 (GNU ou tout
autre admettant l'option -D), make (GNU, ou tout autre admettant
include) et *roff pour les docs. Et enfin sh, awk et install POSIX.
Les distributions binaires n'ont pas toujours assembl�es aussi faut-il
un compilateur C ANSI, du style gcc.
Une installation sous Linux requiert au moins une version 0.99.10 ou
ult�rieure (1.2.13 est ce que j'utilise � l'heure actuelle) , une
carte graphique HGC, EGA, VGA ou SVGA et une souris de type : serial
Microsoft, serial MouseSystems 3 et 5 bytes, serial MMSeries, serial
Logitech, PS/2, ou une souris bus. Avec Buckey (Meta) hot keys en
service, m�me un syst�me ne poss�dant pas de souris peut effectuer pas
mal de travail utile sous MGR. Le mode graphique monochrome VGA
640x480 est support�, tout comme le 640x350 et le 640x200. Pour
tourner en 800x600, ou d'autres modes que votre BIOS peut initialiser
et qui n'ont pas besoin de bank-switching, vous aurez besoin d'un
petit programme (src/vgamisc/regs.exe) sous DOS pour lire les
registres VGA quand ce mode est install� puis d'�crire un fichier
header que vous placerez dans le r�pertoire src/libbitblit/linux, de
telle sorte qu'il puisse �tre appel� par le fichier vga.c. Des
exemples sont fournis, mais cr�ez quand m�me le v�tre. Quelques cartes
VGA peuvent utiliser des fen�tres de 128k ; celles-ci peuvent tourner
avec de plus hautes r�solutions.
Le code Linux-colorport peut aussi tourner dans le mode couleur
standard VGA 320*200*256 sans difficult�s, car il n'y a pas de
bank-switching n�cessaire. Si vous r�fl�chissez au peu que
repr�sentent 64000 pixels, vous comprendrez que ce mode couleur est
tout � fait limit�. Un code lent, mais simple, a �t� ajout� dans la
version 0.65, et il travaille avec une carte Tseng ET4000 dans les
modes 640x480x256 et 800x600x256. Le code S3 ne marche pas encore dans
les r�solutions super-VGA. Pour utiliser des nouvelles cartes
super-VGA il faut �crire une fonction pour changer de bloc de m�moire
et �tre s�r que le mode �cran souhait� peut �tre initialis� � partir
d'un vidage de registre, �ventuellement en le peaufinant � la main.
Les serveurs couleur sous Linux d�forment g�n�ralement les fontes
�crans, d'o� la n�cessit� d'utiliser restorefont comme dans runx. Si
quelqu'un pouvait r�cup�rer le code d'initialisation VGA de X, cela
ferait de MGR un syst�me poss�dant plus de couleurs.
Suns avec SunOS 4.1.2+ et les tampons de trame bwtwo, cgthree, ou
cgsix sont accept�s. Leurs vitesses de manipulation des couleurs sont
correctes. Les syst�mes Coherent doivent se r�f�rer au fichier
README.Coh de la distribution source. Porter le tout dernier _MGR_ sur
un autre syst�me analogue � POSIX qui poss�de select, des pty et un
acc�s direct � un tampon de trame bitmap devrait �tre imm�diat, en
impl�mentant simplement la biblioth�que libbitblit bas�e sur le code
sunmono ou colorport.
Si vous voulez tout installer, vous aurez besoin de 7 MB d'espace
disque pour les binaires, les fonts, les explications, etc. Les
sources font environ 4,5 MB plus les fichiers objets durant la
compilation.
Normalement, /usr/mgr doit �tre le r�pertoire ou bien il doit �tre
link� au r�pertoire o� vous installerez les accessoires _MGR_. Tapez
cd /usr/mgr; tar xvfz l�_ou_vous_le_mettez/mgrusr-0.69.tgz
et �ventuellement
cd /usr/mgr; tar xvfz la_ou_vous_voulez/morefonts-0.69.tgz
pour d�compacter. Les sources peuvent �tre mises n'importe o�, par
exemple tapez
cd /usr/src/local/mgr; tar xvfz la_ou_vous_voulez/mgrsrc-0.69.tgz
pour d�compacter les sources � partir de archimedes.nosc.mil.
L'arborescence source peut �tre compil�e � partir d'un Makefile
principal qui fait appel lui-m�me � des Makefile secondaires, chacun
"incluant" un "Configfile" au niveau sup�rieur. Le Configfile est cr��
� l'aide d'un script interactif nomm� Configure, qui vous pose un
certain nombre de questions, puis utilise m4 avec un fichier
Configfile.m4. Ensuite vous tapez quelque chose comme ceci :
chdir /usr/src/local/mgr
sh ./Configure
make first
make depend
make install
make clean
Il est prudent, avant de taper make, de jeter un coup d'oeil dans le
fichier Configfile g�n�r� par le script Configure, pour v�rifier s'il
n'y a pas d'anomalie. Au pire m4 s'interrompt, cr�ant un fichier
Configfile tout petit. Si cela arrive, essayez une copie de
Configfile.sun ou Configfile.lx. Tout peut �tre effectu� dans
n'importe quel r�pertoire avec un Makefile � partir du moment o� les
biblioth�ques ont �t� compil�es et install�es. Le serveur, les
biblioth�ques et quelques clients sont impl�ment�s avec lint, mais
plusieurs clients utilisent le code C K&R ce qui engendre beaucoup
d'avertissements pendant la compilation. Plusieurs flags dans MGRFLAGS
peuvent �tre ajout�s ou retranch�s pour changer quelques options du
serveur, � savoir :
_-DWHO_
fichier utmp poubelle pour que "who" puisse travailler
_-DVI_
code pour faire bouger le curseur sous vi avec la souris
_-DDEBUG_
permet la mise au point en s�lectionnant l'option -d
_-DFASTMOUSE_
XOR le temps d'acc�s de la souris
_-DBUCKEY_
permet les commandes serveur par le clavier sans souris
_-DPRIORITY_
pour planifier la priorit� des fen�tres au lieu de fonctionner
par requ�tes circulaires ; la fen�tre active obtient une plus
grande priorit�.
_-DCUT_
pour faire du couper/coller entre fen�tres
_-DMGR_ALIGN_
force l'alignement des fen�tres pour un scrolling
rapide(monochrome)
_-DKILL_
supprime les fen�tres en cas d'erreurs i/o sur un tty
_-DSHRINK_
pour utiliser seulement une partie de l'�cran ($MGRSIZE dans
les variables d'environnement)
_-DNOSTACK_
interdit l'empilement d'�v�nements
_-DBELL_
actionne le bip
_-DKBD_
lit les donn�es mgr � partir du clavier sun, au lieu de stdin.
Cela autorise la redirection des messages console vers une
fen�tre.
_-DFRACCHAR_
mouvement de caract�re fractionnel pour fontes proportionnelles
_-DXMENU_
menu �tendu (exp�rimental)
_-DMOVIE_
extension pour faire un film qui enregistre toutes les
op�rations dans un fichier en vue de les rejouer plus tard (ne
marche pas bien sous Linux).
_-DEMUMIDMSBUT_
Pour simuler le 3�me bouton d'une souris
M�fiez-vous : certaines combinaisons n'ont pas �t� essay�es sur tous
les syst�mes. La macro BITBLITFLAGS doit contenir -DBANKED si vous
voulez essayer le super VGA couleur.
Le code C pour les variables statiques du serveur contenant les ic�nes
et les fontes est g�n�r� � l'aide d'un traducteur � partir des
fichiers ic�nes et fontes.
Tous les clients ne sont pas compil�s et install�s par les fichiers
Makefile. Les fichiers clients trouv�s dans src/clients qui ont des
noms en majuscule ou bien non compil�s par les fichiers Makefile
fournis, peuvent donner des probl�mes de compilation et/ou
d'utilisation ; il peut �tre int�ressant de les examiner.
Plusieurs pilotes d'�cran du r�pertoire libbitblit ont plut�t un
int�r�t historique. Mieux vaut les faire dispara�tre.
V�rifiez que votre fichier /etc/termcap et/ou terminfo contient des
entr�es pour les terminaux _MGR_, comme ceux que l'on trouve dans le
r�pertoire misc. Si vos logiciels prennent en compte $TERMCAP dans
l'environnement, ceci n'est pas n�cessaire, tant que vous utilisez
set_termcap dans chaque fen�tre.
Il est pr�f�rable de travailler avec _MGR_ avec setuid root, car il
utilise ptys et write dans le fichier utmp. Cela permet au client
gestionnaire d'ic�nes de mieux travailler et d'avoir une plus grande
s�ret� quant � l'encha�nement des �v�nements. Sur Linux, les
permissions root sont n�cessaires pour faire fonctionner les syst�mes
�cran. Autrement vous d�cidez de lui faire confiance.
Avec les versions aux alentours de 0.62 il y a des probl�mes avec Sun
quand on utilise csh comme shell par d�faut : les programmes semblent
tourner sur un processus diff�rent que le processus de premier plan du
pty de la fen�tre, en contradiction avec les pages de manuel et les
sp�cifications posix. Rien de tel avec bash, sh, ou rc. Vous avez une
id�e ?
4. Utiliser MGR
Le seul fichier _indispensable_ sous _MGR_ est le serveur lui-m�me. Il
vous donnera les fen�tres �mulateur de terminal avec les shells
correspondants, mais pas de jolies horloges, de fontes superbes, de
graphiques marrants, etc... Suivant les options, le serveur monochrome
a besoin de 200K de RAM plus un espace dynamique pour les fen�tres,
bitmaps, etc...
Si /usr/mgr/bin est dans votre PATH, tapez seulement "mgr" pour
d�marrer. Apr�s avoir profit� de l'�cran de d�marrage anim�, frappez
une touche quelconque. Quand le fond hachur� appara�t avec un pointeur
de souris, appuyez sur le bouton gauche de la souris, allez sur "new
window" dans le menu puis rel�chez. Faites promener la souris pour
s�lectionner l'endroit o� vous voulez qu'une fen�tre apparaisse.
Celle-ci aura votre shell par d�faut. Maintenez le bouton gauche de la
souris enfonc� dans une fen�tre existante pour voir un autre menu qui
vous permettra de r�aliser des choses dans cette fen�tre. Cliquer avec
le bouton gauche sur une fen�tre obscurcie l'am�nera au premier plan.
Le menu que vous aviez vu sur l'arri�re plan inclut la commande
`quit'. Pour ceux qui ont une souris avec deux boutons, il suffit
d'appuyer sur les deux boutons simultan�ment pour simuler le
troisi�me. Le sous-menu quit comprend l'option "really quit", une
option d'attente qui doit �tre utilis�e seulement si vous utilisez un
shell offrant l'�dition de la ligne de commande, et un �conomiseur
d'�cran avec un verrouillage qui attend que vous tapiez un mot de
passe lorsque vous revenez sur votre machine.
En essayant _MGR_, si vous :
_ne pouvez trouver l'�cran_
soyez s�r d'avoir une entr�e /dev pour votre vid�o, par ex. sur
Sun /dev/bwtwo0. Si ce n'est pas le cas, en tant que root allez
dans /dev, et tapez "MAKEDEV bwttwo0". Sinon, vous devez faire
-S/dev/bwtwo0 ou (sous Linux) -S640x480 comme option de
commande en d�marrant mgr. Sous Linux, soyez �galement s�rs que
/usr/mgr/bin/mgr a �t� install� suid root.
_ne trouvez pas la souris_
assurez-vous que /dev/mouse existe, habituellement li�
symboliquement au nom r�el de votre souris. Si vous n'avez pas
la permission d'�crire dans /dev, quelque chose comme
-m/dev/cua0 peut �tre donn� comme option en d�marrant mgr.
Soyez �galement s�rs d'avoir mis le bon protocole souris en
configurant mgr. La souris peut s'appeler Microsoft, m�me si ce
n'est pas son vrai nom.
_ne pouvez obtenir un pty_
assurez-vous que tous les /dev/[tp]ty[pq]? sont propri�t� de
root, mode 666, que tous les programmes r�f�renc�s avec
l'option "shell" dans le fichier .mgrc (si il y en a) existent
et sont ex�cutables.
_n'avez rien d'autre que la fonte par d�faut_
assurez-vous que _MGR_ cherche bien au bon endroit pour les
fontes. V�rifiez le fichier Configfile dans les sources, ou
bien regardez si une option comme -f/usr/mgr/font r�soud le
probl�me.
_�tes compl�tement bloqu� (m�me le pointeur souris ne bouge pas)_
logez vous sur votre machine � partir d'un autre terminal et
tuez le processus mgr. Un ctrl-Q fera quitter _MGR_ si le
clavier fonctionne encore.
4.1 Applications non li�es � MGR
Toute application orient�e tty peut tourner sous une fen�tre MGR sans
probl�mes. Les applications orient�es �cran utilisant termcap ou
curses peuvent obtenir le nombre exact de lignes et de colonnes en
utilisant shape(1) pour redimensionner la fen�tre ou en utilisant
set_termcap(1) pour obtenir le termcap ad�quat.
4.2 Applications (clients) MGR distribu�es avec le serveur
_bdftomgr_
convertit des fontes BDF en fontes MGR
_browse_
un browser d'ic�nes
_bury_
enterre la fen�tre
_c_menu_
pour regarder les erreurs de compilation sous C � l'aide de vi
_clock_
horloge digitale
_clock2_
horloge analogique
_close_
ferme la fen�tre et l'iconifie
_color_
pour les couleurs d'arri�re et d'avant-plan du texte dans la
fen�tre
_cursor_
change l'aspect du curseur texte
_cut_
couper/coller du texte de la fen�tre vers une m�moire tampon
_cycle_
affiche une s�quence d'ic�nes
_dmgr_
pr�visualisateur ditroff � l'�tat brut
_fade_
fait passer d'une sc�ne � une autre dans un film
_font_
passe � une autre fonte dans la fen�tre
_gropbm_
un pilote groff PBM utilisant les fontes Hershey
_hpmgr_
�mulateur de terminal hp 2621
_ico_
anime un isoca�dre ou un autre poly�dre
_iconmail_
annonce l'arriv�e de courrier
_iconmsgs_
annonce l'arriv�e d'un message
_ify_
iconifie et d�siconifie les fen�tres
_loadfont_
charge une fonte � partir du syst�me de fichiers
_maze_
jeu de labyrinthe
_mclock_
horloge comique
_menu_
cr�e ou choisit un menu pop-up
_mgr_
Gestionnaire de fen�tres et serveur Bellcore
_mgrbd_
jeu boulder-dash
_mgrbiff_
surveille la bo�te aux lettres et annonce le courrier
_mgrload_
graphique indiquant la charge du syst�me
_mgrlock_
verrouille la console
_mgrlogin_
contr�leur graphique de login
_mgrmag_
loupe sur une partie de l'�cran, avec option de sauvegarde
_mgrmail_
annonce l'arriv�e de courrier
_mgrmode_
ajuste ou annule les modes de fen�tre
_mgrmsgs_
annonce l'arriv�e de messages
_mgrplot_
filtre graphique Unix "plot"
_mgrsclock_
sablier
_mgrshowfont_
parcourt les fontes mgr
_mgrsketch_
programme de sch�mas et dessins
_mgrview_
visualise des images bitmap
_mless_
d�marre less/more dans une fen�tre s�par�e, avec un menu pour
less wtag/mnew/d�marrer n'importe quel programme dans une
fen�tre s�par�e ind�pendante.
_mvi_
d�marre vi dans une fen�tre s�par�e, avec souris
_oclose_
ferme une fen�tre (ancien)
_omgrmail_
annonce l'arriv�e de courrier (ancien)
_pbmrawtomgr,pgmrawtomgr,ppmrawtomgr_
convertit des bitmats PBM,PGM,PPM brutes en format bitmap mgr
_pbmstream_
fractionne une s�quence de bitmaps
_pbmtoprt_
impression � partir de PBM
_pgs_
un patch ghostscript et interface, un visualisateur PS
_pilot_
balaye des bitmaps et visualise des images
_resetwin_
fait le m�nage dans une fen�tre si le client se plante
_rotate_
rotation d'un bitmap de 90 degr�s.
_screendump_
sauvegarde un �cran graphique dans un fichier bitmap
_set_console_
redirige les messages console vers une fen�tre
_set_termcap_
ajuste une valeur TERMCAP appropri�e
_setname_
nomme une fen�tre, pour les messages et pour l'iconifier
_shape_
redimensionne une fen�tre
_square_
transforme une fen�tre en carr�
_squeeze_
compresse un bitmap mgr
_startup_
fournit un fichier de d�marrage pour la disposition de la
fen�tre courante
_texmgr_
pour pr�visualiser un fichier TeX dvi
_text2font, font2text_
conversion entre formats fonte mgr et un texte dump
_unsqueeze_
pour d�compresser un bitmap mgr
_vgafont2mgr,mgrfont2vga_
conversion de format de fontes mgr et VGA
_window_print_
imprime l'image d'une fen�tre
_zoom_
�diteur d'ic�nes
_bounce, grav, hilbert, mgreyes, stringart, walk_
d�mos graphiques
4.3 Applications MGR distribu�es s�par�ment, cf fichier "SUPPORT"
_calctool_
calculatrice
_chess_
interface pour /usr/games/chess
_gnu emacs_
�diteur avec souris lisp/term/mgr.el et aide menu
_gnuplot_
traceur de donn�es scientifiques universel
_metafont_
cr�ation et conception de fontes
_origami_
�diteur de dossier
_pbmplus_
conversions et manipulations de format portable bitmap
_plplot_
traceur de donn�es scientifiques superbe
Le support Emacs dans misc/mgr.el et misc/mailcap comprend un support
MIME tr�s utile, via Rmail et metamail. Un afficheur d'image de
diff�rents types pourrait �tre fabriqu� � partir d'un pilote et de
filtres netPBM, mais je n'ai pas pris le temps de le faire.
5. Programmation pour MGR
Le manuel des programmeurs _MGR_, l'interface des applications langage
C, se trouvent dans le r�pertoire doc sous forme de fichier
exploitable par troff/nroff. Il traite de concepts g�n�raux, des
appels fonction/macro contr�lant le serveur, d'un exemple
d'application, avec index et glossaire. Porter le code client utilis�
avec les anciennes versions de MGR demande le remplacement de
#include <mgr/mgr.h>
par
#include <term.h>
#include <dump.h>
et des clients utilisant les vieux B_XOR, B_CLEAR, etc. au lieu de
BIT_XOR, BIT_CLR et autres peuvent �tre adapt�s en �crivant :
#define OLDMGRBITOPS
#include <mgr/mgr.h>
Compiler le code client demande en g�n�ral des options telles que :
-I/usr/mgr/include -L/usr/mgr/lib -lmgr
Vous pouvez obtenir un aper�u de l'interactivit� des fonctions serveur
_MGR_ en lisant et essayant le pilote de terminal mgr.el pour GNU
Emacs, qui met en oeuvre la biblioth�que interface _MGR_ en Elisp.
L'habitude qui consiste � s'enqu�rir de l'�tat du serveur a pour
risque de se casser la figure si le client attend en m�me temps un
grand volume de notification d'�v�nements. Ce probl�me arrive lorsque
une notification d'�v�nement (asynchrone) survient quand une r�ponse �
une demande (synchrone) �tait attendue. Si cela arrive dans la
pratique (non habituel) alors les fonctions de demande d'�tat _MGR_
doivent �tre int�gr�es avec votre boucle de manipulation d'�v�nement.
La seule fonction manquante pour les dessins dans le protocole _MGR_
est celle de remplissage de surfaces autres que les rectangles. Il y a
un nouveau code pour manipuler la carte des couleurs globale, et aussi
pour l'allocation et la d�livrance des indices de couleur appartenant
� chaque fen�tre. Si vous voulez fouiller dans les progammes serveurs,
vous trouverez le pilote de souris dans mouse.* et mouse_get, les
abominables choses concernant l'interface clavier dans kbd.c, et
l'interface vid�o dans les r�pertoires src/libbitblit/*. La proc�dure
principale, plut�t l'initialisation, et la boucle d'entr�e de niveau
sup�rieur sont dans mgr.c, enfin l'interpr�tation des s�quences
d'�chappement dans put_window.c.
6. Documentation suppl�mentaire
Le manuel du programmeur est indispensable pour les id�es g�n�rales.
La plupart des clients sont fournis avec une documentation man
install�e dans /usr/mgr/man/man1 ou /man6.
D'autres documentations utiles sont bitblit.3, font.5, et bitmap.5. Il
y a une ambigu�t� dans les documentations pour distinguer le format
des bitmaps internes trouv�s dans votre tampon de trame et le format
des bitmaps externes trouv�s dans des fichiers, par exemple les
ic�nes.
La documentation mgr.1 traite des options de commande en ligne, des
commandes dans le fichier .mgrc, de la souris et des interactions du
menu avec le serveur, et enfin des raccourcis clavier disponibles sur
sur les syst�mes qui en poss�dent. Beaucoup de fontes de
/usr/mgr/font/* sont d�crites dans les fichiers /usr/mgr/font/*.txt,
par exemple /usr/mgr/font/FONTDIR.txt donne la description des fontes
de style X pour celles obtenues dans le format .bdf. La fin des noms
de fontes (WxH) s'interpr�te comme suit : W est la largeur du
caract�re en d�cimal H est la hauteur en pixels.
7. Remerciements
Stephen Uhler, avec d'autres travaillant chez Bellcore, fut le
concepteur initial de _MGR_, d�s lors Bellcore a des droits d'auteur
sur la plupart des codes et des documentations de _MGR_, dans les
conditions suivantes :
Vous avez la permission de copier et d'utiliser ce programme,
MAIS
* vous ne pouvez le vendre
* cette note concernant les droits de copie doit accompagner les copies
* mentionner Bellcore quand c'est necessaire
Une vue de la notice de copyright appara�t dans le titre de d�marrage.
Autres remerciements :
* Stephen Hawley pour ses merveilleuses ic�nes.
* Tommy Frandsen pour la biblioth�que VGA linux.
* Tom Heller pour sa biblioth�que.
* Andrew Haylett pour le code du pilote de souris.
* Dan McCrackin pour ses patches gasblit -> linux.
* Dave Gymer, dgymer@gdcarc.co.uk, pour la correction de l'effet
Startrek.
* Alex Liu pour la premi�re version de Linux de _MGR_.
* Lars Aronsson (aronsson@lysator.liu.se) pour les fontes tex2 et
ISO8859.
* Harry Pulley (hcpiv@grumpy.cis.uoguelph.ca,
hcpiv@snowhite.cis.uoguelph.ca) pour l'acc�s Coherent.
* Vance Petree & Grant Edwards & Udo Munk pour leur travail sur
Hercules.
* Udo Munk pour son travail sur l'initialisation et la s�lection de
la souris s�rie.
* Norman Bartek, Hal Snyder de Mark Williams Co. pour leur aide sur
quelques bugs et les pilotes de p�riph�rique Coherent.
* Grand merci � Zeyd Ben Halim pour des tas de patches utiles,
sp�cialement pour adapter les syst�mes de s�lection.
* Bradley Bosch (brad@lachman.com) pour des tas de patches depuis le
port acc�s 3b1, qui corrige des bugs et permet d'installer des
accessoires nouveaux et attractifs.
* Andrew Morton (applix@runxtsa.runx.oz.au) qui �crivit le premier
le code cut-word.
* Kapil Paranjape (kapil@motive.math.tifr.res.in) pour le support
EGA.
* Michael Haardt pour les corrections du support MOVIE, les
corrections de bugs, la s�paration du code libbitblit en pilotes
de sortie, l'extension de libmgr, la compression origami du code.
* Yossi Gil pour de nombreuses fontes.
* Carsten Emde, carsten@thlmak.pr.net.ch, pour mphoon.
* Vincent Broman pour l'�mulation du 3�me bouton de la souris, le
support cgsix Sun, l'acc�s � la table des couleurs VGA, et
l'int�gration du code sunport de l'arrangement en couches Haardt,
le rassemblement des fontes, l'�conomiseur d'�cran, et la
maintenance continue.
* Kenneth Almquist, ka@socrates.hr.att.com, pour les salutaires
reports de bogues.
* Tim Pierce, twpierce@midway.uchicago.edu, pour le portage vers
FreeBSD 2.0R avec la carte VGA Trident.
Toutes les fontes bitmap de toutes les sources sont du domaine public
aux USA. Les fontes 583 � largeur fixe fournies avec _MGR_ furent
obtenues par Uhler, dans la distribution X, Yossi Gil, et autre part.
Les fontes vectorielles Hershey et le code n�cessaire sont
probablement librement redistribuables.