aboutsummaryrefslogtreecommitdiffhomepage
path: root/dev/doc/api.txt
diff options
context:
space:
mode:
Diffstat (limited to 'dev/doc/api.txt')
-rw-r--r--dev/doc/api.txt10
1 files changed, 10 insertions, 0 deletions
diff --git a/dev/doc/api.txt b/dev/doc/api.txt
new file mode 100644
index 000000000..5827257b5
--- /dev/null
+++ b/dev/doc/api.txt
@@ -0,0 +1,10 @@
+Recommendations in using the API:
+
+The type of terms: constr (see kernel/constr.ml and kernel/term.ml)
+
+- On type constr, the canonical equality on CIC (up to
+ alpha-conversion and cast removal) is Constr.equal
+- The type constr is abstract, use mkRel, mkSort, etc. to build
+ elements in constr; use "kind_of_term" to analyze the head of a
+ constr; use destRel, destSort, etc. when the head constructor is
+ known