home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / d / detag110.zip / DETAG.DOC < prev    next >
Text File  |  1993-01-15  |  15KB  |  344 lines
  1.  
  2.  
  3.  
  4.      DETAG V1.10 Copyright (c) 1993 Copy Con Incorporated            Page 1
  5.  
  6.  
  7.      DESCRIPTION
  8.      -----------
  9.      DETAG deletes and/or copies taglines from QWK message archives. DETAG
  10.      automatically determines the compression type, calls the appropriate
  11.      unarchiver to extract MESSAGES.DAT, and strips the taglines. If any
  12.      taglines were deleted, DETAG optionally makes a backup of the original
  13.      QWK file, then calls the appropriate archiver to replace the old
  14.      MESSAGES.DAT with the updated one. DETAG can handle wildcards, with an
  15.      optional Yes/No prompt before stripping each file.
  16.  
  17.  
  18.      REQUIREMENTS
  19.      ------------
  20.      DETAG runs under DOS 2.0 or better. DETAG also calls various file
  21.      archive/unarchive programs, depending on the compression type used on
  22.      your QWK archives; DETAG can handle ZIP, ARJ, LZH, ARC/PAK, and ZOO
  23.      archive types. You won't necessarily need every program listed in
  24.      DETAG.CFG; you probably already have the ones you need, since you are
  25.      able to read QWK message archives in the first place. If the programs
  26.      are not in your path, or if you use programs other than those listed
  27.      in DETAG.CFG (like NoGate's PAK or SEA's ARC), then you will also need
  28.      an ASCII text editor to edit DETAG.CFG.
  29.  
  30.  
  31.      DISCLAIMER
  32.      ----------
  33.      DETAG is distributed on an "AS IS" basis without warranty, expressed
  34.      or implied. Considerable testing effort has been expended, but the
  35.      user is advised to check the program's suitability before relying on
  36.      it. The user assumes full risk as to the results of using this
  37.      program. In no event shall the author be liable for any incidental or
  38.      consequential damages arising from the use, or inability to use this
  39.      program.
  40.  
  41.  
  42.      REGISTRATION
  43.      ------------
  44.      The unregistered version of DETAG is freely distributable and fully
  45.      functional, and may be used for a 30-day trial period. If you plan to
  46.      continue using DETAG, you are obligated to pay the modest registration
  47.      fee of $15. Registered users will receive an individually serialized
  48.      nag-free version of DETAG, a free upgrade, and $5 subsequent upgrades.
  49.  
  50.      All registration information is contained in the DETAG.REG file. If
  51.      that file is missing, register by sending your name, address, and a
  52.      check or money order for $15 in US dollars to:
  53.  
  54.         Copy Con Incorporated
  55.         PO Box 23255
  56.         Baltimore MD 21203-5255
  57.  
  58.      Please specify 3.5" or 5.25" diskette. MD residents add 5% sales tax.
  59.      Thank you for supporting Shareware.
  60.  
  61.  
  62.  
  63.      DETAG V1.10 Copyright (c) 1993 Copy Con Incorporated            Page 2
  64.  
  65.  
  66.      INSTALLATION
  67.      ------------
  68.      To install, copy both DETAG.EXE and DETAG.CFG into your path. If your
  69.      archivers/unarchivers are not in your path, or if you use programs
  70.      other than those listed in DETAG.CFG (like NoGate's PAK or SEA's ARC),
  71.      then you will need to edit DETAG.CFG with any ASCII text editor.
  72.  
  73.      DETAG.CFG contains the locations and command line options of your file
  74.      archivers/unarchivers. A typical line in DETAG.CFG would look like:
  75.  
  76.         LZH = C:\ARCHIVES\LHARC.EXE a /mt !A !F
  77.  
  78.      Each config line can be broken into parts; using the example above:
  79.  
  80.         LZH =         Operation being performed. Operations are UNZIP and
  81.                       ZIP, UNARJ and ARJ, UNLZH and LZH, UNARC and ARC (for
  82.                       ARC or PAK compression), UNZOO and ZOO. Not every
  83.                       operation needs to be specified in DETAG.CFG.
  84.  
  85.         C:\ARCHIVES\  Program location. If no location is specified, DETAG
  86.                       will search your path for the program.
  87.  
  88.         LHARC.EXE     Archive/unarchive program name. If a program location
  89.                       has been specified, the program name must directly
  90.                       follow the program location, as in the example above.
  91.  
  92.         a /mt         Program options. Although the rest of the config line
  93.                       is not case-sensitive, some archive/unarchive
  94.                       programs use case-sensitive options, so this part of
  95.                       the config line will be sent exactly as is.
  96.  
  97.         !A            Will be replaced with the QWK archive name.
  98.  
  99.         !F            Will be replaced with MESSAGES.DAT filename.
  100.  
  101.      After making all desired changes, save DETAG.CFG in ASCII format, in
  102.      the same directory that DETAG.EXE is in.
  103.  
  104.  
  105.      OPERATION
  106.      ---------
  107.      DETAG is activated from the command line, using the format
  108.  
  109.         DETAG filespec [options]
  110.  
  111.      The filespec can include a path, and can also contain wildcards. If no
  112.      extension is specified, an extension of ".Q*" will be appended before
  113.      searching for matching files.
  114.  
  115.  
  116.  
  117.      DETAG V1.10 Copyright (c) 1993 Copy Con Incorporated            Page 3
  118.  
  119.  
  120.      OPTIONS
  121.      -------
  122.      The options can be in any order (even before the filespec), and are
  123.      not case-sensitive. Option descriptions are as follows:
  124.  
  125.         /C   Config file path. This option is usually not needed unless
  126.              your DETAG.CFG file is not in the same directory as your
  127.              DETAG.EXE file, or if you are using DOS version 2.x (which
  128.              cannot determine the path of the program being run). The path
  129.              must directly follow the /C (no spaces). Trailing backslashes
  130.              will be added automatically, if needed.
  131.  
  132.         /N   Do not create backup files. By default, the original QWK file
  133.              will be copied before being updated; use this option to skip
  134.              that step. When backups are made, the first letter of the
  135.              backup file's extension will be changed to a B. Example:
  136.              PROG0101.QWK will be copied to PROG0101.BWK before being
  137.              updated. If the original QWK file's extension started with a
  138.              B, the backup file will start with a C. if the original QWK
  139.              file had no extension, the backup file will have an extension
  140.              of BWK.
  141.  
  142.         /O   Tagline output device or filename. As the taglines are being
  143.              stripped, they will be written to whatever device/file is
  144.              specified here. Default is none. If an existing file is
  145.              specified, the taglines will be appended to that file.
  146.  
  147.         /P   Prompt before stripping each file. This option is useful when
  148.              you want to strip taglines from all but a few QWacK packs.
  149.              Type 'Y' for Yes, 'N' for No, 'A' for All, 'C' for Cancel.
  150.  
  151.         /Q   Quiet mode. By default, DETAG will display progress messages,
  152.              and will also show you what each archive/unarchive program is
  153.              doing; use this option to attempt to surpress these messages.
  154.              DETAG's progress messages, and all archive/unarchive program
  155.              progress messages as well, will be redirected to NUL, although
  156.              output from some programs cannot be redirected. The only
  157.              messages displayed by DETAG will be warnings and error
  158.              messages, both of which are directed to STDERR.
  159.  
  160.         /R   Read only - do not delete taglines. By default, any taglines
  161.              encountered are deleted; use this option to read the taglines
  162.              without deleting. You will most likely also want to use the /O
  163.              option to route the taglines elsewhere, unless you just want
  164.              to find out how many taglines are in a QWK file.
  165.  
  166.         /W   Work directory. By default, MESSAGES.DAT is extracted to the
  167.              current directory for processing; use this option to specify
  168.              an alternate location, like a RAM drive for faster operation.
  169.  
  170.  
  171.  
  172.      DETAG V1.10 Copyright (c) 1993 Copy Con Incorporated            Page 4
  173.  
  174.  
  175.      MESSAGES
  176.      --------
  177.      DETAG messages come in three flavors: progress, warnings and errors.
  178.  
  179.      Progress messages tell you what step DETAG is in.
  180.  
  181.         "Calling (program)" is shown before DETAG attempts to run a file
  182.         archiver/unarchiver.
  183.  
  184.         "Stripping taglines..." is shown when the process of stripping
  185.         taglines from MESSAGES.DAT has begun.
  186.  
  187.         "X tag(s) stripped." is shown upon completion of tagline stripping.
  188.         X is replaced with the number of taglines stripped.
  189.  
  190.         "Copying (file1) to (file2)" is shown when backing up the QWK file.
  191.  
  192.      Warnings are displayed when DETAG has problems with a particular QWK
  193.      file. Warnings will not halt the program; when processing multiple QWK
  194.      files, DETAG will skip the current file and go on to the next one if a
  195.      warning is encountered. If any warnings occur during processing, DETAG
  196.      will return an errorlevel of 2 to DOS, unless overridden by an error.
  197.  
  198.         "Unknown archive method used for (QWK file)" is shown when the QWK
  199.         file does not appear to have been archived by any of the supported
  200.         archive types. (Let me know the archive type, and if I can track
  201.         down the specifications, I'll most likely add support for it.)
  202.  
  203.         "(config option) not defined in config file" is shown when the
  204.         archive type has been determined, but there is no config option in
  205.         DETAG.CFG corresponding to the archive type.
  206.  
  207.         "Not enough memory to call (program)" is shown when there is too
  208.         little RAM to run an archive/unarchive program.
  209.  
  210.         "Unable to extract MESSAGES.DAT from (QWK file)" is shown when a
  211.         file unarchiver returns an error code when trying to extract
  212.         MESSAGES.DAT from a QWK archive. The actual error will have been
  213.         displayed by the unarchive program prior to this message.
  214.  
  215.         "Cannot open (filename)" is shown when DETAG cannot open a file in
  216.         the desired mode, such as if trying to delete taglines from a
  217.         read-only file, or if an archiver/unarchiver is not found. If the
  218.         latter, check the config options in DETAG.CFG to make sure they are
  219.         pointing to the proper programs.
  220.  
  221.         "Error creating backup file" is shown when DETAG is unable to copy
  222.         the original QWK file prior to update. (out of disk space?)
  223.  
  224.         "Unable to update (QWK file)" is shown when a file archiver returns
  225.         an error code when trying to add the updated MESSAGES.DAT file to
  226.         a QWK archive. The actual error will have been displayed by the
  227.         archive program prior to this message.
  228.  
  229.  
  230.  
  231.      DETAG V1.10 Copyright (c) 1993 Copy Con Incorporated            Page 5
  232.  
  233.  
  234.      MESSAGES (continued)
  235.      --------------------
  236.      Errors are displayed when there exists a condition severe enough to
  237.      stop DETAG from continuing. Processing will stop immediately and an
  238.      errorlevel will be returned to DOS.
  239.  
  240.         Lvl Description
  241.  
  242.          1  Help screen. Not actually an error; the help screen is shown
  243.             when no command-line arguments are given.
  244.  
  245.          2  A warning has occurred. Warnings will not halt the program, but
  246.             the errorlevel will be set to 2, unless overridden by an error.
  247.  
  248.          3  "Ctrl-break pressed" is shown when DETAG receives a ctrl-break
  249.             or ctrl-c from the keyboard. If DETAG is running a program, the
  250.             program will receive the break signal instead of DETAG.
  251.  
  252.          4  "No filespec found" is shown when options have been specified
  253.             without a filespec.
  254.  
  255.          5  "Invalid option: (option)" is shown when DETAG runs across an
  256.             unsupported option.
  257.  
  258.          6  "Cannot open (config file)" is shown when DETAG.CFG is not in
  259.             the same directory as DETAG.EXE, or if DETAG.CFG is not in the
  260.             directory specified with the /C option.
  261.  
  262.          7  "Cannot open (tagline file)" is shown when the device or file
  263.             specified with the /O option cannot be opened for writing.
  264.  
  265.          8  "No files match (filespec)" is shown when no files match the
  266.             given filespec. (recursive enough? ;^)
  267.  
  268.          9  "Not enough memory" is shown when DETAG is not able to allocate
  269.             enough RAM prior to processing.
  270.  
  271.         10  "Invalid work directory" is shown when the drive or directory
  272.             specified with the /W option cannot be accessed.
  273.  
  274.  
  275.      EXAMPLES
  276.      --------
  277.      DETAG
  278.         displays a help screen.
  279.  
  280.      DETAG * /p /wd:
  281.         deletes taglines from all files matching a "*.Q*" filespec, making
  282.         backup copies along the way, confirming (/P) before processing each
  283.         file, and specifying the D: drive as the work directory.
  284.  
  285.      DETAG progcrnr.qwk /oprn /q
  286.         deletes taglines from file PROGCRNR.QWK, sending all taglines found
  287.         to the printer (/O), and surpressing progress messages (/Q).
  288.  
  289.  
  290.  
  291.      DETAG V1.10 Copyright (c) 1993 Copy Con Incorporated            Page 6
  292.  
  293.  
  294.      EXAMPLES (continued)
  295.      --------------------
  296.      DETAG exec* /r /oc:\slmr\taglines.mr
  297.         reads without deleting (/R) taglines found in "EXEC*.Q*" files, and
  298.         appends the taglines to an existing tagline file (/O).
  299.  
  300.      DETAG cci /n /cc:\utils
  301.         deletes taglines from "CCI.Q*" files without making backups (/N),
  302.         and specifying that DETAG.CFG is in the C:\UTILS directory (/C).
  303.  
  304.  
  305.      NOTES
  306.      -----
  307.      DETAG is most successful in stripping taglines with the format
  308.  
  309.         * QWK Reader 1.00 * This is a standard tagline.
  310.  
  311.      where * can also be the "square" symbol (ASCII 254). DETAG can also
  312.      strip most non-standard taglines, but due to the proliferation of QWK
  313.      file readers, there will always be new non-standard tagline formats
  314.      popping up; DETAG will be updated continuously to handle new formats.
  315.  
  316.      The QWK format is Copyright 1987 by Sparkware.
  317.  
  318.      All program names mentioned in this document are either Copyright or
  319.      Trademark of respective owners.
  320.  
  321.  
  322.      SUPPORT
  323.      -------
  324.      If you have questions, comments, suggestions, bug reports, et cetera,
  325.      feel free to contact me by one of the following methods:
  326.  
  327.      1: By modem at The Programmer's Corner (301-596-7692 or 410-995-6873).
  328.         Send a message to RD Thomas in the General conference, and check
  329.         back in a couple of days for a reply.
  330.  
  331.      2: By modem in the RIME Shareware conference (RD Thomas ->1520). If
  332.         you do not receive a reply within a week, it is because there are
  333.         still some kinks to be worked out at this node; try contacting me
  334.         via methods 1 or 3.
  335.  
  336.      3: By US Mail at the address given on the first page. If you would
  337.         like a reply, please include a self-addressed, stamped envelope.
  338.  
  339.      * DETAG 1.10 * Looking forward to hearing from you.
  340.  
  341.  
  342.      This document can be printed by typing "copy detag.doc LPTx" at the
  343.      DOS prompt, where x is the number of the printer port to be used.
  344.