RubyGems - gtksourceview3 - Versions diffs - 2.2.0-x86-mingw32 → 2.2.1-x86-mingw32 - Mend

gtksourceview3 2.2.0-x86-mingw32 → 2.2.1-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 (235) hide show

data/vendor/local/share/gtk-doc/html/gtksourceview-3.0/lang-reference.html CHANGED Viewed

@@ -8,12 +8,12 @@
 <link rel="up" href="ch02.html" title="Syntax highlighting reference">
 <link rel="prev" href="lang-tutorial.html" title="Language Definition v2.0 Tutorial">
 <link rel="next" href="style-reference.html" title="Style Scheme Definition Reference">
-<meta name="generator" content="GTK-Doc V1.19.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.21.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
-<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
-<td width="100%" align="left"></td>
+<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
+<td width="100%" align="left" class="shortcuts"></td>
 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
 <td><a accesskey="u" href="ch02.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
 <td><a accesskey="p" href="lang-tutorial.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
@@ -28,18 +28,15 @@
 Reference to the GtkSourceView language definition file format
 </p>
 </td>
-<td valign="top" align="right"></td>
+<td class="gallery_image" valign="top" align="right"></td>
 </tr></table></div>
 <div class="refsect1">
 <a name="id-1.3.3.3"></a><h2>Overview</h2>
-<div class="note">
-<h3 class="title">Note</h3>
-<p>
+<div class="note"><p>
     The version 2 here refers to the language definition file format,
     not to the version of GtkSourceView. So this reference is suitable
     for GtkSourceView 2 and 3.
-  </p>
-</div>
+  </p></div>
 <p>
 This is an overview of the Language Definition XML format, describing the
 meaning and usage of every element and attribute.  The formal definition is
@@ -51,7 +48,42 @@ should be installed on your system in the directory
 </p>
 </div>
 <div class="refsect1">
-<a name="id-1.3.3.4"></a><h2>Tag <code class="code">&lt;language&gt;</code>
+<a name="id-1.3.3.4"></a><h2>Best practices</h2>
+<p>
+It is better to follow the following rules, especially if you want to
+contribute upstream, and get your language definition file included in
+GtkSourceView.
+</p>
+<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
+<li class="listitem"><p>
+      Indentation: 2 spaces.
+    </p></li>
+<li class="listitem"><p>
+      Have the main context at the bottom.
+    </p></li>
+<li class="listitem"><p>
+      Use references to def.lang.
+    </p></li>
+<li class="listitem"><p>
+      Add an example in tests/syntax-highlighting/.
+    </p></li>
+<li class="listitem"><p>
+      LGPL v2.1+ license (copy/paste the license header from c.lang, for
+      example).
+    </p></li>
+<li class="listitem"><p>
+      Add the e-mail address of the language definition file author(s).
+    </p></li>
+<li class="listitem"><p>
+      Refer to the HACKING file for submitting your language definition
+      file upstream. If the file is not included upstream, you can also
+      add the language definition file to the GtkSourceView wiki, so
+      users can easily find it.
+    </p></li>
+</ul></div>
+</div>
+<div class="refsect1">
+<a name="id-1.3.3.5"></a><h2>Tag <code class="code">&lt;language&gt;</code>
 </h2>
 <p>
 The root element for Language Definition files.
@@ -97,7 +129,7 @@ The version of the XML format (currently "2.0").
 The translatable category in which the language has to be grouped when
 presented to the user. It can be marked for translation putting
 an underscore before the attribute name. Currently used categories in
-GtkSourceView are "Sources", "Scripts",  "Markup" and "Others", but
+GtkSourceView are "Source", "Script",  "Markup" and "Other", but
 it is possible to use arbitrary categories (while usually discouraged).
 </p></td>
 </tr>
@@ -114,7 +146,7 @@ a syntax highlighting choice.
 </div>
 </div>
 <div class="refsect1">
-<a name="id-1.3.3.5"></a><h2>Tag <code class="code">&lt;metadata&gt;</code>
+<a name="id-1.3.3.6"></a><h2>Tag <code class="code">&lt;metadata&gt;</code>
 </h2>
 <p>
 Contains optional metadata about the language definition.
