home *** CD-ROM | disk | FTP | other *** search
/ Il CD di internet / CD.iso / HOWTO / MGR-HOWT < prev    next >
Encoding:
Text File  |  1995-04-20  |  23.7 KB  |  759 lines
  1.   The MGR Window System HOWTO
  2.   Vincent Broman
  3.   Draft 16 Nov 1994
  4.  
  5.   1.  This HOWTO
  6.  
  7.  
  8.                       Copyright Vincent Broman 1994.
  9.                 Permission granted to make and distribute
  10.                verbatim (unaltered) copies for any purpose.
  11.  
  12.  
  13.  
  14.   1.1.  Archiving
  15.  
  16.   This HOWTO is temporarily archived in ftp://bugs.nosc.mil/pub/Mgr/MGR-
  17.   HOWTO, and more permanently in
  18.   ftp://sunsite.unc.edu/pub/Linux/docs/HOWTO/MGR-HOWTO.  A copy will
  19.   appear in ftp://archimedes.nosc.mil/pub/Mgr/MGR-HOWTO since bugs is
  20.   disappearing in late 1994.  In the same directories may appear
  21.   alternate formats like MGR-HOWTO.sgml or MGR-HOWTO.txt.
  22.  
  23.  
  24.   1.2.  Credit for the HOWTO
  25.  
  26.   While Vincent Broman first put together this HOWTO, much of the
  27.   information and text was obtained from FAQs, READMEs, etc. written by
  28.   Stephen Uhler, Michael Haardt, and other public-spirited net-persons.
  29.   Email corrections and suggested changes to broman@nosc.mil.
  30.  
  31.   Uhler was the main architect of MGR -- see the Credit section below.
  32.  
  33.  
  34.   2.  What is the MGR window system?
  35.  
  36.  
  37.   2.1.  Function
  38.  
  39.   MGR (ManaGeR) is a graphical window system.  The MGR server provides a
  40.   builtin window manager and windowed graphics terminal emulation on
  41.   color and monochrome bitmap displays.  MGR is controlled by mousing
  42.   pop-up menus, by keyboard interaction, and by escape sequences written
  43.   on pseudo-terminals by client software.
  44.  
  45.   MGR provides each client window with: termcap-style terminal control
  46.   functions, graphics primitives such as line and circle drawing;
  47.   facilities for manipulating bitmaps, fonts, icons, and pop-up menus;
  48.   commands to reshape and position windows; and a message passing
  49.   facility enabling client programs to rendezvous and exchange messages.
  50.   Client programs may ask to be informed when a change in the window
  51.   system occurs, such as a reshaped window, a pushed mouse button, or a
  52.   message sent from another client program.  These changes are called
  53.   events.  MGR notifies a client program of an event by sending it an
  54.   ASCII character string in a format specified by the client program.
  55.   Existing applications can be integrated into the windowing environment
  56.   without modification by having MGR imitate keystrokes in response to
  57.   user defined menu selections or other events.
  58.  
  59.  
  60.   2.2.  Requirements
  61.  
  62.   MGR currently runs on Linux, Sun 3/4 workstations with SunOS, and
  63.   Coherent.  Various older versions of MGR run on the Macintosh, Atari
  64.   ST MiNT, Xenix, 386-Minix, DEC 3100, and the 3b1 Unix-pc.  Many small,
  65.   industrial, real-time systems under OS9 or Lynx in Europe use Mgr for
  66.   their user interface.  The programming interface is implemented in C
  67.   and in ELisp, although supporting clients written in other languages
  68.   is quite easy.
  69.  
  70.   Running MGR requires much less in resources than X, or even gcc.  It
  71.   does not have the user-base, software repertory, or high-level
  72.   libraries of X or MS-Windows, say, but it is quite elegant and
  73.   approachable.
  74.  
  75.   It has been said that MGR is to X as Unix was to Multics.
  76.  
  77.  
  78.   2.3.  How do MGR, X11 and 8.5 compare?
  79.  
  80.   MGR consists of a server with builtin window manager and terminal
  81.   emulator, and clients which run in this terminal emulator and use it
  82.   to communicate with the server.  No resource multiplexing is done.
  83.  
  84.   X11 consists of a server and clients, which usually connect to the
  85.   server using a socket.  All user visible things like terminal
  86.   emulators, window managers etc are done using clients.  No resource
  87.   multiplexing is done.
  88.  
  89.   8.5, the Plan 9 window system, is a resource multiplexer, as each
  90.   process running in a window can access /dev/bitblt, /dev/mouse and
  91.   /dev/kbd in its own namespace.  These are multiplexed to the
  92.   /dev/bitblit, /dev/mouse and /dev/kbd in the namespace of 8.5.  This
  93.   approach allows one to run 8.5 in an 8.5 window, a very clean design.
  94.   8.5 further has an integrated window manager and terminal emulator.
  95.  
  96.  
  97.   3.  Installing MGR
  98.  
  99.   The latest source distribution can be FTPed from the directories
  100.   ftp://bugs.nosc.mil/pub/Mgr/65 and
  101.   ftp://archimedes.nosc.mil/pub/Mgr/65.  One used to be able to find
  102.   older MGR sources at ftp://ftp.thp.uni-koeln.de/pub/linux/mgr, or
  103.   alternatively on ftp://134.95.80.1/pub/thp/linux/mgr, but these may be
  104.   gone.  Even older versions of this distribution from Haardt can be
  105.   found on tsx-11.mit.edu and elsewhere.  Pre-Linux versions of MGR from
  106.   Uhler and others can be found at ftp://bellcore.com/pub/mgr, although
  107.   no one seems to maintain things there.  MGR has been through a lot of
  108.   versions and releases, but the current *Linux* version number is 0.65.
  109.   This version number ought to arrive at 1.0 when stable 256-color VGA
  110.   code for Linux appears.  RCS version numbers have increased from
  111.   Bellcore's 4.3 up to our 4.12 now.
  112.  
  113.   Required tools to build this distribution of MGR are m4 (GNU, or
  114.   perhaps another supporting the -D option), make (GNU, or perhaps
  115.   another supporting include) and *roff for the docs.  Also sh, awk, and
  116.   POSIX install.  Binary distributions have not been assembled yet, so
  117.   you need an ANSI C compiler environment, e.g. gcc.
  118.  
  119.   A Linux installation requires Linux 0.99.10 or better, an HGC, EGA,
  120.   VGA, or SVGA graphics card, and a mouse.  Mouses supported are: serial
  121.   Microsoft mouse, serial MouseSystems 3 and 5 byte mouse, serial
  122.   MMSeries mouse, serial Logitech mouse, PS/2 mouse, or a bus mouse.
  123.   The VGA 640x480 monochrome graphics mode is supported out of the box,
  124.   as is 640x350 and 640x200.  To run 800x600, or other modes that your
  125.   BIOS can initialize and which do not require bank-switching, you need
  126.   to run a small program (supplied as src/vgamisc/regs.exe) under DOS to
  127.   read the VGA registers and write a header file which you place in the
  128.   directory src/libbitblit/linux, so that it can be included by the
  129.   vga.c file there.  Some VGA cards can use 128k windows, and these can
  130.   run higher monochrome resolutions.
  131.  
  132.  
  133.   The Linux-colorport code also runs in the standard 320x200x256 color
  134.   VGA mode without difficulty, because no bank switching is required.
  135.   Non-fast, but simple, bank-switching code has been added in version
  136.   0.65, and it works with a Tseng ET4000 card in 640x480x256 and
  137.   800x600x256 modes.  The S3 code does not work in super VGA
  138.   resolutions, yet.  Supporting new super VGA cards requires writing one
  139.   function to switch banks and making sure that the desired screen mode
  140.   can be initialized from a register dump, possibly with hand-tweaking.
  141.   The Linux color servers generally mangle the screen fonts,
  142.   necessitating use of restorefont as in runx.
  143.  
  144.   Suns with SunOS 4.1.2 and bwtwo, cgthree, or cgsix frame buffers are
  145.   supported.  Coherent installations should refer to the README.Coh file
  146.   in the source distribution.  Porting the latest-and-greatest MGR to
  147.   another POSIX-like system which provides select() and pty's and direct
  148.   access to a bitmapped frame-buffer ought to be straightforward, just
  149.   implementing the libbitblit library based on the sunmono or colorport
  150.   code, say.
  151.  
  152.   If you want to install everything, you need 5 MB disk space for
  153.   binaries, fonts, manual pages etc.  The sources are about 2 MB, plus
  154.   object files during compilation.
  155.  
  156.   Normally, /usr/mgr should be either the directory or a link to the
  157.   directory where you install MGR stuff for runtime use.  Typing
  158.  
  159.  
  160.        chdir /usr/mgr; gunzip < whereveryouputit/mgrusr.tgz | tar xvf -
  161.  
  162.  
  163.  
  164.  
  165.   and optionally
  166.  
  167.  
  168.        chdir /usr/mgr; gunzip < wherever/morefonts.tgz | tar xvf -
  169.  
  170.  
  171.  
  172.  
  173.   will unpack these.  The source can be put anywhere, e.g. typing
  174.  
  175.  
  176.        chdir /usr/src/local/mgr; gunzip < wherever/mgrsrc.tgz | tar xvf -
  177.  
  178.  
  179.  
  180.  
  181.   to unpack the sources from bugs.nosc.mil.
  182.  
  183.   The source tree can be compiled from one top-level Makefile which
  184.   invokes lower-level Makefiles, all of which "include" a "Configfile"
  185.   at the top level.  The Configfile is created by an interactive sh
  186.   script named Configure, which runs m4 on a Configfile.m4.  So you do
  187.   something like this:
  188.  
  189.  
  190.  
  191.        chdir /usr/src/local/mgr
  192.        sh ./Configure
  193.        make first
  194.        make depend
  195.        make install
  196.        make clean
  197.  
  198.  
  199.   It might be wise, before running make, to eyeball the Configfile
  200.   generated by the Configure script, checking that it looks reasonable.
  201.   (At least one m4 poops out (Sun /usr/bin/m4), creating a very short
  202.   Configfile.  If this happens, try editing a copy of Configfile.sun or
  203.   Configfile.lx) Several flags in MGRFLAGS can be added/omitted to
  204.   change some optional features in the server, viz:
  205.  
  206.      -DWHO
  207.         muck utmp file so "who" works
  208.  
  209.      -DVI
  210.         code for clicking the mouse in vi moving the cursor
  211.  
  212.      -DDEBUG
  213.         enable debugging output selectable with -d options.
  214.  
  215.      -DFASTMOUSE
  216.         XOR the mouse track
  217.  
  218.      -DBUCKEY
  219.         for hot-key server commands without mousing
  220.  
  221.      -DPRIORITY
  222.         for priority window scheduling instead of round-robin; the
  223.         active window gets higher priority
  224.  
  225.      -DCUT
  226.         for cut/paste between windows and a global snarf buffer
  227.  
  228.      -DALIGN
  229.         forces window alignment for fast scrolling (monochr)
  230.  
  231.      -DKILL
  232.         kills windows upon tty i/o errors
  233.  
  234.      -DSHRINK
  235.         use only some of the screen ($MGRSIZE in environment)
  236.  
  237.      -DNOSTACK
  238.         don't permit event stacking
  239.  
  240.      -DBELL
  241.         really ring the bell
  242.  
  243.      -DKBD
  244.         read mgr input from the sun kbd, instead of stdin.  This permits
  245.         redirection of console msgs to a window.
  246.  
  247.      -DFRACCHAR
  248.         fractional character movement for proportional fonts
  249.  
  250.      -DXMENU
  251.         extended menu stuff (experimental)
  252.  
  253.      -DMOVIE
  254.         movie making extension which logs all operations to a file for
  255.         later replay -- not quite working under Linux
  256.  
  257.      -DEMUMIDMSBUT
  258.         Emulate a missing middle mouse button by chording
  259.  
  260.   Not all combinations of these options work on all systems.
  261.  
  262.   The BITBLITFLAGS macro should contain -DBANKED if you're trying out
  263.   the super VGA color.
  264.  
  265.   If a make complains about the lack of a default_font.h or an
  266.   icon_server.h in the directory src/mgr, it means that you forgot to do
  267.   this
  268.  
  269.  
  270.        make depend
  271.  
  272.  
  273.  
  274.  
  275.   recently enough.  C code for the static variables containing icons and
  276.   fonts is generated by a translator from icon and font files.
  277.  
  278.   Not all the clients are compiled and installed by the Makefiles.
  279.   Clients found under src/clients having capitalized names or not
  280.   compiled by the supplied Makefiles may have problems compiling and/or
  281.   running, but they may be interesting to hack on.  Most of the screen
  282.   drivers found under the libbitblit directory are of mainly
  283.   archeological interest. Grave robbing can be profitable.
  284.  
  285.   At some point check that your /etc/termcap and/or terminfo file
  286.   contain entries for MGR terminals such as found in the misc directory.
  287.   If all your software checks $TERMCAP in the environment, this is not
  288.   needed, as long as you run set_termcap in each window.
  289.  
  290.   MGR works better if run setuid root, because it wants to chown ptys
  291.   and write in the utmp file.  This helps the ify iconifier client work
  292.   better and the event passing mechanism be more secure.  On Linux, root
  293.   permissions are required in order to do in/out on the screen device.
  294.   Otherwise, you decide whether to trust it.
  295.  
  296.   In versions around 0.62 there are troubles on the Sun with using the
  297.   csh as the default shell.  Programs seem to run in a different process
  298.   group than the foreground process group of the window's pty.  There is
  299.   no trouble with bash, sh, or rc.  Ideas why?
  300.  
  301.  
  302.   4.  Running MGR
  303.  
  304.   The only file required in an MGR installation is the server itself.
  305.   That would give you terminal emulator windows with shells running in
  306.   them, but no nice clocks, extra fonts, fancy graphics, etc.  Depending
  307.   on options, a monochrome server needs about 200K of RAM plus dynamic
  308.   space for windows, bitmaps, etc.
  309.  
  310.   If /usr/mgr/bin is in your PATH, then just type "mgr" to start up.
  311.   After enjoying the animated startup screen, press any key.  When the
  312.   hatched background and mouse pointer appear, hold down the left mouse
  313.   button, highlight the "new window" menu item, and release the button.
  314.   Then drag the mouse from corner to corner where you want a window to
  315.   appear.  The window will have your default shell running in it.  Hold
  316.   down the left mouse button over an existing window to see another menu
  317.   for doing things to that window.  The menu you saw that pops-up over
  318.   the empty background includes the quit command.  For people with a two
  319.   button mouse: press both buttons together to emulate the missing
  320.   middle button.
  321.  
  322.   When trying to run MGR, if you get:
  323.  
  324.      can't find the screen
  325.         make sure you have a /dev entry for your display device, e.g. on
  326.         a Sun /dev/bwtwo0.  If not, as root cd to /dev, and type
  327.         "MAKEDEV bwtwo0".  Otherwise, you might need the -S/dev/bwtwo0
  328.         or (on Linux) the -S640x480 command line option when starting
  329.         mgr.
  330.  
  331.      can't find the mouse
  332.         make sure /dev/mouse exists, usually as a symbolic link to the
  333.         real device name for your mouse.  If you haven't permission to
  334.         write in /dev, then something like a -m/dev/cua0 option can be
  335.         given when starting mgr.  Also, make sure you've supplied the
  336.         right mouse protocol choice when you configured mgr.  The mouse
  337.         may speak Microsoft, even if that is not the brand name.
  338.  
  339.  
  340.      can't get a pty
  341.         make sure all of /dev/[tp]ty[pq]?  are owned by root, mode 666,
  342.         and all programs referenced with the "shell" option in your
  343.         .mgrc startup file (if any) exist and are executable.
  344.  
  345.  
  346.      none but the default font
  347.         make sure MGR is looking in the right place for its fonts.
  348.         Check the Configfile in the source or see whether a
  349.         -f/usr/mgr/font option to mgr fixes the problem.
  350.  
  351.  
  352.      completely hung (not even the mouse track moves)
  353.         login to your machine from another terminal (or rlogin) and kill
  354.         the mgr process.  A buckey-Q key can quit MGR if the keyboard
  355.         still works.
  356.  
  357.  
  358.   4.1.  Applications not aware of MGR
  359.  
  360.   Any tty-oriented application can be run in an MGR window without
  361.   further ado.  Screen-oriented applications using termcap or curses can
  362.   get the correct number of lines and columns by your using shape(1) to
  363.   reshape the window or using set_termcap(1) to obtain the correct
  364.   termcap.
  365.  
  366.  
  367.   4.2.  MGR Applications (clients) distributed with the server
  368.  
  369.  
  370.      bdftomgr
  371.         converts some BDF fonts to MGR fonts
  372.  
  373.      browse
  374.         an icon browser
  375.  
  376.      bury
  377.         bury this window
  378.  
  379.      c_menu
  380.         vi menus from C compiler errors
  381.  
  382.      clock
  383.         digital display of time of day
  384.  
  385.      clock2
  386.         analog display of time of day
  387.  
  388.      close
  389.         close this window, iconify
  390.  
  391.      color
  392.         set the foreground and background color for text in this window
  393.  
  394.      colormap
  395.         read or write in the color lookup table
  396.  
  397.      cursor
  398.         change appearance of the character cursor
  399.  
  400.      cut
  401.         cut text from this window into the cut buffer
  402.  
  403.      cycle
  404.         display a sequence of icons
  405.  
  406.      dmgr
  407.         crude ditroff previewer
  408.  
  409.      fade
  410.         fade a home movie script from one scene to another
  411.  
  412.      font
  413.         change to a new font in this window
  414.  
  415.      hpmgr
  416.         hp 2621 terminal emulator
  417.  
  418.      ico
  419.         animate an icosahedron or other polyhedron
  420.  
  421.      iconmail
  422.         notification of mail arrival
  423.  
  424.      iconmsgs
  425.         message arrival notification
  426.  
  427.      ify
  428.         iconify and deiconify windows
  429.  
  430.      loadfont
  431.         load a font from the file system
  432.  
  433.      maze
  434.         a maze game
  435.  
  436.      mclock
  437.         micky mouse clock
  438.  
  439.      menu
  440.         create or select a pop-up menu
  441.  
  442.      mgr
  443.         bellcore window system server and window manager
  444.  
  445.      mgrbd
  446.         boulder-dash game
  447.  
  448.      mgrbiff
  449.         watch mailbox for mail and notify
  450.  
  451.      mgrload
  452.         graph of system load average
  453.  
  454.      mgrlock
  455.         lock the console
  456.  
  457.      mgrlogin
  458.         graphical login controller
  459.  
  460.      mgrmag
  461.         magnify a part of the screen, optionally dump to file
  462.  
  463.      mgrmail
  464.         notification of mail arrival
  465.  
  466.      mgrmode
  467.         set or clear window modes
  468.  
  469.      mgrmsgs
  470.         message arrival notification
  471.  
  472.      mgrplot
  473.         Unix "plot" graphics filter
  474.  
  475.      mgrsclock
  476.         sandclock
  477.  
  478.      mgrshowfont
  479.         browse through mgr fonts
  480.  
  481.      mgrsketch
  482.         a sketching/drawing program
  483.  
  484.      mgrview
  485.         view mgr bitmap images
  486.  
  487.      mless
  488.         start up less/more in separate window, menu added for less
  489.  
  490.      mphoon
  491.         display the current phase of the moon
  492.  
  493.      mvi
  494.         start up vi in a separate window, mouse pointing
  495.  
  496.      oclose
  497.         (old) close a window
  498.  
  499.      omgrmail
  500.         (old) notification of mail arrival
  501.  
  502.      pbmrawtomgr
  503.         convert pbm raw bitmap to mgr bitmap format
  504.  
  505.      pbmstream
  506.         split out a stream of bitmaps
  507.  
  508.      pbmtoprt
  509.         printer output from PBM
  510.  
  511.      pgs
  512.         ghostscript patch and front end
  513.  
  514.      pilot
  515.         a bitmap browser
  516.  
  517.      resetwin
  518.         cleanup window state after client crashes messily
  519.  
  520.      rotate
  521.         rotate a bitmap 90 degrees.
  522.  
  523.      screendump
  524.         write graphics screen dump to a bitmap file
  525.  
  526.      set_console
  527.         redirect console messages to this window
  528.  
  529.      set_termcap
  530.         output an appropriate TERM and TERMCAP setting
  531.  
  532.      setname
  533.         name a window, for messages and iconifying
  534.  
  535.      shape
  536.         reshape this window
  537.  
  538.      square
  539.         square this window
  540.  
  541.      squeeze
  542.         compress mgr bitmap using run-length encoding
  543.  
  544.      startup
  545.         produce a skeleton startup file for current window layout
  546.  
  547.      texmgr
  548.         TeX dvi file previewer
  549.  
  550.      text2font, font2text
  551.         convert between mgr font format and text dump
  552.  
  553.      unsqueeze
  554.         uncompress mgr bitmap using run length encoding
  555.  
  556.      window_print
  557.         print an image of a window
  558.  
  559.      zoom
  560.         an icon editor
  561.  
  562.      bounce, grav, grid, hilbert, mgreyes, stringart, walk
  563.         graphics demos
  564.  
  565.  
  566.   4.3.  MGR-aware clients distributed separately, see "SUPPORT" file
  567.  
  568.  
  569.      calctool
  570.         on-screen calculator
  571.  
  572.      chess
  573.         frontend to /usr/games/chess
  574.  
  575.      gnu emacs
  576.         editor with lisp/term/mgr.el mouse & menu support
  577.  
  578.      gnuplot
  579.         universal scientific data plotting
  580.  
  581.      metafont
  582.         font design and creation
  583.  
  584.      origami
  585.         folding editor
  586.  
  587.      pbmplus
  588.         portable bitmap format conversions, manipulations
  589.  
  590.      plplot
  591.         slick scientific data plotting
  592.  
  593.      ?  a groff PBM driver using Hershey fonts
  594.  
  595.   5.  Programming for MGR
  596.  
  597.   The MGR programmers manual, the C language applications interface, is
  598.   found in the doc directory in troff/nroff form.  It covers general
  599.   concepts, the function/macro calls controlling the server, a sample
  600.   application, with an index and glossary.
  601.  
  602.   Porting client code used with older versions of MGR sometimes requires
  603.   the substitution of
  604.  
  605.  
  606.            #include <mgr/mgr.h>
  607.  
  608.  
  609.  
  610.  
  611.   for
  612.  
  613.  
  614.            #include <term.h>
  615.            #include <dump.h>
  616.  
  617.  
  618.  
  619.  
  620.   and clients using old-style B_XOR, B_CLEAR, et al instead of BIT_XOR,
  621.   BIT_CLR, et al can be accommodated by writing
  622.  
  623.  
  624.            #define OLDMGRBITOPS
  625.            #include <mgr/mgr.h>
  626.  
  627.  
  628.  
  629.  
  630.   Compiling client code generally requires compiler options like the
  631.   following.
  632.  
  633.  
  634.            -I/usr/mgr/include   -L/usr/mgr/lib -lmgr
  635.  
  636.  
  637.  
  638.  
  639.   One can get some interactive feel for the MGR server functions by
  640.   reading and experimenting with the mgr.el terminal driver for GNU
  641.   Emacs which implements the MGR interface library in ELisp.
  642.  
  643.   The usual method of inquiring state from the server has the potential
  644.   of stumbling on a race condition if the client also expects a large
  645.   volume of event notifications.  The problem arises if an
  646.   (asynchronous) event notification arrives when a (synchronous) inquiry
  647.   response was expected.  If this arises in practice (unusual) then the
  648.   MGR state inquiry functions would have to be integrated with your
  649.   event handling loop.
  650.  
  651.   The only major drawing function missing from the MGR protocol, it
  652.   seems, is an area fill for areas other than upright rectangles.  There
  653.   is new code for manipulating the global colormap, as well as
  654.   (advisory) allocation and freeing of color indices owned by windows.
  655.  
  656.   If you are thinking of hacking on the server, you can find the mouse
  657.   driver in mouse.* and mouse_get.*, the grotty parts of the keyboard
  658.   interface in kbd.c, and the interface to the display in the
  659.   src/libbitblit/* directories.  The main procedure, much
  660.   initialization, and the top level input loop are in mgr.c, and the
  661.   interpretation of escape sequences is in put_window.c.
  662.  
  663.  
  664.   6.  More documentation
  665.  
  666.   The programmer's manual is essential for concepts.
  667.  
  668.   Nearly all the clients supplied come with a man page which is
  669.   installed into /usr/mgr/man/man1 or man6.  Other useful man pages are
  670.   bitblit.3, font.5, and bitmap.5.  There is some ambiguity in the docs
  671.   in distinguishing the internal bitmap format found in your frame-
  672.   buffer and the external bitmap format found in files, e.g. icons.
  673.  
  674.   The mgr.1 man page covers command line options, commands in the
  675.   ~/.mgrc startup file, mouse and menu interaction with the server, and
  676.   hot-key shortcuts available on systems with such hot-keys.
  677.  
  678.   Many of the fonts in /usr/mgr/font/* are described to some extent in
  679.   /usr/mgr/font/*.txt, e.g. /usr/mgr/font/FONTDIR.txt gives X-style font
  680.   descriptions for the fonts obtained in .bdf format.  Font names end in
  681.   WxH, where W and H are the decimal width and height in pixels of each
  682.   character box.
  683.  
  684.  
  685.   7.  Credit for MGR
  686.  
  687.   Stephen Uhler, with others working at Bellcore, was the original
  688.   designer and implementer of MGR, so Bellcore has copyrighted much of
  689.   the code and documentation for MGR under the following conditions.
  690.  
  691.  
  692.       * Permission is granted to copy or use this program, EXCEPT that it
  693.       * may not be sold for profit, the copyright notice must be reproduced
  694.       * on copies, and credit should be given to Bellcore where it is due.
  695.  
  696.  
  697.  
  698.   One required showing of the copyright notice is the startup title
  699.   screen.
  700.  
  701.   Other credits to:
  702.  
  703.   o  Stephen Hawley for his wonderful icons.
  704.  
  705.   o  Tommy Frandsen for the VGA linux library.
  706.  
  707.   o  Tom Heller for his Gasblit library.
  708.  
  709.   o  Andrew Haylett for the Mouse driver code.
  710.  
  711.   o  Dan McCrackin for his gasblit->linux patches.
  712.  
  713.   o  Dave Gymer, dgp@cs.nott.ac.uk, for the Startrek effect fix.
  714.  
  715.   o  Alex Liu for first releasing a working Linux version of MGR.
  716.  
  717.   o  Lars Aronsson (aronsson@lysator.liu.se) for text2font and an
  718.      ISO8859-1 8-bit font.
  719.  
  720.   o  Harry Pulley (hcpiv@grumpy.cis.uoguelph.ca,
  721.      hcpiv@snowhite.cis.uoguelph.ca) for the Coherent port.
  722.  
  723.   o  Vance Petree & Grant Edwards & Udo Munk for their work on Hercules.
  724.  
  725.   o  Udo Munk for his work on serial mouse initialization & select.
  726.  
  727.   o  Norman Bartek & Hal Snyder at Mark Williams Co.  for their help
  728.      with some bugs & with Coherent device drivers.
  729.  
  730.   o  Extra thanks to Zeyd Ben Halim for lots of helpful patches,
  731.      especially the adaptation of selection.
  732.  
  733.   o  Bradley Bosch, brad@lachman.com, for lots of patches from his 3b1
  734.      port, which fix bugs and implement new and desirable features.
  735.  
  736.   o  Andrew Morton, applix@runxtsa.runx.oz.au, who first wrote the cut-
  737.      word code.
  738.  
  739.   o  Kapil Paranjape, kapil@motive.math.tifr.res.in, for the EGA
  740.      support.
  741.  
  742.   o  Michael Haardt for MOVIE support fixes, bug fixes, separation of
  743.      the libbitblit code into output drivers, expansion of the libmgr,
  744.      and origami folding of the code.
  745.  
  746.   o  Yossi Gil for many fonts.
  747.  
  748.   o  Carsten Emde, carsten@thlmak.pr.net.ch, for mphoon.
  749.  
  750.   o  Vincent Broman for middle mouse-button emulation, linting, Sun
  751.      cgsix support, VGA colormap acess, and integration of the sunport
  752.      code into Haardt's layering scheme.
  753.  
  754.   All bitmap fonts from any source are strictly public domain in the
  755.   USA.  The 575 fixed-width fonts supplied with MGR were obtained from
  756.   Uhler, the X distribution, Yossi Gil, and elsewhere.  The Hershey
  757.   vector fonts and the code for rendering them are probably freely
  758.   redistributable.
  759.