From 9f0a1e2911100ae7601aa2d7519b0d2003c87cf3 Mon Sep 17 00:00:00 2001 From: Marti Bolivar Date: Mon, 22 Aug 2011 17:13:50 -0400 Subject: README: updates/cosmetics. --- README | 20 +++++++++++--------- 1 file 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 -- cgit v1.2.3