]> granicus.if.org Git - esp-idf/commitdiff
Corrected documentation style
authorKrzysztof <krzychb@gazeta.pl>
Sun, 30 Oct 2016 18:37:45 +0000 (19:37 +0100)
committerIvan Grokhotkov <ivan@espressif.com>
Mon, 31 Oct 2016 17:21:18 +0000 (01:21 +0800)
This is for better visuaization with Sphinx

components/nvs_flash/include/nvs.h
components/nvs_flash/include/nvs_flash.h

index d0c9908afb06837974ab51112f5fdff1a8edfe71..8418959793307dcce2d49fb28ca9eac7056c02e2 100644 (file)
@@ -62,12 +62,13 @@ typedef enum {
  *                         underlying implementation, but is guaranteed to be
  *                         at least 16 characters. Shouldn't be empty.
  * @param[in]  open_mode   NVS_READWRITE or NVS_READONLY. If NVS_READONLY, will 
- *                                                open a handle for reading only. All write requests will 
- *                                                be rejected for this handle.
+ *                         open a handle for reading only. All write requests will 
+ *                        be rejected for this handle.
  * @param[out] out_handle  If successful (return code is zero), handle will be
  *                         returned in this argument.
  *
- * @return     - ESP_OK if storage handle was opened successfully
+ * @return
+ *             - ESP_OK if storage handle was opened successfully
  *             - ESP_ERR_NVS_NOT_INITIALIZED if the storage driver is not initialized
  *             - ESP_ERR_NVS_NOT_FOUND id namespace doesn't exist yet and
  *               mode is NVS_READONLY
@@ -90,7 +91,8 @@ esp_err_t nvs_open(const char* name, nvs_open_mode open_mode, nvs_handle *out_ha
  * @param[in]  value   The value to set.
  * @param[in]  length  For nvs_set_blob: length of binary value to set, in bytes.
  *
- * @return     - ESP_OK if value was set successfully
+ * @return
+ *             - ESP_OK if value was set successfully
  *             - ESP_ERR_NVS_INVALID_HANDLE if handle has been closed or is NULL
  *             - ESP_ERR_NVS_READ_ONLY if storage handle was opened as read only
  *             - ESP_ERR_NVS_INVALID_NAME if key name doesn't satisfy constraints
@@ -168,7 +170,8 @@ esp_err_t nvs_set_blob(nvs_handle handle, const char* key, const void* value, si
  *                           zero, will be set to the actual length of the value
  *                           written. For nvs_get_str this includes zero terminator.
  *
- * @return     - ESP_OK if the value was retrieved successfully
+ * @return
+ *             - ESP_OK if the value was retrieved successfully
  *             - ESP_ERR_NVS_NOT_FOUND if the requested key doesn't exist
  *             - ESP_ERR_NVS_INVALID_HANDLE if handle has been closed or is NULL
  *             - ESP_ERR_NVS_INVALID_NAME if key name doesn't satisfy constraints
@@ -197,7 +200,8 @@ esp_err_t nvs_get_blob(nvs_handle handle, const char* key, void* out_value, size
  *                     implementation, but is guaranteed to be at least
  *                     16 characters. Shouldn't be empty.
  *
- * @return      - ESP_OK if erase operation was successful
+ * @return
+ *              - ESP_OK if erase operation was successful
  *              - ESP_ERR_NVS_INVALID_HANDLE if handle has been closed or is NULL
  *              - ESP_ERR_NVS_READ_ONLY if handle was opened as read only
  *              - ESP_ERR_NVS_NOT_FOUND if the requested key doesn't exist
@@ -213,7 +217,8 @@ esp_err_t nvs_erase_key(nvs_handle handle, const char* key);
  * @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
+ * @return
+ *              - ESP_OK if erase operation was successful
  *              - ESP_ERR_NVS_INVALID_HANDLE if handle has been closed or is NULL
  *              - ESP_ERR_NVS_READ_ONLY if handle was opened as read only
  *              - other error codes from the underlying storage driver
@@ -230,7 +235,8 @@ esp_err_t nvs_erase_all(nvs_handle handle);
  * @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
+ * @return
+ *             - ESP_OK if the changes have been written successfully
  *             - ESP_ERR_NVS_INVALID_HANDLE if handle has been closed or is NULL
  *             - other error codes from the underlying storage driver
  */
@@ -255,3 +261,4 @@ void nvs_close(nvs_handle handle);
 #endif
 
 #endif //ESP_NVS_H
+
index ce98f39407ac6e5af427114d51d2027a8401cd36..1cade0e956514923d656ee4dbe5f9275866d67bf 100644 (file)
@@ -22,6 +22,8 @@ extern "C" {
 
     Temporarily, this region is hardcoded as a 12KB (0x3000 byte)
     region starting at 24KB (0x6000 byte) offset in flash.
+
+    @return ESP_OK if flash was successfully initialised.
 */
 esp_err_t nvs_flash_init(void);