home *** CD-ROM | disk | FTP | other *** search
/ Wacky Windows Stuff... / WACKY.iso / dos / glance.doc < prev    next >
Text File  |  1993-05-31  |  16KB  |  374 lines
  1.  
  2. -------------------------------------------------------------------
  3.  
  4.  
  5.           English documentation with the Shareware Program
  6.  
  7.  
  8.                         Glance Version 1.0
  9.  
  10.  
  11.                 January 1992, by J.Schipperheijn
  12.                      Alard du Hamelstraat 53
  13.                        5622 CC  Eindhoven
  14.                          The Nederlands
  15.  
  16.  
  17. -------------------------------------------------------------------
  18.  
  19.                          RUNNING GLANCE
  20.  
  21.                Copy ALL five Glance files to one
  22.                    directory on your harddisk.
  23.  
  24.                   Run by typing GLANCE [RETURN]
  25.  
  26. -------------------------------------------------------------------
  27.  
  28.                              GOALS
  29.  
  30. Glance is a program-starter. Glance can contain a maximum of 84
  31. specifications of application programs. Each of these programs can
  32. be run by Glance. Running a program from Glance takes up only
  33. 5808 bytes of the memory available to your application program.
  34.  
  35. The main goal of Glance is to provide an attractive graphic
  36. program-starter that people actually use. Therefore it had to be
  37. easy to work with, have a good looking user interface and, most
  38. important, it had to be fast.
  39. That's why all graphics-routines and most of the rest of the
  40. source code is written directly in assembly-language, specifically
  41. to fit the needs of Glance. I didn't use any existing procedure-
  42. libraries or standard BIOS-functions. Glance is as fast as it can
  43. possibly get.
  44.  
  45. -------------------------------------------------------------------
  46.  
  47.                       SYSTEM REQUIREMENTS
  48.  
  49. Glance works on all IBM's and true compatibles with 256 Kb free
  50. memory, a VGA-card and DOS 3.0 or higher.
  51.  
  52. DOS 3.0 or higher is only needed to provide the Glance startup
  53. directory, which Glance needs to be able to (re)load the Glance
  54. overlay files and load/save your data.
  55. DOS versions with a lower version-number will cause Glance to
  56. report a error and exit to DOS, so watch your SETVER-setup.
  57.  
  58. -------------------------------------------------------------------
  59.  
  60.                          GLANCE GENERAL
  61.  
  62.  
  63. Glance can be controlled with both mouse and keyboard. The standard
  64. setting for the mouse cursor is a fly. This cursor may blink a bit
  65. on slower computers, because it is quite a complex drawing. If the
  66. blinking bothers you, switch to the arrow cursor by pressing Alt-A.
  67. The hot spot of the fly is right between his eyes.
  68.  
  69. It is IMPORTANT to know that within Glance the right mouse button
  70. is identical to a SHIFT key. By pressing a shift key you will be
  71. able to select from the lower half of one of the menu's.
  72.  
  73. The setting of the three main switches of Glance -check the task
  74. screen- are saved automatically too the EXE file when you quit
  75. Glance. So you don't have to do that yourself. The menu data will
  76. not be saved automatically, of course.
  77.  
  78. When you save your data with F2, Glance will first back up your old
  79. data file. This means that the old DAT file will be renamed to
  80. GLANCE.BAK. So if you make a mistake and you want your old data
  81. back, just go to DOS and rename GLANCE.BAK to GLANCE.DAT.
  82.  
  83. Because Glance has to read the same files from disk quite often its
  84. performance will increase drastically if a disk-cache is installed.
  85.  
  86. -------------------------------------------------------------------
  87.  
  88.                      COMMAND LINE PARAMETERS
  89.  
  90. MONO : start up in monochrome mode.
  91. VGA  : force Glance to "detect" a VGA card.
  92.  
  93. Pass any combination of these parameters to Glance if you discover
  94. that Glance is not able to detect a setting automatically at start
  95. up (which is very unlikely to ever happen). 99.999% of all Glance
  96. user's will never have to use these parameters.
  97.  
  98. -------------------------------------------------------------------
  99.  
  100.                           PROGRAM SETUP
  101.  
  102. Glance can contain up to 84 program specifications. These
  103. specifications are divided into 2 menu's. You can switch from one
  104. menu to the other by pressing TAB or SPACE. Every menu, containing
  105. 42 specifications, is split in an upper and a lower half.
  106. In between the upper and the lower half there are five function
  107. buttons on your screen.
  108. Normally, regardless of the setting of the CAPS LOCK key, only the
  109. upper half of a menu is visible on your screen. If you press a
  110. shift key -or the right mouse button- the lower half will become
  111. visible. The function buttons are always on the screen.
  112.  
  113. Glance has a task screen, on which ten functions and their corres-
  114. ponding [function] keys are displayed. This screen is only
  115. programmed for mouse addicts. Keyboard users can call all functions
  116. directly from one of the menu's by pressing the function key.
  117.  
  118. -------------------------------------------------------------------
  119.  
  120.                            GLANCE FILES
  121.  
  122. Glance exists of five files. As said before, ALL files have to be
  123. in ONE directory. The documentation file as well, since it can be
  124. read from within Glance [by pressing F8]. Glance is...
  125.  
  126. │ GLANCE.EXE │ GL0192.EXE │ GL0192.OVL │ GLANCE.DOC │ GLANCE.DAT │
  127.  
  128. One way of deleting all program specifications at once is deleting
  129. the file GLANCE.DAT. This is the file in which Glance stores its
  130. data. However, it is better to clear the menu's from within Glance
  131. by using the Reset function [F7].
  132.  
  133. -------------------------------------------------------------------
  134.  
  135.                           MENU SCREENS
  136.  
  137. After the introduction screen you will see the upper half of Menu
  138. One appear on your display. You can start up any program from this
  139. part of the menu structure by pressing the corresponding letter on
  140. your keyboard. With the mouse: click on the screen button that
  141. displays the name of the program you want to run.
  142.  
  143. To run a program from the lower half of a menu, hold down a shift
  144. key or the right mouse button, then press the letter [a..u] or
  145. click on the screen button with your mouse.
  146.  
  147. If you are in Menu One -for example immediately after start up- the
  148. lower left corner of the screen shows a button saying "Menu Two".
  149. This does NOT mean that Menu Two is currently displayed, but that
  150. you have to click on that button to switch to Menu Two.
  151. It is advisable to be very much aware of that, especially when you
  152. are resetting the menu's with the Reset function.
  153. You can press the "Menu One" or "Menu Two" button with the mouse,
  154. or by pressing TAB or SPACE.
  155.  
  156. Before Glance runs a program it always switches the current DOS
  157. directory to the directory that contains the program, according to
  158. your specification. This way the program has a better chance of
  159. finding its data and/or setup files.
  160.  
  161. -------------------------------------------------------------------
  162.                          MAIN FUNCTIONS
  163.  
  164. The menu screens contain four function buttons. You can press these
  165. buttons with the mouse, or by pressing ALT and the underlined
  166. letter in the function name. The state of any of the shift keys is
  167. not important. The available functions are...
  168.  
  169. Alt-E │ EDIT │ Add or edit a program specification. This function
  170.                will be explained into detail in the next section.
  171. Alt-H │ HELP │ This function can also be called with F1. It shows
  172.                a screen with the most important information for a
  173.                starting Glance user. TAB toggles between main help
  174.                ad help on the Task screen.
  175. Alt-T │ TASK │ Switches to the Task screen. Press Escape or Return
  176.                to return to the Menu screen.
  177. Alt-X │ EXIT │ After Glance made sure your data is saved it returns
  178.                to DOS.
  179.  
  180. -------------------------------------------------------------------
  181.  
  182.                         THE EDIT FUNCTION
  183.  
  184. After you pressed the EDIT button you are supposed to select the
  185. button you would like to edit. You can select any button from any
  186. menu, just like you do when you want to run a program.
  187. After you selected a button, Glance asks for three things...
  188.  
  189. MENU NAME │ The name you enter here will be displayed in the menu.
  190.             It doesn't have to make sense to anyone but you (you
  191.             have to know what program the name refers to).
  192.             For example, type "Word Perfect 5.1" for WP.
  193.             Maximum string length: 20 characters.
  194. MENU NAME │ Enter the exact location and name of the file you want
  195.             Glance to run, In the usual format:
  196.             [drive:] [\path\] filename [.extension].
  197.             Example: "C:\WORD\PERFECT\WP.EXE". You don't HAVE to
  198.             enter anything in between square brackets, but it is
  199.             highly recommendable to do so. For example, if you only
  200.             enter "WP", Word Perfect will only run if
  201.             c:\word\perfect is the current DOS directory.
  202. PARAMETER │ Enter the parameters you want Glance to pass to the
  203.             program (for example the name of a document).
  204.  
  205. When you are editing text, the following functions are available:
  206. (only functions with a button on the screen can also be called with
  207. the mouse. By the way: the cursor is white and does not blink)
  208.  
  209. - ARROW UP    : line up
  210. - ARROW DOWN  : line down
  211. - ARROW LEFT  : character left
  212. - ARROW RIGHT : character right
  213. - CTRL-Y      : delete line
  214. - HOME        : go to the first character of the line
  215. - END         : go to the last character of the line
  216. - RETURN      : confirm line, go to next line
  217. - INSERT      : confirm line, stop editing, update menu
  218. - ESCAPE      : stop editing, do not update the menu
  219.  
  220. With Alt-C, the Check function, you can check if the file name you
  221. entered is correct. That is: if Glance can find the file. This
  222. function is very strict: when you run a program and the file name
  223. is not fully specified (for example, you did not enter the
  224. extension because you forgot whether it was EXE or COM), Glance
  225. will try to add all the missing information. Most of the time
  226. Glance will be able to trace down what file you mean and run it.
  227. The Check function however, does not accept incomplete file
  228. specifications. So when you do not enter the extension of a file,
  229. the Check function will say 'File not found'.
  230.  
  231. -------------------------------------------------------------------
  232.  
  233.                              TASKS
  234.  
  235. Pressing Alt-T opens the Task screen. As said before, all tasks can
  236. be called from the menu screen as well, by pressing their function
  237. key. The following tasks are available...
  238.  
  239. F1  │  Help                │  Guess... Press TAB to toggle between
  240.                               the two available screens.
  241. F2  │  Save Entries        │  Writes the Glance data to disk. First
  242.                               it renames the old data file to *.BAK
  243. F3  │  Load Entries        │  (Re)loads the Glance data. Glance
  244.                               loads the data automatically at start
  245.                               up, but you may want to use this
  246.                               function to undo editing you regret.
  247. F4  │  Go to OS Shell      │  Creates a DOS Shell by running
  248.                               COMMAND.COM. Type Exit [Enter] to
  249.                               return to Glance.
  250. F5  │  View OS Screen      │  Shows the DOS screen. Press any key
  251.                               or mouse button to return to Glance.
  252. F6  │  Blank Screen        │  Surpresses the display to prevent it
  253.                               from burning in. Press something to
  254.                               return to Glance.
  255. F7  │  Reset Part of Menu  │  Removes all program specifications
  256.                               from one half of a menu.
  257. F8  │  Read Documentation  │  Switches to a textmode to enable you
  258.                               to quickly check out this
  259.                               documentation file. Mouse available.
  260. F9  │  About Glance        │  Read the "Okay" section for a juicy
  261.                               detail about this screen. Press a key
  262.                               or button to return.
  263. F10 │  Park Hardddisks     │  Parks all connected harddisks. Do not
  264.                               forget to save you data before you
  265.                               turn off your computer.
  266.  
  267. -------------------------------------------------------------------
  268.  
  269.                             SETTINGS
  270.  
  271. On the Task screen you can set any of the three available switches.
  272. What ever is on the button goes if the corresponding picture
  273. appears "deep". All changes to these setting will be saved to the
  274. EXE file automatically when you quit Glance. Toggle the settings
  275. with the keyboard by pressing Alt-M, Alt-A or Alt-P.
  276.  
  277. The Prevent Mistakes switch enables you to have your actions
  278. verified by Glance. The mainly comes down to having to answer the
  279. question "Are you sure ?" when you run a program or quit Glance.
  280. The names of the other switches are self-explaining.
  281.  
  282. -------------------------------------------------------------------
  283.  
  284.                               OKAY
  285.  
  286. While I was programming Glance, I meant to reserve this option for
  287. registered users only. At second thought I realized it can be a
  288. major contribution to ease with which you work with Glance.
  289. So I decided to give it away to those users who managed to dig into
  290. this documentation file this deep. Here it is...
  291.  
  292. By pressing Ctrl-Enter when you are in the About Screen [F9] you
  293. can choose to skip the introduction screen at start up.
  294. The drawings needed to build that screen will also not be loaded,
  295. so this will again speed up the process.
  296.  
  297. -------------------------------------------------------------------
  298.  
  299.                              HISTORY
  300.  
  301. Glance is the follow up of Glimpse, a Shareware program starter
  302. I wrote for textscreens, that also works with the Shift-concept.
  303. The programs are called Glimpse and Glance because after you have
  304. worked with them for a while, you will be able to locate the keys
  305. of the most-used programs so fast that the menu screens will
  306. hardly become visible.
  307.  
  308. The functionality of Glimpse is almost identical to that of Glance.
  309. The implementation of course, differs quite a bit. Glimpse only
  310. uses text screens. Therefore, it will work with all videocards and
  311. is very much faster than its handsome brother.
  312.  
  313. If you still think Glance is too slow, or you just want to get to
  314. know the razor-sharp predecessor of Glance, then get Glimpse. Copy
  315. it from a friend, or order it. I will send you a copy of the latest
  316. version of Glimpse.
  317.  
  318. -------------------------------------------------------------------
  319.  
  320.                            REGISTERING
  321.  
  322. If you use Glance and enjoy working with it, you should register
  323. your copy. It encourages me to carry on. Of course, there is also
  324. something in it for you.
  325. As a registered user you are the first one to know about updates,
  326. which you can order for a small amount of money. I will also help
  327. you when you are facing problems with Glance (or anything else for
  328. that matter).
  329.  
  330.                            TO REGISTER
  331.  
  332.                           send a cheque,
  333.               $20,- or foreign equivalent suggested,
  334.               do not forget to mention "GLANCE", to
  335.  
  336.                          J.SCHIPPERHEIJN
  337.                       ALARD DU HAMELSTRAAT 53
  338.                         5622 CC EINDHOVEN
  339.                          THE NETHERLANDS
  340.  
  341.  
  342. Please check the address with the About Glance screen before you
  343. send anything. THANK YOU VERY MUCH!
  344.  
  345. -------------------------------------------------------------------
  346.  
  347.                             QUESTIONS
  348.  
  349. If you have any questions, suggestions, remarks or problems: just
  350. send them to me. You will always get a reply. If you managed to
  351. find a bug in Glance, you will get a corrected version right away,
  352. whether you are a registered user or not.
  353.  
  354. -------------------------------------------------------------------
  355.  
  356.                            CONDITIONS
  357.  
  358. Glance is a Shareware program. You can freely copy it and pass it
  359. on to friends if you want to, ONLY if you make sure Glance is
  360. complete and unchanged.
  361.  
  362. Glance may not be distributed or sold by anyone for any amount of
  363. money higher than the duplication/dispatch costs.
  364.  
  365. The author is not responsible for any damage claimed to be caused
  366. by Glance.
  367.  
  368. -------------------------------------------------------------------
  369.  
  370.                            End of file
  371.  
  372. -------------------------------------------------------------------
  373.  
  374.