Idris-dev/docs
Jeremy W. Sherman 056b307e7d Update running text to match code change
Forgot to update the description of what was printed on success
when I updated what was printed on success in both the code and the sample
output.
2015-08-08 15:10:01 -04:00
..
effects Merge pull request #2408 from mjgpy3/metavariable_to_hole_docs 2015-07-08 01:10:05 +02:00
faq Update FAQ 2015-06-14 12:04:58 +01:00
guides Replace "metavariable" with "hole" 2015-06-30 20:37:17 -04:00
image Sphinx Based Documentation for Idris. 2015-03-17 16:19:11 +00:00
listing Extracted listings for prompts into external files. 2015-03-18 07:38:57 +00:00
proofs Replace "metavariable" with "hole" 2015-06-30 20:37:17 -04:00
reference Fixed styling for multi line string literal docs 2015-07-30 00:31:17 +02:00
tutorial Update running text to match code change 2015-08-08 15:10:01 -04:00
.gitignore Sphinx Based Documentation for Idris. 2015-03-17 16:19:11 +00:00
conf.py Bumped doc version number 2015-05-27 12:44:05 +01:00
index.rst Fix missing index contents 2015-06-29 14:28:36 +01:00
LICENSE Updated license to be CC0 and restored missing section. 2015-03-19 19:13:16 +00:00
make.bat Sphinx Based Documentation for Idris. 2015-03-17 16:19:11 +00:00
Makefile Sphinx Based Documentation for Idris. 2015-03-17 16:19:11 +00:00
README.md Can build docs locally using ReadTheDocs Theme. 2015-03-31 10:22:03 +01:00

Documentation for the Idris Language.

This manual has been prepared using ReStructured Text and the Sphinx Documentation Generator for future inclusion on Read The Docs.

Dependencies

To build the manual the following dependencies must be met. We assume that you have standard build automation tools already install i.e. make.

Sphinx-Doc

Python should be installed by default on most systems. Sphinx can be installed either through your hosts package manager or using pip/easy_install.

Note ReadTheDocs works with Sphinx v1.2.2. If you install a more recent version of sphinx then 'incorrectly' marked up documentation may get passed the build system of readthedocs and be ignored. In the past we had several code-blocks disappear because of that.

The ReadTheDocs theme can be installed using pip as follows:

pip install sphinx_rtd_theme

LaTeX

LaTeX can be install either using your systems package manager or direct from TeXLive.

Build Instructions

make html
make latexpdf

Contributing

The documentation for Idris has been published under the Creative Commons CC0 License. As such to the extent possible under law, /The Idris Community/ has waived all copyright and related or neighboring rights to Documentation for Idris.

More information concerning the CC0 can be found online at:

http://creativecommons.org/publicdomain/zero/1.0/

When contributing material to the manual please bear in mind that the work will be licensed as above.