home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: SysTools / SysTools.zip / prgadd10.zip / progadd.doc < prev    next >
Text File  |  1996-09-13  |  5KB  |  184 lines

  1.  
  2.  
  3.  
  4.                                Prog Add 1.0
  5.  
  6.                        By Diarmuid Albers (C)1996
  7.  
  8.  
  9. Introduction
  10.  
  11. With this utility you can create a database of programs and add programs to it
  12. as you go along.
  13. Such a database is actually shiped with Warp and is located in \os2\install as
  14. database.txt -> the text version and database.dat -> the binary version.
  15. These got bigger after every new release of OS/2, but you wouldn't find any
  16. not as well known utillitys or programs in there, so at least I always had
  17. to create all the other program objects again, after a new release of OS/2 or
  18. after some experimenting! But now you only have to enter the title of the 
  19. program object only once or not even that, despite any new 
  20. installations of this wonderful OS ... 
  21.  
  22.  
  23.  
  24.  
  25. Requirements
  26.  
  27.    Any OS/2 Version with the WPS.
  28.  
  29.  
  30. Licence
  31.  
  32. AddProg is copyrighted to the author. It may not be modified in any way or form.
  33. It can be freely distributed providing no charge is made beyond those to 
  34. cover media expenses and the like.
  35.  
  36. AddProg is provided "as  is"  and  any  damage,  actual or perceived,
  37. caused by the program is not the  liability  of  the author. By using the
  38. program you accept these conditions.
  39.  
  40.  
  41.  
  42.  
  43. Syntax :
  44.  
  45. ProgAdd [-q] [[-s] [-v]] [-aDIR] [-dPRGDB] [-nNONODB]
  46.           │     │    │     │       │          │     []  means optional!
  47.           │     │    │     │       │          └Name of noobject database
  48.           │     │    │     │       └───────────Name of program database
  49.           │     │    │     └───────────────────Start directory
  50.           │     │    └─────────────────────────with firstlevel directory names
  51.           │     └──────────────────────────────with subdirs
  52.           └────────────────────────────────────quick, without user interaction
  53.            
  54.            
  55. AddProg is a commandline utillity. All options are begin with an "-" and
  56. are followed by keywords. These are:
  57.  
  58.  [-q] , if this switch is used, the program will not ask the user to input
  59.         an object title. Instead it will take the program name and cut off
  60.         the ".exe" bit. 
  61.         
  62.  [-s] , if this switch is used, the program will also walk through any
  63.         subdirectorys of the current or startdirectory.
  64.         
  65.  [-v] , this switch can only be used in combination with the "-s" switch.
  66.         If its used, the folder names will reflect the names of the first
  67.         level subdirs.
  68.         
  69.         MyStuff 
  70.          │
  71.          └─fileutils          -> folder name
  72.          │   └fc
  73.          │   └fm2
  74.          │   └dirmaster
  75.          └─sysutils           -> folder name
  76.          │   └WarpnGo
  77.          │   └Memsize
  78.          │   └SysBench
  79.          └─graphics           -> folder name
  80.          │   └PM View
  81.          │   └Jview
  82.          │   └lart
  83.          └─proging            -> folder name
  84.             └bcos2
  85.             └emx
  86.             └javaos2
  87.   
  88.  [-a], specifies the directory in which Addprog should start to search!
  89.    
  90.  [-d], specifies the name of the program database. Default is progs.txt
  91.    
  92.  [-n], specifies the name of the noobject list. Default is noobject.txt
  93.    
  94.  
  95.  
  96. Examples
  97.  
  98. This section is just intended  to  visualise  the above into something a
  99. little more tangible. Some examples of syntax are shown below:
  100.  
  101.  
  102.  
  103.  
  104.  Add programs in the current directory to the default database with no
  105.  user interaction:
  106.  
  107.    AddProg -q
  108.   
  109.  The same but now include subdirectorys
  110.  
  111.    AddProg -q -s
  112.  
  113.  Use the specified noobject file
  114.  
  115.    AddProg -q -s -nNOJECT.DAT
  116.  
  117.  Use the specified database
  118.  
  119.    AddProg -q -s -dMyPrgbase.dat
  120.  
  121.  Use the firstlevel directorys as folder names
  122.  
  123.    AddProg -q -s -v 
  124.  
  125.  Start at specified directory
  126.  
  127.    AddProg -q -s -a\myapps
  128.  
  129.    
  130. What now?
  131.  
  132. pcom.cmd [-dProgDat.txt] [-ePrgDat.dat]
  133.  
  134. First we must compile the database into a .dat file. Use the pcom.cmd
  135. file for this. The only optional parameters are the -d which specifies the
  136. program database. The default value for -d is Progs.txt. And -e which
  137. specifies the name of the output binary database. Its default is Progs.dat
  138.  
  139. Now after that:
  140. To actually get the objects created, you must use the "Add Programs" Tool 
  141. (migrate.exe) which is located in the system setup folder (or \os2\install).
  142. Now the option "Search for and select programs to add" must be selected. After
  143. hitting the OK button a dialog appears in which we select for what program types
  144. objects should be createt and the drives on which the programs are located.
  145. Enter the path to the database we created before and click OK. Now the titles
  146. of the found programs are displayed and you can select for which objects shall
  147. be created. OK again, and we're finished!
  148.  
  149.  
  150.    
  151.  
  152. Versions
  153.  
  154.  1.0  09/13/96
  155.  
  156.       First public release.
  157.  
  158.  
  159. Remarks
  160.  
  161. This program was actually created for my personal use. But I thought it could
  162. be useful for other Warpers around. Thats why its freeware!
  163.  
  164.  
  165. Contacts
  166.  
  167. Any suggestions, comments or found bugs about ProgAdd are very welcome. I'm
  168. available at the following addresses:
  169.  
  170.     internet : buster@www.penzberg.de
  171.  
  172.     snailmail: Diarmuid Albers
  173.                Birkenstr.131
  174.                82377 Penzberg
  175.                Germany
  176.                
  177.                I like postcards with pictures of YOUR location in this weird 
  178.                world !
  179.     
  180. Diarmuid Albers 
  181.  
  182.  
  183.  
  184.