homebrew
_.. code-block:: bash
$ brew --version Homebrew 1.1.7
.. code-block:: bash
$ python --version Python 2.7.10
pip
_.. code-block:: bash
$ pip --version pip 9.0.1 from /Library/Python/2.7/site-packages (python 2.7)
Toolchain Install:
.. code-block:: bash
$ git clone https://github.com/sphinx-doc/sphinx.git sphinx
$ cd sphinx && sudo -E python setup.py install && cd ..
$ git clone https://github.com/michaeljones/breathe.git breathe
$ cd breathe && sudo -E python setup.py install && cd ..
$ brew install doxygen
$ sudo pip install recommonmark
Most Linux distributions provide necessary packages in their repositories.
Ubuntu/Debian .. code-block:: bash
sudo apt-get install doxygen python3-breathe python3-recommonmark
Fedora .. code-block:: bash
sudo dnf install doxygen python3-breathe python3-recommonmark
NOTE: These instructions assume that your workspace has all the mynewt repos cloned under the same parent directory.
master
and that the master
branch is checked out.Site Docs
_ to release the docs.When the master/latest documentation is deemed representative of a Mynewt version, it is time to create a versioned set.
Make sure all your mynewt-* repos are up to date and that all changes are merged and committed.
Add the new version to mynewt-documentation/docs/themes/mynewt/versions.html
mynewt-documentation/versions/*/mynewt-documentation/docs/themes/mynewt/versions.html
Make a versions/vX_Y_Z directory
Copy mynewt-documentation/* (except versions!) into versions/vX_Y_Z/mynewt-documentation
Copy the mynewt-core repo into versions/vX_Y_Z/mynewt-core
Repeat for other mynewt-* repos with doxygen docs and a /docs folder
Update the version fields in
docs/conf.py
versions/vX_Y_Z/mynewt-documentation/docs/conf.py
Add a warning that this is not the most recent documentation to:
To preview the changes:
.. code-block:: bash
cd mynewt-documentation/versions/vX_Y_Z/mynewt-documentation make clean && make docs && (cd _build/html && python -m SimpleHTTPServer 8080)
.. _Apache Mynewt: https://mynewt.apache.org/ .. _Sphinx: http://www.sphinx-doc.org/ .. _Doxygen: http://www.doxygen.org/ .. _Homebrew: http://brew.sh/ .. _Pip: https://pip.readthedocs.io/en/stable/installing/ .. _Breathe: http://breathe.readthedocs.io/en/latest/ .. _Site Docs: https://github.com/apache/mynewt-site#deploying-the-latest-docs