home *** CD-ROM | disk | FTP | other *** search
/ No Fragments Archive 10: Diskmags / nf_archive_10.iso / MAGS / ST_USER / 1992 / USERJL92.MSA / LGS_LGSELECT.TXT < prev    next >
Text File  |  1990-11-18  |  49KB  |  1,097 lines

  1.  
  2.                     The Little Green Selector
  3.                     -------------------------
  4.  
  5.                  Shareware by Charles F. Johnson
  6.         Copyright 1989, 1990 Little Green Footballs Software
  7.                        All Rights Reserved.
  8.  
  9.                           Version 1.8C
  10.                  Release Date: November 19, 1990
  11.  
  12.  
  13.      The Little Green Selector is a complete replacement for the
  14. dreaded GEM item selector.  Once it's installed, all programs that
  15. call the GEM item selector will end up using the vastly improved
  16. Little Green Selector instead.  You can install it at bootup time
  17. by placing it in an AUTO folder, or run it from the desktop at any
  18. time after bootup.  The Little Green Selector (henceforth referred
  19. to as LGSELECT) optimizes the process of selecting files, with
  20. unique features that make this easier than ever before.  And
  21. starting with version 1.3, the Little Green Selector has a special
  22. "communications pipeline" with CodeHead Software's MaxiFile desk
  23. accessory that allows you to copy, move, delete, and rename files
  24. and folders, format disks, create new folders, show or print
  25. files, and much more (in a window showing up to 80 files at
  26. once)...any time you use the file selector!
  27.  
  28. *****************************************************************
  29. *                                                               *
  30. *       If you've already received an earlier version of the    *
  31. *  Little Green Selector, and are familiar with its basic       *
  32. *  operation, you may want to skip ahead to the section titled  *
  33. *  "New Stuff" at the end of this document.  This is where the  *
  34. *  new features (and/or bug fixes) of each revision are         *
  35. *  explained.                                                   *
  36. *                                                               *
  37. *****************************************************************
  38.  
  39.  
  40.               Shareware - a concept before its time?
  41.               --------------------------------------
  42.  
  43.      The Little Green Selector is being distributed as "shareware." This
  44. means that you're free to give copies of it to friends, to upload it to
  45. bulletin board services, etc., as long as both LGSELECT.PRG and this
  46. document (LGSELECT.TXT) are included and neither file is altered in ANY
  47. WAY.  In addition, this program and the accompanying text file may not
  48. be included with any commercial package, or sold in any form without
  49. written permission from Charles F.  Johnson.
  50.  
  51.      If you use and enjoy this program, you are expected to pay for it
  52. just as you would be expected to pay for a commercial program.  The only
  53. difference between a shareware product and a "commercial" product is the
  54. means of distribution; the shareware method gives you, the user, all the
  55. benefits since you get to "try before you buy." The shareware
  56. registration fee for the Little Green Selector is only $15.00, so it's
  57. pretty painless to become a registered user of the Little Green
  58. Selector. 
  59.  
  60.      If you do find LGSELECT useful, please send a check or money
  61. order for $15.00 to:
  62.  
  63.      Charles F. Johnson (LG Selector)
  64.      P.O. Box 1250
  65.      Pacific Palisades, CA 90272
  66.  
  67.      If you'd like to me to acknowledge that I've received your
  68. shareware payment, please include a self-addressed stamped envelope.  If
  69. you also include a disk with your SASE (with enough postage), I'll fill
  70. it with the latest versions of all my Little Green Footballs shareware
  71. programs and send it back to you.
  72.  
  73.      I've released two previous programs as shareware (ARC Shell
  74. and Desk Manager), and I'll be honest with you - the response has
  75. been less than overwhelming.  And I've been pretty lucky; I've
  76. spoken to other shareware authors about this, and most of their
  77. experiences have been even more dismal than mine.  Programs don't
  78. come into existence spontaneously - the people who design them
  79. spend many many hours thinking about, planning, testing, and
  80. revising their work (not to mention the years spent refining
  81. techniques and learning to use the tools).  It takes a leap of
  82. faith for programmers to release the fruits of their labor into
  83. free distribution, relying on the "honor system" to see some
  84. reward for their creations.  I know it takes a little extra effort
  85. to write out a check and drop it in the mail, but the fact is that
  86. only you, the user, can make the 'shareware' idea work.  If you'd
  87. like to see more programs distributed as shareware, you have to do
  88. your best to support the programs you use.
  89.  
  90.      (By the way, I want to say a sincere "thank you" to everyone
  91. who has contributed for ARC Shell, Desk Manager, the Little Green
  92. Selector, and/or PinHead, lest you think I've forgotten.  I
  93. haven't, and your contributions are very much appreciated.)
  94.  
  95.      Anyway...end of sermon.  On with the show.
  96.  
  97.  
  98.                        Installing LGSELECT.
  99.                        --------------------
  100.  
  101.      LGSELECT is very simple to install.  You can either run it
  102. from the desktop by double-clicking on its icon or filename, or
  103. place it in an AUTO folder so that it installs automatically at
  104. bootup time.
  105.  
  106.      To install LGSELECT automatically, just copy it into a folder
  107. named AUTO on your boot disk.  If you don't already have an AUTO
  108. folder, you can create one from the GEM desktop by using the 'New
  109. Folder' option in the 'File' drop-down menu.  If you do already
  110. use an AUTO folder with several programs in it, LGSELECT can
  111. simply be copied into the existing folder.  After placing
  112. LGSELECT.PRG in your AUTO folder, reboot your computer. During the
  113. bootup process, you'll see a message from LGSELECT, and it will be
  114. automatically installed.
  115.  
  116.      (NOTE: LGSELECT can run at any point during the AUTO
  117. programs; however, there may be some improperly written AUTO
  118. programs that need to run before or after LGSELECT.  If you have a
  119. conflict, you should begin by removing everything from your AUTO
  120. folder except LGSELECT, then start adding the other programs one
  121. at a time until you find the source of the trouble.  Often, you
  122. can fix incompatibilities simply by changing the order that you
  123. copy programs into the AUTO folder.  Remember that AUTO programs
  124. run in the order in which they appear in a disk's directory [not
  125. alphabetically, nor by time/date stamp] -- if you're not sure about
  126. the order, you can use LGSELECT's 'No Sort' feature [see below] to
  127. show the true arrangement.)
  128.  
  129.      If you run LGSELECT from the desktop, a GEM alert box will
  130. appear.  You can click on the button labeled 'Install' to make
  131. LGSELECT resident, or on 'Cancel' if you change your mind.
  132.  
  133.  
  134.                          Using LGSELECT.
  135.                          ---------------
  136.  
  137.      In addition to the extra features it provides, LGSELECT
  138. incorporates all of the functions of the standard GEM item
  139. selector and has a similar interface; so if you know how to use
  140. the GEM selector you should have no trouble getting accustomed to
  141. LGSELECT.  For this reason, I'm going to assume in the following
  142. discussion that you already know how to perform basic operations
  143. with the GEM selector.  (If you're unsure about how to operate the
  144. GEM item selector, please refer to your ST owner's manual.)
  145.  
  146.      LGSELECT uses both mouse buttons.  In many cases, an option
  147. will behave differently depending on which mouse button you use
  148. when you select it; so it's a good idea to read this documentation
  149. through before using LGSELECT so you won't be surprised.
  150.  
  151.      To get your first look at LGSELECT, run some program that
  152. uses the item selector.  When LGSELECT appears, the first thing
  153. you'll notice is that it's larger than the GEM item selector.
  154. The GEM selector only shows you 9 files at once; LGSELECT displays
  155. 16, so you can see more of a directory at a glance.  You'll also
  156. notice that there are quite a few more controls and buttons in the
  157. LGSELECT dialog box; I'll explain the use of those controls now.
  158.  
  159.  
  160.                         The Drive Buttons.
  161.                         ------------------
  162.  
  163.      On the right side of the box underneath the 'OK' and 'CANCEL'
  164. buttons are 16 drive buttons labeled A through P.  To change to a
  165. new drive with LGSELECT, all you have to do is click on one of the
  166. drive buttons; no more editing the directory line!  Only active
  167. drives are selectable - drives that don't exist on your system are
  168. shown as "disabled".  When you change to a different drive by
  169. clicking one of these buttons, LGSELECT will determine the current
  170. directory for that drive and display its contents.
  171.  
  172.      The drive buttons are also used to display the amount of free
  173. space (in bytes) remaining on a disk.  There are two ways to show
  174. a disk's free space - you can either double-click the drive button
  175. (with the left mouse button), or single-click it with the right
  176. mouse button.  After a short delay to read the information from
  177. the disk, an alert box will appear showing the number of bytes
  178. left.
  179.  
  180.      Another important feature of the drive buttons - you can
  181. force a "media changed" status on any drive by holding down
  182. Alternate, Control, or either Shift key while you click on the
  183. drive's button.  This is very useful for people with removable
  184. media (like the Syquest drives or the Konica 10M floppy) that
  185. sometimes don't properly respond when you change the disk (or
  186. cartridge).  It's also handy for those who have floppy drives that
  187. don't always recognize when you change a disk.
  188.  
  189.      This "force media change" feature also has another important
  190. beneficial side effect; it "flushes" the folder count for the
  191. selected drive.  This can be helpful in avoiding the so-called "40
  192. folder bug" which lives in TOS 1.0 and 1.2.
  193.  
  194.  
  195.                         The Sort Buttons.
  196.                         -----------------
  197.  
  198.      Under the drive buttons are the buttons that represent the
  199. different sorting options that LGSELECT offers.  You can choose to
  200. sort the displayed files by Name, Extension, Size or Date, or you
  201. can display them unsorted if you wish.  To select a new sorting
  202. method, just click on its button and the files in the current
  203. directory will be resorted and redisplayed in the new order.
  204.  
  205.  
  206.                          The Info Button.
  207.                          ----------------
  208.  
  209.      Click on the button labeled 'Info' to show the version number
  210. of LGSELECT.
  211.  
  212.  
  213.                        *.* (Show All Files)
  214.                        --------------------
  215.  
  216.      Click on the button labeled '*.*' to show all files in the
  217. current directory.  When you select this button, the current
  218. directory search specification will be copied into the button, and
  219. the search spec will be changed to '*.*'.  You can return to the
  220. original search spec simply by clicking the button again.
  221.  
  222.  
  223.                         The Paths Button.
  224.                         -----------------
  225.  
  226.      The button labeled 'Paths' gives you access to one of
  227. LGSELECT's nicest features.  Click on 'Paths' and a dialog box
  228. appears, showing 18 blank lines and a list of 20 default
  229. extensions, as well as several buttons for additional options.  In
  230. the Paths box, you can set up as many as 18 default paths;
  231. clicking on any path will instantly set it as the current
  232. directory, and return you to the main LGSELECT box.  (This can
  233. make navigating on a hard disk very simple!)
  234.  
  235.      To install paths into the list, simply hold down Alternate,
  236. Control or either Shift key while you click on the 'Paths' button
  237. in the main LGSELECT box.  The current directory will be copied
  238. into the first empty slot in the path list.  The 'Paths' dialog
  239. box itself will not appear when you're installing paths, so that
  240. you can quickly set up a group of different paths.
  241.  
  242.      If you use up all 18 slots and try to install another path,
  243. an alert box will appear; at this point you can either 'Cancel'
  244. installing the path or 'Replace' the last (18th) entry in the list
  245. with the current directory.
  246.  
  247.      If you click on 'Paths' without holding down Alt, Ctrl, or
  248. Shift, the 'Paths' dialog box appears.  You can instantly set the
  249. current directory to any path in the list by clicking on it with
  250. the left mouse button.  This will return you to the main LGSELECT
  251. box, and the files in the new path will be displayed.
  252.  
  253.      You can delete any single path from the list by clicking on
  254. it with the right mouse button.  An alert box will appear, asking
  255. you to confirm the delete.
  256.  
  257.      At the bottom left of the 'Paths' box is a list of 20
  258. extensions (or file "types") which can be edited with the
  259. keyboard.  Use the up and down arrows to move the cursor through
  260. the list, and Esc to clear an extension.  When you click on one of
  261. the extensions with the left mouse button, the directory line in
  262. the main LGSELECT box is changed to the new extension.  This lets
  263. you easily display only certain types of files.
  264.  
  265.      When LGSELECT is first installed, the extensions are preset
  266. to a group of common file types.  You can change this default set
  267. of extensions by editing them, and then using the 'Save' command
  268. (see below).
  269.  
  270.      At the bottom right of the 'Paths' box is a group of buttons
  271. with some further options:
  272.  
  273.      'Show Hidden Files' -- when this button is selected
  274.      (highlighted), LGSELECT will show files which are marked as
  275.      "hidden" or "system" files.  When hidden files appear in the
  276.      file box they will be shown as disabled text, but they are
  277.      still selectable.
  278.  
  279.      'Save' -- click on this button to save the current list of
  280.      paths and extensions directly into the LGSELECT program file
  281.      itself, so that the next time you boot up, your paths and
  282.      extensions will already be set.  In order for this feature to
  283.      work, LGSELECT.PRG must be in the same drive and directory as
  284.      when you originally ran it, and you must not rename the
  285.      program!
  286.  
  287.      'Clear' -- this option clears the entire list of paths so you
  288.      can start again with a blank slate if you wish.  An alert box
  289.      will appear, asking you to confirm the 'Clear' operation.
  290.  
  291.      'FILENAME.EXT' -- this button will always show the search
  292.      specification that was passed to LGSELECT by the calling
  293.      program, regardless of whether you modify it in the main
  294.      LGSELECT box or not.  This lets you quickly return to the
  295.      original search spec.
  296.  
  297.      'Exit' -- returns to the main LGSELECT box.
  298.  
  299.  
  300.                       File Display Options.
  301.                       ---------------------
  302.  
  303.      OK, back to the main LGSELECT box.  At the bottom of the file
  304. box is a box displaying the total number of files in the current
  305. directory that match the search specification, bordered by two
  306. buttons containing left and right arrows.  If you click with the
  307. left mouse button on either arrow, you can flip the file display
  308. to show the last modification time and date of the files, or their
  309. size.  If you click with the right mouse button on either arrow,
  310. you will return instantly to the name display.  You don't have to
  311. be showing names to select files; all functions are still active
  312. no matter which display option is selected.
  313.  
  314.      The 'Date' display includes the day of the week that the file
  315. was last modified, and the 'Time' display is shown in am/pm
  316. format.
  317.  
  318.  
  319.                           The Close Box.
  320.                           --------------
  321.  
  322.      In the GEM item selector, the function of the close box
  323. (located at the upper left of the file box) is to back out one
  324. level at a time from the current subdirectory.  If you single-
  325. click the LGSELECT close box with the left mouse button, it
  326. behaves the same way.  However, if you double-click the close box,
  327. or click on it with the right mouse button, you will instantly
  328. back out all the way to the root directory of the current drive.
  329. This is very handy for people with hard drives containing lots of
  330. nested subdirectories.
  331.  
  332.  
  333.                       The 'Directory' Line.
  334.                       ---------------------
  335.  
  336.      It should be a rare occasion that you'll need to edit the
  337. LGSELECT 'Directory' line manually, since you can select a different
  338. drive simply by clicking its button.  However, if you do wish to
  339. edit the 'Directory' line, you can do so by moving the text cursor
  340. to the line (by clicking on the 'Directory' line once with the
  341. left mouse button, or by typing the down arrow), making your
  342. changes, and pressing Return.  If the 'Directory' line has been
  343. changed when Return is pressed, the new directory will be set.
  344. (The GEM selector simply exits any time you hit Return.  Ouch.)
  345.  
  346.      Another feature of the LGSELECT 'Directory' line is that you
  347. can back out to any level in the current path simply by clicking
  348. the right mouse button on the subdirectory you wish to return to.
  349. For example, if your current 'Directory' line reads:
  350.  
  351. C:\UTILITY\ARC\ARCFILES\TEMP\*.*
  352.  
  353. you can back out to:
  354.  
  355. C:\UTILITY\*.*
  356.  
  357. simply by right-clicking on the word UTILITY.
  358.  
  359.      (You can also double-click the left mouse button on the
  360. 'Directory' line to back out to a certain level.)
  361.  
  362.  
  363.                      The Up and Down Buttons.
  364.                      ------------------------
  365.  
  366.      If you click with the right mouse button on the up or down
  367. arrows, you will jump instantly to the beginning or the end of the
  368. current directory listing.  Clicking with the left button scrolls
  369. up and down through the list of files, just as with the GEM
  370. selector...but *much* faster.
  371.  
  372.  
  373.                         Selecting a File.
  374.                         -----------------
  375.  
  376.      In the standard GEM selector, there are two ways to select a
  377. file from the list and exit the selector.  You can click on it
  378. once with the left mouse button, and click the 'OK' button; or you
  379. can double-click it with the left mouse button.  LGSELECT also
  380. lets you select a file and immediately exit by single-clicking it
  381. with the right mouse button.
  382.  
  383.  
  384.                    Passing a Title to LGSELECT.
  385.                    ----------------------------
  386.  
  387.      This information is primarily of interest to programmers; if
  388. you don't care about passing a programmer-defined title to
  389. LGSELECT, you can skip to the next section.
  390.  
  391.      Programmers can pass LGSELECT two 12-character title strings,
  392. which will be displayed in the box in the upper right; this lets
  393. you tell the user the purpose of the file selector.  The code to
  394. do this can be written in a way that is "transparent" to the
  395. system.  In other words, if LGSELECT is present, your title
  396. appears; if not, the normal GEM selector works as usual.
  397.  
  398.      To pass the title strings in assembly language, the following
  399. code will do the job:
  400.  
  401.      move      #90,contrl          ; Set up contrl array
  402.      move      #0,contrl+2
  403.      move      #2,contrl+4
  404.      move      #4,contrl+6         ; This parameter differs from
  405.                                    ; standard fsel_input call
  406.      move      #0,contrl+8
  407.      move.l    #directory,addrin   ; Address of directory line
  408.      move.l    #filename,addrin+4  ; Address of filename line
  409.      move.l    #title1,addrin+8    ; First 12-character title string
  410.      move.l    #title2,addrin+12   ; Second title string
  411.      bsr       aes                 ; Call the AES
  412.  
  413.      I'd recommend that if C programmers are interested in using
  414. the title string functions of LGSELECT, it would be a good idea to
  415. code the call to fsel_input with in-line assembly.  Otherwise,
  416. you'll have to alter your compiler's bindings for fsel_input.
  417.  
  418.      Just for your information, all CodeHead Software products are
  419. written to take advantage of LGSELECT's title line feature, as is
  420. my earlier shareware release, ARC Shell.
  421.  
  422.  
  423.                           Miscellaneous.
  424.                           --------------
  425.  
  426.      The Little Green Selector will read a maximum of 300
  427. filenames from a directory.  (Since the GEM desktop itself can
  428. only show 256 files in a single directory, this seemed like a
  429. reasonable limit.)  If your current directory is too long to fit
  430. in the LGSELECT 'Directory' line, no harm will result; the GEM
  431. selector just crashes.
  432.  
  433.      If you're using TOS 1.0, be careful not to type an underline
  434. character in the 'Directory' line -- a bug in TOS 1.0's 'form_do'
  435. routine will cause the system to crash if you do.  (Unfortunately,
  436. there's nothing LGSELECT can do to fix this bug.)
  437.  
  438.      Normally GEM steals all keypresses during the drawing of a
  439. dialog box, but LGSELECT uses some special tricks to allow you to
  440. "type ahead" while the dialog box is being drawn, or while a
  441. directory is being read.
  442.  
  443.  
  444.                           ---------
  445.                           New Stuff
  446.                           ---------
  447.  
  448.  
  449. ************************ VERSION 1.2 *****************************
  450.  
  451.      The big new feature in version 1.2 is keyboard control of
  452. almost all options of LGSELECT.  Here's how the keyboard is used
  453. with LGSELECT 1.2:
  454.  
  455.  
  456.      In the main LGSELECT box
  457.      ------------------------
  458.  
  459.      Alternate A through P      Select current drive.
  460.  
  461.      Control up/down arrows     Scroll up or down through the
  462.                                 list of files.
  463.  
  464.      Control left/right arrows  Display size, time, and date.
  465.  
  466.      Shift up/down arrows       Page up or down through the list
  467.                                 of files.
  468.  
  469.      Clr Home                   Jump to the top of the file list.
  470.  
  471.      Shift Clr Home             Jump to the bottom of the file
  472.                                 list.
  473.  
  474.      Insert                     Select the *.* button.
  475.  
  476.      Help                       Enter the "Paths" dialog box.
  477.  
  478.      Control Backspace          Back out one level in the current
  479.                                 directory.
  480.  
  481.      Alternate Backspace        Back out to the root directory of
  482.                                 the current drive.
  483.  
  484.      F1 through F5              Select sort option.
  485.  
  486.      Return                     Exit LGSELECT, and accept choice
  487.                                 (if any).  Equivalent to clicking
  488.                                 on the 'OK' button.
  489.  
  490.      Alternate Return           Equivalent to clicking on the
  491.      (or Undo)                  'Cancel' button.
  492.  
  493.      Alternate ?                Display version number, author,
  494.                                 and shareware message.
  495.  
  496.      Shift 0 through +          (On numeric keypad) Select the
  497.                                 first through sixteenth entry in
  498.                                 the list of files.  If the entry
  499.                                 is a folder, open it.
  500.  
  501.      F10                        Call MultiFile (version 1.2 or
  502.                                 higher).
  503.  
  504.      In the 'Paths' box
  505.      ------------------
  506.  
  507.      F1 through Shift F8        Select new path for LGSELECT.
  508.                                 (The paths are now labeled with
  509.                                 their respective function keys.)
  510.  
  511.  
  512.  
  513. ************************ VERSION 1.3 *****************************
  514.  
  515.                Communication with MultiFile.
  516.                -----------------------------
  517.  
  518.      LGSELECT 1.3 has several new features, among them the ability
  519. to "call" CodeHead Software's MultiFile accessory (included on the
  520. CodeHead Utilities disk), so you can perform file operations
  521. (copy, move, delete, rename, etc.), format disks, show or print
  522. files, and all that kinda good stuff any time you're using the
  523. file selector.  This feature requires you to have version 1.2 (or
  524. later) of MultiFile installed as a desk accessory; otherwise the
  525. "MultiFile" button will be disabled.  (MultiFile can be installed
  526. either as an ordinary desk accessory, or loaded into CodeHead
  527. Software's MultiDesk; it will work either way.)
  528.  
  529.      To call MultiFile, just click on the button labeled
  530. "MultiFile" in the lower right of the LGSELECT main box, or type
  531. the F10 function key.  The full-screen MultiFile dialog box will
  532. appear, showing all the files in the current LGSELECT directory. 
  533. If there is a file selected in LGSELECT when you call MultiFile,
  534. it will be selected in the MultiFile box as well.  Up to 80 files
  535. can be displayed at once in the MultiFile dialog, and you can mark
  536. them individually or in groups for file operations.  (See your
  537. CodeHead Utilities manual for full details on the operation of
  538. MultiFile.)
  539.  
  540.  
  541.                 Selected File Size Display.
  542.                 ---------------------------
  543.  
  544.      When you select a file in LGSELECT 1.3, its size is displayed
  545. at the bottom of the file box, where the number of files is
  546. normally shown.  Any action which causes that filename to be
  547. de-selected (e.g. scrolling up/down, clicking on a blank line,
  548. etc.) will also cause the display to revert to the number of files
  549. in the current directory.
  550.  
  551.  
  552.              Two New Features in the Paths Box.
  553.              ----------------------------------
  554.  
  555. GET PATHS
  556. ---------
  557.  
  558.      The button labeled "GET PATHS" controls what happens when you
  559. click on one of LGSELECT's drive buttons to change to a new drive. 
  560. When this button is NOT selected, LGSELECT will always set the
  561. path to the root directory of the new drive when you click on a
  562. drive button.  If the "GET PATHS" button is selected, LGSELECT
  563. will determine the current path of the new drive (GEMDOS maintains
  564. a record of the last accessed paths on each connected drive), and
  565. set the directory line to display the files in that path instead
  566. of the root directory.  Try it both ways, and see which one you
  567. prefer.  (NOTE: If you're using a floppy system it usually won't
  568. make a difference which way this button is set.)
  569.  
  570. FLUSH
  571. -----
  572.  
  573.      The button labeled "FLUSH" lets you clear the "folder count"
  574. for all connected drives, or just for a hard disk if you prefer. 
  575. This feature is included to help alleviate a problem in TOS 1.0
  576. and 1.2, which can cause crashes if you access too many folders
  577. (subdirectories) in a single continuous session at the computer. 
  578.  
  579.      When you click on "FLUSH" an alert box will apear, asking if
  580. you want to flush the folder count for "All" drives (which
  581. includes drives A and B), or just active drives with the letters C
  582. through P.  Click on your choice, or "Cancel" to forget the whole
  583. thing. 
  584.  
  585.      I recommend that you don't use the FLUSH button until you've
  586. been operating your computer for a while after booting up.  If you
  587. FLUSH too soon after booting, your number of folders used may
  588. actually increase instead of decreasing.  This happens because
  589. LGSELECT's FLUSH operation goes through and accesses all connected
  590. drives to flush the folder count for each one.  If, in the course
  591. of your computer session, you haven't yet accessed a particular
  592. drive, FLUSHing that drive may result in an increased folder
  593. count.  It all depends on how many folders you've opened or
  594. accessed in one session. 
  595.  
  596.      If you have a hard disk, I strongly recommend that you use
  597. Atari's FOLDRXXX.PRG to increase the number of folders your system
  598. can access in one session.  FOLDRXXX.PRG is available on the major
  599. information services like GEnie, Compuserve, and Delphi, and
  600. probably also through most user groups and private bulletin
  601. boards. 
  602.  
  603.      (NOTE: There is also a public domain program from Atari
  604. called DIRSLEFT.PRG that will show you the number of "folder
  605. slots" left in your system.)
  606.  
  607.  
  608.                   More Information Saved.
  609.                   -----------------------
  610.  
  611.      When you choose the "Save" option in the LGSELECT "Paths"
  612. box, the status of the "SHOW HIDDEN" and "GET PATHS" buttons is
  613. now saved along with the paths and extensions.  The current sort
  614. option is also saved, so that LGSELECT will always come up with
  615. your preferred settings.  (See above in the section titled "The
  616. Paths Button" for more details.)
  617.  
  618.  
  619. ************************ VERSION 1.4 *****************************
  620.  
  621.                  Fast File Search Feature!
  622.                  -------------------------
  623.  
  624.      Version 1.4 of the Little Green Selector adds a file search
  625. feature that can very quickly search all the partitions of a hard
  626. drive for a file or files, with optional wildcard matching.
  627.  
  628.      To use the file search feature, just type in the name of the
  629. file for which you wish to search on the "Selection" line.  If you
  630. wish, you may use the wildcards '*' and '?' to find all files that
  631. match a certain specification.  The '*' character means "match all
  632. characters up to the extension, or the end of the string." The '?'
  633. character means "match any one character in this position."
  634.  
  635.      To start searching, click on the small button labelled "FIND"
  636. in the lower right corner of the "Selection" box.  If drive "C:"
  637. is active on your system an alert box will appear, asking you
  638. whether you'd like to search only the current directory, or every
  639. drive from C: to P:.  Click on "All" if you'd like to search
  640. through every partition on your hard disk, or "Current" to limit
  641. the search to LGSELECT's current directory.  If you don't have a
  642. drive "C:" connected to your system, the search will begin
  643. immediately when you click on the "FIND" button, and will be
  644. limited to the current directory.
  645.  
  646.      If a file is found which matches the search criteria, the
  647. directory in which it's located will be shown on the LGSELECT
  648. "Directory" line, and you will be given the choice to either "Set"
  649. the LGSELECT path to the one containing the matching file, keep
  650. searching for other matching files ("Next"), or "Cancel" the
  651. search operation and return to the directory from which you
  652. started.
  653.  
  654.      While a search is in progress, you can abort it at any time
  655. by holding down the Alternate key. 
  656.  
  657.      NOTE: The LGSELECT file search feature performs an automatic
  658. "flush" operation after searching each drive, when you choose to
  659. search "All" partitions; this should prevent the "40-folder bug"
  660. from ever occurring when searching a large hard drive with many
  661. folders.  (See the section titled "FLUSH" above for more details.)
  662.  
  663.      Another interesting note: for the sake of speed, the file
  664. search routine in LGSELECT uses its own wildcard matching
  665. algorithms instead of the built-in TOS wildcard features.  Along
  666. with the automatic "flush" feature, this makes LGSELECT's file
  667. search both faster and safer than most other file search programs. 
  668.  
  669.  
  670.                   Disk Information Expanded.
  671.                   --------------------------
  672.  
  673.      When you right-click (or double-click) on a drive button,
  674. version 1.4 of LGSELECT will now show more information than
  675. previous versions did.  You will see the total number of folders
  676. and files, the number of bytes used and the number of free bytes
  677. left on the disk. 
  678.  
  679.  
  680. ************************ VERSION 1.6 *****************************
  681.  
  682.                LGSELECT Can Now Be Repositioned!
  683.                ---------------------------------
  684.  
  685.      LGSELECT 1.6 allows you to specify where on the screen you'd
  686. like it to appear, simpy by dragging it to the new location. 
  687. (This is especially handy for those lucky users with "big screen"
  688. monitors.)  To move LGSELECT, just click on the shaded area above
  689. the filename window (the area that corresponds to the 'move bar'
  690. on an ordinary desktop window) and hold down the mouse button.  An
  691. outline of the LGSELECT box will appear, which you can drag to the
  692. new location.  When you've positioned the box where you want it,
  693. let go of the mouse button and the LGSELECT box will be redrawn at
  694. its new spot.
  695.  
  696.      You can center the LGSELECT dialog box on screen at any time
  697. by holding down the Alternate key while you click on the LGSELECT
  698. move bar.
  699.  
  700.      When you save your LGSELECT configuration (with the 'Save'
  701. button in the 'Paths' box) the new screen position will also be
  702. saved, so that LGSELECT will always come up in your chosen
  703. location when you boot your computer.  LGSELECT maintains
  704. separate screen locations for color and monochrome, which makes
  705. things easy for people with two monitors.
  706.  
  707.      NOTE: The old screen images of the LGSELECT box will not be
  708. "cleaned up" right away when it is repositioned.  However, "redraw
  709. messages" are sent to the current application and when you exit
  710. LGSELECT, properly written GEM programs should redraw their
  711. screens correctly.  The next time LGSELECT appears it will show up
  712. cleanly in the new location. 
  713.  
  714.  
  715.                     Preset Paths Revamped.
  716.                     ----------------------
  717.  
  718.      The handling of the 18 paths available in the 'Paths' box has
  719. been altered quite a bit.  There is no longer any need to be in
  720. the 'Paths' box to select one of the 18 preset paths; you can type
  721. the function key for any path (F1 through Shift-F8) whenever
  722. you're in the main LGSELECT box and instantly set the selector to
  723. display the files in that path.
  724.  
  725.      The method of installing paths in the list has also been
  726. improved.  The old way still works; if you hold Alternate,
  727. Control, or either Shift key while clicking the 'Paths' button,
  728. the current path will be inserted in the first blank spot in the
  729. path list.  In version 1.6, however, you may also install paths in
  730. the list by entering the 'Paths' box and clicking on the function
  731. key numbers at the left of the box.  The current LGSELECT path
  732. will be inserted at the spot you choose.  This means that you are
  733. no longer limited to installing paths in the first available blank
  734. slot; you can arrange them to suit your needs.
  735.  
  736.      Also, when you delete a path from the list (by clicking on
  737. the path with the right mouse button), the paths after it are no
  738. longer pulled up to fill the blank slot.
  739.  
  740.      In earlier versions of LGSELECT, the F10 key was used to call
  741. MultiFile or MaxiFile.  This will still work, if you leave the
  742. path line corresponding to function key F10 blank.  Otherwise, you
  743. can call MaxiFile (or MultiFile) with the Shift F10 key
  744. combination. 
  745.  
  746.  
  747.               LDW Power Incompatibility Fixed.
  748.               --------------------------------
  749.  
  750.      The LDW Power spreadsheet program uses a technique which was
  751. formerly incompatible with LGSELECT's right button "quick
  752. selection" feature.  LDW Power translates every press of the right
  753. mouse button into a press of the Return key, which caused earlier
  754. versions of LGSELECT to exit without selecting a file.  I found a
  755. way around this incompatibility in version 1.6, and the right
  756. mouse button will now work normally in LGSELECT when you use it
  757. with LDW Power.
  758.  
  759.  
  760.                  Sort the Extension List.
  761.                  ------------------------
  762.  
  763.      The list of extensions (in the 'Paths' box) may now be sorted
  764. alphabetically, to help you quickly spot a particular file type
  765. you wish to use.  To do this, click on the button labeled 'SORT
  766. EXTS' in the 'Paths' box.  (This button was formerly labeled 'GET
  767. PATHS' [see above].  The 'GET PATHS' function is removed in
  768. version 1.6, since most of the time it seemed to be more of a
  769. hindrance than a help.)
  770.  
  771.  
  772.                  Support for fsel_exinput.
  773.                  -------------------------
  774.  
  775.      TOS 1.4 (AKA "Rainbow TOS") has a new call which allows
  776. programmers to pass the file selector a title string, which
  777. displays at the top of the built-in GEM selector.  LGSELECT 1.6
  778. now supports this new call; the title string will be displayed in
  779. place of the word 'Directory' in the LGSELECT directory line.
  780.  
  781.  
  782.             Keyboard Commands for Sorting Changed. 
  783.             --------------------------------------
  784.  
  785.      Since the function keys are now used to select one of the 18
  786. preset paths, the keyboard commands for the 'Sort' options have
  787. been changed.  They are now:
  788.  
  789.      Alternate 1 - Sort by Name
  790.  
  791.      Alternate 2 - Sort by Extension
  792.  
  793.      Alternate 3 - Sort by Size
  794.  
  795.      Alternate 4 - Sort by Date
  796.  
  797.      Alternate 5 - No Sort
  798.  
  799.      There is also a new key command to call up LGSELECT's 'file
  800. search' function (equivalent to clicking on the 'FIND' button) -
  801. hold down Alternate and type the period (".") key.
  802.  
  803.  
  804. ************************ VERSION 1.6b ****************************
  805.  
  806.                     Position Save Fixed.
  807.                     --------------------
  808.  
  809.      Version 1.6 of LGSELECT had a bug in the config save feature
  810. that would cause you to lose your saved position (see above,
  811. "LGSELECT Can Be Repositioned") if you had dragged the selector
  812. box all the way out to the edges of the screen.  This is fixed in
  813. version 1.6b. 
  814.  
  815.  
  816.       LDW Power Incompatibility Really Fixed.  (Honest.)
  817.       --------------------------------------------------
  818.  
  819.      I know.  The right-button quick-select feature of LGSELECT
  820. 1.6 was supposed to be compatible with LDW Power spreadsheet. 
  821. Well, it wasn't, unless you had version 1.0 of LDW Power.  Oops. 
  822. It's fixed now.  I promise. 
  823.  
  824.  
  825.             New Quick Extension Selection Feature.
  826.             --------------------------------------
  827.  
  828.      Version 1.6b of LGSELECT now lets you quickly select an
  829. extension, without having to enter it into your set of 20 editable
  830. extensions.  To do this, just single-click on any file in the
  831. selector box with the LEFT mouse button, then click on the
  832. filename in LGSELECT's "Selection" line with the RIGHT mouse
  833. button.  The extension of the file you select will be entered into
  834. the LGSELECT "Directory" line as the new search template. 
  835.  
  836.  
  837.         Enter Any ASCII Character On the Selection Line.
  838.         ------------------------------------------------
  839.  
  840.      In the LGSELECT 1.6b "Paths" box, there is now a new button
  841. labeled "CHARS".  If this button is selected, LGSELECT will let
  842. you type any ASCII character on the "Selection" line.  (We use
  843. this at CodeHead when we want to create a file called G+PLUS, for
  844. instance.)  CAUTION: using certain characters in filenames may
  845. make the GEM desktop very unhappy, and may even mark your file as
  846. deleted! If you don't know what you're doing, you probably
  847. shouldn't fool around with this feature. 
  848.  
  849.  
  850. ************************ VERSION 1.6c ****************************
  851.  
  852.                    Hidden Files Bug Fixed.
  853.                    -----------------------
  854.  
  855.      Version 1.6c of LGSELECT fixes a problem with the 'Show
  856. Hidden' function.  In earlier versions, hidden files would
  857. sometimes be displayed regardless of whether the 'Show Hidden'
  858. button was selected or not.  (This happened if certain other file
  859. attributes were set in addition to the 'hidden' attribute.) 
  860. Thanks to Carl Koop for pointing this one out.
  861.  
  862.  
  863. ************************ VERSION 1.7 *****************************
  864.  
  865.             Compatible With MIDI Programs At Last
  866.             -------------------------------------
  867.  
  868.      LGSELECT 1.7 fixes a long-standing incompatibility between
  869. poor, beleaguered Little Greenie and some MIDI sequencer programs. 
  870. One specific program that used to be incompatible with Little
  871. Greenie is Master Tracks Pro from Passport; it works fine now.  (I
  872. won't even get into the issue of whose fault this was, except to
  873. say it wasn't mine!) <grin>
  874.  
  875.  
  876.                  Macintosh-Like Arrow Icons
  877.                  --------------------------
  878.  
  879.      Just for the sheer heck of it, LGSELECT 1.7 now has arrow
  880. icons that look and act very much like the "scroll arrows" in the
  881. Macintosh file selector. 
  882.  
  883.  
  884.                      Folder Information
  885.                      ------------------
  886.  
  887.      If you right-click on any folder in the LGSELECT file window,
  888. version 1.7 will now show you an "information display" for that
  889. folder, which includes the number of nested folders
  890. ("subdirectories"), the total number of files contained within,
  891. and the number of bytes that these files occupy.  The box which
  892. shows this information also has a button labeled "Open"; if you
  893. click on this button, the folder will be opened.  (Of course,
  894. Charles.  We know that.)
  895.  
  896.  
  897.                         Guide Numbers
  898.                         -------------
  899.  
  900.      LGSELECT 1.7 now lets you display a column of "guide numbers"
  901. to the left of the file/folder names in the selection window.  If
  902. you hold either shift key and type the number next to a filename,
  903. that file will be selected and its name will be copied to
  904. LGSELECT's "Selection" line.  If you hold shift and type the
  905. number corresponding to a folder, that folder will be opened. 
  906. (Note: the number keys must be typed on the numeric keypad -- not
  907. on the top row of the main keyboard.)
  908.  
  909.      There is a new button in LGSELECT's 'Paths' box that lets you
  910. turn the guide numbers on or off, in case you don't like them
  911. cluttering up your selection window.  The setting of this button
  912. is saved when you save Little Greenie's configuration. 
  913.  
  914.  
  915.                      Fill Pattern On/Off
  916.                      -------------------
  917.  
  918.      Another new button in LGSELECT's 'Paths' box lets you turn
  919. the background fill pattern in the main dialog box on or off. 
  920. This is for those among you who just hate any hint of color or
  921. pattern in your file selector.  <grin>
  922.  
  923.  
  924.               And Last But Not Least...A Bug Fix
  925.               ----------------------------------
  926.  
  927.      Version 1.7 also fixes a bug that has been in all previous
  928. versions of LGSELECT.  Previously, if you typed something like
  929. "*.*" on the "Directory" line (omitting the drive letter),
  930. LGSELECT would obnoxiously crash on you.  Oops.  This bug is fixed
  931. now.  Thanks to everyone who reported it to me. 
  932.  
  933.  
  934. ************************ VERSION 1.8 *****************************
  935.  
  936.              Key Commands Compatible With CodeKeys
  937.              -------------------------------------
  938.  
  939.      Version 1.8 of LGSELECT uses a new method of reading its key
  940. commands that is now compatible with CodeHead Software's new
  941. product, CodeKeys.  Previous versions could be controlled from
  942. CodeKeys only by recording mouse clicks.
  943.  
  944.      For more information about CodeKeys (known around
  945. CodeHeadQuarters as the "Ultimate Macro Tool"), contact CodeHead
  946. Software at (213) 386-3735. 
  947.  
  948.  
  949.                   TT and ISAC Compatibility
  950.                   -------------------------
  951.  
  952.      LGSELECT 1.8 is now 100% compatible with the Atari TT030
  953. computer, and with the ISAC large screen monitor. 
  954.  
  955.  
  956.                        Nothing Else New!
  957.                        -----------------
  958.  
  959.      I wish I had a long list of amazing new features to report,
  960. but that's it for this release.  Til next time, brush behind your
  961. ears, don't let the bedbugs bite, and never take a wooden nickel
  962. from a sow's ear. 
  963.  
  964.  
  965. ************************ VERSION 1.8A ****************************
  966.  
  967.                 Little Greenie vs. Aladdin ST
  968.                 -----------------------------
  969.  
  970.      One day a little birdie landed on my shoulder and whispered
  971. in my ear, "Yea verily, for Aladdin ST shall appear, and when he
  972. does, the <expletive deleted> is gonna hit the fan."
  973.  
  974.      Aladdin ST is the new "navigator" program for the GEnie
  975. information service.  It automates the process of logging on,
  976. downloading new messages and Email and new file listings, and then
  977. lets you read this stuff and compose replies while offline.  A big
  978. time-and-money saver.  If you use GEnie, you're gonna like it.
  979.  
  980.      HOWEVER....if, while running Aladdin, you use the Little
  981. Green Selector's 'FIND' feature or its 'FLUSH' feature, Aladdin
  982. will get very very unhappy.
  983.  
  984.      The problem lies in LGS's use of the Atari-documented "force
  985. media change" procedure.  As explained above, LGS uses this
  986. procedure to "flush" the folder count for each drive after
  987. searching it, to avoid the "40-folder" bug.  And it does indeed
  988. work for that purpose.
  989.  
  990.      The trouble is, the "force media change" procedure also has
  991. some other undocumented side effects.  For one, it closes any and
  992. all open files.  And since Aladdin leaves tons of files open while
  993. it operates, this means that it will suddenly, with no warning,
  994. find itself trying to access files that are no longer open.  Big
  995. time bad news. 
  996.  
  997.      Another effect is that this procedure resets the "current
  998. directory" to the root; so if a program is relying on the current
  999. directory to be unchanged, using LGS's 'FIND' or 'FLUSH' feature
  1000. (or holding Alt, Shift or Control while clicking a drive letter)
  1001. will throw a very unwelcome monkey wrench into the works. 
  1002.  
  1003.      Note that Aladdin is the first program in which I've seen
  1004. these problems crop up, but it's certainly not impossible for
  1005. other programs to run into these unwanted side effects of the
  1006. "force media change" procedure too. 
  1007.  
  1008.      So, along comes version 1.8A of the Little Green Selector. 
  1009. This version now keeps track of an application's file accesses,
  1010. and if you choose to 'FIND' a file (or files) it will tell you
  1011. that files are open and give you the option of cancelling or
  1012. continuing the search.  If you choose to continue a search while
  1013. files are open, LGS will bypass the "force media change" routine
  1014. during the search.  (See note below.)
  1015.  
  1016.      If no files are open, and it's safe to force a media change,
  1017. LGS 1.8A will now also reset the current drive and current path
  1018. afterwards. 
  1019.  
  1020.      Please NOTE: if you choose to continue with a search
  1021. operation even though LGS cannot force a media change, you _may_
  1022. run into the dreaded "40-folder" bug.  To avoid this, make sure to
  1023. use the FOLDRXXX program (available on online services or from
  1024. Atari) to increase the size of your internal directory buffers. 
  1025. Remember that if you search a large hard disk for a file, LGS has
  1026. to access each and every folder in every partition during the
  1027. search!  (If you use an ICD hard disk host adaptor, you may also
  1028. set the ICD software to increase your folder buffers without using
  1029. FOLDRXXX.)
  1030.  
  1031.      And they all lived happily ever after.
  1032.  
  1033.  
  1034. ************************ VERSION 1.8B ****************************
  1035.  
  1036.                   Fill Pattern Save Bug Fixed
  1037.                   ---------------------------
  1038.  
  1039.      Version 1.8B of LGSELECT fixes a bug that caused the status
  1040. of the 'FILL' button to be saved improperly.
  1041.  
  1042.  
  1043.               New Keys for Backing Out of Folders
  1044.               -----------------------------------
  1045.  
  1046.      There are new key commands for backing out folders in version
  1047. 1.8B of LGSELECT.  (The old key commands still work too.)  The
  1048. keys used are:
  1049.  
  1050.      (  [on numeric keypad] -- back out one level in current path
  1051.  
  1052.      )  [on numeric keypad] -- back out to root of current drive
  1053.  
  1054.      These commands have been added for consistency with CodeHead
  1055. Software's MaxiFile.
  1056.  
  1057.  
  1058. ************************ VERSION 1.8C ****************************
  1059.  
  1060.          Forced Media Change Disabled for Key Commands
  1061.          ---------------------------------------------
  1062.  
  1063.      It's a small thing, I know.  But very annoying if you use
  1064. programs like Word Perfect or Aladdin.  You use the keyboard
  1065. commands for LGSELECT, and keep getting the warning that there are
  1066. files open, and the folder count cannot be flushed.  Well, this
  1067. small but obnoxious character flaw has been fixed in LGSELECT
  1068. 1.8C.  This version will never attempt to flush the folder count
  1069. when you select a drive via the keyboard.
  1070.  
  1071.  
  1072.             Oh Yes, and Apparently Cubase Now Works
  1073.             ---------------------------------------
  1074.  
  1075.      That's right, this version of LGSELECT now coexists
  1076. peacefully with the Cubase MIDI sequencer program, with one small
  1077. problem.  The keyboard commands won't work when LGSELECT is called
  1078. up from within Cubase.  (At least Cubase doesn't crash at the mere
  1079. presence of LGSELECT any more...)
  1080.  
  1081.  
  1082.     **********************************************************
  1083.     *                                                        *
  1084.     * Designed and developed by Charles F. Johnson.          *
  1085.     *                                                        *
  1086.     * The Little Green Selector and this document are        *
  1087.     * Copyright 1989, 1990 Little Green Footballs Software.  *
  1088.     * All Rights Reserved.                                   *
  1089.     *                                                        *
  1090.     * Please support shareware authors!                      *
  1091.     *                                                        *
  1092.     * (Note: A very early version of this program            *
  1093.     * originally appeared in STart magazine, under the       *
  1094.     * name "STart Selector.")                                *
  1095.     *                                                        *
  1096.     **********************************************************
  1097.