commit a5738f02804532efe96abd8c6d5df8beb6fd0a64
Author: Aurelien Jarno <aurelien@aurel32.net>
Date:   Thu Jan 4 14:26:41 2024 +0100

    Add a manpage for usbreset
    
    Signed-off-by: Aurelien Jarno <aurelien@aurel32.net>

diff --git a/Makefile.am b/Makefile.am
index d3a9025..22452ba 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -49,7 +49,8 @@ man_MANS = \
 	lsusb.8	\
 	lsusb.py.1	\
 	usbhid-dump.8 \
-	usb-devices.1
+	usb-devices.1 \
+	usbreset.1
 
 EXTRA_DIST = \
 	lsusb.8.in \
@@ -58,6 +59,7 @@ EXTRA_DIST = \
 	usb-devices.1.in \
 	usb-devices \
 	lsusb.py.in \
+	usbreset.1.in \
 	usbreset.c \
 	LICENSES/GPL-2.0-only.txt \
 	LICENSES/GPL-3.0-only.txt
@@ -80,11 +82,15 @@ usbhid-dump.8: $(srcdir)/usbhid-dump.8.in
 usb-devices.1: $(srcdir)/usb-devices.1.in
 	sed 's|VERSION|$(VERSION)|g' $< >$@
 
+usbreset.1: $(srcdir)/usbreset.1.in
+	sed 's|VERSION|$(VERSION)|g' $< >$@
+
 DISTCLEANFILES = \
 	lsusb.py \
 	lsusb.py.1 \
 	lsusb.8 \
 	usb-devices.1 \
+	usbreset.1 \
 	usbhid-dump.8
 
 distclean-local:
diff --git a/usbreset.1.in b/usbreset.1.in
new file mode 100644
index 0000000..1474ebc
--- /dev/null
+++ b/usbreset.1.in
@@ -0,0 +1,53 @@
+.\" SPDX-License-Identifier: GPL-2.0-only
+.\" Copyright (c) 2023 Aurelien Jarno <aurelien@aurel32.net>
+.TH usbreset 1 "04 January 2024" "usbutils-VERSION" "Linux USB Utilities"
+.IX usbreset
+.SH NAME
+usbreset \- send a USB port reset to a USB device
+.SH SYNOPSIS
+.B usbreset
+[
+.I device
+]
+
+.SH DESCRIPTION
+.B usbreset
+is a utility that performs resets on USB devices. It is particularly useful
+situations where a USB device is unresponsive or exhibits erratic behavior.
+The USB \fIdevice\fP to be reset can be specified in one of three formats:
+.TP
+.BR PPPP:VVVV
+Reset by product and vendor IDs
+.TP
+.BR BBB/DDD
+Reset by bus and device number
+.TP
+.BR "Product"
+Reset by product name
+.PP
+When run without any arguments,
+.B usbreset
+provides usage information and a list of connected USB devices, including their
+product and vendor IDs, bus and device numbers, and product names.
+
+.SH RETURN VALUE
+If the specified device is not found, a non-zero exit code is returned.
+
+.SH EXAMPLES
+.TP
+Reset device with vendor ID 1234 and product ID 5678:
+.B usbreset 1234:5678
+
+.TP
+Reset device 002 on bus 001:
+.B usbreset 001:002
+
+.TP
+Reset device named USB2.0 Hub:
+.B usbreset """USB2.0 Hub"""
+
+.SH SEE ALSO
+.BR lsusb (8).
+
+.SH AUTHOR
+Alan Stern <stern@rowland.harvard.edu>