From 84abc5764ddab831c80040abbc0d0c0171e6d216 Mon Sep 17 00:00:00 2001
From: Ivan Kravets <me@ikravets.com>
Date: Fri, 26 Aug 2016 19:11:35 +0300
Subject: [PATCH] Improve docs for library.json `build` field

---
 docs/librarymanager/config.rst | 72 +++++++++++++++++++++-------------
 1 file changed, 44 insertions(+), 28 deletions(-)

diff --git a/docs/librarymanager/config.rst b/docs/librarymanager/config.rst
index 0d74243d..3f96814a 100644
--- a/docs/librarymanager/config.rst
+++ b/docs/librarymanager/config.rst
@@ -284,8 +284,8 @@ reduce size of the final archive.
 
 Possible options:
 
-* ``include``
-* ``exclude``
+.. contents::
+    :local:
 
 ``include``
 ~~~~~~~~~~~
@@ -483,39 +483,55 @@ A list of example patterns. This field is predefined with default value:
 .. _libjson_build:
 
 ``build``
-------------
+---------
 
 *Optional* | Type: ``Object``
 
 Specify advanced settings, options and flags for the build system. Possible
 options:
 
-.. list-table::
-    :header-rows:  1
+.. contents::
+    :local:
 
-    * - Option
-      - Type
-      - Description
-    * - ``flags``
-      - ``String`` or ``Array``
-      - Extra flags to control preprocessing, compilation, assembly and
-        linking processes. More details :ref:`projectconf_build_flags`
-    * - ``unflags``
-      - ``String`` or ``Array``
-      - Remove base/initial flags which were set by development
-        platform. More details :ref:`projectconf_build_unflags`
-    * - ``srcFilter``
-      - ``String`` or ``Array``
-      - Specify which source files should be included/excluded
-        from build process. More details :ref:`projectconf_src_filter`
-    * - ``extraScript``
-      - ``String``
-      - Launch extra script before build process.
-        More details :ref:`projectconf_extra_script`
-    * - ``libArchive``
-      - ``Boolean``
-      - Archive object files to Static Library. This is default behavior of
-        PlatformIO Build System (``"libArchive": true``).
+``flags``
+~~~~~~~~~
+
+*Optional* | Type: ``String`` or ``Array``
+
+Extra flags to control preprocessing, compilation, assembly and linking
+processes. More details :ref:`projectconf_build_flags`.
+
+``unflags``
+~~~~~~~~~~~
+
+*Optional* | Type: ``String`` or ``Array``
+
+Remove base/initial flags which were set by development platform. More
+details :ref:`projectconf_build_unflags`.
+
+``srcFilter``
+~~~~~~~~~~~~~
+
+*Optional* | Type: ``String`` or ``Array``
+
+Specify which source files should be included/excluded from build process.
+More details :ref:`projectconf_src_filter`.
+
+``extraScript``
+~~~~~~~~~~~~~~~
+
+*Optional* | Type: ``String``
+
+Launch extra script before build process.
+More details :ref:`projectconf_extra_script`.
+
+``libArchive``
+~~~~~~~~~~~~~~
+
+*Optional* | Type: ``Boolean``
+
+Archive object files to Static Library. This is default behavior of PlatformIO
+Build System (``"libArchive": true``).
 
 **Examples**