aboutsummaryrefslogtreecommitdiffstats
path: root/docs/README
diff options
context:
space:
mode:
Diffstat (limited to 'docs/README')
-rw-r--r--docs/README28
1 files changed, 28 insertions, 0 deletions
diff --git a/docs/README b/docs/README
new file mode 100644
index 0000000..8556dd2
--- /dev/null
+++ b/docs/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.