SF.net SVN: geany:[5836] branches/sm

Revision: 5836 http://geany.svn.sourceforge.net/geany/?rev=5836&view=rev Author: statc Date: 2011-06-10 10:26:01 +0000 (Fri, 10 Jun 2011)

Log Message: ----------- Merge trunk (revisions 5738..5833)

Conflicts: src/filetypes.c src/project.c src/ui_utils.c

Modified Paths: -------------- branches/sm/ChangeLog branches/sm/HACKING branches/sm/data/colorschemes/alt.conf branches/sm/data/filetype_extensions.conf branches/sm/data/filetypes.java branches/sm/doc/geany.html branches/sm/doc/geany.txt branches/sm/plugins/Makefile.am branches/sm/plugins/makefile.win32 branches/sm/plugins/splitwindow.c branches/sm/po/ChangeLog branches/sm/po/fr.po branches/sm/po/sl.po branches/sm/scripts/create_py_tags.py branches/sm/src/about.c branches/sm/src/build.c branches/sm/src/callbacks.c branches/sm/src/document.c branches/sm/src/document.h branches/sm/src/documentprivate.h branches/sm/src/editor.c branches/sm/src/encodings.c branches/sm/src/filetypes.c branches/sm/src/filetypes.h branches/sm/src/geanywraplabel.c branches/sm/src/geanywraplabel.h branches/sm/src/highlighting.c branches/sm/src/keybindings.c branches/sm/src/main.c branches/sm/src/msgwindow.c branches/sm/src/plugindata.h branches/sm/src/plugins.c branches/sm/src/prefs.c branches/sm/src/project.c branches/sm/src/search.c branches/sm/src/search.h branches/sm/src/sidebar.c branches/sm/src/stash.c branches/sm/src/ui_utils.c branches/sm/src/ui_utils.h branches/sm/tagmanager/python.c branches/sm/tagmanager/tm_workspace.c branches/sm/wscript

Modified: branches/sm/ChangeLog =================================================================== --- branches/sm/ChangeLog 2011-06-07 18:18:16 UTC (rev 5835) +++ branches/sm/ChangeLog 2011-06-10 10:26:01 UTC (rev 5836) @@ -1,3 +1,206 @@ +2011-06-03 Colomban Wendling <colomban(at)geany(dot)org> + + * src/callbacks.c, src/document.c, src/document.h, src/editor.c, + src/search.c, src/search.h: + Show the actual text the user searched for in messages rather than + the internal one (patch by Eugene Arshinov, thanks). + * src/search.c: + Also use the actual user search in the combo box history. + + +2011-06-02 Enrico Tröger <enrico(dot)troeger(at)uvena(dot)de> + + * src/document.c, src/document.h, src/ui_utils.c, src/ui_utils.h: + Add ui_focus_current_document() and document_grab_focus(). + * src/project.c: + Focus the editor widget after loading project session files. + * scripts/create_py_tags.py: + Ignore tags ending with an underscore. + Dynamically determine the path of Python's standard library instead + of hardcoding it. + Parse all modules of the Python standard library instead of a + hardcoded list of filenames. + + +2011-05-30 Enrico Tröger <enrico(dot)troeger(at)uvena(dot)de> + + * data/filetypes.java: + Move keyword 'enum' to primary keywords (closes #3305737). + + +2011-05-29 Enrico Tröger <enrico(dot)troeger(at)uvena(dot)de> + + * tagmanager/python.c: + When checking for literal strings to ignore, consider also + unicode, binary and raw strings. + * src/plugins.c: + Define and use get_plugin_path() always and move platform dependent + code into the function definition. + Do not add active plugins to the list of plugins when they are + already in the list (closes #3308191). + Check whether the custom plugin path is one of the user or system + plugin paths and if so, ignore it. + + +2011-05-27 Colomban Wendling <colomban(at)geany(dot)org> + + * src/prefs.c: + Fix preferences help button when activated with the keyboard. + + +2011-05-22 Enrico Tröger <enrico(dot)troeger(at)uvena(dot)de> + + * src/about.c, src/build.c, tagmanager/tm_workspace.c: + Remove unused variables (patch by Eugene Arshinov, thanks). + * src/stash.c: + Remove unused variables (suggested by Eugene Arshinov). + * src/ui_utils.c, doc/geany.txt, doc/geany.html: + Do not allow 'Save All' even if 'allow_always_save' is set + (patch by Dimitar Zhekov, thanks). + * data/filetypes.java: + Add 'enum' to secondary keywords + (closes #3305737, patch by Matthew Brush, thanks). + + +2011-05-12 Colomban Wendling <colomban(at)geany(dot)org> + + * src/encodings.c: + Update the HTML content-type encoding detection regexp to accept some + more valid inputs (closes #3300703). + + +2011-05-11 Colomban Wendling <colomban(at)geany(dot)org> + + * src/plugins.c: + Improve the plugin manager dialog a little. + * src/geanywraplabel.c, src/geanywraplabel.h, src/keybindings.c, + src/plugins.c: + Cleanup GeanyWrapLabel a bit. + + +2011-05-09 Colomban Wendling <colomban(at)geany(dot)org> + + * plugins/splitwindow.c: + Remove widget reparenting in Split Window plugin. This fixes plugin + issues on Windows (patch by Matthew Brush, thanks - closes #2725342). + * plugins/Makefile.am, plugins/makefile.win32, wscript: + Enable SplitWindow build on Windows again (re-apply Enrico's patch). + + +2011-05-08 Enrico Tröger <enrico(dot)troeger(at)uvena(dot)de> + + * HACKING: + Add note about patching Glade 2.12 to compile it with + newer GTK versions. + + +2011-05-06 Nick Treleaven <nick(dot)treleaven(at)btinternet(dot)com> + + * src/callbacks.c: + Fix 'Toolbar Preferences' popup menu item (oops). + + +2011-05-03 Colomban Wendling <colomban(at)geany(dot)org> + + * doc/geany.txt, doc/geany.html: + Update the documentation for project patterns and recent FIF dialog + changes. + + +2011-05-03 Nick Treleaven <nick(dot)treleaven(at)btinternet(dot)com> + + * src/highlighting.c, doc/geany.txt, doc/geany.html: + Allow translations for color scheme [theme_info] keys. + * src/build.c, src/filetypes.c, src/filetypes.h, src/main.c: + Save filetype build commands straight after editing them instead of + at shutdown (patch by Dimitar Zhekov, thanks). + + +2011-05-02 Colomban Wendling <colomban(at)geany(dot)org> + + * src/plugindata.h: + Bump plugin API version so a plugin can know the project file + patterns are visible by the user. + + +2011-05-01 Colomban Wendling <colomban(at)geany(dot)org> + + * src/search.c: + Fix pattern filtering when not searching in subdirectories. + + +2011-04-30 Colomban Wendling <colomban(at)geany(dot)org> + + * src/project.c: + Fix project patterns and make them visible (based on a patch + by Jiří Techet, thanks). + * src/search.c: + Use project patterns in the FIF dialog (based on a patch + by Jiří Techet, thanks). + * src/msgwindow.c: + Open the file in the msgwindow even if no line number is specified. + + +2011-04-30 Nick Treleaven <nick(dot)treleaven(at)btinternet(dot)com> + + * 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'. + * src/highlighting.c, doc/geany.txt, doc/geany.html, + data/colorschemes/alt.conf: + Read color scheme name and description for menu item label and + tooltip (based on patch by Matthew Brush, thanks). + + +2011-04-29 Nick Treleaven <nick(dot)treleaven(at)btinternet(dot)com> + + * src/filetypes.c, src/filetypes.h: + Remove now unnecessary Custom filetype group. + * src/filetypes.c: + Move text markup languages into Markup filetype group. + Move some programming language filetypes out of the Miscellaneous + group. + Fix filetype title for some languages. + Don't use 'Languages' for Miscellaneous group label. + These changes mostly proposed by Matthew Brush (thanks). + * src/filetypes.c: + Make custom filetype titles use 'source file' only if their group + is Compiled or Script. + Use 'source file' for reStructuredText title. + + +2011-04-26 Nick Treleaven <nick(dot)treleaven(at)btinternet(dot)com> + + * src/filetypes.c, src/filetypes.h, src/main.c, + data/filetype_extensions.conf: + Make filetype group membership configurable using [Groups] in + filetype_extensions.conf. + Read filetype_extensions.conf when calling filetypes_init_types(), + don't require doclist initialization. + * src/filetypes.c: + Change Programming Languages filetype group label -> Compiled + Languages. + Use 'source file' title for custom filetypes. + * src/prefs.c, doc/geany.txt, doc/geany.html: + Remove Preferences label warning about restarting after editing + template data - this is no longer necessary. + + +2011-04-26 Colomban Wendling <colomban(at)geany(dot)org> + + * src/callbacks.c, src/document.c, src/document.h, + src/documentprivate.h, src/editor.c, src/sidebar.c: + Make sure to update the tag list only for the current document, + avoiding idle updates to show the tag list for the wrong document. + * src/callbacks.c, src/document.c, src/documentprivate.h, + src/sidebar.c: + Avoid changing the tag tree if it's not the one of the current + document, fixing showing the wrong tag list when reloading + configuration files. + + 2011-04-25 Nick Treleaven <nick(dot)treleaven(at)btinternet(dot)com>

* src/utils.c: @@ -5,6 +208,16 @@ <~foo> (oops).

+2011-04-24 Colomban Wendling <colomban(at)geany(dot)org> + + * src/editor.c: + Don't update the tag list when the user is typing (patch by Yura + Siamashka, thanks). + * src/filetypes.c: + When copying filetype groups, add keys from both system and user + ones, making sure user's ones have precedence over system ones. + + 2011-04-23 Nick Treleaven <nick(dot)treleaven(at)btinternet(dot)com>

