diff options
author | Chris Johns <chrisj@rtems.org> | 2016-11-03 14:34:40 +1100 |
---|---|---|
committer | Chris Johns <chrisj@rtems.org> | 2016-11-03 14:34:40 +1100 |
commit | 040b703c14b01d1dd33766c134d80780964996f9 (patch) | |
tree | 4e6f704d38bf024f3f5872e486c4f4669f0176d4 | |
parent | waf: Have configure set building pdf and/or singlehtml. (diff) | |
download | rtems-docs-040b703c14b01d1dd33766c134d80780964996f9.tar.bz2 |
README: Add host set up and update the build commands.
-rw-r--r-- | README.txt | 43 |
1 files changed, 38 insertions, 5 deletions
@@ -6,19 +6,49 @@ check the version and ensure you have a suitable version. If your host does not provide a packaged version use PIP to fetch a recent version. The Sphinx website provides details on doing this. -Building PDF requires a full Latex install. +ReST is the Re-Structed-Text format. It is a simple markup language that allows +us to create quality documentaion. It is flexible and powerful however do not +attempt to train it to create a specific format. You need to test any new way +of present something on all output formats. What may look great in one format +may not translate with the same clarity to another output format. + +The RTEMS Documentation output formats are: + + HTML - Multi-page HTML with files in a single directory per manual. + PDF - Single PDF per manual. + SIngle HTML - Single HTML, one file per manual. + +Host Setup +---------- + +HTML builds directly with Sphinx, PDF requires a full Latex install, and +building a Single HTML page requires the 'inliner' tool. + +Please add your host as you set it up. + +FreeBSD +~~~~~~~ + +Sphinx: + # pkg install py27-sphinx + +PDF: + # pkg install texlive-full + +Single HTML: + # pkg install npm + # npm install -g inliner Building -------- To build enter in the top directory: - $ ./waf configure + $ ./waf configure [--pdf] [--singlehtml] [--prefix] $ ./waf -PDF output can be built without needing to configure again: - - $ ./waf --pdf +The '--pdf' and '--singlehtml' options can be added to build those output +formats. To build and install to a specific location: @@ -31,6 +61,9 @@ version level: $ ./waf configure --sphinx-verbose=-v $ ./waf clean build +You can enter a manual's directory and run the same configure command and build +just that manual. + Documentation Standard ---------------------- |