Index: docs/gst/gstreamer-docs.sgml
===================================================================
RCS file: /cvs/gstreamer/gstreamer/docs/gst/gstreamer-docs.sgml,v
retrieving revision 1.98
diff -u -p -u -p -r1.98 gstreamer-docs.sgml
--- docs/gst/gstreamer-docs.sgml	27 Feb 2008 18:00:03 -0000	1.98
+++ docs/gst/gstreamer-docs.sgml	13 Mar 2008 10:46:30 -0000
@@ -31,11 +31,13 @@
 <!ENTITY GstObject SYSTEM "xml/gstobject.xml">
 <!ENTITY GstPad SYSTEM "xml/gstpad.xml">
 <!ENTITY GstPadTemplate SYSTEM "xml/gstpadtemplate.xml">
+<!ENTITY GstParamSpec SYSTEM "xml/gstparamspec.xml">
 <!ENTITY GstParse SYSTEM "xml/gstparse.xml">
 <!ENTITY GstPipeline SYSTEM "xml/gstpipeline.xml">
 <!ENTITY GstPlugin SYSTEM "xml/gstplugin.xml">
@@ -135,11 +124,13 @@ Windows.  It is released under the GNU L
     &GstObject;
     &GstPad;
     &GstPadTemplate;
+    &GstParamSpec;
     &GstParse;
     &GstPipeline;
Index: docs/gst/gstreamer-sections.txt
===================================================================
RCS file: /cvs/gstreamer/gstreamer/docs/gst/gstreamer-sections.txt,v
retrieving revision 1.325
diff -u -p -u -p -r1.325 gstreamer-sections.txt
--- docs/gst/gstreamer-sections.txt	29 Feb 2008 11:00:43 -0000	1.325
+++ docs/gst/gstreamer-sections.txt	13 Mar 2008 10:46:30 -0000
@@ -1465,6 +1467,28 @@ gst_static_caps_get_type
 
 
 <SECTION>
+<FILE>gstparamspec</FILE>
+<TITLE>GstParamSpec</TITLE>
+
+GST_PARAM_CONTROLLABLE
+GST_PARAM_USER_EDITABLE
+GST_PARAM_PRESETABLE
+GST_PARAM_USER_SHIFT
+
+<SUBSECTION paramspecfraction>
+GstParamSpecFraction
+gst_param_spec_fraction
+
+<SUBSECTION Standard>
+GST_IS_PARAM_SPEC_FRACTION
+GST_PARAM_SPEC_FRACTION
+GST_TYPE_PARAM_FRACTION
+gst_param_spec_fraction_get_type
+
+</SECTION>
+
+
+<SECTION>
 <FILE>gstparse</FILE>
 <TITLE>GstParse</TITLE>
 gst_parse_error_quark
@@ -2255,10 +2302,6 @@ gst_value_get_fraction_denominator
 gst_value_fraction_multiply
 gst_value_fraction_subtract
 
-<SUBSECTION paramspecfraction>
-GstParamSpecFraction
-gst_param_spec_fraction
-
 <SUBSECTION fractionrange>
 GST_VALUE_HOLDS_FRACTION_RANGE
 GST_TYPE_FRACTION_RANGE
@@ -2326,11 +2369,6 @@ gst_value_array_get_size
 gst_value_array_get_value
 gst_value_array_prepend_value
 
-<SUBSECTION Standard>
-GST_IS_PARAM_SPEC_FRACTION
-GST_PARAM_SPEC_FRACTION
-GST_TYPE_PARAM_FRACTION
-gst_param_spec_fraction_get_type
 
 <SUBSECTION Private>
 gst_date_get_type
Index: docs/libs/gstreamer-libs-sections.txt
===================================================================
RCS file: /cvs/gstreamer/gstreamer/docs/libs/gstreamer-libs-sections.txt,v
retrieving revision 1.73
diff -u -p -u -p -r1.73 gstreamer-libs-sections.txt
--- docs/libs/gstreamer-libs-sections.txt	27 Feb 2008 19:01:11 -0000	1.73
+++ docs/libs/gstreamer-libs-sections.txt	13 Mar 2008 10:46:30 -0000
@@ -81,7 +81,6 @@ gst_controller_unset
 gst_controller_unset_all
 gst_controller_get_all
 gst_controller_set_interpolation_mode
-GST_PARAM_CONTROLLABLE
 <SUBSECTION Standard>
 GstControllerClass
 GstControllerPrivate
