From owner-svn-src-head@freebsd.org Mon Mar 13 17:35:56 2017 Return-Path: Delivered-To: svn-src-head@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id B08A0D0A9AC; Mon, 13 Mar 2017 17:35:56 +0000 (UTC) (envelope-from ngie@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 7185F11C0; Mon, 13 Mar 2017 17:35:56 +0000 (UTC) (envelope-from ngie@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id v2DHZtwF062413; Mon, 13 Mar 2017 17:35:55 GMT (envelope-from ngie@FreeBSD.org) Received: (from ngie@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id v2DHZtCN062412; Mon, 13 Mar 2017 17:35:55 GMT (envelope-from ngie@FreeBSD.org) Message-Id: <201703131735.v2DHZtCN062412@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: ngie set sender to ngie@FreeBSD.org using -f From: Ngie Cooper Date: Mon, 13 Mar 2017 17:35:55 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r315202 - head/lib/libcam X-SVN-Group: head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-src-head@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: SVN commit messages for the src tree for head/-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 13 Mar 2017 17:35:56 -0000 Author: ngie Date: Mon Mar 13 17:35:55 2017 New Revision: 315202 URL: https://svnweb.freebsd.org/changeset/base/315202 Log: 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 MFC after: 1 week Reported by: igor [1], manlint [2] Reviewed by: imp Sponsored by: Dell EMC Isilon Differential Revision: D9968 Modified: head/lib/libcam/cam_cdbparse.3 Modified: head/lib/libcam/cam_cdbparse.3 ============================================================================== --- head/lib/libcam/cam_cdbparse.3 Mon Mar 13 17:16:29 2017 (r315201) +++ head/lib/libcam/cam_cdbparse.3 Mon Mar 13 17:35:55 2017 (r315202) @@ -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