[rtems-docs commit] README: Add host set up and update the build commands.
Chris Johns
chrisj at rtems.org
Thu Nov 3 03:42:40 UTC 2016
Module: rtems-docs
Branch: master
Commit: 040b703c14b01d1dd33766c134d80780964996f9
Changeset: http://git.rtems.org/rtems-docs/commit/?id=040b703c14b01d1dd33766c134d80780964996f9
Author: Chris Johns <chrisj at rtems.org>
Date: Thu Nov 3 14:34:40 2016 +1100
README: Add host set up and update the build commands.
---
README.txt | 43 ++++++++++++++++++++++++++++++++++++++-----
1 file changed, 38 insertions(+), 5 deletions(-)
diff --git a/README.txt b/README.txt
index 5132a9e..68f4554 100644
--- a/README.txt
+++ b/README.txt
@@ -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
----------------------
More information about the vc
mailing list