home *** CD-ROM | disk | FTP | other *** search
/ 3D GFX / 3D GFX.iso / pcutils / dos / gl_shell / gl-shell.doc < prev    next >
Encoding:
Text File  |  1995-12-31  |  11.5 KB  |  275 lines
  1.  
  2. ***************************************************************************
  3.                 GL-SHELL version 2.1
  4.                      SHAREWARE
  5.                  (c) C.W.Windt '94 - '95
  6. ***************************************************************************
  7.  
  8. THIS DOCUMENT:
  9. --------------  
  10.  
  11.           1) Introduction
  12.           2) Special features
  13.           3) Short description of menu options
  14.           4) Installation
  15.           5) Limitations
  16.       6) Moving Gl-Shell to another directory
  17.           7) Uninstalling Gl-Shell
  18.           8) Removing the introduction screen
  19.           9) About GRASPRT
  20.              * Commands while viewing an animation
  21.           10) Registering
  22.  
  23.  
  24. 1) INTRODUCTION  
  25. ---------------
  26. Gl-Shell is an utility meant to make viewing your GL and .EXE animations a 
  27. lot easier and faster. Instead of having to re-type your commands from DOS 
  28. over and over again you'll be able to click and watch. A lot of time was 
  29. spent to make Gl-Shell as user-friendly as possible. That's why there are two 
  30. file-listing options in this version: One that enables searching other 
  31. directories and drives, and one that was designed to show you all .GL files 
  32. at a glance and enable you to choose several animations at once for viewing. 
  33. Also, Gl-Shell will remember the last directory you viewed an animation from 
  34. and automatically return there the next time you start Gl-Shell. Only the 
  35. first time you start Gl-Shell you'll get the Main-Menu on start-up, 
  36. afterwards it will immediately go to the file listing menu you viewed an 
  37. animation from the last time. 
  38.  
  39. 2) SPECIAL FEATURES:
  40. --------------------
  41. You can start Gl-Shell either by typing GL-SHELL or by typing GLS. There IS 
  42. a difference other than that "GLS" is shorter! 
  43.  
  44. MEMORY ECONOMY MODE: Will only be initialised by starting Gl-Shell with the 
  45. batch-file 'GLS.BAT'! In this mode Gl-Shell will not use ANY memory at all 
  46. while viewing an animation. Also, only in Memory Economy Mode you'll be able 
  47. to view .EXE (executable) animations. Freeing all available memory for your
  48. animations is especially important when viewing larger animations. In Memory 
  49. Economy Mode you'll be able to view ANY animation you would normally be able 
  50. to view from DOS. If you still get error readings you might try loading DOS 
  51. high and removing any TSR's from memory to get more conventional memory 
  52. available for your movies. 
  53.  
  54. SPEED MODE: Is only named that way because in this mode the transition from 
  55. the file-list to viewing an animation is a little bit quicker. Especially on 
  56. a fast computer the difference will hardly be noticeable. You'll initialize 
  57. Speed Mode when you start Gl-Shell by typing "Gl-Shell"(.EXE) instead of 
  58. "GLS"(.BAT). Don't worry, you'll notice: there's a warning screen at startup 
  59. notifying you that you've entered Speed Mode. In this mode Gl-Shell will 
  60. work, but especially when viewing large animations errors may occur. In 
  61. Speed Mode Gl-Shell does not unload itself from memory, leaving less memory
  62. available for your animation. Another disadvantage is that you cannot view 
  63. .EXE animations in Speed Mode. 
  64.  
  65.  
  66.  
  67. 3) SHORT DESCRIPTION OF MENU OPTIONS:
  68. -------------------------------------
  69.  
  70. Main menu:
  71. ----------
  72. Select an item by pressing Enter or Double-clicking.
  73.  
  74. List and View with Directories:
  75. -------------------------------
  76. List all .GL (and .EXE in Memory Economy Mode) animations, change directory 
  77. and/or drive. Once you've viewed a GL from another directory this will become 
  78. the new default directory. View an animation by pressing Enter or double-
  79. clicking. Change field by pressing Tab or use your mouse. Esc returns you to 
  80. the main menu.
  81.  
  82. List, Tag and View:
  83. -------------------
  84. List all .GL (and .EXE in Memory Economy Mode) animations in the default 
  85. directory, looks like dir /w. Tag files by pressing space or Single-clicking, 
  86. view all tagged animations by pressing Enter or Double-Clicking. Esc returns 
  87. you to the main menu. 
  88.  
  89. Delete a file:
  90. --------------
  91. Deleting a file is now possible by choosing the option from the main menu 
  92. and selecting the file(s) to delete. No need to leave the program anymore. 
  93. Tagging: Press space or click; Confirm your choice by pressing Enter or 
  94. double clicking, or press Esc to abort.
  95.  
  96. Configuration:
  97. --------------
  98. You can reconfigure Gl-Shell by choosing this item. In most cases you'll 
  99. never need this option, except for entering your registration code. Gl-Shell
  100. will normally automatically set the right path to GL-Shell. You can manually 
  101. enter the path to your GL animations here, or Gl-Shell will automatically 
  102. default to the home-directory or the last directory and drive you viewed an 
  103. animation from using the first file-listing option. Confirm your choices by 
  104. pressing F10 or press Esc to abort. Change field by pressing Tab or use your
  105. mouse ("Enter" is not used). Important: Do not end pathnames with "\" !
  106.      If anything is the matter with the configuration you'll be prompted 
  107. to correct it using this option. In most cases you'll be notified of the 
  108. problem, but will Gl-Shell fix it itself.
  109.  
  110.  
  111. Quit:
  112. -----
  113. Does just that: Quit. You do not need to select this item from the main menu,
  114. pressing Esc in the main menu has the same effect. 
  115.      
  116.  
  117. 4) INSTALLATION:
  118. ----------------
  119.  
  120. a) First of all, you might want to keep a copy of the complete Gl-Shell 
  121.    package as a backup on a diskette. Highly recommended! 
  122. b) Create the directory you want to put Gl-Shell in. There's no need to put 
  123.    it in the same directory as your GL animations, you can configure Gl-Shell 
  124.    to look for your animations on any drive or in any directory you please.
  125. c) Copy the Gl-Shell archive to this directory
  126. d) Unpack the archive in this directory
  127. e) Type "GLS"(.BAT) to start Gl-Shell. 
  128.    In most cases Gl-Shell will automatically configure itself. In any case, 
  129.    go to the configuration menu and make sure that the pathnames are correct.
  130.    If something is wrong you'll get an error message when exiting the 
  131.    configuration menu.
  132.    In the configuration menu you'll be able to specify a path to your GL
  133.    animations. You can do this manually or use 'list and view with 
  134.    directories' to go to another drive or directory. After you've viewed an  
  135.    animation from this new directory (using this file-listing option) this 
  136.    will become the new default directory.
  137.  
  138. IMPORTANT ! 
  139. Do not try to change the configuration by editing the file GL-SHELL.CNF. 
  140. You will easily crash Gl-Shell (I'm not kidding!). Just use the configuration 
  141. menu to change the configuration, that's what it's there for.  
  142.  
  143. IMPORTANT, TOO!
  144.  
  145. GRASPRT.EXE (included in this archive) MUST be in the same directory as 
  146. GL-SHELL.EXE itself.
  147.  
  148.  
  149. 5) LIMITATIONS:
  150. ---------------
  151.  
  152. System requirements:
  153.  
  154. - a 286 or better processor
  155. - a VGA monitor and card
  156.  
  157. Do NOT try to run Gl-Shell from another directory than the directory in wich 
  158. it is located. You'll get an error message on startup. 
  159. First go to the directory in which Gl-Shell is installed, then start Gl-Shell
  160. by typing GLS. If you try to start Gl-Shell from another directory it will not 
  161. be able to find its configuration file and GRASPRT.EXE. 
  162.  
  163.  
  164. 6) MOVING GL-SHELL TO ANOTHER DIRECTORY:
  165. ----------------------------------------
  166.  
  167. Delete the file GL-SHELL.CNF. Then copy all other files to the directory of
  168. choice. A new configuration file will be created in the new directory. 
  169. Reconfigure if keep the original configuration file.
  170.  
  171.  
  172. 7) UNINSTALLING GL-SHELL:
  173. -------------------------
  174.  
  175. In version 2.1 the configuration file is not hidden any more. You can just
  176. delete all files by typing 'DEL *.*'. 
  177.  
  178.  
  179. 8) REMOVING THE INTRODUCTION SCREEN:
  180. ------------------------------------
  181.  
  182. To keep the introduction screen from popping up each time you start Gl-Shell,
  183. rename GPIC.EXE to GPIC.BKP. This is only useful if you've got a slow PC.
  184.  
  185.  
  186. 9) ABOUT GRASPRT:
  187. -----------------
  188.  
  189. GRASPRT.EXE is the run-time version of the GRASP system. What the program says
  190. itself:
  191.  
  192. "The GRASP interpreter
  193.  Graphic Animation System for Professionals
  194.  Version 3.20 Beta Version
  195.  Copyright (C) Microtex Industries Inc. 1984 - 1988
  196.             Paul Mace Software 1987, 1988
  197.  
  198.  This run-time version of the GRASP system (GRASPRT.EXE) may be 
  199.  distributed in an unlimited fashion without license or royalty."
  200.  
  201. I would have included more documentation on GRASPRT.EXE if only I would have
  202. been able to FIND any documentation.
  203.      Gl-Shell is basically just that: A shelling program. It shells GRASPRT, 
  204. providing the user interface that GRASPRT.EXE just doesn't have, enabling you
  205. to view your animations as conveniently as possible. Since Gl-Shell isn't any 
  206. good without GRASPRT.EXE I thought it convenient to include GRASPRT.EXE in the
  207. Gl-Shell package, especially since GRASPRT.EXE itself says that it may be 
  208. distributed in an unlimited fashion without license or royalty. Maybe this is
  209. a nice way of advertising for the complete GRASP system. I for one hope that 
  210. Paul Mace sells lots of 'em... 
  211.  
  212.     WARNING: Do not use GRASPRT version 4.0. It has been known to cause
  213. problems with Gl-Shell, and with some VGA cards. 
  214.  
  215. * COMMANDS WHILE VIEWING AN ANIMATION:
  216.  
  217. - Space : Halt animation
  218. - Enter : Resume animation
  219. - Escape: Quit current animation and go to next (if more selected) 
  220.  
  221.  
  222. 10) REGISTERING:
  223. ----------------
  224.  
  225. Gl-Shell is shareware. In this case that means that you're allowed to use and
  226. test Gl-Shell 30 times. After that period you'll have to register if you want 
  227. to continue using Gl-Shell. The registration fee is absolutely minimal, just
  228. enough to cover my costs of mailing. How to register? Simple:
  229.  
  230. * Outside Europe: 
  231.   - Send $10,- to the adress below in CASH. 
  232.   - Or pay with a check but add another $15,- ( That's the handling fee for 
  233.     the bank. Yeah, that stinks.) Make the check payable to "C.W.Windt". It's
  234.     a bit safer than cash I guess, but also a lot more expensive. 
  235.  
  236. * Within Europe:
  237.   - Send Dm 15,- (Deutsch Mark) or an equivalent in your own currency to
  238.     the address below.  
  239.   - Or pay with a check but add Dm 20,- handling fee for the bank
  240.   - Or use GIRO (if you can) to transfer Dm 15,- (or an equivalent) PLUS
  241.     Dm 10,- handling fee for the bank to C.W.Windt, GIRO number 4490602.
  242.     Make sure to mention that this is a number in the Netherlands.  
  243.  
  244. * Within the Netherlands:
  245.   - Maak F10,- over op: 
  246.       Banknummer 57.05.61.310 of
  247.       Gironummer 4490602
  248.   - Zend F10,- cash of als cheque naar het adres onderaan.
  249.     Only within the Netherlands does the bank perform it's services for free.
  250.     It's a pity.
  251.  
  252. IMPORTANT: I cannot guarantee that money you send me actually reaches me. 
  253.            Normally the mail is very reliable, but then again, you never know.
  254.        I cannot be responsible for any foul-ups that might occur. By 
  255.        sending the money you accept this. I'm sorry. You CAN, however, be
  256.        sure that I'm of good will. After all, the main objective for me is
  257.        to get some feedback from users, not to get rich overnight.
  258. IMPORTANT TOO: Please make sure to mention the version of Gl-Shell that you 
  259.            have, and any remarks and/or suggestions you might have.
  260.  
  261.  
  262. That's all folks.
  263.  
  264.           
  265.                     Have Fun!
  266.      
  267.  
  268.                          
  269.                             C.W.Windt Jr.
  270.                                 Wilhelmina Singel 11
  271.                                 9641 NA Veendam
  272.                                 Netherlands (Europe)
  273.     
  274.                        Internet: WINDC@BIOL.RUG.NL 
  275.                 (Internet address valid until 1 sept. '95)