RubyGems - glib2 - Versions diffs - 3.2.1-x86-mingw32 → 3.2.2-x86-mingw32 - Mend

glib2 3.2.1-x86-mingw32 → 3.2.2-x86-mingw32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (927) hide show

data/vendor/local/share/gtk-doc/html/gobject/chapter-signal.html CHANGED

@@ -8,7 +8,7 @@
 <link rel="up" href="pt01.html" title="Part I. Concepts">
 <link rel="prev" href="gobject-properties.html" title="Object properties">
 <link rel="next" href="signal.html" title="Signals">
-<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -54,7 +54,7 @@
     <tbody>
       <tr>
         <td class="listing_lines" align="right"><pre>1</pre></td>
-        <td class="listing_code"><pre class="programlisting">return_type <span class="function">function_callback</span> <span class="gtkdoc opt">(</span>… <span class="gtkdoc opt">,</span> gpointer user_data<span class="gtkdoc opt">);</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="usertype">return_type</span><span class="normal"> </span><span class="function">function_callback</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">… </span><span class="symbol">,</span><span class="normal"> </span><span class="usertype">gpointer</span><span class="normal"> user_data</span><span class="symbol">);</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -190,31 +190,31 @@
 23
 24
 25</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="gobject-Closures.html#g-cclosure-marshal-VOID--INT">g_cclosure_marshal_VOID__INT</a></span> <span class="gtkdoc opt">(</span>GClosure     <span class="gtkdoc opt">*</span>closure<span class="gtkdoc opt">,</span>
-                              GValue       <span class="gtkdoc opt">*</span>return_value<span class="gtkdoc opt">,</span>
-                              guint         n_param_values<span class="gtkdoc opt">,</span>
-                              <span class="gtkdoc kwb">const</span> GValue <span class="gtkdoc opt">*</span>param_values<span class="gtkdoc opt">,</span>
-                              gpointer      invocation_hint<span class="gtkdoc opt">,</span>
-                              gpointer      marshal_data<span class="gtkdoc opt">)</span>
-<span class="gtkdoc opt">{</span>
-  <span class="gtkdoc kwc">typedef</span> <span class="gtkdoc kwb">void</span> <span class="gtkdoc opt">(*</span>GMarshalFunc_VOID__INT<span class="gtkdoc opt">) (</span>gpointer     data1<span class="gtkdoc opt">,</span>
-                                          gint         arg_1<span class="gtkdoc opt">,</span>
-                                          gpointer     data2<span class="gtkdoc opt">);</span>
-  <span class="gtkdoc kwc">register</span> GMarshalFunc_VOID__INT callback<span class="gtkdoc opt">;</span>
-  <span class="gtkdoc kwc">register</span> GCClosure <span class="gtkdoc opt">*</span>cc <span class="gtkdoc opt">= (</span>GCClosure<span class="gtkdoc opt">*)</span> closure<span class="gtkdoc opt">;</span>
-  <span class="gtkdoc kwc">register</span> gpointer data1<span class="gtkdoc opt">,</span> data2<span class="gtkdoc opt">;</span>
+        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="gobject-Closures.html#g-cclosure-marshal-VOID--INT">g_cclosure_marshal_VOID__INT</a></span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GClosure</span><span class="normal">     </span><span class="symbol">*</span><span class="normal"><a href="chapter-signal.html#closure">closure</a></span><span class="symbol">,</span>
+<span class="normal">                              </span><span class="usertype">GValue</span><span class="normal">       </span><span class="symbol">*</span><span class="normal">return_value</span><span class="symbol">,</span>
+<span class="normal">                              </span><span class="usertype">guint</span><span class="normal">         n_param_values</span><span class="symbol">,</span>
+<span class="normal">                              </span><span class="keyword">const</span><span class="normal"> </span><span class="usertype">GValue</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">param_values</span><span class="symbol">,</span>
+<span class="normal">                              </span><span class="usertype">gpointer</span><span class="normal">      invocation_hint</span><span class="symbol">,</span>
+<span class="normal">                              </span><span class="usertype">gpointer</span><span class="normal">      marshal_data</span><span class="symbol">)</span>
+<span class="cbracket">{</span>
+<span class="normal">  </span><span class="keyword">typedef</span><span class="normal"> </span><span class="type">void</span><span class="normal"> </span><span class="symbol">(*</span><span class="normal">GMarshalFunc_VOID__INT</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">gpointer</span><span class="normal">     data1</span><span class="symbol">,</span>
+<span class="normal">                                          </span><span class="usertype">gint</span><span class="normal">         arg_1</span><span class="symbol">,</span>
+<span class="normal">                                          </span><span class="usertype">gpointer</span><span class="normal">     data2</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="keyword">register</span><span class="normal"> </span><span class="usertype">GMarshalFunc_VOID__INT</span><span class="normal"> callback</span><span class="symbol">;</span>
+<span class="normal">  </span><span class="keyword">register</span><span class="normal"> </span><span class="usertype">GCClosure</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">cc </span><span class="symbol">=</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="gobject-Closures.html#GCClosure">GCClosure</a></span><span class="symbol">*)</span><span class="normal"> <a href="chapter-signal.html#closure">closure</a></span><span class="symbol">;</span>
+<span class="normal">  </span><span class="keyword">register</span><span class="normal"> </span><span class="usertype">gpointer</span><span class="normal"> data1</span><span class="symbol">,</span><span class="normal"> data2</span><span class="symbol">;</span>
-  <span class="function"><a href="../glib-Warnings-and-Assertions.html#g-return-if-fail">g_return_if_fail</a></span> <span class="gtkdoc opt">(</span>n_param_values <span class="gtkdoc opt">==</span> <span class="number">2</span><span class="gtkdoc opt">);</span>
+<span class="normal">  </span><span class="function"><a href="../glib-Warnings-and-Assertions.html#g-return-if-fail">g_return_if_fail</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">n_param_values </span><span class="symbol">==</span><span class="normal"> </span><span class="number">2</span><span class="symbol">);</span>
-  data1 <span class="gtkdoc opt">=</span> <span class="function"><a href="gobject-Generic-values.html#g-value-peek-pointer">g_value_peek_pointer</a></span> <span class="gtkdoc opt">(</span>param_values <span class="gtkdoc opt">+</span> <span class="number">0</span><span class="gtkdoc opt">);</span>
-  data2 <span class="gtkdoc opt">=</span> closure<span class="gtkdoc opt">-&gt;</span>data<span class="gtkdoc opt">;</span>
+<span class="normal">  data1 </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="gobject-Generic-values.html#g-value-peek-pointer">g_value_peek_pointer</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">param_values </span><span class="symbol">+</span><span class="normal"> </span><span class="number">0</span><span class="symbol">);</span>
+<span class="normal">  data2 </span><span class="symbol">=</span><span class="normal"> <a href="chapter-signal.html#closure">closure</a></span><span class="symbol">-&gt;</span><span class="normal">data</span><span class="symbol">;</span>
-  callback <span class="gtkdoc opt">= (</span>GMarshalFunc_VOID__INT<span class="gtkdoc opt">) (</span>marshal_data <span class="gtkdoc opt">?</span> marshal_data <span class="gtkdoc opt">:</span> cc<span class="gtkdoc opt">-&gt;</span>callback<span class="gtkdoc opt">);</span>
+<span class="normal">  callback </span><span class="symbol">=</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">GMarshalFunc_VOID__INT</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">marshal_data </span><span class="symbol">?</span><span class="normal"> marshal_data </span><span class="symbol">:</span><span class="normal"> cc</span><span class="symbol">-&gt;</span><span class="normal">callback</span><span class="symbol">);</span>
-  <span class="function">callback</span> <span class="gtkdoc opt">(</span>data1<span class="gtkdoc opt">,</span>
-            <span class="function">g_marshal_value_peek_int</span> <span class="gtkdoc opt">(</span>param_values <span class="gtkdoc opt">+</span> <span class="number">1</span><span class="gtkdoc opt">),</span>
-            data2<span class="gtkdoc opt">);</span>
-<span class="gtkdoc opt">}</span></pre></td>
+<span class="normal">  </span><span class="function">callback</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">data1</span><span class="symbol">,</span>
+<span class="normal">            </span><span class="function">g_marshal_value_peek_int</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">param_values </span><span class="symbol">+</span><span class="normal"> </span><span class="number">1</span><span class="symbol">),</span>
+<span class="normal">            data2</span><span class="symbol">);</span>
+<span class="cbracket">}</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -248,6 +248,6 @@
 </div>
 </div>
 <div class="footer">
