michaelh/zephyr
1
0
Fork 0
Code Releases Activity

doc: use @rst/@endrst for ReST in headers

Browse source 
Folks found the use of @rststar/@endrststar non-intuitive (wanted to use
@rststart).  The "star" was there indicating the doxygen comment lines
had a leading asterisk that needed to be stripped, but since our
commenting convention is to use the leading asterisk on continuation
lines, the leading asterisk is always there.  So, change the doxygen
alias to the more expected @rst/@endrst.

Signed-off-by: David B. Kinder <david.b.kinder@intel.com>
This commit is contained in:
David B. Kinder 2019-06-25 10:44:55 -07:00 • committed by Anas Nashif
commit 8de9cc7079
6 changed files with 76 additions and 80 deletions
Download patch file Download diff file Expand all files Collapse all files

4
include/net/mqtt.h
View file

@ -515,10 +515,10 @@ void mqtt_client_init(struct mqtt_client *client);
* @note Default protocol revision used for connection request is 3.1.1. Please
* set client.protocol_version = MQTT_VERSION_3_1_0 to use protocol 3.1.0.
* @note
* @rststar
* @rst
* Please modify :option:`CONFIG_MQTT_KEEPALIVE` time to override
* default of 1 minute.
* @endrststar
* @endrst
*/
int mqtt_connect(struct mqtt_client *client);