[PATCH BlueZ v7 15/16] client: Expand GATT submenu documentation

@@ -25,147 +25,180 @@ Generic Attribute Commands
 list-attributes
 ---------------
 
-List attributes.
+Lists the attributes of either the local device or a remote device,
+encompassing services, characteristics, and handles. This command provides
+a comprehensive overview of the available Bluetooth attributes, which can
+be further interacted with using other commands.
 
-:Usage: **> list-attributes <attribute/UUID>**
+:Usage: **> list-attributes <attribute/UUID> <dev/local>**
 
 select-attribute
 ----------------
 
-Select attribute.
+Selects a specific attribute on either the local or remote device for
+subsequent operations. Before you can read or write to an attribute, you
+must select it with this command. This establishes a context for many
+other commands (read, write, notify, etc.), specifying the attribute
+they should operate on.
 
-:Usage: **> select-attribute <attribute/UUID>**
+:Usage: **> select-attribute <attribute/UUID/local>**
 
 attribute-info
 --------------
 
-Select attribute.
+Displays detailed information about an attribute. If no attribute or
+UUID is specified, it shows information about the currently selected
+attribute. This command is useful for understanding the properties and
+capabilities of an attribute.
 
 :Usage: **> attribute-info [attribute/UUID]**
 
 read
 ----
 
-Read attribute value.
+Reads the value of an attribute. Requires that an attribute be selected
+beforehand with select-attribute. The optional offset parameter can be
+used for attributes that allow partial reads.
 
 :Usage: **> read [offset]**
 
 write
 -----
 
-Write attribute value.
+Writes a value to an attribute. This command necessitates that an attribute
+be selected in advance using select-attribute. Data must be provided in
+hexadecimal format. Optional offset and type parameters can accommodate
+specific write requirements.
 
 :Usage: **> write <data=xx xx ...> [offset] [type]**
 
 acquire-write
 -------------
 
-Acquire Write file descriptor.
+Acquires a Write file descriptor for a previously selected attribute. This
+is useful for applications that need a file descriptor to perform
+write operations.
 
 :Usage: **> acquire-write**
 
 release-write
 -------------
 
-Release Write file descriptor.
+Releases the Write file descriptor acquired with acquire-write. This
+command is necessary to clean up resources after you're done with the
+write operation.
 
 :Usage: **> release-write**
 
 acquire-notify
 --------------
 
-Acquire Notify file descriptor.
+Acquires a Notify file descriptor for a previously selected attribute.
+This enables applications to listen for notifications on attribute
+value changes.
 
 :Usage: **> acquire-notify**
 
 release-notify
 --------------
 
-Release Notify file descriptor.
+Releases the Notify file descriptor obtained with acquire-notify. Ensures
+resources are freed once notification listening is no longer needed.
 
 :Usage: **> release-notify**
 
 notify
 ------
 
-Notify attribute value.
+Enables or disables notifications for attribute value changes. Before
+this command can be used, the relevant attribute must be selected. This
+command allows applications to be notified of attribute changes without
+polling.
 
 :Usage: **> notify <on/off>**
 
 clone
 -----
 
-Clone a device or attribute.
+Creates a clone of a device or attribute. This can be useful for creating
+a backup or working with a copy for testing purposes.
 
 :Usage: **> clone [dev/attribute/UUID]**
 
 register-application
 --------------------
 
-Register application.
+Registers a new application with the Bluetooth system, allowing for the
+management of services, characteristics, and descriptors under this
+application.
 
 :Usage: **> register-application [UUID ...]**
 
 unregister-application
 ----------------------
 
-Unregister application
+Removes a previously registered application from the Bluetooth system.
 
 :Usage: **> unregister-application**
 
 register-service
 ----------------
 
-Register application service.
+Adds a new service under a registered application. This command is
+crucial for defining new services that devices can offer.
 
 :Usage: **> register-service <UUID> [handle]**
 
 unregister-service
 ------------------
 
-Unregister application service
+Removes a service from a registered application, effectively ceasing
+its availability.
 
 :Usage: **> unregister-service <UUID/object>**
 
 register-includes
 -----------------
 
-Register as Included service.
+Marks a service as included within another service, allowing for
+service hierarchies and complex service structures.
 
 :Usage: **>r egister-includes <UUID> [handle]**
 
 unregister-includes
 -------------------
 
-Unregister Included service.
+Removes an included service relationship, simplifying the service structure.
 
 :Usage: **> unregister-includes <Service-UUID><Inc-UUID>**
 
 register-characteristic
 -----------------------
 
-Register service characteristic.
+Introduces a new characteristic under a service, specifying its properties
+and access permissions with flags.
 
 :Usage: **> register-characteristic <UUID> <Flags=read,write,notify...> [handle]**
 
 unregister-characteristic
 -------------------------
 
-Unregister service characteristic.
+Eliminates a characteristic from a service, removing its functionality.
 
 :Usage: **> unregister-characteristic <UUID/object>**
 
 register-descriptor
 -------------------
 
-Register characteristic descriptor.
+Adds a descriptor to a characteristic, further defining its behavior and
+access controls.
 
 :Usage: **> register-descriptor <UUID> <Flags=read,write...> [handle]**
 
 unregister-descriptor
 ---------------------
 
-Unregister characteristic descriptor.
+Removes a descriptor from a characteristic, simplifying its behavior.
 
 :Usage: **> unregister-descriptor <UUID/object>**