Index: gst/gstvalue.c
===================================================================
RCS file: /cvs/gstreamer/gstreamer/gst/gstvalue.c,v
retrieving revision 1.140
diff -u -p -u -p -r1.140 gstvalue.c
--- gst/gstvalue.c	28 Dec 2007 14:34:34 -0000	1.140
+++ gst/gstvalue.c	13 Mar 2008 10:46:32 -0000
@@ -19,15 +19,15 @@
 
 /**
  * SECTION:gstvalue
- * @short_description: GValue and GParamSpec implementations specific
+ * @short_description: GValue implementations specific
  * to GStreamer
  *
- * GValue and GParamSpec implementations specific to GStreamer.
+ * GValue implementations specific to GStreamer.
  *
  * Note that operations on the same GstValue (or GValue) from multiple
  * threads may lead to undefined behaviour. 
  *
- * Last reviewed on 2006-03-07 (0.10.4)
+ * Last reviewed on 2008-03-11 (0.10.18)
  */
 
 #ifdef HAVE_CONFIG_H
Index: gst/gstparamspecs.c
===================================================================
RCS file: /cvs/gstreamer/gstreamer/gst/gstparamspecs.c,v
retrieving revision 1.3
diff -u -p -u -p -r1.3 gstparamspecs.c
--- gst/gstparamspecs.c	14 Jun 2007 16:07:09 -0000	1.3
+++ gst/gstparamspecs.c	13 Mar 2008 10:46:32 -0000
@@ -16,6 +16,15 @@
  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  * Boston, MA 02111-1307, USA.
  */
+/**
+ * SECTION:gstparamspec
+ * @short_description: GParamSpec implementations specific
+ * to GStreamer
+ *
+ * GParamSpec implementations specific to GStreamer.
+ *
+ * Last reviewed on 2008-03-11 (0.10.18)
+ */
 
 #ifdef HAVE_CONFIG_H
 #include "config.h"
Index: gst/gstparamspecs.h
===================================================================
RCS file: /cvs/gstreamer/gstreamer/gst/gstparamspecs.h,v
retrieving revision 1.2
diff -u -p -u -p -r1.2 gstparamspecs.h
--- gst/gstparamspecs.h	25 Jul 2007 13:00:23 -0000	1.2
+++ gst/gstparamspecs.h	13 Mar 2008 10:46:32 -0000
@@ -24,6 +24,48 @@
 
 G_BEGIN_DECLS
 
+/* --- paramspec flags */
+
+/**
+ * GST_PARAM_CONTROLLABLE:
+ *
+ * Use this flag on GObject properties to signal they can make sense to be.
+ * controlled over time. This hint is used by the GstController.
+ */
+#define	GST_PARAM_CONTROLLABLE	(1 << (G_PARAM_USER_SHIFT + 1))
+
+/**
+ * GST_PARAM_USER_EDITABLE:
+ *
+ * Use this flag on GObject properties to signal that they should be shown in
+ * a UI.
+ *
+ * FIXME:
+ * Should all %GST_PARAM_CONTROLLABLE get %GST_PARAM_USER_EDITABLE flag in practise?
+ */
+#define	GST_PARAM_USER_EDITABLE	(1 << (G_PARAM_USER_SHIFT + 2))
+
+/**
+ * GST_PARAM_PRESETABLE:
+ *
+ * Use this flag on GObject properties you wish to serialize/deserialize in
+ * presets.
+ *
+ * FIXME:
+ * What are uses cases whwere this is diffecrent from _CONTROLLABLE|_USER_EDITABLE ?
+ * - wtay: GstObject::name should be shown in GstEditor but but not appear in a preset
+ *   - ensonic: GstEditor should show UI for all properties
+ */
+#define	GST_PARAM_PRESETABLE	(1 << (G_PARAM_USER_SHIFT + 3))
+
+/**
+ * GST_PARAM_USER_SHIFT:
+ *
+ * Bits based on GST_PARAM_USER_SHIFT can be used by 3rd party applications.
+ */
+#define	GST_PARAM_USER_SHIFT	(1 << (G_PARAM_USER_SHIFT + 8))
+
+
 /* --- type macros --- */
 
 #define GST_TYPE_PARAM_FRACTION           (gst_param_spec_fraction_get_type ())
Index: libs/gst/controller/gstcontroller.h
===================================================================
RCS file: /cvs/gstreamer/gstreamer/libs/gst/controller/gstcontroller.h,v
retrieving revision 1.26
diff -u -p -u -p -r1.26 gstcontroller.h
--- libs/gst/controller/gstcontroller.h	8 Jan 2008 02:07:38 -0000	1.26
+++ libs/gst/controller/gstcontroller.h	13 Mar 2008 10:46:32 -0000
@@ -35,15 +35,6 @@
 
 G_BEGIN_DECLS
 
-/**
- * GST_PARAM_CONTROLLABLE:
- *
- * Use this flag on GstElement properties you wish to be (eventually) handled
- * by a GstController.
- * TODO: needs to go to gstelemnt.h (to avoid clashes on G_PARAM_USER_SHIFT)
- */
-#define	GST_PARAM_CONTROLLABLE	(1 << (G_PARAM_USER_SHIFT + 1))
-
 /* type macros */
 
 #define GST_TYPE_CONTROLLER	       (gst_controller_get_type ())
