summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorTodd C. Miller <Todd.Miller@sudo.ws>2022-02-16 12:33:32 -0700
committerTodd C. Miller <Todd.Miller@sudo.ws>2022-02-16 12:33:32 -0700
commit829d231abfe73abf2db6d86e01f35809a365eeee (patch)
treeed06e0e7aa51b2505fd7d618d5702078fe497e53
parent63d762e2c25ff3a1c5544c8bb027c23570f85e84 (diff)
downloadsudo-829d231abfe73abf2db6d86e01f35809a365eeee.tar.gz
Remove "please" from the documentation, it is considered bad style.
-rw-r--r--INSTALL.md25
-rw-r--r--README.LDAP.md10
-rw-r--r--README.md30
-rw-r--r--docs/CONTRIBUTING.md13
-rw-r--r--docs/CONTRIBUTORS.md2
-rw-r--r--docs/SECURITY.md10
-rw-r--r--docs/TROUBLESHOOTING.md4
-rw-r--r--docs/UPGRADE.md3
-rw-r--r--docs/cvtsudoers.man.in6
-rw-r--r--docs/cvtsudoers.mdoc.in6
-rw-r--r--docs/sudo.conf.man.in13
-rw-r--r--docs/sudo.conf.mdoc.in13
-rw-r--r--docs/sudo.man.in12
-rw-r--r--docs/sudo.mdoc.in12
-rw-r--r--docs/sudo_logsrv.proto.man.in6
-rw-r--r--docs/sudo_logsrv.proto.mdoc.in6
-rw-r--r--docs/sudo_logsrvd.conf.man.in6
-rw-r--r--docs/sudo_logsrvd.conf.mdoc.in6
-rw-r--r--docs/sudo_logsrvd.man.in8
-rw-r--r--docs/sudo_logsrvd.mdoc.in8
-rw-r--r--docs/sudo_plugin.man.in6
-rw-r--r--docs/sudo_plugin.mdoc.in6
-rw-r--r--docs/sudo_plugin_python.man.in13
-rw-r--r--docs/sudo_plugin_python.mdoc.in13
-rw-r--r--docs/sudo_sendlog.man.in8
-rw-r--r--docs/sudo_sendlog.mdoc.in8
-rw-r--r--docs/sudoers.ldap.man.in8
-rw-r--r--docs/sudoers.ldap.mdoc.in8
-rw-r--r--docs/sudoers.man.in16
-rw-r--r--docs/sudoers.mdoc.in16
-rw-r--r--docs/sudoers_timestamp.man.in6
-rw-r--r--docs/sudoers_timestamp.mdoc.in6
-rw-r--r--docs/sudoreplay.man.in8
-rw-r--r--docs/sudoreplay.mdoc.in8
-rw-r--r--docs/visudo.man.in8
-rw-r--r--docs/visudo.mdoc.in8
36 files changed, 168 insertions, 177 deletions
diff --git a/INSTALL.md b/INSTALL.md
index 9cd052b14..d707c33d4 100644
--- a/INSTALL.md
+++ b/INSTALL.md
@@ -4,7 +4,7 @@ Sudo installation instructions
Sudo uses a `configure` script to probe the capabilities and type of the
system in question. Sudo's `configure` script has a large number of options
that control its behavior and enable or disable optional functionality.
-Please read this document fully before configuring and building sudo.
+Be sure to read this document fully before configuring and building sudo.
You may also wish to read the file INSTALL.configure which explains more
about the `configure` script itself.
@@ -30,8 +30,8 @@ for a list of packages required to build sudo.
## Simple sudo installation
-0. If you are upgrading from a previous version of sudo please read
- the info in [docs/UPGRADE.md](docs/UPGRADE.md) before proceeding.
+0. If you are upgrading from a previous version of sudo, read
+ [docs/UPGRADE.md](docs/UPGRADE.md) before proceeding.
1. Read the "OS dependent notes" section for any particular
"gotchas" relating to your operating system.
@@ -45,8 +45,9 @@ for a list of packages required to build sudo.
4. Type `make` to compile sudo. If `configure` did its job properly (and
you have a supported configuration) there won't be any problems. If you
have a problem, check [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md)
- for tips on what might have gone wrong. Please mail us if you have a
- fix or if you are unable to come up with a fix (address at EOF).
+ for tips on what might have gone wrong. If your problem is not covered,
+ you may file a bug report at https://bugzilla.sudo.ws/ or an issue at
+ https://github.com/sudo-project/sudo/issues/ (not both).
5. Type `make install` (as root) to install sudo, visudo, the
man pages, and a skeleton sudoers file. Note that the install
@@ -352,7 +353,7 @@ Defaults are listed in brackets after the description.
--with-ldap[=DIR]
Enable LDAP support. If specified, DIR is the base directory
- containing the LDAP include and lib directories. Please see
+ containing the LDAP include and lib directories. See
[README.LDAP.md](README.LDAP.md) for more information.
--with-ldap-conf-file=PATH
@@ -391,7 +392,7 @@ Defaults are listed in brackets after the description.
This is also used to support the "log_subcmds" sudoers
setting. For example, this means that for a shell run
through sudo, the individual commands run by the shell are
- also subject to rules in the sudoers file. Please see the
+ also subject to rules in the sudoers file. See the
"Preventing Shell Escapes" section in the sudoers man page
for details. If specified, PATH should be a fully qualified
path name, e.g. /usr/local/libexec/sudo/sudo_intercept.so.
@@ -402,11 +403,11 @@ Defaults are listed in brackets after the description.
--with-noexec[=PATH]
Enable support for the "noexec" functionality which prevents
a dynamically-linked program being run by sudo from executing
- another program (think shell escapes). Please see the
- "Preventing Shell Escapes" section in the sudoers man page
- for details. If specified, PATH should be a fully qualified
- path name, e.g. /usr/local/libexec/sudo/sudo_noexec.so. If PATH
- is "no", noexec support will not be compiled in. The default
+ another program (think shell escapes). See the "Preventing
+ Shell Escapes" section in the sudoers man page for details.
+ If specified, PATH should be a fully qualified path name,
+ e.g. /usr/local/libexec/sudo/sudo_noexec.so. If PATH is
+ "no", noexec support will not be compiled in. The default
is to compile noexec support if libtool supports building
shared objects on your system.
diff --git a/README.LDAP.md b/README.LDAP.md
index dbdea773a..1e511b076 100644
--- a/README.LDAP.md
+++ b/README.LDAP.md
@@ -23,7 +23,7 @@ by synchronizing changes via CVS/RSYNC/RDIST/RCP/SCP and even NFS.
By using LDAP for sudoers we gain a centrally administered, globally
available configuration source for sudo.
-For information on OpenLDAP, please see https://www.openldap.org/.
+For information on OpenLDAP, see https://www.openldap.org/.
## Definitions
@@ -46,11 +46,11 @@ to specify them at configure time. E.g.
$ ./configure --with-ldap=/usr/local/ldapsdk
Sudo is developed using OpenLDAP but Netscape-based LDAP libraries
-(such as those present in Solaris) are also known to work.
+(such as those present in Solaris) and IBM LDAP are also known to work.
-Your mileage may vary. Please let the sudo workers mailing list
-sudo-workers@sudo.ws know if special configuration was required
-to build an LDAP-enabled sudo so we can improve sudo.
+If special configuration was required to build an LDAP-enabled sudo,
+let the sudo workers mailing list <sudo-workers@sudo.ws> know so
+we can improve sudo.
## Schema Changes
diff --git a/README.md b/README.md
index 1e2d3d0f4..04a7fb4bb 100644
--- a/README.md
+++ b/README.md
@@ -6,10 +6,9 @@ privileges as possible but still allow people to get their work done.
## Where to find sudo
-Before you try and build sudo, *please* make sure you have the current
-version. The latest sudo may always be gotten via anonymous ftp from
-ftp.sudo.ws in the directory /pub/sudo/ or from the sudo web site,
-https://www.sudo.ws/
+Before building sudo, make sure you have the current version. The
+latest sudo may always be gotten via anonymous ftp from ftp.sudo.ws
+in the directory /pub/sudo/ or from the sudo web site, https://www.sudo.ws/
The distribution is sudo-M.m.tar.gz where _M_ is the major version
number and _m_ is the minor version number. Beta versions of sudo may
@@ -23,19 +22,18 @@ a complete list of changes, see the [ChangeLog](ChangeLog).
For a summary of major changes to the current stable release, see
https://www.sudo.ws/releases/stable/.
-If you are upgrading from an earlier version of Sudo, please read
+If you are upgrading from an earlier version of Sudo, read
[docs/UPGRADE.md](docs/UPGRADE.md) for information on changes in
behavior that may affect you.
-For a history of sudo please see [docs/HISTORY.md](docs/HISTORY.md).
+For a history of sudo see [docs/HISTORY.md](docs/HISTORY.md).
You can find a list of contributors to sudo in
[docs/CONTRIBUTORS.md](docs/CONTRIBUTORS.md).
## Building the release
-Please read the installation guide, [INSTALL.md](INSTALL.md), before
-trying to build sudo. Pay special attention to the "OS dependent notes"
-section.
+Read the installation guide, [INSTALL.md](INSTALL.md), before trying
+to build sudo. Pay special attention to the "OS dependent notes" section.
## How to contribute
@@ -45,7 +43,7 @@ how you can help contribute to sudo.
## Copyright
Sudo is distributed under an ISC-style license.
-Please refer to [LICENSE.md](LICENSE.md) for details.
+Refer to [LICENSE.md](LICENSE.md) for details.
## Mailing lists
@@ -94,10 +92,10 @@ report in the sudo bug database, at https://bugzilla.sudo.ws/.
Alternately, you can file a GitHub issue if that is easier for you
at https://github.com/sudo-project/sudo/issues/.
-Please see [docs/SECURITY.md](docs/SECURITY.md) for our security
-policy and how to report security issues.
+See [docs/SECURITY.md](docs/SECURITY.md) for our security policy
+and how to report security issues.
-Please read over [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md)
-*before* submitting a bug report. When reporting bugs, please be
-sure to include the version of sudo you are using as well as the
-platform you are running it on.
+Check [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md) *before*
+submitting a bug report. When reporting bugs, be sure to include
+the version of sudo you are using as well as the platform you are
+running it on.
diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md
index d8286c777..621bfb325 100644
--- a/docs/CONTRIBUTING.md
+++ b/docs/CONTRIBUTING.md
@@ -6,7 +6,7 @@ number of way you can help make Sudo better.
## Getting started
-To get an overview of Sudo, please read the [README.md](../README.md).
+To get an overview of Sudo, see the [README.md](../README.md) file.
There are multiple ways to contribute, some of which don't require
writing a single line of code.
@@ -19,12 +19,11 @@ email, messages may be sent to the [sudo-workers@sudo.ws
mailing list](https://www.sudo.ws/mailman/listinfo/sudo-workers)
(public) or to sudo@sudo.ws (private).
-For information on reporting security issues, please see
-[SECURITY.md](SECURITY.md).
+For information on reporting security issues, see [SECURITY.md](SECURITY.md).
-Please include the version of sudo you are using, the operating
-system and/or distro that is affected, and step-by-step instructions
-to reproduce the problem.
+Include the version of sudo you are using, the operating system
+and/or distro that is affected, and, if possible, step-by-step
+instructions to reproduce the problem.
## Making changes to Sudo
@@ -66,7 +65,7 @@ For more information, see https://www.sudo.ws/security/fuzzing/.
## Translations
The Free Translation Project provides translations for Sudo. If
-you would like to contribute to Sudo's translations, please see the
+you would like to contribute to Sudo's translations, see the
ABOUT-NLS file in the Sudo source tree or visit [the Free Translation
Project's homepage](https://translationproject.org).
diff --git a/docs/CONTRIBUTORS.md b/docs/CONTRIBUTORS.md
index cebb3730a..2acbe32b1 100644
--- a/docs/CONTRIBUTORS.md
+++ b/docs/CONTRIBUTORS.md
@@ -1,7 +1,7 @@
The following list of people, sorted by last name, have contributed
code or patches to this implementation of sudo since I began
maintaining it in 1993. This list is known to be incomplete--if
-you believe you should be listed, please send a note to sudo@sudo.ws.
+you believe you should be listed, send a note to sudo@sudo.ws.
Ackeret, Matt
Adler, Mark
diff --git a/docs/SECURITY.md b/docs/SECURITY.md
index 286cdbd02..40a586bc0 100644
--- a/docs/SECURITY.md
+++ b/docs/SECURITY.md
@@ -1,17 +1,17 @@
Sudo Security Policy
====================
-The Sudo Project takes security seriously. If you believe you have found a security vulnerability in Sudo, please report it to us as described below.
+The Sudo Project takes security seriously. If you believe you have found a security vulnerability in Sudo, you can report it to us as described below.
## Reporting Security Issues
-**Please do not report security vulnerabilities through public GitHub issues or Bugzilla.**
+**Do not report security vulnerabilities through public GitHub issues or Bugzilla.**
-Instead, please report them via email to <Todd.Miller@sudo.ws>. You may encrypt your message with PGP if you would like. The current PGP key has the fingerprint 59D1 E9CC BA2B 3767 04FD D35B A9F4 C021 CEA4 70FB and may be downloaded from [the sudo.ws web site](https://www.sudo.ws/dist/PGPKEYS) or the [OpenPGP Key Server](https://keys.openpgp.org/search?q=0xa9f4c021cea470fb).
+Instead, report them via email to <Todd.Miller@sudo.ws>. You may encrypt your message with PGP if you would like. The current PGP key has the fingerprint 59D1 E9CC BA2B 3767 04FD D35B A9F4 C021 CEA4 70FB and may be downloaded from [the sudo.ws web site](https://www.sudo.ws/dist/PGPKEYS) or the [OpenPGP Key Server](https://keys.openpgp.org/search?q=0xa9f4c021cea470fb).
-We try to respond to security issues in a timely manner but please understand that Sudo is a volunteer project.
+We try to respond to security issues in a timely manner but understand that Sudo is a volunteer project.
-Please include as much of the following information as possible to help us better understand the nature and scope of the potential issue:
+Include as much of the following information as possible to help us better understand the nature and scope of the potential issue:
* Type of issue (e.g. buffer overflow, privilege escalation, etc.)
* Full paths of source file(s) related to the issue
diff --git a/docs/TROUBLESHOOTING.md b/docs/TROUBLESHOOTING.md
index f43d37c81..acc863d92 100644
--- a/docs/TROUBLESHOOTING.md
+++ b/docs/TROUBLESHOOTING.md
@@ -318,8 +318,8 @@ It just says "Sorry, try again." three times and exits.
> configure with the `--disable-pie` option, then `make clean` and
> `make`. If that fixes the problem then your operating system
> does not properly support position independent executables.
-> Please send a message to sudo@sudo.ws with system details such
-> as the Linux distro, kernel version, and CPU architecture.
+> Send a message to sudo@sudo.ws with system details such as the
+> Linux distro, kernel version, and CPU architecture.
#### When I run configure I get the following error:
diff --git a/docs/UPGRADE.md b/docs/UPGRADE.md
index f9e79be48..a39097daa 100644
--- a/docs/UPGRADE.md
+++ b/docs/UPGRADE.md
@@ -466,9 +466,6 @@ Notes on upgrading from an older release
in sudo's ldap.conf unless ldap.conf references a valid certificate
authority file(s).
- Please also see the NEWS file for a list of new features in
- sudo 1.7.0.
-
* Upgrading from a version prior to 1.6.9:
Starting with sudo 1.6.9, if an OS supports a modular authentication
diff --git a/docs/cvtsudoers.man.in b/docs/cvtsudoers.man.in
index 01a8c588c..5e65be3bf 100644
--- a/docs/cvtsudoers.man.in
+++ b/docs/cvtsudoers.man.in
@@ -16,7 +16,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.TH "CVTSUDOERS" "1" "February 10, 2022" "Sudo @PACKAGE_VERSION@" "General Commands Manual"
+.TH "CVTSUDOERS" "1" "February 16, 2022" "Sudo @PACKAGE_VERSION@" "General Commands Manual"
.nh
.if n .ad l
.SH "NAME"
@@ -620,9 +620,9 @@ distribution (https://www.sudo.ws/about/contributors/) for an
exhaustive list of people who have contributed to
\fBsudo\fR.
.SH "BUGS"
-If you feel you have found a bug in
+If you believe you have found a bug in
\fBcvtsudoers\fR,
-please submit a bug report at https://bugzilla.sudo.ws/
+you can submit a bug report at https://bugzilla.sudo.ws/
.SH "SUPPORT"
Limited free support is available via the sudo-users mailing list,
see https://www.sudo.ws/mailman/listinfo/sudo-users to subscribe or
diff --git a/docs/cvtsudoers.mdoc.in b/docs/cvtsudoers.mdoc.in
index e9250c7b0..7aa06868f 100644
--- a/docs/cvtsudoers.mdoc.in
+++ b/docs/cvtsudoers.mdoc.in
@@ -15,7 +15,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd February 10, 2022
+.Dd February 16, 2022
.Dt CVTSUDOERS 1
.Os Sudo @PACKAGE_VERSION@
.Sh NAME
@@ -534,9 +534,9 @@ distribution (https://www.sudo.ws/about/contributors/) for an
exhaustive list of people who have contributed to
.Nm sudo .
.Sh BUGS
-If you feel you have found a bug in
+If you believe you have found a bug in
.Nm ,
-please submit a bug report at https://bugzilla.sudo.ws/
+you can submit a bug report at https://bugzilla.sudo.ws/
.Sh SUPPORT
Limited free support is available via the sudo-users mailing list,
see https://www.sudo.ws/mailman/listinfo/sudo-users to subscribe or
diff --git a/docs/sudo.conf.man.in b/docs/sudo.conf.man.in
index ed39405dd..7e7059df0 100644
--- a/docs/sudo.conf.man.in
+++ b/docs/sudo.conf.man.in
@@ -17,7 +17,7 @@
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.nr SL @SEMAN@
-.TH "SUDO.CONF" "@mansectform@" "February 11, 2022" "Sudo @PACKAGE_VERSION@" "File Formats Manual"
+.TH "SUDO.CONF" "@mansectform@" "February 16, 2022" "Sudo @PACKAGE_VERSION@" "File Formats Manual"
.nh
.if n .ad l
.SH "NAME"
@@ -422,10 +422,9 @@ Set developer_mode true
.fi
.RS 10n
.sp
-Please note that this creates a security risk, so it is not recommended
-on critical systems such as a desktop machine for daily use, but is intended
-to be used in development environments (VM, container, etc).
-Before enabling developer mode, ensure you understand the implications.
+This creates a security risk and is not recommended for production systems,
+it is intended to be used in a development environment (VM, container, etc).
+Before enabling developer mode, be sure that you understand the implications.
.sp
This setting is only available in
\fBsudo\fR
@@ -892,9 +891,9 @@ distribution (https://www.sudo.ws/about/contributors/) for an
exhaustive list of people who have contributed to
\fBsudo\fR.
.SH "BUGS"
-If you feel you have found a bug in
+If you believe you have found a bug in
\fBsudo\fR,
-please submit a bug report at https://bugzilla.sudo.ws/
+you can submit a bug report at https://bugzilla.sudo.ws/
.SH "SUPPORT"
Limited free support is available via the sudo-users mailing list,
see https://www.sudo.ws/mailman/listinfo/sudo-users to subscribe or
diff --git a/docs/sudo.conf.mdoc.in b/docs/sudo.conf.mdoc.in
index f916ebfb3..9453bc5b0 100644
--- a/docs/sudo.conf.mdoc.in
+++ b/docs/sudo.conf.mdoc.in
@@ -16,7 +16,7 @@
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.nr SL @SEMAN@
-.Dd February 11, 2022
+.Dd February 16, 2022
.Dt SUDO.CONF @mansectform@
.Os Sudo @PACKAGE_VERSION@
.Sh NAME
@@ -388,10 +388,9 @@ as follows:
Set developer_mode true
.Ed
.Pp
-Please note that this creates a security risk, so it is not recommended
-on critical systems such as a desktop machine for daily use, but is intended
-to be used in development environments (VM, container, etc).
-Before enabling developer mode, ensure you understand the implications.
+This creates a security risk and is not recommended for production systems,
+it is intended to be used in a development environment (VM, container, etc).
+Before enabling developer mode, be sure that you understand the implications.
.Pp
This setting is only available in
.Nm sudo
@@ -819,9 +818,9 @@ distribution (https://www.sudo.ws/about/contributors/) for an
exhaustive list of people who have contributed to
.Nm sudo .
.Sh BUGS
-If you feel you have found a bug in
+If you believe you have found a bug in
.Nm sudo ,
-please submit a bug report at https://bugzilla.sudo.ws/
+you can submit a bug report at https://bugzilla.sudo.ws/
.Sh SUPPORT
Limited free support is available via the sudo-users mailing list,
see https://www.sudo.ws/mailman/listinfo/sudo-users to subscribe or
diff --git a/docs/sudo.man.in b/docs/sudo.man.in
index c87ed2903..8d636bb26 100644
--- a/docs/sudo.man.in
+++ b/docs/sudo.man.in
@@ -25,7 +25,7 @@
.nr BA @BAMAN@
.nr LC @LCMAN@
.nr PS @PSMAN@
-.TH "SUDO" "@mansectsu@" "February 14, 2022" "Sudo @PACKAGE_VERSION@" "System Manager's Manual"
+.TH "SUDO" "@mansectsu@" "February 16, 2022" "Sudo @PACKAGE_VERSION@" "System Manager's Manual"
.nh
.if n .ad l
.SH "NAME"
@@ -1066,7 +1066,7 @@ that reside in a directory that is writable by the user.
If the user can modify or replace the command there is no way
to limit what additional commands they can run.
.PP
-Please note that
+Note that
\fBsudo\fR
will normally only log the command it explicitly runs.
If a user runs a command such as
@@ -1084,7 +1084,7 @@ Because of this, care must be taken when giving users access to commands via
\fBsudo\fR
to verify that the command does not inadvertently give the user an
effective root shell.
-For information on ways to address this, please see the
+For information on ways to address this, see the
\fIPreventing shell escapes\fR
section in
sudoers(@mansectform@).
@@ -1496,7 +1496,7 @@ $ sudo cd /usr/local/protected
.PP
since when the command exits the parent process (your shell) will
still be the same.
-Please see the
+See the
\fIEXAMPLES\fR
section for more information.
.PP
@@ -1506,9 +1506,9 @@ can expose the same kernel bugs that make set-user-ID shell scripts
unsafe on some operating systems (if your OS has a /dev/fd/ directory,
set-user-ID shell scripts are generally safe).
.SH "BUGS"
-If you feel you have found a bug in
+If you believe you have found a bug in
\fBsudo\fR,
-please submit a bug report at https://bugzilla.sudo.ws/
+you can submit a bug report at https://bugzilla.sudo.ws/
.SH "SUPPORT"
Limited free support is available via the sudo-users mailing list,
see https://www.sudo.ws/mailman/listinfo/sudo-users to subscribe or
diff --git a/docs/sudo.mdoc.in b/docs/sudo.mdoc.in
index 1ae34f5d3..40a55b738 100644
--- a/docs/sudo.mdoc.in
+++ b/docs/sudo.mdoc.in
@@ -24,7 +24,7 @@
.nr BA @BAMAN@
.nr LC @LCMAN@
.nr PS @PSMAN@
-.Dd February 14, 2022
+.Dd February 16, 2022
.Dt SUDO @mansectsu@
.Os Sudo @PACKAGE_VERSION@
.Sh NAME
@@ -1007,7 +1007,7 @@ that reside in a directory that is writable by the user.
If the user can modify or replace the command there is no way
to limit what additional commands they can run.
.Pp
-Please note that
+Note that
.Nm
will normally only log the command it explicitly runs.
If a user runs a command such as
@@ -1025,7 +1025,7 @@ Because of this, care must be taken when giving users access to commands via
.Nm
to verify that the command does not inadvertently give the user an
effective root shell.
-For information on ways to address this, please see the
+For information on ways to address this, see the
.Em Preventing shell escapes
section in
.Xr sudoers @mansectform@ .
@@ -1383,7 +1383,7 @@ $ sudo cd /usr/local/protected
.Pp
since when the command exits the parent process (your shell) will
still be the same.
-Please see the
+See the
.Sx EXAMPLES
section for more information.
.Pp
@@ -1393,9 +1393,9 @@ can expose the same kernel bugs that make set-user-ID shell scripts
unsafe on some operating systems (if your OS has a /dev/fd/ directory,
set-user-ID shell scripts are generally safe).
.Sh BUGS
-If you feel you have found a bug in
+If you believe you have found a bug in
.Nm ,
-please submit a bug report at https://bugzilla.sudo.ws/
+you can submit a bug report at https://bugzilla.sudo.ws/
.Sh SUPPORT
Limited free support is available via the sudo-users mailing list,
see https://www.sudo.ws/mailman/listinfo/sudo-users to subscribe or
diff --git a/docs/sudo_logsrv.proto.man.in b/docs/sudo_logsrv.proto.man.in
index 9d214600a..9d662e52c 100644
--- a/docs/sudo_logsrv.proto.man.in
+++ b/docs/sudo_logsrv.proto.man.in
@@ -16,7 +16,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.TH "SUDO_LOGSRV.PROTO" "@mansectform@" "February 10, 2022" "Sudo @PACKAGE_VERSION@" "File Formats Manual"
+.TH "SUDO_LOGSRV.PROTO" "@mansectform@" "February 16, 2022" "Sudo @PACKAGE_VERSION@" "File Formats Manual"
.nh
.if n .ad l
.SH "NAME"
@@ -894,9 +894,9 @@ distribution (https://www.sudo.ws/about/contributors/) for an
exhaustive list of people who have contributed to
\fBsudo\fR.
.SH "BUGS"
-If you feel you have found a bug in
+If you believe you have found a bug in
\fBsudo\fR,
-please submit a bug report at https://bugzilla.sudo.ws/
+you can submit a bug report at https://bugzilla.sudo.ws/
.SH "SUPPORT"
Limited free support is available via the sudo-users mailing list,
see https://www.sudo.ws/mailman/listinfo/sudo-users to subscribe or
diff --git a/docs/sudo_logsrv.proto.mdoc.in b/docs/sudo_logsrv.proto.mdoc.in
index bcfb66f4a..9e64a8afb 100644
--- a/docs/sudo_logsrv.proto.mdoc.in
+++ b/docs/sudo_logsrv.proto.mdoc.in
@@ -15,7 +15,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd February 10, 2022
+.Dd February 16, 2022
.Dt SUDO_LOGSRV.PROTO @mansectform@
.Os Sudo @PACKAGE_VERSION@
.Sh NAME
@@ -811,9 +811,9 @@ distribution (https://www.sudo.ws/about/contributors/) for an
exhaustive list of people who have contributed to
.Nm sudo .
.Sh BUGS
-If you feel you have found a bug in
+If you believe you have found a bug in
.Nm sudo ,
-please submit a bug report at https://bugzilla.sudo.ws/
+you can submit a bug report at https://bugzilla.sudo.ws/
.Sh SUPPORT
Limited free support is available via the sudo-users mailing list,
see https://www.sudo.ws/mailman/listinfo/sudo-users to subscribe or
diff --git a/docs/sudo_logsrvd.conf.man.in b/docs/sudo_logsrvd.conf.man.in
index 601b4f84b..0c8be9070 100644
--- a/docs/sudo_logsrvd.conf.man.in
+++ b/docs/sudo_logsrvd.conf.man.in
@@ -16,7 +16,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.TH "SUDO_LOGSRVD.CONF" "@mansectform@" "February 12, 2022" "Sudo @PACKAGE_VERSION@" "File Formats Manual"
+.TH "SUDO_LOGSRVD.CONF" "@mansectform@" "February 16, 2022" "Sudo @PACKAGE_VERSION@" "File Formats Manual"
.nh
.if n .ad l
.SH "NAME"
@@ -1086,9 +1086,9 @@ distribution (https://www.sudo.ws/about/contributors/) for an
exhaustive list of people who have contributed to
\fBsudo\fR.
.SH "BUGS"
-If you feel you have found a bug in
+If you believe you have found a bug in
\fBsudo\fR,
-please submit a bug report at https://bugzilla.sudo.ws/
+you can submit a bug report at https://bugzilla.sudo.ws/
.SH "SUPPORT"
Limited free support is available via the sudo-users mailing list,
see https://www.sudo.ws/mailman/listinfo/sudo-users to subscribe or
diff --git a/docs/sudo_logsrvd.conf.mdoc.in b/docs/sudo_logsrvd.conf.mdoc.in
index 2d644587e..2c406b757 100644
--- a/docs/sudo_logsrvd.conf.mdoc.in
+++ b/docs/sudo_logsrvd.conf.mdoc.in
@@ -15,7 +15,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd February 12, 2022
+.Dd February 16, 2022
.Dt SUDO_LOGSRVD.CONF @mansectform@
.Os Sudo @PACKAGE_VERSION@
.Sh NAME
@@ -1010,9 +1010,9 @@ distribution (https://www.sudo.ws/about/contributors/) for an
exhaustive list of people who have contributed to
.Nm sudo .
.Sh BUGS
-If you feel you have found a bug in
+If you believe you have found a bug in
.Nm sudo ,
-please submit a bug report at https://bugzilla.sudo.ws/
+you can submit a bug report at https://bugzilla.sudo.ws/
.Sh SUPPORT
Limited free support is available via the sudo-users mailing list,
see https://www.sudo.ws/mailman/listinfo/sudo-users to subscribe or
diff --git a/docs/sudo_logsrvd.man.in b/docs/sudo_logsrvd.man.in
index 0455142bf..0a4a1ae58 100644
--- a/docs/sudo_logsrvd.man.in
+++ b/docs/sudo_logsrvd.man.in
@@ -16,7 +16,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.TH "SUDO_LOGSRVD" "@mansectsu@" "February 10, 2022" "Sudo @PACKAGE_VERSION@" "System Manager's Manual"
+.TH "SUDO_LOGSRVD" "@mansectsu@" "February 16, 2022" "Sudo @PACKAGE_VERSION@" "System Manager's Manual"
.nh
.if n .ad l
.SH "NAME"
@@ -124,7 +124,7 @@ file.
.PP
For more information on configuring
sudo.conf(@mansectform@),
-please refer to its manual.
+refer to its manual.
.SH "FILES"
.TP 26n
\fI@sysconfdir@/sudo.conf\fR
@@ -443,9 +443,9 @@ distribution (https://www.sudo.ws/about/contributors/) for an
exhaustive list of people who have contributed to
\fBsudo\fR.
.SH "BUGS"
-If you feel you have found a bug in
+If you believe you have found a bug in
\fBsudo_logsrvd\fR,
-please submit a bug report at https://bugzilla.sudo.ws/
+you can submit a bug report at https://bugzilla.sudo.ws/
.SH "SUPPORT"
Limited free support is available via the sudo-users mailing list,
see https://www.sudo.ws/mailman/listinfo/sudo-users to subscribe or
diff --git a/docs/sudo_logsrvd.mdoc.in b/docs/sudo_logsrvd.mdoc.in
index 16dba3040..c438f5a54 100644
--- a/docs/sudo_logsrvd.mdoc.in
+++ b/docs/sudo_logsrvd.mdoc.in
@@ -15,7 +15,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd February 10, 2022
+.Dd February 16, 2022
.Dt SUDO_LOGSRVD @mansectsu@
.Os Sudo @PACKAGE_VERSION@
.Sh NAME
@@ -119,7 +119,7 @@ file.
.Pp
For more information on configuring
.Xr sudo.conf @mansectform@ ,
-please refer to its manual.
+refer to its manual.
.Sh FILES
.Bl -tag -width 24n
.It Pa @sysconfdir@/sudo.conf
@@ -399,9 +399,9 @@ distribution (https://www.sudo.ws/about/contributors/) for an
exhaustive list of people who have contributed to
.Nm sudo .
.Sh BUGS
-If you feel you have found a bug in
+If you believe you have found a bug in
.Nm ,
-please submit a bug report at https://bugzilla.sudo.ws/
+you can submit a bug report at https://bugzilla.sudo.ws/
.Sh SUPPORT
Limited free support is available via the sudo-users mailing list,
see https://www.sudo.ws/mailman/listinfo/sudo-users to subscribe or
diff --git a/docs/sudo_plugin.man.in b/docs/sudo_plugin.man.in
index 8a39c4ac9..90856acb2 100644
--- a/docs/sudo_plugin.man.in
+++ b/docs/sudo_plugin.man.in
@@ -16,7 +16,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.TH "SUDO_PLUGIN" "5" "February 10, 2022" "Sudo @PACKAGE_VERSION@" "File Formats Manual"
+.TH "SUDO_PLUGIN" "5" "February 16, 2022" "Sudo @PACKAGE_VERSION@" "File Formats Manual"
.nh
.if n .ad l
.SH "NAME"
@@ -5313,9 +5313,9 @@ distribution (https://www.sudo.ws/about/contributors/) for an
exhaustive list of people who have contributed to
\fBsudo\fR.
.SH "BUGS"
-If you feel you have found a bug in
+If you believe you have found a bug in
\fBsudo\fR,
-please submit a bug report at https://bugzilla.sudo.ws/
+you can submit a bug report at https://bugzilla.sudo.ws/
.SH "SUPPORT"
Limited free support is available via the sudo-users mailing list,
see https://www.sudo.ws/mailman/listinfo/sudo-users to subscribe or
diff --git a/docs/sudo_plugin.mdoc.in b/docs/sudo_plugin.mdoc.in
index 4b0bbd7f5..dc098c33c 100644
--- a/docs/sudo_plugin.mdoc.in
+++ b/docs/sudo_plugin.mdoc.in
@@ -15,7 +15,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd February 10, 2022
+.Dd February 16, 2022
.Dt SUDO_PLUGIN @mansectform@
.Os Sudo @PACKAGE_VERSION@
.Sh NAME
@@ -4707,9 +4707,9 @@ distribution (https://www.sudo.ws/about/contributors/) for an
exhaustive list of people who have contributed to
.Nm sudo .
.Sh BUGS
-If you feel you have found a bug in
+If you believe you have found a bug in
.Nm sudo ,
-please submit a bug report at https://bugzilla.sudo.ws/
+you can submit a bug report at https://bugzilla.sudo.ws/
.Sh SUPPORT
Limited free support is available via the sudo-users mailing list,
see https://www.sudo.ws/mailman/listinfo/sudo-users to subscribe or
diff --git a/docs/sudo_plugin_python.man.in b/docs/sudo_plugin_python.man.in
index fb1f6ffa9..cea0d2e7d 100644
--- a/docs/sudo_plugin_python.man.in
+++ b/docs/sudo_plugin_python.man.in
@@ -17,7 +17,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.TH "SUDO_PLUGIN_PYTHON" "5" "February 11, 2022" "Sudo @PACKAGE_VERSION@" "File Formats Manual"
+.TH "SUDO_PLUGIN_PYTHON" "5" "February 16, 2022" "Sudo @PACKAGE_VERSION@" "File Formats Manual"
.nh
.if n .ad l
.SH "NAME"
@@ -1833,9 +1833,9 @@ exhaustive list of people who have contributed to
.SH "BUGS"
Python plugin support is currently considered experimental.
.PP
-If you feel you have found a bug in
+If you believe you have found a bug in
\fBsudo\fR,
-please submit a bug report at https://bugzilla.sudo.ws/
+you can submit a bug report at https://bugzilla.sudo.ws/
.SH "SECURITY CONSIDERATIONS"
All Python plugin handling is implemented inside the
\fRpython_plugin.so\fR
@@ -1871,10 +1871,9 @@ For example:
Set developer_mode true
.RE
.PP
-Please note that this creates a security risk, so it is not recommended
-on critical systems such as a desktop machine for daily use, but is intended
-to be used in development environments (VM, container, etc).
-Before enabling developer mode, ensure you understand the implications.
+This creates a security risk and is not recommended for production systems,
+it is intended to be used in a development environment (VM, container, etc).
+Before enabling developer mode, be sure that you understand the implications.
.SH "SUPPORT"
Limited free support is available via the sudo-users mailing list,
see https://www.sudo.ws/mailman/listinfo/sudo-users to subscribe or
diff --git a/docs/sudo_plugin_python.mdoc.in b/docs/sudo_plugin_python.mdoc.in
index 913be4b24..03b82ab27 100644
--- a/docs/sudo_plugin_python.mdoc.in
+++ b/docs/sudo_plugin_python.mdoc.in
@@ -16,7 +16,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd February 11, 2022
+.Dd February 16, 2022
.Dt SUDO_PLUGIN_PYTHON @mansectform@
.Os Sudo @PACKAGE_VERSION@
.Sh NAME
@@ -1486,9 +1486,9 @@ exhaustive list of people who have contributed to
.Sh BUGS
Python plugin support is currently considered experimental.
.Pp
-If you feel you have found a bug in
+If you believe you have found a bug in
.Nm sudo ,
-please submit a bug report at https://bugzilla.sudo.ws/
+you can submit a bug report at https://bugzilla.sudo.ws/
.Sh SECURITY CONSIDERATIONS
All Python plugin handling is implemented inside the
.Li python_plugin.so
@@ -1522,10 +1522,9 @@ option can be used to disable it.
For example:
.Dl Set developer_mode true
.Pp
-Please note that this creates a security risk, so it is not recommended
-on critical systems such as a desktop machine for daily use, but is intended
-to be used in development environments (VM, container, etc).
-Before enabling developer mode, ensure you understand the implications.
+This creates a security risk and is not recommended for production systems,
+it is intended to be used in a development environment (VM, container, etc).
+Before enabling developer mode, be sure that you understand the implications.
.Sh SUPPORT
Limited free support is available via the sudo-users mailing list,
see https://www.sudo.ws/mailman/listinfo/sudo-users to subscribe or
diff --git a/docs/sudo_sendlog.man.in b/docs/sudo_sendlog.man.in
index f348e4eb4..72e118725 100644
--- a/docs/sudo_sendlog.man.in
+++ b/docs/sudo_sendlog.man.in
@@ -16,7 +16,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.TH "SUDO_SENDLOG" "@mansectsu@" "February 10, 2022" "Sudo @PACKAGE_VERSION@" "System Manager's Manual"
+.TH "SUDO_SENDLOG" "@mansectsu@" "February 16, 2022" "Sudo @PACKAGE_VERSION@" "System Manager's Manual"
.nh
.if n .ad l
.SH "NAME"
@@ -161,7 +161,7 @@ file.
.PP
For more information on configuring
sudo.conf(@mansectform@),
-please refer to its manual.
+refer to its manual.
.SH "FILES"
.TP 26n
\fI@sysconfdir@/sudo.conf\fR
@@ -185,9 +185,9 @@ distribution (https://www.sudo.ws/about/contributors/) for an
exhaustive list of people who have contributed to
\fBsudo\fR.
.SH "BUGS"
-If you feel you have found a bug in
+If you believe you have found a bug in
\fBsudo_sendlog\fR,
-please submit a bug report at https://bugzilla.sudo.ws/
+you can submit a bug report at https://bugzilla.sudo.ws/
.SH "SUPPORT"
Limited free support is available via the sudo-users mailing list,
see https://www.sudo.ws/mailman/listinfo/sudo-users to subscribe or
diff --git a/docs/sudo_sendlog.mdoc.in b/docs/sudo_sendlog.mdoc.in
index 35c5f8830..42edb553e 100644
--- a/docs/sudo_sendlog.mdoc.in
+++ b/docs/sudo_sendlog.mdoc.in
@@ -15,7 +15,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd February 10, 2022
+.Dd February 16, 2022
.Dt SUDO_SENDLOG @mansectsu@
.Os Sudo @PACKAGE_VERSION@
.Sh NAME
@@ -146,7 +146,7 @@ file.
.Pp
For more information on configuring
.Xr sudo.conf @mansectform@ ,
-please refer to its manual.
+refer to its manual.
.Sh FILES
.Bl -tag -width 24n
.It Pa @sysconfdir@/sudo.conf
@@ -170,9 +170,9 @@ distribution (https://www.sudo.ws/about/contributors/) for an
exhaustive list of people who have contributed to
.Nm sudo .
.Sh BUGS
-If you feel you have found a bug in
+If you believe you have found a bug in
.Nm ,
-please submit a bug report at https://bugzilla.sudo.ws/
+you can submit a bug report at https://bugzilla.sudo.ws/
.Sh SUPPORT
Limited free support is available via the sudo-users mailing list,
see https://www.sudo.ws/mailman/listinfo/sudo-users to subscribe or
diff --git a/docs/sudoers.ldap.man.in b/docs/sudoers.ldap.man.in
index 795058b42..f2298b51e 100644
--- a/docs/sudoers.ldap.man.in
+++ b/docs/sudoers.ldap.man.in
@@ -16,7 +16,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.TH "SUDOERS.LDAP" "@mansectform@" "February 10, 2022" "Sudo @PACKAGE_VERSION@" "File Formats Manual"
+.TH "SUDOERS.LDAP" "@mansectform@" "February 16, 2022" "Sudo @PACKAGE_VERSION@" "File Formats Manual"
.nh
.if n .ad l
.SH "NAME"
@@ -1460,7 +1460,7 @@ Note that the
file is not used by the SSSD
\fBsudo\fR
back end.
-Please see
+See
sssd-sudo(@mansectform@)
for more information on configuring
\fBsudo\fR
@@ -1711,9 +1711,9 @@ See the
\fIDifferences between LDAP and non-LDAP sudoers\fR
section for more information.
.SH "BUGS"
-If you feel you have found a bug in
+If you believe you have found a bug in
\fBsudo\fR,
-please submit a bug report at https://bugzilla.sudo.ws/
+you can submit a bug report at https://bugzilla.sudo.ws/
.SH "SUPPORT"
Limited free support is available via the sudo-users mailing list,
see https://www.sudo.ws/mailman/listinfo/sudo-users to subscribe or
diff --git a/docs/sudoers.ldap.mdoc.in b/docs/sudoers.ldap.mdoc.in
index 0cd8af181..5496a3b64 100644
--- a/docs/sudoers.ldap.mdoc.in
+++ b/docs/sudoers.ldap.mdoc.in
@@ -15,7 +15,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd February 10, 2022
+.Dd February 16, 2022
.Dt SUDOERS.LDAP @mansectform@
.Os Sudo @PACKAGE_VERSION@
.Sh NAME
@@ -1329,7 +1329,7 @@ Note that the
file is not used by the SSSD
.Nm sudo
back end.
-Please see
+See
.Xr sssd-sudo @mansectform@
for more information on configuring
.Nm sudo
@@ -1573,9 +1573,9 @@ See the
.Sx Differences between LDAP and non-LDAP sudoers
section for more information.
.Sh BUGS
-If you feel you have found a bug in
+If you believe you have found a bug in
.Nm sudo ,
-please submit a bug report at https://bugzilla.sudo.ws/
+you can submit a bug report at https://bugzilla.sudo.ws/
.Sh SUPPORT
Limited free support is available via the sudo-users mailing list,
see https://www.sudo.ws/mailman/listinfo/sudo-users to subscribe or
diff --git a/docs/sudoers.man.in b/docs/sudoers.man.in
index 8202ee0b8..39ced2a72 100644
--- a/docs/sudoers.man.in
+++ b/docs/sudoers.man.in
@@ -50,7 +50,7 @@ section.
For information on storing
\fBsudoers\fR
policy information
-in LDAP, please see
+in LDAP, see
sudoers.ldap(@mansectform@).
.SS "Configuring sudo.conf for sudoers"
\fBsudo\fR
@@ -171,7 +171,7 @@ It should be specified as an octal value.
.PP
For more information on configuring
sudo.conf(@mansectform@),
-please refer to its manual.
+refer to its manual.
.SS "User Authentication"
The
\fBsudoers\fR
@@ -471,7 +471,7 @@ is displayed when
is run by root with the
\fB\-V\fR
option.
-Please note that the list of environment variables to remove
+Note that the list of environment variables to remove
varies based on the operating system
\fBsudo\fR
is running on.
@@ -2395,7 +2395,7 @@ Attempting to define an
named
\fBALL\fR
will result in a syntax error.
-Please note that using
+Note that using
\fBALL\fR
can be dangerous since in a command context, it allows the user to run
\fIany\fR
@@ -5719,7 +5719,7 @@ The
file has the wrong owner.
If you wish to change the
\fIsudoers\fR
-file owner, please add
+file owner, add
\(lqsudoers_uid=N\(rq
(where
\(oqN\(cq
@@ -5755,7 +5755,7 @@ The
file has the wrong group ownership.
If you wish to change the
\fIsudoers\fR
-file group ownership, please add
+file group ownership, add
\(lqsudoers_gid=N\(rq
(where
\(oqN\(cq
@@ -7269,9 +7269,9 @@ command or use the
option in
\fIsudoers\fR.
.SH "BUGS"
-If you feel you have found a bug in
+If you believe you have found a bug in
\fBsudo\fR,
-please submit a bug report at https://bugzilla.sudo.ws/
+you can submit a bug report at https://bugzilla.sudo.ws/
.SH "SUPPORT"
Limited free support is available via the sudo-users mailing list,
see https://www.sudo.ws/mailman/listinfo/sudo-users to subscribe or
diff --git a/docs/sudoers.mdoc.in b/docs/sudoers.mdoc.in
index b6870afcf..e00de1545 100644
--- a/docs/sudoers.mdoc.in
+++ b/docs/sudoers.mdoc.in
@@ -49,7 +49,7 @@ section.
For information on storing
.Nm
policy information
-in LDAP, please see
+in LDAP, see
.Xr sudoers.ldap @mansectform@ .
.Ss Configuring sudo.conf for sudoers
.Nm sudo
@@ -159,7 +159,7 @@ It should be specified as an octal value.
.Pp
For more information on configuring
.Xr sudo.conf @mansectform@ ,
-please refer to its manual.
+refer to its manual.
.Ss User Authentication
The
.Nm
@@ -457,7 +457,7 @@ is displayed when
is run by root with the
.Fl V
option.
-Please note that the list of environment variables to remove
+Note that the list of environment variables to remove
varies based on the operating system
.Nm sudo
is running on.
@@ -2261,7 +2261,7 @@ Attempting to define an
named
.Sy ALL
will result in a syntax error.
-Please note that using
+Note that using
.Sy ALL
can be dangerous since in a command context, it allows the user to run
.Em any
@@ -5336,7 +5336,7 @@ The
file has the wrong owner.
If you wish to change the
.Em sudoers
-file owner, please add
+file owner, add
.Dq sudoers_uid=N
(where
.Sq N
@@ -5370,7 +5370,7 @@ The
file has the wrong group ownership.
If you wish to change the
.Em sudoers
-file group ownership, please add
+file group ownership, add
.Dq sudoers_gid=N
(where
.Sq N
@@ -6723,9 +6723,9 @@ command or use the
option in
.Em sudoers .
.Sh BUGS
-If you feel you have found a bug in
+If you believe you have found a bug in
.Nm sudo ,
-please submit a bug report at https://bugzilla.sudo.ws/
+you can submit a bug report at https://bugzilla.sudo.ws/
.Sh SUPPORT
Limited free support is available via the sudo-users mailing list,
see https://www.sudo.ws/mailman/listinfo/sudo-users to subscribe or
diff --git a/docs/sudoers_timestamp.man.in b/docs/sudoers_timestamp.man.in
index 9a348e318..ca5c30916 100644
--- a/docs/sudoers_timestamp.man.in
+++ b/docs/sudoers_timestamp.man.in
@@ -16,7 +16,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.TH "SUDOERS_TIMESTAMP" "@mansectform@" "February 10, 2022" "Sudo @PACKAGE_VERSION@" "File Formats Manual"
+.TH "SUDOERS_TIMESTAMP" "@mansectform@" "February 16, 2022" "Sudo @PACKAGE_VERSION@" "File Formats Manual"
.nh
.if n .ad l
.SH "NAME"
@@ -293,9 +293,9 @@ distribution (https://www.sudo.ws/about/contributors/) for an
exhaustive list of people who have contributed to
\fBsudo\fR.
.SH "BUGS"
-If you feel you have found a bug in
+If you believe you have found a bug in
\fBsudo\fR,
-please submit a bug report at https://bugzilla.sudo.ws/
+you can submit a bug report at https://bugzilla.sudo.ws/
.SH "SUPPORT"
Limited free support is available via the sudo-users mailing list,
see https://www.sudo.ws/mailman/listinfo/sudo-users to subscribe or
diff --git a/docs/sudoers_timestamp.mdoc.in b/docs/sudoers_timestamp.mdoc.in
index e7106bc60..1dbfeac62 100644
--- a/docs/sudoers_timestamp.mdoc.in
+++ b/docs/sudoers_timestamp.mdoc.in
@@ -15,7 +15,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd February 10, 2022
+.Dd February 16, 2022
.Dt SUDOERS_TIMESTAMP @mansectform@
.Os Sudo @PACKAGE_VERSION@
.Sh NAME
@@ -271,9 +271,9 @@ distribution (https://www.sudo.ws/about/contributors/) for an
exhaustive list of people who have contributed to
.Nm sudo .
.Sh BUGS
-If you feel you have found a bug in
+If you believe you have found a bug in
.Nm sudo ,
-please submit a bug report at https://bugzilla.sudo.ws/
+you can submit a bug report at https://bugzilla.sudo.ws/
.Sh SUPPORT
Limited free support is available via the sudo-users mailing list,
see https://www.sudo.ws/mailman/listinfo/sudo-users to subscribe or
diff --git a/docs/sudoreplay.man.in b/docs/sudoreplay.man.in
index 3da120125..a60ddcdab 100644
--- a/docs/sudoreplay.man.in
+++ b/docs/sudoreplay.man.in
@@ -16,7 +16,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.TH "SUDOREPLAY" "@mansectsu@" "February 10, 2022" "Sudo @PACKAGE_VERSION@" "System Manager's Manual"
+.TH "SUDOREPLAY" "@mansectsu@" "February 16, 2022" "Sudo @PACKAGE_VERSION@" "System Manager's Manual"
.nh
.if n .ad l
.SH "NAME"
@@ -407,7 +407,7 @@ file.
.PP
For more information on configuring
sudo.conf(@mansectform@),
-please refer to its manual.
+refer to its manual.
.SH "FILES"
.TP 26n
\fI@sysconfdir@/sudo.conf\fR
@@ -504,9 +504,9 @@ distribution (https://www.sudo.ws/about/contributors/) for an
exhaustive list of people who have contributed to
\fBsudo\fR.
.SH "BUGS"
-If you feel you have found a bug in
+If you believe you have found a bug in
\fBsudoreplay\fR,
-please submit a bug report at https://bugzilla.sudo.ws/
+you can submit a bug report at https://bugzilla.sudo.ws/
.SH "SUPPORT"
Limited free support is available via the sudo-users mailing list,
see https://www.sudo.ws/mailman/listinfo/sudo-users to subscribe or
diff --git a/docs/sudoreplay.mdoc.in b/docs/sudoreplay.mdoc.in
index c078cb1e0..1dc0a5fcf 100644
--- a/docs/sudoreplay.mdoc.in
+++ b/docs/sudoreplay.mdoc.in
@@ -15,7 +15,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd February 10, 2022
+.Dd February 16, 2022
.Dt SUDOREPLAY @mansectsu@
.Os Sudo @PACKAGE_VERSION@
.Sh NAME
@@ -370,7 +370,7 @@ file.
.Pp
For more information on configuring
.Xr sudo.conf @mansectform@ ,
-please refer to its manual.
+refer to its manual.
.Sh FILES
.Bl -tag -width 24n
.It Pa @sysconfdir@/sudo.conf
@@ -446,9 +446,9 @@ distribution (https://www.sudo.ws/about/contributors/) for an
exhaustive list of people who have contributed to
.Nm sudo .
.Sh BUGS
-If you feel you have found a bug in
+If you believe you have found a bug in
.Nm ,
-please submit a bug report at https://bugzilla.sudo.ws/
+you can submit a bug report at https://bugzilla.sudo.ws/
.Sh SUPPORT
Limited free support is available via the sudo-users mailing list,
see https://www.sudo.ws/mailman/listinfo/sudo-users to subscribe or
diff --git a/docs/visudo.man.in b/docs/visudo.man.in
index 9a69008c0..48fa0d870 100644
--- a/docs/visudo.man.in
+++ b/docs/visudo.man.in
@@ -21,7 +21,7 @@
.\" Agency (DARPA) and Air Force Research Laboratory, Air Force
.\" Materiel Command, USAF, under agreement number F39502-99-1-0512.
.\"
-.TH "VISUDO" "@mansectsu@" "February 10, 2022" "Sudo @PACKAGE_VERSION@" "System Manager's Manual"
+.TH "VISUDO" "@mansectsu@" "February 16, 2022" "Sudo @PACKAGE_VERSION@" "System Manager's Manual"
.nh
.if n .ad l
.SH "NAME"
@@ -346,7 +346,7 @@ It should be specified as an octal value.
.PP
For more information on configuring
sudo.conf(@mansectform@),
-please refer to its manual.
+refer to its manual.
.SH "ENVIRONMENT"
The following environment variables may be consulted depending on
the value of the
@@ -481,9 +481,9 @@ the editor used by
\fBvisudo\fR
allows shell escapes.
.SH "BUGS"
-If you feel you have found a bug in
+If you believe you have found a bug in
\fBvisudo\fR,
-please submit a bug report at https://bugzilla.sudo.ws/
+you can submit a bug report at https://bugzilla.sudo.ws/
.SH "SUPPORT"
Limited free support is available via the sudo-users mailing list,
see https://www.sudo.ws/mailman/listinfo/sudo-users to subscribe or
diff --git a/docs/visudo.mdoc.in b/docs/visudo.mdoc.in
index fc3353ae6..d283733d8 100644
--- a/docs/visudo.mdoc.in
+++ b/docs/visudo.mdoc.in
@@ -20,7 +20,7 @@
.\" Agency (DARPA) and Air Force Research Laboratory, Air Force
.\" Materiel Command, USAF, under agreement number F39502-99-1-0512.
.\"
-.Dd February 10, 2022
+.Dd February 16, 2022
.Dt VISUDO @mansectsu@
.Os Sudo @PACKAGE_VERSION@
.Sh NAME
@@ -333,7 +333,7 @@ It should be specified as an octal value.
.Pp
For more information on configuring
.Xr sudo.conf @mansectform@ ,
-please refer to its manual.
+refer to its manual.
.Sh ENVIRONMENT
The following environment variables may be consulted depending on
the value of the
@@ -461,9 +461,9 @@ the editor used by
.Nm
allows shell escapes.
.Sh BUGS
-If you feel you have found a bug in
+If you believe you have found a bug in
.Nm ,
-please submit a bug report at https://bugzilla.sudo.ws/
+you can submit a bug report at https://bugzilla.sudo.ws/
.Sh SUPPORT
Limited free support is available via the sudo-users mailing list,
see https://www.sudo.ws/mailman/listinfo/sudo-users to subscribe or