aboutsummaryrefslogtreecommitdiffhomepage
path: root/kernel/names.mli
diff options
context:
space:
mode:
authorGravatar Pierre-Marie Pédrot <pierre-marie.pedrot@inria.fr>2016-06-09 16:50:07 +0200
committerGravatar Pierre-Marie Pédrot <pierre-marie.pedrot@inria.fr>2016-06-09 17:48:02 +0200
commit7527751d9772656b4680df311546825cc2dd3d8f (patch)
tree27c07324760d255939dcb9ec556bf8e309ab5186 /kernel/names.mli
parent8efb78da7900e7f13105aac8361272477f8f5119 (diff)
Adding a bit of documentation in the mli.
Diffstat (limited to 'kernel/names.mli')
-rw-r--r--kernel/names.mli14
1 files changed, 14 insertions, 0 deletions
diff --git a/kernel/names.mli b/kernel/names.mli
index 56f0f8c60..feaedc775 100644
--- a/kernel/names.mli
+++ b/kernel/names.mli
@@ -6,6 +6,20 @@
(* * GNU Lesser General Public License Version 2.1 *)
(************************************************************************)
+(** This file defines a lot of different notions of names used pervasively in
+ the kernel as well as in other places. The essential datatypes exported by
+ this API are:
+
+ - Id.t is the type of identifiers, that is morally a subset of strings which
+ only contains Unicode characters of the Letter kind (and a few more).
+ - Name.t is an ad-hoc variant of Id.t option allowing to handle optionally
+ named objects.
+ - DirPath.t represents generic paths as sequences of identifiers.
+ - Label.t is an equivalent of Id.t made distinct for semantical purposes.
+ - ModPath.t are module paths.
+ - KerName.t are absolute names of objects in Coq.
+*)
+
open Util
(** {6 Identifiers } *)