2
0
mirror of https://github.com/sudo-project/sudo.git synced 2025-08-23 02:17:35 +00:00

Refer to "syntax error" instead of "parse error".

This is the term the parser uses when there is an actual error.
This commit is contained in:
Todd C. Miller 2020-08-27 16:12:09 -06:00
parent 1b300f78de
commit 47ed1721be
4 changed files with 20 additions and 20 deletions

View File

@ -25,7 +25,7 @@
.nr BA @BAMAN@ .nr BA @BAMAN@
.nr LC @LCMAN@ .nr LC @LCMAN@
.nr PS @PSMAN@ .nr PS @PSMAN@
.TH "SUDOERS" "@mansectform@" "August 17, 2020" "Sudo @PACKAGE_VERSION@" "File Formats Manual" .TH "SUDOERS" "@mansectform@" "August 27, 2020" "Sudo @PACKAGE_VERSION@" "File Formats Manual"
.nh .nh
.if n .ad l .if n .ad l
.SH "NAME" .SH "NAME"
@ -116,14 +116,14 @@ The
\fIerror_recovery\fR \fIerror_recovery\fR
argument can be used to control whether argument can be used to control whether
\fBsudoers\fR \fBsudoers\fR
should attempt to recover from parse errors in the should attempt to recover from syntax errors in the
\fIsudoers\fR \fIsudoers\fR
file. file.
If set to If set to
\fItrue\fR \fItrue\fR
(the default), (the default),
\fBsudoers\fR \fBsudoers\fR
will try to recover from a parse error by discarding the portion will try to recover from a syntax error by discarding the portion
of the line that contains the error until the end of the line. of the line that contains the error until the end of the line.
A value of A value of
\fIfalse\fR \fIfalse\fR

View File

@ -24,7 +24,7 @@
.nr BA @BAMAN@ .nr BA @BAMAN@
.nr LC @LCMAN@ .nr LC @LCMAN@
.nr PS @PSMAN@ .nr PS @PSMAN@
.Dd August 17, 2020 .Dd August 27, 2020
.Dt SUDOERS @mansectform@ .Dt SUDOERS @mansectform@
.Os Sudo @PACKAGE_VERSION@ .Os Sudo @PACKAGE_VERSION@
.Sh NAME .Sh NAME
@ -109,14 +109,14 @@ The
.Em error_recovery .Em error_recovery
argument can be used to control whether argument can be used to control whether
.Nm .Nm
should attempt to recover from parse errors in the should attempt to recover from syntax errors in the
.Em sudoers .Em sudoers
file. file.
If set to If set to
.Em true .Em true
(the default), (the default),
.Nm .Nm
will try to recover from a parse error by discarding the portion will try to recover from a syntax error by discarding the portion
of the line that contains the error until the end of the line. of the line that contains the error until the end of the line.
A value of A value of
.Em false .Em false

View File

