From a4e61cf22f1bd8d754dc71c9dc9dfdcdd88ddfb6 Mon Sep 17 00:00:00 2001 From: jsg Date: Sun, 6 Feb 2022 00:29:02 +0000 Subject: [PATCH] remove please from manual pages ok jmc@ sthen@ millert@ --- lib/libc/stdlib/atexit.3 | 6 +++--- lib/libc/sys/getentropy.2 | 6 +++--- lib/libkeynote/keynote.4 | 6 +++--- lib/libpthread/man/pthreads.3 | 6 +++--- .../man/SSL_get_ex_data_X509_STORE_CTX_idx.3 | 6 +++--- sbin/iked/iked.conf.5 | 17 ++++++++--------- sbin/isakmpd/isakmpd.conf.5 | 6 +++--- sbin/isakmpd/isakmpd.policy.5 | 6 +++--- sbin/wsconsctl/wsconsctl.8 | 6 +++--- share/man/man1/dpb.1 | 6 +++--- share/man/man4/carp.4 | 6 +++--- share/man/man4/ix.4 | 6 +++--- share/man/man4/man4.i386/pcibios.4 | 6 +++--- share/man/man4/tty.4 | 6 +++--- share/man/man7/script.7 | 6 +++--- share/man/man9/bus_space.9 | 6 +++--- usr.bin/mandoc/mandoc.1 | 6 +++--- usr.bin/skeyinit/skeyinit.1 | 6 +++--- usr.bin/ssh/ssh-keygen.1 | 16 ++++++++-------- usr.bin/ssh/ssh.1 | 6 +++--- usr.sbin/relayd/relayd.conf.5 | 6 +++--- usr.sbin/user/group.8 | 6 +++--- usr.sbin/user/user.8 | 6 +++--- 23 files changed, 79 insertions(+), 80 deletions(-) diff --git a/lib/libc/stdlib/atexit.3 b/lib/libc/stdlib/atexit.3 index a95a45b92e4..3a7e0d978a8 100644 --- a/lib/libc/stdlib/atexit.3 +++ b/lib/libc/stdlib/atexit.3 @@ -29,9 +29,9 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $OpenBSD: atexit.3,v 1.12 2019/06/27 16:30:39 schwarze Exp $ +.\" $OpenBSD: atexit.3,v 1.13 2022/02/06 00:29:02 jsg Exp $ .\" -.Dd $Mdocdate: June 27 2019 $ +.Dd $Mdocdate: February 6 2022 $ .Dt ATEXIT 3 .Os .Sh NAME @@ -68,7 +68,7 @@ that matters, not the source of the function that was registered. is very difficult to use correctly without creating .Xr exit 3 Ns -time races. -Unless absolutely necessary, please avoid using it. +Unless absolutely necessary, avoid using it. .Sh RETURN VALUES The .Nm diff --git a/lib/libc/sys/getentropy.2 b/lib/libc/sys/getentropy.2 index 234969e7a1d..3f4fb058a48 100644 --- a/lib/libc/sys/getentropy.2 +++ b/lib/libc/sys/getentropy.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getentropy.2,v 1.9 2019/09/28 14:55:12 deraadt Exp $ +.\" $OpenBSD: getentropy.2,v 1.10 2022/02/06 00:29:02 jsg Exp $ .\" .\" Copyright (c) 2014 Theo de Raadt .\" @@ -14,7 +14,7 @@ .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" -.Dd $Mdocdate: September 28 2019 $ +.Dd $Mdocdate: February 6 2022 $ .Dt GETENTROPY 2 .Os .Sh NAME @@ -33,7 +33,7 @@ as input for process-context pseudorandom generators like The maximum buffer size permitted is 256 bytes. .Pp .Fn getentropy -is not intended for regular code; please use the +is not intended for regular code; use the .Xr arc4random 3 family of functions instead. .Pp diff --git a/lib/libkeynote/keynote.4 b/lib/libkeynote/keynote.4 index aabd2db365d..d6210dc38bb 100644 --- a/lib/libkeynote/keynote.4 +++ b/lib/libkeynote/keynote.4 @@ -1,4 +1,4 @@ -.\" $OpenBSD: keynote.4,v 1.37 2021/06/12 06:39:17 jmc Exp $ +.\" $OpenBSD: keynote.4,v 1.38 2022/02/06 00:29:02 jsg Exp $ .\" .\" The author of this code is Angelos D. Keromytis (angelos@dsl.cis.upenn.edu) .\" @@ -20,7 +20,7 @@ .\" MERCHANTABILITY OF THIS SOFTWARE OR ITS FITNESS FOR ANY PARTICULAR .\" PURPOSE. .\" -.Dd $Mdocdate: June 12 2021 $ +.Dd $Mdocdate: February 6 2022 $ .Dt KEYNOTE 4 .\" .TH KeyNote 4 local .Os @@ -374,7 +374,7 @@ attribute .Sh QUERY SEMANTICS The discussion in the following sections assume some familiarity with assertion syntax. -Please refer to +Refer to .Xr keynote 5 for more details on the syntax. .Sh QUERY PARAMETERS diff --git a/lib/libpthread/man/pthreads.3 b/lib/libpthread/man/pthreads.3 index 94e86227874..cf585839665 100644 --- a/lib/libpthread/man/pthreads.3 +++ b/lib/libpthread/man/pthreads.3 @@ -1,6 +1,6 @@ -.\" $OpenBSD: pthreads.3,v 1.43 2019/02/04 18:06:32 jmc Exp $ +.\" $OpenBSD: pthreads.3,v 1.44 2022/02/06 00:29:02 jsg Exp $ .\" David Leonard , 1998. Public domain. -.Dd $Mdocdate: February 4 2019 $ +.Dd $Mdocdate: February 6 2022 $ .Dt PTHREADS 3 .Os .Sh NAME @@ -463,7 +463,7 @@ conform to .St -p1003.1-96 and various later versions of .Pq Dq Tn POSIX . -Please consult the manpages for the individual functions for details. +Consult the manpages for the individual functions for details. .Sh HISTORY This 1-to-1 implementation of the .Nm diff --git a/lib/libssl/man/SSL_get_ex_data_X509_STORE_CTX_idx.3 b/lib/libssl/man/SSL_get_ex_data_X509_STORE_CTX_idx.3 index e30e4de84fa..a249cda6ac4 100644 --- a/lib/libssl/man/SSL_get_ex_data_X509_STORE_CTX_idx.3 +++ b/lib/libssl/man/SSL_get_ex_data_X509_STORE_CTX_idx.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: SSL_get_ex_data_X509_STORE_CTX_idx.3,v 1.4 2019/06/08 15:25:43 schwarze Exp $ +.\" $OpenBSD: SSL_get_ex_data_X509_STORE_CTX_idx.3,v 1.5 2022/02/06 00:29:02 jsg Exp $ .\" OpenSSL 9b86974e Aug 17 15:21:33 2015 -0400 .\" .\" This file was written by Lutz Jaenicke . @@ -48,7 +48,7 @@ .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED .\" OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.Dd $Mdocdate: June 8 2019 $ +.Dd $Mdocdate: February 6 2022 $ .Dt SSL_GET_EX_DATA_X509_STORE_CTX_IDX 3 .Os .Sh NAME @@ -104,7 +104,7 @@ provides access to object for the connection during the .Fn verify_callback when checking the peer's certificate. -Please check the example in +Check the example in .Xr SSL_CTX_set_verify 3 . .Sh SEE ALSO .Xr CRYPTO_set_ex_data 3 , diff --git a/sbin/iked/iked.conf.5 b/sbin/iked/iked.conf.5 index 78dfbbfa1d1..7f97977ab12 100644 --- a/sbin/iked/iked.conf.5 +++ b/sbin/iked/iked.conf.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: iked.conf.5,v 1.91 2021/11/13 20:56:51 tobhe Exp $ +.\" $OpenBSD: iked.conf.5,v 1.92 2022/02/06 00:29:02 jsg Exp $ .\" .\" Copyright (c) 2010 - 2014 Reyk Floeter .\" Copyright (c) 2004 Mathieu Sauve-Frankel All rights reserved. @@ -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 $Mdocdate: November 13 2021 $ +.Dd $Mdocdate: February 6 2022 $ .Dt IKED.CONF 5 .Os .Sh NAME @@ -197,8 +197,7 @@ Enable OCSP and set the fallback URL of the OCSP responder. This fallback will be used if the trusted CA from .Pa /etc/iked/ca/ does not have an OCSP-URL extension. -Please note that the matching responder certificates -have to be placed in +The matching responder certificates have to be placed in .Pa /etc/iked/ocsp/responder.crt . .Pp The optional @@ -231,7 +230,7 @@ and the and .Ar password arguments. -Note that the password has to be specified in plain text which is +The password has to be specified in plain text which is required to support different challenge-based EAP methods like EAP-MD5 or EAP-MSCHAPv2. .El @@ -255,7 +254,7 @@ the connection, the default action is to ignore the connection attempt or to use the .Ar default policy, if set. -Please also see the +See the .Sx EXAMPLES section for a detailed example of the policy evaluation. .Pp @@ -360,7 +359,7 @@ which can be either .Ar inet or .Ar inet6 . -Note that this only matters for IKEv2 endpoints and does not +This only matters for IKEv2 endpoints and does not restrict the traffic selectors to negotiate flows with different address families, e.g. IPv6 flows negotiated by IPv4 endpoints. .Pp @@ -626,7 +625,7 @@ and .Ql G for kilo-, mega- and gigabytes accordingly. .Pp -Please note that rekeying must happen at least several times a day as +Rekeying must happen at least several times a day as IPsec security heavily depends on frequent key renewals. .Pp .It Op Ar ikeauth @@ -1028,7 +1027,7 @@ The currently supported group types are either MODP (exponentiation groups modulo a prime), ECP (elliptic curve groups modulo a prime), or Curve25519. -Please note that MODP groups of less than 2048 bits are considered +MODP groups of less than 2048 bits are considered as weak or insecure (see RFC 8247 section 2.4) and only provided for backwards compatibility. .Sh FILES diff --git a/sbin/isakmpd/isakmpd.conf.5 b/sbin/isakmpd/isakmpd.conf.5 index 4d35e162393..a1d8e782c27 100644 --- a/sbin/isakmpd/isakmpd.conf.5 +++ b/sbin/isakmpd/isakmpd.conf.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: isakmpd.conf.5,v 1.136 2021/11/03 05:59:25 yasuoka Exp $ +.\" $OpenBSD: isakmpd.conf.5,v 1.137 2022/02/06 00:29:02 jsg Exp $ .\" $EOM: isakmpd.conf.5,v 1.57 2000/12/21 14:43:17 ho Exp $ .\" .\" Copyright (c) 1998, 1999, 2000 Niklas Hallqvist. All rights reserved. @@ -28,7 +28,7 @@ .\" .\" Manual page, using -mandoc macros .\" -.Dd $Mdocdate: November 3 2021 $ +.Dd $Mdocdate: February 6 2022 $ .Dt ISAKMPD.CONF 5 .Os .Sh NAME @@ -1372,7 +1372,7 @@ LIFE_DURATION= 1000,768:1536 .Xr isakmpd 8 .Sh CAVEATS Using aggressive mode is discouraged due to various design problems. -If your peer only supports aggressive mode, please consider replacing that +If your peer only supports aggressive mode, consider replacing that peer with a sane ISAKMP/IKE implementation. For details see .Lk http://www.usenix.org/publications/login/1999-12/features/harmful.html . diff --git a/sbin/isakmpd/isakmpd.policy.5 b/sbin/isakmpd/isakmpd.policy.5 index 55fb593dfa6..0e2e6fc3244 100644 --- a/sbin/isakmpd/isakmpd.policy.5 +++ b/sbin/isakmpd/isakmpd.policy.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: isakmpd.policy.5,v 1.50 2021/10/22 16:41:47 jmc Exp $ +.\" $OpenBSD: isakmpd.policy.5,v 1.51 2022/02/06 00:29:02 jsg Exp $ .\" $EOM: isakmpd.policy.5,v 1.24 2000/11/23 12:55:25 niklas Exp $ .\" .\" Copyright (c) 1999-2001, Angelos D. Keromytis. All rights reserved. @@ -26,7 +26,7 @@ .\" .\" Manual page, using -mandoc macros .\" -.Dd $Mdocdate: October 22 2021 $ +.Dd $Mdocdate: February 6 2022 $ .Dt ISAKMPD.POLICY 5 .Os .Sh NAME @@ -143,7 +143,7 @@ SAs established from that point on (even if the associated Phase 1 SA was already established when the new policies were loaded). The policy change will not affect already established Phase 2 SAs. .Pp -For more details on KeyNote assertion format, please see +For more details on KeyNote assertion format, see .Xr keynote 5 . Briefly, KeyNote policy assertions used in IKE have the following characteristics: diff --git a/sbin/wsconsctl/wsconsctl.8 b/sbin/wsconsctl/wsconsctl.8 index f7ef41c50bd..5c4b0e8dcc4 100644 --- a/sbin/wsconsctl/wsconsctl.8 +++ b/sbin/wsconsctl/wsconsctl.8 @@ -1,4 +1,4 @@ -.\" $OpenBSD: wsconsctl.8,v 1.25 2017/05/27 10:25:44 fcambus Exp $ +.\" $OpenBSD: wsconsctl.8,v 1.26 2022/02/06 00:29:02 jsg Exp $ .\" $NetBSD: wsconsctl.8,v 1.5 1999/09/12 18:47:11 kleink Exp $ .\" .\" Copyright (c) 1998 The NetBSD Foundation, Inc. @@ -28,7 +28,7 @@ .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" POSSIBILITY OF SUCH DAMAGE. .\"/ -.Dd $Mdocdate: May 27 2017 $ +.Dd $Mdocdate: February 6 2022 $ .Dt WSCONSCTL 8 .Os .Sh NAME @@ -134,7 +134,7 @@ Modify the current keyboard encoding so that, when the key is pressed, the same encoding sequence as .Ar Left Control is sent. -For a full list of keysyms, and keycodes, please refer +For a full list of keysyms, and keycodes, refer to the .Ar /usr/include/dev/wscons/wsksymdef.h file. diff --git a/share/man/man1/dpb.1 b/share/man/man1/dpb.1 index dd8d040845a..3fedbc21aba 100644 --- a/share/man/man1/dpb.1 +++ b/share/man/man1/dpb.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: dpb.1,v 1.24 2021/05/03 07:48:16 espie Exp $ +.\" $OpenBSD: dpb.1,v 1.25 2022/02/06 00:29:02 jsg Exp $ .\" .\" Copyright (c) 2010-2013 Marc Espie .\" @@ -14,7 +14,7 @@ .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" -.Dd $Mdocdate: May 3 2021 $ +.Dd $Mdocdate: February 6 2022 $ .Dt DPB 1 .Os .Sh NAME @@ -1408,7 +1408,7 @@ affinity mismatch, but job will start on the wrong host anyways, as the queue contains no other buildable path. .El .Pp -Please note that the engine is no longer run after each package build event +The engine is no longer run after each package build event because of performance considerations, so the .Sq Q and diff --git a/share/man/man4/carp.4 b/share/man/man4/carp.4 index 1ea8d5c2dd5..981df35137d 100644 --- a/share/man/man4/carp.4 +++ b/share/man/man4/carp.4 @@ -1,4 +1,4 @@ -.\" $OpenBSD: carp.4,v 1.40 2018/01/12 04:36:44 deraadt Exp $ +.\" $OpenBSD: carp.4,v 1.41 2022/02/06 00:29:02 jsg Exp $ .\" .\" Copyright (c) 2003, Ryan McBride. All rights reserved. .\" @@ -23,7 +23,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd $Mdocdate: January 12 2018 $ +.Dd $Mdocdate: February 6 2022 $ .Dt CARP 4 .Os .Sh NAME @@ -186,7 +186,7 @@ In this mode never sends packets with its virtual MAC address as source. Stealth mode prevents a switch from learning the virtual MAC address, so that it has to flood the traffic to all its ports. -Please note that activating stealth mode on a +Activating stealth mode on a .Nm interface that has already been running might not work instantly. As a workaround the VHID of the first carpnode can be changed to a diff --git a/share/man/man4/ix.4 b/share/man/man4/ix.4 index 52557648623..64ebbc9adf9 100644 --- a/share/man/man4/ix.4 +++ b/share/man/man4/ix.4 @@ -1,4 +1,4 @@ -.\" $OpenBSD: ix.4,v 1.9 2021/09/07 19:35:41 benno Exp $ +.\" $OpenBSD: ix.4,v 1.10 2022/02/06 00:29:02 jsg Exp $ .\" .\" Copyright (c) 2008 Reyk Floeter .\" @@ -14,7 +14,7 @@ .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" -.Dd $Mdocdate: September 7 2021 $ +.Dd $Mdocdate: February 6 2022 $ .Dt IX 4 .Os .Sh NAME @@ -73,7 +73,7 @@ HotLava Tambora 64G4/80G4/64G6/120G6 (SFP+) SFP+ adapters generally also support SFP type modules with their associated 1000base-* media types. .Pp -Please note that the networking interface should be brought down before +The networking interface should be brought down before disconnecting fiber optics, otherwise irreversible damage might be caused to the equipment. .Sh SEE ALSO diff --git a/share/man/man4/man4.i386/pcibios.4 b/share/man/man4/man4.i386/pcibios.4 index 65e046317d6..186c30ae09d 100644 --- a/share/man/man4/man4.i386/pcibios.4 +++ b/share/man/man4/man4.i386/pcibios.4 @@ -1,4 +1,4 @@ -.\" $OpenBSD: pcibios.4,v 1.23 2008/07/01 04:14:57 ray Exp $ +.\" $OpenBSD: pcibios.4,v 1.24 2022/02/06 00:29:02 jsg Exp $ .\" $NetBSD: pcibios.4,v 1.7 2000/08/03 13:32:39 soda Exp $ .\" .\" Copyright (c) 2000 Michael Shalayeff, All rights reserved. @@ -29,7 +29,7 @@ .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" POSSIBILITY OF SUCH DAMAGE. .\" -.Dd $Mdocdate: July 1 2008 $ +.Dd $Mdocdate: February 6 2022 $ .Dt PCIBIOS 4 i386 .Os .Sh NAME @@ -90,7 +90,7 @@ And many BIOS implementations don't assign a bus number for CardBuses. .Pp A typical symptom of this is the following boot message: .D1 Sy cardbus0 at cardslot0: bus 0 device 0... -Please note that this cardbus0 has a bus number +This cardbus0 has a bus number .Sq 0 , but normally the bus number 0 is used by the machine's primary PCI bus. diff --git a/share/man/man4/tty.4 b/share/man/man4/tty.4 index de51cc2d5b7..2d525dc5ae7 100644 --- a/share/man/man4/tty.4 +++ b/share/man/man4/tty.4 @@ -1,4 +1,4 @@ -.\" $OpenBSD: tty.4,v 1.53 2019/09/07 10:28:27 schwarze Exp $ +.\" $OpenBSD: tty.4,v 1.54 2022/02/06 00:29:02 jsg Exp $ .\" $NetBSD: tty.4,v 1.4 1996/03/19 04:26:01 paulus Exp $ .\" .\" Copyright (c) 1991, 1992, 1993 @@ -30,7 +30,7 @@ .\" .\" @(#)tty.4 8.3 (Berkeley) 4/19/94 .\" -.Dd $Mdocdate: September 7 2019 $ +.Dd $Mdocdate: February 6 2022 $ .Dt TTY 4 .Os .Sh NAME @@ -148,7 +148,7 @@ When the line discipline is in effect, the terminal file behaves and is operated according to the rules described in .Xr termios 4 . -Please refer to that man page for a full description of the terminal +Refer to that man page for a full description of the terminal semantics. The operations described here generally represent features common diff --git a/share/man/man7/script.7 b/share/man/man7/script.7 index 80542d1f46f..0905a2b0a0e 100644 --- a/share/man/man7/script.7 +++ b/share/man/man7/script.7 @@ -1,4 +1,4 @@ -.\" $OpenBSD: script.7,v 1.8 2019/08/11 15:48:08 deraadt Exp $ +.\" $OpenBSD: script.7,v 1.9 2022/02/06 00:29:02 jsg Exp $ .\" .\" $NetBSD: script.7,v 1.1 2005/05/07 02:20:34 perry Exp $ .\" @@ -29,7 +29,7 @@ .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" POSSIBILITY OF SUCH DAMAGE. .\" -.Dd $Mdocdate: August 11 2019 $ +.Dd $Mdocdate: February 6 2022 $ .Dt SCRIPT 7 .Os .Sh NAME @@ -337,7 +337,7 @@ described is largely portable across style systems, with two significant exceptions: the maximum length of the .Sq #! line, and the behavior if multiple arguments are passed. -Please be aware that the behavior in the +Be aware that the behavior in the face of multiple arguments is not consistent across systems. .Sh HISTORY The behavior of the kernel when encountering scripts that start in diff --git a/share/man/man9/bus_space.9 b/share/man/man9/bus_space.9 index b9fc6e1c71c..58acb832e3c 100644 --- a/share/man/man9/bus_space.9 +++ b/share/man/man9/bus_space.9 @@ -1,4 +1,4 @@ -.\" $OpenBSD: bus_space.9,v 1.31 2015/09/10 15:59:18 schwarze Exp $ +.\" $OpenBSD: bus_space.9,v 1.32 2022/02/06 00:29:03 jsg Exp $ .\" $NetBSD: bus_space.9,v 1.15 2000/08/09 03:11:00 tv Exp $ .\" .\" Copyright (c) 1997 The NetBSD Foundation, Inc. @@ -28,7 +28,7 @@ .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" POSSIBILITY OF SUCH DAMAGE. .\" -.Dd $Mdocdate: September 10 2015 $ +.Dd $Mdocdate: February 6 2022 $ .Dt BUS_SPACE 9 .Os .Sh NAME @@ -1471,7 +1471,7 @@ must be a multiple of the access width or the results are undefined. .Pp In all other respects these functions are the same as their non-raw counterparts. -Please consult the documentation for those functions for further +Consult the documentation for those functions for further information. .Sh SEE ALSO .Xr bus_dma 9 diff --git a/usr.bin/mandoc/mandoc.1 b/usr.bin/mandoc/mandoc.1 index 1e8dcc4b251..df436741806 100644 --- a/usr.bin/mandoc/mandoc.1 +++ b/usr.bin/mandoc/mandoc.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: mandoc.1,v 1.179 2021/08/14 13:51:46 schwarze Exp $ +.\" $OpenBSD: mandoc.1,v 1.180 2022/02/06 00:29:03 jsg Exp $ .\" .\" Copyright (c) 2012, 2014-2021 Ingo Schwarze .\" Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons @@ -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 $Mdocdate: August 14 2021 $ +.Dd $Mdocdate: February 6 2022 $ .Dt MANDOC 1 .Os .Sh NAME @@ -835,7 +835,7 @@ message levels, the .Cm style level tries to reduce the probability that issues go unnoticed, so it may occasionally issue bogus suggestions. -Please use your good judgement to decide whether any particular +Use your judgement to decide whether any particular .Cm style suggestion really justifies a change to the input file. .It Cm base diff --git a/usr.bin/skeyinit/skeyinit.1 b/usr.bin/skeyinit/skeyinit.1 index 0e1a3060df6..537049df0bf 100644 --- a/usr.bin/skeyinit/skeyinit.1 +++ b/usr.bin/skeyinit/skeyinit.1 @@ -1,8 +1,8 @@ -.\" $OpenBSD: skeyinit.1,v 1.41 2015/10/09 21:59:34 tim Exp $ +.\" $OpenBSD: skeyinit.1,v 1.42 2022/02/06 00:29:03 jsg Exp $ .\" $NetBSD: skeyinit.1,v 1.4 1995/07/07 22:24:09 jtc Exp $ .\" @(#)skeyinit.1 1.1 10/28/93 .\" -.Dd $Mdocdate: October 9 2015 $ +.Dd $Mdocdate: February 6 2022 $ .Dt SKEYINIT 1 .Os .Sh NAME @@ -118,7 +118,7 @@ type must be specified via the .Fl a option (see above). -Please note that entering a password or passphrase in plain text +Entering a password or passphrase in plain text defeats the purpose of using .Dq secure mode. diff --git a/usr.bin/ssh/ssh-keygen.1 b/usr.bin/ssh/ssh-keygen.1 index 212e3525a25..59b7f23a1fa 100644 --- a/usr.bin/ssh/ssh-keygen.1 +++ b/usr.bin/ssh/ssh-keygen.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: ssh-keygen.1,v 1.219 2022/01/05 04:50:11 djm Exp $ +.\" $OpenBSD: ssh-keygen.1,v 1.220 2022/02/06 00:29:03 jsg Exp $ .\" .\" Author: Tatu Ylonen .\" Copyright (c) 1995 Tatu Ylonen , Espoo, Finland @@ -35,7 +35,7 @@ .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.Dd $Mdocdate: January 5 2022 $ +.Dd $Mdocdate: February 6 2022 $ .Dt SSH-KEYGEN 1 .Os .Sh NAME @@ -372,12 +372,12 @@ to use on files that mix hashed and non-hashed names. .It Fl h When signing a key, create a host certificate instead of a user certificate. -Please see the +See the .Sx CERTIFICATES section for details. .It Fl I Ar certificate_identity Specify the key identity when signing a public key. -Please see the +See the .Sx CERTIFICATES section for details. .It Fl i @@ -469,7 +469,7 @@ Provides the new passphrase. Specify one or more principals (user or host names) to be included in a certificate when signing a key. Multiple principals may be specified, separated by commas. -Please see the +See the .Sx CERTIFICATES section for details. .It Fl O Ar option @@ -534,7 +534,7 @@ but other methods may be supported in the future. .It Cm write-attestation Ns = Ns Ar path May be used at key generation time to record the attestation data returned from FIDO tokens during key generation. -Please note that this information is potentially sensitive. +This information is potentially sensitive. By default, this information is discarded. .El .Pp @@ -594,7 +594,7 @@ Print the SSHFP fingerprint resource record named for the specified public key file. .It Fl s Ar ca_key Certify (sign) a public key using the specified CA key. -Please see the +See the .Sx CERTIFICATES section for details. .Pp @@ -1059,7 +1059,7 @@ public key must be trusted by .Xr sshd 8 or .Xr ssh 1 . -Please refer to those manual pages for details. +Refer to those manual pages for details. .Sh KEY REVOCATION LISTS .Nm is able to manage OpenSSH format Key Revocation Lists (KRLs). diff --git a/usr.bin/ssh/ssh.1 b/usr.bin/ssh/ssh.1 index 6f29a067044..ce002491169 100644 --- a/usr.bin/ssh/ssh.1 +++ b/usr.bin/ssh/ssh.1 @@ -33,8 +33,8 @@ .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.\" $OpenBSD: ssh.1,v 1.428 2022/02/04 02:49:17 dtucker Exp $ -.Dd $Mdocdate: February 4 2022 $ +.\" $OpenBSD: ssh.1,v 1.429 2022/02/06 00:29:03 jsg Exp $ +.Dd $Mdocdate: February 6 2022 $ .Dt SSH 1 .Os .Sh NAME @@ -825,7 +825,7 @@ An attacker may then be able to perform activities such as keystroke monitoring. .Pp For this reason, X11 forwarding is subjected to X11 SECURITY extension restrictions by default. -Please refer to the +Refer to the .Nm .Fl Y option and the diff --git a/usr.sbin/relayd/relayd.conf.5 b/usr.sbin/relayd/relayd.conf.5 index cecbae71f87..135aaad49e0 100644 --- a/usr.sbin/relayd/relayd.conf.5 +++ b/usr.sbin/relayd/relayd.conf.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: relayd.conf.5,v 1.203 2021/01/09 08:53:58 denis Exp $ +.\" $OpenBSD: relayd.conf.5,v 1.204 2022/02/06 00:29:03 jsg Exp $ .\" .\" Copyright (c) 2006 - 2016 Reyk Floeter .\" Copyright (c) 2006, 2007 Pierre-Yves Ritschard @@ -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 $Mdocdate: January 9 2021 $ +.Dd $Mdocdate: February 6 2022 $ .Dt RELAYD.CONF 5 .Os .Sh NAME @@ -179,7 +179,7 @@ Set the global timeout in milliseconds for checks. This can be overridden by the timeout value in the table definitions. The default timeout is 200 milliseconds and it must not exceed the global interval. -Please note that the default value is optimized for checks within the +The default value is optimized for checks within the same collision domain \(en use a higher timeout, such as 1000 milliseconds, for checks of hosts in other subnets. If this option is to be set, it should be placed before overrides in tables. diff --git a/usr.sbin/user/group.8 b/usr.sbin/user/group.8 index 2b56c765917..a6d4752a66f 100644 --- a/usr.sbin/user/group.8 +++ b/usr.sbin/user/group.8 @@ -1,4 +1,4 @@ -.\" $OpenBSD: group.8,v 1.17 2016/11/29 03:59:31 jsg Exp $ +.\" $OpenBSD: group.8,v 1.18 2022/02/06 00:29:03 jsg Exp $ .\" $NetBSD: group.8,v 1.10 2003/02/25 10:36:21 wiz Exp $ .\" .\" Copyright (c) 1999 Alistair G. Crooks. All rights reserved. @@ -28,7 +28,7 @@ .\" SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" .\" -.Dd $Mdocdate: November 29 2016 $ +.Dd $Mdocdate: February 6 2022 $ .Dt GROUP 8 .Os .Sh NAME @@ -65,7 +65,7 @@ and .Xr groupdel 8 commands. .Pp -For a full explanation of the options, please see the relevant manual page. +For a full explanation of the options, see the relevant manual page. .Sh EXIT STATUS .Ex -std group .Sh SEE ALSO diff --git a/usr.sbin/user/user.8 b/usr.sbin/user/user.8 index 11f08c17240..960c664da8d 100644 --- a/usr.sbin/user/user.8 +++ b/usr.sbin/user/user.8 @@ -1,4 +1,4 @@ -.\" $OpenBSD: user.8,v 1.23 2016/11/29 03:59:31 jsg Exp $ +.\" $OpenBSD: user.8,v 1.24 2022/02/06 00:29:03 jsg Exp $ .\" $NetBSD: user.8,v 1.9 2001/06/05 11:31:21 wiz Exp $ .\" .\" Copyright (c) 1999 Alistair G. Crooks. All rights reserved. @@ -28,7 +28,7 @@ .\" SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" .\" -.Dd $Mdocdate: November 29 2016 $ +.Dd $Mdocdate: February 6 2022 $ .Dt USER 8 .Os .Sh NAME @@ -101,7 +101,7 @@ and .Xr userdel 8 commands. .Pp -For a full explanation of the options, please see the relevant manual page. +For a full explanation of the options, see the relevant manual page. .Sh FILES .Bl -tag -width /etc/usermgmt.conf -compact .It Pa /etc/skel/.[A-z]* -- 2.20.1