[nrf fromtree] doc: Added note regarding the intended use for secondary services

Pieloaf · gmarull · commit 3db330717c1c · 2022-09-06T11:56:51.000+02:00
Noting that secondary services should only be included in other services or higher level specification. Signed-off-by: Pierce Lowe <pierce.lowe@nordicsemi.no> (cherry picked from commit 0be57d3) Signed-off-by: Herman Berget <herman.berget@nordicsemi.no>
diff --git a/include/zephyr/bluetooth/gatt.h b/include/zephyr/bluetooth/gatt.h
@@ -622,6 +622,9 @@ ssize_t bt_gatt_attr_read_service(struct bt_conn *conn,
  *
  *  Helper macro to declare a secondary service attribute.
  *
+ *  @note A secondary service is only intended to be included from a primary
+ *  service or another secondary service or other higher layer specification.
+ *
  *  @param _service Service attribute value.
  */
 #define BT_GATT_SECONDARY_SERVICE(_service)				\

Original file line number	Diff line number	Diff line change
`@@ -622,6 +622,9 @@ ssize_t bt_gatt_attr_read_service(struct bt_conn *conn,`
`622`	`622`	`*`
`623`	`623`	`* Helper macro to declare a secondary service attribute.`
`624`	`624`	`*`
	`625`	`+ * @note A secondary service is only intended to be included from a primary`
	`626`	`+ * service or another secondary service or other higher layer specification.`
	`627`	`+ *`
`625`	`628`	`* @param _service Service attribute value.`
`626`	`629`	`*/`
`627`	`630`	`#define BT_GATT_SECONDARY_SERVICE(_service) \`