Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 20 Mar 2017 03:01:21 +0000 (UTC)
From:      Ngie Cooper <ngie@FreeBSD.org>
To:        src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-stable@freebsd.org, svn-src-stable-11@freebsd.org
Subject:   svn commit: r315607 - stable/11/lib/libcam
Message-ID:  <201703200301.v2K31L17076076@repo.freebsd.org>

next in thread | raw e-mail | index | archive | help
Author: ngie
Date: Mon Mar 20 03:01:21 2017
New Revision: 315607
URL: https://svnweb.freebsd.org/changeset/base/315607

Log:
  MFC r315202:
  
  lib/libcam/cam_cdbparse.3: fix manpage warnings
  
  - Add comma before and after 'e.g.'; remove surrounding parentheses
    that were unnecessary after this change [1].
  - Add .Mt when referencing ken and Peter Dufault's email addresses
    [2].
  - Sprinkle around .An use where proper [2].
  
  Bump .Dd for the change

Modified:
  stable/11/lib/libcam/cam_cdbparse.3
Directory Properties:
  stable/11/   (props changed)

Modified: stable/11/lib/libcam/cam_cdbparse.3
==============================================================================
--- stable/11/lib/libcam/cam_cdbparse.3	Mon Mar 20 03:00:22 2017	(r315606)
+++ stable/11/lib/libcam/cam_cdbparse.3	Mon Mar 20 03:01:21 2017	(r315607)
@@ -61,7 +61,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\"
-.Dd October 13, 1998
+.Dd March 13, 2017
 .Dt CAM_CDBPARSE 3
 .Os
 .Sh NAME
@@ -170,12 +170,11 @@ layer.
 These functions may be used in new applications, but users may find it
 easier to use the various SCSI CCB building functions included with the
 .Xr cam 3
-library.
-(e.g.\&
+library, e.g., \&
 .Fn cam_fill_csio ,
 .Fn scsi_start_stop ,
 and
-.Fn scsi_read_write )
+.Fn scsi_read_write .
 .Pp
 .Fn csio_build
 builds up a
@@ -522,17 +521,18 @@ implemented for the old
 layer.
 The encoding/decoding functions in the old
 .Tn SCSI
-code were written by Peter Dufault.
+code were written by
+.An Peter Dufault Aq Mt dufault@hda.com .
 .Pp
 Many systems have comparable interfaces to permit a user to construct a
 SCSI command in user space.
 .Pp
 The old
 .Va scsireq
-data structure was almost identical to the SGI /dev/scsi data
-structure.
-If anyone knows the name of the authors it should
-go here; Peter Dufault first read about it in a 1989 Sun Expert magazine.
+data structure was almost identical to the SGI /dev/scsi data structure.
+If anyone knows the name of the authors it should go here;
+Peter Dufault
+first read about it in a 1989 Sun Expert magazine.
 .Pp
 The new CCB data structures are derived from the CAM-2 and CAM-3
 specifications.
@@ -545,11 +545,14 @@ led to the original
 .Fx
 .Tn SCSI
 library and the related kernel ioctl.
-If anyone needs that for compatibility contact dufault@hda.com.
+If anyone needs that for compatibility, contact
+.Mt dufault@hda.com .
 .Sh AUTHORS
-Kenneth Merry implemented the CAM versions of these encoding and decoding
-functions.
-This current work is based upon earlier work by Peter Dufault.
+.An -nosplit
+.An Kenneth Merry Aq Mt ken@FreeBSD.org
+implemented the CAM versions of these encoding and decoding functions.
+This current work is based upon earlier work by
+.An Peter Dufault Aq Mt dufault@hda.com .
 .Sh BUGS
 There should probably be a function that encodes both the CDB and the data
 buffer portions of a



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201703200301.v2K31L17076076>