home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 4 / DATAFILE_PDCD4.iso / unix / riscbsd / 1_1_beta / readme_x11 < prev    next >
Text File  |  1996-10-07  |  7KB  |  182 lines
  1. ****************************************************************************
  2. *                                                                          *
  3. *                         RiscBSD X11R6 Distribution                       *
  4. *                               Alpha Release                              *
  5. *                               Release Notes                              *
  6. *                                v4 16/8/95                                *
  7. *                                                                          *
  8. ****************************************************************************
  9.  
  10. Copyright (C) 1995 Robert Black (RiscBSD kernel team)
  11.  
  12. Copyright (C) 1994 X Consortium
  13.  
  14. Permission is hereby granted, free of charge, to any person obtaining a copy
  15. of this software and associated documentation files (the "Software"), to
  16. deal in the Software without restriction, including without limitation the
  17. rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
  18. sell copies of the Software, and to permit persons to whom the Software is
  19. furnished to do so, subject to the following conditions:
  20.  
  21. The above copyright notice and this permission notice shall be included in
  22. all copies or substantial portions of the Software.
  23.  
  24. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  25. IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  26. FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
  27. X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
  28. AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNEC-
  29. TION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  30.  
  31. Except as contained in this notice, the name of the X Consortium shall not
  32. be used in advertising or otherwise to promote the sale, use or other deal-
  33. ings in this Software without prior written authorization from the X Consor-
  34. tium.
  35.  
  36. X Window System is a trademark of X Consortium, Inc.
  37.  
  38. The above copyrights apply to the entire RiscBSD X Windows package.
  39.  
  40.  
  41. ****************************************************************************
  42.  
  43.  
  44. Contents:
  45. 1. Introduction
  46. 2. X Installation
  47. 3. Starting X
  48. 4. Known Problems & Bugs
  49.  
  50.  
  51. ****************************************************************************
  52.  
  53.  
  54. Section 1. Introduction.
  55.  
  56. Welcome to the RiscBSD distribution of X windows. This is an alpha version of
  57. the RiscBSD port of the X Window System. This release is being made due to
  58. popular demand and, as such, it is unfinished and has a lot of bugs. As the
  59. configuration used by imake has not been finalised there are no libraries or
  60. header-files in this release. There are also likely to be missing manual pages
  61. as I don't have enough disk space to build them.
  62.  
  63.  
  64. ****************************************************************************
  65.  
  66.  
  67. Section 2. X Installation.
  68.  
  69. The name of this section is slightly misleading because it doesn't tell you
  70. how to actually unpack the distribution onto your system. You should do this
  71. using inst in the usual manner. The installation installs all files relevant
  72. to X in the directory /usr/X11R6. To remove the X installation simply delete
  73. this directory.
  74.  
  75. The directory structure of this X distribution is split into three parts:
  76.  
  77. /usr/X11R6/bin        - X binaries and support programs. Add this directory to
  78.                       your path.
  79.  
  80. /usr/X11R6/lib      - Configuration files, data files and fonts. The libraries
  81.                       have been deliberately omitted.
  82.  
  83. /usr/X11R6/include  - not a lot :-) This directory will eventually contain
  84.                       the include files necessary to compile new binaries.
  85.  
  86. The whole package takes up about 45Mb of disk space. If you want to reduce
  87. this you can do so by removing fonts and binaries. If you remove anything
  88. else X is likely to break. The recommended minimal installation is:
  89.  
  90. binaries:
  91.  
  92. X                   - A symbolic link to Xarm.
  93.  
  94. Xarm                - The X server binary. You do not need this if you will
  95.                       not be displaying X locally. If you remove this you
  96.                       can remove all the fonts as well.
  97.  
  98. xterm               - A terminal window. If you delete this X won't be very
  99.                       useful unless you are running your applications on
  100.                       another host.
  101.  
  102. twm                 - A window manager. You need to run this if you want to
  103.                       be able to move windows around.
  104.  
  105. xrefresh            - Redraws the screen if it gets corrupted. Remember that
  106.                       this is an alpha release.
  107.  
  108. xconsole            - If you run this then system messages will be put here.
  109.                       Otherwise they are likely to corrupt the display.
  110.  
  111. xsetroot            - You need this to be able to change the colour of the
  112.                       background. The default dithered background upsets
  113.                       some monitors.
  114.  
  115. startx              - Script to start X by calling xinit.
  116.  
  117. xinit               - Program to handle starting the X server.
  118.  
  119. fonts:
  120.  
  121. misc
  122.  
  123. You can't delete the other font directories completely as X will look for
  124. the files font.alias and font.dir in them.
  125.  
  126.  
  127. ****************************************************************************
  128.  
  129.  
  130. Section 3. Starting X.
  131.  
  132. The simplest way to start X is to type 'startx' (after adding /usr/X11R6/bin
  133. to your path). The version number of the X server will be printed on the
  134. current virtual console. Immediately after this the console switches to
  135. console 8 (corresponding to alt+F9). This is the console used by X. If all
  136. is going well the screen will flash white and then be cleared to a graded
  137. blue-green display. From this point X takes about 30-40 seconds to start. Do
  138. not worry. This long delay is perfectly normal and is caused by RiscBSD's
  139. unoptimised floating point emulator.
  140.  
  141. When X has started you will probably have an xterm at the top left of the
  142. screen. You can't move this around unless you run a window manager (eg twm).
  143. The easiest way to do this is to type 'twm &' in the xterm.
  144.  
  145. The numeric keypad does not act as a numeric keypad but as an alternative to
  146. the mouse.
  147.  
  148. You cannot switch virtual terminals from within X unless you disable the
  149. X keyboard driver first using <Print Screen>. Please note that there is
  150. currently no way to reenable the keyboard driver without restarting X.
  151.  
  152. When you have finished using X you can shut it down by exiting from your
  153. original xterm. Alternatively you can press <Print Screen>, switch to a text
  154. console and kill the X server process.
  155.  
  156. If the kernel panics the X server will appear to hang but alt+Fx will change
  157. virtual console.
  158.  
  159.  
  160. ****************************************************************************
  161.  
  162.  
  163. Section 4. Known Problems & Bugs.
  164.  
  165. The following are known problems with the X server. If you come across any
  166. more please mail them either to the list or to r.black@ic.ac.uk.
  167.  
  168. 1. There is a black blob on the screen.
  169.  
  170. This is the hardware cursor which currently doesn't always get turned off
  171. properly.
  172.  
  173. 2. X doesn't work in non 8-bit modes.
  174.  
  175. Correct. It isn't implemented yet.
  176.  
  177. 3. The screen blanks whilst I'm typing.
  178.  
  179. This is a known bug.
  180.  
  181. ****************************************************************************
  182.