From: Justin Seyster <jseyster@cs.sunysb.edu>
Date: Mon, 11 Oct 2010 21:46:32 +0000 (-0400)
Subject: Documentation for the aop_pointcut.
X-Git-Tag: release-v1.0~28^2~19
X-Git-Url: https://git.fsl.cs.stonybrook.edu/?a=commitdiff_plain;h=5d360d4d064043ff71dcaa9a3d09f279530d1d99;p=interaspect.git

Documentation for the aop_pointcut.
---

diff --git a/src/aop-doxy-main.c b/src/aop-doxy-main.c
index cf83099..025743f 100644
--- a/src/aop-doxy-main.c
+++ b/src/aop-doxy-main.c
@@ -93,6 +93,24 @@
  * documentation.
  */
 
+/**
+ * \struct aop_pointcut
+ * \brief A set of \ref aop_joinpoint "join points" in the current
+ * function that are available for instrumentation.
+ *
+ * Create a pointcut using one of the <code>aop_match</code>
+ * functions.  Some types of pointcuts can be further refined using
+ * <code>aop_filter</code> functions.  Iterate through the individual
+ * join points in a pointcut using the aop_join_on() function, which
+ * calls an iterator function once for each of the join points in the
+ * set.
+ *
+ * A pointcut stays valid for the duration of the compiler pass it is
+ * created in.  You should never store a pointer to an aop_pointcut in
+ * any global data structure, in order to avoid any accesses to the
+ * join point after it becomes invalid.
+ */
+
 /**
  * \struct aop_dynval
  * \brief Representation of a runtime value.