Module Name: src
Committed By: wiz
Date: Tue Feb 20 15:56:43 UTC 2018
Modified Files:
src/share/man/man4: ugen.4
Log Message:
Add missing end quote.
Avoid some punctuation markup.
To generate a diff of this commit:
cvs rdiff -u -r1.33 -r1.34 src/share/man/man4/ugen.4
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/share/man/man4/ugen.4
diff -u src/share/man/man4/ugen.4:1.33 src/share/man/man4/ugen.4:1.34
--- src/share/man/man4/ugen.4:1.33 Tue Feb 20 15:50:02 2018
+++ src/share/man/man4/ugen.4 Tue Feb 20 15:56:43 2018
@@ -1,4 +1,4 @@
-.\" $NetBSD: ugen.4,v 1.33 2018/02/20 15:50:02 ws Exp $
+.\" $NetBSD: ugen.4,v 1.34 2018/02/20 15:56:43 wiz Exp $
.\"
.\" Copyright (c) 1999 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -35,7 +35,7 @@
.Nd USB generic device support
.Sh SYNOPSIS
.Cd "ugen* at uhub? flags N"
-.Cd "ugen* at uhub? vendor V product P configuration C interface I flags 1
+.Cd "ugen* at uhub? vendor V product P configuration C interface I flags 1"
.Sh DESCRIPTION
The
.Nm
@@ -178,11 +178,11 @@ All endpoints handle the following
calls:
.Pp
.Bl -tag -width indent -compact
-.It Dv USB_SET_SHORT_XFER (int)
+.It Dv USB_SET_SHORT_XFER ( int )
Allow short read transfer.
Normally a transfer from the device which is shorter than the
request specified is reported as an error.
-.It Dv USB_SET_TIMEOUT (int)
+.It Dv USB_SET_TIMEOUT ( int )
Set the timeout on the device operations, the time is specified
in milliseconds.
The value 0 is used to indicate that there is no timeout.
@@ -193,14 +193,14 @@ The control endpoint (endpoint 0) handle
calls:
.Pp
.Bl -tag -width indent -compact
-.It Dv USB_GET_CONFIG (int)
+.It Dv USB_GET_CONFIG ( int )
Get the device configuration number.
-.It Dv USB_SET_CONFIG (int)
+.It Dv USB_SET_CONFIG ( int )
Set the device into the given configuration number.
.Pp
This operation can only be performed when the control endpoint
is the sole open endpoint.
-.It Dv USB_GET_ALTINTERFACE (struct usb_alt_interface)
+.It Dv USB_GET_ALTINTERFACE ( struct usb_alt_interface )
Get the alternative setting number for the interface with the given
index.
The
@@ -213,7 +213,7 @@ struct usb_alt_interface {
int uai_alt_no;
};
.Ed
-.It Dv USB_SET_ALTINTERFACE (struct usb_alt_interface)
+.It Dv USB_SET_ALTINTERFACE ( struct usb_alt_interface )
Set the alternative setting to the given number in the interface with the
given index.
The
@@ -222,13 +222,13 @@ is ignored in this call.
.Pp
This operation can only be performed when no endpoints for the interface
are open.
-.It Dv USB_GET_NO_ALT (struct usb_alt_interface)
+.It Dv USB_GET_NO_ALT ( struct usb_alt_interface )
Return the number of different alternate settings in the
.Dv uai_alt_no
field.
-.It Dv USB_GET_DEVICE_DESC (usb_device_descriptor_t)
+.It Dv USB_GET_DEVICE_DESC ( usb_device_descriptor_t )
Return the device descriptor.
-.It Dv USB_GET_CONFIG_DESC (struct usb_config_desc)
+.It Dv USB_GET_CONFIG_DESC ( struct usb_config_desc )
Return the descriptor for the configuration with the given index.
For convenience the current configuration can be specified by
.Dv USB_CURRENT_CONFIG_INDEX .
@@ -238,7 +238,7 @@ struct usb_config_desc {
usb_config_descriptor_t ucd_desc;
};
.Ed
-.It Dv USB_GET_INTERFACE_DESC (struct usb_interface_desc)
+.It Dv USB_GET_INTERFACE_DESC ( struct usb_interface_desc )
Return the interface descriptor for an interface specified by its
configuration index, interface index, and alternative index.
For convenience the current alternative can be specified by
@@ -251,7 +251,7 @@ struct usb_interface_desc {
usb_interface_descriptor_t uid_desc;
};
.Ed
-.It Dv USB_GET_ENDPOINT_DESC (struct usb_endpoint_desc)
+.It Dv USB_GET_ENDPOINT_DESC ( struct usb_endpoint_desc )
Return the endpoint descriptor for the endpoint specified by its
configuration index, interface index, alternative index, and
endpoint index.
@@ -264,7 +264,7 @@ struct usb_endpoint_desc {
usb_endpoint_descriptor_t ued_desc;
};
.Ed
-.It Dv USB_GET_FULL_DESC (struct usb_full_desc)
+.It Dv USB_GET_FULL_DESC ( struct usb_full_desc )
Return all the descriptors for the given configuration.
.Bd -literal
struct usb_full_desc {
@@ -283,7 +283,7 @@ The proper size can be determined by fir
and inspecting the
.Dv wTotalLength
field.
-.It Dv USB_GET_STRING_DESC (struct usb_string_desc)
+.It Dv USB_GET_STRING_DESC ( struct usb_string_desc )
Get a string descriptor for the given language id and
string index.
.Bd -literal
@@ -322,7 +322,7 @@ This is a dangerous operation in that it
on the device.
Some of the most dangerous (e.g., changing the device
address) are not allowed.
-.It Dv USB_GET_DEVICEINFO (struct usb_device_info)
+.It Dv USB_GET_DEVICEINFO ( struct usb_device_info )
Get an information summary for the device.
This call will not issue any USB transactions.
.El
@@ -332,7 +332,7 @@ Bulk endpoints handle the following
calls:
.Pp
.Bl -tag -width indent -compact
-.It Dv USB_SET_BULK_RA (int)
+.It Dv USB_SET_BULK_RA ( int )
Enable or disable bulk read-ahead.
When enabled, the driver will begin to read data from the device into
a buffer, and will perform reads from the device whenever there is
@@ -345,7 +345,7 @@ The buffer size and the read request len
.Dv USB_SET_BULK_RA_OPT
.Xr ioctl 2
call.
-.It Dv USB_SET_BULK_WB (int)
+.It Dv USB_SET_BULK_WB ( int )
Enable or disable bulk write-behind.
When enabled, the driver will buffer data from the
.Xr write 2
@@ -359,7 +359,7 @@ The buffer size and the write request le
.Dv USB_SET_BULK_WB_OPT
.Xr ioctl 2
call.
-.It Dv USB_SET_BULK_RA_OPT (struct usb_bulk_ra_wb_opt)
+.It Dv USB_SET_BULK_RA_OPT ( struct usb_bulk_ra_wb_opt )
Set the size of the buffer and the length of the read requests used by
the driver when bulk read-ahead is enabled.
The changes do not take
@@ -381,7 +381,7 @@ struct usb_bulk_ra_wb_opt {
u_int ra_wb_request_size;
};
.Ed
-.It Dv USB_SET_BULK_WB_OPT (struct usb_bulk_ra_wb_opt)
+.It Dv USB_SET_BULK_WB_OPT ( struct usb_bulk_ra_wb_opt )
Set the size of the buffer and the length of the write requests used
by the driver when bulk write-behind is enabled.
The changes do not