@@ -148,7 +180,7 @@ files.
 </p></dd>
 </div>
 <div class="refsect1">
-<a name="id-1.3.3.6"></a><h2>Tag <code class="code">&lt;styles&gt;</code>
+<a name="id-1.3.3.7"></a><h2>Tag <code class="code">&lt;styles&gt;</code>
 </h2>
 <p>
 Contains the definitions of every style used in the current language and
@@ -160,10 +192,10 @@ Contained elements:
 </p>
 </div>
 <div class="refsect1">
-<a name="id-1.3.3.7"></a><h2>Tag <code class="code">&lt;style&gt;</code>
+<a name="id-1.3.3.8"></a><h2>Tag <code class="code">&lt;style&gt;</code>
 </h2>
 <p>
-Defines a style, associating it's id with a user visible translatable
+Defines a style, associating its id with a user visible translatable
 name and a default style.
 </p>
 <p>
@@ -201,7 +233,7 @@ font properties defined for those default styles.
 The id of the default style has to be preceded with the id of the
 language where it is defined, separated with a semicolon ":".
 When omitted the style is not considered derived from any style and will
-be not highlighted until the user specifies a color scheme for this
+not be highlighted until the user specifies a color scheme for this
 style.
 </p></td>
 </tr>
@@ -210,7 +242,7 @@ style.
 </div>
 </div>
 <div class="refsect1">
-<a name="id-1.3.3.8"></a><h2>Tag <code class="code">&lt;keyword-char-class&gt;</code>
+<a name="id-1.3.3.9"></a><h2>Tag <code class="code">&lt;keyword-char-class&gt;</code>
 </h2>
 <p>
 Contains a regex character class used to redefine the customizable
@@ -223,7 +255,7 @@ Contained elements: none.
 </p>
 </div>
 <div class="refsect1">
-<a name="id-1.3.3.9"></a><h2>Tag <code class="code">&lt;default-regex-options&gt;</code>
+<a name="id-1.3.3.10"></a><h2>Tag <code class="code">&lt;default-regex-options&gt;</code>
 </h2>
 <p>
 Used to set global options for how regular expressions are processed.
@@ -242,7 +274,7 @@ Contained elements: none.
 <tr>
 <td><p><span class="term"><code class="code">case-sensitive</code> (optional)</span></p></td>
 <td><p>Set to <code class="code">false</code> to make regular expressions
-ignore case.
+ignore case.
 Defaults to <code class="code">true</code>.
 </p></td>
 </tr>
@@ -265,12 +297,9 @@ Defaults to <code class="code">false</code>.
 </tbody>
 </table>
 </div>
-<p>
-Contained elements: none.
-</p>
 </div>
 <div class="refsect1">
-<a name="id-1.3.3.10"></a><h2>Tag <code class="code">&lt;definitions&gt;</code>
+<a name="id-1.3.3.11"></a><h2>Tag <code class="code">&lt;definitions&gt;</code>
 </h2>
 <p>
 The element containing the real description of the syntax to be
@@ -291,7 +320,7 @@ Contained elements:
 </p>
 </div>
 <div class="refsect1">
-<a name="id-1.3.3.11"></a><h2>Tag <code class="code">&lt;define-regex&gt;</code>
+<a name="id-1.3.3.12"></a><h2>Tag <code class="code">&lt;define-regex&gt;</code>
 </h2>
 <p>
 Defines a regular expression that can be reused inside other regular