-<hr>Generated by GTK-Doc V1.25.1</div>
+<hr>Generated by GTK-Doc V1.27</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/gobject/glib-genmarshal.html CHANGED

@@ -8,7 +8,7 @@
 <link rel="up" href="rn02.html" title="Tools Reference">
 <link rel="prev" href="glib-mkenums.html" title="glib-mkenums">
 <link rel="next" href="gobject-query.html" title="gobject-query">
-<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -59,7 +59,7 @@ comment in the form of
     <tbody>
       <tr>
         <td class="listing_lines" align="right"><pre>1</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc ppc"># this is a comment</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="preproc"># this</span><span class="normal"> is a comment</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -393,7 +393,84 @@ debugging information. This option is mutually exclusive with the
 </table></div>
 </div>
 <div class="refsect1">
-<a name="id-1.5.3.7"></a><h2>Example</h2>
+<a name="id-1.5.3.7"></a><h2>Using glib-genmarshal with Autotools</h2>
+<p>
+In order to use <span class="command"><strong>glib-genmarshal</strong></span> in your project when using
+Autotools as the build system, you will first need to modify your
+<code class="filename">configure.ac</code> file to ensure you find the appropriate
+command using <span class="command"><strong>pkg-config</strong></span>, similarly as to how you discover
+the compiler and linker flags for GLib.
+</p>
+<div class="informalexample">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2
+3</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="function">PKG_PROG_PKG_CONFIG</span><span class="symbol">([</span><span class="number">0.28</span><span class="symbol">])</span>
+<span class="function">PKG_CHECK_VAR</span><span class="symbol">([</span><span class="normal">GLIB_GENMARSHAL</span><span class="symbol">],</span><span class="normal"> </span><span class="symbol">[</span><span class="normal">glib</span><span class="symbol">-</span><span class="number">2.0</span><span class="symbol">],</span><span class="normal"> </span><span class="symbol">[</span><span class="normal">glib_genmarshal</span><span class="symbol">])</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+<p>
+In your <code class="filename">Makefile.am</code> file you will typically need very
+simple rules to generate the C files needed for the build.
+</p>
+<div class="informalexample">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2
+3
+4
+5
+6
+7
+8
+9
+10
+11
+12
+13
+14
+15
+16</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="normal">marshal</span><span class="symbol">.</span><span class="normal">h</span><span class="symbol">:</span><span class="normal"> marshal</span><span class="symbol">.</span><span class="normal">list</span>
+<span class="normal">        $</span><span class="symbol">(</span><span class="normal">AM_V_GEN</span><span class="symbol">)</span><span class="normal">$</span><span class="symbol">(</span><span class="normal">GLIB_GENMARSHAL</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">\</span>
+<span class="normal">                </span><span class="symbol">--</span><span class="normal">header </span><span class="symbol">\</span>
+<span class="normal">                </span><span class="symbol">--</span><span class="normal">output</span><span class="symbol">=</span><span class="normal">$@ </span><span class="symbol">\</span>
+<span class="normal">                $</span><span class="symbol">&lt;</span>
+<span class="normal">marshal</span><span class="symbol">.</span><span class="normal">c</span><span class="symbol">:</span><span class="normal"> marshal</span><span class="symbol">.</span><span class="usertype">list</span><span class="normal"> marshal</span><span class="symbol">.</span><span class="normal">h</span>
+<span class="normal">        $</span><span class="symbol">(</span><span class="normal">AM_V_GEN</span><span class="symbol">)</span><span class="normal">$</span><span class="symbol">(</span><span class="normal">GLIB_GENMARSHAL</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">\</span>
+<span class="normal">                </span><span class="symbol">--</span><span class="normal">include</span><span class="symbol">-</span><span class="normal">header</span><span class="symbol">=</span><span class="normal">marshal</span><span class="symbol">.</span><span class="normal">h </span><span class="symbol">\</span>
+<span class="normal">                </span><span class="symbol">--</span><span class="normal">body </span><span class="symbol">\</span>
+<span class="normal">                </span><span class="symbol">--</span><span class="normal">output</span><span class="symbol">=</span><span class="normal">$@ </span><span class="symbol">\</span>
+<span class="normal">                $</span><span class="symbol">&lt;</span>
+<span class="normal">BUILT_SOURCES </span><span class="symbol">+=</span><span class="normal"> marshal</span><span class="symbol">.</span><span class="usertype">h</span><span class="normal"> marshal</span><span class="symbol">.</span><span class="normal">c</span>
+<span class="normal">CLEANFILES </span><span class="symbol">+=</span><span class="normal"> marshal</span><span class="symbol">.</span><span class="usertype">h</span><span class="normal"> marshal</span><span class="symbol">.</span><span class="normal">c</span>
+<span class="normal">EXTRA_DIST </span><span class="symbol">+=</span><span class="normal"> marshal</span><span class="symbol">.</span><span class="normal">list</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+<p>
+In the example above, the first rule generates the header file and depends on
+a <code class="filename">marshal.list</code> file in order to regenerate the result in
+case the marshallers list is updated. The second rule generates the source file
+for the same <code class="filename">marshal.list</code>, and includes the file generated
+by the header rule.
+</p>
+</div>
+<div class="refsect1">
+<a name="id-1.5.3.8"></a><h2>Example</h2>
 <p>
 To generate marshallers for the following callback functions:
 </p>
@@ -410,15 +487,15 @@ To generate marshallers for the following callback functions:
 7
 8
 9</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">void</span>   <span class="function">foo</span> <span class="gtkdoc opt">(</span>gpointer data1<span class="gtkdoc opt">,</span>
-            gpointer data2<span class="gtkdoc opt">);</span>
-<span class="gtkdoc kwb">void</span>   <span class="function">bar</span> <span class="gtkdoc opt">(</span>gpointer data1<span class="gtkdoc opt">,</span>
-            gint     param1<span class="gtkdoc opt">,</span>
-            gpointer data2<span class="gtkdoc opt">);</span>
-gfloat <span class="function">baz</span> <span class="gtkdoc opt">(</span>gpointer data1<span class="gtkdoc opt">,</span>
-            gboolean param1<span class="gtkdoc opt">,</span>
-            guchar   param2<span class="gtkdoc opt">,</span>
-            gpointer data2<span class="gtkdoc opt">);</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="type">void</span><span class="normal">   </span><span class="function">foo</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">gpointer</span><span class="normal"> data1</span><span class="symbol">,</span>
+<span class="normal">            </span><span class="usertype">gpointer</span><span class="normal"> data2</span><span class="symbol">);</span>
+<span class="type">void</span><span class="normal">   </span><span class="function">bar</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">gpointer</span><span class="normal"> data1</span><span class="symbol">,</span>
+<span class="normal">            </span><span class="usertype">gint</span><span class="normal">     param1</span><span class="symbol">,</span>
+<span class="normal">            </span><span class="usertype">gpointer</span><span class="normal"> data2</span><span class="symbol">);</span>
+<span class="usertype">gfloat</span><span class="normal"> </span><span class="function">baz</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">gpointer</span><span class="normal"> data1</span><span class="symbol">,</span>
+<span class="normal">            </span><span class="usertype">gboolean</span><span class="normal"> param1</span><span class="symbol">,</span>
+<span class="normal">            </span><span class="usertype">guchar</span><span class="normal">   param2</span><span class="symbol">,</span>
+<span class="normal">            </span><span class="usertype">gpointer</span><span class="normal"> data2</span><span class="symbol">);</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -464,14 +541,14 @@ GSignalCMarshaller c_marshaller; argument upon creation of signals:
 6
 7
 8</pre></td>
