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 <[email protected]>. 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 <[email protected]>. The author will try to help you out, although he may not have time to fix your problems.

COPYRIGHT

Copyright 2011, 2013 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.

RELATED TO rrep…

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.