@@ -318,6 +347,10 @@ be redefined with the <code class="code">&lt;keyword-char-class&gt;</code> (in c
 </p></li>
 </ul></div>
 <p>
+It is allowed to use any of the attributes from
+<code class="code">&lt;default-regex-opts&gt;</code> as attributes of this tag.
+</p>
+<p>
 Contained elements: none.
 </p>
 <div class="variablelist">
@@ -340,7 +373,7 @@ hyphens ("<code class="code">-</code>") and underscores ("<code class="code">_</
 </div>
 </div>
 <div class="refsect1">
-<a name="id-1.3.3.12"></a><h2>Tag <code class="code">&lt;context&gt;</code>
+<a name="id-1.3.3.13"></a><h2>Tag <code class="code">&lt;context&gt;</code>
 </h2>
 <p>
 This is the most important element when describing the syntax: the file to
@@ -349,8 +382,26 @@ colored differently. Contexts can also contain other contexts.
 There are different kind of context elements: simple contexts, container
 contexts, sub-pattern contexts, reference contexts and keyword contexts.
 </p>
+<p>
+Context classes can be enabled or disabled for some contexts, with the
+<code class="code">class</code> and <code class="code">class-disabled</code> attributes. You can create
+your own context classes in custom language definition files. Here are the
+default context classes:
+</p>
+<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
+<li class="listitem"><p>
+      <span class="emphasis"><em>comment</em></span>: the context delimits a comment;
+    </p></li>
+<li class="listitem"><p>
+      <span class="emphasis"><em>string</em></span>: the context delimits a string;
+    </p></li>
+<li class="listitem"><p>
+      <span class="emphasis"><em>no-spell-check</em></span>: the context's content should
+      not be spell checked.
+    </p></li>
+</ul></div>
 <div class="refsect2">
-<a name="id-1.3.3.12.3"></a><h3>Simple contexts</h3>
+<a name="id-1.3.3.13.5"></a><h3>Simple contexts</h3>
 They contain a mandatory <code class="code">&lt;match&gt;</code> element and an optional
 <code class="code">&lt;include&gt;</code> element. The context will span over the strings
 matched by the regular expression contained in the <code class="code">&lt;match&gt;</code>
@@ -359,7 +410,7 @@ can only put sub-pattern contexts.
 <p>
 Contained elements:
-<span class="simplelist"><code class="code">&lt;match&gt;</code> (mandatory)</span>.
+<span class="simplelist"><code class="code">&lt;match&gt;</code> (mandatory), <code class="code">&lt;include&gt;</code> (optional)</span>.
 </p>
 <div class="variablelist">
 <p class="title"><b>Attributes:</b></p>
@@ -415,13 +466,25 @@ A boolean value telling the engine whether the context can occur only
 once in its parent. If not specified it defaults to <code class="code">false</code>.
 </p></td>
 </tr>
+<tr>
+<td><p><span class="term"><code class="code">class</code> (optional)</span></p></td>
+<td><p>
+A space-separated list of context classes to enable.
+</p></td>
+</tr>
+<tr>
+<td><p><span class="term"><code class="code">class-disabled</code> (optional)</span></p></td>
+<td><p>
+A space-separated list of context classes to disable.
+</p></td>
+</tr>
 </tbody>
 </table>
 </div>
 </div>
 <hr>
 <div class="refsect2">
-<a name="id-1.3.3.12.4"></a><h3>Container contexts</h3>
+<a name="id-1.3.3.13.6"></a><h3>Container contexts</h3>
 They contain a <code class="code">&lt;start&gt;</code> element and an optional
 <code class="code">&lt;end&gt;</code>. They respectively contain the regular
 expression that makes the engine enter in the context and the terminating one.
@@ -473,7 +536,7 @@ whole context will be highlighted.
 <td><p><span class="term"><code class="code">extend-parent</code> (optional)</span></p></td>
 <td><p>
 A boolean value telling the engine whether the context has a higher
-priority than the end of he parent. If not specified it defaults to
+priority than the end of its parent. If not specified it defaults to
 <code class="code">true</code>.
 </p></td>
 </tr>
@@ -481,8 +544,8 @@ priority than the end of he parent. If not specified it defaults to
 <td><p><span class="term"><code class="code">end-at-line-end</code> (optional)</span></p></td>
 <td><p>
 A boolean value telling the engine whether the context must be forced
-to end at the end of the line, displaying an error ???? XXX. If not specified
-it defaults to <code class="code">false</code>.
+to end at the end of the line. If not specified it defaults to
+<code class="code">false</code>.
 </p></td>
 </tr>
 <tr>
@@ -507,13 +570,25 @@ A boolean value telling the engine whether the context can occur only
 once in its parent. If not specified it defaults to <code class="code">false</code>.
 </p></td>
 </tr>
+<tr>
+<td><p><span class="term"><code class="code">class</code> (optional)</span></p></td>
+<td><p>
+A space-separated list of context classes to enable.
+</p></td>
+</tr>
+<tr>
+<td><p><span class="term"><code class="code">class-disabled</code> (optional)</span></p></td>
+<td><p>
+A space-separated list of context classes to disable.
+</p></td>
+</tr>
 </tbody>
 </table>
 </div>
 </div>
 <hr>
 <div class="refsect2">
-<a name="id-1.3.3.12.5"></a><h3>Sub-pattern contexts</h3>
+<a name="id-1.3.3.13.7"></a><h3>Sub-pattern contexts</h3>
 <p>
 They refer to a group in a regular expression of the parent context, so it
 is possible to highlight differently only a portion of the matched regular
@@ -555,13 +630,25 @@ expression of the <code class="code">&lt;start&gt;</code> or the <code class="co
 element. In simple contexts it must be omitted.
 </p></td>
 </tr>
+<tr>
+<td><p><span class="term"><code class="code">class</code> (optional)</span></p></td>
+<td><p>
+A space-separated list of context classes to enable.
+</p></td>
+</tr>
+<tr>
+<td><p><span class="term"><code class="code">class-disabled</code> (optional)</span></p></td>
+<td><p>
+A space-separated list of context classes to disable.
+</p></td>
+</tr>
 </tbody>
 </table>
 </div>
 </div>
 <hr>
 <div class="refsect2">
-<a name="id-1.3.3.12.6"></a><h3>Reference contexts</h3>
+<a name="id-1.3.3.13.8"></a><h3>Reference contexts</h3>
 <p>
 Used to include a previously defined context.
 </p>
@@ -598,17 +685,24 @@ in the referenced context.
 <tr>
 <td><p><span class="term"><code class="code">ignore-style</code> (optional)</span></p></td>
 <td><p>
-If this attribute it "true" then the referenced context will not
+If this attribute is "true" then the referenced context will not
 be highlighted. It does not affect child contexts and their styles.
 </p></td>
 </tr>
+<tr>
+<td><p><span class="term"><code class="code">original</code> (optional)</span></p></td>
+<td><p>
+If this attribute is "true", it references the original context, if it
+has been replaced with the <code class="code">&lt;replace&gt;</code> tag.
+</p></td>
+</tr>
 </tbody>
 </table>
 </div>
 </div>
 <hr>
 <div class="refsect2">
-<a name="id-1.3.3.12.7"></a><h3>Keyword contexts</h3>
+<a name="id-1.3.3.13.9"></a><h3>Keyword contexts</h3>
 <p>
 They contain a list of <code class="code">&lt;keyword&gt;</code> and matches every keyword
 listed. You can also put a <code class="code">&lt;prefix&gt;</code> and/or a
@@ -629,7 +723,7 @@ The attributes are the same used in simple contexts.
 </div>
 </div>
 <div class="refsect1">
-<a name="id-1.3.3.13"></a><h2>Tag <code class="code">&lt;include&gt;</code>
+<a name="id-1.3.3.14"></a><h2>Tag <code class="code">&lt;include&gt;</code>
 </h2>
 <p>
 Contains the list of context contained in the current
@@ -641,13 +735,13 @@ Contained elements:
 </p>
 </div>
 <div class="refsect1">
-<a name="id-1.3.3.14"></a><h2>Tag <code class="code">&lt;match&gt;</code>
+<a name="id-1.3.3.15"></a><h2>Tag <code class="code">&lt;match&gt;</code>
 </h2>
 <p>
-Contains the regular expression for the current simple context.
+Contains the regular expression for the current simple context.
 The expression is in the same form used in
 <code class="code">&lt;define-regex&gt;</code> elements.
-It is allowed to use any of the attributes from
+It is allowed to use any of the attributes from
 <code class="code">&lt;default-regex-opts&gt;</code> as attributes of this tag.
 </p>
 <p>
@@ -655,13 +749,13 @@ Contained elements: none.
 </p>
 </div>
 <div class="refsect1">
-<a name="id-1.3.3.15"></a><h2>Tag <code class="code">&lt;start&gt;</code>
+<a name="id-1.3.3.16"></a><h2>Tag <code class="code">&lt;start&gt;</code>
 </h2>
 <p>
 Contains the starting regular expression for the current container context.
 The expression is in the same form used in <code class="code">&lt;define-regex&gt;</code>
 elements.
-It is allowed to use any of the attributes from
+It is allowed to use any of the attributes from
 <code class="code">&lt;default-regex-opts&gt;</code> as attributes of this tag.
 </p>
 <p>
@@ -669,7 +763,7 @@ Contained elements: none.
 </p>
 </div>
 <div class="refsect1">
-<a name="id-1.3.3.16"></a><h2>Tag <code class="code">&lt;end&gt;</code>
+<a name="id-1.3.3.17"></a><h2>Tag <code class="code">&lt;end&gt;</code>
 </h2>
 <p>
 Contains the terminating regular expression for the current container
@@ -687,7 +781,7 @@ implement shell-style here-documents with this code:
 &lt;/context&gt;
 </pre>
 <p>
-It is also possible to use any of the attributes from
+It is also possible to use any of the attributes from
 <code class="code">&lt;default-regex-opts&gt;</code> as attributes of this tag.
 </p>
 <p>
@@ -695,7 +789,7 @@ Contained elements: none.
 </p>
 </div>
 <div class="refsect1">
-<a name="id-1.3.3.17"></a><h2>Tag <code class="code">&lt;keyword&gt;</code>
+<a name="id-1.3.3.18"></a><h2>Tag <code class="code">&lt;keyword&gt;</code>
 </h2>
 <p>
 Contains a keyword to be matched by the current context. The keyword is a
@@ -706,7 +800,7 @@ Contained elements: none.
 </p>
 </div>
 <div class="refsect1">
-<a name="id-1.3.3.18"></a><h2>Tag <code class="code">&lt;prefix&gt;</code>
+<a name="id-1.3.3.19"></a><h2>Tag <code class="code">&lt;prefix&gt;</code>
 </h2>
 <p>
 Contains a prefix common to all of the following keywords in the current
@@ -719,7 +813,7 @@ Contained elements: none.
 </p>
 </div>
 <div class="refsect1">
-<a name="id-1.3.3.19"></a><h2>Tag <code class="code">&lt;suffix&gt;</code>
+<a name="id-1.3.3.20"></a><h2>Tag <code class="code">&lt;suffix&gt;</code>
 </h2>
 <p>
 Contains a suffix common to all of the following keywords in the current
@@ -732,17 +826,17 @@ Contained elements: none.
 </p>
 </div>
 <div class="refsect1">
-<a name="id-1.3.3.20"></a><h2>Tag <code class="code">&lt;replace&gt;</code>
+<a name="id-1.3.3.21"></a><h2>Tag <code class="code">&lt;replace&gt;</code>
 </h2>
 <p>
-The replace tag allows you to change one context so it functions as
-another context.  For example, in the <code class="code">html.lang</code> definition,
-there are a few references to a null context with id
-"<code class="code">external</code>".  In <code class="code">php.lang</code>, that context is
-replaced like this: <code class="code">&lt;replace id="html:external"
-ref="php-block"&gt;</code>, so that php blocks are recognized within the
-<code class="code">html:html</code> context at the points where the
-<code class="code">external</code> context appears.
+The replace tag allows you to change one context so it functions as
+another context.  For example, in the <code class="code">html.lang</code> definition,
+there are a few references to a null context with id
+"<code class="code">embedded-lang-hook</code>".  In <code class="code">php.lang</code>, that context is
+replaced like this: <code class="code">&lt;replace id="html:embedded-lang-hook"
+ref="php-block"&gt;</code>, so that php blocks are recognized within the
+<code class="code">html:html</code> context at the points where the
+<code class="code">embedded-lang-hook</code> context appears.
 </p>
 <p>
 Contained elements: none.
@@ -758,7 +852,7 @@ Contained elements: none.
 <tr>
 <td><p><span class="term"><code class="code">id</code> (mandatory)</span></p></td>
 <td><p>
-The id of the context to replace. Ex: <code class="code">id="html:external"</code>
+The id of the context to replace. Ex: <code class="code">id="html:embedded-lang-hook"</code>
 </p></td>
 </tr>
 <tr>
@@ -774,6 +868,6 @@ The id of the context to put in place of the context being replaced. Ex: <code c
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.19.1</div>
+          Generated by GTK-Doc V1.21.1</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/gtksourceview-3.0/lang-tutorial.html CHANGED Viewed

@@ -8,12 +8,12 @@
 <link rel="up" href="ch02.html" title="Syntax highlighting reference">
 <link rel="prev" href="ch02.html" title="Syntax highlighting reference">
 <link rel="next" href="lang-reference.html" title="Language Definition v2.0 Reference">
-<meta name="generator" content="GTK-Doc V1.19.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.21.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
-<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
-<td width="100%" align="left"></td>
+<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
+<td width="100%" align="left" class="shortcuts"></td>
 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
 <td><a accesskey="u" href="ch02.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
 <td><a accesskey="p" href="ch02.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
@@ -28,18 +28,15 @@
 Guide to the GtkSourceView language definition file format
 </p>
 </td>
-<td valign="top" align="right"></td>
+<td class="gallery_image" valign="top" align="right"></td>
 </tr></table></div>
 <div class="refsect1">
 <a name="tutorial"></a><h2>A language definition for the C language</h2>
-<div class="note">
-<h3 class="title">Note</h3>
-<p>
+<div class="note"><p>
     The version 2 here refers to the language definition file format,
     not to the version of GtkSourceView. So this tutorial is suitable
     for GtkSourceView 2 and 3.
-  </p>
-</div>
+  </p></div>
 <p>
 To describe the syntax of a language GtkSourceView uses an XML format which
 defines nested context to be highlighted. Each context roughly corresponds
@@ -62,7 +59,7 @@ XML declaration:
 After the usual preamble, the main tag is the <code class="code">&lt;language&gt;</code> element:
 </p>
 <pre class="programlisting">
-&lt;language id="c" _name="C" version="2.0" _section="Sources"&gt;
+&lt;language id="c" _name="C" version="2.0" _section="Source"&gt;
 </pre>
 <p>
 The attribute <code class="code">id</code> is used in external references and defines a standard
@@ -73,8 +70,8 @@ the name presented to the user (it is translatable using gettext prepending a
 <p>
 The attribute <code class="code">section</code>, also translatable, tells the category where
 this language should be grouped when it is presented to the user. Currently
-available categories in GtkSourceView are "Sources", "Scripts", "Markup",
-"Scientific" and "Others".
+available categories in GtkSourceView are "Source", "Script", "Markup",
+"Scientific" and "Other".
 </p>
 <p>
 The attribute <code class="code">version</code> specifies the version of the xml syntax
@@ -91,7 +88,7 @@ The <code class="code">&lt;language&gt;</code> element contains three sections:
 <p>
 The <code class="code">&lt;metadata&gt;</code> element is optional and provides a collection
 of properties which specify arbitrary information about the language definition
-file itself. It is particularly important to specify the conventional
+file itself. It is particularly important to specify the conventional
 <code class="code">mimetypes</code> and <code class="code">globs</code> properties that
 GtkSourceView uses to automatically detect which syntax highlighting to use
 for a given file. They respectively contain a semi-colon separated list of
@@ -135,8 +132,8 @@ contexts, so they will share the same appearance.
 &lt;style id="type" _name="Data Type" map-to="def:type"/&gt;
 </pre>
 <p>
-Following the <code class="code">&lt;styles&gt;</code> element there is the
-<code class="code">&lt;definitions&gt;</code> element, which contains the
+Following the <code class="code">&lt;styles&gt;</code> element there is the
+<code class="code">&lt;definitions&gt;</code> element, which contains the
 description proper of the syntax:
 </p>
 <pre class="programlisting">
@@ -523,7 +520,7 @@ for this tutorial:
 </p>
 <pre class="programlisting">
 &lt;?xml version="1.0" encoding="UTF-8"?&gt;
-&lt;language id="c" _name="C" version="2.0" _section="Sources"&gt;
+&lt;language id="c" _name="C" version="2.0" _section="Source"&gt;
   &lt;metadata&gt;
     &lt;property name="mimetypes"&gt;text/x-c;text/x-csrc&lt;/property&gt;
     &lt;property name="globs"&gt;*.c&lt;/property&gt;
@@ -652,6 +649,6 @@ for this tutorial:
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.19.1</div>
+          Generated by GTK-Doc V1.21.1</div>
 </body>
 </html>