Updating man pages from Docs

Approved-by: Bjorn Munch <bjorn.munch@oracle.com>

Author: bkandasa

man/comp_err.1

@@ -2,12 +2,12 @@
 .\"     Title: \fBcomp_err\fR
 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 11/23/2019
+.\"      Date: 03/06/2020
 .\"    Manual: MySQL Database System
 .\"    Source: MySQL 8.0
 .\"  Language: English
 .\"
-.TH "\FBCOMP_ERR\FR" "1" "11/23/2019" "MySQL 8\&.0" "MySQL Database System"
+.TH "\FBCOMP_ERR\FR" "1" "03/06/2020" "MySQL 8\&.0" "MySQL Database System"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -43,20 +43,51 @@ to determine the error messages to display for different error codes\&.
 \fBcomp_err\fR
 normally is run automatically when MySQL is built\&. It compiles the
 errmsg\&.sys
-file from the text file located at
-sql/share/errmsg\-utf8\&.txt
-in MySQL source distributions\&.
+file from text\-format error information in MySQL source distributions:
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+As of MySQL 8\&.0\&.19, the error information comes from the
+messages_to_error_log\&.txt
+and
+messages_to_clients\&.txt
+files in the
+share
+directory\&.
+.sp
+For more information about defining error messages, see the comments within those files, along with the
+errmsg_readme\&.txt
+file\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Prior to MySQL 8\&.0\&.19, the error information comes from the
+errmsg\-utf8\&.txt
+file in the
+sql/share
+directory\&.
+.RE
 .PP
 \fBcomp_err\fR
-also generates
+also generates the
 mysqld_error\&.h,
 mysqld_ername\&.h, and
-sql_state\&.h
+mysqld_errmsg\&.h
 header files\&.
 .PP
-For more information about how error messages are defined, see the
-\m[blue]\fBMySQL Internals Manual\fR\m[]\&\s-2\u[1]\d\s+2\&.
-.PP
 Invoke
 \fBcomp_err\fR
 like this:
@@ -143,7 +174,22 @@ Print some debugging information when the program exits\&.
 .sp -1
 .IP \(bu 2.3
 .\}
-\fB\-\-header_file=\fR\fB\fIfile_name\fR\fR,
+\fB\-\-errmsg\-file=\fR\fB\fIfile_name\fR\fR,
+\fB\-H \fR\fB\fIfile_name\fR\fR
+.sp
+The name of the error message file\&. The default is
+mysqld_errmsg\&.h\&. This option was added in MySQL 8\&.0\&.18\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fB\-\-header\-file=\fR\fB\fIfile_name\fR\fR,
 \fB\-H \fR\fB\fIfile_name\fR\fR
 .sp
 The name of the error header file\&. The default is
@@ -158,11 +204,17 @@ mysqld_error\&.h\&.
 .sp -1
 .IP \(bu 2.3
 .\}
-\fB\-\-in_file=\fR\fB\fIfile_name\fR\fR,
+\fB\-\-in\-file=\fR\fB\fIfile_name\fR\fR,
 \fB\-F \fR\fB\fIfile_name\fR\fR
 .sp
 The name of the input file\&. The default is
-\&.\&./sql/share/errmsg\-utf8\&.txt\&.
+\&.\&./share/errmsg\-utf8\&.txt\&.
+.sp
+This option was removed in MySQL 8\&.0\&.19 and replaced by the
+\fB\-\-in\-file\-errlog\fR
+and
+\fB\-\-in\-file\-toclient\fR
+options\&.
 .RE
 .sp
 .RS 4
@@ -173,11 +225,13 @@ The name of the input file\&. The default is
 .sp -1
 .IP \(bu 2.3
 .\}
-\fB\-\-name_file=\fR\fB\fIfile_name\fR\fR,
-\fB\-N \fR\fB\fIfile_name\fR\fR
+\fB\-\-in\-file\-errlog=\fR\fB\fIfile_name\fR\fR,
+\fB\-e \fR\fB\fIfile_name\fR\fR
 .sp
-The name of the error name file\&. The default is
-mysqld_ername\&.h\&.
+The name of the input file that defines error messages intended to be written to the error log\&. The default is
+\&.\&./share/messages_to_error_log\&.txt\&.
+.sp
+This option was added in MySQL 8\&.0\&.19\&.
 .RE
 .sp
 .RS 4
@@ -188,11 +242,13 @@ mysqld_ername\&.h\&.
 .sp -1
 .IP \(bu 2.3
 .\}
-\fB\-\-out_dir=\fR\fB\fIdir_name\fR\fR,
-\fB\-D \fR\fB\fIdir_name\fR\fR
+\fB\-\-in\-file\-toclient=\fR\fB\fIfile_name\fR\fR,
+\fB\-c \fR\fB\fIfile_name\fR\fR
 .sp
