Attachment 253709 Details for Bug 281621 – manuals: Fix typos in -offset for .Bd and .Bl

[patch] manuals: Fix typos in -offset for .Bd and .Bl

0001-manuals-Fix-typos-in-offset-for-.Bd-and-.Bl.patch (text/plain), 7.57 KB, created by Graham Percival on 2024-09-21 03:51:36 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Graham Percival

Created: 2024-09-21 03:51:36 UTC

Size: 7.57 KB

patch

obsolete

>From d5ab6cc732811bd143836a2a6a487b417fa38180 Mon Sep 17 00:00:00 2001
>From: Graham Percival <gperciva@tarsnap.com>
>Date: Fri, 20 Sep 2024 20:48:27 -0700
>Subject: [PATCH] manuals: Fix typos in -offset for .Bd and .Bl
>
>The intended value is:
>    -offset indent
>If there's any typo such that the value doesn't match the pre-defined
>strings, then the offset is the same width as the value.  So by chance,
>"-offset -ident" ends up being a standard-width indent (since the
>default indent is 6 chars, and "-ident" also has 6 chars), whereas
>"-offset -indent" has a longer indent, and "-offset ident" has a shorter
>one.
>
>Signed-off-by:	Graham Percival <gperciva@tarsnap.com>
>Sponsored by:	Tarsnap Backup Inc.
>---
> bin/sh/sh.1                      |  4 ++--
> share/man/man4/efidev.4          |  2 +-
> share/man/man4/vmd.4             |  2 +-
> share/man/man5/motd.5            |  2 +-
> share/man/man7/arch.7            |  2 +-
> share/man/man9/mbuf.9            |  2 +-
> usr.bin/bintrans/bintrans.1      |  2 +-
> usr.bin/elfctl/elfctl.1          |  4 ++--
> usr.sbin/binmiscctl/binmiscctl.8 |  4 ++--
> usr.sbin/dconschat/dconschat.8   |  2 +-
> usr.sbin/pwd_mkdb/pwd_mkdb.8     |  2 +-
> usr.sbin/service/service.8       | 16 ++++++++--------
> 12 files changed, 22 insertions(+), 22 deletions(-)
>
>diff --git a/bin/sh/sh.1 b/bin/sh/sh.1
>index 849133540cdd..1ce26ecba328 100644
>--- a/bin/sh/sh.1
>+++ b/bin/sh/sh.1
>@@ -1074,13 +1074,13 @@ command.
> Commands may be grouped by writing either
> .Pp
> .Sm off
>-.Bd -literal -offset -ident
>+.Bd -literal -offset indent
> .Po Ar list Pc
> .Ed
> .Sm on
> .Pp
> or
>-.Bd -literal -offset -ident
>+.Bd -literal -offset indent
> .No { Ar list ; }
> .Ed
> .Pp
>diff --git a/share/man/man4/efidev.4 b/share/man/man4/efidev.4
>index 684a93340d7f..defae1f31bea 100644
>--- a/share/man/man4/efidev.4
>+++ b/share/man/man4/efidev.4
>@@ -34,7 +34,7 @@
> .Sh SYNOPSIS
> To compile this driver into the kernel, place the following lines in your
> kernel configuration file:
>-.Bd -ragged -offset -indent
>+.Bd -ragged -offset indent
> .Cd "options EFIRT"
> .Ed
> .Pp
>diff --git a/share/man/man4/vmd.4 b/share/man/man4/vmd.4
>index 2d6a06bc10e3..590a368f006b 100644
>--- a/share/man/man4/vmd.4
>+++ b/share/man/man4/vmd.4
>@@ -34,7 +34,7 @@
> .Sh SYNOPSIS
> To compile this driver into the kernel, place the following lines in your
> kernel configuration file:
>-.Bd -ragged -offset -indent
>+.Bd -ragged -offset indent
> .Cd "device vmd"
> .Ed
> .Pp
>diff --git a/share/man/man5/motd.5 b/share/man/man5/motd.5
>index 86cb8f723634..5dce1ccd52ae 100644
>--- a/share/man/man5/motd.5
>+++ b/share/man/man5/motd.5
>@@ -25,7 +25,7 @@ and the contents are written to
> can be updated without a system reboot by manually restarting the
> motd service after updating
> .Pa /etc/motd.template :
>-.Bd -literal -offset -ident -compact
>+.Bd -literal -offset indent -compact
> service motd restart
> .Ed
> .Pp
>diff --git a/share/man/man7/arch.7 b/share/man/man7/arch.7
>index 21d2b156af87..3fa45af16ba6 100644
>--- a/share/man/man7/arch.7
>+++ b/share/man/man7/arch.7
>@@ -168,7 +168,7 @@ execution state, however older arm binaries are not supported by
> .Fx .
> .Pp
> On all supported architectures:
>-.Bl -column -offset -indent "long long" "Size"
>+.Bl -column -offset indent "long long" "Size"
> .It Sy Type Ta Sy Size
> .It short Ta 2
> .It int Ta 4
>diff --git a/share/man/man9/mbuf.9 b/share/man/man9/mbuf.9
>index 0b03d697b8bf..0262c598ed18 100644
>--- a/share/man/man9/mbuf.9
>+++ b/share/man/man9/mbuf.9
>@@ -1212,7 +1212,7 @@ the following
> various failure/extreme cases for testing of network drivers
> and other parts of the kernel that rely on
> .Vt mbufs .
>-.Bl -tag -width ident
>+.Bl -tag -width indent
> .It Va net.inet.ip.mbuf_frag_size
> Causes
> .Fn ip_output
>diff --git a/usr.bin/bintrans/bintrans.1 b/usr.bin/bintrans/bintrans.1
>index 16ae66aa21d1..65420075b118 100644
>--- a/usr.bin/bintrans/bintrans.1
>+++ b/usr.bin/bintrans/bintrans.1
>@@ -154,7 +154,7 @@ utility ignores any leading and trailing lines.
> .Pp
> The following options are available for
> .Nm uuencode :
>-.Bl -tag -width ident
>+.Bl -tag -width indent
> .It Fl m
> Use the Base64 method of encoding, rather than the traditional
> .Nm uuencode
>diff --git a/usr.bin/elfctl/elfctl.1 b/usr.bin/elfctl/elfctl.1
>index 2dbe04ee0ed2..5ba016b664a3 100644
>--- a/usr.bin/elfctl/elfctl.1
>+++ b/usr.bin/elfctl/elfctl.1
>@@ -87,12 +87,12 @@ elfctl -e +noaslr file
> .Ed
> .Pp
> Features may be specified as numerical values:
>-.Bd -literal -offset -indent
>+.Bd -literal -offset indent
> elfctl -e =0x0001,0x0004 file
> .Ed
> .Pp
> Features may also be specified as a single combined value:
>-.Bd -literal -offset -indent
>+.Bd -literal -offset indent
> elfctl -e =0x5 file
> .Ed
> .Sh SEE ALSO
>diff --git a/usr.sbin/binmiscctl/binmiscctl.8 b/usr.sbin/binmiscctl/binmiscctl.8
>index 4a4890146b57..17bce41a3212 100644
>--- a/usr.sbin/binmiscctl/binmiscctl.8
>+++ b/usr.sbin/binmiscctl/binmiscctl.8
>@@ -308,13 +308,13 @@ specified in the
> .Nm
> command.
> Using the example above:
>-.Bd -literal -offset -ident
>+.Bd -literal -offset indent
> mkdir $D/usr/local/bin
> cp /usr/local/bin/qemu-arm-static $D/usr/local/bin
> .Ed
> .Pp
> Now the user can chroot into the environment normally, as root:
>-.Bd -literal -offset -ident
>+.Bd -literal -offset indent
> chroot $D
> .Ed
> .Sh SEE ALSO
>diff --git a/usr.sbin/dconschat/dconschat.8 b/usr.sbin/dconschat/dconschat.8
>index 1f93e6d5a235..e2348410a04c 100644
>--- a/usr.sbin/dconschat/dconschat.8
>+++ b/usr.sbin/dconschat/dconschat.8
>@@ -110,7 +110,7 @@ A escape character (the default is
> .Ql ~
> ) appearing as the first character of a line is an escape signal; the
> following are recognized:
>-.Bl -tag -width ident
>+.Bl -tag -width indent
> .It Ic ~.
> Drop the connection and exit.
> .It Ic ~^G
>diff --git a/usr.sbin/pwd_mkdb/pwd_mkdb.8 b/usr.sbin/pwd_mkdb/pwd_mkdb.8
>index d28d5dc0ab2c..262a07f4ef3c 100644
>--- a/usr.sbin/pwd_mkdb/pwd_mkdb.8
>+++ b/usr.sbin/pwd_mkdb/pwd_mkdb.8
>@@ -139,7 +139,7 @@ A Version 7 format password file.
> .Sh EXAMPLES
> Regenerate the password database after manually editing or replacing
> the password file:
>-.Bd -literal -offset -indent
>+.Bd -literal -offset indent
> /usr/sbin/pwd_mkdb -p /etc/master.passwd
> .Ed
> .Sh COMPATIBILITY
>diff --git a/usr.sbin/service/service.8 b/usr.sbin/service/service.8
>index 2c5dfa3f3a66..380fbc8c1269 100644
>--- a/usr.sbin/service/service.8
>+++ b/usr.sbin/service/service.8
>@@ -141,39 +141,39 @@ For a full list of commands available in most rc.d scripts, see
> .Xr rc 8 .
> .Pp
> Enable a service, then start it:
>-.Bd -literal -offset -indent
>+.Bd -literal -offset indent
> service sshd enable
> service sshd start
> .Ed
> .Pp
> Stop a service, then disable it:
>-.Bd -literal -offset -indent
>+.Bd -literal -offset indent
> service sshd stop
> service sshd disable
> .Ed
> .Pp
> Start a service which is not enabled:
>-.Bd -literal -offset -indent
>+.Bd -literal -offset indent
> service sshd onestart
> .Ed
> .Pp
> Report the status of a service:
>-.Bd -literal -offset -ident
>+.Bd -literal -offset indent
> service named status
> .Ed
> .Pp
> Restart a service running in a jail:
>-.Bd -literal -offset -indent
>+.Bd -literal -offset indent
> service -j dns named restart
> .Ed
> .Pp
> Start a service with a specific environment variable set:
>-.Bd -literal -offset -indent
>+.Bd -literal -offset indent
> service -E LC_ALL=C.UTF-8 named start
> .Ed
> .Pp
> Report a verbose listing of all available services:
>-.Bd -literal -offset -indent
>+.Bd -literal -offset indent
> service -rv
> .Ed
> .Pp
>@@ -189,7 +189,7 @@ complete service 'c/-/(e l r v)/' 'p/1/`service -l`/' \e
> The following programmable completion entry can be used in
> .Xr bash 1
> for the names of the rc.d scripts:
>-.Bd -literal -offset -ident
>+.Bd -literal -offset indent
> _service () {
> 	local cur
> 	cur=${COMP_WORDS[COMP_CWORD]}
>-- 
>2.45.2
>

Actions: View | Diff

Attachments on bug 281621: 253709