From 36f3ce1c5fb977e69e4cfbcef896748aafa14fcd Mon Sep 17 00:00:00 2001 From: Marti Bolivar Date: Thu, 7 Oct 2010 07:06:22 -0400 Subject: added docs readme file --- README | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) create mode 100644 README (limited to 'README') diff --git a/README b/README new file mode 100644 index 0000000..8556dd2 --- /dev/null +++ b/README @@ -0,0 +1,28 @@ +This directory contains the Sphinx documentation for libmaple. You +can generate HTML documentation using the Makefile if you have make, +or using make.bat from Windows. + +For the impatient, you can build the HTML docs with (on Unix): + + $ sudo easy_install -U Sphinx + $ make html + +Which will produce HTML documentation in build/html. + +All of the documentation itself lives in source/. The directory +source/_static is for static content like style sheets; +source/_templates contains Sphinx templates. + +The documentation is written in reStructuredText (reST); it's a Python +thing that they use to produce the docs at python.org (which are +beautiful, if you've never seen them). You can read more about Sphinx +here: + + http://sphinx.pocoo.org/tutorial.html + +Specific information on documenting C and C++ is available here: + + http://sphinx.pocoo.org/domains.html + +The file source/conf.py is an autogenerated configuration file; you +can read it yourself. -- cgit v1.2.3