-        <td class="listing_code"><pre class="programlisting">GClosure <span class="gtkdoc opt">*</span>cc_foo<span class="gtkdoc opt">, *</span>cc_bar<span class="gtkdoc opt">, *</span>cc_baz<span class="gtkdoc opt">;</span>
+        <td class="listing_code"><pre class="programlisting"><span class="usertype">GClosure</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">cc_foo</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">cc_bar</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">cc_baz</span><span class="symbol">;</span>
-cc_foo <span class="gtkdoc opt">=</span> <span class="function"><a href="gobject-Closures.html#g-cclosure-new">g_cclosure_new</a></span> <span class="gtkdoc opt">(</span>NULL<span class="gtkdoc opt">,</span> foo<span class="gtkdoc opt">,</span> NULL<span class="gtkdoc opt">);</span>
-<span class="function"><a href="gobject-Closures.html#g-closure-set-marshal">g_closure_set_marshal</a></span> <span class="gtkdoc opt">(</span>cc_foo<span class="gtkdoc opt">,</span> g_cclosure_user_marshal_VOID__VOID<span class="gtkdoc opt">);</span>
-cc_bar <span class="gtkdoc opt">=</span> <span class="function"><a href="gobject-Closures.html#g-cclosure-new">g_cclosure_new</a></span> <span class="gtkdoc opt">(</span>NULL<span class="gtkdoc opt">,</span> bar<span class="gtkdoc opt">,</span> NULL<span class="gtkdoc opt">);</span>
-<span class="function"><a href="gobject-Closures.html#g-closure-set-marshal">g_closure_set_marshal</a></span> <span class="gtkdoc opt">(</span>cc_bar<span class="gtkdoc opt">,</span> g_cclosure_user_marshal_VOID__INT<span class="gtkdoc opt">);</span>
-cc_baz <span class="gtkdoc opt">=</span> <span class="function"><a href="gobject-Closures.html#g-cclosure-new">g_cclosure_new</a></span> <span class="gtkdoc opt">(</span>NULL<span class="gtkdoc opt">,</span> baz<span class="gtkdoc opt">,</span> NULL<span class="gtkdoc opt">);</span>
-<span class="function"><a href="gobject-Closures.html#g-closure-set-marshal">g_closure_set_marshal</a></span> <span class="gtkdoc opt">(</span>cc_baz<span class="gtkdoc opt">,</span> g_cclosure_user_marshal_FLOAT__BOOLEAN_UCHAR<span class="gtkdoc opt">);</span></pre></td>
+<span class="normal">cc_foo </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="gobject-Closures.html#g-cclosure-new">g_cclosure_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="../glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> foo</span><span class="symbol">,</span><span class="normal"> <a href="../glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
+<span class="function"><a href="gobject-Closures.html#g-closure-set-marshal">g_closure_set_marshal</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cc_foo</span><span class="symbol">,</span><span class="normal"> g_cclosure_user_marshal_VOID__VOID</span><span class="symbol">);</span>
+<span class="normal">cc_bar </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="gobject-Closures.html#g-cclosure-new">g_cclosure_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="../glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> bar</span><span class="symbol">,</span><span class="normal"> <a href="../glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
+<span class="function"><a href="gobject-Closures.html#g-closure-set-marshal">g_closure_set_marshal</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cc_bar</span><span class="symbol">,</span><span class="normal"> g_cclosure_user_marshal_VOID__INT</span><span class="symbol">);</span>
+<span class="normal">cc_baz </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="gobject-Closures.html#g-cclosure-new">g_cclosure_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="../glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> baz</span><span class="symbol">,</span><span class="normal"> <a href="../glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
+<span class="function"><a href="gobject-Closures.html#g-closure-set-marshal">g_closure_set_marshal</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cc_baz</span><span class="symbol">,</span><span class="normal"> g_cclosure_user_marshal_FLOAT__BOOLEAN_UCHAR</span><span class="symbol">);</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -479,13 +556,13 @@ cc_baz <span class="gtkdoc opt">=</span> <span class="function"><a href="gobject
 </div>
 <div class="refsect1">
