Linaro EDGE (LEDGE) reference platform documentation

The LEDGE documentation describes instructions to build, install and use varios features included in LEDGE linux reference platform.

Contributing

Anyone may contribute to LEDGE doc. Discussion is on the [email protected] mailing list, or linaro-ledge irc channel at freenode.

Build Instructions

Requirements

• Sphinx version 1.5 or later: http://sphinx-doc.org/en/master/contents.html
• LaTeX (and pdflatex, and various LaTeX packages)

On Debian and Ubuntu

# apt-get install python-sphinx texlive texlive-latex-extra libalgorithm-diff-perl \
                  texlive-humanities texlive-generic-recommended texlive-generic-extra \
                  latexmk

If the version of python-sphinx installed is too old, then an additional new version can be installed with the Python package installer:

$ apt-get install python-pip
$ pip install --user --upgrade Sphinx
$ export SPHINXBUILD=~/.local/bin/sphinx-build

Export SPHINXBUILD (see above) if Sphinx was installed with pip --user, then follow Make commands below

On Fedora

# dnf install python2-sphinx texlive texlive-capt-of texlive-draftwatermark \
              texlive-fncychap texlive-framed texlive-needspace \
              texlive-tabulary texlive-titlesec texlive-upquote \
              texlive-wrapfig

It is also possible to use python3-sphinx; this requires SPHINXBUILD=sphinx-build-3 to be passed on the Make command line.

On Mac OS X

• Install MacTeX

• Install pip if you do not have it:

  $ sudo easy_install pip
  

• Install Sphinx:

  $ pip install --user --upgrade Sphinx
  

Make Targets

To generate PDF:

$ make latexpdf

To generate hierarchy of HTML pages:

$ make html

To generate a single HTML page:

$ make singlehtml

Output goes in ./build subdirectory.

License

International License (CC-BY-SA-4.0). To view a copy of this license, visit http://creativecommons.org/licenses/by-sa/4.0/ or send a letter to Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.

Contributions are accepted under the same with sign-off under the Developer's Certificate of Origin. For more on contributing to EBBR, see CONTRIBUTING.rst.

A copy of the license is included in the LICENSE file.

Writers Guide

All documentation in this repository uses reStructuredText markup with Sphinx extensions.

All files in this project must include the relevant SPDX license identifier tag. Generally this means each .rst file should include the line

.. SPDX-License-Identifier: CC-BY-SA-4.0