From 4b353ae99ab66390561730974d0c4fecc4f38d6a Mon Sep 17 00:00:00 2001
From: Paul Otto <potto@ieee.org>
Date: Fri, 3 Nov 2023 21:38:50 -0400
Subject: [PATCH] client: Add bluetoothctl-transport.1 man page

This adds bluetoothctl-transport.rst which is then converted to
bluetoothctl-transport.1 using rst2man.
---
 Makefile.tools                    |  5 +-
 client/bluetoothctl-transport.rst | 81 +++++++++++++++++++++++++++++++
 2 files changed, 84 insertions(+), 2 deletions(-)
 create mode 100644 client/bluetoothctl-transport.rst

diff --git a/Makefile.tools b/Makefile.tools
index ba92fb9ce..8d8dbe268 100644
--- a/Makefile.tools
+++ b/Makefile.tools
@@ -352,7 +352,7 @@ man_MANS += tools/rctest.1 tools/l2ping.1 tools/btattach.1 tools/isotest.1 \
 		client/bluetoothctl-monitor.1 client/bluetoothctl-admin.1 \
 		client/bluetoothctl-advertise.1 client/bluetoothctl-endpoint.1 \
 		client/bluetoothctl-gatt.1 client/bluetoothctl-player.1 \
-		client/bluetoothctl-scan.1
+		client/bluetoothctl-scan.1 client/bluetoothctl-transport.1
 
 endif
 
@@ -482,7 +482,8 @@ manual_pages += tools/hciattach.1 tools/hciconfig.1 \
 			client/bluetoothctl-endpoint.1 \
 			client/bluetoothctl-gatt.1 \
 			client/bluetoothctl-player.1 \
-			client/bluetoothctl-scan.1
+			client/bluetoothctl-scan.1 \
+			client/bluetoothctl-transport.1
 
 if HID2HCI
 udevdir = $(UDEV_DIR)
diff --git a/client/bluetoothctl-transport.rst b/client/bluetoothctl-transport.rst
new file mode 100644
index 000000000..21ba2f701
--- /dev/null
+++ b/client/bluetoothctl-transport.rst
@@ -0,0 +1,81 @@
+======================
+bluetoothctl-transport
+======================
+
+-----------------------
+Media Transport Submenu
+-----------------------
+
+:Version: BlueZ
+:Copyright: Free use of this software is granted under ther terms of the GNU
+            Lesser General Public Licenses (LGPL).
+:Date: November 2022
+:Manual section: 1
+:Manual group: Linux System Administration
+
+SYNOPSIS
+========
+
+**bluetoothctl** [--options] [transport.commands]
+
+Media Transport Commands
+=========================
+
+list
+----
+
+List available transports.
+
+:Usage: **# list**
+
+show
+----
+
+Show transport information.
+
+:Usage: **# show <transport>**
+
+acquire
+-------
+
+Acquire transport.
+
+:Usage: **# acquire <transport> [transport1...]**
+
+release
+-------
+
+Release transport.
+
+:Usage: **# release <transport> [transport1...]**
+
+send
+----
+
+Send contents of a file.
+
+:Usage: **# send <transport> <filename>**
+
+receive
+-------
+
+Get/Set file to receive.
+
+:Usage: **# receive <transport> [filename]**
+
+volume
+------
+
+Get/Set transport volume.
+
+:Usage: **# volume <transport> [value]**
+
+RESOURCES
+=========
+
+http://www.bluez.org
+
+REPORTING BUGS
+==============
+
+linux-bluetooth@vger.kernel.org
-- 
2.47.3