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

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

diff --git a/Makefile.tools b/Makefile.tools
index a06cbb56a..fd32c2018 100644
--- a/Makefile.tools
+++ b/Makefile.tools
@@ -351,7 +351,7 @@ man_MANS += tools/rctest.1 tools/l2ping.1 tools/btattach.1 tools/isotest.1 \
 		tools/btmgmt.1 client/bluetoothctl-mgmt.1 \
 		client/bluetoothctl-monitor.1 client/bluetoothctl-admin.1 \
 		client/bluetoothctl-advertise.1 client/bluetoothctl-endpoint.1 \
-		client/bluetoothctl-gatt.1
+		client/bluetoothctl-gatt.1 client/bluetoothctl-player.1
 endif
 
 if MESH
@@ -478,7 +478,8 @@ manual_pages += tools/hciattach.1 tools/hciconfig.1 \
 			client/bluetoothctl-admin.1 \
 			client/bluetoothctl-advertise.1 \
 			client/bluetoothctl-endpoint.1 \
-			client/bluetoothctl-gatt.1
+			client/bluetoothctl-gatt.1 \
+			client/bluetoothctl-player.1
 
 if HID2HCI
 udevdir = $(UDEV_DIR)
diff --git a/client/bluetoothctl-player.rst b/client/bluetoothctl-player.rst
new file mode 100644
index 000000000..e45e61a1c
--- /dev/null
+++ b/client/bluetoothctl-player.rst
@@ -0,0 +1,165 @@
+===================
+bluetoothctl-player
+===================
+
+--------------------
+Media Player 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] [player.commands]
+
+Media Player Commands
+=====================
+
+list
+----
+
+List available players.
+
+:Usage: **# list**
+
+show
+----
+
+Show player information.
+
+:Usage: **# show [player]**
+
+select
+------
+
+Select default player.
+
+:Usage: **# select <player>**
+
+play
+----
+
+Start playback.
+
+:Usage: **# play [item]**
+
+pause
+-----
+
+Pause playback.
+
+:Usage: **# pause**
+
+stop
+----
+
+Stop playback.
+
+:Usage: **# stop**
+
+next
+----
+
+Jump to next item.
+
+:Usage: **# next**
+
+previous
+--------
+
+Jump to previous item.
+
+:Usage: **# previous**
+
+fast-forward
+------------
+
+Fast forward playback.
+
+:Usage: **# fast-forward**
+
+rewind
+------
+
+Rewind playback.
+
+:Usage: **# rewind**
+
+equalizer
+---------
+
+Enable/Disable equalizer.
+
+:Usage: **# equalizer <on/off>**
+
+repeat
+------
+
+Set repeat mode.
+
+:Usage: **# repeat <singletrack/alltrack/group/off>**
+
+shuffle
+-------
+
+Set shuffle mode.
+
+:Usage: **# shuffle <alltracks/group/off>**
+
+scan
+----
+
+Set scan mode.
+
+:Usage: **# scan <alltracks/group/off>**
+
+change-folder
+-------------
+
+Change current folder.
+
+:Usage: **# change-folder <item>**
+
+list-items
+----------
+
+List items of current folder.
+
+:Usage: **# list-items [start] [end]**
+
+search
+------
+
+Search items containing string.
+
+:Usage: **# search <string>**
+
+queue
+-----
+
+Add item to playlist queue.
+
+:Usage: **# queue <item>**
+
+show-item
+---------
+
+Show item information.
+
+:Usage: **# show-item <item>**
+
+RESOURCES
+=========
+
+http://www.bluez.org
+
+REPORTING BUGS
+==============
+
+linux-bluetooth@vger.kernel.org
-- 
2.47.3