aboutsummaryrefslogtreecommitdiff
path: root/dev/doc/api.txt
diff options
context:
space:
mode:
authorMaxime Dénès2017-03-15 11:47:16 +0100
committerMaxime Dénès2017-03-15 11:47:16 +0100
commit0e07ace6b6810f70f99fffff924d8c499db18250 (patch)
tree6fce7540b596c19caae63988d56b74b54051ae87 /dev/doc/api.txt
parent229f858e8c37b577bd07a18f3ca1e0ecd0a912fe (diff)
parent6eefbf216bd4d674f84a7827ecb205c6e12c33d3 (diff)
Merge PR#267: Proposal for an update of the recommended style in programming Coq.
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 0000000000..5827257b53
--- /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