documentation/sphinx: Prepare source and configuration files for PDF docs release

Fixes broken references to other documents/sections/websites.
Moves misplaced tutorials from the `mynewt-core` repository.
Sets fixed width for some images that were too big for PDF output.
Removes incompatible emojis from code snippets.
Adjusts Sphinx config to:
 - ignore all `README` files,
 - add Mynewt logo on the first page.

Author: wpiet

docs/_static/common.rst

@@ -77,7 +77,7 @@
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
 # This patterns also effect to html_static_path and html_extra_path
-exclude_patterns = ['_build', 'README.rst', 'Thumbs.db', '.DS_Store', 'themes']
+exclude_patterns = ['_build', '**README.rst', 'Thumbs.db', '.DS_Store', 'themes']
 
 # The name of the Pygments (syntax highlighting) style to use.
 pygments_style = 'sphinx'
@@ -147,6 +147,7 @@
      u'The Apache Software Foundation', 'manual'),
 ]
 
+latex_logo = '_static/img/logo.png'
 
 # -- Options for manual page output ---------------------------------------
 

docs/conf.py

@@ -33,7 +33,7 @@ install the other compiler. However, one can install gcc compiler with brew:
     ...
     ...
     ==> Pouring gcc-10.2.0_2.big_sur.bottle.tar.gz
-    🍺  /usr/local/Cellar/gcc/10.2.0_2: 1,455 files, 338.1MB
+        /usr/local/Cellar/gcc/10.2.0_2: 1,455 files, 338.1MB
 
 
 Check the GCC version you have installed (either using ``brew`` or
@@ -68,7 +68,7 @@ Installing GDB
     ...
     ...
     ==> Summary
-    🍺  /usr/local/Cellar/gdb/7.10.1: XXX files,YYM
+        /usr/local/Cellar/gdb/7.10.1: XXX files,YYM
 
 **NOTE:** When running a program with GDB, you may need to sign your ``gdb``
 executable. `This

docs/get_started/native_install/native_tools.rst

@@ -76,6 +76,7 @@ It should look like this:
 
 .. figure:: pics/ft232h.png
    :alt: FT232H Wiring
+   :width: 180
 
    FT232H Wiring
 
@@ -93,6 +94,7 @@ you're done, your wiring should look like this:
 
 .. figure:: pics/nrf52dk.png
    :alt: NRF52DK Wiring
+   :width: 180
 
    NRF52DK Wiring
 
@@ -107,6 +109,7 @@ Your Arduino M0 Pro should look like this:
 
 .. figure:: pics/m0pro.png
    :alt: Arduino M0 Pro Wiring
+   :width: 180
 
    Arduino M0 Pro Wiring
 

docs/get_started/serial_access.rst

@@ -26,7 +26,7 @@ This guide shows you how to perform the following:
   :depth: 2
 
 **Note:** You will also need to read and follow the instructions from
-the :doc:`faq` to set up your git repos to submit changes.
+the :doc:`../mynewt_faq/index` to set up your git repos to submit changes.
 
 Step 1: Installing Go
 ~~~~~~~~~~~~~~~~~~~~~
@@ -57,7 +57,7 @@ Use brew to install Go:
     ...
     ...
     ==> Summary
-    🍺  /usr/local/Cellar/go/1.8.3: 7,035 files, 282.0MB
+        /usr/local/Cellar/go/1.8.3: 7,035 files, 282.0MB
 
 You can also download the Go package directly from
 (https://golang.org/dl/) and install it in /usr/local/bin instead of
@@ -219,7 +219,7 @@ tools.
    is installed.
 2. Pull the latest changes from the master branch. If you made changes
    you will need to rebase with **origin master** (See
-   :doc:`faq`).
+   :doc:`../mynewt_faq/index`).
 3. Build and install the tool.
 
 Change to the directory where the source for the tool is installed.

docs/misc/go_env.rst

@@ -43,7 +43,7 @@ Setting ``serial`` and ``mfghash``
 
 **A**: ``mfghash`` is computed if you’re using ``newt mfg`` to construct your flash image, and it identifies the build of 
 your bootloader. ``newt mfg`` bundles togetherthe bootloader, target image, and other data you’d want to bundle when creating 
-an image to burn to flash. See the ``newt mfg`` :doc:`documentation <../../../../command_list/newt_mfg>` for the construction 
+an image to burn to flash. See the ``newt mfg`` :doc:`documentation <../newt/command_list/newt_mfg>` for the construction
 side of things and ``apache-mynewt-core/sys/mfg/src/mfg.c`` for the firmware side. ``serial`` was intended to be used if you 
 want to have your own naming scheme per device when building products; i.e. you want something other than the mcu serial 
 number, or if you don’t have serial number available.

docs/mynewt_faq/syntax_faq.rst

@@ -85,8 +85,7 @@ Enable Trace in Mynewt
     pkg.type: "target"
     pkg.description: 
     pkg.author: 
-    pkg.homepage: 
-    ​
+    pkg.homepage:
     pkg.cflags:
       - -DENABLE_TRACE
 

docs/mynewt_faq/troubleshoot_faq.rst

@@ -138,8 +138,7 @@ Connection callbacks are used to communicate a variety of events related
 to a connection. An application determines the type of event that
 occurred by inspecting the value of the *event->type* parameter. The
 full list of event codes can be found on the :doc:`GAP
-events <../../../../network/ble/ble_hs/ble_gap/definitions/ble_gap_defs/>`
-page.
+page <../../../../network/ble_hs/ble_gap>`.
 
 Guarantees
 ^^^^^^^^^^

docs/tutorials/ble/bleprph/bleprph-sections/bleprph-gap-event.rst

@@ -233,8 +233,7 @@ The ``ble_gatts_add_svcs()`` function returns 0 on success, or a
 *BLE_HS_E[...]* error code on failure.
 
 More detailed information about the registration callback function can
-be found in the :doc:`BLE User Guide <../../../network/ble/ble_intro>`
-(TBD).
+be found in the :doc:`BLE User Guide <../../../../network/index>`.
 
 The *bleprph* app registers its services as follows:
 
@@ -251,4 +250,4 @@ Descriptors and Included Services
 Your peripheral can also expose descriptors and included services. These
 are less common, so they are not covered in this tutorial. For more
 information, see the :doc:`BLE User
-Guide <../../../network/ble/ble_intro>`.
+Guide <../../../../network/index>`.

docs/tutorials/ble/bleprph/bleprph-sections/bleprph-svc-reg.rst

@@ -38,7 +38,7 @@ pages:
 
 -  :doc:`Create Your First Mynewt Project <../../../get_started/project_create>`
 -  :doc:`BLE Bare Bones Application Tutorial <../ble_bare_bones>`
--  :doc:`NimBLE Stack Initialization <../../../network/ble/ini_stack/ble_ini_intro>`
+-  :doc:`NimBLE Stack Initialization <../../../network/ble_setup/ble_setup_intro>`
 
 Services, Characteristics, Descriptors
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^