SF.net SVN: geany:[4338] trunk
ntrel at users.sourceforge.net
ntrel at xxxxx
Mon Oct 19 12:15:42 UTC 2009
Revision: 4338
http://geany.svn.sourceforge.net/geany/?rev=4338&view=rev
Author: ntrel
Date: 2009-10-19 12:15:42 +0000 (Mon, 19 Oct 2009)
Log Message:
-----------
Add 'Custom filetypes' section.
Modified Paths:
--------------
trunk/ChangeLog
trunk/doc/geany.html
trunk/doc/geany.txt
Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog 2009-10-19 11:50:36 UTC (rev 4337)
+++ trunk/ChangeLog 2009-10-19 12:15:42 UTC (rev 4338)
@@ -1,3 +1,9 @@
+2009-10-19 Nick Treleaven <nick(dot)treleaven(at)btinternet(dot)com>
+
+ * doc/geany.txt, doc/geany.html:
+ Add 'Custom filetypes' section.
+
+
2009-10-19 Frank Lanitz <frank(at)frank(dot)uvena(dot)de>
* THANKS, src/about.c:
Modified: trunk/doc/geany.html
===================================================================
--- trunk/doc/geany.html 2009-10-19 11:50:36 UTC (rev 4337)
+++ trunk/doc/geany.html 2009-10-19 12:15:42 UTC (rev 4338)
@@ -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="2009-10-03" />
+<meta name="date" content="2009-10-15" />
<style type="text/css">
/*
@@ -139,7 +139,7 @@
<br />Nick Treleaven
<br />Frank Lanitz</td></tr>
<tr><th class="docinfo-name">Date:</th>
-<td>2009-10-03</td></tr>
+<td>2009-10-15</td></tr>
<tr><th class="docinfo-name">Version:</th>
<td>0.19</td></tr>
</tbody>
@@ -392,85 +392,88 @@
<li><a class="reference" href="#tools-menu-items" id="id170" name="id170">Tools menu items</a></li>
<li><a class="reference" href="#global-configuration-file" id="id171" name="id171">Global configuration file</a></li>
<li><a class="reference" href="#filetype-definition-files" id="id172" name="id172">Filetype definition files</a><ul>
-<li><a class="reference" href="#format" id="id173" name="id173">Format</a><ul>
-<li><a class="reference" href="#styling-section" id="id174" name="id174">[styling] Section</a><ul>
-<li><a class="reference" href="#using-a-named-style" id="id175" name="id175">Using a named style</a></li>
+<li><a class="reference" href="#custom-filetypes" id="id173" name="id173">Custom filetypes</a></li>
+<li><a class="reference" href="#system-files" id="id174" name="id174">System files</a></li>
+<li><a class="reference" href="#user-files" id="id175" name="id175">User files</a></li>
+<li><a class="reference" href="#format" id="id176" name="id176">Format</a><ul>
+<li><a class="reference" href="#styling-section" id="id177" name="id177">[styling] Section</a><ul>
+<li><a class="reference" href="#using-a-named-style" id="id178" name="id178">Using a named style</a></li>
</ul>
</li>
-<li><a class="reference" href="#keywords-section" id="id176" name="id176">[keywords] Section</a></li>
-<li><a class="reference" href="#settings-section" id="id177" name="id177">[settings] Section</a></li>
-<li><a class="reference" href="#build-settings-section" id="id178" name="id178">[build_settings] Section</a></li>
+<li><a class="reference" href="#keywords-section" id="id179" name="id179">[keywords] Section</a></li>
+<li><a class="reference" href="#settings-section" id="id180" name="id180">[settings] Section</a></li>
+<li><a class="reference" href="#build-settings-section" id="id181" name="id181">[build_settings] Section</a></li>
</ul>
</li>
-<li><a class="reference" href="#special-file-filetypes-common" id="id179" name="id179">Special file filetypes.common</a><ul>
-<li><a class="reference" href="#named-styles-section" id="id180" name="id180">[named_styles] Section</a></li>
-<li><a class="reference" href="#id5" id="id181" name="id181">[styling] Section</a></li>
-<li><a class="reference" href="#id6" id="id182" name="id182">[settings] Section</a></li>
+<li><a class="reference" href="#special-file-filetypes-common" id="id182" name="id182">Special file filetypes.common</a><ul>
+<li><a class="reference" href="#named-styles-section" id="id183" name="id183">[named_styles] Section</a></li>
+<li><a class="reference" href="#id5" id="id184" name="id184">[styling] Section</a></li>
+<li><a class="reference" href="#id6" id="id185" name="id185">[settings] Section</a></li>
</ul>
</li>
</ul>
</li>
-<li><a class="reference" href="#filetype-extensions" id="id183" name="id183">Filetype extensions</a></li>
-<li><a class="reference" href="#preferences-file-format" id="id184" name="id184">Preferences File Format</a><ul>
-<li><a class="reference" href="#hidden-preferences" id="id185" name="id185">Hidden preferences</a></li>
-<li><a class="reference" href="#build-menu-section" id="id186" name="id186">[build-menu] Section</a></li>
+<li><a class="reference" href="#filetype-extensions" id="id186" name="id186">Filetype extensions</a></li>
+<li><a class="reference" href="#preferences-file-format" id="id187" name="id187">Preferences File Format</a><ul>
+<li><a class="reference" href="#hidden-preferences" id="id188" name="id188">Hidden preferences</a></li>
+<li><a class="reference" href="#build-menu-section" id="id189" name="id189">[build-menu] Section</a></li>
</ul>
</li>
-<li><a class="reference" href="#project-file-format" id="id187" name="id187">Project File Format</a><ul>
-<li><a class="reference" href="#build-menu-additions" id="id188" name="id188">[build-menu] Additions</a></li>
+<li><a class="reference" href="#project-file-format" id="id190" name="id190">Project File Format</a><ul>
+<li><a class="reference" href="#build-menu-additions" id="id191" name="id191">[build-menu] Additions</a></li>
</ul>
</li>
-<li><a class="reference" href="#templates" id="id189" name="id189">Templates</a><ul>
-<li><a class="reference" href="#template-meta-data" id="id190" name="id190">Template meta data</a></li>
-<li><a class="reference" href="#file-templates" id="id191" name="id191">File templates</a><ul>
-<li><a class="reference" href="#custom-file-templates" id="id192" name="id192">Custom file templates</a></li>
-<li><a class="reference" href="#filetype-templates" id="id193" name="id193">Filetype templates</a></li>
+<li><a class="reference" href="#templates" id="id192" name="id192">Templates</a><ul>
+<li><a class="reference" href="#template-meta-data" id="id193" name="id193">Template meta data</a></li>
+<li><a class="reference" href="#file-templates" id="id194" name="id194">File templates</a><ul>
+<li><a class="reference" href="#custom-file-templates" id="id195" name="id195">Custom file templates</a></li>
+<li><a class="reference" href="#filetype-templates" id="id196" name="id196">Filetype templates</a></li>
</ul>
</li>
-<li><a class="reference" href="#customizing-templates" id="id194" name="id194">Customizing templates</a><ul>
-<li><a class="reference" href="#template-wildcards" id="id195" name="id195">Template wildcards</a></li>
+<li><a class="reference" href="#customizing-templates" id="id197" name="id197">Customizing templates</a><ul>
+<li><a class="reference" href="#template-wildcards" id="id198" name="id198">Template wildcards</a></li>
</ul>
</li>
</ul>
</li>
-<li><a class="reference" href="#customizing-the-toolbar" id="id196" name="id196">Customizing the toolbar</a><ul>
-<li><a class="reference" href="#manually-editing-of-the-toolbar-layout" id="id197" name="id197">Manually editing of the toolbar layout</a></li>
-<li><a class="reference" href="#available-toolbar-elements" id="id198" name="id198">Available toolbar elements</a></li>
+<li><a class="reference" href="#customizing-the-toolbar" id="id199" name="id199">Customizing the toolbar</a><ul>
+<li><a class="reference" href="#manually-editing-of-the-toolbar-layout" id="id200" name="id200">Manually editing of the toolbar layout</a></li>
+<li><a class="reference" href="#available-toolbar-elements" id="id201" name="id201">Available toolbar elements</a></li>
</ul>
</li>
</ul>
</li>
-<li><a class="reference" href="#plugin-documentation" id="id199" name="id199">Plugin documentation</a><ul>
-<li><a class="reference" href="#save-actions" id="id200" name="id200">Save Actions</a><ul>
-<li><a class="reference" href="#instant-save" id="id201" name="id201">Instant Save</a></li>
-<li><a class="reference" href="#backup-copy" id="id202" name="id202">Backup Copy</a></li>
+<li><a class="reference" href="#plugin-documentation" id="id202" name="id202">Plugin documentation</a><ul>
+<li><a class="reference" href="#save-actions" id="id203" name="id203">Save Actions</a><ul>
+<li><a class="reference" href="#instant-save" id="id204" name="id204">Instant Save</a></li>
+<li><a class="reference" href="#backup-copy" id="id205" name="id205">Backup Copy</a></li>
</ul>
</li>
</ul>
</li>
-<li><a class="reference" href="#contributing-to-this-document" id="id203" name="id203">Contributing to this document</a></li>
-<li><a class="reference" href="#scintilla-keyboard-commands" id="id204" name="id204">Scintilla keyboard commands</a><ul>
-<li><a class="reference" href="#keyboard-commands" id="id205" name="id205">Keyboard commands</a></li>
+<li><a class="reference" href="#contributing-to-this-document" id="id206" name="id206">Contributing to this document</a></li>
+<li><a class="reference" href="#scintilla-keyboard-commands" id="id207" name="id207">Scintilla keyboard commands</a><ul>
+<li><a class="reference" href="#keyboard-commands" id="id208" name="id208">Keyboard commands</a></li>
</ul>
</li>
-<li><a class="reference" href="#tips-and-tricks" id="id206" name="id206">Tips and tricks</a><ul>
-<li><a class="reference" href="#document-notebook" id="id207" name="id207">Document notebook</a></li>
-<li><a class="reference" href="#editor" id="id208" name="id208">Editor</a></li>
-<li><a class="reference" href="#interface" id="id209" name="id209">Interface</a></li>
-<li><a class="reference" href="#gtk-related" id="id210" name="id210">GTK-related</a></li>
+<li><a class="reference" href="#tips-and-tricks" id="id209" name="id209">Tips and tricks</a><ul>
+<li><a class="reference" href="#document-notebook" id="id210" name="id210">Document notebook</a></li>
+<li><a class="reference" href="#editor" id="id211" name="id211">Editor</a></li>
+<li><a class="reference" href="#interface" id="id212" name="id212">Interface</a></li>
+<li><a class="reference" href="#gtk-related" id="id213" name="id213">GTK-related</a></li>
</ul>
</li>
-<li><a class="reference" href="#compile-time-options" id="id211" name="id211">Compile-time options</a><ul>
-<li><a class="reference" href="#src-geany-h" id="id212" name="id212">src/geany.h</a></li>
-<li><a class="reference" href="#project-h" id="id213" name="id213">project.h</a></li>
-<li><a class="reference" href="#editor-h" id="id214" name="id214">editor.h</a></li>
-<li><a class="reference" href="#keyfile-c" id="id215" name="id215">keyfile.c</a></li>
-<li><a class="reference" href="#build-h" id="id216" name="id216">build.h</a></li>
-<li><a class="reference" href="#build-c" id="id217" name="id217">build.c</a></li>
+<li><a class="reference" href="#compile-time-options" id="id214" name="id214">Compile-time options</a><ul>
+<li><a class="reference" href="#src-geany-h" id="id215" name="id215">src/geany.h</a></li>
+<li><a class="reference" href="#project-h" id="id216" name="id216">project.h</a></li>
+<li><a class="reference" href="#editor-h" id="id217" name="id217">editor.h</a></li>
+<li><a class="reference" href="#keyfile-c" id="id218" name="id218">keyfile.c</a></li>
+<li><a class="reference" href="#build-h" id="id219" name="id219">build.h</a></li>
+<li><a class="reference" href="#build-c" id="id220" name="id220">build.c</a></li>
</ul>
</li>
-<li><a class="reference" href="#gnu-general-public-license" id="id218" name="id218">GNU General Public License</a></li>
-<li><a class="reference" href="#license-for-scintilla-and-scite" id="id219" name="id219">License for Scintilla and SciTE</a></li>
+<li><a class="reference" href="#gnu-general-public-license" id="id221" name="id221">GNU General Public License</a></li>
+<li><a class="reference" href="#license-for-scintilla-and-scite" id="id222" name="id222">License for Scintilla and SciTE</a></li>
</ul>
</div>
<div class="section">
@@ -3957,6 +3960,22 @@
stored in the filetype definition files. Those settings are colors
for syntax highlighting, general settings like comment characters or
word delimiter characters as well as compiler and linker settings.</p>
+<div class="section">
+<h3><a class="toc-backref" href="#id173" id="custom-filetypes" name="custom-filetypes">Custom filetypes</a></h3>
+<p>At startup Geany looks for <tt class="docutils literal"><span class="pre">filetypes.*.conf</span></tt> files in the system and
+user filetype paths, adding any filetypes found with the name matching
+the '<tt class="docutils literal"><span class="pre">*</span></tt>' wildcard.</p>
+<p>Custom filetypes are not as powerful as built-in filetypes. The following
+have been implemented:</p>
+<ul class="simple">
+<li>Recognizing and setting the filetype (after the user has manually edited
+<tt class="docutils literal"><span class="pre">filetype_extensions.conf</span></tt>).</li>
+<li>Filetype settings in the [settings] section (see <a class="reference" href="#format">Format</a>).</li>
+<li>Build commands.</li>
+</ul>
+</div>
+<div class="section">
+<h3><a class="toc-backref" href="#id174" id="system-files" name="system-files">System files</a></h3>
<p>The system-wide configuration files can be found in
<tt class="docutils literal"><span class="pre">$prefix/share/geany</span></tt> and are called <tt class="docutils literal"><span class="pre">filetypes.$ext</span></tt>,
where <tt class="docutils literal"><span class="pre">$prefix</span></tt> is the path where Geany is installed (see
@@ -3969,6 +3988,9 @@
<p class="last">It is not recommended that users edit the system-wide files,
because they will be overridden when Geany is updated.</p>
</div>
+</div>
+<div class="section">
+<h3><a class="toc-backref" href="#id175" id="user-files" name="user-files">User files</a></h3>
<p>To change the settings, copy a file from <tt class="docutils literal"><span class="pre">$prefix/share/geany</span></tt> to
the subdirectory filedefs in your configuration directory (usually
<tt class="docutils literal"><span class="pre">~/.config/geany/</span></tt>).</p>
@@ -3984,10 +4006,11 @@
global definition file in <tt class="docutils literal"><span class="pre">$prefix/share/geany</span></tt>.</p>
<p>As well as the sections listed below, each filetype file can contain
a [build-menu] section as described in <a class="reference" href="#build-menu-section">[build-menu] Section</a>.</p>
+</div>
<div class="section">
-<h3><a class="toc-backref" href="#id173" id="format" name="format">Format</a></h3>
+<h3><a class="toc-backref" href="#id176" id="format" name="format">Format</a></h3>
<div class="section">
-<h4><a class="toc-backref" href="#id174" id="styling-section" name="styling-section">[styling] Section</a></h4>
+<h4><a class="toc-backref" href="#id177" id="styling-section" name="styling-section">[styling] Section</a></h4>
<p>In this section the colors for syntax highlighting are defined. The
manual format is:</p>
<ul class="simple">
@@ -4003,7 +4026,7 @@
<p>This makes the key style have red foreground text, default background
color text and bold emphasis.</p>
<div class="section">
-<h5><a class="toc-backref" href="#id175" id="using-a-named-style" name="using-a-named-style">Using a named style</a></h5>
+<h5><a class="toc-backref" href="#id178" id="using-a-named-style" name="using-a-named-style">Using a named style</a></h5>
<p>The second format uses a <em>named style</em> name to reference a style
defined in filetypes.common.</p>
<ul class="simple">
@@ -4022,7 +4045,7 @@
</div>
</div>
<div class="section">
-<h4><a class="toc-backref" href="#id176" id="keywords-section" name="keywords-section">[keywords] Section</a></h4>
+<h4><a class="toc-backref" href="#id179" id="keywords-section" name="keywords-section">[keywords] Section</a></h4>
<p>This section contains keys for different keyword lists specific to
the filetype. Some filetypes do not support keywords, so adding a
new key will not work. You can only add or remove keywords to/from
@@ -4033,7 +4056,7 @@
</div>
</div>
<div class="section">
-<h4><a class="toc-backref" href="#id177" id="settings-section" name="settings-section">[settings] Section</a></h4>
+<h4><a class="toc-backref" href="#id180" id="settings-section" name="settings-section">[settings] Section</a></h4>
<dl class="docutils">
<dt>extension</dt>
<dd><p class="first">This is the default file extension used when saving files, not
@@ -4096,7 +4119,7 @@
</dl>
</div>
<div class="section">
-<h4><a class="toc-backref" href="#id178" id="build-settings-section" name="build-settings-section">[build_settings] Section</a></h4>
+<h4><a class="toc-backref" href="#id181" id="build-settings-section" name="build-settings-section">[build_settings] Section</a></h4>
<p>As of Geany v0.19 this section is supplemented by the <a class="reference" href="#build-menu-section">[build-menu] Section</a>.
Values that are set in the [build-menu] section will override those in this section.</p>
<dl class="docutils">
@@ -4149,13 +4172,13 @@
</div>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id179" id="special-file-filetypes-common" name="special-file-filetypes-common">Special file filetypes.common</a></h3>
+<h3><a class="toc-backref" href="#id182" id="special-file-filetypes-common" name="special-file-filetypes-common">Special file filetypes.common</a></h3>
<p>There is a special filetype definition file called
filetypes.common. This file defines some general non-filetype-specific
settings.</p>
<p>See the <a class="reference" href="#format">Format</a> section for how to define styles.</p>
<div class="section">
-<h4><a class="toc-backref" href="#id180" id="named-styles-section" name="named-styles-section">[named_styles] Section</a></h4>
+<h4><a class="toc-backref" href="#id183" id="named-styles-section" name="named-styles-section">[named_styles] Section</a></h4>
<p>Named styles declared here can be used in the [styling] section of any
filetypes.* file.</p>
<p>For example:</p>
@@ -4180,7 +4203,7 @@
</div>
</div>
<div class="section">
-<h4><a class="toc-backref" href="#id181" id="id5" name="id5">[styling] Section</a></h4>
+<h4><a class="toc-backref" href="#id184" id="id5" name="id5">[styling] Section</a></h4>
<dl class="docutils">
<dt>default</dt>
<dd><p class="first">This is the default style. It is used for styling files without a
@@ -4346,7 +4369,7 @@
</dl>
</div>
<div class="section">
-<h4><a class="toc-backref" href="#id182" id="id6" name="id6">[settings] Section</a></h4>
+<h4><a class="toc-backref" href="#id185" id="id6" name="id6">[settings] Section</a></h4>
<dl class="docutils">
<dt>whitespace_chars</dt>
<dd><p class="first">Characters to treat as whitespace. These characters are ignored
@@ -4360,7 +4383,7 @@
</div>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id183" id="filetype-extensions" name="filetype-extensions">Filetype extensions</a></h2>
+<h2><a class="toc-backref" href="#id186" id="filetype-extensions" name="filetype-extensions">Filetype extensions</a></h2>
<p>To change the default filetype extension used when saving a new file,
see <a class="reference" href="#filetype-definition-files">Filetype definition files</a>.</p>
<p>You can override the list of file extensions that Geany uses for each
@@ -4386,12 +4409,12 @@
</pre>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id184" id="preferences-file-format" name="preferences-file-format">Preferences File Format</a></h2>
+<h2><a class="toc-backref" href="#id187" id="preferences-file-format" name="preferences-file-format">Preferences File Format</a></h2>
<p>The preferences file <tt class="docutils literal"><span class="pre">~/.config/geany/geany.conf</span></tt> holds settings for all the items configured
in the preferences dialog. These are not detailed as they should not be edited
as they are overwritten by Geany.</p>
<div class="section">
-<h3><a class="toc-backref" href="#id185" id="hidden-preferences" name="hidden-preferences">Hidden preferences</a></h3>
+<h3><a class="toc-backref" href="#id188" 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>
@@ -4519,7 +4542,7 @@
</table>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id186" id="build-menu-section" name="build-menu-section">[build-menu] Section</a></h3>
+<h3><a class="toc-backref" href="#id189" 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
@@ -4551,11 +4574,11 @@
</div>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id187" id="project-file-format" name="project-file-format">Project File Format</a></h2>
+<h2><a class="toc-backref" href="#id190" 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="#id188" id="build-menu-additions" name="build-menu-additions">[build-menu] Additions</a></h3>
+<h3><a class="toc-backref" href="#id191" 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
@@ -4571,7 +4594,7 @@
</div>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id189" id="templates" name="templates">Templates</a></h2>
+<h2><a class="toc-backref" href="#id192" id="templates" name="templates">Templates</a></h2>
<p>Geany supports the following templates:</p>
<ul class="simple">
<li>ChangeLog entry</li>
@@ -4594,7 +4617,7 @@
function description won't contain the correct function name but "unknown"
instead.</p>
<div class="section">
-<h3><a class="toc-backref" href="#id190" id="template-meta-data" name="template-meta-data">Template meta data</a></h3>
+<h3><a class="toc-backref" href="#id193" 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 "Templates" (see
@@ -4604,7 +4627,7 @@
at startup.</p>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id191" id="file-templates" name="file-templates">File templates</a></h3>
+<h3><a class="toc-backref" href="#id194" 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>
@@ -4616,7 +4639,7 @@
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="#id192" id="custom-file-templates" name="custom-file-templates">Custom file templates</a></h4>
+<h4><a class="toc-backref" href="#id195" id="custom-file-templates" name="custom-file-templates">Custom file templates</a></h4>
<p>These are read from the following directories:</p>
<ul class="simple">
<li><tt class="docutils literal"><span class="pre">$prefix/share/geany/templates/files</span></tt> (see <a class="reference" href="#installation-prefix">Installation prefix</a>)</li>
@@ -4631,7 +4654,7 @@
template, only after adding a new one.</p>
</div>
<div class="section">
-<h4><a class="toc-backref" href="#id193" id="filetype-templates" name="filetype-templates">Filetype templates</a></h4>
+<h4><a class="toc-backref" href="#id196" id="filetype-templates" name="filetype-templates">Filetype templates</a></h4>
<div class="note">
<p class="first admonition-title">Note</p>
<p class="last">It's recommended to use custom file templates instead.</p>
@@ -4647,7 +4670,7 @@
</div>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id194" id="customizing-templates" name="customizing-templates">Customizing templates</a></h3>
+<h3><a class="toc-backref" href="#id197" 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
@@ -4655,7 +4678,7 @@
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="#id195" id="template-wildcards" name="template-wildcards">Template wildcards</a></h4>
+<h4><a class="toc-backref" href="#id198" id="template-wildcards" name="template-wildcards">Template wildcards</a></h4>
<p>All wildcards must be enclosed by "{" and "}", e.g. {date}.</p>
<table border="1" class="docutils">
<colgroup>
@@ -4776,13 +4799,13 @@
</div>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id196" id="customizing-the-toolbar" name="customizing-the-toolbar">Customizing the toolbar</a></h2>
+<h2><a class="toc-backref" href="#id199" 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
by manually editing the 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="#id197" id="manually-editing-of-the-toolbar-layout" name="manually-editing-of-the-toolbar-layout">Manually editing of the toolbar layout</a></h3>
+<h3><a class="toc-backref" href="#id200" id="manually-editing-of-the-toolbar-layout" name="manually-editing-of-the-toolbar-layout">Manually editing of the toolbar layout</a></h3>
<p>To override the system-wide configuration file, copy it from
<tt class="docutils literal"><span class="pre">$prefix/share/geany</span></tt> to your configuration directory, usually
<tt class="docutils literal"><span class="pre">~/.config/geany/</span></tt>. <tt class="docutils literal"><span class="pre">$prefix</span></tt> is the path where Geany is installed
@@ -4806,7 +4829,7 @@
</div>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id198" id="available-toolbar-elements" name="available-toolbar-elements">Available toolbar elements</a></h3>
+<h3><a class="toc-backref" href="#id201" id="available-toolbar-elements" name="available-toolbar-elements">Available toolbar elements</a></h3>
<table border="1" class="docutils">
<colgroup>
<col width="19%" />
@@ -4920,11 +4943,11 @@
</div>
</div>
<div class="section">
-<h1><a class="toc-backref" href="#id199" id="plugin-documentation" name="plugin-documentation">Plugin documentation</a></h1>
+<h1><a class="toc-backref" href="#id202" id="plugin-documentation" name="plugin-documentation">Plugin documentation</a></h1>
<div class="section">
-<h2><a class="toc-backref" href="#id200" id="save-actions" name="save-actions">Save Actions</a></h2>
+<h2><a class="toc-backref" href="#id203" id="save-actions" name="save-actions">Save Actions</a></h2>
<div class="section">
-<h3><a class="toc-backref" href="#id201" id="instant-save" name="instant-save">Instant Save</a></h3>
+<h3><a class="toc-backref" href="#id204" id="instant-save" name="instant-save">Instant Save</a></h3>
<p>This plugin sets on every new file (File->New or File-> New (with template))
a randomly chosen filename and set its filetype appropriate to the used template
or when no template was used, to a configurable default filetype.
@@ -4934,7 +4957,7 @@
similar.</p>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id202" id="backup-copy" name="backup-copy">Backup Copy</a></h3>
+<h3><a class="toc-backref" href="#id205" 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
@@ -4945,7 +4968,7 @@
</div>
</div>
<div class="section">
-<h1><a class="toc-backref" href="#id203" id="contributing-to-this-document" name="contributing-to-this-document">Contributing to this document</a></h1>
+<h1><a class="toc-backref" href="#id206" 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 "reST"). 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
@@ -4965,7 +4988,7 @@
and Fedora systems.</p>
</div>
<div class="section">
-<h1><a class="toc-backref" href="#id204" id="scintilla-keyboard-commands" name="scintilla-keyboard-commands">Scintilla keyboard commands</a></h1>
+<h1><a class="toc-backref" href="#id207" id="scintilla-keyboard-commands" name="scintilla-keyboard-commands">Scintilla keyboard commands</a></h1>
<p>Copyright © 1998, 2006 Neil Hodgson <neilh(at)scintilla(dot)org></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
@@ -4974,7 +4997,7 @@
Scintilla and SciTE</a>.</p>
<p>20 June 2006</p>
<div class="section">
-<h2><a class="toc-backref" href="#id205" id="keyboard-commands" name="keyboard-commands">Keyboard commands</a></h2>
+<h2><a class="toc-backref" href="#id208" 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
@@ -5056,9 +5079,9 @@
</div>
</div>
<div class="section">
-<h1><a class="toc-backref" href="#id206" id="tips-and-tricks" name="tips-and-tricks">Tips and tricks</a></h1>
+<h1><a class="toc-backref" href="#id209" id="tips-and-tricks" name="tips-and-tricks">Tips and tricks</a></h1>
<div class="section">
-<h2><a class="toc-backref" href="#id207" id="document-notebook" name="document-notebook">Document notebook</a></h2>
+<h2><a class="toc-backref" href="#id210" 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>
@@ -5069,7 +5092,7 @@
</ul>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id208" id="editor" name="editor">Editor</a></h2>
+<h2><a class="toc-backref" href="#id211" 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>
@@ -5079,13 +5102,13 @@
</ul>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id209" id="interface" name="interface">Interface</a></h2>
+<h2><a class="toc-backref" href="#id212" 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="#id210" id="gtk-related" name="gtk-related">GTK-related</a></h2>
+<h2><a class="toc-backref" href="#id213" 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>
@@ -5100,7 +5123,7 @@
</div>
</div>
<div class="section">
-<h1><a class="toc-backref" href="#id211" id="compile-time-options" name="compile-time-options">Compile-time options</a></h1>
+<h1><a class="toc-backref" href="#id214" 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
@@ -5112,7 +5135,7 @@
<p class="last">Most users should not need to change these options.</p>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id212" id="src-geany-h" name="src-geany-h">src/geany.h</a></h2>
+<h2><a class="toc-backref" href="#id215" id="src-geany-h" name="src-geany-h">src/geany.h</a></h2>
<table border="1" class="docutils">
<colgroup>
<col width="33%" />
@@ -5169,7 +5192,7 @@
</table>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id213" id="project-h" name="project-h">project.h</a></h2>
+<h2><a class="toc-backref" href="#id216" id="project-h" name="project-h">project.h</a></h2>
<table border="1" class="docutils">
<colgroup>
<col width="33%" />
@@ -5194,7 +5217,7 @@
</table>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id214" id="editor-h" name="editor-h">editor.h</a></h2>
+<h2><a class="toc-backref" href="#id217" id="editor-h" name="editor-h">editor.h</a></h2>
<table border="1" class="docutils">
<colgroup>
<col width="33%" />
@@ -5220,7 +5243,7 @@
</table>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id215" id="keyfile-c" name="keyfile-c">keyfile.c</a></h2>
+<h2><a class="toc-backref" href="#id218" 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>
@@ -5301,7 +5324,7 @@
</table>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id216" id="build-h" name="build-h">build.h</a></h2>
+<h2><a class="toc-backref" href="#id219" id="build-h" name="build-h">build.h</a></h2>
<table border="1" class="docutils">
<colgroup>
<col width="33%" />
@@ -5331,7 +5354,7 @@
</table>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id217" id="build-c" name="build-c">build.c</a></h2>
+<h2><a class="toc-backref" href="#id220" id="build-c" name="build-c">build.c</a></h2>
<table border="1" class="docutils">
<colgroup>
<col width="33%" />
@@ -5362,7 +5385,7 @@
</div>
</div>
<div class="section">
-<h1><a class="toc-backref" href="#id218" id="gnu-general-public-license" name="gnu-general-public-license">GNU General Public License</a></h1>
+<h1><a class="toc-backref" href="#id221" 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
@@ -5707,7 +5730,7 @@
</pre>
</div>
<div class="section">
-<h1><a class="toc-backref" href="#id219" 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="#id222" 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 <neilh(at)scintilla(dot)org></p>
<p>All Rights Reserved</p>
<p>Permission to use, copy, modify, and distribute this software and
@@ -5727,7 +5750,7 @@
<div class="footer">
<hr class="footer" />
<a class="reference" href="geany.txt">View document source</a>.
-Generated on: 2009-10-15 14:51 UTC.
+Generated on: 2009-10-19 12:10 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>
Modified: trunk/doc/geany.txt
===================================================================
--- trunk/doc/geany.txt 2009-10-19 11:50:36 UTC (rev 4337)
+++ trunk/doc/geany.txt 2009-10-19 12:15:42 UTC (rev 4338)
@@ -3322,6 +3322,22 @@
for syntax highlighting, general settings like comment characters or
word delimiter characters as well as compiler and linker settings.
+Custom filetypes
+^^^^^^^^^^^^^^^^
+At startup Geany looks for ``filetypes.*.conf`` files in the system and
+user filetype paths, adding any filetypes found with the name matching
+the '``*``' wildcard.
+
+Custom filetypes are not as powerful as built-in filetypes. The following
+have been implemented:
+
+* Recognizing and setting the filetype (after the user has manually edited
+ ``filetype_extensions.conf``).
+* Filetype settings in the [settings] section (see `Format`_).
+* Build commands.
+
+System files
+^^^^^^^^^^^^
The system-wide configuration files can be found in
``$prefix/share/geany`` and are called ``filetypes.$ext``,
where ``$prefix`` is the path where Geany is installed (see
@@ -3334,6 +3350,8 @@
It is not recommended that users edit the system-wide files,
because they will be overridden when Geany is updated.
+User files
+^^^^^^^^^^
To change the settings, copy a file from ``$prefix/share/geany`` to
the subdirectory filedefs in your configuration directory (usually
``~/.config/geany/``).
This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.
More information about the Commits
mailing list