From fa3e4103abd1a0d8af787cf79b757797a86bedd1 Mon Sep 17 00:00:00 2001
From: Krzysztof <krzychb@gazeta.pl>
Date: Wed, 16 Nov 2016 20:11:32 +0100
Subject: [PATCH 1/6] docs: Hyperlinks to guides

---
 CONTRIBUTING.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
index 968826790a..5810d06b98 100644
--- a/CONTRIBUTING.rst
+++ b/CONTRIBUTING.rst
@@ -15,7 +15,9 @@ Before sending us a Pull Request, please consider this list of points:
 
 * Is the contribution entirely your own work, or already licensed under an Apache License 2.0 compatible Open Source License? If not then we unfortunately cannot accept it.
 
-* Does any new code conform to the esp-idf Style Guide? (Style Guide currently pending).
+* Does any new code conform to the esp-idf :doc:`Style Guide <style-guide>`?
+
+* Does the code documentation follow requirements in :doc:`documenting-code`?
 
 * Is the code adequately commented for people to understand how it is structured?
 

From 4e9e8f52acdba97d7f10d16ba440904d9c709425 Mon Sep 17 00:00:00 2001
From: Krzysztof <krzychb@gazeta.pl>
Date: Wed, 16 Nov 2016 20:13:18 +0100
Subject: [PATCH 2/6] doc: Documenting Code clean up

---
 .../_static/doc-code-documentation-inline.png | Bin 52513 -> 52554 bytes
 docs/documenting-code.rst                     | 121 +++++++++---------
 2 files changed, 57 insertions(+), 64 deletions(-)

diff --git a/docs/_static/doc-code-documentation-inline.png b/docs/_static/doc-code-documentation-inline.png
index 72bf22f156224e4e32e7934828ccc73f15cea67e..9de5d51a2bd0c0fca7f0cb53b8b0a6c3ff9ed38c 100644
GIT binary patch
delta 14525
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
N;OXk;vd$@?2>@&u+xP$g

delta 14441
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
FCIDGE;dlT5

diff --git a/docs/documenting-code.rst b/docs/documenting-code.rst
index 72e3cea147..a73e26de4b 100644
--- a/docs/documenting-code.rst
+++ b/docs/documenting-code.rst
@@ -40,98 +40,91 @@ Go for it!
 
 When writing code for this repository, please follow guidelines below.
 
-  1. Document all building blocks of code: functions, structs, typedefs, enums, macros, etc. Provide enough information on purpose, functionality and limitations of documented items, as you would like to see them documented when reading the code by others.
+1. Document all building blocks of code: functions, structs, typedefs, enums, macros, etc. Provide enough information on purpose, functionality and limitations of documented items, as you would like to see them documented when reading the code by others.
 
-  2. Documentation of function should describe what this function does. If it accepts input parameters and returns some value, all of them should be explained.
+2. Documentation of function should describe what this function does. If it accepts input parameters and returns some value, all of them should be explained.
 
-  3. Do not add a data type before parameter or any other characters besides spaces. All spaces and line breaks are compressed into a single space. If you like to break a line, then break it twice.
+3. Do not add a data type before parameter or any other characters besides spaces. All spaces and line breaks are compressed into a single space. If you like to break a line, then break it twice.
 
-    .. image:: _static/doc-code-function.png
-       :align: center
-       :alt: Sample function documented inline and after rendering
+  .. image:: _static/doc-code-function.png
+     :align: center
+     :alt: Sample function documented inline and after rendering
 
-  4. If function has void input or does not return any value, then skip ``@param`` or ``@return``
+4. If function has void input or does not return any value, then skip ``@param`` or ``@return``
 
-    .. image:: _static/doc-code-void-function.png
-       :align: center
-       :alt: Sample void function documented inline and after rendering
+  .. image:: _static/doc-code-void-function.png
+     :align: center
+     :alt: Sample void function documented inline and after rendering
  
-  5. When documenting members of a ``struct``, ``typedef`` or ``enum``, place specific comment like below after each member.
+5. When documenting a ``define`` as well as members of a ``struct`` or ``enum``, place specific comment like below after each member.
 
