Idris2/docs
Edwin Brady d60feaace0 Add finalisers to Chez back end
This involves new primitives GCPtr and GCAnyPtr which are pointer types
that have finalisers attached. The finalisers are run when the
associated pointer goes out of scope.

In the test, I am assuming that the GC will only be called once, right
at the end. Otherwise, the output isn't guaranteed to be deterministic!
Let's see how this assumption holds...

This is currently Chez only. I think it'll be easy enough to add to
the Racket and Gambit back ends too.
2020-06-08 20:34:23 +01:00
..
source Add finalisers to Chez back end 2020-06-08 20:34:23 +01:00
LICENSE Copy more files over from Idris2 2020-05-20 11:23:04 +01:00
make.bat replace HTTP links with HTTPS 2020-05-27 14:50:05 +02:00
Makefile Copy more files over from Idris2 2020-05-20 11:23:04 +01:00
README.md Copy more files over from Idris2 2020-05-20 11:23:04 +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. Recommended way is to use virtual environment for building documentation.

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 in virtual environment using pip as follows:

python3 -m venv idris2docs_venv
source idris2docs_venv/bin/activate
pip install --upgrade pip
pip install sphinx_rtd_theme

LaTeX

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

Build Instructions

cd docs
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:

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

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