NAME

       rrep - replace patterns in files.

SYNOPSIS

       rrep [OPTIONS] PATTERN REPLACEMENT [FILE...]

DESCRIPTION

       The  rrep  utility  searches input FILEs for matches to a given PATTERN and replaces those
       matches by a given REPLACEMENT.  The pattern is, by default, a basic  regular  expression.
       The  replacement string may contain special characters to refer to portions of the matched
       pattern.

       Binary files are, by default, ignored. A file is regarded as binary  if  it  contains  the
       null character.

OPTIONS

       -E, --extended-regexp
              PATTERN is interpreted as an extended regular expression (ERE).

       -F, --fixed-strings
              PATTERN   and  REPLACEMENT  are  interpreted  as  fixed  strings,  not  as  regular
              expressions or escape sequences.

       -R, -r, --recursive
              Each directory that is given on the command line is processed  recursively.   Files
              and sub-directories starting with the .  character are, by default, ignored.

       --include=FILE_PATTERN
              Only files are processed that match the pattern FILE_PATTERN, except for files that
              are specifically given on the command line.   *,  ?,  and  [...]  can  be  used  as
              wildcards  in  FILE_PATTERN.  Wildcards and backslash characters can be quoted with
              \.

       --exclude=FILE_PATTERN
              Files that match the pattern FILE_PATTERN will be skipped, except  for  files  that
              are  specifically  given  on the command line (using wildcard matching as described
              under --include).

       --exclude-dir=PATTERN
              Directories that  match  PATTERN  will  be  skipped,  except  for  files  that  are
              specifically  given on the command line (using wildcard matching as described under
              --include).

       -V, --version
              Print the version number of rrep.

       -S SUFFIX, --suffix=SUFFIX
              Override default backup suffix. This option implicitly activates backups.

       -a, --all
              Files and sub-directories starting with the . character  in  recursively  processed
              directories (see --recursive) are processed as well.

       -b     Backup before overwriting files. The backup files are written into the directory of
              the original file. Equivalent to using --backup=existing.

       --backup[=CONTROL]
              Like -b but accepts a version control argument. The file name of the backup file is
              appended  by  a  ~  character.  The backup suffix is ~, unless set with --suffix or
              SIMPLE_BACKUP_SUFFIX.  The version control method may be selected via the  --backup
              option or through the VERSION_CONTROL environment variable. Here are the values:
                none, off       never make backups
                                (even if --backup is given)
                numbered, t     make numbered backups
                existing, nil   numbered if numbered backups exist, simple
                                otherwise
                simple, never   always make simple backups

       --binary
              Do  not  ignore  binary files. A file is regarded as binary if it contains the null
              character \0.

       --dry-run
              The replacement is just simulated. No file is actually modified.

       -e PATTERN, --regexp=PATTERN
              Use PATTERN for matching. This option can be used to specify  a  pattern  beginning
              with -.

       -h, --help
              Display a help message that descibes the command line options and exit afterwards.

       -i, --ignore-case
              Case distinctions in PATTERN are ignored.

       --keep-times
              The  original  access  and modification times of files and directories are restored
              after processing.

       -p REPLACEMENT, --replace-with=REPLACEMENT
              Use REPLACEMENT for substitution.

       --interactive
              Each time before a file is modified  the  user  is  prompted  and  can  cancel  the
              modification.

       -q, --quiet, --silent
              All normal output messages are suppressed.

       -s, --no-messages
              All error messages are suppressed.

       -w, --word-regexp
              Only those matches of PATTERN are replaced that match whole words.

       -x, --line-regexp
              Only those matches of PATTERN are replaced that match whole lines.

EXIT STATUS

       Exit status is 1 if any error occurs, 0 otherwise.

AUTHOR

       Written by Arno Onken.

REPORTING BUGS

       If  you  find  a bug in rrep, please send electronic mail to <asnelt@asnelt.org>.  Include
       the version number, which you can find by running rrep --version.  Also  include  in  your
       message the output that the program produced and the output you expected.

       If  you  have  other questions, comments or suggestions about rrep, contact the author via
       electronic mail to <asnelt@asnelt.org>.  The author will try to help you out, although  he
       may not have time to fix your problems.

COPYRIGHT

       Copyright 2011 Arno Onken

       This  is  free  software; see the source for copying conditions. There is NO warranty; not
       even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

SEE ALSO

   Regular Manual Pages
       find(1), grep(1), sed(1), xargs(1), regex(7).

   TeXinfo Documentation
       The full documentation for rrep is maintained as a TeXinfo manual. If the  info  and  rrep
       programs are properly installed at your site, the command

              info rrep

       should give you access to the complete manual.