isl_aff.c: document isl_aff_normalize

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

diff --git a/isl_aff.c b/isl_aff.c
index a531bf8..e47cad9 100644 (file)
--- a/isl_aff.c
+++ b/isl_aff.c
@@ -648,6 +648,12 @@ __isl_give isl_aff *isl_aff_remove_unused_divs( __isl_take isl_aff *aff)
        return aff;
 }
 
+/* Normalize the representation of "aff".
+ *
+ * This function should only be called of "new" isl_affs, i.e.,
+ * with only a single reference.  We therefore do not need to
+ * worry about affecting other instances.
+ */
 __isl_give isl_aff *isl_aff_normalize(__isl_take isl_aff *aff)
 {
        if (!aff)