home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / qlsort13.zip / QLSORT13.DOC < prev   
Text File  |  1996-09-08  |  10KB  |  249 lines

  1. ******************************************************
  2. *                                                                     *
  3. *                WebEx - QuickList - Sorter  V 1.3               *
  4. *                                                                     *
  5. *                              by Thomas Unger                     *
  6. *                                                                     *
  7. ******************************************************
  8.  
  9. Disclaimer:
  10.  
  11. There is no warranty. Use this software at your own risk.
  12.  
  13. I am not responsible for any damage or loss of data caused by use of
  14. this software. This program is expected to work correctly, but
  15. nobody can actually guarantee this for any circumstances. And because this
  16. software is free, you get what you pay for ...
  17.  
  18. This program can be used freely. If you find any bugs or have
  19. suggestions about further enhancement, please contact the author.
  20.  
  21.  
  22. What is Web-QuickList-Sorter (QLSORT.EXE) ?
  23. --------------------------------------
  24.  
  25. This Program is a simple Utility to arrange IBM's WebEx Quicklist-Entries.
  26.  
  27. I found it annoying to arrange these Tags manually fiddling around with
  28. WebEx explore.ini, so I first wrote a Tool using StarOffice's VBA-compatible Basic. But loading a big Office-Program just to sort a Quicklist seemd a bit exaggerated. So here is a small, fast
  29. and easy to use Tool to do the work.
  30.  
  31. How will WebEx-QuickList-Sorter work ?
  32. ----------------------------------
  33.  
  34. *Retrieving an explore.ini:
  35.  
  36.  QLSORT.EXE will search for the file explore.ini within the directory QLSORT.EXE is
  37.  located in.
  38.  If it can't find it there, QLSORT.EXE queries the ETC-PATH  (SET ETC=... in your config.sys)
  39.  for explore.ini.
  40.  
  41.  A File-Open Menu has been added to open an explore.ini.
  42.  
  43. How to use WebEx-QuickList-Sorter
  44. ------------------------------
  45. QLSORT.EXE is a very simple Program, so it does not provide an Online-Help.
  46.  
  47. Although QLSORT.EXE will backup EXPLORE.INI, you should backup the original
  48. EXPLORE.INI to a different location before using this program. 
  49.  
  50. (new) a tiny Properties-Dialog has been added. The Preferences are stored in qlsort.ini.
  51.        To access this Dialog use Edit/Properties or PopUp/Properties 
  52.  
  53. (new) The Toolbar-Iconsize is adjustable to two different sizes. Use Properties-Dialog to
  54.         change the size.
  55.  
  56. (new) A field located at the right bottom side shows if the Filecontents were changed. This
  57.        Information is periodically determined. 
  58.  
  59. (new) To change the default Listboxsize-ratio (50/50) just start dragging between the 
  60.         Listboxes.
  61.  
  62. (new) Changing the Fonts of the Listboxes and Entry-Fields above is possible now.
  63.        To change the Default-Font, drag a new Font for your Font-Palette to the free
  64.         space on the right side of the Toolbar-Icons. This will change the Fonts of
  65.         the four Main-Controls (Listboxes and Entryfields above). To save the new Font
  66.         just choose "Window-Save current Position" .
  67.  
  68. The Icon-Bar provides quick access to most functions. Fly-Over-Help gives a short hint.
  69.  
  70. *Find a Substring
  71.  
  72.  To locate a Substring, use the Find-Command. It's possible to search either in Title-List, URL-List
  73.  or both. QLSORT searches globally. If there's no match, a small notification pops up.
  74.  
  75.  
  76. *MenuBar/PopUpMenu:
  77.  
  78.  Most Functions can be accessed from the MenuBar/PopUp-Menu
  79.  (press Mouse Button 2 inside a ListBox to open a PopUp-Menu).
  80.  
  81.  Some Functions can be invoked by using Accelerator-Keys
  82.  (e.g File-Open: Ctlr+O). 
  83.  
  84.  
  85. *Moving Tags:
  86.  
  87.  After starting the Program and the Quicklist-Tags are sucessfully retrieved, you
  88.  can change the position of the Tags by selecting one and pressing Promote/Demote
  89.  to change its position.
  90.  
  91.  Alternativly, Tags can be moved by dragging to the desired position with
  92.  Mouse Button 1 (usually the LeftMouseButton) pressed.
  93.  
  94.  To move Tags quickly to the Top/Bottom, use "Move Tags to Top/Bottom" Function.
  95.  
  96. *Edit your Tags
  97.  
  98.   All Tags can be edited. For this purpose use the two Entryfields above the Listboxes.
  99.   These Entryfields provide normal cut/copy/paste-procedures using the Clipboard.
  100.   To send the changes from an Entryfield into the Listbox, hit "Enter". 
  101.  
  102.  Important: Both EntryFields must contain Information to be accepted by the Listbox.    
  103.  Pressing ESC-Key will leave Edit-Mode without accepting changes.
  104.  
  105. *Add/Delete Tags
  106.  
  107.  Two Buttons (ADD/DELETE) have been added. Use them to add or delete Tags.
  108.  
  109. *Sorting Tags:
  110.  Tags can be sorted ascending/descending. It's possible to undo the last sort-command.
  111.  Sorting will always process the Title-Entries (URL's are updated as well). 
  112.  
  113. *Saving the processed Explore.ini
  114.  
  115.  If you press the "Save"-Button, you are asked for confirmation to save the changes.
  116.  You can press "Yes" to save and  "No" to cancel.
  117.  If "Yes" is pressed, a backup of the current INI-File is created having the extention
  118.  .QLS. The changed INI-File will be saved overwriting the Original.
  119.  If the Backupfile already exists, you are asked to overwrite it. Press "Yes" to proceed
  120.  overwriting it or "NO" to skip overwriting (no Backup will be created).
  121.  
  122.  To use a different Filename to save, use the "Save-As-Dialog".
  123.  
  124.  
  125. *Usefull Information displayed by QLSORT
  126.  
  127.  Bottom Area of the Window shows the Path of the currently processed explore.ini.
  128.  
  129.  The lower right windowcorner shows the current selected Tagnumber and Count of
  130.  all Tags.  
  131.  
  132.  
  133.  
  134. How to maintain multiple explore.ini-Files 
  135. ----------------------------------
  136. A. The easiest way is to create different objects of QLSORT on your desktop
  137.    and to set the working-directory in the settings-notebook to the path were
  138.    a copy of explore.ini resides.
  139.  
  140. B. Or you can associate QLSORT with explore.ini in the settings-notebook.
  141.    Opening any explore.ini will start QLSORT.
  142.  
  143. C. Simply drag an explore.ini onto QLSORT will work too.
  144.  
  145. D. Use the File-Open and/or Save-As Dialog.
  146.  
  147.  
  148.  
  149. To contact the author:
  150. ------------------
  151. If you find any bugs, or have any suggestions concerning this program,
  152. contact the author:
  153.  
  154. Fido: Thomas Unger @ 2:2468/1001.37
  155. eMail: tmunger@rummelplatz.uni-mannheim.de
  156.  
  157.  
  158.  
  159. Thanks to:
  160. Martin S. Hanoian, who encouraged me to implement certain functions.
  161.  
  162.  
  163.  
  164.  
  165. History
  166. ------
  167.  
  168. V 0.3 Beta   first public release
  169.  
  170. V 0.4 Beta    * corrected: QLSORT.EXE did not save the new Tags to explore.ini.
  171.                              (only a backup was created)
  172.  
  173.                 * changed:   the backup-file explore.qls is now stored in the same
  174.                               path as the original.                                      
  175.  
  176. V 0.5 Beta  internal build
  177.         * added:     a possibility to edit the Tags.
  178.         
  179. V 0.6 Beta   internal build
  180.         * added:     Status output in upper right windowcorner 
  181.         * added:     Path of currently processed explore.ini is displayed
  182.                               at windowbottom.
  183.  
  184. V 0.7 Beta  internal build
  185.         *added:     ADD/DELETE Button
  186.  
  187. V 0.8 Beta    *changed:   A bug resulting in a GPF when loading a very big explore.ini.
  188.                              (bug removed).
  189.  
  190. V 0.9  Beta internal build 1
  191.         *added      Moving Tags with LeftMouseButton pressed
  192.  
  193. V 0.9  Beta internal build 2
  194.         *changed     Edit-Tags-Routine improved
  195.  
  196.         *changed     Moving Tags with LMB-Routine performance improved
  197.         
  198.         *changed     Add-Routine-performance improved
  199.         
  200.         *changed   "The biggest explore.ini isn't big enough" - maximum processing-size
  201.                              increased. Now it should be possible to handle 900 Tags.
  202.  
  203.  
  204. V 0.9 Beta public release
  205.                 *changed   Maximum Tag-Count is now limited by available memory
  206.                             (successfully created and edited an explore.ini containing 7300 Tags)                     
  207.                 *changed   some minor code-improvement
  208.  
  209.  
  210. V 1.0 Beta internal build 3
  211.                 *changed  Removed a bug in Promote-Routine.
  212.                             (Dragging with Mouse worked well)
  213.                 *added     Menu-Bar /PopUp-Menu
  214.                 *added     Sort Ascending/Descending
  215.                 *added     Move Tag to Top/Bottom
  216.                 *changed   Listbox-Scrolling synchronized
  217.                 *added     File/Save-As Dialog.
  218.  
  219.  
  220. V 1.0 Beta Internal build 4   
  221.                *changed  better support for different screen-resolution.
  222.                *added     Find-dialog
  223.                *added     Accelerator-Keys for most functions.
  224.                *changed   improved Keyboard usage
  225.                          
  226. V 1.1 Beta public release
  227.                *added    Toolbar added.
  228.                *added    Toolbar-Fly-over-help
  229.                *changed  Layout changed.
  230.               
  231.  
  232. V 1.2 Beta 
  233.               *added    Large Icons
  234.               *added    Properties-Dialog
  235.               *added    Find-Fail-Notification
  236.               *added    Filecontent-Status added (Changed/Unchanged)
  237.               *changed  some minor Code-improvement 
  238.               *changed  FlyOver-Help Rectanglesize calculation an positioning improved
  239.               *added    Auto-Vanish of FlyOver-Help Rectangle after a short period of time
  240.  
  241. V 1.3        
  242.               *added    Dynamic resizing of both Listboxes 
  243.               *added    Changing Fonts of Main-Controls (Listboxes and Entryfields above)
  244.                           via D&D
  245.  
  246.               *added    Storing Window-Pos/Size/Fonts/Listboxadjustment in QLSORT.INI
  247.               *added    (very) simple HLP-File
  248.  
  249.