-<a name="id-1.5.3.8"></a><h2>See also</h2>
+<a name="id-1.5.3.9"></a><h2>See also</h2>
 <p>
 <span class="citerefentry"><span class="refentrytitle">glib-mkenums</span>(1)</span>
 </p>
 </div>
 </div>
 <div class="footer">
-<hr>Generated by GTK-Doc V1.25.1</div>
+<hr>Generated by GTK-Doc V1.27</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/gobject/glib-mkenums.html CHANGED

@@ -8,7 +8,7 @@
 <link rel="up" href="rn02.html" title="Tools Reference">
 <link rel="prev" href="rn02.html" title="Tools Reference">
 <link rel="next" href="glib-genmarshal.html" title="glib-genmarshal">
-<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -34,16 +34,15 @@
 </div>
 <div class="refsect1">
 <a name="id-1.5.2.5"></a><h2>Description</h2>
-<p><span class="command"><strong>glib-mkenums</strong></span> is a small perl-script utility that
-parses C code to extract enum definitions and produces enum descriptions based
-on text templates specified by the user. Most frequently this script is used to
-produce C code that contains enum values as strings so programs can provide
-value name strings for introspection.
+<p><span class="command"><strong>glib-mkenums</strong></span> is a small utility that parses C code to
+extract enum definitions and produces enum descriptions based on text templates
+specified by the user. Typically, you can use this tool to generate enumeration
+types for the GType type system, for #GObject properties and signal marshalling;
+additionally, you can use it to generate enumeration values of #GSettings schemas.
 </p>
 <p><span class="command"><strong>glib-mkenums</strong></span> takes a list of valid C code files as
-input. The options specified control the text that is output, certain
-substitutions are performed on the text templates for keywords enclosed
-in @ characters.
+input. The options specified control the text that generated, substituting various
+keywords enclosed in @ characters in the templates.
 </p>
 <div class="refsect2">
 <a name="id-1.5.2.5.4"></a><h3>Production text substitutions</h3>
@@ -61,11 +60,11 @@ the following example enum definition is assumed:
 3
 4
 5</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwc">typedef</span> <span class="gtkdoc kwb">enum</span>
-<span class="gtkdoc opt">{</span>
-  PREFIX_THE_XVALUE    <span class="gtkdoc opt">=</span> <span class="number">1</span> <span class="gtkdoc opt">&lt;&lt;</span> <span class="number">3</span><span class="gtkdoc opt">,</span>
-  PREFIX_ANOTHER_VALUE <span class="gtkdoc opt">=</span> <span class="number">1</span> <span class="gtkdoc opt">&lt;&lt;</span> <span class="number">4</span>
-<span class="gtkdoc opt">}</span> PrefixTheXEnum<span class="gtkdoc opt">;</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="keyword">typedef</span><span class="normal"> </span><span class="keyword">enum</span>
+<span class="cbracket">{</span>
+<span class="normal">  PREFIX_THE_XVALUE    </span><span class="symbol">=</span><span class="normal"> </span><span class="number">1</span><span class="normal"> </span><span class="symbol">&lt;&lt;</span><span class="normal"> </span><span class="number">3</span><span class="symbol">,</span>
+<span class="normal">  PREFIX_ANOTHER_VALUE </span><span class="symbol">=</span><span class="normal"> </span><span class="number">1</span><span class="normal"> </span><span class="symbol">&lt;&lt;</span><span class="normal"> </span><span class="number">4</span>
+<span class="cbracket">}</span><span class="normal"> PrefixTheXEnum</span><span class="symbol">;</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -84,34 +83,34 @@ the following example enum definition is assumed:
 <td><p>
 The name of the enum currently being processed, enum names are assumed to be
 properly namespaced and to use mixed capitalization to separate
