home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / utilities / utilst / xfront / !Xfront / !Help < prev    next >
Text File  |  1995-05-03  |  5KB  |  156 lines
  1. !Xfront - The improved !X front end
  2. ===================================
  3.  
  4. By S.J.Borrill
  5.  
  6. v1.04 3rd May 1995
  7.  
  8. NOTE:  !Xfront is FREEWARE. It is freely distributable, as long as it is
  9. supplied in it's entirety. I retain the copyright.
  10.  
  11. N.B. !X is © Gnome Computers
  12.  
  13. Purpose
  14. =======
  15. !X is a very nice program that allows your RISCOS computer to function as an
  16. X terminal. Unfortunately, the frontend for !X requires you to remember the
  17. command line syntax and options if you wish to reconfigure the number of
  18. screens, resolution, colour depth, etc. !Xfront is a application that
  19. coexists with !X to provide a more versatile user interface. You *must* have
  20. a copy of !X and also the filer must have 'seen' that copy in order for
  21. !Xfront to run.
  22.  
  23. N.B. The !X.!Boot file does not contain the line:
  24. Set X$Dir <Obey$Dir>
  25. This *must* be inserted otherwise !X will have to be run before using
  26. !Xfront.
  27.  
  28. Use
  29. ===
  30.  
  31. ***** !Xfront supports the interactive help provided by !Help *****
  32.  
  33. Double click on the !Xfront icon. When the !Xfront is installed on the
  34. iconbar, you have three options depending on which mouse button you press
  35. over the !Xfront icon.
  36.  
  37. SELECT : Opens the !Xfront options window.
  38. MENU   : Brings up the !Xfront menu.
  39. ADJUST : Starts the X server with the default settings.
  40.  
  41. The iconbar menu has 3 options:
  42.  
  43.     Info >              Tells you about the program.
  44.     Bug compatible      Disable some error checking for backwards
  45.                 compatibility to older releases of !X. See 
  46.                 manual for details.
  47.     Quit                Quits Xfront.
  48.  
  49. The main options window has a few different sections.
  50.  
  51. At the top are the options relating to up to four screens. (If you want to
  52. use more screens, get in touch and I'll get it to do it). Clicking MENU over
  53. the screen information will bring up a menu with all the different display
  54. types known. Choosing a display type from the menu will select that for the
  55. screen that you pressed MENU over. There is also an option to define a new
  56. display mode (up to 10 modes can be defined - get in touch if this is too
  57. few). You can also click on the up/down arrows to cycle through the available
  58. displays. You can switch dynamic colourmaps on and off with the relevant
  59. option button. The number of screens desired can be altered with the option
  60. buttons alongside screens 1, 2 and 3. It will all make sense when you give it
  61. a go. (Honest!)
  62.  
  63. Next, there is the desired X host. This will default to 'broadcast'. (see
  64. later how to configure other hosts). Clicking MENU over here will give a list
  65. of known hosts read in from your xdmfile.
  66.  
  67. Next, there are sections for you to enter the actual size of your monitors
  68. display and to allow you to configure mouse acceleration. If you are used to
  69. a standard RISCOS mouse then leave acceleration at 1. This gives linear
  70. movement.
  71.  
  72. Next, there are two options buttons allowing you to choose whether you want
  73. backing store to be applied to all windows and whether you want multiple X
  74. sessions or not. (See !X manual for details)
  75.  
  76. Finally, you can enter any other options you require in the bottom writable
  77. icon.
  78.  
  79. Once you have set up the options as you wish, you can:
  80.  
  81. a) Close the window (by clicking on cancel). Clicking ADJUST on the iconbar
  82.    icon will now start the X server with your set options.
  83.    
  84. b) Save the settings as defaults.
  85.  
  86. c) Start the X server with the required setting immediately.
  87.  
  88. d) Save the setting as an Obey file to allow multiple configurations. To do
  89.    this, click MENU (away from the screen and host sections) and use the
  90.    save option to save the Obey file to the desired location.
  91.    
  92. Customising
  93. ===========
  94.  
  95. !Xfront uses 3 files to get its information.
  96.  
  97. <Xfront$Dir>.Modes
  98.   -  Has a list of modes that are offered as display types. The file can
  99.      either be edited directly or rather, use the 'New mode...' menu option
  100.      on the option screen menu to add new display modes.
  101.  
  102.   -  This file has one mode per line in the format:
  103.      X res, Y res, colours (the same as colours options for !X)
  104.      e.g.  1024 768 c16   =>  1024x768x32767 (16bit) colour
  105.            640 480 bw4    =>  640x480x16 greys
  106.      Here is my Modes file:
  107.  
  108. ----Cut here ----
  109. 800 600 c16
  110. 1024 768 c8
  111. 1280 1024 c4
  112. 1600 1200 c4
  113. ----Cut here ----
  114.  
  115. <Xsearch$Dir>.Defaults
  116.   -  Has a list of default options in the same format as the !X default file.
  117.  
  118. <Xsearch$Dir>.xdmfile
  119.   -  Has a list of known hosts. These must be entered in the same format as
  120.      the xdmfile file in !X.
  121.      
  122. N.B. Xsearch$Dir can be set up to use the defaults and xdmfile files from !X,
  123. simply by editing the !Run file in the !Xfront directory.
  124.  
  125. History
  126. =======
  127.  
  128. v1.00 16/3/95 Started work
  129. v1.01 22/3/95 Finished work. Got save Obey files to work. First release.
  130. v1.02 27/3/95 Got first bug report (Thanks to Peter Killworth. Now allows
  131.               any number of hosts to be set up. Changed from 'hosts' to 
  132.               'xdmfile' for list of hosts.
  133. v1.03 27/3/95 Re-organised menu system and rewrote help text. Second release.
  134. v1.04  3/5/95 Fixed a bug in the parsing of the xdmfile. Added 'bug
  135.           compatible' to menu (equivalent to 'bc' option). Thanks to
  136.           Chris at Gnome for suggesting that. Third release.
  137.  
  138. Contact
  139. =======
  140.  
  141. Contact me at:
  142.  
  143. Stephen Borrill
  144. Fitzwilliam College,
  145. Cambridge.
  146. CB3 0DG
  147.  
  148. or email me on:
  149.  
  150. sjb42@cus.cam.ac.uk
  151.  
  152.  
  153.  
  154. S.J.Borrill
  155. 3/5/95
  156.