-The name of the output base directory\&. The default is
-\&.\&./sql/share/\&.
+The name of the input file that defines error messages intended to be written to clients\&. The default is
+\&.\&./share/messages_to_clients\&.txt\&.
+.sp
+This option was added in MySQL 8\&.0\&.19\&.
 .RE
 .sp
 .RS 4
@@ -203,11 +259,26 @@ The name of the output base directory\&. The default is
 .sp -1
 .IP \(bu 2.3
 .\}
-\fB\-\-out_file=\fR\fB\fIfile_name\fR\fR,
-\fB\-O \fR\fB\fIfile_name\fR\fR
+\fB\-\-name\-file=\fR\fB\fIfile_name\fR\fR,
+\fB\-N \fR\fB\fIfile_name\fR\fR
 .sp
-The name of the output file\&. The default is
-errmsg\&.sys\&.
+The name of the error name file\&. The default is
+mysqld_ername\&.h\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fB\-\-out\-dir=\fR\fB\fIdir_name\fR\fR,
+\fB\-D \fR\fB\fIdir_name\fR\fR
+.sp
+The name of the output base directory\&. The default is
+\&.\&./sql/share/\&.
 .RE
 .sp
 .RS 4
@@ -218,11 +289,11 @@ errmsg\&.sys\&.
 .sp -1
 .IP \(bu 2.3
 .\}
-\fB\-\-statefile=\fR\fB\fIfile_name\fR\fR,
-\fB\-S \fR\fB\fIfile_name\fR\fR
+\fB\-\-out\-file=\fR\fB\fIfile_name\fR\fR,
+\fB\-O \fR\fB\fIfile_name\fR\fR
 .sp
-The name for the SQLSTATE header file\&. The default is
-sql_state\&.h\&.
+The name of the output file\&. The default is
+errmsg\&.sys\&.
 .RE
 .sp
 .RS 4
@@ -241,20 +312,14 @@ Display version information and exit\&.
 .SH "COPYRIGHT"
 .br
 .PP