-words (e.g. PrefixTheXEnum).
+words (e.g. <code class="literal">PrefixTheXEnum</code>).
 </p></td>
 </tr>
 <tr>
 <td><p><span class="term">@enum_name@</span></p></td>
 <td><p>
 The enum name with words lowercase and word-separated by underscores
-(e.g. prefix_the_xenum).
+(e.g. <code class="literal">prefix_the_xenum</code>).
 </p></td>
 </tr>
 <tr>
 <td><p><span class="term">@ENUMNAME@</span></p></td>
 <td><p>
 The enum name with words uppercase and word-separated by underscores
-(e.g. PREFIX_THE_XENUM).
+(e.g. <code class="literal">PREFIX_THE_XENUM</code>).
 </p></td>
 </tr>
 <tr>
 <td><p><span class="term">@ENUMSHORT@</span></p></td>
 <td><p>
 The enum name with words uppercase and word-separated by underscores,
-prefix stripped (e.g. THE_XENUM).
+prefix stripped (e.g. <code class="literal">THE_XENUM</code>).
 </p></td>
 </tr>
 <tr>
 <td><p><span class="term">@ENUMPREFIX@</span></p></td>
 <td><p>
-The prefix of the enum name (e.g. PREFIX).
+The prefix of the enum name (e.g. <code class="literal">PREFIX</code>).
 </p></td>
 </tr>
 <tr>
@@ -120,7 +119,7 @@ The prefix of the enum name (e.g. PREFIX).
 The enum value name currently being processed with words uppercase and
 word-separated by underscores,
 this is the assumed literal notation of enum values in the C sources
-(e.g. PREFIX_THE_XVALUE).
+(e.g. <code class="literal">PREFIX_THE_XVALUE</code>).
 </p></td>
 </tr>
 <tr>
@@ -129,18 +128,16 @@ this is the assumed literal notation of enum values in the C sources
 A nick name for the enum value currently being processed, this is usually
 generated by stripping common prefix words of all the enum values of the
 current enum, the words are lowercase and underscores are substituted by a
-minus (e.g. the-xvalue).
+minus (e.g. <code class="literal">the-xvalue</code>).
 </p></td>
 </tr>
 <tr>
 <td><p><span class="term">@valuenum@</span></p></td>
 <td><p>
-The integer value for the enum value currently being processed.  This is
-calculated by using <span class="command"><strong>perl</strong></span> to attempt to evaluate the
-expression as it appears in the C source code.  If evaluation fails then
-<span class="command"><strong>glib-mkenums</strong></span> will exit with an error status, but this
-only happens if <code class="literal">@valuenum@</code> appears in your value
-production template.  (Since: 2.26)
+The integer value for the enum value currently being processed. If the
+evaluation fails then <span class="command"><strong>glib-mkenums</strong></span> will exit with an
+error status, but this only happens if <code class="literal">@valuenum@</code>
+appears in your value production template. (Since: 2.26)
 </p></td>
 </tr>
 <tr>
@@ -171,7 +168,8 @@ The name of the input file currently being processed (e.g. foo.h).
 <tr>
 <td><p><span class="term">@basename@</span></p></td>
 <td><p>
-The base name of the input file currently being processed (e.g. foo.h). (Since: 2.22)
+The base name of the input file currently being processed (e.g. foo.h). Typically
+you want to use <code class="literal">@basename@</code> in place of <code class="literal">@filename@</code> in your templates, to improve the reproducibility of the build. (Since: 2.22)
 </p></td>
 </tr>
 </tbody>
@@ -191,7 +189,7 @@ indicate this enum definition to be skipped, or for it to be treated as
 a flags definition, or to specify the common prefix to be stripped from
 all values to generate value nicknames, respectively. The "underscore_name"
 option can be used to specify the word separation used in the *_get_type()
-function. For instance, /*&lt; underscore_name=gnome_vfs_uri_hide_options &gt;*/.
+function. For instance, <code class="literal">/*&lt; underscore_name=gnome_vfs_uri_hide_options &gt;*/</code>.
 </p>
 <p>
 Per value definition, the options "skip" and "nick" are supported.
@@ -214,17 +212,17 @@ Examples:
 9
 10
 11</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwc">typedef</span> <span class="gtkdoc kwb">enum</span> <span class="comment">/*&lt; skip &gt;*/</span>
-<span class="gtkdoc opt">{</span>
-  PREFIX_FOO
-<span class="gtkdoc opt">}</span> PrefixThisEnumWillBeSkipped<span class="gtkdoc opt">;</span>
-<span class="gtkdoc kwc">typedef</span> <span class="gtkdoc kwb">enum</span> <span class="comment">/*&lt; flags,prefix=PREFIX &gt;*/</span>
-<span class="gtkdoc opt">{</span>
-  PREFIX_THE_ZEROTH_VALUE<span class="gtkdoc opt">,</span>	<span class="comment">/*&lt; skip &gt;*/</span>
-  PREFIX_THE_FIRST_VALUE<span class="gtkdoc opt">,</span>
-  PREFIX_THE_SECOND_VALUE<span class="gtkdoc opt">,</span>
-  PREFIX_THE_THIRD_VALUE<span class="gtkdoc opt">,</span>	<span class="comment">/*&lt; nick=the-last-value &gt;*/</span>
-<span class="gtkdoc opt">}</span> PrefixTheFlagsEnum<span class="gtkdoc opt">;</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="keyword">typedef</span><span class="normal"> </span><span class="keyword">enum</span><span class="normal"> </span><span class="comment">/*&lt; skip &gt;*/</span>
+<span class="cbracket">{</span>
+<span class="normal">  PREFIX_FOO</span>
+<span class="cbracket">}</span><span class="normal"> PrefixThisEnumWillBeSkipped</span><span class="symbol">;</span>
+<span class="keyword">typedef</span><span class="normal"> </span><span class="keyword">enum</span><span class="normal"> </span><span class="comment">/*&lt; flags,prefix=PREFIX &gt;*/</span>
+<span class="cbracket">{</span>
+<span class="normal">  PREFIX_THE_ZEROTH_VALUE</span><span class="symbol">,</span><span class="normal">  </span><span class="comment">/*&lt; skip &gt;*/</span>
+<span class="normal">  PREFIX_THE_FIRST_VALUE</span><span class="symbol">,</span>
+<span class="normal">  PREFIX_THE_SECOND_VALUE</span><span class="symbol">,</span>
+<span class="normal">  PREFIX_THE_THIRD_VALUE</span><span class="symbol">,</span><span class="normal">   </span><span class="comment">/*&lt; nick=the-last-value &gt;*/</span>
+<span class="cbracket">}</span><span class="normal"> PrefixTheFlagsEnum</span><span class="symbol">;</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -244,50 +242,110 @@ Examples:
 <tbody>
 <tr>
 <td><p><span class="term"><code class="option">--fhead</code> <em class="replaceable"><code>TEXT</code></em></span></p></td>
