From cc71ca0ccabd2a501b56649f3a06891a208f4902 Mon Sep 17 00:00:00 2001
From: Nick Treleaven <nick.treleaven@btinternet.com>
Date: Sat, 30 Apr 2011 15:25:09 +0000
Subject: [PATCH] Add section 'Filetype group membership'.

git-svn-id: https://geany.svn.sourceforge.net/svnroot/geany/trunk@5750 ea778897-0a13-0410-b9d1-a72fbfd435f5
---
 ChangeLog      |   2 +
 doc/geany.html | 188 +++++++++++++++++++++++++++----------------------
 doc/geany.txt  |  21 ++++++
 3 files changed, 128 insertions(+), 83 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 390db798..9b3c0e30 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -3,6 +3,8 @@
  * src/filetypes.c, data/filetype_extensions.conf:
    Revert 'Compiled' filetype group back to 'Programming' (couldn't
    agree on whether e.g. Java is a compiled language).
+ * doc/geany.txt, doc/geany.html:
+   Add section 'Filetype group membership'.
 
 
 2011-04-29  Nick Treleaven  <nick(dot)treleaven(at)btinternet(dot)com>
diff --git a/doc/geany.html b/doc/geany.html
index a0b45ece..c247facd 100644
--- a/doc/geany.html
+++ b/doc/geany.html
@@ -6,7 +6,7 @@
 <meta name="generator" content="Docutils 0.4: http://docutils.sourceforge.net/" />
 <title>Geany</title>
 <meta name="authors" content="Enrico Tröger  Nick Treleaven  Frank Lanitz" />
