on master help sign in
rearrange documentation for elaborator reflection
840d3e4martinbaker
docs/proofs/elabReflection.rst → docs/elaboratorReflection/elabReflection.rstrenamed

The content is the same.

docs/reference/elaborator-reflection.rst → docs/elaboratorReflection/elaborator-reflection.rstrenamed+6−5
@@ -1,8 +1,8 @@
1.. _elaborator-reflection:
1.. _elaborator-reflection:
2
2
3−*********************
3+**********************************
4−Elaborator Reflection
4+Elaborator Reflection Introduction
5−*********************
5+**********************************
6
6
7The Idris elaborator is responsible for converting high-level Idris code into the core language.
7The Idris elaborator is responsible for converting high-level Idris code into the core language.
8It is implemented as a kind of embedded tactic language in Haskell, where tactic scripts are written in an *elaboration monad* that provides error handling and a proof state.
8It is implemented as a kind of embedded tactic language in Haskell, where tactic scripts are written in an *elaboration monad* that provides error handling and a proof state.
@@ -198,6 +198,7 @@ This is primarily useful for code generation, particularly for generating patter
198
198
199Learn More
199Learn More
200==========
200==========
201−While this documentation is still incomplete, elaboration reflection works in Idris today.
201+Tactics are discussed in the proofs section.
202+
202−As you wait for the completion of the documentation, the list of built-in tactics can be obtained using the ``:browse`` command in an Idris REPL or the corresponding feature in one of the graphical IDE clients to explore the ``Language.Reflection.Elab.Tactics`` namespace.
203+The list of built-in tactics can be obtained using the ``:browse`` command in an Idris REPL or the corresponding feature in one of the graphical IDE clients to explore the ``Language.Reflection.Elab.Tactics`` namespace.
203All of the built-in tactics contain documentation strings.
204All of the built-in tactics contain documentation strings.
docs/proofs/example1.rst → docs/elaboratorReflection/example1.rstrenamed

The content is the same.

docs/proofs/generatingData.rst → docs/elaboratorReflection/generatingData.rstrenamed

The content is the same.

docs/proofs/holes.rst → docs/elaboratorReflection/holes.rstrenamed

The content is the same.

docs/elaboratorReflection/index.rstnew file+33
@@ -0,0 +1,33 @@
1+.. _proofs-index:
2+
3+#########################################
4+Theorem Proving and Elaborator Reflection
5+#########################################
6+
7+A tutorial on theorem proving in Idris.
8+
9+.. note::
10+
11+ The documentation for Idris has been published under the Creative
12+ Commons CC0 License. As such to the extent possible under law, *The
13+ Idris Community* has waived all copyright and related or neighboring
14+ rights to Documentation for Idris.
15+
16+ More information concerning the CC0 can be found online at: http://creativecommons.org/publicdomain/zero/1.0/
17+
18+.. toctree::
19+ :maxdepth: 1
20+
21+ definitional
22+ pluscomm
23+ inductive
24+ patterns
25+ propositional
26+ interactive
27+ interactiveOld
28+ elabReflection
29+ tactics
30+ holes
31+ example1
32+ primitive
33+ generatingData
docs/proofs/primitive.rst → docs/elaboratorReflection/primitive.rstrenamed

The content is the same.

docs/proofs/tactics.rst → docs/elaboratorReflection/tactics.rstrenamed

The content is the same.

docs/index.rst+1
@@ -24,5 +24,6 @@ Documentation for the Idris Language
24 st/index
24 st/index
25 effects/index
25 effects/index
26 proofs/index
26 proofs/index
27+ elaboratorReflection/index
27 reference/index
28 reference/index
28 guides/index
29 guides/index
docs/proofs/index.rst+4−9
@@ -1,8 +1,8 @@
1.. _proofs-index:
1.. _proofs-index:
2
2
3−#########################################
3+###############
4−Theorem Proving and Elaborator Reflection
4+Theorem Proving
5−#########################################
5+###############
6
6
7A tutorial on theorem proving in Idris.
7A tutorial on theorem proving in Idris.
8
8
@@ -25,9 +25,4 @@ A tutorial on theorem proving in Idris.
25 propositional
25 propositional
26 interactive
26 interactive
27 interactiveOld
27 interactiveOld
28− elabReflection
28+
29− tactics
30− holes
31− example1
32− primitive
33− generatingData