-<td><p>
-Put out <em class="replaceable"><code>TEXT</code></em> prior to processing input files.
-</p></td>
+<td>
+<p>
+Emits <em class="replaceable"><code>TEXT</code></em> prior to processing input files.
+</p>
+<p>
+You can specify this option multiple times, and the <em class="replaceable"><code>TEXT</code></em>
+will be concatenated.
+</p>
+<p>
+When used along with a template file, <em class="replaceable"><code>TEXT</code></em>
+will be prepended to the template's <code class="literal">file-header</code> section.
+</p>
+</td>
 </tr>
 <tr>
 <td><p><span class="term"><code class="option">--fprod</code> <em class="replaceable"><code>TEXT</code></em></span></p></td>
-<td><p>
-Put out <em class="replaceable"><code>TEXT</code></em> everytime a new input file
+<td>
+<p>
+Emits <em class="replaceable"><code>TEXT</code></em> every time a new input file
 is being processed.
-</p></td>
+</p>
+<p>
+You can specify this option multiple times, and the <em class="replaceable"><code>TEXT</code></em>
+will be concatenated.
+</p>
+<p>
+When used along with a template file, <em class="replaceable"><code>TEXT</code></em>
+will be appended to the template's <code class="literal">file-production</code> section.
+</p>
+</td>
 </tr>
 <tr>
 <td><p><span class="term"><code class="option">--ftail</code> <em class="replaceable"><code>TEXT</code></em></span></p></td>
-<td><p>
-Put out <em class="replaceable"><code>TEXT</code></em> after all input files have been
+<td>
+<p>
+Emits <em class="replaceable"><code>TEXT</code></em> after all input files have been
 processed.
-</p></td>
+</p>
+<p>
+You can specify this option multiple times, and the <em class="replaceable"><code>TEXT</code></em>
+will be concatenated.
+</p>
+<p>
+When used along with a template file, <em class="replaceable"><code>TEXT</code></em>
+will be appended to the template's <code class="literal">file-tail</code> section.
+</p>
+</td>
 </tr>
 <tr>
 <td><p><span class="term"><code class="option">--eprod</code> <em class="replaceable"><code>TEXT</code></em></span></p></td>
 <td><p>
-Put out <em class="replaceable"><code>TEXT</code></em> everytime an enum is encountered
+Emits <em class="replaceable"><code>TEXT</code></em> everytime an enum is encountered
 in the input files.
 </p></td>
 </tr>
 <tr>
 <td><p><span class="term"><code class="option">--vhead</code> <em class="replaceable"><code>TEXT</code></em></span></p></td>
-<td><p>
-Put out <em class="replaceable"><code>TEXT</code></em> before iterating over the set of
+<td>
+<p>
+Emits <em class="replaceable"><code>TEXT</code></em> before iterating over the set of
 values of an enum.
-</p></td>
+</p>
+<p>
+You can specify this option multiple times, and the <em class="replaceable"><code>TEXT</code></em>
+will be concatenated.
+</p>
+<p>
+When used along with a template file, <em class="replaceable"><code>TEXT</code></em>
+will be prepended to the template's <code class="literal">value-header</code> section.
+</p>
+</td>
 </tr>
 <tr>
 <td><p><span class="term"><code class="option">--vprod</code> <em class="replaceable"><code>TEXT</code></em></span></p></td>
-<td><p>
-Put out <em class="replaceable"><code>TEXT</code></em> for every value of an enum.
-</p></td>
+<td>
+<p>
+Emits <em class="replaceable"><code>TEXT</code></em> for every value of an enum.
+</p>
+<p>
+You can specify this option multiple times, and the <em class="replaceable"><code>TEXT</code></em>
+will be concatenated.
+</p>
+<p>
+When used along with a template file, <em class="replaceable"><code>TEXT</code></em>
+will be appended to the template's <code class="literal">value-production</code> section.
+</p>
+</td>
 </tr>
 <tr>
 <td><p><span class="term"><code class="option">--vtail</code> <em class="replaceable"><code>TEXT</code></em></span></p></td>
-<td><p>
-Put out <em class="replaceable"><code>TEXT</code></em> after iterating over all values
+<td>
+<p>
+Emits <em class="replaceable"><code>TEXT</code></em> after iterating over all values
 of an enum.
-</p></td>
+</p>
+<p>
+You can specify this option multiple times, and the <em class="replaceable"><code>TEXT</code></em>
+will be concatenated.
+</p>
+<p>
+When used along with a template file, <em class="replaceable"><code>TEXT</code></em>
+will be appended to the template's <code class="literal">value-tail</code> section.
+</p>
+</td>
 </tr>
 <tr>
 <td><p><span class="term"><code class="option">--comments</code> <em class="replaceable"><code>TEXT</code></em></span></p></td>
@@ -369,13 +427,243 @@ Write output to FILE instead of stdout.
 </table></div>
 </div>
 <div class="refsect1">
