home *** CD-ROM | disk | FTP | other *** search
/ Amiga GigaPD 3 / Amiga_GigaPD_v3_3of3.iso / netbsd / contrib / bsd / x11 / xami_rev0.readme < prev    next >
Text File  |  1993-06-25  |  6KB  |  147 lines
  1.  
  2. rev 0.00 Xami - general information
  3. ===================================
  4.  
  5. Xami
  6. ---- 
  7. Xami is a very generic X11R5 server based on Israel & Fortune book
  8. "The X Window System Server".  Basically to port the generic server
  9. this book describes, all you need is three devices: frame buffer,
  10. mouse, and keyboard.  Thanks to the very robust and somewhat stable
  11. nature of NetBSD, X11R5 ports quickly and basically unmodified.
  12. However, to tune a server, one can spend a lifetime (hardware mouse,
  13. blitter usage, user defined options, bells, whistles, etc).  Currently
  14. Xami only supports the mfb (monochrome frame buffer) library on the
  15. native Amiga chip set and will probably stay that way.
  16.  
  17. This Xami is a little rough, but seemed stable enough to have someone
  18. help test.  A query to the mailing list showed enough interest to
  19. upload.  Well, ok, 4-5 people expressed interest, and the French Xbsd
  20. guys asked a question.  But anyways, please comment if you try Xami!
  21. (even if you just want me to unlink the whole mess).  Especially if
  22. you also tried Xbsd!
  23.  
  24. "wee alrrready a got a one!  Eeets vhar nhaaace! (I tolla him we
  25. already a got a one (heeheehee)).
  26.   - Monty Python and the Holy Grail
  27.  
  28. Note: Xami is completely independent of "Xbsd" (though I did try out
  29. the R4 version of that server a while back, it appeared to worked
  30. fine.  I just don't have the disk space to try their R5 version).
  31.  
  32. This Release
  33. ------------
  34. This is a mini-release designed to keep things small.  Perhaps it will
  35. have more appeal to people who want to run X but have little disk
  36. space.  The intent here is to be complete yet keep it down to 2mb
  37. compressed, 5mb uncompressed or so.  The other X11 "Xbsd" package
  38. should be completely compatible with this for binaries, fonts, libs,
  39. etc, so they may be used for a more complete X.  Basically this
  40. release includes the server, a few clients, necessary lib stuff, some
  41. fonts, and some misc info.
  42.  
  43. Kernel
  44. ------
  45. This first release supports runs on an unmodified 709 Kernel.  I
  46. didn't move up to 713/14 yet because of : small 640x400 window, no
  47. /dev/reboot (which I do a lot), trouble with /tmp disk and newfs.  It
  48. should be easy enough to move over later.
  49.  
  50. Mouse
  51. -----
  52. Expects a /dev/mouse.  Please use a soft link to link /dev/mouse1 or
  53. /dev/mouse2, whichever you are using, to point to /dev/mouse, if there
  54. is not already one.  The left button is the X button 1.  The right
  55. button is the X button 2 (middle).  Both buttons down (or the middle
  56. button) signify the seldom used X button 3.  Should add some option
  57. switch to make this change for (lucky) people with three actual
  58. physical buttons.
  59.  
  60.  
  61. Keyboard
  62. --------
  63. Supports US keyboard, expects a /dev/kbd for the keyboard device.
  64. Same keyboard repeat times as the kernel 709 ite console driver.  Even
  65. includes the occasional key repeat problem.  Just when I think I've
  66. fixed it, it comes back to haunt me.  See below for info on using the
  67. keyboard to reset the server.
  68.  
  69.  
  70. Framebuffer
  71. -----------
  72. Expects a /dev/grf0 for the framebuffer device.  Opens the full 1024 x
  73. 1024 size framebuffer, with visibile width 716x768, even though the
  74. true visible height is 464.  This is done so that x11perf may be run,
  75. as it expects a 768 or so tall window or so.  If the pointer is missing,
  76. it may be lurking down there.  Just don't put any windows down there or
  77. you may never find them :-).
  78.  
  79. Environment Setup
  80. -----------------
  81. - Install everything into /usr/X11R5/Amiga/...
  82. - 'setenv DISPLAY :0' or whatever you do to export and env.
  83. - make sure ip sockets are enabled by goint multiuser or
  84.    execute ". /etc/netstart" for single user.
  85. - make sure your path points to /usr/X11R5/Amiga/bin before /usr/bin/X11.
  86. - startup the server with startx or xinit.
  87.  
  88. Server Startup
  89. --------------
  90. You may use startx or xinit to start up the server.  Or for that
  91. matter, start up everything by hand.  Before starting, do a 
  92. ". /etc/netstart", or go multiuser, to enable the ip sockets.
  93. Use "xinit >& /tmp/x.log" or some such to prevent scrolling of the
  94. framebuffer due to occasional system messages.  Same when using 
  95. "startx >& /tmp/x.log".
  96.  
  97. Be careful not to touch the mouse during startup.  It will do a
  98. sleep(6) to wait for the green crosshairs to blank, then do a grfoff
  99. to keep it blank and allow the X blankers to blank rather than the
  100. NetBSD blanker.  I havent't figured out a quick way of blanking the
  101. green crosshair cursor without kernel mods yet, and figure it's easy
  102. on the newer kernels, so it is not a high priority.  I suppose another
  103. cheap way out would be to use /dev/mouse2.
  104.  
  105. Use -ac switch to turn off authorization if you like.  Otherwise, be
  106. sure to 'setenv DISPLAY :0' or 'export DISPLAY=:0'. before running
  107. clients.
  108.  
  109.  
  110. Server Exit
  111. ----------- 
  112. If the server is alive enough to read the keyboard, you may do a
  113. Shift-Shift-F1-F10 (press all four keys simultaneously) to kill the
  114. server.  This is only if you are deperate.  I arbitrarily picked the
  115. keys hoping this sequence was unlikely to be encountered in day to day
  116. use (patchable but not programmable - yet).  Otherwise kill the login
  117. client or just do a ps and kill the server.
  118.  
  119.  
  120. Future Plans
  121. ------------
  122. I ported this mainly to convince myself that if I got a high zoot
  123. graphics card that it could be used for X.  Otherwise, I simply
  124. wouldn't buy one.  In this way I guarantee that whatever I buy will be
  125. supported :-).  I have high hopes of speeding up the server
  126. significantly and supporting the latest kernel and whatever graphics
  127. cards I can find.  Of course, in the meantime "Xbsd" looks like it
  128. will be supporting some of these cards already.
  129.  
  130.  
  131. Packing list:
  132. -------------
  133. These were compiled to be located under
  134. /usr/X11R5/Amiga/{bin,lib,...}.  If you would like them elsewhere, be
  135. sure links exist to point to the area that X expects to find things
  136. in.  Likewise, if you are using Xbsd files, be sure links point from
  137. the above files, to where Xbsd is expecting to find them (probably
  138. /usr/bin/X11, usr/lib/X11, etc).
  139.  
  140. Binaries:  Xami, xterm, twm, xinit, startx, xev, xrefresh, x11perf.
  141.            X links to Xami.
  142.  
  143. Lib dir:  complete except for 100dpi and 75dpi fonts.
  144.  
  145. Misc:  misc stuff:  configuration files, etc.
  146.  
  147.