home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / mint / x11 / readme < prev    next >
Encoding:
Text File  |  1994-12-13  |  5.5 KB  |  188 lines
  1.  
  2.  
  3.         An X-Window system Port for MiNT
  4.  
  5.  
  6. This is a port of the X-Window system (X11R5) for MiNT. Unfortunately, this
  7. distribution contains only executables. There's still a lot of work to be done
  8. to be able to distribute the full source code. Until shortly you could get the
  9. original source code on ftp-server of the TU Darmstadt, but somehow they are
  10. gone now. (This might have something to do with the fact that they have X11R6
  11. there now?!) Anyway, you can find more fonts and documentation there.
  12.  
  13.  
  14.  
  15. Installation
  16. ============
  17.  
  18. 1. Install mint-net and get a shell "sh".
  19.  
  20. 2. Create a neu directory. In the following steps you must replace "$X11" with
  21.    this directory.
  22.  
  23. 3. Unpack the archive in "$X11". You will get the directories "$X11/etc",
  24.    $X11/home and $X11/usr.
  25.  
  26. 4. Create the directory "$X11/tmp".
  27.  
  28. 5. Create the directory "$X11/bin" and put the shell "sh" in it.
  29.  
  30. 6. Edit (or create) the file "mint.cnf": It should contain at least:
  31.     CON=u:\dev\console
  32.     PRN=u:\dev\console
  33.     cd u:\
  34.     setenv UNIXMODE /-ru
  35.     setenv PATH /usr/local/bin/X11
  36.     setenv HOME $X11/home
  37.     sln $X11\bin u:\bin
  38.     sln $X11\etc u:\etc
  39.     sln $X11\usr u:\usr
  40.     sln $X11\tmp u:\tmp
  41.     exec $X11\bin\kbd
  42.     exec $X11\pty\pty
  43.     INIT=$X11\usr\local\bin\X11\xinit
  44.  
  45. 7. Restart your computer. You should get a "xterm" and a "xclock".
  46.  
  47.  
  48.  
  49. The X-Server
  50. ============
  51.  
  52. The actual X-server is called "X". It should be invoked by "xinit" or "startx"
  53. but can also be invoked directly. If you invoke the server directly, the
  54. "DISPLAY" environment variable should be set to ":0".
  55.  
  56. The "/tmp" directory has to be on a minix-partition of your disk or you have to
  57. invoke the server as "root". Otherwise you'll get an error like this:
  58.  
  59.     Binding Unix socket: access denied.
  60.  
  61.  
  62. When the X-server starts, the program will print out an error message like
  63.  
  64.     Couldn't open RGB_DB '/usr/lib/X11/rgb'
  65.  
  66. You can safely ignore it. Sometimes you will also encounter a message like
  67.  
  68.     Unix domain socket /tmp/.X11-unix/X0 trashed, receating
  69.  
  70. This is because this file is supposed to be a socket and not a normal file. But
  71. this shouldn't cause any other problems.
  72.  
  73. The server needs at least two fonts: "cursor" and "fixed". They can be found in
  74. the "fonts" subdirectory. If you want to install more fonts, put them there
  75. too.
  76.  
  77. The keyboard driver is called "kbd". Kbd installs a driver that puts the
  78. scancodes in "/dev/scancode". You have to be "root" to do this. The only option
  79. is "-n". This option causes the driver to pass on keyboard events to TOS, even
  80. when another program gets them (i.e. when "/dev/scancode" is open).
  81.  
  82. You can kill the server with "CTRL-LSHIFT-ESC" immediately. However, running
  83. applications aren't shutdown correctly (yet?).
  84.  
  85. The server doesn't use VDI. It accesses the display memory directly. Up to now
  86. it only supports monochrome displays. You can only run TOS and X programs with
  87. this server. You _cannot_ run GEM files!
  88.  
  89. The two mouse buttons on the Atari mouse play the roles of the first and third
  90. mouse button on a normal X-mouse. You will probably be able to use the second
  91. mouse button on three-button-mice that use "/dev/mouse" correctly.
  92.  
  93.  
  94.  
  95. Applications
  96. ============
  97.  
  98. You can set global application defaults in "/usr/lib/X11/app-defaults/*" and
  99. personal user defaults in "~/.Xdefaults". The author's personal defaults file
  100. is incuded as "home/.Xdefaults" in the distribution. The files in the
  101. "usr/lib/X11/app-defaults" directory are the original system defaults.
  102.  
  103.  
  104. xterm
  105. -----
  106.  
  107. You need the "pty" driver to run xterm. With every invokation you will get two
  108. ptys in "/dev/[pt]tty*". This can only be done as root. However, this driver
  109. doesn't work reliably: the stty settings don't work.
  110.  
  111. Also, you'll need the "/etc/termcap" file. The original "termcap" file is
  112. included in the distribution.
  113.  
  114. On the author's machine the "tcsh" shell crashed a couple of times (shortly
  115. before the prompt came up). This was fixed by shortening the entry for "xterm"
  116. in "/etc/termcap". But lately, it seems to work even without modifications.
  117.  
  118. There's a utility program called "resize" that re-sets the values of "COLUMNS"
  119. and "LINES" when you have changed the size of your window.
  120.  
  121.  
  122. twm
  123. ---
  124.  
  125. The "twm" configuration is determined by the contents of
  126.  
  127.     /usr/lib/X11/twm/system.twmrc
  128.  
  129. and also "~/.twmrc". The first should contain global definitions and the second
  130. personal definitions that are preferred.
  131.  
  132. The files "{jim,keith,lemke}.twmrc" are the original twm files. "home/.twmrc"
  133. is the authors configuration.
  134.  
  135.  
  136. xinit
  137. -----
  138.  
  139. This program sets up the X-server and then tries to call "~/.xinitrc" or
  140. "/usr/lib/X11/xinit/xinitrc". If this fails you will get an "xterm".
  141. "home/.xinitrc.orig" is the original file, "home/.xinitrc" is the file that the
  142. author uses.
  143.  
  144. There's also a shell script "startx" that calls "xinit".
  145.  
  146.  
  147. bitmap, atobm, bmtoa
  148. --------------------
  149.  
  150. This program needs the "Bitmap" resource file and the corresponding bitmaps to
  151. work.
  152.  
  153.  
  154. x11perf
  155. -------
  156.  
  157. The window of this application is a little smaller than normal, so that it fits
  158. onto the author's screen. But if you test the program with images it crashes!
  159.  
  160.  
  161.  
  162. Bugs
  163. ====
  164.  
  165. - xdpyinfo outputs a wrong resolution
  166. - keyboard auto-repeat doesn't work
  167. - there's no colour support
  168. - clients don't recognize (properly) when the server dies
  169. - the cursor still flashes, even when X is running
  170. - the program-flags aren't set correctly, so the programs can't use fast-ram
  171.  
  172.  
  173.  
  174. Author
  175. ======
  176.  
  177. Send comments and bug reports to
  178.  
  179.   Andreas Kirschbaum
  180.   ank@rbg.informatik.th-darmstadt.de
  181.  
  182. or via snail mail:
  183.  
  184.   Andreas Kirschbaum
  185.   Quellenstr. 5
  186.   61118 Bad Vilbel
  187.   Germany
  188.