2008-07-01 Emmanuele Bassi <ebassi@openedhand.com>

* clutter/clutter-behaviour-bspline.h:
	* clutter/clutter-behaviour.h:
	* clutter/clutter-event.h:
	* clutter/clutter-texture.h: Add missing documentation and
	change the copyright and licensing notice to use the FSF
	website instead of its address. (#512)

ChangeLog

@@ -1,3 +1,12 @@
+2008-07-01  Emmanuele Bassi  <ebassi@openedhand.com>
+
+	* clutter/clutter-behaviour-bspline.h:
+	* clutter/clutter-behaviour.h:
+	* clutter/clutter-event.h:
+	* clutter/clutter-texture.h: Add missing documentation and
+	change the copyright and licensing notice to use the FSF
+	website instead of its address. (#512)
+
 2008-06-30  Matthew Allum  <mallum@openedhand.com>
 
 	Bug 1008 - tfp still a bit borked

clutter/clutter-behaviour-bspline.h

@@ -18,9 +18,7 @@
  * Lesser General Public License for more details.
  *
  * You should have received a copy of the GNU Lesser General Public
- * License along with this library; if not, write to the
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
- * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
- * Boston, MA 02111-1307, USA.
  */
 
 #ifndef __CLUTTER_BEHAVIOUR_BSPLINE_H__
@@ -58,19 +56,41 @@ typedef struct _ClutterBehaviourBspline        ClutterBehaviourBspline;
 typedef struct _ClutterBehaviourBsplinePrivate ClutterBehaviourBsplinePrivate;
 typedef struct _ClutterBehaviourBsplineClass   ClutterBehaviourBsplineClass;
 
+/**
+ * ClutterBehaviourBspline:
+ *
+ * #ClutterBehaviourBspline-struct contains only private data and
+ * should be accessed using the functions below.
+ *
+ * Since: 0.2
+ */
 struct _ClutterBehaviourBspline
 {
   ClutterBehaviour parent_instance;
   ClutterBehaviourBsplinePrivate *priv;
 };
 
+/**
+ * ClutterBehaviourBsplineClass:
+ * @knot_reached: class handler for the #ClutterBehaviourBspline::knot-reached
+ *   signal
+ *
+ * #ClutterBehaviourBsplineClass-struct contains only private data
+ * and should be accessed using the functions below.
+ *
+ * Since: 0.2
+ */
 struct _ClutterBehaviourBsplineClass
 {
+  /*< private >*/
   ClutterBehaviourClass   parent_class;
 
+  /*< public >*/
   void (*knot_reached) (ClutterBehaviourBspline *bsplineb,
                         const ClutterKnot       *knot);
 
+  /*< private >*/
+  /* padding for future expansion */
   void (*_clutter_bspline_1) (void);
   void (*_clutter_bspline_2) (void);
   void (*_clutter_bspline_3) (void);

clutter/clutter-behaviour.h

@@ -20,9 +20,7 @@
  * Lesser General Public License for more details.
  *
  * You should have received a copy of the GNU Lesser General Public
- * License along with this library; if not, write to the
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
- * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
- * Boston, MA 02111-1307, USA.
  */
 
 #ifndef _HAVE_CLUTTER_BEHAVIOUR_H
@@ -75,6 +73,14 @@ typedef void (*ClutterBehaviourForeachFunc) (ClutterBehaviour *behaviour,
                                              ClutterActor     *actor,
                                              gpointer          data);
 
+/**
+ * ClutterBehaviour:
+ *
+ * #ClutterBehaviour-struct contains only private data and should
+ * be accessed with the functions below.
+ *
+ * Since: 0.2
+ */
 struct _ClutterBehaviour
 {
   /*< private >*/

clutter/clutter-event.h

@@ -18,9 +18,7 @@
  * Lesser General Public License for more details.
  *
  * You should have received a copy of the GNU Lesser General Public
- * License along with this library; if not, write to the
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
- * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
- * Boston, MA 02111-1307, USA.
  */
 
 #ifndef _HAVE_CLUTTER_EVENT_H
@@ -182,6 +180,13 @@ typedef struct _ClutterScrollEvent      ClutterScrollEvent;
 typedef struct _ClutterStageStateEvent  ClutterStageStateEvent;
 typedef struct _ClutterCrossingEvent    ClutterCrossingEvent;
 
+/**
+ * ClutterInputDevice:
+ *
+ * Generic representation of an input device. The
+ * actual contents of this structure depend on the
+ * backend used.
+ */
 typedef struct _ClutterInputDevice      ClutterInputDevice;
 
 /**

clutter/clutter-texture.h

@@ -18,9 +18,7 @@
  * Lesser General Public License for more details.
  *
  * You should have received a copy of the GNU Lesser General Public
- * License along with this library; if not, write to the
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
- * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
- * Boston, MA 02111-1307, USA.
  */
 
 #ifndef _HAVE_CLUTTER_TEXTURE_H
@@ -115,12 +113,15 @@ typedef enum { /*< prefix=CLUTTER_TEXTURE >*/
 /**
  * ClutterTextureQuality:
  * @CLUTTER_TEXTURE_QUALITY_LOW: fastest rendering will use nearest neighbour
- * interpolation when rendering.
+ *   interpolation when rendering. good setting.
- * good setting.
  * @CLUTTER_TEXTURE_QUALITY_MEDIUM: higher quality rendering without using
  *   extra resources.
  * @CLUTTER_TEXTURE_QUALITY_HIGH: render the texture with the best quality
  *   available using extra memory.
+ *
+ * Enumaration controlling the texture quality.
+ *
+ * Since: 0.8
  */
 typedef enum { /*< prefix=CLUTTER_TEXTURE_QUALITY >*/
   CLUTTER_TEXTURE_QUALITY_LOW = 0,