* This family of functions set value for the key, given its name. Note that
* actual storage will not be updated until nvs_commit function is called.
*
- * @param[in] handle Handle obtained from nvs_open function. If the handle was
- * opened with read_only set to true, nvs_set_X functions will
- * fail with ESP_ERR_NVS_READONLY.
+ * @param[in] handle Handle obtained from nvs_open function.
+ * Handles that were opened read only cannot be used.
* @param[in] key Key name. Maximal length is determined by the underlying
* implementation, but is guaranteed to be at least
* 16 characters. Shouldn't be empty.
*
* Note that actual storage may not be updated until nvs_commit function is called.
*
- * @param[in] handle Storage handle obtained with nvs_open. If handle has to be
- * opened as not read only for this call to succeed.
+ * @param[in] handle Storage handle obtained with nvs_open.
+ * Handles that were opened read only cannot be used.
*
* @param[in] key Key name. Maximal length is determined by the underlying
* implementation, but is guaranteed to be at least
*
* Note that actual storage may not be updated until nvs_commit function is called.
*
- * @param[in] handle Storage handle obtained with nvs_open. If handle has to be
- * opened as not read only for this call to succeed.
+ * @param[in] handle Storage handle obtained with nvs_open.
+ * Handles that were opened read only cannot be used.
*
* @return - ESP_OK if erase operation was successful
* - ESP_ERR_NVS_INVALID_HANDLE if handle has been closed or is NULL
* to non-volatile storage. Individual implementations may write to storage at other times,
* but this is not guaranteed.
*
- * @param[in] handle Storage handle obtained with nvs_open. If handle has to be
- * opened as not read only for this call to succeed.
+ * @param[in] handle Storage handle obtained with nvs_open.
+ * Handles that were opened read only cannot be used.
*
* @return - ESP_OK if the changes have been written successfully
* - ESP_ERR_NVS_INVALID_HANDLE if handle has been closed or is NULL