From 5c785643deb5b591019cac5f96c0c4c07851ca9c Mon Sep 17 00:00:00 2001
From: Edward Tomasz Napierala <trasz@FreeBSD.org>
Date: Wed, 8 Jun 2016 07:39:55 +0000
Subject: [PATCH] Improve documentation for usfs(4) and usb_template(4).

Reviewed by:	hselasky (earlier version)
MFC after:	1 month
Differential Revision:	https://reviews.freebsd.org/D6740
---
 share/man/man4/usb_template.4 | 34 ++++++++++++++++++++++++----------
 share/man/man4/usfs.4         | 11 ++++++++---
 2 files changed, 32 insertions(+), 13 deletions(-)

diff --git a/share/man/man4/usb_template.4 b/share/man/man4/usb_template.4
index e4dba2cf74af..2cc1ee421266 100644
--- a/share/man/man4/usb_template.4
+++ b/share/man/man4/usb_template.4
@@ -23,7 +23,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd March 18, 2014
+.Dd June 8, 2016
 .Dt USB_TEMPLATE 4
 .Os
 .
@@ -32,7 +32,7 @@
 .
 .Nm usb_template
 .
-.Nd "USB templates"
+.Nd "USB device side templates"
 .
 .
 .Sh SYNOPSIS
@@ -59,19 +59,33 @@ configuration descriptors, one or more USB interface descriptors, one
 or more USB endpoint descriptors, USB strings and additional USB
 descriptors.
 .
-The USB template module currently has templates for USB Mass Storage,
-USB CDC Ethernet and Message Transfer Protocol.
+USB templates are selected using the
+.Va hw.usb.template
+sysctl and tunable.
 .
-USB templates are currently selected using the "hw.usb.template"
-sysctl.
-.
-The "hw.usb.template" value can be changed at any time, but will not
+The
+.Va hw.usb.template
+value can be changed at any time, but will not
 have any effect until the USB device has been re-enumerated.
 .
-.
+Available templates are:
+.Bl -column -offset 3n "Value"
+.It Em Value Ta Em Description
+.It Dv 0 Ta USB Mass Storage
+.It Dv 1 Ta CDC Ethernet
+.It Dv 2 Ta Media Transfer Protocol (MTP)
+.It Dv 3 Ta USB serial port
+.It Dv 4 Ta USB audio
+.It Dv 5 Ta USB keyboard
+.It Dv 6 Ta USB mouse
+.It Dv 7 Ta USB phone
+.It Dv 8 Ta CDC Ethernet and serial port
+.It Dv 9 Ta USB MIDI
+.El
 .
 .Sh SEE ALSO
-.Xr usb 4
+.Xr usb 4 ,
+.Xr usfs 4
 .Sh STANDARDS
 The
 .Nm
diff --git a/share/man/man4/usfs.4 b/share/man/man4/usfs.4
index a72a8d8435b0..417fbcf48a5d 100644
--- a/share/man/man4/usfs.4
+++ b/share/man/man4/usfs.4
@@ -25,7 +25,7 @@
 .\" 
 .\" $FreeBSD$
 .\"
-.Dd March 18, 2014
+.Dd June 8, 2016
 .Dt USFS 4
 .Os
 .Sh NAME
@@ -50,12 +50,17 @@ usfs_load="YES"
 The
 .Nm
 driver provides support for emulating an USB mass storage device when
-the USB stack is activated in USB device side mode.
+the USB stack is activated in USB device side mode (the
+.Xr usb_template 4
+module is loaded and the
+.Va hw.usb.template
+sysctl is set to 0).
 .Pp
 Upon attach the driver creates a RAM disk which can be read and written.
 .Sh SEE ALSO
 .Xr umass 4 ,
-.Xr usb 4
+.Xr usb 4 ,
+.Xr usb_template 4
 .Sh HISTORY
 The
 .Nm