[src/trunk]: src/share/man/man4 Remove Tn. Fix some mandoc lint warnings.

[wiz <wiz%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/9cd60e047c28
branches:  trunk
changeset: 358695:9cd60e047c28
user:      wiz <wiz%NetBSD.org@localhost>
date:      Sat Jan 13 23:43:46 2018 +0000

description:
Remove Tn. Fix some mandoc lint warnings.

diffstat:

 share/man/man4/acpi.4      |  238 ++++++++++++--------------------------------
 share/man/man4/bpf.4       |   44 +++----
 share/man/man4/isp.4       |   22 +--
 share/man/man4/njata.4     |    3 +-
 share/man/man4/wscons.4    |   33 +----
 share/man/man4/wsdisplay.4 |    7 +-
 6 files changed, 108 insertions(+), 239 deletions(-)

diffs (truncated from 806 to 300 lines):

diff -r b80b88bf9b7d -r 9cd60e047c28 share/man/man4/acpi.4
--- a/share/man/man4/acpi.4     Sat Jan 13 22:06:21 2018 +0000
+++ b/share/man/man4/acpi.4     Sat Jan 13 23:43:46 2018 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: acpi.4,v 1.83 2018/01/13 17:35:33 uwe Exp $
+.\" $NetBSD: acpi.4,v 1.84 2018/01/13 23:43:46 wiz Exp $
 .\"
 .\" Copyright (c) 2002, 2004, 2010 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -43,32 +43,16 @@
 .Sh DESCRIPTION
 .Nx
 provides machine-independent bus support for
-Advanced Configuration and Power Interface
-.Pq Tn ACPI
-devices and includes several
-.Tn ACPI
-device drivers.
+Advanced Configuration and Power Interface (ACPI)
+devices and includes several ACPI device drivers.
 .Pp
 The
 .Nx
-implementation of
-.Tn ACPI
-integrates Intel's ACPI Component Architecture
-.Pq Tn ACPI-CA
-for the OS-independent part.
-The
-.Tn ACPI-CA
-provides OS-neutral
-.Tn ACPI
-functionalities such as
-.Tn ACPI
-.Tn BIOS
+implementation of ACPI integrates Intel's ACPI Component Architecture
+(ACPI-CA) for the OS-independent part.
+The ACPI-CA provides OS-neutral ACPI functionalities such as ACPI BIOS
 table support,
-an
-.Tn ACPI
-event framework and an ACPI Machine Language
-.Pq Tn AML
-interpreter.
+an ACPI event framework and an ACPI Machine Language (AML) interpreter.
 .Pp
 Options:
 .Bl -tag -width ACPI_DSDT_FILE__filename_XX -offset 3n
@@ -77,19 +61,14 @@
 .It Dv ACPIVERBOSE
 Enable verbose debug messages.
 .It Dv ACPI_ACTIVATE_DEV
-Determine if the
-.Tn ACPI
-driver should attempt to activate inactive devices.
+Determine if the ACPI driver should attempt to activate inactive devices.
 The default is off.
 .It Dv ACPI_DSDT_OVERRIDE
-Force a given Differentiated System Description Table
-.Pq Tn DSDT
-instead of the version supplied by the
-.Tn BIOS .
+Force a given Differentiated System Description Table (DSDT)
+instead of the version supplied by the BIOS.
 Use
 .Dv ACPI_DSDT_FILE
-to specify a
-.Tn DSDT .
+to specify a DSDT.
 .It Dv ACPI_DSDT_FILE="filename"
 If
 .Dv ACPI_DSDT_FILE
@@ -109,13 +88,10 @@
 .Sh SYSCTL SUPPORT
 Few
 .Xr sysctl 8
-variables are directly relevant for
-.Tn ACPI .
+variables are directly relevant for ACPI.
 .Bl -tag -width "123456" -offset indent
 .It Ic hw.acpi.root
-The address of the
-.Tn ACPI
-root pointer in system memory.
+The address of the ACPI root pointer in system memory.
 .It Ic hw.acpi.sleep.state
 The system sleep state.
 .It Ic hw.acpi.sleep.states
@@ -138,8 +114,7 @@
 power off
 .El
 .It Ic hw.acpi.sleep.beep
-A boolean variable that controls whether the
-.Tn PC
+A boolean variable that controls whether the PC
 speaker beeps upon resume.
 Only available on i386 and amd64 architectures.
 .It Ic hw.acpi.sleep.vbios
@@ -147,14 +122,9 @@
 The supported values are:
 .Bl -tag -width '2' -offset 2n
 .It 0
-No attempt to reset the
-.Tn VGA
-controller will be made.
+No attempt to reset the VGA controller will be made.
 .It 1
-Call the
-.Tn VGA
-.Tn BIOS
-when still in real mode.
+Call the VGA BIOS when still in real mode.
 This can result in direct reboots.
 In that case, use
 .Sq 2
@@ -164,50 +134,32 @@
 .Pa pkgsrc/sysutils/vbetool
 package.
 .It 2
-Call the
-.Tn VGA
-.Tn BIOS
-using the in-kernel x86 emulator.
+Call the VGA BIOS using the in-kernel x86 emulator.
 .El
 .Pp
-If the system has problems in resuming from the
-.Tn S3
+If the system has problems in resuming from the S3
 state, experimenting with different values may provide a solution.
 .It Ic hw.acpi.stat.gpe
-The number of dispatched General Purpose Events
-.Pq Tn GPEs .
+The number of dispatched General Purpose Events (GPEs).
 .It Ic hw.acpi.stat.sci
-The number of System Control Interrupts
-.Pq Tn SCIs .
+The number of System Control Interrupts (SCIs).
 See
 .Xr acpiec 4
-for a brief description of both
-.Tn GPEs
-and
-.Tn SCIs .
+for a brief description of both GPEs and SCIs.
 .It Ic hw.acpi.stat.fixed
 The number of
 .Dq fixed events .
 .It Ic hw.acpi.stat.method
-The number of
-.Tn AML
-methods executed by the interpreter.
+The number of AML methods executed by the interpreter.
 .It Ic hw.acpi.power
-This read-only node describes the
-.Tn ACPI
-power state of devices.
-The values range from
-.Tn D0
+This read-only node describes the ACPI power state of devices.
+The values range from D0
 .Pq Dq on
-to
-.Tn D3
+to D3
 .Pq Dq off .
 .It Ic hw.acpi.wake
-This node represents devices that can wake the system from the
-.Tn S3
-or
-.Tn S4
-sleep state.
+This node represents devices that can wake the system from the S3 or
+S4 sleep state.
 By default,
 .Xr acpibut 4 ,
 .Xr acpilid 4 ,
@@ -218,60 +170,40 @@
 .El
 .Sh SUPPORTED DEVICES
 .Nx
-.Tn ACPI
-supports several machine-dependent and machine-independent devices,
-some specific to
-.Tn ACPI
-and some configured via it.
+ACPI supports several machine-dependent and machine-independent devices,
+some specific to ACPI and some configured via it.
 .Ss Machine-independent devices
 .Bl -tag -width "thinkpad(4) " -offset indent -compact
 .It Xr acpiacad 4
-.Tn ACPI
-AC adapters.
+ACPI AC adapters.
 .It Xr acpibat 4
-.Tn ACPI
-batteries.
+ACPI batteries.
 .It Xr acpibut 4
-.Tn ACPI
-power and sleep buttons.
+ACPI power and sleep buttons.
 .It Xr acpicpu 4
-.Tn ACPI
-processors.
+ACPI processors.
 .It Xr acpidalb 4
-.Tn ACPI
-direction application launch buttons.
+ACPI direction application launch buttons.
 .It Xr acpiec 4
-.Tn ACPI
-embedded controllers.
+ACPI embedded controllers.
 .It Xr acpiecdt 4
-.Tn ACPI
-Embedded Controller Boot Resource Table
-.Pq Tn ECDT .
+ACPI Embedded Controller Boot Resource Table (ECDT).
 .It Xr acpifan 4
-.Tn ACPI
-fans.
+ACPI fans.
 .It Xr acpilid 4
-.Tn ACPI
-lid switches.
+ACPI lid switches.
 .It Xr acpipmtr 4
-.Tn ACPI
-power meters.
+ACPI power meters.
 .It Xr acpismbus 4
-.Tn ACPI
-SMBus via control method interface
-.Pq Tn CMI .
+ACPI SMBus via control method interface (CMI).
 .It Xr acpitz 4
-.Tn ACPI
-thermal zones.
+ACPI thermal zones.
 .It Xr acpivga 4
-.Tn ACPI
-display adapter and output devices.
+ACPI display adapter and output devices.
 .It Xr acpiwmi 4
-.Tn ACPI
-support for Windows Management Instrumentation.
+ACPI support for Windows Management Instrumentation.
 .It Xr acpiwdrt 4
-.Tn ACPI
-watchdogs.
+ACPI watchdogs.
 .It Xr aibs 4
 ASUSTeK voltage, temperature and fan sensors.
 .It Xr asus 4
@@ -289,8 +221,7 @@
 .It Xr hpacel 4
 HP 3D DriveGuard accelerometer.
 .It Xr hpet 4
-High Precision Event Timer
-.Pq Tn HPET .
+High Precision Event Timer (HPET).
 .It Xr hpqlb 4
 HP Quick Launch Buttons.
 .It Xr joy 4
@@ -329,16 +260,13 @@
 .El
 .Sh DEBUGGING
 Although the situation has become better over the years,
-.Tn ACPI
-is typically prone to various errors,
+ACPI is typically prone to various errors,
 ranging from blatant flaws in the firmware to bugs in the implementation.
-Before anything else, it is a good practice to upgrade the
-.Tn BIOS
+Before anything else, it is a good practice to upgrade the BIOS
 to the latest version available from the vendor.
 .Pp
 To ease the task of diagnosing and fixing different problems, the
-.Tn ACPICA
-reference implementation provides a rich
+ACPICA reference implementation provides a rich
 facility of different debugging methods.
 In
 .Nx
@@ -364,34 +292,19 @@
 module using the option
 .Fl b Cm dump=true .
 .Ss Custom DSDT
-.Tn ACPI
-interprets bytecode known as
-.Tn ACPI
-Machine Language
-.Pq Tn AML ,
-provided by the
-.Tn BIOS
-as a memory image during the system bootstrap.
-Most of the
-.Tn AML
-relevant to