* src/utils.c, src/utils.h, src/plugindata.h, src/plugins.c, @@ -6081,7 +6294,7 @@ display the right amount of matches. Fix the display of the matches once per line (I broke the original patch). - * src/ui_uitls.c: + * src/ui_utils.c: Fix wrong directory selection behaviour in all Open Folder dialogs (closes #2688020, patch by Marcel Stimberg, thanks). * src/socket.c:

Modified: branches/sm/HACKING =================================================================== --- branches/sm/HACKING 2011-06-07 18:18:16 UTC (rev 5835) +++ branches/sm/HACKING 2011-06-10 10:26:01 UTC (rev 5836) @@ -126,6 +126,15 @@ You can download Glade 2.12.2 here: http://download.geany.org/glade-2.12.2.tar.gz

+On recent GTK versions, you need a small patch to make it compile. +You can get the patch from: +http://download.geany.org/glade-2.12.2-build-fixes.patch + +And then simply apply it like so:: + + $ /tmp/glade-2.12.2% patch -p1 < glade-2.12.2-build-fixes.patch + + GTK API documentation --------------------- The official GTK 2.8 API documentation is not available online anymore,

Modified: branches/sm/data/colorschemes/alt.conf =================================================================== --- branches/sm/data/colorschemes/alt.conf 2011-06-07 18:18:16 UTC (rev 5835) +++ branches/sm/data/colorschemes/alt.conf 2011-06-10 10:26:01 UTC (rev 5836) @@ -1,4 +1,6 @@ -# Set of styles like the Geany <= 0.19 Python/script defaults with gray comments. +[theme_info] +name=Alternate +description=Alternate Geany color scheme with styles like the Geany <= 0.19 Python/script defaults with gray comments.

[named_styles] # see filetypes.common for details

Modified: branches/sm/data/filetype_extensions.conf =================================================================== --- branches/sm/data/filetype_extensions.conf 2011-06-07 18:18:16 UTC (rev 5835) +++ branches/sm/data/filetype_extensions.conf 2011-06-10 10:26:01 UTC (rev 5836) @@ -56,3 +56,11 @@ XML=*.xml;*.sgml;*.xsl;*.xslt;*.xsd;*.xhtml; YAML=*.yaml;*.yml; None=*; + +# Note: restarting is required after editing groups +[Groups] +Programming=Genie;Scala; +Script= +Markup= +Misc= +None=

Modified: branches/sm/data/filetypes.java =================================================================== --- branches/sm/data/filetypes.java 2011-06-07 18:18:16 UTC (rev 5835) +++ branches/sm/data/filetypes.java 2011-06-10 10:26:01 UTC (rev 5836) @@ -25,7 +25,7 @@ globalclass=type

[keywords] -primary=abstract assert break case catch class const continue default do else extends final finally for future generic goto if implements import inner instanceof interface native new outer package private protected public rest return static super switch synchronized this throw throws transient try var volatile while true false null +primary=abstract assert break case catch class const continue default do else enum extends final finally for future generic goto if implements import inner instanceof interface native new outer package private protected public rest return static super switch synchronized this throw throws transient try var volatile while true false null secondary=boolean byte char double float int long short void # documentation keywords for javadoc doccomment=author deprecated exception param return see serial serialData serialField since throws todo version

Modified: branches/sm/doc/geany.html =================================================================== --- branches/sm/doc/geany.html 2011-06-07 18:18:16 UTC (rev 5835) +++ branches/sm/doc/geany.html 2011-06-10 10:26:01 UTC (rev 5836) @@ -3,10 +3,10 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> -<meta name="generator" content="Docutils 0.4: http://docutils.sourceforge.net/" /> +<meta name="generator" content="Docutils 0.7: http://docutils.sourceforge.net/" /> <title>Geany</title> <meta name="authors" content="Enrico Tröger Nick Treleaven Frank Lanitz" /> -<meta name="date" content="2011-04-01" /> +<meta name="date" content="2011-05-03" /> <style type="text/css">

/* @@ -139,7 +139,7 @@ <br />Nick Treleaven <br />Frank Lanitz</td></tr> <tr><th class="docinfo-name">Date:</th> -<td>2011-04-01</td></tr> +<td>2011-05-03</td></tr> <tr><th class="docinfo-name">Version:</th> <td>0.21</td></tr> </tbody> @@ -149,374 +149,375 @@ License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. A copy of this license can be found in the file COPYING included with the source code -of this program, and also in the chapter <a class="reference" href="#gnu-general-public-license">GNU General Public License</a>.</p> -<div class="contents topic"> -<p class="topic-title first"><a id="contents" name="contents">Contents</a></p> +of this program, and also in the chapter <a class="reference internal" href="#gnu-general-public-license">GNU General Public License</a>.</p> +<div class="contents topic" id="contents"> +<p class="topic-title first">Contents</p> <ul class="simple"> -<li><a class="reference" href="#introduction" id="id7" name="id7">Introduction</a><ul> -<li><a class="reference" href="#about-geany" id="id8" name="id8">About Geany</a></li> -<li><a class="reference" href="#where-to-get-it" id="id9" name="id9">Where to get it</a></li> -<li><a class="reference" href="#license" id="id10" name="id10">License</a></li> -<li><a class="reference" href="#about-this-document" id="id11" name="id11">About this document</a></li> +<li><a class="reference internal" href="#introduction" id="id7">Introduction</a><ul> +<li><a class="reference internal" href="#about-geany" id="id8">About Geany</a></li> +<li><a class="reference internal" href="#where-to-get-it" id="id9">Where to get it</a></li> +<li><a class="reference internal" href="#license" id="id10">License</a></li> +<li><a class="reference internal" href="#about-this-document" id="id11">About this document</a></li> </ul> </li> -<li><a class="reference" href="#installation" id="id12" name="id12">Installation</a><ul> -<li><a class="reference" href="#requirements" id="id13" name="id13">Requirements</a></li> -<li><a class="reference" href="#binary-packages" id="id14" name="id14">Binary packages</a></li> -<li><a class="reference" href="#source-compilation" id="id15" name="id15">Source compilation</a><ul> -<li><a class="reference" href="#autotools-based-build-system" id="id16" name="id16">Autotools based build system</a></li> -<li><a class="reference" href="#waf-based-build-system" id="id17" name="id17">Waf based build system</a><ul> -<li><a class="reference" href="#waf-cache" id="id18" name="id18">Waf cache</a><ul> -<li><a class="reference" href="#cleaning-the-cache" id="id19" name="id19">Cleaning the cache</a></li> +<li><a class="reference internal" href="#installation" id="id12">Installation</a><ul> +<li><a class="reference internal" href="#requirements" id="id13">Requirements</a></li> +<li><a class="reference internal" href="#binary-packages" id="id14">Binary packages</a></li> +<li><a class="reference internal" href="#source-compilation" id="id15">Source compilation</a><ul> +<li><a class="reference internal" href="#autotools-based-build-system" id="id16">Autotools based build system</a></li> +<li><a class="reference internal" href="#waf-based-build-system" id="id17">Waf based build system</a><ul> +<li><a class="reference internal" href="#waf-cache" id="id18">Waf cache</a><ul> +<li><a class="reference internal" href="#cleaning-the-cache" id="id19">Cleaning the cache</a></li> </ul> </li> </ul> </li> -<li><a class="reference" href="#custom-installation" id="id20" name="id20">Custom installation</a></li> -<li><a class="reference" href="#dynamic-linking-loader-support-and-vte" id="id21" name="id21">Dynamic linking loader support and VTE</a></li> -<li><a class="reference" href="#build-problems" id="id22" name="id22">Build problems</a></li> +<li><a class="reference internal" href="#custom-installation" id="id20">Custom installation</a></li> +<li><a class="reference internal" href="#dynamic-linking-loader-support-and-vte" id="id21">Dynamic linking loader support and VTE</a></li> +<li><a class="reference internal" href="#build-problems" id="id22">Build problems</a></li> </ul> </li> -<li><a class="reference" href="#installation-prefix" id="id23" name="id23">Installation prefix</a></li> +<li><a class="reference internal" href="#installation-prefix" id="id23">Installation prefix</a></li> </ul> </li> -<li><a class="reference" href="#usage" id="id24" name="id24">Usage</a><ul> -<li><a class="reference" href="#getting-started" id="id25" name="id25">Getting started</a></li> -<li><a class="reference" href="#the-geany-workspace" id="id26" name="id26">The Geany workspace</a></li> -<li><a class="reference" href="#command-line-options" id="id27" name="id27">Command line options</a></li> -<li><a class="reference" href="#general" id="id28" name="id28">General</a><ul> -<li><a class="reference" href="#startup" id="id29" name="id29">Startup</a></li> -<li><a class="reference" href="#opening-files-from-the-command-line-in-a-running-instance" id="id30" name="id30">Opening files from the command-line in a running instance</a></li> -<li><a class="reference" href="#virtual-terminal-emulator-widget-vte" id="id31" name="id31">Virtual terminal emulator widget (VTE)</a></li> -<li><a class="reference" href="#defining-own-widget-styles-using-gtkrc-2-0" id="id32" name="id32">Defining own widget styles using .gtkrc-2.0</a></li> +<li><a class="reference internal" href="#usage" id="id24">Usage</a><ul> +<li><a class="reference internal" href="#getting-started" id="id25">Getting started</a></li> +<li><a class="reference internal" href="#the-geany-workspace" id="id26">The Geany workspace</a></li> +<li><a class="reference internal" href="#command-line-options" id="id27">Command line options</a></li> +<li><a class="reference internal" href="#general" id="id28">General</a><ul> +<li><a class="reference internal" href="#startup" id="id29">Startup</a></li> +<li><a class="reference internal" href="#opening-files-from-the-command-line-in-a-running-instance" id="id30">Opening files from the command-line in a running instance</a></li> +<li><a class="reference internal" href="#virtual-terminal-emulator-widget-vte" id="id31">Virtual terminal emulator widget (VTE)</a></li> +<li><a class="reference internal" href="#defining-own-widget-styles-using-gtkrc-2-0" id="id32">Defining own widget styles using .gtkrc-2.0</a></li> </ul> </li> -<li><a class="reference" href="#documents" id="id33" name="id33">Documents</a><ul> -<li><a class="reference" href="#switching-between-documents" id="id34" name="id34">Switching between documents</a></li> +<li><a class="reference internal" href="#documents" id="id33">Documents</a><ul> +<li><a class="reference internal" href="#switching-between-documents" id="id34">Switching between documents</a></li> </ul> </li> -<li><a class="reference" href="#character-sets-and-unicode-byte-order-mark-bom" id="id35" name="id35">Character sets and Unicode Byte-Order-Mark (BOM)</a><ul> -<li><a class="reference" href="#using-character-sets" id="id36" name="id36">Using character sets</a></li> -<li><a class="reference" href="#in-file-encoding-specification" id="id37" name="id37">In-file encoding specification</a></li> -<li><a class="reference" href="#special-encoding-none" id="id38" name="id38">Special encoding &quot;None&quot;</a></li> -<li><a class="reference" href="#unicode-byte-order-mark-bom" id="id39" name="id39">Unicode Byte-Order-Mark (BOM)</a></li> +<li><a class="reference internal" href="#character-sets-and-unicode-byte-order-mark-bom" id="id35">Character sets and Unicode Byte-Order-Mark (BOM)</a><ul> +<li><a class="reference internal" href="#using-character-sets" id="id36">Using character sets</a></li> +<li><a class="reference internal" href="#in-file-encoding-specification" id="id37">In-file encoding specification</a></li> +<li><a class="reference internal" href="#special-encoding-none" id="id38">Special encoding &quot;None&quot;</a></li> +<li><a class="reference internal" href="#unicode-byte-order-mark-bom" id="id39">Unicode Byte-Order-Mark (BOM)</a></li> </ul> </li> -<li><a class="reference" href="#editing" id="id40" name="id40">Editing</a><ul> -<li><a class="reference" href="#folding" id="id41" name="id41">Folding</a></li> -<li><a class="reference" href="#column-mode-editing-rectangular-selections" id="id42" name="id42">Column mode editing (rectangular selections)</a></li> -<li><a class="reference" href="#drag-and-drop-of-text" id="id43" name="id43">Drag and drop of text</a></li> -<li><a class="reference" href="#indentation" id="id44" name="id44">Indentation</a><ul> -<li><a class="reference" href="#applying-new-indentation-settings" id="id45" name="id45">Applying new indentation settings</a></li> -<li><a class="reference" href="#detecting-indent-type" id="id46" name="id46">Detecting indent type</a></li> +<li><a class="reference internal" href="#editing" id="id40">Editing</a><ul> +<li><a class="reference internal" href="#folding" id="id41">Folding</a></li> +<li><a class="reference internal" href="#column-mode-editing-rectangular-selections" id="id42">Column mode editing (rectangular selections)</a></li> +<li><a class="reference internal" href="#drag-and-drop-of-text" id="id43">Drag and drop of text</a></li> +<li><a class="reference internal" href="#indentation" id="id44">Indentation</a><ul> +<li><a class="reference internal" href="#applying-new-indentation-settings" id="id45">Applying new indentation settings</a></li> +<li><a class="reference internal" href="#detecting-indent-type" id="id46">Detecting indent type</a></li> </ul> </li> -<li><a class="reference" href="#auto-indentation" id="id47" name="id47">Auto-indentation</a></li> -<li><a class="reference" href="#bookmarks" id="id48" name="id48">Bookmarks</a></li> -<li><a class="reference" href="#code-navigation-history" id="id49" name="id49">Code navigation history</a></li> -<li><a class="reference" href="#sending-text-through-custom-commands" id="id50" name="id50">Sending text through custom commands</a></li> -<li><a class="reference" href="#context-actions" id="id51" name="id51">Context actions</a></li> -<li><a class="reference" href="#autocompletion" id="id52" name="id52">Autocompletion</a><ul> -<li><a class="reference" href="#word-part-completion" id="id53" name="id53">Word part completion</a></li> -<li><a class="reference" href="#scope-autocompletion" id="id54" name="id54">Scope autocompletion</a></li> +<li><a class="reference internal" href="#auto-indentation" id="id47">Auto-indentation</a></li> +<li><a class="reference internal" href="#bookmarks" id="id48">Bookmarks</a></li> +<li><a class="reference internal" href="#code-navigation-history" id="id49">Code navigation history</a></li> +<li><a class="reference internal" href="#sending-text-through-custom-commands" id="id50">Sending text through custom commands</a></li> +<li><a class="reference internal" href="#context-actions" id="id51">Context actions</a></li> +<li><a class="reference internal" href="#autocompletion" id="id52">Autocompletion</a><ul> +<li><a class="reference internal" href="#word-part-completion" id="id53">Word part completion</a></li> +<li><a class="reference internal" href="#scope-autocompletion" id="id54">Scope autocompletion</a></li> </ul> </li> -<li><a class="reference" href="#user-definable-snippets" id="id55" name="id55">User-definable snippets</a><ul> -<li><a class="reference" href="#snippet-keybindings" id="id56" name="id56">Snippet keybindings</a></li> +<li><a class="reference internal" href="#user-definable-snippets" id="id55">User-definable snippets</a><ul> +<li><a class="reference internal" href="#snippet-keybindings" id="id56">Snippet keybindings</a></li> </ul> </li> -<li><a class="reference" href="#inserting-unicode-characters" id="id57" name="id57">Inserting Unicode characters</a></li> +<li><a class="reference internal" href="#inserting-unicode-characters" id="id57">Inserting Unicode characters</a></li> </ul> </li> -<li><a class="reference" href="#search-replace-and-go-to" id="id58" name="id58">Search, replace and go to</a><ul> -<li><a class="reference" href="#toolbar-entries" id="id59" name="id59">Toolbar entries</a><ul> -<li><a class="reference" href="#search-bar" id="id60" name="id60">Search bar</a></li> +<li><a class="reference internal" href="#search-replace-and-go-to" id="id58">Search, replace and go to</a><ul> +<li><a class="reference internal" href="#toolbar-entries" id="id59">Toolbar entries</a><ul> +<li><a class="reference internal" href="#search-bar" id="id60">Search bar</a></li> </ul> </li> -<li><a class="reference" href="#find" id="id61" name="id61">Find</a><ul> -<li><a class="reference" href="#matching-options" id="id62" name="id62">Matching options</a></li> -<li><a class="reference" href="#find-all" id="id63" name="id63">Find all</a></li> -<li><a class="reference" href="#change-font-in-search-dialog-text-fields" id="id64" name="id64">Change font in search dialog text fields</a></li> +<li><a class="reference internal" href="#find" id="id61">Find</a><ul> +<li><a class="reference internal" href="#matching-options" id="id62">Matching options</a></li> +<li><a class="reference internal" href="#find-all" id="id63">Find all</a></li> +<li><a class="reference internal" href="#change-font-in-search-dialog-text-fields" id="id64">Change font in search dialog text fields</a></li> </ul> </li> -<li><a class="reference" href="#find-selection" id="id65" name="id65">Find selection</a></li> -<li><a class="reference" href="#find-usage" id="id66" name="id66">Find usage</a></li> -<li><a class="reference" href="#find-in-files" id="id67" name="id67">Find in files</a><ul> -<li><a class="reference" href="#filtering-out-version-control-files" id="id68" name="id68">Filtering out version control files</a></li> +<li><a class="reference internal" href="#find-selection" id="id65">Find selection</a></li> +<li><a class="reference internal" href="#find-usage" id="id66">Find usage</a></li> +<li><a class="reference internal" href="#find-in-files" id="id67">Find in files</a><ul> +<li><a class="reference internal" href="#filtering-out-version-control-files" id="id68">Filtering out version control files</a></li> </ul> </li> -<li><a class="reference" href="#replace" id="id69" name="id69">Replace</a><ul> -<li><a class="reference" href="#replace-all" id="id70" name="id70">Replace all</a></li> +<li><a class="reference internal" href="#replace" id="id69">Replace</a><ul> +<li><a class="reference internal" href="#replace-all" id="id70">Replace all</a></li> </ul> </li> -<li><a class="reference" href="#go-to-tag-definition" id="id71" name="id71">Go to tag definition</a></li> -<li><a class="reference" href="#go-to-tag-declaration" id="id72" name="id72">Go to tag declaration</a></li> -<li><a class="reference" href="#go-to-line" id="id73" name="id73">Go to line</a></li> -<li><a class="reference" href="#regular-expressions" id="id74" name="id74">Regular expressions</a></li> +<li><a class="reference internal" href="#go-to-tag-definition" id="id71">Go to tag definition</a></li> +<li><a class="reference internal" href="#go-to-tag-declaration" id="id72">Go to tag declaration</a></li> +<li><a class="reference internal" href="#go-to-line" id="id73">Go to line</a></li> +<li><a class="reference internal" href="#regular-expressions" id="id74">Regular expressions</a></li> </ul> </li> -<li><a class="reference" href="#view-menu" id="id75" name="id75">View menu</a><ul> -<li><a class="reference" href="#color-schemes-menu" id="id76" name="id76">Color schemes menu</a></li> +<li><a class="reference internal" href="#view-menu" id="id75">View menu</a><ul> +<li><a class="reference internal" href="#color-schemes-menu" id="id76">Color schemes menu</a></li> </ul> </li> -<li><a class="reference" href="#tags" id="id77" name="id77">Tags</a><ul> -<li><a class="reference" href="#workspace-tags" id="id78" name="id78">Workspace tags</a></li> -<li><a class="reference" href="#global-tags" id="id79" name="id79">Global tags</a><ul> -<li><a class="reference" href="#default-global-tags-files" id="id80" name="id80">Default global tags files</a></li> -<li><a class="reference" href="#global-tags-file-format" id="id81" name="id81">Global tags file format</a></li> -<li><a class="reference" href="#generating-a-global-tags-file" id="id82" name="id82">Generating a global tags file</a></li> +<li><a class="reference internal" href="#tags" id="id77">Tags</a><ul> +<li><a class="reference internal" href="#workspace-tags" id="id78">Workspace tags</a></li> +<li><a class="reference internal" href="#global-tags" id="id79">Global tags</a><ul> +<li><a class="reference internal" href="#default-global-tags-files" id="id80">Default global tags files</a></li> +<li><a class="reference internal" href="#global-tags-file-format" id="id81">Global tags file format</a></li> +<li><a class="reference internal" href="#generating-a-global-tags-file" id="id82">Generating a global tags file</a></li> </ul> </li> -<li><a class="reference" href="#c-ignore-tags" id="id83" name="id83">C ignore.tags</a></li> +<li><a class="reference internal" href="#c-ignore-tags" id="id83">C ignore.tags</a></li> </ul> </li> -<li><a class="reference" href="#preferences" id="id84" name="id84">Preferences</a><ul> -<li><a class="reference" href="#general-startup-preferences" id="id85" name="id85">General Startup preferences</a><ul> -<li><a class="reference" href="#id1" id="id86" name="id86">Startup</a></li> -<li><a class="reference" href="#shutdown" id="id87" name="id87">Shutdown</a></li> -<li><a class="reference" href="#paths" id="id88" name="id88">Paths</a></li> +<li><a class="reference internal" href="#preferences" id="id84">Preferences</a><ul> +<li><a class="reference internal" href="#general-startup-preferences" id="id85">General Startup preferences</a><ul> +<li><a class="reference internal" href="#id1" id="id86">Startup</a></li> +<li><a class="reference internal" href="#shutdown" id="id87">Shutdown</a></li> +<li><a class="reference internal" href="#paths" id="id88">Paths</a></li> </ul> </li> -<li><a class="reference" href="#general-miscellaneous-preferences" id="id89" name="id89">General Miscellaneous preferences</a><ul> -<li><a class="reference" href="#miscellaneous" id="id90" name="id90">Miscellaneous</a></li> -<li><a class="reference" href="#search" id="id91" name="id91">Search</a></li> -<li><a class="reference" href="#projects" id="id92" name="id92">Projects</a></li> +<li><a class="reference internal" href="#general-miscellaneous-preferences" id="id89">General Miscellaneous preferences</a><ul> +<li><a class="reference internal" href="#miscellaneous" id="id90">Miscellaneous</a></li> +<li><a class="reference internal" href="#search" id="id91">Search</a></li> +<li><a class="reference internal" href="#projects" id="id92">Projects</a></li> </ul> </li> -<li><a class="reference" href="#interface-preferences" id="id93" name="id93">Interface preferences</a><ul> -<li><a class="reference" href="#sidebar" id="id94" name="id94">Sidebar</a></li> -<li><a class="reference" href="#fonts" id="id95" name="id95">Fonts</a></li> -<li><a class="reference" href="#id2" id="id96" name="id96">Miscellaneous</a></li> +<li><a class="reference internal" href="#interface-preferences" id="id93">Interface preferences</a><ul> +<li><a class="reference internal" href="#sidebar" id="id94">Sidebar</a></li> +<li><a class="reference internal" href="#fonts" id="id95">Fonts</a></li> +<li><a class="reference internal" href="#id2" id="id96">Miscellaneous</a></li> </ul> </li> -<li><a class="reference" href="#interface-notebook-tab-preferences" id="id97" name="id97">Interface Notebook tab preferences</a><ul> -<li><a class="reference" href="#editor-tabs" id="id98" name="id98">Editor tabs</a></li> -<li><a class="reference" href="#tab-positions" id="id99" name="id99">Tab positions</a></li> +<li><a class="reference internal" href="#interface-notebook-tab-preferences" id="id97">Interface Notebook tab preferences</a><ul> +<li><a class="reference internal" href="#editor-tabs" id="id98">Editor tabs</a></li> +<li><a class="reference internal" href="#tab-positions" id="id99">Tab positions</a></li> </ul> </li> -<li><a class="reference" href="#interface-toolbar-preferences" id="id100" name="id100">Interface Toolbar preferences</a><ul> -<li><a class="reference" href="#toolbar" id="id101" name="id101">Toolbar</a></li> -<li><a class="reference" href="#appearance" id="id102" name="id102">Appearance</a></li> +<li><a class="reference internal" href="#interface-toolbar-preferences" id="id100">Interface Toolbar preferences</a><ul> +<li><a class="reference internal" href="#toolbar" id="id101">Toolbar</a></li> +<li><a class="reference internal" href="#appearance" id="id102">Appearance</a></li> </ul> </li> -<li><a class="reference" href="#editor-features-preferences" id="id103" name="id103">Editor Features preferences</a><ul> -<li><a class="reference" href="#features" id="id104" name="id104">Features</a></li> +<li><a class="reference internal" href="#editor-features-preferences" id="id103">Editor Features preferences</a><ul> +<li><a class="reference internal" href="#features" id="id104">Features</a></li> </ul> </li> -<li><a class="reference" href="#editor-indentation-preferences" id="id105" name="id105">Editor Indentation preferences</a><ul> -<li><a class="reference" href="#indentation-group" id="id106" name="id106">Indentation group</a></li> +<li><a class="reference internal" href="#editor-indentation-preferences" id="id105">Editor Indentation preferences</a><ul> +<li><a class="reference internal" href="#indentation-group" id="id106">Indentation group</a></li> </ul> </li> -<li><a class="reference" href="#editor-completions-preferences" id="id107" name="id107">Editor Completions preferences</a><ul> -<li><a class="reference" href="#completions" id="id108" name="id108">Completions</a></li> -<li><a class="reference" href="#auto-close-quotes-and-brackets" id="id109" name="id109">Auto-close quotes and brackets</a></li> +<li><a class="reference internal" href="#editor-completions-preferences" id="id107">Editor Completions preferences</a><ul> +<li><a class="reference internal" href="#completions" id="id108">Completions</a></li> +<li><a class="reference internal" href="#auto-close-quotes-and-brackets" id="id109">Auto-close quotes and brackets</a></li> </ul> </li> -<li><a class="reference" href="#editor-display-preferences" id="id110" name="id110">Editor Display preferences</a><ul> -<li><a class="reference" href="#display" id="id111" name="id111">Display</a></li> -<li><a class="reference" href="#long-line-marker" id="id112" name="id112">Long line marker</a></li> -<li><a class="reference" href="#virtual-spaces" id="id113" name="id113">Virtual spaces</a></li> +<li><a class="reference internal" href="#editor-display-preferences" id="id110">Editor Display preferences</a><ul> +<li><a class="reference internal" href="#display" id="id111">Display</a></li> +<li><a class="reference internal" href="#long-line-marker" id="id112">Long line marker</a></li> +<li><a class="reference internal" href="#virtual-spaces" id="id113">Virtual spaces</a></li> </ul> </li> -<li><a class="reference" href="#files-preferences" id="id114" name="id114">Files preferences</a><ul> -<li><a class="reference" href="#new-files" id="id115" name="id115">New files</a></li> -<li><a class="reference" href="#saving-files" id="id116" name="id116">Saving files</a></li> -<li><a class="reference" href="#id3" id="id117" name="id117">Miscellaneous</a></li> +<li><a class="reference internal" href="#files-preferences" id="id114">Files preferences</a><ul> +<li><a class="reference internal" href="#new-files" id="id115">New files</a></li> +<li><a class="reference internal" href="#saving-files" id="id116">Saving files</a></li> +<li><a class="reference internal" href="#id3" id="id117">Miscellaneous</a></li> </ul> </li> -<li><a class="reference" href="#tools-preferences" id="id118" name="id118">Tools preferences</a><ul> -<li><a class="reference" href="#tool-paths" id="id119" name="id119">Tool paths</a></li> -<li><a class="reference" href="#commands" id="id120" name="id120">Commands</a></li> +<li><a class="reference internal" href="#tools-preferences" id="id118">Tools preferences</a><ul> +<li><a class="reference internal" href="#tool-paths" id="id119">Tool paths</a></li> +<li><a class="reference internal" href="#commands" id="id120">Commands</a></li> </ul> </li> -<li><a class="reference" href="#template-preferences" id="id121" name="id121">Template preferences</a><ul> -<li><a class="reference" href="#template-data" id="id122" name="id122">Template data</a></li> +<li><a class="reference internal" href="#template-preferences" id="id121">Template preferences</a><ul> +<li><a class="reference internal" href="#template-data" id="id122">Template data</a></li> </ul> </li> -<li><a class="reference" href="#keybinding-preferences" id="id123" name="id123">Keybinding preferences</a></li> -<li><a class="reference" href="#printing-preferences" id="id124" name="id124">Printing preferences</a></li> -<li><a class="reference" href="#terminal-vte-preferences" id="id125" name="id125">Terminal (VTE) preferences</a><ul> -<li><a class="reference" href="#terminal-widget" id="id126" name="id126">Terminal widget</a></li> +<li><a class="reference internal" href="#keybinding-preferences" id="id123">Keybinding preferences</a></li> +<li><a class="reference internal" href="#printing-preferences" id="id124">Printing preferences</a></li> +<li><a class="reference internal" href="#terminal-vte-preferences" id="id125">Terminal (VTE) preferences</a><ul> +<li><a class="reference internal" href="#terminal-widget" id="id126">Terminal widget</a></li> </ul> </li> </ul> </li> -<li><a class="reference" href="#project-management" id="id127" name="id127">Project management</a><ul> -<li><a class="reference" href="#new-project" id="id128" name="id128">New project</a></li> -<li><a class="reference" href="#project-properties" id="id129" name="id129">Project properties</a></li> -<li><a class="reference" href="#open-project" id="id130" name="id130">Open project</a></li> -<li><a class="reference" href="#close-project" id="id131" name="id131">Close project</a></li> +<li><a class="reference internal" href="#project-management" id="id127">Project management</a><ul> +<li><a class="reference internal" href="#new-project" id="id128">New project</a></li> +<li><a class="reference internal" href="#project-properties" id="id129">Project properties</a></li> +<li><a class="reference internal" href="#open-project" id="id130">Open project</a></li> +<li><a class="reference internal" href="#close-project" id="id131">Close project</a></li> </ul> </li> -<li><a class="reference" href="#build-menu" id="id132" name="id132">Build menu</a><ul> -<li><a class="reference" href="#indicators" id="id133" name="id133">Indicators</a></li> -<li><a class="reference" href="#default-build-menu-items" id="id134" name="id134">Default build menu items</a><ul> -<li><a class="reference" href="#compile" id="id135" name="id135">Compile</a></li> -<li><a class="reference" href="#build" id="id136" name="id136">Build</a></li> -<li><a class="reference" href="#make" id="id137" name="id137">Make</a></li> -<li><a class="reference" href="#make-custom-target" id="id138" name="id138">Make custom target</a></li> -<li><a class="reference" href="#make-object" id="id139" name="id139">Make object</a></li> -<li><a class="reference" href="#next-error" id="id140" name="id140">Next error</a></li> -<li><a class="reference" href="#previous-error" id="id141" name="id141">Previous error</a></li> -<li><a class="reference" href="#execute" id="id142" name="id142">Execute</a></li> -<li><a class="reference" href="#stopping-running-processes" id="id143" name="id143">Stopping running processes</a><ul> -<li><a class="reference" href="#terminal-emulators" id="id144" name="id144">Terminal emulators</a></li> +<li><a class="reference internal" href="#build-menu" id="id132">Build menu</a><ul> +<li><a class="reference internal" href="#indicators" id="id133">Indicators</a></li> +<li><a class="reference internal" href="#default-build-menu-items" id="id134">Default build menu items</a><ul> +<li><a class="reference internal" href="#compile" id="id135">Compile</a></li> +<li><a class="reference internal" href="#build" id="id136">Build</a></li> +<li><a class="reference internal" href="#make" id="id137">Make</a></li> +<li><a class="reference internal" href="#make-custom-target" id="id138">Make custom target</a></li> +<li><a class="reference internal" href="#make-object" id="id139">Make object</a></li> +<li><a class="reference internal" href="#next-error" id="id140">Next error</a></li> +<li><a class="reference internal" href="#previous-error" id="id141">Previous error</a></li> +<li><a class="reference internal" href="#execute" id="id142">Execute</a></li> +<li><a class="reference internal" href="#stopping-running-processes" id="id143">Stopping running processes</a><ul> +<li><a class="reference internal" href="#terminal-emulators" id="id144">Terminal emulators</a></li> </ul> </li> -<li><a class="reference" href="#set-build-commands" id="id145" name="id145">Set build commands</a></li> +<li><a class="reference internal" href="#set-build-commands" id="id145">Set build commands</a></li> </ul> </li> -<li><a class="reference" href="#build-menu-configuration" id="id146" name="id146">Build menu configuration</a></li> -<li><a class="reference" href="#build-menu-commands-dialog" id="id147" name="id147">Build menu commands dialog</a><ul> -<li><a class="reference" href="#substitutions-in-commands-and-working-directories" id="id148" name="id148">Substitutions in commands and working directories</a></li> -<li><a class="reference" href="#build-menu-keyboard-shortcuts" id="id149" name="id149">Build menu keyboard shortcuts</a></li> -<li><a class="reference" href="#old-settings" id="id150" name="id150">Old settings</a></li> +<li><a class="reference internal" href="#build-menu-configuration" id="id146">Build menu configuration</a></li> +<li><a class="reference internal" href="#build-menu-commands-dialog" id="id147">Build menu commands dialog</a><ul> +<li><a class="reference internal" href="#substitutions-in-commands-and-working-directories" id="id148">Substitutions in commands and working directories</a></li> +<li><a class="reference internal" href="#build-menu-keyboard-shortcuts" id="id149">Build menu keyboard shortcuts</a></li> +<li><a class="reference internal" href="#old-settings" id="id150">Old settings</a></li> </ul> </li> </ul> </li> -<li><a class="reference" href="#printing-support" id="id151" name="id151">Printing support</a></li> -<li><a class="reference" href="#plugins" id="id152" name="id152">Plugins</a><ul> -<li><a class="reference" href="#plugin-manager" id="id153" name="id153">Plugin manager</a></li> +<li><a class="reference internal" href="#printing-support" id="id151">Printing support</a></li> +<li><a class="reference internal" href="#plugins" id="id152">Plugins</a><ul> +<li><a class="reference internal" href="#plugin-manager" id="id153">Plugin manager</a></li> </ul> </li> -<li><a class="reference" href="#keybindings" id="id154" name="id154">Keybindings</a><ul> -<li><a class="reference" href="#switching-documents" id="id155" name="id155">Switching documents</a></li> -<li><a class="reference" href="#configurable-keybindings" id="id156" name="id156">Configurable keybindings</a><ul> -<li><a class="reference" href="#file-keybindings" id="id157" name="id157">File keybindings</a></li> -<li><a class="reference" href="#editor-keybindings" id="id158" name="id158">Editor keybindings</a></li> -<li><a class="reference" href="#clipboard-keybindings" id="id159" name="id159">Clipboard keybindings</a></li> -<li><a class="reference" href="#select-keybindings" id="id160" name="id160">Select keybindings</a></li> -<li><a class="reference" href="#insert-keybindings" id="id161" name="id161">Insert keybindings</a></li> -<li><a class="reference" href="#format-keybindings" id="id162" name="id162">Format keybindings</a></li> -<li><a class="reference" href="#settings-keybindings" id="id163" name="id163">Settings keybindings</a></li> -<li><a class="reference" href="#search-keybindings" id="id164" name="id164">Search keybindings</a></li> -<li><a class="reference" href="#go-to-keybindings" id="id165" name="id165">Go to keybindings</a></li> -<li><a class="reference" href="#view-keybindings" id="id166" name="id166">View keybindings</a></li> -<li><a class="reference" href="#focus-keybindings" id="id167" name="id167">Focus keybindings</a></li> -<li><a class="reference" href="#notebook-tab-keybindings" id="id168" name="id168">Notebook tab keybindings</a></li> -<li><a class="reference" href="#document-keybindings" id="id169" name="id169">Document keybindings</a></li> -<li><a class="reference" href="#build-keybindings" id="id170" name="id170">Build keybindings</a></li> -<li><a class="reference" href="#tools-keybindings" id="id171" name="id171">Tools keybindings</a></li> -<li><a class="reference" href="#help-keybindings" id="id172" name="id172">Help keybindings</a></li> +<li><a class="reference internal" href="#keybindings" id="id154">Keybindings</a><ul> +<li><a class="reference internal" href="#switching-documents" id="id155">Switching documents</a></li> +<li><a class="reference internal" href="#configurable-keybindings" id="id156">Configurable keybindings</a><ul> +<li><a class="reference internal" href="#file-keybindings" id="id157">File keybindings</a></li> +<li><a class="reference internal" href="#editor-keybindings" id="id158">Editor keybindings</a></li> +<li><a class="reference internal" href="#clipboard-keybindings" id="id159">Clipboard keybindings</a></li> +<li><a class="reference internal" href="#select-keybindings" id="id160">Select keybindings</a></li> +<li><a class="reference internal" href="#insert-keybindings" id="id161">Insert keybindings</a></li> +<li><a class="reference internal" href="#format-keybindings" id="id162">Format keybindings</a></li> +<li><a class="reference internal" href="#settings-keybindings" id="id163">Settings keybindings</a></li> +<li><a class="reference internal" href="#search-keybindings" id="id164">Search keybindings</a></li> +<li><a class="reference internal" href="#go-to-keybindings" id="id165">Go to keybindings</a></li> +<li><a class="reference internal" href="#view-keybindings" id="id166">View keybindings</a></li> +<li><a class="reference internal" href="#focus-keybindings" id="id167">Focus keybindings</a></li> +<li><a class="reference internal" href="#notebook-tab-keybindings" id="id168">Notebook tab keybindings</a></li> +<li><a class="reference internal" href="#document-keybindings" id="id169">Document keybindings</a></li> +<li><a class="reference internal" href="#build-keybindings" id="id170">Build keybindings</a></li> +<li><a class="reference internal" href="#tools-keybindings" id="id171">Tools keybindings</a></li> +<li><a class="reference internal" href="#help-keybindings" id="id172">Help keybindings</a></li> </ul> </li> </ul> </li> </ul> </li> -<li><a class="reference" href="#configuration-files" id="id173" name="id173">Configuration files</a><ul> -<li><a class="reference" href="#configuration-file-paths" id="id174" name="id174">Configuration file paths</a><ul> -<li><a class="reference" href="#paths-on-unix-like-systems" id="id175" name="id175">Paths on Unix-like systems</a></li> +<li><a class="reference internal" href="#configuration-files" id="id173">Configuration files</a><ul> +<li><a class="reference internal" href="#configuration-file-paths" id="id174">Configuration file paths</a><ul> +<li><a class="reference internal" href="#paths-on-unix-like-systems" id="id175">Paths on Unix-like systems</a></li> </ul> </li> -<li><a class="reference" href="#tools-menu-items" id="id176" name="id176">Tools menu items</a></li> -<li><a class="reference" href="#global-configuration-file" id="id177" name="id177">Global configuration file</a></li> -<li><a class="reference" href="#filetype-definition-files" id="id178" name="id178">Filetype definition files</a><ul> -<li><a class="reference" href="#filenames" id="id179" name="id179">Filenames</a></li> -<li><a class="reference" href="#system-files" id="id180" name="id180">System files</a></li> -<li><a class="reference" href="#user-files" id="id181" name="id181">User files</a></li> -<li><a class="reference" href="#custom-filetypes" id="id182" name="id182">Custom filetypes</a><ul> -<li><a class="reference" href="#creating-a-custom-filetype-from-an-existing-filetype" id="id183" name="id183">Creating a custom filetype from an existing filetype</a></li> +<li><a class="reference internal" href="#tools-menu-items" id="id176">Tools menu items</a></li> +<li><a class="reference internal" href="#global-configuration-file" id="id177">Global configuration file</a></li> +<li><a class="reference internal" href="#filetype-definition-files" id="id178">Filetype definition files</a><ul> +<li><a class="reference internal" href="#filenames" id="id179">Filenames</a></li> +<li><a class="reference internal" href="#system-files" id="id180">System files</a></li> +<li><a class="reference internal" href="#user-files" id="id181">User files</a></li> +<li><a class="reference internal" href="#custom-filetypes" id="id182">Custom filetypes</a><ul> +<li><a class="reference internal" href="#creating-a-custom-filetype-from-an-existing-filetype" id="id183">Creating a custom filetype from an existing filetype</a></li> </ul> </li> -<li><a class="reference" href="#filetype-configuration" id="id184" name="id184">Filetype configuration</a><ul> -<li><a class="reference" href="#styling-section" id="id185" name="id185">[styling] section</a><ul> -<li><a class="reference" href="#using-a-named-style" id="id186" name="id186">Using a named style</a></li> -<li><a class="reference" href="#reading-styles-from-another-filetype" id="id187" name="id187">Reading styles from another filetype</a></li> +<li><a class="reference internal" href="#filetype-configuration" id="id184">Filetype configuration</a><ul> +<li><a class="reference internal" href="#styling-section" id="id185">[styling] section</a><ul> +<li><a class="reference internal" href="#using-a-named-style" id="id186">Using a named style</a></li> +<li><a class="reference internal" href="#reading-styles-from-another-filetype" id="id187">Reading styles from another filetype</a></li> </ul> </li> -<li><a class="reference" href="#keywords-section" id="id188" name="id188">[keywords] section</a></li> -<li><a class="reference" href="#lexer-properties-section" id="id189" name="id189">[lexer_properties] section</a></li> -<li><a class="reference" href="#settings-section" id="id190" name="id190">[settings] section</a></li> -<li><a class="reference" href="#build-settings-section" id="id191" name="id191">[build_settings] section</a></li> +<li><a class="reference internal" href="#keywords-section" id="id188">[keywords] section</a></li> +<li><a class="reference internal" href="#lexer-properties-section" id="id189">[lexer_properties] section</a></li> +<li><a class="reference internal" href="#settings-section" id="id190">[settings] section</a></li> +<li><a class="reference internal" href="#build-settings-section" id="id191">[build_settings] section</a></li> </ul> </li> -<li><a class="reference" href="#special-file-filetypes-common" id="id192" name="id192">Special file filetypes.common</a><ul> -<li><a class="reference" href="#named-styles-section" id="id193" name="id193">[named_styles] section</a></li> -<li><a class="reference" href="#id4" id="id194" name="id194">[styling] section</a></li> -<li><a class="reference" href="#id5" id="id195" name="id195">[settings] section</a></li> +<li><a class="reference internal" href="#special-file-filetypes-common" id="id192">Special file filetypes.common</a><ul> +<li><a class="reference internal" href="#named-styles-section" id="id193">[named_styles] section</a></li> +<li><a class="reference internal" href="#id4" id="id194">[styling] section</a></li> +<li><a class="reference internal" href="#id5" id="id195">[settings] section</a></li> </ul> </li> </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 internal" href="#filetype-extensions" id="id196">Filetype extensions</a></li> +<li><a class="reference internal" href="#filetype-group-membership" id="id197">Filetype group membership</a></li> +<li><a class="reference internal" href="#preferences-file-format" id="id198">Preferences file format</a><ul> +<li><a class="reference internal" href="#hidden-preferences" id="id199">Hidden preferences</a></li> +<li><a class="reference internal" href="#build-menu-section" id="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 internal" href="#project-file-format" id="id201">Project file format</a><ul> +<li><a class="reference internal" href="#build-menu-additions" id="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 internal" href="#templates" id="id203">Templates</a><ul> +<li><a class="reference internal" href="#template-meta-data" id="id204">Template meta data</a></li> +<li><a class="reference internal" href="#file-templates" id="id205">File templates</a><ul> +<li><a class="reference internal" href="#adding-file-templates" id="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 internal" href="#customizing-templates" id="id207">Customizing templates</a><ul> +<li><a class="reference internal" href="#template-wildcards" id="id208">Template wildcards</a><ul> +<li><a class="reference internal" href="#special-command-wildcard" id="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 internal" href="#customizing-the-toolbar" id="id210">Customizing the toolbar</a><ul> +<li><a class="reference internal" href="#manually-editing-the-toolbar-layout" id="id211">Manually editing the toolbar layout</a></li> +<li><a class="reference internal" href="#available-toolbar-elements" id="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 internal" href="#plugin-documentation" id="id213">Plugin documentation</a><ul> +<li><a class="reference internal" href="#html-characters" id="id214">HTML Characters</a><ul> +<li><a class="reference internal" href="#insert-entity-dialog" id="id215">Insert entity dialog</a></li> +<li><a class="reference internal" href="#replace-special-chars-by-its-entity" id="id216">Replace special chars by its entity</a><ul> +<li><a class="reference internal" href="#at-typing-time" id="id217">At typing time</a></li> +<li><a class="reference internal" href="#bulk-replacement" id="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 internal" href="#save-actions" id="id219">Save Actions</a><ul> +<li><a class="reference internal" href="#instant-save" id="id220">Instant Save</a></li> +<li><a class="reference internal" href="#backup-copy" id="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 internal" href="#contributing-to-this-document" id="id222">Contributing to this document</a></li> +<li><a class="reference internal" href="#scintilla-keyboard-commands" id="id223">Scintilla keyboard commands</a><ul> +<li><a class="reference internal" href="#keyboard-commands" id="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 internal" href="#tips-and-tricks" id="id225">Tips and tricks</a><ul> +<li><a class="reference internal" href="#document-notebook" id="id226">Document notebook</a></li> +<li><a class="reference internal" href="#editor" id="id227">Editor</a></li> +<li><a class="reference internal" href="#interface" id="id228">Interface</a></li> +<li><a class="reference internal" href="#gtk-related" id="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 internal" href="#compile-time-options" id="id230">Compile-time options</a><ul> +<li><a class="reference internal" href="#src-geany-h" id="id231">src/geany.h</a></li> +<li><a class="reference internal" href="#project-h" id="id232">project.h</a></li> +<li><a class="reference internal" href="#editor-h" id="id233">editor.h</a></li> +<li><a class="reference internal" href="#keyfile-c" id="id234">keyfile.c</a></li> +<li><a class="reference internal" href="#build-c" id="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 internal" href="#gnu-general-public-license" id="id236">GNU General Public License</a></li> +<li><a class="reference internal" href="#license-for-scintilla-and-scite" id="id237">License for Scintilla and SciTE</a></li> </ul> </div> -<div class="section"> -<h1><a class="toc-backref" href="#id7" id="introduction" name="introduction">Introduction</a></h1> -<div class="section"> -<h2><a class="toc-backref" href="#id8" id="about-geany" name="about-geany">About Geany</a></h2> +<div class="section" id="introduction"> +<h1><a class="toc-backref" href="#id7">Introduction</a></h1> +<div class="section" id="about-geany"> +<h2><a class="toc-backref" href="#id8">About Geany</a></h2> <p>Geany is a small and lightweight Integrated Development Environment. It was developed to provide a small and fast IDE, which has only a few dependencies on other packages. Another goal was to be as independent @@ -539,56 +540,56 @@ <li>Plugin interface</li> </ul> </div> -<div class="section"> -<h2><a class="toc-backref" href="#id9" id="where-to-get-it" name="where-to-get-it">Where to get it</a></h2> -<p>You can obtain Geany from <a class="reference" href="http://www.geany.org/">http://www.geany.org/</a> or perhaps also from +<div class="section" id="where-to-get-it"> +<h2><a class="toc-backref" href="#id9">Where to get it</a></h2> +<p>You can obtain Geany from <a class="reference external" href="http://www.geany.org/">http://www.geany.org/</a> or perhaps also from your distribution. For a list of available packages, please see -<a class="reference" href="http://www.geany.org/Download/ThirdPartyPackages">http://www.geany.org/Download/ThirdPartyPackages</a>.</p> +<a class="reference external" href="http://www.geany.org/Download/ThirdPartyPackages">http://www.geany.org/Download/ThirdPartyPackages</a>.</p> </div> -<div class="section"> -<h2><a class="toc-backref" href="#id10" id="license" name="license">License</a></h2> +<div class="section" id="license"> +<h2><a class="toc-backref" href="#id10">License</a></h2> <p>Geany is distributed under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. A copy of this license can be found in the file COPYING included with the source -code of this program and in the chapter, <a class="reference" href="#gnu-general-public-license">GNU General Public License</a>.</p> +code of this program and in the chapter, <a class="reference internal" href="#gnu-general-public-license">GNU General Public License</a>.</p> <p>The included Scintilla library (found in the subdirectory -<tt class="docutils literal"><span class="pre">scintilla/</span></tt>) has its own license, which can be found in the chapter, -<a class="reference" href="#license-for-scintilla-and-scite">License for Scintilla and SciTE</a>.</p> +<tt class="docutils literal">scintilla/</tt>) has its own license, which can be found in the chapter, +<a class="reference internal" href="#license-for-scintilla-and-scite">License for Scintilla and SciTE</a>.</p> </div> -<div class="section"> -<h2><a class="toc-backref" href="#id11" id="about-this-document" name="about-this-document">About this document</a></h2> +<div class="section" id="about-this-document"> +<h2><a class="toc-backref" href="#id11">About this document</a></h2> <p>This documentation is available in HTML and text formats. -The latest version can always be found at <a class="reference" href="http://www.geany.org/">http://www.geany.org/</a>.</p> -<p>If you want to contribute to it, see <a class="reference" href="#contributing-to-this-document">Contributing to this document</a>.</p> +The latest version can always be found at <a class="reference external" href="http://www.geany.org/">http://www.geany.org/</a>.</p> +<p>If you want to contribute to it, see <a class="reference internal" href="#contributing-to-this-document">Contributing to this document</a>.</p> </div> </div> -<div class="section"> -<h1><a class="toc-backref" href="#id12" id="installation" name="installation">Installation</a></h1> -<div class="section"> -<h2><a class="toc-backref" href="#id13" id="requirements" name="requirements">Requirements</a></h2> +<div class="section" id="installation"> +<h1><a class="toc-backref" href="#id12">Installation</a></h1> +<div class="section" id="requirements"> +<h2><a class="toc-backref" href="#id13">Requirements</a></h2> <p>You will need the GTK (&gt;= 2.8.0) libraries and their dependencies (Pango, GLib and ATK). Your distro should provide packages for these, usually installed by default. For Windows, you can download an installer from the website which bundles these libraries.</p> </div> -<div class="section"> -<h2><a class="toc-backref" href="#id14" id="binary-packages" name="binary-packages">Binary packages</a></h2> +<div class="section" id="binary-packages"> +<h2><a class="toc-backref" href="#id14">Binary packages</a></h2> <p>There are many binary packages available. For an up-to-date but maybe -incomplete list see <a class="reference" href="http://www.geany.org/Download/ThirdPartyPackages">http://www.geany.org/Download/ThirdPartyPackages</a>.</p> +incomplete list see <a class="reference external" href="http://www.geany.org/Download/ThirdPartyPackages">http://www.geany.org/Download/ThirdPartyPackages</a>.</p> </div> -<div class="section"> -<h2><a class="toc-backref" href="#id15" id="source-compilation" name="source-compilation">Source compilation</a></h2> +<div class="section" id="source-compilation"> +<h2><a class="toc-backref" href="#id15">Source compilation</a></h2> <p>Compiling Geany is quite easy. To do so, you need the GTK (&gt;= 2.8.0) libraries and header files. You also need the Pango, GLib and ATK libraries and header files. -All these files are available at <a class="reference" href="http://www.gtk.org">http://www.gtk.org</a>, but very often +All these files are available at <a class="reference external" href="http://www.gtk.org">http://www.gtk.org</a>, but very often your distro will provide development packages to save the trouble of building these yourself.</p> <p>Furthermore you need, of course, a C and C++ compiler. The GNU versions of these tools are recommended.</p> -<div class="section"> -<h3><a class="toc-backref" href="#id16" id="autotools-based-build-system" name="autotools-based-build-system">Autotools based build system</a></h3> +<div class="section" id="autotools-based-build-system"> +<h3><a class="toc-backref" href="#id16">Autotools based build system</a></h3> <p>The Autotools based build system is very mature and has been well tested. To use it, you just need the Make tool, preferably GNU Make.</p> <p>Then run the following commands:</p> @@ -601,8 +602,8 @@ % make install </pre> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id17" id="waf-based-build-system" name="waf-based-build-system">Waf based build system</a></h3> +<div class="section" id="waf-based-build-system"> +<h3><a class="toc-backref" href="#id17">Waf based build system</a></h3> <p>The Waf build system is still quite young and under heavy development but already in a usable state. In contrast to the Autotools system, Waf needs Python. So before using Waf, you need to install Python on your system. @@ -610,7 +611,7 @@ build process might be a bit faster. Especially when you use the Waf cache feature for repetitive builds (e.g. when changing only a few source files to test something) will become much faster since Waf will cache and re-use the -unchanged built files and only compile the changed code again. See <a class="reference" href="#waf-cache">Waf Cache</a> for details. +unchanged built files and only compile the changed code again. See <a class="reference internal" href="#waf-cache">Waf Cache</a> for details. To build Geany with Waf as run:</p> <pre class="literal-block"> $ ./waf configure @@ -620,13 +621,13 @@ <pre class="literal-block"> % ./waf install </pre> -<div class="section"> -<h4><a class="toc-backref" href="#id18" id="waf-cache" name="waf-cache">Waf cache</a></h4> +<div class="section" id="waf-cache"> +<h4><a class="toc-backref" href="#id18">Waf cache</a></h4> <p>The Waf build system has a nice and interesting feature which can help to avoid a lot of unnecessary rebuilding of unchanged code. This often happens when developing new features or trying to debug something in Geany. Waf is able to store and retrieve the object files from a cache. This cache is declared -using the environment variable <tt class="docutils literal"><span class="pre">WAFCACHE</span></tt>. +using the environment variable <tt class="docutils literal">WAFCACHE</tt>. A possible location of the cache directory could be <tt class="docutils literal"><span class="pre">~/.cache/waf</span></tt>. In order to make use of this, you first need to create this directory:</p> <pre class="literal-block"> @@ -637,11 +638,11 @@ <pre class="literal-block"> export WAFCACHE=/home/username/.cache/waf </pre> -<p>Remember to replace <tt class="docutils literal"><span class="pre">username</span></tt> with your actual username.</p> +<p>Remember to replace <tt class="docutils literal">username</tt> with your actual username.</p> <p>More information about the Waf cache feature are available at -<a class="reference" href="http://code.google.com/p/waf/wiki/CacheObjectFiles">http://code.google.com/p/waf/wiki/CacheObjectFiles</a>.</p> -<div class="section"> -<h5><a class="toc-backref" href="#id19" id="cleaning-the-cache" name="cleaning-the-cache">Cleaning the cache</a></h5> +<a class="reference external" href="http://code.google.com/p/waf/wiki/CacheObjectFiles">http://code.google.com/p/waf/wiki/CacheObjectFiles</a>.</p> +<div class="section" id="cleaning-the-cache"> +<h5><a class="toc-backref" href="#id19">Cleaning the cache</a></h5> <p>You should be careful about the size of the cache directory as it may grow rapidly over time. Waf doesn't do any cleaning or other house-keeping of the cache yet, so you need to keep it @@ -652,12 +653,12 @@ $ find /home/username/.cache/waf -mtime +14 -exec rm {} ; </pre> <p>This will delete all files in the cache directory which are older than 14 days.</p> -<p>For details about the <tt class="docutils literal"><span class="pre">find</span></tt> command and its options, check its manual page.</p> +<p>For details about the <tt class="docutils literal">find</tt> command and its options, check its manual page.</p> </div> </div> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id20" id="custom-installation" name="custom-installation">Custom installation</a></h3> +<div class="section" id="custom-installation"> +<h3><a class="toc-backref" href="#id20">Custom installation</a></h3> <p>The configure script supports several common options, for a detailed list, type:</p> <pre class="literal-block"> @@ -671,44 +672,44 @@ <p>You may also want to read the INSTALL file for advanced installation options.</p> <ul class="simple"> -<li>See also <a class="reference" href="#compile-time-options">Compile-time options</a>.</li> +<li>See also <a class="reference internal" href="#compile-time-options">Compile-time options</a>.</li> </ul> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id21" id="dynamic-linking-loader-support-and-vte" name="dynamic-linking-loader-support-and-vte">Dynamic linking loader support and VTE</a></h3> +<div class="section" id="dynamic-linking-loader-support-and-vte"> +<h3><a class="toc-backref" href="#id21">Dynamic linking loader support and VTE</a></h3> <p>In the case that your system lacks dynamic linking loader support, you -probably want to pass the option <tt class="docutils literal"><span class="pre">--disable-vte</span></tt> to the <tt class="docutils literal"><span class="pre">configure</span></tt> +probably want to pass the option <tt class="docutils literal"><span class="pre">--disable-vte</span></tt> to the <tt class="docutils literal">configure</tt> script. This prevents compiling Geany with dynamic linking loader -support for automatically loading <tt class="docutils literal"><span class="pre">libvte.so.4</span></tt> if available.</p> +support for automatically loading <tt class="docutils literal">libvte.so.4</tt> if available.</p> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id22" id="build-problems" name="build-problems">Build problems</a></h3> +<div class="section" id="build-problems"> +<h3><a class="toc-backref" href="#id22">Build problems</a></h3> <p>If there are any errors during compilation, check your build environment and try to find the error, otherwise contact the mailing list or one the authors. Sometimes you might need to ask for specific help from your distribution.</p> </div> </div> -<div class="section"> -<h2><a class="toc-backref" href="#id23" id="installation-prefix" name="installation-prefix">Installation prefix</a></h2> +<div class="section" id="installation-prefix"> +<h2><a class="toc-backref" href="#id23">Installation prefix</a></h2> <p>If you want to find Geany's system files after installation you may want to know the installation prefix.</p> <p>Pass the <tt class="docutils literal"><span class="pre">--print-prefix</span></tt> option to Geany to check this - see -<a class="reference" href="#command-line-options">Command line options</a>. The first path is the prefix.</p> -<p>On Unix-like systems this is commonly <tt class="docutils literal"><span class="pre">/usr</span></tt> if you installed from -a binary package, or <tt class="docutils literal"><span class="pre">/usr/local</span></tt> if you build from source.</p> +<a class="reference internal" href="#command-line-options">Command line options</a>. The first path is the prefix.</p> +<p>On Unix-like systems this is commonly <tt class="docutils literal">/usr</tt> if you installed from +a binary package, or <tt class="docutils literal">/usr/local</tt> if you build from source.</p> <div class="note"> <p class="first admonition-title">Note</p> <p class="last">Editing system files is not necessary as you can use the per-user configuration files instead, which don't need root -permissions. See <a class="reference" href="#configuration-files">Configuration files</a>.</p> +permissions. See <a class="reference internal" href="#configuration-files">Configuration files</a>.</p> </div> </div> </div> -<div class="section"> -<h1><a class="toc-backref" href="#id24" id="usage" name="usage">Usage</a></h1> -<div class="section"> -<h2><a class="toc-backref" href="#id25" id="getting-started" name="getting-started">Getting started</a></h2> +<div class="section" id="usage"> +<h1><a class="toc-backref" href="#id24">Usage</a></h1> +<div class="section" id="getting-started"> +<h2><a class="toc-backref" href="#id25">Getting started</a></h2> <p>You can start Geany in the following ways:</p> <ul> <li><p class="first">From the Desktop Environment menu:</p> @@ -724,8 +725,8 @@ </li> </ul> </div> -<div class="section"> -<h2><a class="toc-backref" href="#id26" id="the-geany-workspace" name="the-geany-workspace">The Geany workspace</a></h2> +<div class="section" id="the-geany-workspace"> +<h2><a class="toc-backref" href="#id26">The Geany workspace</a></h2> <p>The Geany window is shown in the following figure:</p> <img alt="./images/main_window.png" src="./images/main_window.png" /> <p>The workspace has the following parts:</p> @@ -748,15 +749,15 @@ </li> <li>A status bar</li> </ul> -<p>Most of these can be configured in the <a class="reference" href="#interface-preferences">Interface preferences</a>, the -<a class="reference" href="#view-menu">View menu</a>, or the popup menu for the relevant area.</p> +<p>Most of these can be configured in the <a class="reference internal" href="#interface-preferences">Interface preferences</a>, the +<a class="reference internal" href="#view-menu">View menu</a>, or the popup menu for the relevant area.</p> <p>Additional tabs may be added to the sidebar and message window by plugins.</p> <p>The position of the tabs can be selected in the interface preferences.</p> <p>The sizes of the sidebar and message window can be adjusted by dragging the dividers.</p> </div> -<div class="section"> -<h2><a class="toc-backref" href="#id27" id="command-line-options" name="command-line-options">Command line options</a></h2> +<div class="section" id="command-line-options"> +<h2><a class="toc-backref" href="#id27">Command line options</a></h2> <table border="1" class="docutils"> <colgroup> <col width="9%" /> @@ -785,7 +786,7 @@ <td>--config=directory_name</td> <td>Use an alternate configuration directory. The default configuration directory is <tt class="docutils literal"><span class="pre">~/.config/geany/</span></tt> and that -is where <tt class="docutils literal"><span class="pre">geany.conf</span></tt> and other configuration files +is where <tt class="docutils literal">geany.conf</tt> and other configuration files reside.</td> </tr> <tr><td><em>none</em></td> @@ -796,7 +797,7 @@ <tr><td>-g</td> <td>--generate-tags</td> <td>Generate a global tags file (see -<a class="reference" href="#generating-a-global-tags-file">Generating a global tags file</a>).</td> +<a class="reference internal" href="#generating-a-global-tags-file">Generating a global tags file</a>).</td> </tr> <tr><td>-P</td> <td>--no-preprocessing</td> @@ -852,7 +853,7 @@ <td>--no-terminal</td> <td>Do not load terminal support. Use this option if you do not want to load the virtual terminal emulator widget -at startup. If you do not have <tt class="docutils literal"><span class="pre">libvte.so.4</span></tt> installed, +at startup. If you do not have <tt class="docutils literal">libvte.so.4</tt> installed, then terminal-support is automatically disabled. Only available if Geany was compiled with support for VTE.</td> </tr> @@ -870,7 +871,7 @@ <td>--vte-lib</td> <td>Specify explicitly the path including filename or only the filename to the VTE library, e.g. -<tt class="docutils literal"><span class="pre">/usr/lib/libvte.so</span></tt> or <tt class="docutils literal"><span class="pre">libvte.so</span></tt>. This option is +<tt class="docutils literal">/usr/lib/libvte.so</tt> or <tt class="docutils literal">libvte.so</tt>. This option is only needed when the auto-detection does not work. Only available if Geany was compiled with support for VTE.</td> </tr> @@ -909,13 +910,13 @@ <p>Geany supports all generic GTK options, a list is available on the help screen.</p> </div> -<div class="section"> -<h2><a class="toc-backref" href="#id28" id="general" name="general">General</a></h2> -<div class="section"> -<h3><a class="toc-backref" href="#id29" id="startup" name="startup">Startup</a></h3> +<div class="section" id="general"> +<h2><a class="toc-backref" href="#id28">General</a></h2> +<div class="section" id="startup"> +<h3><a class="toc-backref" href="#id29">Startup</a></h3> <p>At startup, Geany loads all files from the last time Geany was launched. You can disable this feature in the preferences dialog -(see <a class="reference" href="#general-startup-preferences">General Startup preferences</a>). If you specify some +(see <a class="reference internal" href="#general-startup-preferences">General Startup preferences</a>). If you specify some files on the command line, only these files will be opened, but you can find the files from the last session in the file menu under the &quot;Recent files&quot; item. By default this contains the last 10 recently @@ -926,8 +927,8 @@ do not specify any filenames on the command-line, or disable opening files in a running instance using the appropriate command line option.</p> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id30" id="opening-files-from-the-command-line-in-a-running-instance" name="opening-files-from-the-command-line-in-a-running-instance">Opening files from the command-line in a running instance</a></h3> +<div class="section" id="opening-files-from-the-command-line-in-a-running-instance"> +<h3><a class="toc-backref" href="#id30">Opening files from the command-line in a running instance</a></h3> <p>Geany detects if there is an an instance of itself already running and opens files from the command-line in that instance. So, Geany can be used to view and edit files by opening them from other programs @@ -936,22 +937,22 @@ <pre class="literal-block"> geany some_file.foo:55:4 </pre> -<p>This would open the file <tt class="docutils literal"><span class="pre">some_file.foo</span></tt> with the cursor on line 55, +<p>This would open the file <tt class="docutils literal">some_file.foo</tt> with the cursor on line 55, column 4.</p> <p>If you do not like this for some reason, you can disable using the first instance by using the appropriate command line option -- see the section -called <a class="reference" href="#command-line-options">Command line options</a>.</p> +called <a class="reference internal" href="#command-line-options">Command line options</a>.</p> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id31" id="virtual-terminal-emulator-widget-vte" name="virtual-terminal-emulator-widget-vte">Virtual terminal emulator widget (VTE)</a></h3> -<p>If you have installed <tt class="docutils literal"><span class="pre">libvte.so</span></tt> on your system, it is loaded +<div class="section" id="virtual-terminal-emulator-widget-vte"> +<h3><a class="toc-backref" href="#id31">Virtual terminal emulator widget (VTE)</a></h3> +<p>If you have installed <tt class="docutils literal">libvte.so</tt> on your system, it is loaded automatically by Geany, and you will have a terminal widget in the notebook at the bottom.</p> -<p>If Geany cannot find any <tt class="docutils literal"><span class="pre">libvte.so</span></tt> at startup, the terminal widget +<p>If Geany cannot find any <tt class="docutils literal">libvte.so</tt> at startup, the terminal widget will not be loaded. So there is no need to install the package containing this file in order to run Geany. Additionally, you can disable the use of the terminal widget by command line option, for more information -see the section called <a class="reference" href="#command-line-options">Command line options</a>.</p> +see the section called <a class="reference internal" href="#command-line-options">Command line options</a>.</p> <p>You can use this terminal (from now on called VTE) much as you would a terminal program like xterm. There is basic clipboard support. You can paste the contents of the clipboard by pressing the right mouse @@ -968,26 +969,26 @@ you can use the argument <tt class="docutils literal"><span class="pre">--login</span></tt>.</p> <div class="note"> <p class="first admonition-title">Note</p> -<p class="last">Geany tries to load <tt class="docutils literal"><span class="pre">libvte.so</span></tt>. If this fails, it tries to load +<p class="last">Geany tries to load <tt class="docutils literal">libvte.so</tt>. If this fails, it tries to load some other filenames. If this fails too, you should check whether you installed libvte correctly. Again note, Geany will run without this library.</p> </div> <p>It could be, that the library is called something else than -<tt class="docutils literal"><span class="pre">libvte.so</span></tt> (e.g. on FreeBSD 6.0 it is called <tt class="docutils literal"><span class="pre">libvte.so.8</span></tt>). If so +<tt class="docutils literal">libvte.so</tt> (e.g. on FreeBSD 6.0 it is called <tt class="docutils literal">libvte.so.8</tt>). If so please set a link to the correct file (as root):</p> <pre class="literal-block"> # ln -s /usr/lib/libvte.so.X /usr/lib/libvte.so </pre> <p>Obviously, you have to adjust the paths and set X to the number of your -<tt class="docutils literal"><span class="pre">libvte.so</span></tt>.</p> +<tt class="docutils literal">libvte.so</tt>.</p> <p>You can also specify the filename of the VTE library to use on the command -line (see the section called <a class="reference" href="#command-line-options">Command line options</a>) or at compile time +line (see the section called <a class="reference internal" href="#command-line-options">Command line options</a>) or at compile time by specifying the command line option <tt class="docutils literal"><span class="pre">--with-vte-module-path</span></tt> to ./configure.</p> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id32" id="defining-own-widget-styles-using-gtkrc-2-0" name="defining-own-widget-styles-using-gtkrc-2-0">Defining own widget styles using .gtkrc-2.0</a></h3> +<div class="section" id="defining-own-widget-styles-using-gtkrc-2-0"> +<h3><a class="toc-backref" href="#id32">Defining own widget styles using .gtkrc-2.0</a></h3> <p>You can define your widget style for many of Geany's GUI parts. To do this, just edit your <tt class="docutils literal"><span class="pre">.gtkrc-2.0</span></tt> (usually found in your home directory on UNIX-like systems and in the etc subdirectory of your @@ -1027,23 +1028,23 @@ </pre> </div> </div> -<div class="section"> -<h2><a class="toc-backref" href="#id33" id="documents" name="documents">Documents</a></h2> -<div class="section"> -<h3><a class="toc-backref" href="#id34" id="switching-between-documents" name="switching-between-documents">Switching between documents</a></h3> +<div class="section" id="documents"> +<h2><a class="toc-backref" href="#id33">Documents</a></h2> +<div class="section" id="switching-between-documents"> +<h3><a class="toc-backref" href="#id34">Switching between documents</a></h3> <p>The documents list and the editor tabs are two different ways to switch between documents using the mouse. When you hit the key combination to move between tabs, the order is determined by the tab order. It is not alphabetical as shown in the documents list (regardless of whether or not editor tabs are visible).</p> -<p>See the <a class="reference" href="#notebook-tab-keybindings">Notebook tab keybindings</a> section for useful +<p>See the <a class="reference internal" href="#notebook-tab-keybindings">Notebook tab keybindings</a> section for useful shortcuts including for Most-Recently-Used document switching.</p> </div> </div> -<div class="section"> -<h2><a class="toc-backref" href="#id35" id="character-sets-and-unicode-byte-order-mark-bom" name="character-sets-and-unicode-byte-order-mark-bom">Character sets and Unicode Byte-Order-Mark (BOM)</a></h2> -<div class="section"> -<h3><a class="toc-backref" href="#id36" id="using-character-sets" name="using-character-sets">Using character sets</a></h3> +<div class="section" id="character-sets-and-unicode-byte-order-mark-bom"> +<h2><a class="toc-backref" href="#id35">Character sets and Unicode Byte-Order-Mark (BOM)</a></h2> +<div class="section" id="using-character-sets"> +<h3><a class="toc-backref" href="#id36">Using character sets</a></h3> <p>Geany provides support for detecting and converting character sets. So you can open and save files in different character sets, and even convert a file from one character set to another. To do this, @@ -1089,8 +1090,8 @@ </li> </ul> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id37" id="in-file-encoding-specification" name="in-file-encoding-specification">In-file encoding specification</a></h3> +<div class="section" id="in-file-encoding-specification"> +<h3><a class="toc-backref" href="#id37">In-file encoding specification</a></h3> <p>Geany detects meta tags of HTML files which contain charset information like:</p> <pre class="literal-block"> @@ -1117,7 +1118,7 @@ correctly the next time.</p> <p>Since Geany 0.15 you can also use lines which match the regular expression used to find the encoding string: -<tt class="docutils literal"><span class="pre">coding[\t</span> <span class="pre">]*[:=][\t</span> <span class="pre">]*([a-z0-9-]+)[\t</span> <span class="pre">]*</span></tt></p> +<tt class="docutils literal"><span class="pre">coding[\t</span> <span class="pre">]*[:=][\t</span> <span class="pre">]*([a-z0-9-]+)[\t</span> ]*</tt></p> <div class="note"> <p class="first admonition-title">Note</p> <p class="last">These specifications must be in the first 512 bytes of the file. @@ -1132,8 +1133,8 @@ # coding: ISO-8859-15 </pre> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id38" id="special-encoding-none" name="special-encoding-none">Special encoding &quot;None&quot;</a></h3> +<div class="section" id="special-encoding-none"> +<h3><a class="toc-backref" href="#id38">Special encoding &quot;None&quot;</a></h3> <p>There is a special encoding &quot;None&quot; which uses no encoding. It is useful when you know that Geany cannot auto-detect the encoding of a file and it is not displayed correctly. Especially @@ -1142,10 +1143,10 @@ of the first NULL-byte. Using this encoding opens the file as it is without any character conversion.</p> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id39" id="unicode-byte-order-mark-bom" name="unicode-byte-order-mark-bom">Unicode Byte-Order-Mark (BOM)</a></h3> +<div class="section" id="unicode-byte-order-mark-bom"> +<h3><a class="toc-backref" href="#id39">Unicode Byte-Order-Mark (BOM)</a></h3> <p>Furthermore, Geany detects a Unicode Byte Order Mark (see -<a class="reference" href="http://en.wikipedia.org/wiki/Byte_Order_Mark">http://en.wikipedia.org/wiki/Byte_Order_Mark</a> for details). Of course, +<a class="reference external" href="http://en.wikipedia.org/wiki/Byte_Order_Mark">http://en.wikipedia.org/wiki/Byte_Order_Mark</a> for details). Of course, this feature is only available if the opened file is in a Unicode encoding. The Byte Order Mark helps to detect the encoding of a file, e.g. whether it is UTF-16LE or UTF-16BE and so on. On Unix-like systems @@ -1165,10 +1166,10 @@ </div> </div> </div> -<div class="section"> -<h2><a class="toc-backref" href="#id40" id="editing" name="editing">Editing</a></h2> -<div class="section"> -<h3><a class="toc-backref" href="#id41" id="folding" name="folding">Folding</a></h3> +<div class="section" id="editing"> +<h2><a class="toc-backref" href="#id40">Editing</a></h2> +<div class="section" id="folding"> +<h3><a class="toc-backref" href="#id41">Folding</a></h3> <p>Geany provides basic code folding support. Folding means the ability to show and hide parts of the text in the current file. You can hide unimportant code sections and concentrate on the parts you are working on @@ -1182,7 +1183,7 @@ <div class="note"> <p class="first admonition-title">Note</p> <p class="last">You can customize the folding icon and line styles - see the -filetypes.common <a class="reference" href="#folding-settings">Folding Settings</a>.</p> +filetypes.common <a class="reference internal" href="#folding-settings">Folding Settings</a>.</p> </div> <p>If you don't like it or don't need it at all, you can simply disable folding support completely in the preferences dialog.</p> @@ -1197,8 +1198,8 @@ children of a fold point&quot; option is enabled, pressing Shift will disable it for this click and vice versa.</p> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id42" id="column-mode-editing-rectangular-selections" name="column-mode-editing-rectangular-selections">Column mode editing (rectangular selections)</a></h3> +<div class="section" id="column-mode-editing-rectangular-selections"> +<h3><a class="toc-backref" href="#id42">Column mode editing (rectangular selections)</a></h3> <p>There is basic support for column mode editing. To use it, create a rectangular selection by holding down the Control and Shift keys (or Control and Alt if it doesn't work) while @@ -1207,23 +1208,23 @@ this selection and the modifications will be done for every line in the selection.</p> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id43" id="drag-and-drop-of-text" name="drag-and-drop-of-text">Drag and drop of text</a></h3> +<div class="section" id="drag-and-drop-of-text"> +<h3><a class="toc-backref" href="#id43">Drag and drop of text</a></h3> <p>If you drag selected text in the editor widget of Geany the text is moved to the position where the mouse pointer is when releasing the mouse button. Holding Control when releasing the mouse button will copy the text instead. This behaviour was changed in Geany 0.11 - before the selected text was copied to the new position.</p> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id44" id="indentation" name="indentation">Indentation</a></h3> +<div class="section" id="indentation"> +<h3><a class="toc-backref" href="#id44">Indentation</a></h3> <p>Geany allows each document to indent either with a tab character, multiple spaces or a combination of both. The default indent -settings are set in <a class="reference" href="#editor-indentation-preferences">Editor Indentation preferences</a> (see the link +settings are set in <a class="reference internal" href="#editor-indentation-preferences">Editor Indentation preferences</a> (see the link for more information).</p> <p>The default settings can be overridden per-document using the Document menu. They can also be overridden by projects - see -<a class="reference" href="#project-management">Project management</a>.</p> +<a class="reference internal" href="#project-management">Project management</a>.</p> <p>The indent mode for the current document is shown on the status bar as follows:</p> <dl class="docutils"> @@ -1235,21 +1236,21 @@ <dd>Indent with tabs and spaces, depending on how much indentation is on a line.</dd> </dl> -<div class="section"> -<h4><a class="toc-backref" href="#id45" id="applying-new-indentation-settings" name="applying-new-indentation-settings">Applying new indentation settings</a></h4> +<div class="section" id="applying-new-indentation-settings"> +<h4><a class="toc-backref" href="#id45">Applying new indentation settings</a></h4> <p>After changing the default settings you may wish to apply the new settings to every document in the current session. To do this use the <em>Project-&gt;Apply Default Indentation</em> menu item.</p> </div> -<div class="section"> -<h4><a class="toc-backref" href="#id46" id="detecting-indent-type" name="detecting-indent-type">Detecting indent type</a></h4> +<div class="section" id="detecting-indent-type"> +<h4><a class="toc-backref" href="#id46">Detecting indent type</a></h4> <p>The <em>Detect from file</em> indentation preference can be used to scan each file as it's opened and set the indent type based on how many lines start with a tab vs. 2 or more spaces.</p> </div> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id47" id="auto-indentation" name="auto-indentation">Auto-indentation</a></h3> +<div class="section" id="auto-indentation"> +<h3><a class="toc-backref" href="#id47">Auto-indentation</a></h3> <p>When enabled, auto-indentation happens when pressing <em>Enter</em> in the Editor. It adds a certain amount of indentation to the new line so the user doesn't always have to indent each line manually.</p> @@ -1270,10 +1271,10 @@ </dl> <p>There is also XML-tag auto-indentation. This is enabled when the mode is more than just Basic, and is also controlled by a filetype -setting - see <a class="reference" href="#xml-indent-tags">xml_indent_tags</a>.</p> +setting - see <a class="reference internal" href="#xml-indent-tags">xml_indent_tags</a>.</p> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id48" id="bookmarks" name="bookmarks">Bookmarks</a></h3> +<div class="section" id="bookmarks"> +<h3><a class="toc-backref" href="#id48">Bookmarks</a></h3> <p>Geany provides a handy bookmarking feature that lets you mark one or more lines in a document, and return the cursor to them using a key combination.</p> @@ -1290,14 +1291,14 @@ (Ctrl-PgUp/PgDn and Ctrl-Tab) provides a particularly fast way to navigate around multiple files.</p> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id49" id="code-navigation-history" name="code-navigation-history">Code navigation history</a></h3> +<div class="section" id="code-navigation-history"> +<h3><a class="toc-backref" href="#id49">Code navigation history</a></h3> <p>To ease navigation in source files and especially between different files, Geany lets you jump between different navigation points. Currently, this works for the following:</p> <ul class="simple"> -<li><a class="reference" href="#go-to-tag-declaration">Go to tag declaration</a></li> -<li><a class="reference" href="#go-to-tag-definition">Go to tag definition</a></li> +<li><a class="reference internal" href="#go-to-tag-declaration">Go to tag declaration</a></li> +<li><a class="reference internal" href="#go-to-tag-definition">Go to tag definition</a></li> <li>Symbol list items</li> <li>Build errors</li> <li>Message items</li> @@ -1309,8 +1310,8 @@ location&quot;. This makes it easier to navigate in e.g. foreign code and between different files.</p> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id50" id="sending-text-through-custom-commands" name="sending-text-through-custom-commands">Sending text through custom commands</a></h3> +<div class="section" id="sending-text-through-custom-commands"> +<h3><a class="toc-backref" href="#id50">Sending text through custom commands</a></h3> <p>You can define several custom commands in Geany and send the current selection to one of these commands using the <em>Edit-&gt;Format-&gt;Send Selection to</em> menu or keybindings. The output of the command will be @@ -1329,22 +1330,22 @@ commands are not saved.</p> <p>Normal shell quoting is supported, so you can do things like:</p> <ul class="simple"> -<li><tt class="docutils literal"><span class="pre">sed</span> <span class="pre">'s/./(dot)/g'</span></tt></li> +<li><tt class="docutils literal">sed <span class="pre">'s/./(dot)/g'</span></tt></li> </ul> -<p>The above example would normally be done with the <a class="reference" href="#replace-all">Replace all</a> +<p>The above example would normally be done with the <a class="reference internal" href="#replace-all">Replace all</a> function, but it can be handy to have common commands already set up.</p> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id51" id="context-actions" name="context-actions">Context actions</a></h3> +<div class="section" id="context-actions"> +<h3><a class="toc-backref" href="#id51">Context actions</a></h3> <p>You can execute the context action command on the current word at the cursor position or the available selection. This word or selection can be used as an argument to the command. The context action is invoked by a menu entry in the popup menu of the editor and also a keyboard shortcut (see the section called -<a class="reference" href="#keybindings">Keybindings</a>).</p> +<a class="reference internal" href="#keybindings">Keybindings</a>).</p> <p>The command can be specified in the preferences dialog and also for each filetype (see &quot;context_action_cmd&quot; in the section called -<a class="reference" href="#filetype-configuration">Filetype configuration</a>). When the context action is invoked, the filetype +<a class="reference internal" href="#filetype-configuration">Filetype configuration</a>). When the context action is invoked, the filetype specific command is used if available, otherwise the command specified in the preferences dialog is executed.</p> <p>The current word or selection can be referred with the wildcard &quot;%s&quot; @@ -1359,19 +1360,19 @@ <p>when executing the command, the %s is substituted by the word near the cursor position or by the current selection. If the cursor is at the word &quot;echo&quot;, a browser window will open(assumed your browser is -called firefox) and it will open the address: <a class="reference" href="http://www.php.net/echo">http://www.php.net/echo</a>.</p> +called firefox) and it will open the address: <a class="reference external" href="http://www.php.net/echo">http://www.php.net/echo</a>.</p> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id52" id="autocompletion" name="autocompletion">Autocompletion</a></h3> +<div class="section" id="autocompletion"> +<h3><a class="toc-backref" href="#id52">Autocompletion</a></h3> <p>Geany can offer a list of possible completions for symbols defined in the tags and for all words in a document.</p> <p>The autocompletion list for symbols is presented when the first few

@@ Diff output truncated at 100000 characters. @@

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.