-<a name="id-1.5.2.7"></a><h2>See also</h2>
+<a name="id-1.5.2.7"></a><h2>Using glib-mkenums with Autotools</h2>
+<p>
+In order to use <span class="command"><strong>glib-mkenums</strong></span> in your project when using
+Autotools as the build system, you will first need to modify your
+<code class="filename">configure.ac</code> file to ensure you find the appropriate
+command using <span class="command"><strong>pkg-config</strong></span>, similarly as to how you discover
+the compiler and linker flags for GLib.
+</p>
+<div class="informalexample">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2
+3</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="function">PKG_PROG_PKG_CONFIG</span><span class="symbol">([</span><span class="number">0.28</span><span class="symbol">])</span>
+<span class="function">PKG_CHECK_VAR</span><span class="symbol">([</span><span class="normal">GLIB_MKENUMS</span><span class="symbol">],</span><span class="normal"> </span><span class="symbol">[</span><span class="normal">glib</span><span class="symbol">-</span><span class="number">2.0</span><span class="symbol">],</span><span class="normal"> </span><span class="symbol">[</span><span class="normal">glib_mkenums</span><span class="symbol">])</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+<p>
+In your <code class="filename">Makefile.am</code> file you will typically use rules
+like these:
+</p>
+<div class="informalexample">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2
+3
+4
+5
+6
+7
+8
+9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="preproc"># A</span><span class="normal"> list of headers to inspect</span>
+<span class="normal">project_headers </span><span class="symbol">=</span><span class="normal"> </span><span class="symbol">\</span>
+<span class="normal">        project</span><span class="symbol">-</span><span class="normal">foo</span><span class="symbol">.</span><span class="normal">h </span><span class="symbol">\</span>
+<span class="normal">        project</span><span class="symbol">-</span><span class="normal">bar</span><span class="symbol">.</span><span class="normal">h </span><span class="symbol">\</span>
+<span class="normal">        project</span><span class="symbol">-</span><span class="normal">baz</span><span class="symbol">.</span><span class="normal">h</span>
+<span class="keyword">enum</span><span class="symbol">-</span><span class="normal">types</span><span class="symbol">.</span><span class="normal">h</span><span class="symbol">:</span><span class="normal"> $</span><span class="symbol">(</span><span class="normal">project_headers</span><span class="symbol">)</span><span class="normal"> </span><span class="keyword">enum</span><span class="symbol">-</span><span class="normal">types</span><span class="symbol">.</span><span class="normal">h</span><span class="symbol">.</span><span class="normal">in</span>
+<span class="normal">        $</span><span class="symbol">(</span><span class="normal">AM_V_GEN</span><span class="symbol">)</span><span class="normal">$</span><span class="symbol">(</span><span class="normal">GLIB_MKENUMS</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">\</span>
+<span class="normal">                </span><span class="symbol">--</span><span class="normal">template</span><span class="symbol">=</span><span class="keyword">enum</span><span class="symbol">-</span><span class="normal">types</span><span class="symbol">.</span><span class="normal">h</span><span class="symbol">.</span><span class="normal">in </span><span class="symbol">\</span>
+<span class="normal">                </span><span class="symbol">--</span><span class="normal">output</span><span class="symbol">=</span><span class="normal">$@ </span><span class="symbol">\</span>
+<span class="normal">                $</span><span class="symbol">(</span><span class="normal">project_headers</span><span class="symbol">)</span>
+<span class="keyword">enum</span><span class="symbol">-</span><span class="normal">types</span><span class="symbol">.</span><span class="normal">c</span><span class="symbol">:</span><span class="normal"> $</span><span class="symbol">(</span><span class="normal">project_headers</span><span class="symbol">)</span><span class="normal"> </span><span class="keyword">enum</span><span class="symbol">-</span><span class="normal">types</span><span class="symbol">.</span><span class="normal">c</span><span class="symbol">.</span><span class="usertype">in</span><span class="normal"> </span><span class="keyword">enum</span><span class="symbol">-</span><span class="normal">types</span><span class="symbol">.</span><span class="normal">h</span>
+<span class="normal">        $</span><span class="symbol">(</span><span class="normal">AM_V_GEN</span><span class="symbol">)</span><span class="normal">$</span><span class="symbol">(</span><span class="normal">GLIB_MKENUMS</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">\</span>
+<span class="normal">                </span><span class="symbol">--</span><span class="normal">template</span><span class="symbol">=</span><span class="keyword">enum</span><span class="symbol">-</span><span class="normal">types</span><span class="symbol">.</span><span class="normal">c</span><span class="symbol">.</span><span class="normal">in </span><span class="symbol">\</span>
+<span class="normal">                </span><span class="symbol">--</span><span class="normal">output</span><span class="symbol">=</span><span class="normal">$@ </span><span class="symbol">\</span>
+<span class="normal">                $</span><span class="symbol">(</span><span class="normal">project_headers</span><span class="symbol">)</span>
+<span class="normal">BUILT_SOURCES </span><span class="symbol">+=</span><span class="normal"> </span><span class="keyword">enum</span><span class="symbol">-</span><span class="normal">types</span><span class="symbol">.</span><span class="usertype">h</span><span class="normal"> </span><span class="keyword">enum</span><span class="symbol">-</span><span class="normal">types</span><span class="symbol">.</span><span class="normal">c</span>
+<span class="normal">CLEANFILES </span><span class="symbol">+=</span><span class="normal"> </span><span class="keyword">enum</span><span class="symbol">-</span><span class="normal">types</span><span class="symbol">.</span><span class="usertype">h</span><span class="normal"> </span><span class="keyword">enum</span><span class="symbol">-</span><span class="normal">types</span><span class="symbol">.</span><span class="normal">c</span>
+<span class="normal">EXTRA_DIST </span><span class="symbol">+=</span><span class="normal"> </span><span class="keyword">enum</span><span class="symbol">-</span><span class="normal">types</span><span class="symbol">.</span><span class="normal">h</span><span class="symbol">.</span><span class="usertype">in</span><span class="normal"> </span><span class="keyword">enum</span><span class="symbol">-</span><span class="normal">types</span><span class="symbol">.</span><span class="normal">c</span><span class="symbol">.</span><span class="normal">in</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+<p>
+In the example above, we have a variable called <code class="literal">project_headers</code>
+where we reference all header files we want to inspect for generating enumeration
+GTypes. In the <code class="filename">enum-types.h</code> rule we use <span class="command"><strong>glib-mkenums</strong></span>
+with a template called <code class="filename">enum-types.h.in</code> in order to generate the
+header file; a header template file will typically look like this:
+</p>
+<div class="informalexample">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2
+3
+4
+5
+6
+7
+8
+9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="comment">/*** BEGIN file-header ***/</span>
+<span class="preproc">#pragma</span><span class="normal"> once</span>
+<span class="comment">/* Include the main project header */</span>
+<span class="preproc">#include</span><span class="normal"> </span><span class="string">"project.h"</span>
+<span class="normal"><a href="../glib-Miscellaneous-Macros.html#G-BEGIN-DECLS:CAPS">G_BEGIN_DECLS</a></span>
+<span class="comment">/*** END file-header ***/</span>
+<span class="comment">/*** BEGIN file-production ***/</span>
+<span class="comment">/* enumerations from "@filename@" */</span>
+<span class="comment">/*** END file-production ***/</span>
+<span class="comment">/*** BEGIN value-header ***/</span>
+<span class="normal"><a href="gobject-Type-Information.html#GType">GType</a> @enum_name@</span><span class="function">_get_type</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span><span class="normal"> <a href="../glib-Miscellaneous-Macros.html#G-GNUC-CONST:CAPS">G_GNUC_CONST</a></span><span class="symbol">;</span>
+<span class="preproc">#define</span><span class="normal"> @ENUMPREFIX@_TYPE_@ENUMSHORT@ </span><span class="symbol">(</span><span class="normal">@enum_name@</span><span class="function">_get_type</span><span class="normal"> </span><span class="symbol">())</span>
+<span class="comment">/*** END value-header ***/</span>
+<span class="comment">/*** BEGIN file-tail ***/</span>
+<span class="normal"><a href="../glib-Miscellaneous-Macros.html#G-END-DECLS:CAPS">G_END_DECLS</a></span>
+<span class="comment">/*** END file-tail ***/</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+<p>
+The <code class="filename">enum-types.c</code> rule is similar to the rule for the
+header file, but will use a different <code class="filename">enum-types.c.in</code> template
+file, similar to this:
+</p>
+<div class="informalexample">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2
+3
+4
+5
+6
+7
+8
+9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28
+29
+30
+31
+32
+33
+34
+35
+36
+37
+38</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="comment">/*** BEGIN file-header ***/</span>
+<span class="preproc">#include</span><span class="normal"> </span><span class="string">"config.h"</span>
+<span class="preproc">#include</span><span class="normal"> </span><span class="string">"enum-types.h"</span>
+<span class="comment">/*** END file-header ***/</span>
+<span class="comment">/*** BEGIN file-production ***/</span>
+<span class="comment">/* enumerations from "@filename@" */</span>
+<span class="comment">/*** END file-production ***/</span>
+<span class="comment">/*** BEGIN value-header ***/</span>
+<span class="normal"><a href="gobject-Type-Information.html#GType">GType</a></span>
+<span class="normal">@enum_name@</span><span class="function">_get_type</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span>
+<span class="cbracket">{</span>
+<span class="normal">  </span><span class="keyword">static</span><span class="normal"> </span><span class="keyword">volatile</span><span class="normal"> </span><span class="usertype">gsize</span><span class="normal"> g_@type@_type_id__volatile</span><span class="symbol">;</span>
+<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="../glib-Threads.html#g-once-init-enter">g_once_init_enter</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">g_define_type_id__volatile</span><span class="symbol">))</span>
+<span class="normal">    </span><span class="cbracket">{</span>
+<span class="normal">      </span><span class="keyword">static</span><span class="normal"> </span><span class="keyword">const</span><span class="normal"> G@Type@</span><span class="usertype">Value</span><span class="normal"> values</span><span class="symbol">[]</span><span class="normal"> </span><span class="symbol">=</span><span class="normal"> </span><span class="cbracket">{</span>
+<span class="comment">/*** END value-header ***/</span>
+<span class="comment">/*** BEGIN value-production ***/</span>
+<span class="normal">            </span><span class="cbracket">{</span><span class="normal"> @VALUENAME@</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"@VALUENAME@"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"@valuenick@"</span><span class="normal"> </span><span class="cbracket">}</span><span class="symbol">,</span>
+<span class="comment">/*** END value-production ***/</span>
+<span class="comment">/*** BEGIN value-tail ***/</span>
+<span class="normal">            </span><span class="cbracket">{</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> <a href="../glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="../glib-Standard-Macros.html#NULL:CAPS">NULL</a> </span><span class="cbracket">}</span>
+<span class="normal">      </span><span class="cbracket">}</span><span class="symbol">;</span>
+<span class="normal">      </span><span class="usertype">GType</span><span class="normal"> g_@type@_type_id </span><span class="symbol">=</span>
+<span class="normal">        g_@type@</span><span class="function">_register_static</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="../glib-Quarks.html#g-intern-static-string">g_intern_static_string</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"@EnumName@"</span><span class="symbol">),</span><span class="normal"> values</span><span class="symbol">);</span>
+<span class="normal">      </span><span class="function"><a href="../glib-Threads.html#g-once-init-leave">g_once_init_leave</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">g_@type@_type_id__volatile</span><span class="symbol">,</span><span class="normal"> g_@type@_type_id</span><span class="symbol">);</span>
+<span class="normal">    </span><span class="cbracket">}</span>
+<span class="normal">  </span><span class="keyword">return</span><span class="normal"> g_@type@_type_id__volatile</span><span class="symbol">;</span>
+<span class="cbracket">}</span>
+<span class="comment">/*** END value-tail ***/</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+</div>
+<div class="refsect1">
+<a name="id-1.5.2.8"></a><h2>See also</h2>
 <p>
 <span class="citerefentry"><span class="refentrytitle">glib-genmarshal</span>(1)</span>
 </p>
 </div>
 </div>
 <div class="footer">
-<hr>Generated by GTK-Doc V1.25.1</div>
+<hr>Generated by GTK-Doc V1.27</div>
 </body>
 </html>