-    .. image:: _static/doc-code-member.png
-       :align: center
-       :alt: Sample of member documentation inline and after rendering
+  .. image:: _static/doc-code-member.png
+     :align: center
+     :alt: Sample of member documentation inline and after rendering
+
+
+6. To provide well formatted lists, break the line after command (like ``@return`` in example below).
+
+  ::
+
+    *
+    * @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
+    *    - other error codes from the underlying storage driver
+    *
  
-  6. To provide well formatted lists, break the line after command (like ``@return`` in example below).
-
-    .. code-block:: c
-
-      ...
-      *
-      * @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
-      *    - other error codes from the underlying storage driver
-      *
-      ...
- 
-  7. Overview of functionality of documented header file, or group of files that make a library, should be placed in the same directory in a separate ``README.rst`` file. If directory contains header files for different APIs, then the file name should be ``apiname-readme.rst``.
+7. Overview of functionality of documented header file, or group of files that make a library, should be placed in the same directory in a separate ``README.rst`` file. If directory contains header files for different APIs, then the file name should be ``apiname-readme.rst``.
 
 Go one extra mile
 -----------------
 
 There is couple of tips, how you can make your documentation even better and more useful to the reader.
 
-  1. Add code snippets to illustrate implementation. To do so, enclose snippet using ``@code{c}`` and ``@endcode`` commands. 
+1. Add code snippets to illustrate implementation. To do so, enclose snippet using ``@code{c}`` and ``@endcode`` commands. 
 
-    .. code-block:: c
+  ::
 
-      ...
-      *
-      * @code{c}
-      * // Example of using nvs_get_i32:
-      * int32_t max_buffer_size = 4096; // default value
-      * esp_err_t err = nvs_get_i32(my_handle, "max_buffer_size", &max_buffer_size);
-      * assert(err == ESP_OK || err == ESP_ERR_NVS_NOT_FOUND);
-      * // if ESP_ERR_NVS_NOT_FOUND was returned, max_buffer_size will still
-      * // have its default value.
-      * @endcode
-      *
-      ...
+    *
+    * @code{c}
+    * // Example of using nvs_get_i32:
+    * int32_t max_buffer_size = 4096; // default value
+    * esp_err_t err = nvs_get_i32(my_handle, "max_buffer_size", &max_buffer_size);
+    * assert(err == ESP_OK || err == ESP_ERR_NVS_NOT_FOUND);
+    * // if ESP_ERR_NVS_NOT_FOUND was returned, max_buffer_size will still
+    * // have its default value.
+    * @endcode
+    *
 
-    The code snippet should be enclosed in a comment block of the function that it illustrates.
+  The code snippet should be enclosed in a comment block of the function that it illustrates.
 
-  2. To highlight some important information use command ``@attention`` or ``@note``.
+2. To highlight some important information use command ``@attention`` or ``@note``.
 
-    .. code-block:: c
+  ::
 
-      ...
-      *
-      * @attention
-      *     1. This API only impact WIFI_MODE_STA or WIFI_MODE_APSTA mode
-      *     2. If the ESP32 is connected to an AP, call esp_wifi_disconnect to disconnect.
-      *
-      ...
+    *
+    * @attention
+    *     1. This API only impact WIFI_MODE_STA or WIFI_MODE_APSTA mode
+    *     2. If the ESP32 is connected to an AP, call esp_wifi_disconnect to disconnect.
+    *
 
-    Above example also shows how to use a numbered list.
+  Above example also shows how to use a numbered list.
 
-  3. Use markdown to make your documentation even more readable. You will add headers, links, tables and more.
+3. Use markdown to make your documentation even more readable. You will add headers, links, tables and more.
 
-    .. code-block:: c
+  ::
 
