doc: warn about the limited use of identifiers of individual dimensions

Signed-off-by: Sven Verdoolaege <skimo@kotnet.org>

diff --git a/doc/user.pod b/doc/user.pod
index 0ace5aa..d7d91d3 100644 (file)
--- a/doc/user.pod
+++ b/doc/user.pod
@@ -1409,7 +1409,9 @@ read off using the following functions.
                enum isl_dim_type type, unsigned pos);
 
 These functions are mostly useful to obtain the identifiers, positions
-or names of the parameters.
+or names of the parameters.  Identifiers of individual dimensions are
+essentially only useful for printing.  They are ignored by all other
+operations and may not be preserved across those operations.
 
 =head2 Properties