home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: OtherApp / OtherApp.zip / hl_news.zip / zipgrep.doc < prev    next >
Text File  |  1998-11-24  |  4KB  |  89 lines
  1.  
  2. ZIPGREP(1L)                                           ZIPGREP(1L)
  3.  
  4. NAME
  5.        zipgrep - search files in a ZIP archive for lines matching
  6.        a pattern
  7.  
  8. SYNOPSIS
  9.        zipgrep [egrep_options] pattern  file[.zip]  [file(s) ...]
  10.        [-x xfile(s) ...]
  11.  
  12. DESCRIPTION
  13.        zipgrep  will  search files within a ZIP archive for lines
  14.        matching the given string or pattern.  zipgrep is a  shell
  15.        script  and  requires  egrep(1) and unzip(1L) to function.
  16.        Its output is identical to that of egrep(1).
  17.  
  18. ARGUMENTS
  19.        pattern
  20.               The pattern to be located  within  a  ZIP  archive.
  21.               Any   string  or  regular  expression  accepted  by
  22.               egrep(1) may be used.  file[.zip] Path of  the  ZIP
  23.               archive.  (Wildcard expressions for the ZIP archive
  24.               name are not supported.)  If the  literal  filename
  25.               is  not  found,  the suffix .zip is appended.  Note
  26.               that self-extracting ZIP files  are  supported,  as
  27.               with  any  other ZIP archive; just specify the .exe
  28.               suffix (if any) explicitly.
  29.  
  30.        [file(s)]
  31.               An optional list of  archive  members  to  be  pro-
  32.               cessed,  separated  by  spaces.  If no member files
  33.               are specified, all members of the ZIP  archive  are
  34.               searched.   Regular  expressions (wildcards) may be
  35.               used to match multiple members:
  36.  
  37.               *      matches a sequence of 0 or more characters
  38.  
  39.               ?      matches exactly 1 character
  40.  
  41.               [...]  matches any single  character  found  inside
  42.                      the  brackets;  ranges  are  specified  by a
  43.                      beginning character, a hyphen, and an ending
  44.                      character.   If  an  exclamation  point or a
  45.                      caret (`!' or `^') follows the left bracket,
  46.                      then  the  range  of  characters  within the
  47.                      brackets is complemented (that is,  anything
  48.                      except the characters inside the brackets is
  49.                      considered a match).
  50.  
  51.               (Be sure to quote any character that  might  other-
  52.               wise  be  interpreted  or modified by the operating
  53.               system.)
  54.  
  55.        [-x xfile(s)]
  56.               An optional list of archive members to be  excluded
  57.               from  processing.   Since wildcard characters match
  58.  
  59. Info-ZIP                 28 November 1998                       1
  60.  
  61. ZIPGREP(1L)                                           ZIPGREP(1L)
  62.  
  63.               directory separators (`/'), this option may be used
  64.               to  exclude  any  files that are in subdirectories.
  65.               For example, ``zipgrep grumpy foo *.[ch]  -x  */*''
  66.               would  search  for  the  string ``grumpy'' in all C
  67.               source files in the main directory of  the  ``foo''
  68.               archive,  but  none in any subdirectories.  Without
  69.               the -x option, all C source files in  all  directo-
  70.               ries within the zipfile would be searched.
  71.  
  72. OPTIONS
  73.        All  options  prior to the ZIP archive filename are passed
  74.        to egrep(1).
  75.  
  76. SEE ALSO
  77.        egrep(1), unzip(1L),  zip(1L),  funzip(1L),  zipcloak(1L),
  78.        zipinfo(1L), zipnote(1L), zipsplit(1L)
  79.  
  80. URL
  81.        The     Info-ZIP     home    page    is    currently    at
  82.        http://www.cdrom.com/pub/infozip/ .
  83.  
  84. AUTHORS
  85.        zipgrep was written by Jean-loup Gailly.
  86.  
  87. Info-ZIP                 28 November 1998                       2
  88.  
  89.