[PATCH BlueZ v1 10/15] doc/bluetoothctl-le: Document arguments and add examples

[Luiz Augusto von Dentz <luiz.dentz@gmail.com>]

From: Luiz Augusto von Dentz <luiz.von.dentz@intel.com>

Add parameter documentation for show, connect and disconnect commands
explaining device address and object path parameters for LE operations.
Documents optional vs required device parameters for Low Energy
Bluetooth device management.
---
 doc/bluetoothctl-le.rst | 20 ++++++++++++++++----
 1 file changed, 16 insertions(+), 4 deletions(-)

diff --git a/doc/bluetoothctl-le.rst b/doc/bluetoothctl-le.rst
index 808d5786ee80..11f26d30ab6d 100644
--- a/doc/bluetoothctl-le.rst
+++ b/doc/bluetoothctl-le.rst
@@ -27,6 +27,8 @@ list
 List available le devices.
 
 :Usage: **> list**
+:Example Display all LE (Low Energy) devices that have been discovered:
+	| **> list**
 
 show
 ----
@@ -34,6 +36,11 @@ show
 Show le bearer information on a device.
 
 :Usage: **> show [dev]**
+:[dev]: Bluetooth device address (optional, shows all LE bearers if omitted)
+:Example Show all LE bearer information:
+	| **> show**
+:Example Show LE bearer info for device with specified address:
+	| **> show 00:11:22:33:44:55**
 
 connect
 -------
@@ -46,8 +53,10 @@ An active scan report is required before the connection can be
 established. If no advertising report is received before the timeout,
 a le-connection-abort-by-local error will be issued.
 
-:Usage: > connect <dev>
-:Example: > connect 1C:48:F9:9D:81:5C
+:Usage: **> connect <dev>**
+:<dev>: Bluetooth device address to connect to
+:Example Connect to another LE device:
+	| **> connect 00:11:22:33:44:55**
 
 disconnect
 ----------
@@ -57,8 +66,11 @@ Disconnect device over le.
 By default this command disconnects all profiles/services associated with the le
 connection, and then terminates the le link.
 
-:Usage: > disconnect <dev>
-:Example: > disconnect 1C:48:F9:9D:81:5C
+:Usage: **> disconnect <dev>**
+:<dev>: Bluetooth device address to disconnect from
+:Example Disconnect from another LE device:
+	| **> disconnect 00:11:22:33:44:55**
+
 
 RESOURCES
 =========
-- 
2.52.0