coap_resource.txt.in: Update resource flags definitions

man/coap_block.txt.in

@@ -43,7 +43,7 @@ coap_release_large_data_t _release_func_, void *_app_ptr_);*
 *int coap_add_data_large_request_app(coap_session_t *_session_,
 coap_pdu_t *_pdu_, size_t _length_,
 coap_release_large_data_t _release_func_, coap_get_large_data_t _get_func_,
-void *_app_ptr_);
+void *_app_ptr_);*
 
 *int coap_add_data_large_response(coap_resource_t *_resource_,
 coap_session_t *_session_, const coap_pdu_t *_request_, coap_pdu_t *_response_,

man/coap_context.txt.in

@@ -73,7 +73,7 @@ coap_app_data_free_callback_t _app_cb_);*
 
 *int coap_context_set_cid_tuple_change(coap_context_t *_context_context, uint8_t _every_);*
 
-*void coap_context_set_shutdown_no_observe(coap_context_t *_context_);
+*void coap_context_set_shutdown_no_observe(coap_context_t *_context_);*
 
 *void coap_context_set_session_reconnect_time(coap_context_t *_context_,
 unsigned int _reconnect_time_);*

man/coap_resource.txt.in

@@ -127,6 +127,11 @@ The *coap_resource_init*() function returns a newly created _resource_ of
 type _coap_resource_t_ * .  _uri_path_ specifies the uri string path to match
 against.  Normally there is no need for the leading '/' - e.g. just
 "full/path/for/resource".
+
+*NOTE:* _uri_path_, if not 7 bit readable ASCII, binary bytes must be hex
+encoded according to the rules defined in
+"https://rfc-editor.org/rfc/rfc3986#section-2.1[RFC3986 2.1. Percent-Encoding]".
+
 _flags_ can be zero or more of the following definitions or'ed together.
 
 [horizontal]
@@ -159,11 +164,25 @@ to the request handler.
 *COAP_RESOURCE_FLAGS_OSCORE_ONLY*::
 Define this resource as an OSCORE enabled access only.
 
+*COAP_RESOURCE_HIDE_WELLKNOWN_CORE*::
+Hide this resource from .well-known/core.
+
 *COAP_RESOURCE_HANDLE_WELLKNOWN_CORE*::
 Define this when invoking *coap_resource_unknown_init2*() if .well-known/core
 is to be passed to the unknown URI handler rather than processed locally.
 Used for easily passing on a request as a reverse-proxy request.
 
+*COAP_RESOURCE_USE_BLOCK_DATA_HANDLER*::
+Call the block data handler for this resource if one is registered for the context.
+
+*COAP_RESOURCE_SAFE_REQUEST_HANDLER*::
+Define this resource's request handlers as not manipulating any resource held
+and is therefore multi-thread safe.
+If not set, then the resource is locked (on multi-threaded systems) before
+calling any of these handlers so that any data changes are thread safe.
+*NOTE:* If there is a POST or PUT handler, then it is likely this should
+not be set.
+
 *NOTE:* The following flags are only tested against if
 *coap_mcast_per_resource*() has been called.  If *coap_mcast_per_resource*()
 has not been called, then all resources have multicast support, libcoap adds
@@ -209,16 +228,6 @@ Disable libcoap library suppressing 5.xx multicast responses (overridden by
 https://rfc-editor.org/rfc/rfc7967[RFC7967] No-Response option) for multicast
 requests.
 
-*COAP_RESOURCE_USE_BLOCK_DATA_HANDLER*::
-Call the block data handler for this resource if one is registered for the context.
-
-*COAP_RESOURCE_HIDE_WELLKNOWN_CORE*::
-Hide this resource from .well-known/core.
-
-*NOTE:* _uri_path_, if not 7 bit readable ASCII, binary bytes must be hex
-encoded according to the rules defined in
-"https://rfc-editor.org/rfc/rfc3986#section-2.1[RFC3986 2.1. Percent-Encoding]".
-
 *Function: coap_resource_unknown_init()*
 
 The *coap_resource_unknown_init*() function returns a newly created _resource_