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.