home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 6 File / 06-File.zip / cmntm030.zip / english.txt < prev    next >
Text File  |  1997-01-20  |  9KB  |  180 lines
  1. -----------------------[Comment Manager V.0.3 beta]-------------------------
  2.  
  3. -------------[(c) 1997 Alessandro Cantatore * Team OS/2 Italy]--------------
  4.  
  5. This program is freeware and it is beta code. Anyway it should be safe and
  6. not able to cause any loss of data. You can freely use it till April the 30th
  7. 1997. After that date the program will cease to work.
  8. As a standard disclaimer:
  9.  
  10. Under no circumstances the author is liable for any loss or damage.
  11. The use of the program implies acceptance of the conditions stated above.
  12.  
  13. ----------------------------------------------------------------------------
  14.  
  15. What is new with this release
  16.  
  17.   - The main window has been enlarged
  18.   - Has been added an entry field for editing the .SUBJECT extended attribute
  19.   - You can set your favourite font for the main window
  20.   - You can choose between single file selection mode and extended selection
  21.     setting the same attribute to all selected files
  22.   - You can avoid displaying the startup logo.
  23.   - If the has been minimized on the desktop, it will be properly displayed
  24.     with its icon
  25.   - Now you can move through the various controls by pressing Alt + the
  26.     underlined character
  27.  
  28.  
  29. Introduction
  30.  
  31. The program allows to easily add, edit or delete the .SUBJECT, .COMMENTS and
  32. .KEYPHRASES extended attributes of your files.
  33. I have a lot of archived files I downloaded from the internet and often cannot
  34. remember their content or cannot find a particular file. Comment manager
  35. allows to add a small description (it can be as long as about 32 KB) and
  36. some "Key Phrases" you can use when searching files.
  37. Even if the "Find" button is not yet operative in this release, the OS/2
  38. built-in Find utility allows file search based on the content of the
  39. "Key Phrases" extended attribute.
  40. Suppose you run a BBS and have archives of various kind of applications for
  41. different operating system, you could use various key phrases describing for
  42. example:
  43. -1) the author of the application
  44. -2) the operating system it is designed for
  45. -3) kind of application (file manager, game, etc.)
  46. -4) your evaluation (good application, useful, etc)
  47. -5) anything else
  48. This way, through the object find utility, you could automatically create
  49. folders containing all your "OS/2 text mode file managers", or all
  50. applications of your favourite software author and so on...
  51.  
  52.  
  53. Installation...
  54.  
  55. Just put it where you like and run it. It doesn't need any runtime library
  56. (i.e. DLL files) other than the operating system DLLs and won't mess with
  57. your INI files!
  58. Now you can set some options by specifying some parameters through the
  59. command line or in the "Parameters" entry field of the settings notebook
  60. of the program. You can create various "Comment manager" objects with
  61. different settings each. See the "Options..." section for more detail about
  62. the available options.
  63.  
  64.  
  65. How it works...
  66.  
  67. It is like a file dialog box: just select a file and edit the attributes.
  68. If you have changed some attribute and select a new file or directory
  69. a dialog box will ask you if you want to save or discard what you modified.
  70. Click on the Save button to avoid that.
  71. If you chosed to work with the Extended selection flag on (see "Options")
  72. you can select one or more files in the same way you do that with other
  73. WPS objects:
  74.  - swiping the mouse pointer on the "File:" list box while pressing down MB1
  75.    (mouse button one)
  76.  - clicking with MB1 while keeping the "Ctrl" key pressed down for selecting
  77.    not-contiguous files
  78.  - clicking with MB1 while keeping the "Shift" key pressed down for selecting
  79.    all files betwen the previous selection and the current selection
  80. The file specifics and attributes showed concern the topmost selected file.
  81. If you want to set the same attribute for all selected files you must click
  82. on the "Save" button in the main window. A dialog box will then be displayed
  83. to allow you to choose which attributes to set for all the selcted files.
  84. For instance if the selected files have different "comments" and you want them
  85. to share the same "key phrases" without affecting "comments" or any other
  86. attribute, you must select only the "Key phrases" check box in the "Multiple
  87. File Save" dialog.
  88. The Find routine has not yet been implemented so do not expect any action
  89. from the Find button.
  90. The Quit button allows you to terminate the program. If some attribute of
  91. the current file have been changed you will be prompted for saving,
  92. discarding them or cancel quitting.
  93.  
  94.  
  95. Options...
  96.  
  97. Now you can override some default settings by specifying in any order one or
  98. more of the options described below. Options are case insensitive and may be
  99. introduced either form the dash "-" or from the slash "/" characters.
  100. In case of an invalid option a dialog box will appear showing a short list
  101. of the valid options and the program will start using only the valid options.
  102. Valid options are:
  103.    -N (-n | /N | /n) lets start the program without showing the "About Comment
  104.                      Manager" dialog.
  105.    -E (-e | /E | /e) sets the Extended selection mode
  106.    -FfontSpecs (-f | /F | /f) where fontSpecs is the font size and name as
  107.                      specified in the Font Palette. If the font name enclose
  108.                      some blank character you must enclose the whole option
  109.                      between double quotes.
  110.                      Example:
  111.                      "-f5.System VIO"
  112.  
  113.  
  114.  
  115. Limitations
  116.  
  117. -1) There is no exception handler for "drive not ready" so if you click on
  118.     the ID letter of an empty drive you can just terminate the program or
  119.     insert a floppy in the drive.
  120. -2) The behaviour of the list box is not consistent: 1 mouse click is enough
  121.     for changing drive or file, but a double click is needed for changing
  122.     directory.
  123. -3) If the path is too long it could not be entirely displayed so it is better
  124.     to use a small font ("-f5.System VIO").
  125. -4) I've used standard "list box" controls so there could be problems if
  126.     you have large amounts of files in your folders (32765 of files with
  127.     OS/2 Warp 3 or 4 - I'm not sure about OS/2 2.x).
  128. -5) The code has not yet been optimized, neither for size not for speed.
  129.     The program works very well with my P100 machine, and I think the speed
  130.     could be acceptable even with a 386 (let me know if you have any problem).
  131.     The program has not been packed, it isn't that large (about 35 KB) but
  132.     if you have warp 3 or 4 you could shrink it up to about 20 KB by LXLITE.
  133.     (It is a free utility by Andrew Zabolotny. You can download it from
  134.      hobbes.nmsu.edu/os2/archiver as lxlt115.zip).
  135.     The C language may require a lot of coding work, but it does produce fast
  136.     and small executables!
  137. -6) If multiple files are selected, selecting a new file (and deselecting
  138.     previously selected files) will display the "Save..." dialog. Clicking
  139.     on the "Save" button in this dialog will allow to save only the topmost
  140.     of the previously selected files. So in order to set the same attribute
  141.     for multiple files it is necessary to click on the save button in the
  142.     main window.
  143.  
  144. What will be in the next release?
  145.  
  146. If anybody would be interested in that I could easily add:
  147. -0) Get rid of above mentioned limitations.
  148. -1) Setting notebook for changing presentation parameters (font, colors)
  149.     and setting the default behaviour of other functions.
  150. -2) Resizeable window border. You will be able to choose the size and
  151.     position of the window. The inner controls will be resized accordingly
  152.     and size, position and other preferences will be stored in an INI file.
  153. -3) Display or copy the content of file_id.diz files from archives into
  154.     the .COMMENTS ea.
  155. -4) Import or copy any other kind of comment like those created by 4DOS or
  156.     4OS/2.
  157. -5) Controls for changing the date and time of one or more files in one
  158.     directory and/or all subdirectories.
  159. -6) Access to every kind of standard and not standard extended attribute.
  160. -7) A powerful routine to search for Files based on their content, or the
  161.     content of their attributes.
  162. -8) Pop up menu for basic editing features (cut/copy/paste, select/deselect,
  163.     etc.) in the extended attributes editing fields.
  164. -9) Help with some notes about extended attributes.
  165. -10)Better organization of the folder listbox.
  166. -11)Option for displaying file and folder icons.
  167. -12)Option for storing in a separate file attributes of files residing on
  168.     not writeable media like CD ROM or floppy disk with no available space
  169.     in order to create a data base of all available files.
  170. -13) Different language versions (I would need your help).
  171. -14) Any other feature you would like...
  172.  
  173. Version 1.0 will probably be avaliable as shareware in March-April 1997.
  174.  
  175. Well for any suggestion or bug report write to me:
  176.  
  177. Alessandro Cantatore
  178.   Team OS/2 Italy
  179. alexcant@mbox.vol.it
  180.