home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 6 File / 06-File.zip / comnt110.zip / Comment.Txt < prev    next >
Text File  |  1996-04-04  |  3KB  |  80 lines
  1. Comment.Cmd 1.10                                            4-Apr-1996
  2.  
  3. NAME
  4.        comment - display or change file comments
  5.  
  6. SYNOPSIS
  7.        comment [options] fileSpec [comment]
  8.  
  9.        comment -d [--delete] fileSpec...
  10.  
  11. DESCRIPTION
  12.        This manual page documents Comment.Cmd.  Comment.Cmd allows you
  13.        to display or change file comments.  You can also view and edit
  14.        file comments using the WPS (open the settings notebook for the
  15.        file, and turn to the third page of the File tab).
  16.  
  17.        If `comment' is specified, it is assigned to the files matching
  18.        fileSpec.  Existing comments are not replaced unless the -f
  19.        (--force) option is given.  You should NOT put quotation marks
  20.        around the comment, unless you want them to be part of it.
  21.  
  22.        If `comment' is not specified, comments are displayed for all
  23.        files matching fileSpec.
  24.  
  25.        The `-s' (--subject) option tells Comment.Cmd to use the
  26.        subject field instead of the comments field.  In the settings
  27.        notebook, the subject field is on the first page of the File
  28.        tab.
  29.  
  30.    OPTIONS
  31.        -a, --all-files
  32.               List all files, including those without comments
  33.  
  34.        -d, --delete
  35.               Delete comments from all files matching fileSpec.
  36.               Multiple fileSpec's can be given with this option.
  37.  
  38.        -f, --force
  39.               Replace existing comments
  40.  
  41.        -q, --quiet
  42.               Do not display status messages
  43.  
  44.        -s, --subject
  45.               Manipulate the subject field instead of the comments
  46.  
  47.        -?, --help
  48.               Print a usage message on standard output and exit
  49.  
  50.        --license
  51.               Print license information on standard output and exit
  52.  
  53.        --version
  54.               Print version information on standard output and exit
  55.  
  56. BUGS
  57.        Can not display comments that span multiple lines (displays
  58.        `<Multi-line comment>' instead).
  59.  
  60. HISTORY
  61.        Version 1.10, 4-Apr-1996
  62.          Creates comments using the LP ASCII extended attribute type
  63.          instead of Multi-Value Multi-Type.  This saves a few bytes.
  64.  
  65.        Version 1.09, 14-Feb-1996
  66.          First public release
  67.  
  68. LICENSE
  69.        Comment.Cmd is distributed in the hope that it will be useful,
  70.        but WITHOUT ANY WARRANTY; without even the implied warranty of
  71.        MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  72.        GNU General Public License for more details.
  73.  
  74. AUTHOR
  75.        Christopher J. Madsen    Internet: ac608@yfn.ysu.edu
  76.        3222 Darby Ln.
  77.        Denton, TX  76207-1305
  78.  
  79. Comment.Cmd 1.10                                            4-Apr-1996
  80.