-Copyright \(co 1997, 2019, Oracle and/or its affiliates. All rights reserved.
+Copyright \(co 1997, 2020, Oracle and/or its affiliates. All rights reserved.
 .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-1301 USA or see http://www.gnu.org/licenses/.
 .sp
-.SH "NOTES"
-.IP " 1." 4
-MySQL Internals Manual
-.RS 4
-\%https://dev.mysql.com/doc/internals/en
-.RE
 .SH "SEE ALSO"
 For more information, please refer to the MySQL Reference Manual,
 which may already be installed locally and which is also available

man/ibd2sdi.1

@@ -2,12 +2,12 @@
 .\"     Title: \fBibd2sdi\fR
 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 11/23/2019
+.\"      Date: 03/06/2020
 .\"    Manual: MySQL Database System
 .\"    Source: MySQL 8.0
 .\"  Language: English
 .\"
-.TH "\FBIBD2SDI\FR" "1" "11/23/2019" "MySQL 8\&.0" "MySQL Database System"
+.TH "\FBIBD2SDI\FR" "1" "03/06/2020" "MySQL 8\&.0" "MySQL Database System"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -102,7 +102,8 @@ The files of a multi\-file tablespace must be specified in order of the ascendin
 outputs SDI (containing id, type, and data fields) in
 JSON
 format\&.
-ibd2sdi Options.PP
+ibd2sdi Options
+.PP
 \fBibd2sdi\fR
 supports the following options:
 .sp
@@ -210,6 +211,11 @@ shell> \fBibd2sdi \-\-debug=d:t /tmp/ibd2sdi\&.trace\fR
 .if n \{\
 .RE
 .\}
+.sp
+This option is available only if MySQL was built using
+\fBWITH_DEBUG\fR\&. MySQL release binaries provided by Oracle are
+\fInot\fR
+built using this option\&.
 .RE
 .sp
 .RS 4
@@ -496,7 +502,7 @@ shell> \fBibd2sdi \-\-skip\-pretty \&.\&./data/test/t1\&.ibd\fR
 .SH "COPYRIGHT"
 .br
 .PP
-Copyright \(co 1997, 2019, Oracle and/or its affiliates. All rights reserved.
+Copyright \(co 1997, 2020, Oracle and/or its affiliates. All rights reserved.
 .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

man/innochecksum.1

@@ -2,12 +2,12 @@
 .\"     Title: \fBinnochecksum\fR
 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 11/23/2019
+.\"      Date: 03/06/2020
 .\"    Manual: MySQL Database System
 .\"    Source: MySQL 8.0
 .\"  Language: English
 .\"
-.TH "\FBINNOCHECKSUM\FR" "1" "11/23/2019" "MySQL 8\&.0" "MySQL Database System"
+.TH "\FBINNOCHECKSUM\FR" "1" "03/06/2020" "MySQL 8\&.0" "MySQL Database System"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -70,7 +70,8 @@ shell> \fBinnochecksum [\fR\fB\fIoptions\fR\fR\fB] \fR\fB\fIfile_name\fR\fR
 .RE
 .\}
 .sp
-innochecksum Options.PP
+innochecksum Options
+.PP
 \fBinnochecksum\fR
 supports the following options\&. For options that refer to page numbers, the numbers are zero\-based\&.
 .sp
@@ -839,7 +840,8 @@ shell> \fBcat t1\&.ibd | innochecksum \-\-write=crc32 \- > a\&.ibd\fR
 .RE
 .\}
 .RE
-Running innochecksum on Multiple User\-defined Tablespace Files.PP
+Running innochecksum on Multiple User\-defined Tablespace Files
+.PP
 The following examples demonstrate how to run
 \fBinnochecksum\fR
 on multiple user\-defined tablespace files (\&.ibd
@@ -928,7 +930,8 @@ cmd> innochecksum\&.exe t3\&.ibd
 .\}
 .sp .5v
 .RE
-Running innochecksum on Multiple System Tablespace Files.PP
+Running innochecksum on Multiple System Tablespace Files
+.PP
 By default, there is only one
 InnoDB
 system tablespace file (ibdata1) but multiple files for the system tablespace can be defined using the
@@ -1014,7 +1017,7 @@ cmd> innochecksum\&.exe ibdata3
 .SH "COPYRIGHT"
 .br
 .PP
-Copyright \(co 1997, 2019, Oracle and/or its affiliates. All rights reserved.
+Copyright \(co 1997, 2020, Oracle and/or its affiliates. All rights reserved.
 .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

man/lz4_decompress.1

@@ -2,12 +2,12 @@
 .\"     Title: \fBlz4_decompress\fR
 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 11/23/2019
+.\"      Date: 03/06/2020
 .\"    Manual: MySQL Database System
 .\"    Source: MySQL 8.0
 .\"  Language: English
 .\"
-.TH "\FBLZ4_DECOMPRESS\FR" "1" "11/23/2019" "MySQL 8\&.0" "MySQL Database System"
+.TH "\FBLZ4_DECOMPRESS\FR" "1" "03/06/2020" "MySQL 8\&.0" "MySQL Database System"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -101,7 +101,7 @@ ZLIB\-compressed output, use
 .SH "COPYRIGHT"
 .br
 .PP
-Copyright \(co 1997, 2019, Oracle and/or its affiliates. All rights reserved.
+Copyright \(co 1997, 2020, Oracle and/or its affiliates. All rights reserved.
 .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

man/my_print_defaults.1

@@ -2,12 +2,12 @@
 .\"     Title: \fBmy_print_defaults\fR
 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 11/23/2019
+.\"      Date: 03/06/2020
 .\"    Manual: MySQL Database System
 .\"    Source: MySQL 8.0
 .\"  Language: English
 .\"
-.TH "\FBMY_PRINT_DEFAULTS\FR" "1" "11/23/2019" "MySQL 8\&.0" "MySQL Database System"
+.TH "\FBMY_PRINT_DEFAULTS\FR" "1" "03/06/2020" "MySQL 8\&.0" "MySQL Database System"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -231,7 +231,7 @@ Display version information and exit\&.
 .SH "COPYRIGHT"
 .br
 .PP
-Copyright \(co 1997, 2019, Oracle and/or its affiliates. All rights reserved.
+Copyright \(co 1997, 2020, Oracle and/or its affiliates. All rights reserved.
 .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

man/myisam_ftdump.1

@@ -2,12 +2,12 @@
 .\"     Title: \fBmyisam_ftdump\fR
 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 11/23/2019
+.\"      Date: 03/06/2020
 .\"    Manual: MySQL Database System
 .\"    Source: MySQL 8.0
 .\"  Language: English
 .\"
-.TH "\FBMYISAM_FTDUMP\FR" "1" "11/23/2019" "MySQL 8\&.0" "MySQL Database System"
+.TH "\FBMYISAM_FTDUMP\FR" "1" "03/06/2020" "MySQL 8\&.0" "MySQL Database System"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -250,7 +250,7 @@ Verbose mode\&. Print more output about what the program does\&.
 .SH "COPYRIGHT"
 .br
 .PP
-Copyright \(co 1997, 2019, Oracle and/or its affiliates. All rights reserved.
+Copyright \(co 1997, 2020, Oracle and/or its affiliates. All rights reserved.
 .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