summaryrefslogtreecommitdiffstats
path: root/man/replace.1
diff options
context:
space:
mode:
Diffstat (limited to 'man/replace.1')
-rw-r--r--man/replace.1167
1 files changed, 167 insertions, 0 deletions
diff --git a/man/replace.1 b/man/replace.1
new file mode 100644
index 00000000..f5327815
--- /dev/null
+++ b/man/replace.1
@@ -0,0 +1,167 @@
+'\" t
+.\"
+.TH "\fBREPLACE\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.\" replace utility
+.\" string replacement: replace utility
+.SH "NAME"
+replace \- a string\-replacement utility
+.SH "SYNOPSIS"
+.HP \w'\fBreplace\ \fR\fB\fIarguments\fR\fR\ 'u
+\fBreplace \fR\fB\fIarguments\fR\fR
+.SH "DESCRIPTION"
+.PP
+The
+\fBreplace\fR
+utility program changes strings in place in files or on the standard input\&.
+.PP
+Invoke
+\fBreplace\fR
+in one of the following ways:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+shell> \fBreplace \fR\fB\fIfrom\fR\fR\fB \fR\fB\fIto\fR\fR\fB [\fR\fB\fIfrom\fR\fR\fB \fR\fB\fIto\fR\fR\fB] \&.\&.\&. \-\- \fR\fB\fIfile_name\fR\fR\fB [\fR\fB\fIfile_name\fR\fR\fB] \&.\&.\&.\fR
+shell> \fBreplace \fR\fB\fIfrom\fR\fR\fB \fR\fB\fIto\fR\fR\fB [\fR\fB\fIfrom\fR\fR\fB \fR\fB\fIto\fR\fR\fB] \&.\&.\&. < \fR\fB\fIfile_name\fR\fR
+.fi
+.if n \{\
+.RE
+.\}
+.PP
+\fIfrom\fR
+represents a string to look for and
+\fIto\fR
+represents its replacement\&. There can be one or more pairs of strings\&.
+.PP
+Use the
+\fB\-\-\fR
+option to indicate where the string\-replacement list ends and the file names begin\&. In this case, any file named on the command line is modified in place, so you may want to make a copy of the original before converting it\&.
+\fIreplace\fR
+prints a message indicating which of the input files it actually modifies\&.
+.PP
+If the
+\fB\-\-\fR
+option is not given,
+\fBreplace\fR
+reads the standard input and writes to the standard output\&.
+.PP
+\fBreplace\fR
+uses a finite state machine to match longer strings first\&. It can be used to swap strings\&. For example, the following command swaps
+a
+and
+b
+in the given files,
+file1
+and
+file2:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+shell> \fBreplace a b b a \-\- file1 file2 \&.\&.\&.\fR
+.fi
+.if n \{\
+.RE
+.\}
+.PP
+The
+\fBreplace\fR
+program is used by
+\fBmsql2mysql\fR\&. See
+\fBmsql2mysql\fR(1)\&.
+.PP
+\fBreplace\fR
+supports the following options\&.
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fB\-?\fR,
+\fB\-I\fR
+.sp
+Display a help message and exit\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fB\-#\fR\fB\fIdebug_options\fR\fR
+.sp
+Enable debugging\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fB\-s\fR
+.sp
+Silent mode\&. Print less information what the program does\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fB\-v\fR
+.sp
+Verbose mode\&. Print more information about what the program does\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fB\-V\fR
+.sp
+Display version information and exit\&.
+.RE
+.SH "COPYRIGHT"
+.br
+.PP
+Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2020 MariaDB Foundation
+.PP
+This documentation is free software; you can redistribute it and/or modify it only under the terms of the GNU General Public License as published by the Free Software Foundation; version 2 of the License.
+.PP
+This documentation is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
+.PP
+You should have received a copy of the GNU General Public License along with the program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1335 USA or see http://www.gnu.org/licenses/.
+.sp
+.SH "SEE ALSO"
+For more information, please refer to the MariaDB Knowledge Base, available online at https://mariadb.com/kb/
+.SH AUTHOR
+MariaDB Foundation (http://www.mariadb.org/).