svn commit: r368802 - head/sbin/nvmecontrol

[Gordon Bergling]

Author: gbe (doc committer)
Date: Sat Dec 19 11:47:38 2020
New Revision: 368802
URL: https://svnweb.freebsd.org/changeset/base/368802

Log:
  nvmecontrol(8): Fix a few mandoc related issues and add a SEE ALSO section
  
  - inserting missing end of block: Ss breaks Bl
  - skipping paragraph macro: Pp before Ss
  - referenced manual not found: Xr nvme 4 (2 times)
  - unknown standard specifier: St The
  
  The macro .St can only be used for standards known by mdoc(7). So add a
  SEE ALSO section and add a reference to the NVM Express Base Specification.
  
  MFC after:	2 weeks

Modified:
  head/sbin/nvmecontrol/nvmecontrol.8

Modified: head/sbin/nvmecontrol/nvmecontrol.8
==============================================================================
--- head/sbin/nvmecontrol/nvmecontrol.8	Sat Dec 19 11:03:54 2020	(r368801)
+++ head/sbin/nvmecontrol/nvmecontrol.8	Sat Dec 19 11:47:38 2020	(r368802)
@@ -35,7 +35,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd April 30, 2020
+.Dd December 19, 2020
 .Dt NVMECONTROL 8
 .Os
 .Sh NAME
@@ -205,7 +205,6 @@
 .Sh DESCRIPTION
 NVM Express (NVMe) is a storage protocol standard, for SSDs and other
 high-speed storage devices over PCI Express.
-.Pp
 .Ss identify
 The identify commands reports information from the drive's
 .Dv IDENTIFY_CONTROLLER
@@ -238,6 +237,7 @@ of
 is used to retrieve the
 .Dv IDENTIFY_CONTROLLER
 data associated with that drive.
+.El
 .Ss logpage
 The logpage command knows how to print log pages of various types.
 It also knows about vendor specific log pages from hgst/wdc and intel.
@@ -482,9 +482,7 @@ and
 commands send NVMe commands to
 either the administrative or the data part of the device.
 These commands are expected to be compatible with nvme-cli.
-Please see
-.St The NVMe Standard
-for details.
+Please see the NVMe Standard for details.
 .Bl -tag -width 16n
 .It Fl o -opcode Ar opcode
 Opcode to send.
@@ -674,6 +672,12 @@ linker set are added to the top-level commands.
 The members of the
 .Va logpage
 linker set are added to the logpage parsers.
+.Sh SEE ALSO
+.Rs
+.%T The NVM Express Base Specification
+.%D June 10, 2019
+.%U https://nvmexpress.org/wp-content/uploads/NVM-Express-1_4-2019.06.10-Ratified.pdf
+.Re
 .Sh HISTORY
 The
 .Nm