-      ...
-      *
-      * [ESP32 Technical Reference](http://espressif.com/sites/default/files/documentation/esp32_technical_reference_manual_en.pdf)
-      *
-      ...
+    *
+    * [ESP32 Technical Reference](http://espressif.com/sites/default/files/documentation/esp32_technical_reference_manual_en.pdf)
+    *
 
-  .. note::
+.. note::
 
    Code snippets, notes, links, etc. will not make it to the documentation, if not enclosed in a comment block associated with one of documented objects.
 
-  5. Prepare one or more complete code examples together with description. Place them in a separate file ``example.rst`` in the same directory as the API header files. If directory contains header files for different APIs, then the file name should be ``apiname-example.rst``.
+5. Prepare one or more complete code examples together with description. Place them in a separate file ``example.rst`` in the same directory as the API header files. If directory contains header files for different APIs, then the file name should be ``apiname-example.rst``.
 
 Put it all together
 -------------------

From bf61f6de55a2d637e7fa6805bfa2736e15f982d8 Mon Sep 17 00:00:00 2001
From: Krzysztof <krzychb@gazeta.pl>
Date: Wed, 16 Nov 2016 20:14:48 +0100
Subject: [PATCH 3/6] doc: API Reference - examples & fixes

---
 docs/api/bt.rst        | 11 +++++++----
 docs/api/ledc.rst      |  3 +++
 docs/api/nvs_flash.rst | 19 +++++++++++++++++--
 docs/api/vfs.rst       |  1 +
 4 files changed, 28 insertions(+), 6 deletions(-)

diff --git a/docs/api/bt.rst b/docs/api/bt.rst
index 0ab17b2aa5..1824bc454a 100644
--- a/docs/api/bt.rst
+++ b/docs/api/bt.rst
@@ -9,15 +9,19 @@ Overview
 Application Example
 -------------------
 
-`Instructions`_
+Check `/examples <https://github.com/espressif/esp-idf/tree/master/examples>`_ folder of `espressif/esp-idf <https://github.com/espressif/esp-idf/>`_ repository, that contains the following example:
 
-API Reference
--------------
+`05_ble_adv <https://github.com/espressif/esp-idf/blob/master/examples/05_ble_adv/main/app_bt.c>`_ 
+
+  This is a BLE advertising demo with virtual HCI interface. Send Reset/ADV_PARAM/ADV_DATA/ADV_ENABLE HCI command for BLE advertising.
 
 `Instructions`_
 
 .. _Instructions: template.html
 
+API Reference
+-------------
+
 Header Files
 ^^^^^^^^^^^^
 
@@ -35,4 +39,3 @@ Functions
 .. doxygenfunction:: API_vhci_host_register_callback
 .. doxygenfunction:: API_vhci_host_send_packet
 .. doxygenfunction:: bt_controller_init
-
diff --git a/docs/api/ledc.rst b/docs/api/ledc.rst
index f379e9d008..855f822163 100644
--- a/docs/api/ledc.rst
+++ b/docs/api/ledc.rst
@@ -27,7 +27,10 @@ Data Structures
 ^^^^^^^^^^^^^^^
 
 .. doxygenstruct:: ledc_channel_config_t
+   :members:
+
 .. doxygenstruct:: ledc_timer_config_t
+   :members:
 
 Macros
 ^^^^^^
diff --git a/docs/api/nvs_flash.rst b/docs/api/nvs_flash.rst
index 5d36343552..a765f7608e 100644
--- a/docs/api/nvs_flash.rst
+++ b/docs/api/nvs_flash.rst
@@ -5,8 +5,23 @@ Application Example
 
 Two examples are provided in ESP-IDF examples directory:
 
-- `07_nvs_rw_value <https://github.com/espressif/esp-idf/tree/master/examples/07_nvs_rw_value>`_ demostrates how to read and write integer values
-- `08_nvs_rw_blob <https://github.com/espressif/esp-idf/tree/master/examples/08_nvs_rw_blob>`_ demostrates how to read and write variable length binary values
+`07_nvs_rw_value <https://github.com/espressif/esp-idf/blob/master/examples/07_nvs_rw_value/main/nvs_rw_value.c>`_
+
+  Demonstrates how to read and write a single integer value using NVS.
+
+  The value holds the number of ESP32 module restarts. Since it is written to NVS, the value is preserved between restarts.
+
+  Example also shows how to check if read / write operation was successful, or certain value is not initialized in NVS. Diagnostic is provided in plain text to help track program flow and capture any issues on the way.
+
+`08_nvs_rw_blob <https://github.com/espressif/esp-idf/blob/master/examples/08_nvs_rw_blob/main/nvs_rw_blob.c>`_
+
+  Demonstrates how to read and write a single integer value and a blob (binary large object) using NVS to preserve them between ESP32 module restarts.
+
+    * value - tracks number of ESP32 module soft and hard restarts.
+    * blob - contains a table with module run times. The table is read from NVS to dynamically allocated RAM. New run time is added to the table on each manually triggered soft restart and written back to NVS. Triggering is done by pulling down GPIO0.
+
+  Example also shows how to implement diagnostics if read / write operation was successful.
+
 
 API Reference
 -------------
diff --git a/docs/api/vfs.rst b/docs/api/vfs.rst
index df6cd03f67..798aac5492 100644
--- a/docs/api/vfs.rst
+++ b/docs/api/vfs.rst
@@ -25,6 +25,7 @@ Structures
 ^^^^^^^^^^
 
 .. doxygenstruct:: esp_vfs_t
+   :members:
 
 Functions
 ^^^^^^^^^

From a86c431f981cb20031997c95352232d49865a5dd Mon Sep 17 00:00:00 2001
From: Krzysztof <krzychb@gazeta.pl>
Date: Wed, 16 Nov 2016 20:16:47 +0100
Subject: [PATCH 4/6] doc: Formating clean up

---
 docs/build_system.rst         | 15 ++++++++++-----
 docs/security/secure-boot.rst |  8 ++++----
 2 files changed, 14 insertions(+), 9 deletions(-)

diff --git a/docs/build_system.rst b/docs/build_system.rst
index aa14cdda56..4ba89f8652 100644
--- a/docs/build_system.rst
+++ b/docs/build_system.rst
@@ -57,6 +57,7 @@ Example Project
 ---------------
 
 An example project directory tree might look like this::
+
     - myProject/
                  - Makefile
                  - sdkconfig
@@ -66,11 +67,11 @@ An example project directory tree might look like this::
                                - component2/ - component.mk
                                              - Kconfig
                                              - src1.c
-                                             - include/
-                                                    - component2.h
+                                             - include/ - component2.h
                  - main/       - src1.c
                                - src2.c
                                - component.mk
+
                  - build/
 
 This example "myProject" contains the following elements:
@@ -101,6 +102,7 @@ Minimal Example Makefile
 ^^^^^^^^^^^^^^^^^^^^^^^^
 
 ::
+
    PROJECT_NAME := myProject
    
    include $(IDF_PATH)/make/project.mk
@@ -135,7 +137,8 @@ Minimal Component Makefile
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The minimal ``component.mk`` file is an empty file(!). If the file is empty, the default component behaviour is set:
-- All source files in the same directory as the makefile (*.c, *.cpp, *.S) will be compiled into the component library
+
+- All source files in the same directory as the makefile (``*.c``, ``*.cpp``, ``*.S``) will be compiled into the component library
 - A sub-directory "include" will be added to the global include search path for all other components.
 - The component library will be linked into the project app.
 
@@ -209,8 +212,8 @@ The following variables can be set inside ``component.mk`` to control the build
   ``COMPONENT_PRIV_INCLUDEDIRS`` variable, except these paths are not
   expanded relative to the component directory.
 - ``COMPONENT_SRCDIRS``: Directory paths, must be relative to the
-  component directory, which will be searched for source files (*.cpp,
-  *.c, *.S). Defaults to '.', ie the component directory
+  component directory, which will be searched for source files (``*.cpp``,
+  ``*.c``, ``*.S``). Defaults to '.', ie the component directory
   itself. Override this to specify a different list of directories
   which contain source files.
 - ``COMPONENT_OBJS``: Object files to compile. Default value is a .o
@@ -366,12 +369,14 @@ The configuration system can be used to conditionally compile some files
 depending on the options selected in ``make menuconfig``:
 
 ``Kconfig``::
+
     config FOO_ENABLE_BAR
         bool "Enable the BAR feature."
         help
             This enables the BAR feature of the FOO component.
 
 ``component.mk``::
+
     COMPONENT_OBJS := foo_a.o foo_b.o
 
     ifdef CONFIG_FOO_BAR
diff --git a/docs/security/secure-boot.rst b/docs/security/secure-boot.rst
index b352b3964c..113d250902 100644
--- a/docs/security/secure-boot.rst
+++ b/docs/security/secure-boot.rst
@@ -27,18 +27,18 @@ This is a high level overview of the secure boot process. Step by step instructi
 
 2. Secure Boot Configuration includes "Secure boot signing key", which is a file path. This file is a ECDSA public/private key pair in a PEM format file.
 
-2. The software bootloader image is built by esp-idf with secure boot support enabled and the public key (signature verification) portion of the secure boot signing key compiled in. This software bootloader image is flashed at offset 0x1000.
+3. The software bootloader image is built by esp-idf with secure boot support enabled and the public key (signature verification) portion of the secure boot signing key compiled in. This software bootloader image is flashed at offset 0x1000.
 
-3. On first boot, the software bootloader follows the following process to enable secure boot:
+4. On first boot, the software bootloader follows the following process to enable secure boot:
 
    - Hardware secure boot support generates a device secure bootloader key (generated via hardware RNG, then stored read/write protected in efuse), and a secure digest. The digest is derived from the key, an IV, and the bootloader image contents.
    - The secure digest is flashed at offset 0x0 in the flash.
    - Depending on Secure Boot Configuration, efuses are burned to disable JTAG and the ROM BASIC interpreter (it is strongly recommended these options are turned on.)
    - Bootloader permanently enables secure boot by burning the ABS_DONE_0 efuse. The software bootloader then becomes protected (the chip will only boot a bootloader image if the digest matches.)
 
-4. On subsequent boots the ROM bootloader sees that the secure boot efuse is burned, reads the saved digest at 0x0 and uses hardware secure boot support to compare it with a newly calculated digest. If the digest does not match then booting will not continue. The digest and comparison are performed entirely by hardware, and the calculated digest is not readable by software. For technical details see `Hardware Secure Boot Support`.
+5. On subsequent boots the ROM bootloader sees that the secure boot efuse is burned, reads the saved digest at 0x0 and uses hardware secure boot support to compare it with a newly calculated digest. If the digest does not match then booting will not continue. The digest and comparison are performed entirely by hardware, and the calculated digest is not readable by software. For technical details see `Hardware Secure Boot Support`.
 
-5. When running in secure boot mode, the software bootloader uses the secure boot signing key (the public key of which is embedded in the bootloader itself, and therefore validated as part of the bootloader) to verify the signature appended to all subsequent partition tables and app images before they are booted.
+6. When running in secure boot mode, the software bootloader uses the secure boot signing key (the public key of which is embedded in the bootloader itself, and therefore validated as part of the bootloader) to verify the signature appended to all subsequent partition tables and app images before they are booted.
 
 Keys
 ----

From dd0585e84e6e28039131bc227b1b0010eeeea28a Mon Sep 17 00:00:00 2001
From: Krzysztof <krzychb@gazeta.pl>
Date: Wed, 16 Nov 2016 20:17:44 +0100
Subject: [PATCH 5/6] doc: Index clean up

---
 docs/index.rst | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/docs/index.rst b/docs/index.rst
index 8bc7a72f29..adf07b586e 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -5,6 +5,9 @@ ESP32 Programming Guide
 
    Until ESP-IDF release 1.0, this documentation is a draft. It is incomplete and may have mistakes. Please mind your step!
 
+Documentation adressed to developers of applications for `ESP32 <https://espressif.com/en/products/hardware/esp32/overview>`_ by `Espressif <https://espressif.com/>`_ using `esp-idf <https://github.com/espressif/esp-idf>`_.
+
+
 Contents:
 
 .. toctree::
@@ -41,7 +44,7 @@ Contents:
    1. System - TBA
      1.1. Fundamentals of multiprocessor programming with FreeRTOS - TBA
      1.2. Application startup flow - TBA
-     1.3. Flash encryption and secure boot: how they work and APIs - TBA
+     1.3. Flash encryption and secure boot: how they work and APIs
      1.4. Lower Power Coprocessor - TBA
      1.5. Watchdogs <api/wdts>
      1.6. ...
@@ -61,7 +64,7 @@ Contents:
      6.1. GPIO
      6.2. ADC - TBA
      6.3. DAC - TBA
-     6.4. UART - TBA
+     6.4. UART
      6.5. I2C - TBA
      6.6. I2S - TBA
      6.7. SPI - TBA
@@ -78,9 +81,9 @@ Contents:
      7.3. Touch Sensor - TBA
    8. Protocols - TBA
    9. Components
-     9.1. Logging <api/log>
-     9.2  Non-Volatile Storage <api/nvs_flash>
-     9.3  Virtual Filesystem <api/vfs>
+     9.1. Logging
+     9.2  Non-Volatile Storage
+     9.3  Virtual Filesystem
      9.3. Http sever - TBA
    10. Applications - TBA
    ..
@@ -128,11 +131,9 @@ Contents:
 
    COPYRIGHT
 
-.. About - TBA
-
  
 Indices
-=======
+-------
 
 * :ref:`genindex`
 * :ref:`search`

From d4b5bd347da854a79bee24a3ee88741fcca4a362 Mon Sep 17 00:00:00 2001
From: Krzysztof <krzychb@gazeta.pl>
Date: Wed, 16 Nov 2016 20:27:55 +0100
Subject: [PATCH 6/6] Doxygen configuration clean up

---
 docs/Doxyfile | 37 ++++++++++++++++++++++++++++++-------
 1 file changed, 30 insertions(+), 7 deletions(-)

diff --git a/docs/Doxyfile b/docs/Doxyfile
index 1f53a85931..eeb4fe740d 100644
--- a/docs/Doxyfile
+++ b/docs/Doxyfile
@@ -1,3 +1,18 @@
+# This is Doxygen configuration file
+#
+# Doxygen provides over 260 configuration statements
+# To make this file easier to follow, 
+# it contains only statements that are non-default
+#
+# NOTE:
+# It is recommended not to change defaults unless specifically required
+# Test any changes how they affect generated documentation
+# Make sure that correct warnings are generated to flag issues with documented code
+#
+# For the complete list of configuration statements see:
+# http://www.stack.nl/~dimitri/doxygen/manual/config.html
+
+
 PROJECT_NAME = "ESP32 Programming Guide"
 
 INPUT = ../components/esp32/include/esp_wifi.h \
@@ -10,14 +25,18 @@ INPUT = ../components/esp32/include/esp_wifi.h \
 	../components/esp32/include/esp_int_wdt.h \
 	../components/esp32/include/esp_task_wdt.h
 
-WARN_NO_PARAMDOC	= YES
+## Get warnings for functions that have no documentation for their parameters or return value 
+##
+WARN_NO_PARAMDOC = YES
 
-RECURSIVE		= NO
-CASE_SENSE_NAMES 	= NO
-EXTRACT_ALL		= NO
+## Do not complain about not having dot
+##
+HAVE_DOT = NO
 
-GENERATE_XML		= YES
-XML_OUTPUT		= xml
+## Generate XML that is required for Breathe
+##
+GENERATE_XML = YES
+XML_OUTPUT = xml
 
 GENERATE_HTML		= NO
 HAVE_DOT		= NO
@@ -25,5 +44,9 @@ GENERATE_LATEX		= NO
 GENERATE_MAN		= YES
 GENERATE_RTF		= NO
 
+## Skip distracting progress messages
+##
+QUIET = YES
+## Log warnings in a file for further review
+##
 WARN_LOGFILE = "doxygen-warning-log.txt"
-