-<meta name="date" content="2011-04-02" />
+<meta name="date" content="2011-04-26" />
 <style type="text/css">
 
 /*
@@ -139,7 +139,7 @@ Stylesheet for Geany's documentation based on a version of John Gabriele.
 <br />Nick Treleaven
 <br />Frank Lanitz</td></tr>
 <tr><th class="docinfo-name">Date:</th>
-<td>2011-04-02</td></tr>
+<td>2011-04-26</td></tr>
 <tr><th class="docinfo-name">Version:</th>
 <td>0.21</td></tr>
 </tbody>
@@ -441,76 +441,77 @@ of this program, and also in the chapter <a class="reference" href="#gnu-general
 </ul>
 </li>
 <li><a class="reference" href="#filetype-extensions" id="id196" name="id196">Filetype extensions</a></li>
-<li><a class="reference" href="#preferences-file-format" id="id197" name="id197">Preferences file format</a><ul>
-<li><a class="reference" href="#hidden-preferences" id="id198" name="id198">Hidden preferences</a></li>
-<li><a class="reference" href="#build-menu-section" id="id199" name="id199">[build-menu] section</a></li>
+<li><a class="reference" href="#filetype-group-membership" id="id197" name="id197">Filetype group membership</a></li>
+<li><a class="reference" href="#preferences-file-format" id="id198" name="id198">Preferences file format</a><ul>
+<li><a class="reference" href="#hidden-preferences" id="id199" name="id199">Hidden preferences</a></li>
+<li><a class="reference" href="#build-menu-section" id="id200" name="id200">[build-menu] section</a></li>
 </ul>
 </li>
-<li><a class="reference" href="#project-file-format" id="id200" name="id200">Project file format</a><ul>
-<li><a class="reference" href="#build-menu-additions" id="id201" name="id201">[build-menu] additions</a></li>
+<li><a class="reference" href="#project-file-format" id="id201" name="id201">Project file format</a><ul>
+<li><a class="reference" href="#build-menu-additions" id="id202" name="id202">[build-menu] additions</a></li>
 </ul>
 </li>
-<li><a class="reference" href="#templates" id="id202" name="id202">Templates</a><ul>
-<li><a class="reference" href="#template-meta-data" id="id203" name="id203">Template meta data</a></li>
-<li><a class="reference" href="#file-templates" id="id204" name="id204">File templates</a><ul>
-<li><a class="reference" href="#adding-file-templates" id="id205" name="id205">Adding file templates</a></li>
+<li><a class="reference" href="#templates" id="id203" name="id203">Templates</a><ul>
+<li><a class="reference" href="#template-meta-data" id="id204" name="id204">Template meta data</a></li>
+<li><a class="reference" href="#file-templates" id="id205" name="id205">File templates</a><ul>
+<li><a class="reference" href="#adding-file-templates" id="id206" name="id206">Adding file templates</a></li>
 </ul>
 </li>
-<li><a class="reference" href="#customizing-templates" id="id206" name="id206">Customizing templates</a><ul>
-<li><a class="reference" href="#template-wildcards" id="id207" name="id207">Template wildcards</a><ul>
-<li><a class="reference" href="#special-command-wildcard" id="id208" name="id208">Special {command:} wildcard</a></li>
+<li><a class="reference" href="#customizing-templates" id="id207" name="id207">Customizing templates</a><ul>
+<li><a class="reference" href="#template-wildcards" id="id208" name="id208">Template wildcards</a><ul>
+<li><a class="reference" href="#special-command-wildcard" id="id209" name="id209">Special {command:} wildcard</a></li>
 </ul>
 </li>
 </ul>
 </li>
 </ul>
 </li>
-<li><a class="reference" href="#customizing-the-toolbar" id="id209" name="id209">Customizing the toolbar</a><ul>
-<li><a class="reference" href="#manually-editing-the-toolbar-layout" id="id210" name="id210">Manually editing the toolbar layout</a></li>
-<li><a class="reference" href="#available-toolbar-elements" id="id211" name="id211">Available toolbar elements</a></li>
+<li><a class="reference" href="#customizing-the-toolbar" id="id210" name="id210">Customizing the toolbar</a><ul>
+<li><a class="reference" href="#manually-editing-the-toolbar-layout" id="id211" name="id211">Manually editing the toolbar layout</a></li>
+<li><a class="reference" href="#available-toolbar-elements" id="id212" name="id212">Available toolbar elements</a></li>
 </ul>
 </li>
 </ul>
 </li>
-<li><a class="reference" href="#plugin-documentation" id="id212" name="id212">Plugin documentation</a><ul>
-<li><a class="reference" href="#html-characters" id="id213" name="id213">HTML Characters</a><ul>
-<li><a class="reference" href="#insert-entity-dialog" id="id214" name="id214">Insert entity dialog</a></li>
-<li><a class="reference" href="#replace-special-chars-by-its-entity" id="id215" name="id215">Replace special chars by its entity</a><ul>
-<li><a class="reference" href="#at-typing-time" id="id216" name="id216">At typing time</a></li>
-<li><a class="reference" href="#bulk-replacement" id="id217" name="id217">Bulk replacement</a></li>
+<li><a class="reference" href="#plugin-documentation" id="id213" name="id213">Plugin documentation</a><ul>
+<li><a class="reference" href="#html-characters" id="id214" name="id214">HTML Characters</a><ul>
+<li><a class="reference" href="#insert-entity-dialog" id="id215" name="id215">Insert entity dialog</a></li>
+<li><a class="reference" href="#replace-special-chars-by-its-entity" id="id216" name="id216">Replace special chars by its entity</a><ul>
+<li><a class="reference" href="#at-typing-time" id="id217" name="id217">At typing time</a></li>
+<li><a class="reference" href="#bulk-replacement" id="id218" name="id218">Bulk replacement</a></li>
 </ul>
 </li>
 </ul>
 </li>
-<li><a class="reference" href="#save-actions" id="id218" name="id218">Save Actions</a><ul>
-<li><a class="reference" href="#instant-save" id="id219" name="id219">Instant Save</a></li>
-<li><a class="reference" href="#backup-copy" id="id220" name="id220">Backup Copy</a></li>
+<li><a class="reference" href="#save-actions" id="id219" name="id219">Save Actions</a><ul>
+<li><a class="reference" href="#instant-save" id="id220" name="id220">Instant Save</a></li>
+<li><a class="reference" href="#backup-copy" id="id221" name="id221">Backup Copy</a></li>
 </ul>
 </li>
 </ul>
 </li>
-<li><a class="reference" href="#contributing-to-this-document" id="id221" name="id221">Contributing to this document</a></li>
-<li><a class="reference" href="#scintilla-keyboard-commands" id="id222" name="id222">Scintilla keyboard commands</a><ul>
-<li><a class="reference" href="#keyboard-commands" id="id223" name="id223">Keyboard commands</a></li>
+<li><a class="reference" href="#contributing-to-this-document" id="id222" name="id222">Contributing to this document</a></li>
+<li><a class="reference" href="#scintilla-keyboard-commands" id="id223" name="id223">Scintilla keyboard commands</a><ul>
+<li><a class="reference" href="#keyboard-commands" id="id224" name="id224">Keyboard commands</a></li>
 </ul>
 </li>
-<li><a class="reference" href="#tips-and-tricks" id="id224" name="id224">Tips and tricks</a><ul>
-<li><a class="reference" href="#document-notebook" id="id225" name="id225">Document notebook</a></li>
-<li><a class="reference" href="#editor" id="id226" name="id226">Editor</a></li>
-<li><a class="reference" href="#interface" id="id227" name="id227">Interface</a></li>
-<li><a class="reference" href="#gtk-related" id="id228" name="id228">GTK-related</a></li>
+<li><a class="reference" href="#tips-and-tricks" id="id225" name="id225">Tips and tricks</a><ul>
+<li><a class="reference" href="#document-notebook" id="id226" name="id226">Document notebook</a></li>
+<li><a class="reference" href="#editor" id="id227" name="id227">Editor</a></li>
+<li><a class="reference" href="#interface" id="id228" name="id228">Interface</a></li>
+<li><a class="reference" href="#gtk-related" id="id229" name="id229">GTK-related</a></li>
 </ul>
 </li>
-<li><a class="reference" href="#compile-time-options" id="id229" name="id229">Compile-time options</a><ul>
-<li><a class="reference" href="#src-geany-h" id="id230" name="id230">src/geany.h</a></li>
-<li><a class="reference" href="#project-h" id="id231" name="id231">project.h</a></li>
-<li><a class="reference" href="#editor-h" id="id232" name="id232">editor.h</a></li>
-<li><a class="reference" href="#keyfile-c" id="id233" name="id233">keyfile.c</a></li>
-<li><a class="reference" href="#build-c" id="id234" name="id234">build.c</a></li>
+<li><a class="reference" href="#compile-time-options" id="id230" name="id230">Compile-time options</a><ul>
+<li><a class="reference" href="#src-geany-h" id="id231" name="id231">src/geany.h</a></li>
+<li><a class="reference" href="#project-h" id="id232" name="id232">project.h</a></li>
+<li><a class="reference" href="#editor-h" id="id233" name="id233">editor.h</a></li>
+<li><a class="reference" href="#keyfile-c" id="id234" name="id234">keyfile.c</a></li>
+<li><a class="reference" href="#build-c" id="id235" name="id235">build.c</a></li>
 </ul>
 </li>
-<li><a class="reference" href="#gnu-general-public-license" id="id235" name="id235">GNU General Public License</a></li>
-<li><a class="reference" href="#license-for-scintilla-and-scite" id="id236" name="id236">License for Scintilla and SciTE</a></li>
+<li><a class="reference" href="#gnu-general-public-license" id="id236" name="id236">GNU General Public License</a></li>
+<li><a class="reference" href="#license-for-scintilla-and-scite" id="id237" name="id237">License for Scintilla and SciTE</a></li>
 </ul>
 </div>
 <div class="section">
@@ -4960,13 +4961,34 @@ Make=Makefile*;*.mk;Buildfile;
 </pre>
 </div>
 <div class="section">
-<h2><a class="toc-backref" href="#id197" id="preferences-file-format" name="preferences-file-format">Preferences file format</a></h2>
+<h2><a class="toc-backref" href="#id197" id="filetype-group-membership" name="filetype-group-membership">Filetype group membership</a></h2>
+<p>Group membership is also stored in <tt class="docutils literal"><span class="pre">filetype_extensions.conf</span></tt>. This
+file is used to store information Geany needs at startup, whereas the
+separate filetype definition files hold information only needed when
+a document with their filetype is used.</p>
+<p>The format looks like:</p>
+<pre class="literal-block">
+[Groups]
+Programming=C;C++;
+Script=Perl;Python;
+Markup=HTML;XML;
+Misc=Diff;Conf;
+None=None;
+</pre>
+<p>The key names cannot be configured.</p>
+<div class="note">
+<p class="first admonition-title">Note</p>
+<p class="last">Group membership is only read at startup.</p>
+</div>
+</div>
+<div class="section">
+<h2><a class="toc-backref" href="#id198" id="preferences-file-format" name="preferences-file-format">Preferences file format</a></h2>
 <p>The user preferences file <tt class="docutils literal"><span class="pre">geany.conf</span></tt> holds settings for all the items configured
 in the preferences dialog. This file should not be edited while Geany is running
 as the file will be overwritten when the preferences in Geany are changed or Geany
 is quit.</p>
 <div class="section">
-<h3><a class="toc-backref" href="#id198" id="hidden-preferences" name="hidden-preferences">Hidden preferences</a></h3>
+<h3><a class="toc-backref" href="#id199" id="hidden-preferences" name="hidden-preferences">Hidden preferences</a></h3>
 <p>There are some rarely used preferences that are not shown in the Preferences
 dialog. These can be set by editing the preferences file, then
 restarting Geany. Search for the key name, then edit the value. Example:</p>
@@ -5179,7 +5201,7 @@ execute section of the Build menu.</td>
 </table>
 </div>
 <div class="section">
-<h3><a class="toc-backref" href="#id199" id="build-menu-section" name="build-menu-section">[build-menu] section</a></h3>
+<h3><a class="toc-backref" href="#id200" id="build-menu-section" name="build-menu-section">[build-menu] section</a></h3>
 <p>The [build-menu] section contains the configuration of the build menu.
 This section can occur in filetype, preferences and project files and
 always has the format described here.  Different menu items are loaded
@@ -5211,11 +5233,11 @@ starting at 00</li>
 </div>
 </div>
 <div class="section">
-<h2><a class="toc-backref" href="#id200" id="project-file-format" name="project-file-format">Project file format</a></h2>
+<h2><a class="toc-backref" href="#id201" id="project-file-format" name="project-file-format">Project file format</a></h2>
 <p>The project file contains project related settings and possibly a
 record of the current session files.</p>
 <div class="section">
-<h3><a class="toc-backref" href="#id201" id="build-menu-additions" name="build-menu-additions">[build-menu] additions</a></h3>
+<h3><a class="toc-backref" href="#id202" id="build-menu-additions" name="build-menu-additions">[build-menu] additions</a></h3>
 <p>The project file also can have extra fields in the [build-menu] section
 in addition to those listed in <a class="reference" href="#build-menu-section">[build-menu] section</a> above.</p>
 <p>When filetype menu items are configured for the project they are stored
@@ -5231,7 +5253,7 @@ filetype menu item 0 for the C filetype would be</p>
 </div>
 </div>
 <div class="section">
-<h2><a class="toc-backref" href="#id202" id="templates" name="templates">Templates</a></h2>
+<h2><a class="toc-backref" href="#id203" id="templates" name="templates">Templates</a></h2>
 <p>Geany supports the following templates:</p>
 <ul class="simple">
 <li>ChangeLog entry</li>
@@ -5260,7 +5282,7 @@ save a file in the user's template configuration directory. You can
 also force this by selecting <em>Tools-&gt;Reload Configuration</em>.</p>
 </div>
 <div class="section">
-<h3><a class="toc-backref" href="#id203" id="template-meta-data" name="template-meta-data">Template meta data</a></h3>
+<h3><a class="toc-backref" href="#id204" id="template-meta-data" name="template-meta-data">Template meta data</a></h3>
 <p>Meta data can be used with all templates, but by default user set
 meta data is only used for the ChangeLog and File header templates.</p>
 <p>In the configuration dialog you can find a tab &quot;Templates&quot; (see
@@ -5268,7 +5290,7 @@ meta data is only used for the ChangeLog and File header templates.</p>
 which will be inserted in the templates.</p>
 </div>
 <div class="section">
-<h3><a class="toc-backref" href="#id204" id="file-templates" name="file-templates">File templates</a></h3>
+<h3><a class="toc-backref" href="#id205" id="file-templates" name="file-templates">File templates</a></h3>
 <p>File templates are templates used as the basis of a new file. To
 use them, choose the <em>New (with Template)</em> menu item from the <em>File</em>
 menu.</p>
@@ -5280,7 +5302,7 @@ optional template wildcards like <tt class="docutils literal"><span class="pre">
 wildcard can be placed anywhere, but it's usually put on the first
 line of the file, followed by a blank line.</p>
 <div class="section">
-<h4><a class="toc-backref" href="#id205" id="adding-file-templates" name="adding-file-templates">Adding file templates</a></h4>
+<h4><a class="toc-backref" href="#id206" id="adding-file-templates" name="adding-file-templates">Adding file templates</a></h4>
 <p>File templates are read from <tt class="docutils literal"><span class="pre">templates/files</span></tt> under the
 <a class="reference" href="#configuration-file-paths">Configuration file paths</a>.</p>
 <p>The filetype to use is detected from the template file's extension, if
@@ -5291,7 +5313,7 @@ clicked.</p>
 </div>
 </div>
 <div class="section">
-<h3><a class="toc-backref" href="#id206" id="customizing-templates" name="customizing-templates">Customizing templates</a></h3>
+<h3><a class="toc-backref" href="#id207" id="customizing-templates" name="customizing-templates">Customizing templates</a></h3>
 <p>Each template can be customized to your needs. The templates are
 stored in the <tt class="docutils literal"><span class="pre">~/.config/geany/templates/</span></tt> directory (see the section called
 <a class="reference" href="#command-line-options">Command line options</a> for further information about the configuration
@@ -5299,7 +5321,7 @@ directory). Just open the desired template with an editor (ideally,
 Geany ;-) ) and edit the template to your needs. There are some
 wildcards which will be automatically replaced by Geany at startup.</p>
 <div class="section">
-<h4><a class="toc-backref" href="#id207" id="template-wildcards" name="template-wildcards">Template wildcards</a></h4>
+<h4><a class="toc-backref" href="#id208" id="template-wildcards" name="template-wildcards">Template wildcards</a></h4>
 <p>All wildcards must be enclosed by &quot;{&quot; and &quot;}&quot;, e.g. {date}.</p>
 <p><strong>Wildcards for character escaping</strong></p>
 <table border="1" class="docutils">
@@ -5512,7 +5534,7 @@ will only be replaced in file templates.</td>
 </tbody>
 </table>
 <div class="section">
-<h5><a class="toc-backref" href="#id208" id="special-command-wildcard" name="special-command-wildcard">Special {command:} wildcard</a></h5>
+<h5><a class="toc-backref" href="#id209" id="special-command-wildcard" name="special-command-wildcard">Special {command:} wildcard</a></h5>
 <p>The {command:} wildcard is a special one because it can execute
 a specified command and put the command's output (stdout) into
 the template.</p>
@@ -5547,14 +5569,14 @@ standard error and in the Help-&gt;Debug Messages dialog.</p>
 </div>
 </div>
 <div class="section">
-<h2><a class="toc-backref" href="#id209" id="customizing-the-toolbar" name="customizing-the-toolbar">Customizing the toolbar</a></h2>
+<h2><a class="toc-backref" href="#id210" id="customizing-the-toolbar" name="customizing-the-toolbar">Customizing the toolbar</a></h2>
 <p>You can add, remove and reorder the elements in the toolbar by using
 the toolbar editor, or by manually editing the configuration file
 <tt class="docutils literal"><span class="pre">ui_toolbar.xml</span></tt>.</p>
 <p>The toolbar editor can be opened from the preferences editor on the Toolbar tab or
 by right-clicking on the toolbar itself and choosing it from the menu.</p>
 <div class="section">
-<h3><a class="toc-backref" href="#id210" id="manually-editing-the-toolbar-layout" name="manually-editing-the-toolbar-layout">Manually editing the toolbar layout</a></h3>
+<h3><a class="toc-backref" href="#id211" id="manually-editing-the-toolbar-layout" name="manually-editing-the-toolbar-layout">Manually editing the toolbar layout</a></h3>
 <p>To override the system-wide configuration file, copy it to your user
 configuration directory (see <a class="reference" href="#configuration-file-paths">Configuration file paths</a>).</p>
 <p>For example:</p>
@@ -5576,7 +5598,7 @@ will be used instead.</p>
 </div>
 </div>
 <div class="section">
-<h3><a class="toc-backref" href="#id211" id="available-toolbar-elements" name="available-toolbar-elements">Available toolbar elements</a></h3>
+<h3><a class="toc-backref" href="#id212" id="available-toolbar-elements" name="available-toolbar-elements">Available toolbar elements</a></h3>
 <table border="1" class="docutils">
 <colgroup>
 <col width="19%" />
@@ -5690,13 +5712,13 @@ use 'SearchEntry')</td>
 </div>
 </div>
 <div class="section">
-<h1><a class="toc-backref" href="#id212" id="plugin-documentation" name="plugin-documentation">Plugin documentation</a></h1>
+<h1><a class="toc-backref" href="#id213" id="plugin-documentation" name="plugin-documentation">Plugin documentation</a></h1>
 <div class="section">
-<h2><a class="toc-backref" href="#id213" id="html-characters" name="html-characters">HTML Characters</a></h2>
+<h2><a class="toc-backref" href="#id214" id="html-characters" name="html-characters">HTML Characters</a></h2>
 <p>The HTML Characters plugin helps when working with special
 characters in XML/HTML, e.g. German Umlauts ü and ä.</p>
 <div class="section">
-<h3><a class="toc-backref" href="#id214" id="insert-entity-dialog" name="insert-entity-dialog">Insert entity dialog</a></h3>
+<h3><a class="toc-backref" href="#id215" id="insert-entity-dialog" name="insert-entity-dialog">Insert entity dialog</a></h3>
 <p>When the plugin is enabled, you can insert special character
 entities using <em>Tools-&gt;Insert Special HTML Characters</em>.</p>
 <p>This opens up a dialog where you can find a huge amount of special
@@ -5708,7 +5730,7 @@ the entity for the character at the current cursor position. You
 might also like to double click the chosen entity instead.</p>
 </div>
 <div class="section">
-<h3><a class="toc-backref" href="#id215" id="replace-special-chars-by-its-entity" name="replace-special-chars-by-its-entity">Replace special chars by its entity</a></h3>
+<h3><a class="toc-backref" href="#id216" id="replace-special-chars-by-its-entity" name="replace-special-chars-by-its-entity">Replace special chars by its entity</a></h3>
 <p>To help make a XML/HTML document valid the plugin supports
 replacement of special chars known by the plugin. Both bulk
 replacement and immediate replacement during typing are supported.</p>
@@ -5724,7 +5746,7 @@ replacement and immediate replacement during typing are supported.</p>
 </dd>
 </dl>
 <div class="section">
-<h4><a class="toc-backref" href="#id216" id="at-typing-time" name="at-typing-time">At typing time</a></h4>
+<h4><a class="toc-backref" href="#id217" id="at-typing-time" name="at-typing-time">At typing time</a></h4>
 <p>You can activate/deactivate this feature using the <em>Tools-&gt;HTML
 Replacement-&gt;Auto-replace Special Characters</em> menu item. If it's
 activated, all special characters (beside the given exceptions from
@@ -5733,7 +5755,7 @@ above) known by the plugin will be replaced by their entities.</p>
 of this feature.</p>
 </div>
 <div class="section">
-<h4><a class="toc-backref" href="#id217" id="bulk-replacement" name="bulk-replacement">Bulk replacement</a></h4>
+<h4><a class="toc-backref" href="#id218" id="bulk-replacement" name="bulk-replacement">Bulk replacement</a></h4>
 <p>After inserting a huge amount of text, e.g. by using copy &amp; paste, the
 plugin allows bulk replacement of all known characters (beside the
 mentioned exceptions). You can find the function under the same
@@ -5743,9 +5765,9 @@ configure a keybinding for the plugin.</p>
 </div>
 </div>
 <div class="section">
-<h2><a class="toc-backref" href="#id218" id="save-actions" name="save-actions">Save Actions</a></h2>
+<h2><a class="toc-backref" href="#id219" id="save-actions" name="save-actions">Save Actions</a></h2>
 <div class="section">
-<h3><a class="toc-backref" href="#id219" id="instant-save" name="instant-save">Instant Save</a></h3>
+<h3><a class="toc-backref" href="#id220" id="instant-save" name="instant-save">Instant Save</a></h3>
 <p>This plugin sets on every new file (<em>File-&gt;New</em> or <em>File-&gt;New (with template)</em>)
 a randomly chosen filename and set its filetype appropriate to the used template
 or when no template was used, to a configurable default filetype.
@@ -5755,7 +5777,7 @@ useful when you often create new files just for testing some code or something
 similar.</p>
 </div>
 <div class="section">
-<h3><a class="toc-backref" href="#id220" id="backup-copy" name="backup-copy">Backup Copy</a></h3>
+<h3><a class="toc-backref" href="#id221" id="backup-copy" name="backup-copy">Backup Copy</a></h3>
 <p>This plugin creates a backup copy of the current file in Geany when it is
 saved. You can specify the directory where the backup copy is saved and
 you can configure the automatically added extension in the configure dialog
@@ -5766,7 +5788,7 @@ copied into the configured backup directory when the file is saved in Geany.</p>
 </div>
 </div>
 <div class="section">
-<h1><a class="toc-backref" href="#id221" id="contributing-to-this-document" name="contributing-to-this-document">Contributing to this document</a></h1>
+<h1><a class="toc-backref" href="#id222" id="contributing-to-this-document" name="contributing-to-this-document">Contributing to this document</a></h1>
 <p>This document (<tt class="docutils literal"><span class="pre">geany.txt</span></tt>) is written in <a class="reference" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a>
 (or &quot;reST&quot;). The source file for it is located in Geany's <tt class="docutils literal"><span class="pre">doc</span></tt>
 subdirectory.  If you intend on making changes, you should grab the
@@ -5786,7 +5808,7 @@ to build the docs. The package is named <tt class="docutils literal"><span class
 and Fedora systems.</p>
 </div>
 <div class="section">
-<h1><a class="toc-backref" href="#id222" id="scintilla-keyboard-commands" name="scintilla-keyboard-commands">Scintilla keyboard commands</a></h1>
+<h1><a class="toc-backref" href="#id223" id="scintilla-keyboard-commands" name="scintilla-keyboard-commands">Scintilla keyboard commands</a></h1>
 <p>Copyright © 1998, 2006 Neil Hodgson &lt;neilh(at)scintilla(dot)org&gt;</p>
 <p>This appendix is distributed under the terms of the License for
 Scintilla and SciTE. A copy of this license can be found in the file
@@ -5795,7 +5817,7 @@ program and in the appendix of this document. See <a class="reference" href="#li
 Scintilla and SciTE</a>.</p>
 <p>20 June 2006</p>
 <div class="section">
-<h2><a class="toc-backref" href="#id223" id="keyboard-commands" name="keyboard-commands">Keyboard commands</a></h2>
+<h2><a class="toc-backref" href="#id224" id="keyboard-commands" name="keyboard-commands">Keyboard commands</a></h2>
 <p>Keyboard commands for Scintilla mostly follow common Windows and GTK+
 conventions. All move keys (arrows, page up/down, home and end)
 allows to extend or reduce the stream selection when holding the
@@ -5877,9 +5899,9 @@ menus. Some less common commands with no menu equivalent are:</p>
 </div>
 </div>
 <div class="section">
-<h1><a class="toc-backref" href="#id224" id="tips-and-tricks" name="tips-and-tricks">Tips and tricks</a></h1>
+<h1><a class="toc-backref" href="#id225" id="tips-and-tricks" name="tips-and-tricks">Tips and tricks</a></h1>
 <div class="section">
-<h2><a class="toc-backref" href="#id225" id="document-notebook" name="document-notebook">Document notebook</a></h2>
+<h2><a class="toc-backref" href="#id226" id="document-notebook" name="document-notebook">Document notebook</a></h2>
 <ul class="simple">
 <li>Double-click on empty space in the notebook tab bar to open a
 new document.</li>
@@ -5892,7 +5914,7 @@ shortcut). The interface pref must be enabled for this to work.</li>
 </ul>
 </div>
 <div class="section">
-<h2><a class="toc-backref" href="#id226" id="editor" name="editor">Editor</a></h2>
+<h2><a class="toc-backref" href="#id227" id="editor" name="editor">Editor</a></h2>
 <ul class="simple">
 <li>Alt-scroll wheel moves up/down a page.</li>
 <li>Ctrl-scroll wheel zooms in/out.</li>
@@ -5902,13 +5924,13 @@ shortcut). The interface pref must be enabled for this to work.</li>
 </ul>
 </div>
 <div class="section">
-<h2><a class="toc-backref" href="#id227" id="interface" name="interface">Interface</a></h2>
+<h2><a class="toc-backref" href="#id228" id="interface" name="interface">Interface</a></h2>
 <ul class="simple">
 <li>Double-click on a symbol-list group to expand or compact it.</li>
 </ul>
 </div>
 <div class="section">
-<h2><a class="toc-backref" href="#id228" id="gtk-related" name="gtk-related">GTK-related</a></h2>
+<h2><a class="toc-backref" href="#id229" id="gtk-related" name="gtk-related">GTK-related</a></h2>
 <ul class="simple">
 <li>Scrolling the mouse wheel over a notebook tab bar will switch
 notebook pages.</li>
@@ -5923,7 +5945,7 @@ position without having to drag it.</li>
 </div>
 </div>
 <div class="section">
-<h1><a class="toc-backref" href="#id229" id="compile-time-options" name="compile-time-options">Compile-time options</a></h1>
+<h1><a class="toc-backref" href="#id230" id="compile-time-options" name="compile-time-options">Compile-time options</a></h1>
 <p>There are some options which can only be changed at compile time,
 and some options which are used as the default for configurable
 options. To change these options, edit the appropriate source file
@@ -5935,7 +5957,7 @@ not be changed.</p>
 <p class="last">Most users should not need to change these options.</p>
 </div>
 <div class="section">
-<h2><a class="toc-backref" href="#id230" id="src-geany-h" name="src-geany-h">src/geany.h</a></h2>
+<h2><a class="toc-backref" href="#id231" id="src-geany-h" name="src-geany-h">src/geany.h</a></h2>
 <table border="1" class="docutils">
 <colgroup>
 <col width="33%" />
@@ -5992,7 +6014,7 @@ when building on a non-Win32 system.</em></td>
 </table>
 </div>
 <div class="section">
-<h2><a class="toc-backref" href="#id231" id="project-h" name="project-h">project.h</a></h2>
+<h2><a class="toc-backref" href="#id232" id="project-h" name="project-h">project.h</a></h2>
 <table border="1" class="docutils">
 <colgroup>
 <col width="33%" />
@@ -6017,7 +6039,7 @@ open dialog.</td>
 </table>
 </div>
 <div class="section">
-<h2><a class="toc-backref" href="#id232" id="editor-h" name="editor-h">editor.h</a></h2>
+<h2><a class="toc-backref" href="#id233" id="editor-h" name="editor-h">editor.h</a></h2>
 <table border="1" class="docutils">
 <colgroup>
 <col width="33%" />
@@ -6043,7 +6065,7 @@ underscore.</td>
 </table>
 </div>
 <div class="section">
-<h2><a class="toc-backref" href="#id233" id="keyfile-c" name="keyfile-c">keyfile.c</a></h2>
+<h2><a class="toc-backref" href="#id234" id="keyfile-c" name="keyfile-c">keyfile.c</a></h2>
 <p>These are default settings that can be overridden in the <a class="reference" href="#preferences">Preferences</a> dialog.</p>
 <table border="1" class="docutils">
 <colgroup>
@@ -6124,7 +6146,7 @@ Geany provide.</td>
 </table>
 </div>
 <div class="section">
-<h2><a class="toc-backref" href="#id234" id="build-c" name="build-c">build.c</a></h2>
+<h2><a class="toc-backref" href="#id235" id="build-c" name="build-c">build.c</a></h2>
 <table border="1" class="docutils">
 <colgroup>
 <col width="33%" />
@@ -6169,7 +6191,7 @@ overriding the compile setting.</td>
 </div>
 </div>
 <div class="section">
-<h1><a class="toc-backref" href="#id235" id="gnu-general-public-license" name="gnu-general-public-license">GNU General Public License</a></h1>
+<h1><a class="toc-backref" href="#id236" id="gnu-general-public-license" name="gnu-general-public-license">GNU General Public License</a></h1>
 <pre class="literal-block">
             GNU GENERAL PUBLIC LICENSE
                Version 2, June 1991
@@ -6514,7 +6536,7 @@ Public License instead of this License.
 </pre>
 </div>
 <div class="section">
-<h1><a class="toc-backref" href="#id236" id="license-for-scintilla-and-scite" name="license-for-scintilla-and-scite">License for Scintilla and SciTE</a></h1>
+<h1><a class="toc-backref" href="#id237" id="license-for-scintilla-and-scite" name="license-for-scintilla-and-scite">License for Scintilla and SciTE</a></h1>
 <p>Copyright 1998-2003 by Neil Hodgson &lt;neilh(at)scintilla(dot)org&gt;</p>
 <p>All Rights Reserved</p>
 <p>Permission to use, copy, modify, and distribute this software and
@@ -6534,7 +6556,7 @@ USE OR PERFORMANCE OF THIS SOFTWARE.</p>
 <div class="footer">
 <hr class="footer" />
 <a class="reference" href="geany.txt">View document source</a>.
-Generated on: 2011-04-26 16:36 UTC.
+Generated on: 2011-04-30 15:22 UTC.
 Generated by <a class="reference" href="http://docutils.sourceforge.net/">Docutils</a> from <a class="reference" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a> source.
 
 </div>
diff --git a/doc/geany.txt b/doc/geany.txt
index 17879262..584f3250 100644
--- a/doc/geany.txt
+++ b/doc/geany.txt
@@ -4276,6 +4276,27 @@ should look like::
     [Extensions]
     Make=Makefile*;*.mk;Buildfile;
 
+Filetype group membership
+-------------------------
+Group membership is also stored in ``filetype_extensions.conf``. This
+file is used to store information Geany needs at startup, whereas the
+separate filetype definition files hold information only needed when
+a document with their filetype is used.
+
+The format looks like::
+
+    [Groups]
+    Programming=C;C++;
+    Script=Perl;Python;
+    Markup=HTML;XML;
+    Misc=Diff;Conf;
+    None=None;
+
+The key names cannot be configured.
+
+.. note::
+    Group membership is only read at startup.
+
 Preferences file format
 -----------------------