home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / IDFILE51.ZIP / IDFILE51.DOC < prev    next >
Text File  |  1995-03-12  |  12KB  |  285 lines
  1.                       Identi-Filer v5.0 Documentation
  2.                      ==================================
  3.  
  4.                                 DISCLAIMER
  5.                                 ----------
  6.     This program is guaranteed to do nothing more than take up space.
  7.     By using this software, you the user, agree that any coincidental
  8.     damage arising from its use or misuse is the sole responsibility
  9.     of the user and not of the authors.  This program was designed with
  10.     a single purpose in mind and we are reasonably sure that it does
  11.     nothing more than what we claim. 
  12.           
  13.   Note:   I have included LIST.COM which Identi-Filer calls for when you 
  14.           choose to view the created listing.  LIST.COM is also shareware 
  15.           and requires registration by the user with its authors.
  16.  
  17.           This program requires that you already have one or more of the
  18.           supported compression utilities installed on your system somewhere
  19.           in your DOS path or in the same directory that you will install
  20.           IDENTI-FILER v5.0.  If Identi-Filer cannot locate any of your 
  21.           compression utilities, it will not attempt to extract anything.
  22.           
  23.  ==========================================================================
  24.               This program was compressed with COMPACK v4.5
  25.               ---------------------------------------------
  26.  
  27. How to use:
  28. ------------
  29.  
  30.   1. Identi-Filer depends upon your decompression utilities to exist in
  31.      either the same directory in which IDFILER.EXE resides or to be 
  32.      somewhere in your DOS path.  It will not extract descriptions if 
  33.      otherwise.
  34.  
  35.   2. When the program starts, you are given a menu of options that can
  36.      be modified to suit your needs.  Simply choose the command letter for
  37.      the setting(s) that you wish to change.  When you have completed your
  38.      setup you can press ENTER to begin processing or ESCAPE to abort.
  39.  
  40.   3. Here is a brief description of each menu option and its use:
  41.  
  42.      [S] Source drive:\path     : 
  43.  
  44.         This line is your drive letter and path of the directory of files
  45.         that you wish to process.  It must be in the format of:
  46.         [drive letter]:\[directory name] such as C:\DOS.  Identi-Filer
  47.         will ignore any entry that does not contain the colon and slash.
  48.  
  49.      [T] Target drive:\path     : 
  50.  
  51.         This line is your drive letter and path of the directory that you
  52.         wish Identi-Filer to do its processing and to write the output file
  53.         listing.  The syntax is the same as Source drive:\path.
  54.         Pressing ENTER on this line while blank will use the identical
  55.         drive and path as the Source drive and path.
  56.  
  57.      
  58.      
  59.      
  60.      
  61.      [F] File name to create    :
  62.  
  63.         This line contains the filename of your output file listing.
  64.         It can be any name you wish.  This option is not available until
  65.         Identi-Filer is registered.
  66.      
  67.      [N] Name of File-Insert    :
  68.  
  69.         This is a text file or any other file of your choosing.
  70.         It can be an advertisement for your BBS, an announcement of some 
  71.         kind or whatever you wish.   When File-Insert Mode is turned on, 
  72.         Identi-Filer will compress this file into each of your archived  
  73.         files.
  74. ** NOTE ** 
  75.         The filename must be L00K-AT.ME! in the unregistered version and
  76.         must exist in the same directory as IDFILER.EXE to use this feature.
  77.      
  78.      [H] Header at top of list  : ON/OFF
  79.  
  80.         This toggles the header (heading printed at the top of each output
  81.         file) on and off.  This option is not available until Identi-Filer
  82.         is registered.
  83.  
  84.      [1] Include File Size      : ON/OFF
  85.  
  86.         Toggles whether to list the file size for each file in the output
  87.         file listing.
  88.      
  89.      [2] Include File Date      : ON/OFF
  90.  
  91.         Toggles whether to list the file date for each file in the output
  92.         file listing.
  93.      
  94.      [3] Include Descriptions   : ON/OFF
  95.  
  96.         Toggles whether to list the description for each file in the output
  97.         file listing.
  98.      
  99.      [+] Append Output File     : ON/OFF
  100.  
  101.         This toggle gives you the option of appending the list you are about
  102.         to create onto the end of an existing file list.  The output file
  103.         name must be the same as the existing file for this feature to work.
  104.         See also "[@] Sub-Directories  : ON/SORT/OFF"  below
  105.  
  106.      [C] Compressed Files Only  : ON/OFF
  107.  
  108.         This toggles whether or not you want ALL of the files in the source
  109.         directory to be listed or only the .ZIP .ARJ and .SDN files.
  110.  
  111.      [I] Interactive Mode       : ON/OFF
  112.  
  113.         This toggles the Interactive mode.  The interactive mode, when turned
  114.         on, will prompt you to manually enter a one line description for a
  115.         file when none was found within the archive.
  116.  
  117.  
  118.  
  119.  
  120.  
  121.      [A] Auto-Add descriptions  : ON/OFF
  122.  
  123.         Used in conjuction with Interactive Mode.  When this option is turned
  124.         on, it will add the manually entered description into the compressed
  125.         file for future use.  Auto-Add will not work without Interactive Mode
  126.         on so by toggling this feature Identi-Filer automatically turns
  127.         Interactive Mode.
  128.      ---*** Identi-Filer WILL NOT violate the "security envelope" of .SDN
  129.             or .ARJ files and will simply ignore this command when coming
  130.             across a "sealed" SDN or ARJ file.
  131.             
  132.  
  133.      [D] Double-space the List  : ON/OFF
  134.  
  135.         This toggles the line spacing of the output file to single or double
  136.         line spacing between listed file names and their descriptions.
  137.  
  138.      
  139.      [P] Pack File-Inserts     : ON/OFF
  140.      
  141.         This command toggles the Jumk-Mail Mode.  File-Insert is a
  142.         feature that allows you to compress one of your own files
  143.         (text file advertisement, for example) into each of the files in
  144.         your source directory during processing.  
  145.         ** NOTE ** This feature is disabled if Identi-Filer cannot find
  146.                    the File-Insert filename in the current directory.
  147.         ** The filename must be L00K-AT.ME! in the unregistered version.
  148.      ---*** Identi-Filer WILL NOT violate the "security envelope" of .SDN
  149.             or .ARJ files and will simply ignore this command when coming
  150.             across a "sealed" SDN or ARJ file.
  151.  
  152.      [$] File-Insert Mode Only : ON/OFF
  153.  
  154.         When this switch is turned on, it will compress your File-Insert
  155.         file into each file that it is processing.   This option produces
  156.         no output list and all other features are disabled during operation.
  157.      ---*** Identi-Filer WILL NOT violate the "security envelope" of .SDN
  158.             or .ARJ files and will simply ignore this command when coming
  159.             across a "sealed" SDN or ARJ file.
  160.         
  161.      [@] Sub-Directories       : ON/SORT/OFF
  162.  
  163.         This switch works in relation to the Append File List function.
  164.         If this switch is on and Append File List is OFF then Identi-Filer
  165.         will create separate file listings for each directory in the
  166.         target directory.
  167.         If this switch is on SORT, Identi-Filer will put each individual
  168.         file list in its corresponding source directory.
  169.         
  170.      [/] Save Configuration
  171.  
  172.         This option saves the current configuration to the file IDFILER.SET
  173.         in the current directory.  If IDFILER.SET does not exist, this
  174.         command will create it automatically.
  175.      
  176.  
  177.  
  178.  
  179.  
  180.  
  181.      [R] Register!
  182.  
  183.         This command enters Registration mode.  A registration code is
  184.         required to register Identi-Filer and is only available upon
  185.         registration with the author.
  186.  
  187.  
  188. Command Line Options
  189. --------------------
  190.  
  191. Example:
  192.    At your DOS prompt;
  193.  
  194. IDFILER /AUTO or IDFILER /LOGO or IDFILER /SCAN or IDFILER /AUTO /LOGO etc.
  195.  
  196.  
  197.    /AUTO =  Runs Identi-Filer automatically with the default settings
  198.             used in the IDFILER.SET.  This paramater is useful for running
  199.             Identi-Filer in a BBS event or other timed event, 
  200.             for automatic execution in a batch file such as AUTOEXEC.BAT
  201.             during boot-up, or any other use where you want Identi-Filer
  202.             to run automatically and unattended.
  203.  
  204.    /LOGO =  This option allows you to run Identi-Filer in File-Insert Mode 
  205.             for the purpose of inserting your Logo file (see above) into
  206.             archived files without any other processing.  
  207.             This command will disable the .DIZ/.SDI/.ID extraction.
  208.             Identi-Filer will not produce a list in this mode.
  209.  
  210.    /SCAN =  This feature causes Identi-Filer to run in STATISTICAL MODE ONLY.
  211.             This mode will search all subdirectories starting with the source
  212.             directory that you specify.  To do an entire drive choose the
  213.             root directory of that drive.   Identi-Filer will scan each
  214.             directory and will display running totals of directories, files,
  215.             file sizes, average file size, average files per directory, etc.
  216.  
  217. What does Identi-Filer do?
  218. --------------------------
  219.  This program searches the supported archive type (.ZIP, .ARJ, .SDN, .ARC,
  220.  .LZH, .LHA, .RAR, .PAK) in the specified directory for the files 
  221.  FILE_ID.DIZ or DESC.SDI (and SDN.ID. in .SDN files). 
  222.  These are description files found in most compressed files describing 
  223.  the archived program.  Identi-Filer extracts this description file and 
  224.  reads it. It then writes the description to a text file of your choosing 
  225.  which will contain the complete listing of every .ZIP and .ARJ file in the 
  226.  specified directory along with their descriptions.  The text file can be 
  227.  used for importing files into a BBS database, CD-ROM Door, or can simply 
  228.  be used as a catalog listing of your archived collections.
  229.  
  230.  This version also reads the internal descriptions found in .MOD sound files.
  231.  
  232.  If Identi-Filer finds a text file by the same filename as chosen
  233.  at startup in the target path, it will rename it with a .OLD extension
  234.  during operation and then will restore the original file name when finished.
  235.  
  236.  This program is very simple and has much room for improvement and change
  237.  so try it out and then give me all of your suggestions, comments, and
  238.  ideas.  I will do what I can to incorporate your ideas into future versions.
  239.  
  240.  
  241.  
  242.  
  243.    This version of Identi-Filer is SHAREWARE.  This means that you can 
  244.    try it out for a period of time and then either pay me for it or 
  245.    discontinue using it. It is unlawful to continue using shareware programs 
  246.    after the initial demo period.   
  247.             *  THE DEMO PERIOD FOR "IDENTI-FILER" IS 30 DAYS.  *
  248.  
  249.   If you enjoy this program and would like to continue using it then please 
  250.   register it.
  251.  
  252.   Send $20.00 to:   Kevin Smith
  253.                     1403 E. Elm #9
  254.                     Springfield, MO.  65802
  255.                     ------------------------
  256.   
  257.   Credit Cards are not accepted by the BBS at this time.
  258.  
  259.       A registered code will be generated in your name within 24 hours
  260.       of receipt of your payment and will be made available to you from 
  261.       The Neon Vortex BBS. 
  262.       
  263.       If you do not want to get your code from the BBS, I can either send 
  264.       it to you by US Mail, by a voice telephone call or I can send the 
  265.       code to you by Fido NETMAIL.
  266.       
  267.       When you register IDENTI-FILER you are entitled to and will receive
  268.       free minor upgrades to the software as well as 1/2 price on all future  
  269.       major releases of this program as well as any of our other products.
  270.  
  271.  
  272.  
  273.  
  274. **  For product support, suggestions or bug reports contact:
  275.  
  276.              Kevin Smith  
  277.              Sysop of The Neon Vortex BBS         
  278.              Springfield, MO. 65802         
  279.              
  280.              BBS : (417) 865-7386 
  281.            Voice : (417) 865-0974
  282.         Cellular : (417) 861-6828
  283.         Fido-Net : (1:284/79)  The Neon Vortex BBS
  284.                       
  285.