Phoenix CD 2.0/Phoenix_CD.cdr/15a/comment.zip/CMT.DOC

Text File | 1988-07-31 | 9KB | 205 lines

 CMT  -  Add Comment Utility for ARC files created with Phil Katz' PKARC

 CMTS -  Add Comment BATch file Utility for multiple ARC files

 (c)  Copyright 1988 by Crater Rim Software.  All Rights Reserved

First things first....


CMT Licensing Agreement
-----------------------
    This  utility is the sole property of Crater Rim Software.  For the
    sake of clarity,  all references and restrictions to the use of CMT
    also apply to any and all of the associated support files (included
    with or created by) CMT.

    CMT,  its  overlays and all of its associated support files are not
    public  domain  software,  nor  are  they  free  software.  CMT  is
    copyright (c) 1988 by Crater Rim Software. All rights reserved.

    Users  are  granted  a  limited  license  to use CMT free of charge
    BUT subject to the following limitations:

        No  user  may  modify  CMT in any way,  including but not
        limited  to  decompiling,   disassembling  or   otherwise
        reverse engineering the program.

        CMT must be copied in unmodified form,  complete with the
        file containing this license information.

        Any and all CMT documentation must be included  with  the
        copy.  No  fee,  charge  or  other  compensation  may  be
        accepted or requested by any licensee.

        CMT may not be distributed in conjunction with any  other
        product   without  prior  arrangements  with  Crater  Rim
        Software.

    Operators of electronic bulletin board systems  (Sysops)  may  post
    CMT  for  downloading  by  their  users  only  as long as the above
    conditions are met and PERMISSION HAS BEEN REQUESTED AND GRANTED by
    Crater Rim Software.

    Sysops,  you are responsible for the distribution of this  package.
    If  you  have  not  complied  with  the  terms  of  this  licensing
    agreement,  apporpriate action may be taken against you  regardless
    of your system disclaimers!

    Distributors  of  public  domain  or  user  supported  software may
    distribute copies of CMT under  the  above  conditions  ONLY  AFTER
    OBTAINING  WRITTEN  PERMISSION  from  Crater  Rim  Software.   Such
    permission usually is granted.  Please write or call for details.

    Distributors,  you are responsible for  the  distribution  of  this
    package.  If you have not complied with the terms of this licensing
    agreement,  apporpriate action may be taken against you  regardless
    of your disclaimers!

                   Software Discalaimer and Warranty

    Crater  Rim  Software  makes  no  warranty of any kind,  express or
    implied,   including  without   limitation,   any   warranties   of
    merchantability  and/or  fitness  for a particular purpose.  Crater
    Rim Software shall not be liable for any damages,  whether  direct,
    indirect,  special  or consequential arising from a failure of this
    program to operate in the manner desired by the  user.  Crater  Rim
    Software  shall  not  be  liable for any damage to data or property
    which may be caused directly or indirectly by use of the program.

    IN NO EVENT WILL Crater Rim Software  BE  LIABLE  TO  YOU  FOR  ANY
    DAMAGES,   INCLUDING  ANY  LOST  PROFITS,  LOST  SAVINGS  OR  OTHER
    INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING  OUT  OF  YOUR  USE  OR
    INABILITY TO USE THE PROGRAM, OR FOR ANY CLAIM BY ANY OTHER PARTY.

                 Sal Manaro  dba  Crater Rim Softare
               4028 41st Ave South   Seattle, Wa 98118

            Courtesy of Underdog's MiniNet  [phone]
            1200/2400 (9600 soon)  24hrs   600 megs OnLine

            Please address any questions/requests to SYSOP
            on  Underdog's MiniNet  at phone number above.

= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =

Now let's get on with it!

    This utility allows you to add a Comment to your ARC files.  It  is
    a  simple,  no-nonsense  shell  which  uses  Phil  Katz'' PKARC.COM
    Utility and an external COMMENT file.  Since it does  nothing  more
    than  add  a  comment line to an ARC file,  all that is required is
    enough room for PKARC to create its working copy of the file  being
    processed (a total of twice the largest ARC file size).

    Upon  initial startup,  CMT will display an intro screen and ask if
    you wish to edit  your  information.  This  intro  screen  is  only
    displayed  upon  the  initial  startup  or  when the @ command line
    parameter is used.

    During edit,  you may bypass (without change) a particular line  by
    simply hitting [Enter].

    The information CMT requires:

      Use Color

         Setting  this  parameter  will tell CMT that it is to use
         color during its operation.  It also tells CMT to  insert
         ANSI color escape codes into the CMTS.BAT it creates. Use
         of ANSI codes within the  CMTS.BAT  requires the presence
         of ANSI.SYS (via your CONFIG.SYS file).

      ARC Utility Name

         I  rename PKARC.COM to A.COM (and PKXARC.COM to X.COM) to
         save keystrokes.  I've included this parameter so that if
         you also rename PKARC.COM,  you can tell CMT what the new
         name  is.  You  may  also include the full drive and path
         where PKARC.COM resides...  however,  if the directory in
         which  it resides is included in the DOS path,  including
         the full drive and path is not required here.

      ARC Comment Filename

         This is the name of the COMMENT file which  contains  the
         comment  that  is  to  be inserted into the processed ARC
         files. If the Comment File does not reside in the current
         logged drive/directory,  you will HAVE to supply the full
         drive and path here.

      ARC Comment Line

         This  is  the  Comment  line that you wish to me inserted
         into your ARC files.

    After  you've  edited  the  ARC Utility Name,  COMMENT filename and
    other information,  CMT will clone itself - thus retaining the  new
    information  for  future  use.  CMT will also save your new Comment
    Line  to  the  designated  drive:\path\COMMENT  file!  Lastly,  CMT
    creates  a  batch  file  called  CMTS.BAT  so  that you can process
    multiple ARC files automatically.  Upon exiting back  to  DOS,  you
    should  copy  CMT.COM,  CMTS.BAT  and  youe Comment file into their
    appropriate locations (preferably within the DOS path).

      CMT

         Starting CMT.COM  without  any  filename  parameter  will
         display a help screen with the various command formats.

      CMT @

         Starting  CMT.COM  this  way  allows  you  to  change the
         information  stored  within  CMT.COM.   If  none  of  the
         settings  are changed,  CMT will simply exit back to DOS.
         You may change the information at  any  time  using  this
         option.  CMT  will reclone itself and create whatever new
         support files have been affected by the changes.

      CMT ?

         Starting CMT.COM this way will display the current values
         of the information stored within CMT.

      CMT filename

         This is the method of  starting  CMT  when  you  want  to
         process  a  single  ARC file (where 'filename' is the ARC
         file  to  receive  the  comment).   Note  that  the  .ARC
         extension  is assumed.  If no  .ARC extension is present,
         CMT will add the extension for you. Like PKARC/PKXARC, if
         you specify a  filename  and  include  the  dot  (period)
         delimiter,  CMT  will  not add the .ARC extension to your
         input filename.  And  lastly,  you  may  specify  an  ARC
         filename  which  contains a filename extension other than
         .ARC.

      CMTS path

         If you wish to process multiple ARC files (like an entire
         directory),  start CMT via the CMTS batch file which  CMT
         creates upon startup.

         CMTS.BAT renames all *.ARC files to be processed to *.###
         then passes each .### file to CMT which, in turn, renames
         it back to .ARC and processes it.  If you are logged into
         the directory where the files to be processed reside, you
         do  not have to include a path.  If you call CMTS.BAT and
         include the path,  the  path  specification  may  be  any
         standard  variation of the path that is normally accepted
         by DOS  - However, it MUST include the trailing backslash
         (\) character.


    That's about it!  Oh,  one last note...  Since CMT performs  a  DOS
    shell  to  accomplish  its  task,  it  ASSUMES  and  REQUIRES  that
    COMMAND.COM is resident in the ROOT of your C:  drive.  I wanted to
    keep  CMT  memory  requirements  (I  run  it  in  a  150K  TaskView
    multitasking partition without problem)  to  a  minimum  and  thus,
    defaulted   COMMAND.COM   to   C:\  rather  than  doing  a  COMSPEC
    environment search.

                            Enjoy,
                               Sal Manaro