aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--README20
1 files changed, 11 insertions, 9 deletions
diff --git a/README b/README
index d5aab21..15c1006 100644
--- a/README
+++ b/README
@@ -1,7 +1,7 @@
Introduction
------------
-This directory contains reStructuredText (reST) source files used to
+This repository contains reStructuredText (reST) source files used to
generate the documentation for LeafLabs' libmaple and Maple IDE
projects. For more information on these projects, see their GitHub
pages:
@@ -33,9 +33,8 @@ The docs are written in Sphinx's extensions to reStructuredText
http://sphinx.pocoo.org/tutorial.html
-Much of the documentation is pulled out of the libmaple source code;
-we pull Doxygen's XML output into Sphinx documentation. You can read
-more about Doxygen here:
+Much of the documentation is pulled out of the libmaple source code.
+libmaple documents itself using Doxygen:
http://doxygen.org
@@ -47,8 +46,8 @@ into a form usable by Sphinx. You can read more about Breathe here:
Documentation Build Steps
-------------------------
-You first need to produce Doxygen XML output, then you can generate
-the HTML documentation.
+First, you will need to install some dependencies (Doxygen, Sphinx,
+and Breathe).
1. You need a recent-ish version of Doxygen in your PATH:
@@ -83,14 +82,17 @@ the HTML documentation.
You need Sphinx version >= 1.0.6.
-4. Before the first time you run Sphinx (and any time the Doxygen
+You are now ready to build the documentation. First, you'll produce
+Doxygen XML output, then you can generate the HTML documentation.
+
+1. Before the first time you run Sphinx (and any time the Doxygen
comments in the libmaple source code are changed), you'll need to
rebuild libmaple's Doxygen XML output. That is, from within the
- libmaple (i.e., NOT THIS REPOSITORY), run:
+ libmaple repository (i.e., NOT THIS REPOSITORY), run:
$ make doxygen
-5. Finally, you can build the documentation (in this folder):
+2. Finally, you can build the documentation (in this folder):
$ make html