@ -2,7 +2,7 @@
.\" .\"
.\" SPDX-License-Identifier: ISC .\" SPDX-License-Identifier: ISC
.\" .\"
.\" Copyright (c) 1996,1998-2005, 2007-2019 .\" Copyright (c) 1996,1998-2005, 2007-2020
.\" Todd C. Miller <Todd.Miller@sudo.ws> .\" Todd C. Miller <Todd.Miller@sudo.ws>
.\" .\"
.\" Permission to use, copy, modify, and distribute this software for any .\" Permission to use, copy, modify, and distribute this software for any
@ -21,7 +21,7 @@
.\" Agency (DARPA) and Air Force Research Laboratory, Air Force .\" Agency (DARPA) and Air Force Research Laboratory, Air Force
.\" Materiel Command, USAF, under agreement number F39502-99-1-0512. .\" Materiel Command, USAF, under agreement number F39502-99-1-0512.
.\" .\"
.TH "VISUDO" "@mansectsu@" "October 20, 2019" "Sudo @PACKAGE_VERSION@" "System Manager's Manual" .TH "VISUDO" "@mansectsu@" "August 27, 2020" "Sudo @PACKAGE_VERSION@" "System Manager's Manual"
.nh .nh
.if n .ad l .if n .ad l
.SH "NAME" .SH "NAME"
@ -42,7 +42,7 @@ vipw(@mansectsu@).
locks the locks the
\fIsudoers\fR \fIsudoers\fR
file against multiple simultaneous edits, provides basic sanity checks, file against multiple simultaneous edits, provides basic sanity checks,
and checks for parse errors before installing the edited file. and checks for syntax errors before installing the edited file.
If the If the
\fIsudoers\fR \fIsudoers\fR
file is currently being edited you will receive a message to try again later. file is currently being edited you will receive a message to try again later.
@ -70,7 +70,7 @@ The
\(oqQ\(cq \(oqQ\(cq
option should be used with extreme caution because if option should be used with extreme caution because if
\fBvisudo\fR \fBvisudo\fR
believes there to be a parse error, so will believes there to be a syntax error, so will
\fBsudo\fR \fBsudo\fR
and no one will be able to run and no one will be able to run
\fBsudo\fR \fBsudo\fR
@ -79,7 +79,7 @@ If
\(oqe\(cq \(oqe\(cq
is typed to edit the is typed to edit the
\fIsudoers\fR \fIsudoers\fR
file after a parse error has been detected, the cursor will be placed on file after a syntax error has been detected, the cursor will be placed on
the line where the error occurred (if the editor supports this feature). the line where the error occurred (if the editor supports this feature).
.PP .PP
There are two There are two
@ -228,7 +228,7 @@ file.
If an alias is referenced but not actually defined If an alias is referenced but not actually defined
or if there is a cycle in an alias, or if there is a cycle in an alias,
\fBvisudo\fR \fBvisudo\fR
will consider this a parse error. will consider this a syntax error.
Note that it is not possible to differentiate between an Note that it is not possible to differentiate between an
alias and a host name or user name that consists solely of uppercase alias and a host name or user name that consists solely of uppercase
letters, digits, and the underscore letters, digits, and the underscore
@ -364,7 +364,7 @@ Default temporary file used by visudo
.SH "DIAGNOSTICS" .SH "DIAGNOSTICS"
In addition to reporting In addition to reporting
\fIsudoers\fR \fIsudoers\fR
parse errors, syntax errors,
\fBvisudo\fR \fBvisudo\fR
may produce the following messages: may produce the following messages:
.TP 6n .TP 6n

View File

@ -1,7 +1,7 @@
.\" .\"
.\" SPDX-License-Identifier: ISC .\" SPDX-License-Identifier: ISC
.\" .\"
.\" Copyright (c) 1996,1998-2005, 2007-2019 .\" Copyright (c) 1996,1998-2005, 2007-2020
.\" Todd C. Miller <Todd.Miller@sudo.ws> .\" Todd C. Miller <Todd.Miller@sudo.ws>
.\" .\"
.\" Permission to use, copy, modify, and distribute this software for any .\" Permission to use, copy, modify, and distribute this software for any
@ -20,7 +20,7 @@
.\" Agency (DARPA) and Air Force Research Laboratory, Air Force .\" Agency (DARPA) and Air Force Research Laboratory, Air Force
.\" Materiel Command, USAF, under agreement number F39502-99-1-0512. .\" Materiel Command, USAF, under agreement number F39502-99-1-0512.
.\" .\"
.Dd October 20, 2019 .Dd August 27, 2020
.Dt VISUDO @mansectsu@ .Dt VISUDO @mansectsu@
.Os Sudo @PACKAGE_VERSION@ .Os Sudo @PACKAGE_VERSION@
.Sh NAME .Sh NAME
@ -40,7 +40,7 @@ file in a safe fashion, analogous to
locks the locks the
.Em sudoers .Em sudoers
file against multiple simultaneous edits, provides basic sanity checks, file against multiple simultaneous edits, provides basic sanity checks,
and checks for parse errors before installing the edited file. and checks for syntax errors before installing the edited file.
If the If the
.Em sudoers .Em sudoers
file is currently being edited you will receive a message to try again later. file is currently being edited you will receive a message to try again later.
@ -68,7 +68,7 @@ The
.Ql Q .Ql Q
option should be used with extreme caution because if option should be used with extreme caution because if
.Nm .Nm
believes there to be a parse error, so will believes there to be a syntax error, so will
.Nm sudo .Nm sudo
and no one will be able to run and no one will be able to run
.Nm sudo .Nm sudo
@ -77,7 +77,7 @@ If
.Ql e .Ql e
is typed to edit the is typed to edit the
.Em sudoers .Em sudoers
file after a parse error has been detected, the cursor will be placed on file after a syntax error has been detected, the cursor will be placed on
the line where the error occurred (if the editor supports this feature). the line where the error occurred (if the editor supports this feature).
.Pp .Pp
There are two There are two
@ -222,7 +222,7 @@ file.
If an alias is referenced but not actually defined If an alias is referenced but not actually defined
or if there is a cycle in an alias, or if there is a cycle in an alias,
.Nm .Nm
will consider this a parse error. will consider this a syntax error.
Note that it is not possible to differentiate between an Note that it is not possible to differentiate between an
alias and a host name or user name that consists solely of uppercase alias and a host name or user name that consists solely of uppercase
letters, digits, and the underscore letters, digits, and the underscore
@ -351,7 +351,7 @@ Default temporary file used by visudo
.Sh DIAGNOSTICS .Sh DIAGNOSTICS
In addition to reporting In addition to reporting
.Em sudoers .Em sudoers
parse errors, syntax errors,
.Nm .Nm
may produce the following messages: may produce the following messages:
.Bl -tag -width 4n .Bl -tag -width 4n