glade3 r1783 - in trunk: . doc

[tvb svn gnome org]

Author: tvb
Date: Wed Apr  9 20:29:41 2008
New Revision: 1783
URL: http://svn.gnome.org/viewvc/glade3?rev=1783&view=rev

Log:

	* doc/catalogintro.sgml, doc/widgetclasses.sgml, doc/properties.sgml:
	Documented newly added catalog tags.



Modified:
   trunk/ChangeLog
   trunk/doc/catalogintro.sgml
   trunk/doc/properties.sgml
   trunk/doc/widgetclasses.sgml

Modified: trunk/doc/catalogintro.sgml
==============================================================================
--- trunk/doc/catalogintro.sgml	(original)
+++ trunk/doc/catalogintro.sgml	Wed Apr  9 20:29:41 2008
@@ -79,19 +79,40 @@
         <term>name</term>
         <listitem>
           <para>
-The 'name' property is simply a string identifier for the catalog in 
-question, it will be used to identify your catalog so that the glade file can explicitly
-require it and to manage inter catalog dependencies.
+A string identifier for the catalog in question, it will be used to identify your 
+catalog so that the glade file can explicitly require it and to manage inter 
+catalog dependencies.
           </para>
         </listitem>
       </varlistentry>
       
       <varlistentry>
+        <term>version</term>
+        <listitem>
+          <para>
+A 'major.minor' formed version describing the current version of underlying widget kit;
+example: <literal>version="1.0"</literal>. This is needed for version checking to work. 
+Please note that all versioning related support is completely optional.
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term>targetable</term>
+        <listitem>
+          <para>
+A comma separated list of 'major.minor' formed versions describing sensable previous
+targetable versions of the underlying toolkit not including the current version; 
+example: <literal>targetable="0.6,0.8"</literal>.
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
         <term>icon-prefix</term>
         <listitem>
           <para>
-The 'icon-prefix' attribute is used to form icon names for widgets. This property defaults
-to the value of the 'name' attribute.
+Used to form icon names for widgets. This property defaults to the value of the 'name' attribute.
           </para>
         </listitem>
       </varlistentry>
@@ -100,13 +121,13 @@
         <term>library</term>
         <listitem>
           <para>
-The 'library' property is used to load the types and introspect properties, unless
-you are faking your widget classes (which will be described later on), glade will
-need to load this library, it can either be the name of the library containing the 
-widgets or the plugin library which is assumed to implicitly link to your widget
-library. The library will be loaded either by a user specified path, the system
-plugin directory: <literal>$prefix/lib/glade-3/modules/</literal>, or from
-the default system library paths in the afore mentioned order of precedence.
+Used to load the types and introspect properties, unless you are faking your widget 
+classes (which will be described later on), glade will need to load this library, 
+it can either be the name of the library containing the widgets or the plugin library
+which is assumed to implicitly link to your widget library. The library will be loaded
+either by a user specified path, the system plugin directory: 
+<literal>$prefix/lib/glade-3/modules/</literal>, or from the default system library 
+paths in the afore mentioned order of precedence.
           </para>
         </listitem>
       </varlistentry>
@@ -115,11 +136,11 @@
         <term>depends</term>
         <listitem>
           <para>
-The 'depends' property is used for inheritance of support code to work 
-properly  (i.e. if your object derives from an object in gtk+, you'll want the default 
-support code in the gladegtk plugin to be enabled for your widget too). This property's 
-value is the `name' property of another installed glade plugin; usually you'll want to
-declare: 'depends="gtk+"' for your plugin.
+Used for inheritance of support code to work properly  (i.e. if your object derives 
+from an object in gtk+, you'll want the default support code in the gladegtk plugin 
+to be enabled for your widget too). This property's value is the `name' property of 
+another installed glade plugin; usually you'll want to declare: 'depends="gtk+"'
+for your plugin.
           </para>
         </listitem>
       </varlistentry>
@@ -128,7 +149,7 @@
         <term>domain</term>
         <listitem>
           <para>
-The 'domain' property is the domain in which to search for translatable strings from the 
+The domain in which to search for translatable strings from the 
 catalog file; please note that all strings from the catalog that will apear in the UI are
 translated using this domain. If the 'domain' is not specified, the library property will
 be used in it's stead.
@@ -140,7 +161,7 @@
         <term>book</term>
         <listitem>
           <para>
-The 'book' property is used to specify a namespace to search devhelp docs library with
+Used to specify a namespace to search devhelp docs library with
 (specificly, it is the $(DOC_MODULE) that you specified in your gtk-doc Makefile.am).
           </para>
         </listitem>
@@ -150,7 +171,7 @@
         <term>init-function</term>
         <listitem>
           <para>
-The 'init-function' tag is used to retrieve an optional global entry point to your plugin; 
+Used to retrieve an optional global entry point to your plugin; 
 if you need to initialize any backends or whatnot this is a good place. 
 Your catalog's init-function will be called before any widget classes are instantiated.
           </para>

Modified: trunk/doc/properties.sgml
==============================================================================
--- trunk/doc/properties.sgml	(original)
+++ trunk/doc/properties.sgml	Wed Apr  9 20:29:41 2008
@@ -60,6 +60,17 @@
         </varlistentry>
 
         <varlistentry>
+          <term>since</term>
+          <listitem>
+            <para>
+A 'major.minor' formed version describing the version of the owning catalog in which this 
+property was introduced; example: <literal>since="1.0"</literal>. Properties are initialized
+to be supported since the introducing #GladeWidgetAdaptor was supported.
+            </para>
+          </listitem>
+        </varlistentry>
+
+        <varlistentry>
           <term>disabled</term>
           <listitem>
             <para>

Modified: trunk/doc/widgetclasses.sgml
==============================================================================
--- trunk/doc/widgetclasses.sgml	(original)
+++ trunk/doc/widgetclasses.sgml	Wed Apr  9 20:29:41 2008
@@ -44,6 +44,14 @@
 
   </properties>
 
+  <signals>
+
+    <signal id="frobnicate" since="1.0"/>
+
+    ... signal definitions go here
+
+  </signals>
+
   <packing-properties>
 
     ... child packing property definitions go here
@@ -97,6 +105,34 @@
         </listitem>
       </varlistentry>
 
+     <varlistentry>
+        <term>since</term>
+        <listitem>
+          <para>
+A 'major.minor' formed version describing the version of the owning catalog in which this 
+object class was introduced; example: <literal>since="1.0"</literal>.
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term>deprecated</term>
+        <listitem>
+          <para>
+A boolean property depicting that this widget is currently deprecated.
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term>builder-unsupported</term>
+        <listitem>
+          <para>
+A boolean property depicting that this widget is not supported by #GtkBuilder.
+          </para>
+        </listitem>
+      </varlistentry>
+
       <varlistentry>
         <term>get-type-function</term>
         <listitem>
@@ -490,6 +526,16 @@
   </refsect1>
 
   <refsect1>
+    <title>Signals</title>
+    <para>
+The signal elements are currently only needed for versioning support, use
+the `signal' child tag as described above and set signal `id' to be supported
+since version `since'. Signals are initialized to be supported since the
+introducing #GladeWidgetAdaptor was supported.
+    </para>
+  </refsect1>
+
+  <refsect1>
     <title>Icons</title>
     <para>
 The Glade palette and other components use icons to represent the various widget classes.