doc: Add introduction text for low-level bindings.

1 files changed, 12 insertions, 1 deletions

diff --git a/doc/drmaa.texi b/doc/drmaa.texi
index 58a22c6..d54a548 100644
--- a/doc/drmaa.texi
+++ b/doc/drmaa.texi
@@ -11,7 +11,7 @@
 @include version.texi
 
 @copying
-Copyright @copyright{} 2020 Ricardo Wurmus
+Copyright @copyright{} 2020, 2021 Ricardo Wurmus
 
 Permission is granted to copy, distribute and/or modify this document
 under the terms of the GNU Free Documentation License, Version 1.3 or
@@ -89,6 +89,17 @@ first and then perform the above steps.
 @c *********************************************************************
 @node Low-level bindings
 @chapter Low-level bindings
+@cindex (drmaa v1 low)
+
+The @code{(drmaa v1 low)} module provides low-level bindings that
+directly map to the procedures exposed by the DRMAA library.
+
+We recommend using the high-level bindings in @code{(drmaa v1 high)}
+to avoid resource management problems, in particular for the DRMAA
+session setup and teardown, as well as for template allocation and
+destruction.
+
+The following procedures are defined in this module:
 
 @include low.texi