SF.net SVN: geany:[4118] branches/build-system/doc
ntrel at users.sourceforge.net
ntrel at xxxxx
Mon Aug 24 12:43:19 UTC 2009
Revision: 4118
http://geany.svn.sourceforge.net/geany/?rev=4118&view=rev
Author: ntrel
Date: 2009-08-24 12:43:19 +0000 (Mon, 24 Aug 2009)
Log Message:
-----------
Regenerate manual, minor fix.
Modified Paths:
--------------
branches/build-system/doc/geany.html
branches/build-system/doc/geany.txt
Modified: branches/build-system/doc/geany.html
===================================================================
--- branches/build-system/doc/geany.html 2009-08-24 12:39:13 UTC (rev 4117)
+++ branches/build-system/doc/geany.html 2009-08-24 12:43:19 UTC (rev 4118)
@@ -6,7 +6,7 @@
<meta name="generator" content="Docutils 0.4: http://docutils.sourceforge.net/" />
<title>Geany</title>
<meta name="authors" content="Enrico Tröger Nick Treleaven Frank Lanitz" />
-<meta name="date" content="2009-08-16" />
+<meta name="date" content="2009-08-19" />
<style type="text/css">
/*
@@ -139,7 +139,7 @@
<br />Nick Treleaven
<br />Frank Lanitz</td></tr>
<tr><th class="docinfo-name">Date:</th>
-<td>2009-08-16</td></tr>
+<td>2009-08-19</td></tr>
<tr><th class="docinfo-name">Version:</th>
<td>0.19</td></tr>
</tbody>
@@ -153,289 +153,306 @@
<div class="contents topic">
<p class="topic-title first"><a id="contents" name="contents">Contents</a></p>
<ul class="simple">
-<li><a class="reference" href="#introduction" id="id11" name="id11">Introduction</a><ul>
-<li><a class="reference" href="#about-geany" id="id12" name="id12">About Geany</a></li>
-<li><a class="reference" href="#where-to-get-it" id="id13" name="id13">Where to get it</a></li>
-<li><a class="reference" href="#license" id="id14" name="id14">License</a></li>
-<li><a class="reference" href="#about-this-document" id="id15" name="id15">About this document</a></li>
+<li><a class="reference" href="#introduction" id="id12" name="id12">Introduction</a><ul>
+<li><a class="reference" href="#about-geany" id="id13" name="id13">About Geany</a></li>
+<li><a class="reference" href="#where-to-get-it" id="id14" name="id14">Where to get it</a></li>
+<li><a class="reference" href="#license" id="id15" name="id15">License</a></li>
+<li><a class="reference" href="#about-this-document" id="id16" name="id16">About this document</a></li>
</ul>
</li>
-<li><a class="reference" href="#installation" id="id16" name="id16">Installation</a><ul>
-<li><a class="reference" href="#requirements" id="id17" name="id17">Requirements</a></li>
-<li><a class="reference" href="#binary-packages" id="id18" name="id18">Binary packages</a></li>
-<li><a class="reference" href="#source-compilation" id="id19" name="id19">Source compilation</a><ul>
-<li><a class="reference" href="#autotools-based-build-system" id="id20" name="id20">Autotools based build system</a></li>
-<li><a class="reference" href="#waf-based-build-system" id="id21" name="id21">Waf based build system</a><ul>
-<li><a class="reference" href="#waf-cache" id="id22" name="id22">Waf Cache</a><ul>
-<li><a class="reference" href="#cleaning-the-cache" id="id23" name="id23">Cleaning the Cache</a></li>
+<li><a class="reference" href="#installation" id="id17" name="id17">Installation</a><ul>
+<li><a class="reference" href="#requirements" id="id18" name="id18">Requirements</a></li>
+<li><a class="reference" href="#binary-packages" id="id19" name="id19">Binary packages</a></li>
+<li><a class="reference" href="#source-compilation" id="id20" name="id20">Source compilation</a><ul>
+<li><a class="reference" href="#autotools-based-build-system" id="id21" name="id21">Autotools based build system</a></li>
+<li><a class="reference" href="#waf-based-build-system" id="id22" name="id22">Waf based build system</a><ul>
+<li><a class="reference" href="#waf-cache" id="id23" name="id23">Waf Cache</a><ul>
+<li><a class="reference" href="#cleaning-the-cache" id="id24" name="id24">Cleaning the Cache</a></li>
</ul>
</li>
</ul>
</li>
-<li><a class="reference" href="#custom-installation" id="id24" name="id24">Custom installation</a></li>
-<li><a class="reference" href="#dynamic-linking-loader-support" id="id25" name="id25">Dynamic linking loader support</a></li>
-<li><a class="reference" href="#build-problems" id="id26" name="id26">Build problems</a></li>
+<li><a class="reference" href="#custom-installation" id="id25" name="id25">Custom installation</a></li>
+<li><a class="reference" href="#dynamic-linking-loader-support" id="id26" name="id26">Dynamic linking loader support</a></li>
+<li><a class="reference" href="#build-problems" id="id27" name="id27">Build problems</a></li>
</ul>
</li>
-<li><a class="reference" href="#installation-prefix" id="id27" name="id27">Installation prefix</a></li>
+<li><a class="reference" href="#installation-prefix" id="id28" name="id28">Installation prefix</a></li>
</ul>
</li>
-<li><a class="reference" href="#usage" id="id28" name="id28">Usage</a><ul>
-<li><a class="reference" href="#getting-started" id="id29" name="id29">Getting started</a></li>
-<li><a class="reference" href="#command-line-options" id="id30" name="id30">Command line options</a></li>
-<li><a class="reference" href="#general" id="id31" name="id31">General</a><ul>
-<li><a class="reference" href="#startup" id="id32" name="id32">Startup</a></li>
-<li><a class="reference" href="#opening-files-from-the-command-line-in-a-running-instance" id="id33" name="id33">Opening files from the command-line in a running instance</a></li>
-<li><a class="reference" href="#virtual-terminal-emulator-widget-vte" id="id34" name="id34">Virtual terminal emulator widget (VTE)</a></li>
-<li><a class="reference" href="#defining-own-widget-styles-using-gtkrc-2-0" id="id35" name="id35">Defining own widget styles using .gtkrc-2.0</a></li>
+<li><a class="reference" href="#usage" id="id29" name="id29">Usage</a><ul>
+<li><a class="reference" href="#getting-started" id="id30" name="id30">Getting started</a></li>
+<li><a class="reference" href="#command-line-options" id="id31" name="id31">Command line options</a></li>
+<li><a class="reference" href="#general" id="id32" name="id32">General</a><ul>
+<li><a class="reference" href="#startup" id="id33" name="id33">Startup</a></li>
+<li><a class="reference" href="#opening-files-from-the-command-line-in-a-running-instance" id="id34" name="id34">Opening files from the command-line in a running instance</a></li>
+<li><a class="reference" href="#virtual-terminal-emulator-widget-vte" id="id35" name="id35">Virtual terminal emulator widget (VTE)</a></li>
+<li><a class="reference" href="#defining-own-widget-styles-using-gtkrc-2-0" id="id36" name="id36">Defining own widget styles using .gtkrc-2.0</a></li>
</ul>
</li>
-<li><a class="reference" href="#documents" id="id36" name="id36">Documents</a><ul>
-<li><a class="reference" href="#switching-between-documents" id="id37" name="id37">Switching between documents</a></li>
+<li><a class="reference" href="#documents" id="id37" name="id37">Documents</a><ul>
+<li><a class="reference" href="#switching-between-documents" id="id38" name="id38">Switching between documents</a></li>
</ul>
</li>
-<li><a class="reference" href="#character-sets-and-unicode-byte-order-mark-bom" id="id38" name="id38">Character sets and Unicode Byte-Order-Mark (BOM)</a><ul>
-<li><a class="reference" href="#using-character-sets" id="id39" name="id39">Using character sets</a></li>
-<li><a class="reference" href="#in-file-encoding-specification" id="id40" name="id40">In-file encoding specification</a></li>
-<li><a class="reference" href="#special-encoding-none" id="id41" name="id41">Special encoding "None"</a></li>
-<li><a class="reference" href="#unicode-byte-order-mark-bom" id="id42" name="id42">Unicode Byte-Order-Mark (BOM)</a></li>
+<li><a class="reference" href="#character-sets-and-unicode-byte-order-mark-bom" id="id39" name="id39">Character sets and Unicode Byte-Order-Mark (BOM)</a><ul>
+<li><a class="reference" href="#using-character-sets" id="id40" name="id40">Using character sets</a></li>
+<li><a class="reference" href="#in-file-encoding-specification" id="id41" name="id41">In-file encoding specification</a></li>
+<li><a class="reference" href="#special-encoding-none" id="id42" name="id42">Special encoding "None"</a></li>
+<li><a class="reference" href="#unicode-byte-order-mark-bom" id="id43" name="id43">Unicode Byte-Order-Mark (BOM)</a></li>
</ul>
</li>
-<li><a class="reference" href="#editing" id="id43" name="id43">Editing</a><ul>
-<li><a class="reference" href="#folding" id="id44" name="id44">Folding</a></li>
-<li><a class="reference" href="#column-mode-editing-rectangular-selections" id="id45" name="id45">Column mode editing (rectangular selections)</a></li>
-<li><a class="reference" href="#drag-and-drop-of-text" id="id46" name="id46">Drag and drop of text</a></li>
-<li><a class="reference" href="#indentation" id="id47" name="id47">Indentation</a></li>
-<li><a class="reference" href="#auto-indentation" id="id48" name="id48">Auto-indentation</a></li>
-<li><a class="reference" href="#bookmarks" id="id49" name="id49">Bookmarks</a></li>
-<li><a class="reference" href="#code-navigation-history" id="id50" name="id50">Code Navigation History</a></li>
-<li><a class="reference" href="#send-text-through-definable-commands" id="id51" name="id51">Send text through definable commands</a></li>
-<li><a class="reference" href="#context-actions" id="id52" name="id52">Context actions</a></li>
-<li><a class="reference" href="#autocompletion" id="id53" name="id53">Autocompletion</a><ul>
-<li><a class="reference" href="#scope-autocompletion" id="id54" name="id54">Scope autocompletion</a></li>
+<li><a class="reference" href="#editing" id="id44" name="id44">Editing</a><ul>
+<li><a class="reference" href="#folding" id="id45" name="id45">Folding</a></li>
+<li><a class="reference" href="#column-mode-editing-rectangular-selections" id="id46" name="id46">Column mode editing (rectangular selections)</a></li>
+<li><a class="reference" href="#drag-and-drop-of-text" id="id47" name="id47">Drag and drop of text</a></li>
+<li><a class="reference" href="#indentation" id="id48" name="id48">Indentation</a></li>
+<li><a class="reference" href="#auto-indentation" id="id49" name="id49">Auto-indentation</a></li>
+<li><a class="reference" href="#bookmarks" id="id50" name="id50">Bookmarks</a></li>
+<li><a class="reference" href="#code-navigation-history" id="id51" name="id51">Code Navigation History</a></li>
+<li><a class="reference" href="#send-text-through-definable-commands" id="id52" name="id52">Send text through definable commands</a></li>
+<li><a class="reference" href="#context-actions" id="id53" name="id53">Context actions</a></li>
+<li><a class="reference" href="#autocompletion" id="id54" name="id54">Autocompletion</a><ul>
+<li><a class="reference" href="#scope-autocompletion" id="id55" name="id55">Scope autocompletion</a></li>
</ul>
</li>
-<li><a class="reference" href="#user-definable-snippets" id="id55" name="id55">User-definable snippets</a></li>
-<li><a class="reference" href="#inserting-unicode-characters" id="id56" name="id56">Inserting Unicode characters</a></li>
+<li><a class="reference" href="#user-definable-snippets" id="id56" name="id56">User-definable snippets</a></li>
+<li><a class="reference" href="#inserting-unicode-characters" id="id57" name="id57">Inserting Unicode characters</a></li>
</ul>
</li>
-<li><a class="reference" href="#search-replace-and-go-to" id="id57" name="id57">Search, replace and go to</a><ul>
-<li><a class="reference" href="#find" id="id58" name="id58">Find</a><ul>
-<li><a class="reference" href="#matching-options" id="id59" name="id59">Matching options</a></li>
-<li><a class="reference" href="#find-all" id="id60" name="id60">Find all</a></li>
-<li><a class="reference" href="#change-font-in-search-dialog-text-fields" id="id61" name="id61">Change font in search dialog text fields</a></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="#find" id="id59" name="id59">Find</a><ul>
+<li><a class="reference" href="#matching-options" id="id60" name="id60">Matching options</a></li>
+<li><a class="reference" href="#find-all" id="id61" name="id61">Find all</a></li>
+<li><a class="reference" href="#change-font-in-search-dialog-text-fields" id="id62" name="id62">Change font in search dialog text fields</a></li>
</ul>
</li>
-<li><a class="reference" href="#find-usage" id="id62" name="id62">Find usage</a></li>
-<li><a class="reference" href="#find-in-files" id="id63" name="id63">Find in files</a><ul>
-<li><a class="reference" href="#filtering-out-version-control-files" id="id64" name="id64">Filtering out version control files</a></li>
+<li><a class="reference" href="#find-usage" id="id63" name="id63">Find usage</a></li>
+<li><a class="reference" href="#find-in-files" id="id64" name="id64">Find in files</a><ul>
+<li><a class="reference" href="#filtering-out-version-control-files" id="id65" name="id65">Filtering out version control files</a></li>
</ul>
</li>
-<li><a class="reference" href="#replace" id="id65" name="id65">Replace</a><ul>
-<li><a class="reference" href="#replace-all" id="id66" name="id66">Replace all</a></li>
+<li><a class="reference" href="#replace" id="id66" name="id66">Replace</a><ul>
+<li><a class="reference" href="#replace-all" id="id67" name="id67">Replace all</a></li>
</ul>
</li>
-<li><a class="reference" href="#go-to-tag-definition" id="id67" name="id67">Go to tag definition</a></li>
-<li><a class="reference" href="#go-to-tag-declaration" id="id68" name="id68">Go to tag declaration</a></li>
-<li><a class="reference" href="#go-to-line" id="id69" name="id69">Go to line</a></li>
-<li><a class="reference" href="#regular-expressions" id="id70" name="id70">Regular expressions</a></li>
+<li><a class="reference" href="#go-to-tag-definition" id="id68" name="id68">Go to tag definition</a></li>
+<li><a class="reference" href="#go-to-tag-declaration" id="id69" name="id69">Go to tag declaration</a></li>
+<li><a class="reference" href="#go-to-line" id="id70" name="id70">Go to line</a></li>
+<li><a class="reference" href="#regular-expressions" id="id71" name="id71">Regular expressions</a></li>
</ul>
</li>
-<li><a class="reference" href="#tags" id="id71" name="id71">Tags</a><ul>
-<li><a class="reference" href="#workspace-tags" id="id72" name="id72">Workspace tags</a></li>
-<li><a class="reference" href="#global-tags" id="id73" name="id73">Global tags</a><ul>
-<li><a class="reference" href="#default-global-tags-files" id="id74" name="id74">Default global tags files</a></li>
-<li><a class="reference" href="#global-tags-file-format" id="id75" name="id75">Global tags file format</a></li>
-<li><a class="reference" href="#generating-a-global-tags-file" id="id76" name="id76">Generating a global tags file</a></li>
+<li><a class="reference" href="#tags" id="id72" name="id72">Tags</a><ul>
+<li><a class="reference" href="#workspace-tags" id="id73" name="id73">Workspace tags</a></li>
+<li><a class="reference" href="#global-tags" id="id74" name="id74">Global tags</a><ul>
+<li><a class="reference" href="#default-global-tags-files" id="id75" name="id75">Default global tags files</a></li>
+<li><a class="reference" href="#global-tags-file-format" id="id76" name="id76">Global tags file format</a></li>
+<li><a class="reference" href="#generating-a-global-tags-file" id="id77" name="id77">Generating a global tags file</a></li>
</ul>
</li>
-<li><a class="reference" href="#ignore-tags" id="id77" name="id77">Ignore tags</a></li>
+<li><a class="reference" href="#ignore-tags" id="id78" name="id78">Ignore tags</a></li>
</ul>
</li>
-<li><a class="reference" href="#preferences" id="id78" name="id78">Preferences</a><ul>
-<li><a class="reference" href="#general-startup-tab-in-preferences-dialog" id="id79" name="id79">General Startup tab in preferences dialog</a><ul>
-<li><a class="reference" href="#id1" id="id80" name="id80">Startup</a></li>
-<li><a class="reference" href="#shutdown" id="id81" name="id81">Shutdown</a></li>
-<li><a class="reference" href="#paths" id="id82" name="id82">Paths</a></li>
+<li><a class="reference" href="#preferences" id="id79" name="id79">Preferences</a><ul>
+<li><a class="reference" href="#general-startup-tab-in-preferences-dialog" id="id80" name="id80">General Startup tab in preferences dialog</a><ul>
+<li><a class="reference" href="#id1" id="id81" name="id81">Startup</a></li>
+<li><a class="reference" href="#shutdown" id="id82" name="id82">Shutdown</a></li>
+<li><a class="reference" href="#paths" id="id83" name="id83">Paths</a></li>
</ul>
</li>
-<li><a class="reference" href="#general-miscellaneous-tab-in-preferences-dialog" id="id83" name="id83">General Miscellaneous tab in preferences dialog</a><ul>
-<li><a class="reference" href="#miscellaneous" id="id84" name="id84">Miscellaneous</a></li>
+<li><a class="reference" href="#general-miscellaneous-tab-in-preferences-dialog" id="id84" name="id84">General Miscellaneous tab in preferences dialog</a><ul>
+<li><a class="reference" href="#miscellaneous" id="id85" name="id85">Miscellaneous</a></li>
</ul>
</li>
-<li><a class="reference" href="#search" id="id85" name="id85">Search</a><ul>
-<li><a class="reference" href="#projects" id="id86" name="id86">Projects</a></li>
+<li><a class="reference" href="#search" id="id86" name="id86">Search</a><ul>
+<li><a class="reference" href="#projects" id="id87" name="id87">Projects</a></li>
</ul>
</li>
-<li><a class="reference" href="#interface-tab-in-preferences-dialog" id="id87" name="id87">Interface tab in preferences dialog</a><ul>
-<li><a class="reference" href="#sidebar" id="id88" name="id88">Sidebar</a></li>
-<li><a class="reference" href="#fonts" id="id89" name="id89">Fonts</a></li>
-<li><a class="reference" href="#editor-tabs" id="id90" name="id90">Editor tabs</a></li>
-<li><a class="reference" href="#tab-positions" id="id91" name="id91">Tab positions</a></li>
-<li><a class="reference" href="#id2" id="id92" name="id92">Miscellaneous</a></li>
+<li><a class="reference" href="#interface-tab-in-preferences-dialog" id="id88" name="id88">Interface tab in preferences dialog</a><ul>
+<li><a class="reference" href="#sidebar" id="id89" name="id89">Sidebar</a></li>
+<li><a class="reference" href="#fonts" id="id90" name="id90">Fonts</a></li>
+<li><a class="reference" href="#editor-tabs" id="id91" name="id91">Editor tabs</a></li>
+<li><a class="reference" href="#tab-positions" id="id92" name="id92">Tab positions</a></li>
+<li><a class="reference" href="#id2" id="id93" name="id93">Miscellaneous</a></li>
</ul>
</li>
-<li><a class="reference" href="#toolbar-tab-in-preferences-dialog" id="id93" name="id93">Toolbar tab in preferences dialog</a><ul>
-<li><a class="reference" href="#toolbar" id="id94" name="id94">Toolbar</a></li>
-<li><a class="reference" href="#appearance" id="id95" name="id95">Appearance</a></li>
+<li><a class="reference" href="#toolbar-tab-in-preferences-dialog" id="id94" name="id94">Toolbar tab in preferences dialog</a><ul>
+<li><a class="reference" href="#toolbar" id="id95" name="id95">Toolbar</a></li>
+<li><a class="reference" href="#appearance" id="id96" name="id96">Appearance</a></li>
</ul>
</li>
-<li><a class="reference" href="#editor-features-tab-in-preferences-dialog" id="id96" name="id96">Editor Features tab in preferences dialog</a><ul>
-<li><a class="reference" href="#features" id="id97" name="id97">Features</a></li>
+<li><a class="reference" href="#editor-features-tab-in-preferences-dialog" id="id97" name="id97">Editor Features tab in preferences dialog</a><ul>
+<li><a class="reference" href="#features" id="id98" name="id98">Features</a></li>
</ul>
</li>
-<li><a class="reference" href="#editor-indentation-tab-in-preferences-dialog" id="id98" name="id98">Editor Indentation tab in preferences dialog</a><ul>
-<li><a class="reference" href="#indentation-group" id="id99" name="id99">Indentation group</a></li>
+<li><a class="reference" href="#editor-indentation-tab-in-preferences-dialog" id="id99" name="id99">Editor Indentation tab in preferences dialog</a><ul>
+<li><a class="reference" href="#indentation-group" id="id100" name="id100">Indentation group</a></li>
</ul>
</li>
-<li><a class="reference" href="#editor-completions-tab-in-preferences-dialog" id="id100" name="id100">Editor Completions tab in preferences dialog</a><ul>
-<li><a class="reference" href="#completions" id="id101" name="id101">Completions</a></li>
-<li><a class="reference" href="#auto-close-quotes-and-brackets" id="id102" name="id102">Auto-close quotes and brackets</a></li>
+<li><a class="reference" href="#editor-completions-tab-in-preferences-dialog" id="id101" name="id101">Editor Completions tab in preferences dialog</a><ul>
+<li><a class="reference" href="#completions" id="id102" name="id102">Completions</a></li>
+<li><a class="reference" href="#auto-close-quotes-and-brackets" id="id103" name="id103">Auto-close quotes and brackets</a></li>
</ul>
</li>
-<li><a class="reference" href="#editor-display-tab-in-preferences-dialog" id="id103" name="id103">Editor Display tab in preferences dialog</a><ul>
-<li><a class="reference" href="#display" id="id104" name="id104">Display</a></li>
-<li><a class="reference" href="#long-line-marker" id="id105" name="id105">Long line marker</a></li>
+<li><a class="reference" href="#editor-display-tab-in-preferences-dialog" id="id104" name="id104">Editor Display tab in preferences dialog</a><ul>
+<li><a class="reference" href="#display" id="id105" name="id105">Display</a></li>
+<li><a class="reference" href="#long-line-marker" id="id106" name="id106">Long line marker</a></li>
</ul>
</li>
-<li><a class="reference" href="#files-tab-in-preferences-dialog" id="id106" name="id106">Files tab in preferences dialog</a><ul>
-<li><a class="reference" href="#new-files" id="id107" name="id107">New files</a></li>
-<li><a class="reference" href="#saving-files" id="id108" name="id108">Saving files</a></li>
-<li><a class="reference" href="#id3" id="id109" name="id109">Miscellaneous</a></li>
+<li><a class="reference" href="#files-tab-in-preferences-dialog" id="id107" name="id107">Files tab in preferences dialog</a><ul>
+<li><a class="reference" href="#new-files" id="id108" name="id108">New files</a></li>
+<li><a class="reference" href="#saving-files" id="id109" name="id109">Saving files</a></li>
+<li><a class="reference" href="#id3" id="id110" name="id110">Miscellaneous</a></li>
</ul>
</li>
-<li><a class="reference" href="#tools-tab-in-preferences-dialog" id="id110" name="id110">Tools tab in preferences dialog</a><ul>
-<li><a class="reference" href="#tool-paths" id="id111" name="id111">Tool paths</a></li>
-<li><a class="reference" href="#commands" id="id112" name="id112">Commands</a></li>
+<li><a class="reference" href="#tools-tab-in-preferences-dialog" id="id111" name="id111">Tools tab in preferences dialog</a><ul>
+<li><a class="reference" href="#tool-paths" id="id112" name="id112">Tool paths</a></li>
+<li><a class="reference" href="#commands" id="id113" name="id113">Commands</a></li>
</ul>
</li>
-<li><a class="reference" href="#template-tab-in-preferences-dialog" id="id113" name="id113">Template tab in preferences dialog</a><ul>
-<li><a class="reference" href="#template-data" id="id114" name="id114">Template data</a></li>
+<li><a class="reference" href="#template-tab-in-preferences-dialog" id="id114" name="id114">Template tab in preferences dialog</a><ul>
+<li><a class="reference" href="#template-data" id="id115" name="id115">Template data</a></li>
</ul>
</li>
-<li><a class="reference" href="#keybinding-tab-in-preferences-dialog" id="id115" name="id115">Keybinding tab in preferences dialog</a></li>
-<li><a class="reference" href="#printing-tab-in-preferences-dialog" id="id116" name="id116">Printing tab in preferences dialog</a></li>
-<li><a class="reference" href="#terminal-vte-tab-in-preferences-dialog" id="id117" name="id117">Terminal (VTE) tab in preferences dialog</a><ul>
-<li><a class="reference" href="#terminal-widget" id="id118" name="id118">Terminal widget</a></li>
+<li><a class="reference" href="#keybinding-tab-in-preferences-dialog" id="id116" name="id116">Keybinding tab in preferences dialog</a></li>
+<li><a class="reference" href="#printing-tab-in-preferences-dialog" id="id117" name="id117">Printing tab in preferences dialog</a></li>
+<li><a class="reference" href="#terminal-vte-tab-in-preferences-dialog" id="id118" name="id118">Terminal (VTE) tab in preferences dialog</a><ul>
+<li><a class="reference" href="#terminal-widget" id="id119" name="id119">Terminal widget</a></li>
</ul>
</li>
</ul>
</li>
-<li><a class="reference" href="#project-management" id="id119" name="id119">Project Management</a><ul>
-<li><a class="reference" href="#new-project" id="id120" name="id120">New Project</a></li>
-<li><a class="reference" href="#project-properties" id="id121" name="id121">Project Properties</a><ul>
-<li><a class="reference" href="#make-in-base-path" id="id122" name="id122">Make in base path</a></li>
-<li><a class="reference" href="#run-command" id="id123" name="id123">Run command</a></li>
+<li><a class="reference" href="#project-management" id="id120" name="id120">Project Management</a><ul>
+<li><a class="reference" href="#new-project" id="id121" name="id121">New Project</a></li>
+<li><a class="reference" href="#project-properties" id="id122" name="id122">Project Properties</a><ul>
+<li><a class="reference" href="#set-base-path-button" id="id123" name="id123">Set Base Path Button</a></li>
</ul>
</li>
<li><a class="reference" href="#open-project" id="id124" name="id124">Open Project</a></li>
<li><a class="reference" href="#close-project" id="id125" name="id125">Close Project</a></li>
</ul>
</li>
-<li><a class="reference" href="#build-system" id="id126" name="id126">Build system</a><ul>
-<li><a class="reference" href="#compile" id="id127" name="id127">Compile</a></li>
-<li><a class="reference" href="#build" id="id128" name="id128">Build</a></li>
-<li><a class="reference" href="#make-all" id="id129" name="id129">Make all</a></li>
-<li><a class="reference" href="#make-custom-target" id="id130" name="id130">Make custom target</a></li>
-<li><a class="reference" href="#make-object" id="id131" name="id131">Make object</a></li>
-<li><a class="reference" href="#execute" id="id132" name="id132">Execute</a></li>
-<li><a class="reference" href="#stopping-running-processes" id="id133" name="id133">Stopping running processes</a><ul>
-<li><a class="reference" href="#terminal-emulators" id="id134" name="id134">Terminal emulators</a></li>
+<li><a class="reference" href="#build-menu" id="id126" name="id126">Build Menu</a><ul>
+<li><a class="reference" href="#indicators" id="id127" name="id127">Indicators</a></li>
+<li><a class="reference" href="#default-build-menu-items" id="id128" name="id128">Default Build Menu Items</a><ul>
+<li><a class="reference" href="#compile" id="id129" name="id129">Compile</a></li>
+<li><a class="reference" href="#build" id="id130" name="id130">Build</a></li>
+<li><a class="reference" href="#make" id="id131" name="id131">Make</a></li>
+<li><a class="reference" href="#make-custom-target" id="id132" name="id132">Make custom target</a></li>
+<li><a class="reference" href="#make-object" id="id133" name="id133">Make object</a></li>
+<li><a class="reference" href="#next-error" id="id134" name="id134">Next Error</a></li>
+<li><a class="reference" href="#previous-error" id="id135" name="id135">Previous Error</a></li>
+<li><a class="reference" href="#execute" id="id136" name="id136">Execute</a></li>
+<li><a class="reference" href="#stopping-running-processes" id="id137" name="id137">Stopping running processes</a><ul>
+<li><a class="reference" href="#terminal-emulators" id="id138" name="id138">Terminal emulators</a></li>
</ul>
</li>
-<li><a class="reference" href="#set-includes-and-arguments" id="id135" name="id135">Set Includes and Arguments</a><ul>
-<li><a class="reference" href="#one-step-compilation" id="id136" name="id136">One step compilation</a></li>
+<li><a class="reference" href="#set-build-commands" id="id139" name="id139">Set Build Commands</a></li>
</ul>
</li>
-<li><a class="reference" href="#indicators" id="id137" name="id137">Indicators</a></li>
+<li><a class="reference" href="#build-menu-configuration" id="id140" name="id140">Build Menu Configuration</a></li>
+<li><a class="reference" href="#build-menu-commands-dialog" id="id141" name="id141">Build Menu Commands Dialog</a><ul>
+<li><a class="reference" href="#substitutions-in-commands-and-working-directories" id="id142" name="id142">Substitutions in Commands and Working Directories</a></li>
+<li><a class="reference" href="#build-menu-keyboard-shortcuts" id="id143" name="id143">Build Menu Keyboard Shortcuts</a></li>
+<li><a class="reference" href="#configuration-files" id="id144" name="id144">Configuration Files</a></li>
</ul>
</li>
-<li><a class="reference" href="#printing-support" id="id138" name="id138">Printing support</a></li>
-<li><a class="reference" href="#plugins" id="id139" name="id139">Plugins</a></li>
-<li><a class="reference" href="#keybindings" id="id140" name="id140">Keybindings</a><ul>
-<li><a class="reference" href="#switching-documents" id="id141" name="id141">Switching documents</a></li>
-<li><a class="reference" href="#configurable-keybindings" id="id142" name="id142">Configurable keybindings</a></li>
</ul>
</li>
+<li><a class="reference" href="#printing-support" id="id145" name="id145">Printing support</a></li>
+<li><a class="reference" href="#plugins" id="id146" name="id146">Plugins</a></li>
+<li><a class="reference" href="#keybindings" id="id147" name="id147">Keybindings</a><ul>
+<li><a class="reference" href="#switching-documents" id="id148" name="id148">Switching documents</a></li>
+<li><a class="reference" href="#configurable-keybindings" id="id149" name="id149">Configurable keybindings</a></li>
</ul>
</li>
-<li><a class="reference" href="#configuration-files" id="id143" name="id143">Configuration files</a><ul>
-<li><a class="reference" href="#tools-menu-items" id="id144" name="id144">Tools menu items</a></li>
-<li><a class="reference" href="#global-configuration-file" id="id145" name="id145">Global configuration file</a></li>
-<li><a class="reference" href="#filetype-definition-files" id="id146" name="id146">Filetype definition files</a><ul>
-<li><a class="reference" href="#format" id="id147" name="id147">Format</a><ul>
-<li><a class="reference" href="#styling-section" id="id148" name="id148">[styling] Section</a><ul>
-<li><a class="reference" href="#using-a-named-style" id="id149" name="id149">Using a named style</a></li>
</ul>
</li>
-<li><a class="reference" href="#keywords-section" id="id150" name="id150">[keywords] Section</a></li>
-<li><a class="reference" href="#settings-section" id="id151" name="id151">[settings] Section</a></li>
-<li><a class="reference" href="#build-settings-section" id="id152" name="id152">[build_settings] Section</a></li>
+<li><a class="reference" href="#id4" id="id150" name="id150">Configuration files</a><ul>
+<li><a class="reference" href="#tools-menu-items" id="id151" name="id151">Tools menu items</a></li>
+<li><a class="reference" href="#global-configuration-file" id="id152" name="id152">Global configuration file</a></li>
+<li><a class="reference" href="#filetype-definition-files" id="id153" name="id153">Filetype definition files</a><ul>
+<li><a class="reference" href="#format" id="id154" name="id154">Format</a><ul>
+<li><a class="reference" href="#styling-section" id="id155" name="id155">[styling] Section</a><ul>
+<li><a class="reference" href="#using-a-named-style" id="id156" name="id156">Using a named style</a></li>
</ul>
</li>
-<li><a class="reference" href="#special-file-filetypes-common" id="id153" name="id153">Special file filetypes.common</a><ul>
-<li><a class="reference" href="#named-styles-section" id="id154" name="id154">[named_styles] Section</a></li>
-<li><a class="reference" href="#id4" id="id155" name="id155">[styling] Section</a></li>
-<li><a class="reference" href="#id5" id="id156" name="id156">[settings] Section</a></li>
+<li><a class="reference" href="#keywords-section" id="id157" name="id157">[keywords] Section</a></li>
+<li><a class="reference" href="#settings-section" id="id158" name="id158">[settings] Section</a></li>
+<li><a class="reference" href="#build-settings-section" id="id159" name="id159">[build_settings] Section</a></li>
</ul>
</li>
+<li><a class="reference" href="#special-file-filetypes-common" id="id160" name="id160">Special file filetypes.common</a><ul>
+<li><a class="reference" href="#named-styles-section" id="id161" name="id161">[named_styles] Section</a></li>
+<li><a class="reference" href="#id5" id="id162" name="id162">[styling] Section</a></li>
+<li><a class="reference" href="#id6" id="id163" name="id163">[settings] Section</a></li>
</ul>
</li>
-<li><a class="reference" href="#filetype-extensions" id="id157" name="id157">Filetype extensions</a></li>
-<li><a class="reference" href="#templates" id="id158" name="id158">Templates</a><ul>
-<li><a class="reference" href="#template-meta-data" id="id159" name="id159">Template meta data</a></li>
-<li><a class="reference" href="#file-templates" id="id160" name="id160">File templates</a><ul>
-<li><a class="reference" href="#custom-file-templates" id="id161" name="id161">Custom file templates</a></li>
-<li><a class="reference" href="#filetype-templates" id="id162" name="id162">Filetype templates</a></li>
</ul>
</li>
-<li><a class="reference" href="#customizing-templates" id="id163" name="id163">Customizing templates</a><ul>
-<li><a class="reference" href="#template-wildcards" id="id164" name="id164">Template wildcards</a></li>
+<li><a class="reference" href="#filetype-extensions" id="id164" name="id164">Filetype extensions</a></li>
+<li><a class="reference" href="#preferences-file-format" id="id165" name="id165">Preferences File Format</a><ul>
+<li><a class="reference" href="#hidden-preferences" id="id166" name="id166">Hidden preferences</a></li>
+<li><a class="reference" href="#build-menu-section" id="id167" name="id167">[build-menu] Section</a></li>
</ul>
</li>
+<li><a class="reference" href="#project-file-format" id="id168" name="id168">Project File Format</a><ul>
+<li><a class="reference" href="#build-menu-additions" id="id169" name="id169">[build-menu] Additions</a></li>
</ul>
</li>
-<li><a class="reference" href="#customizing-the-toolbar" id="id165" name="id165">Customizing the toolbar</a><ul>
-<li><a class="reference" href="#manually-editing-of-the-toolbar-layout" id="id166" name="id166">Manually editing of the toolbar layout</a></li>
-<li><a class="reference" href="#available-toolbar-elements" id="id167" name="id167">Available toolbar elements</a></li>
+<li><a class="reference" href="#templates" id="id170" name="id170">Templates</a><ul>
+<li><a class="reference" href="#template-meta-data" id="id171" name="id171">Template meta data</a></li>
+<li><a class="reference" href="#file-templates" id="id172" name="id172">File templates</a><ul>
+<li><a class="reference" href="#custom-file-templates" id="id173" name="id173">Custom file templates</a></li>
+<li><a class="reference" href="#filetype-templates" id="id174" name="id174">Filetype templates</a></li>
</ul>
</li>
+<li><a class="reference" href="#customizing-templates" id="id175" name="id175">Customizing templates</a><ul>
+<li><a class="reference" href="#template-wildcards" id="id176" name="id176">Template wildcards</a></li>
</ul>
</li>
-<li><a class="reference" href="#plugin-documentation" id="id168" name="id168">Plugin documentation</a><ul>
-<li><a class="reference" href="#instant-save" id="id169" name="id169">Instant Save</a></li>
-<li><a class="reference" href="#backup-copy" id="id170" name="id170">Backup Copy</a></li>
</ul>
</li>
-<li><a class="reference" href="#contributing-to-this-document" id="id171" name="id171">Contributing to this document</a></li>
-<li><a class="reference" href="#scintilla-keyboard-commands" id="id172" name="id172">Scintilla keyboard commands</a><ul>
-<li><a class="reference" href="#keyboard-commands" id="id173" name="id173">Keyboard commands</a></li>
+<li><a class="reference" href="#customizing-the-toolbar" id="id177" name="id177">Customizing the toolbar</a><ul>
+<li><a class="reference" href="#manually-editing-of-the-toolbar-layout" id="id178" name="id178">Manually editing of the toolbar layout</a></li>
+<li><a class="reference" href="#available-toolbar-elements" id="id179" name="id179">Available toolbar elements</a></li>
</ul>
</li>
-<li><a class="reference" href="#tips-and-tricks" id="id174" name="id174">Tips and tricks</a><ul>
-<li><a class="reference" href="#document-notebook" id="id175" name="id175">Document notebook</a></li>
-<li><a class="reference" href="#editor" id="id176" name="id176">Editor</a></li>
-<li><a class="reference" href="#interface" id="id177" name="id177">Interface</a></li>
-<li><a class="reference" href="#gtk-related" id="id178" name="id178">GTK-related</a></li>
</ul>
</li>
-<li><a class="reference" href="#hidden-preferences" id="id179" name="id179">Hidden preferences</a></li>
-<li><a class="reference" href="#compile-time-options" id="id180" name="id180">Compile-time options</a><ul>
-<li><a class="reference" href="#src-geany-h" id="id181" name="id181">src/geany.h</a></li>
-<li><a class="reference" href="#project-h" id="id182" name="id182">project.h</a></li>
-<li><a class="reference" href="#editor-h" id="id183" name="id183">editor.h</a></li>
-<li><a class="reference" href="#keyfile-c" id="id184" name="id184">keyfile.c</a></li>
-<li><a class="reference" href="#build-h" id="id185" name="id185">build.h</a></li>
+<li><a class="reference" href="#plugin-documentation" id="id180" name="id180">Plugin documentation</a><ul>
+<li><a class="reference" href="#instant-save" id="id181" name="id181">Instant Save</a></li>
+<li><a class="reference" href="#backup-copy" id="id182" name="id182">Backup Copy</a></li>
</ul>
</li>
-<li><a class="reference" href="#gnu-general-public-license" id="id186" name="id186">GNU General Public License</a></li>
-<li><a class="reference" href="#license-for-scintilla-and-scite" id="id187" name="id187">License for Scintilla and SciTE</a></li>
+<li><a class="reference" href="#contributing-to-this-document" id="id183" name="id183">Contributing to this document</a></li>
+<li><a class="reference" href="#scintilla-keyboard-commands" id="id184" name="id184">Scintilla keyboard commands</a><ul>
+<li><a class="reference" href="#keyboard-commands" id="id185" name="id185">Keyboard commands</a></li>
</ul>
+</li>
+<li><a class="reference" href="#tips-and-tricks" id="id186" name="id186">Tips and tricks</a><ul>
+<li><a class="reference" href="#document-notebook" id="id187" name="id187">Document notebook</a></li>
+<li><a class="reference" href="#editor" id="id188" name="id188">Editor</a></li>
+<li><a class="reference" href="#interface" id="id189" name="id189">Interface</a></li>
+<li><a class="reference" href="#gtk-related" id="id190" name="id190">GTK-related</a></li>
+</ul>
+</li>
+<li><a class="reference" href="#compile-time-options" id="id191" name="id191">Compile-time options</a><ul>
+<li><a class="reference" href="#src-geany-h" id="id192" name="id192">src/geany.h</a></li>
+<li><a class="reference" href="#project-h" id="id193" name="id193">project.h</a></li>
+<li><a class="reference" href="#editor-h" id="id194" name="id194">editor.h</a></li>
+<li><a class="reference" href="#keyfile-c" id="id195" name="id195">keyfile.c</a></li>
+<li><a class="reference" href="#build-h" id="id196" name="id196">build.h</a></li>
+<li><a class="reference" href="#build-c" id="id197" name="id197">build.c</a></li>
+</ul>
+</li>
+<li><a class="reference" href="#gnu-general-public-license" id="id198" name="id198">GNU General Public License</a></li>
+<li><a class="reference" href="#license-for-scintilla-and-scite" id="id199" name="id199">License for Scintilla and SciTE</a></li>
+</ul>
</div>
<div class="section">
-<h1><a class="toc-backref" href="#id11" id="introduction" name="introduction">Introduction</a></h1>
+<h1><a class="toc-backref" href="#id12" id="introduction" name="introduction">Introduction</a></h1>
<div class="section">
-<h2><a class="toc-backref" href="#id12" id="about-geany" name="about-geany">About Geany</a></h2>
+<h2><a class="toc-backref" href="#id13" id="about-geany" name="about-geany">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 from other packages. Another goal was to be as independent
@@ -459,13 +476,13 @@
</ul>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id13" id="where-to-get-it" name="where-to-get-it">Where to get it</a></h2>
+<h2><a class="toc-backref" href="#id14" 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
your distributor. 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>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id14" id="license" name="license">License</a></h2>
+<h2><a class="toc-backref" href="#id15" id="license" name="license">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
@@ -476,28 +493,28 @@
<a class="reference" href="#license-for-scintilla-and-scite">License for Scintilla and SciTE</a>.</p>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id15" id="about-this-document" name="about-this-document">About this document</a></h2>
+<h2><a class="toc-backref" href="#id16" id="about-this-document" name="about-this-document">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>
</div>
</div>
<div class="section">
-<h1><a class="toc-backref" href="#id16" id="installation" name="installation">Installation</a></h1>
+<h1><a class="toc-backref" href="#id17" id="installation" name="installation">Installation</a></h1>
<div class="section">
-<h2><a class="toc-backref" href="#id17" id="requirements" name="requirements">Requirements</a></h2>
+<h2><a class="toc-backref" href="#id18" id="requirements" name="requirements">Requirements</a></h2>
<p>You will need the GTK (>= 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
which bundles these libraries from the website.</p>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id18" id="binary-packages" name="binary-packages">Binary packages</a></h2>
+<h2><a class="toc-backref" href="#id19" id="binary-packages" name="binary-packages">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>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id19" id="source-compilation" name="source-compilation">Source compilation</a></h2>
+<h2><a class="toc-backref" href="#id20" id="source-compilation" name="source-compilation">Source compilation</a></h2>
<p>Compiling Geany is quite easy.
To do so, you need the GTK (>= 2.8.0) libraries and header files.
You also need the Pango, GLib and ATK libraries and header files.
@@ -507,7 +524,7 @@
<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="#id20" id="autotools-based-build-system" name="autotools-based-build-system">Autotools based build system</a></h3>
+<h3><a class="toc-backref" href="#id21" id="autotools-based-build-system" name="autotools-based-build-system">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>
@@ -521,7 +538,7 @@
</pre>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id21" id="waf-based-build-system" name="waf-based-build-system">Waf based build system</a></h3>
+<h3><a class="toc-backref" href="#id22" id="waf-based-build-system" name="waf-based-build-system">Waf based build system</a></h3>
<p>The Waf build system is still quite young and under heavy development but already in an
usable state. In contrary to the Autotools, Waf needs Python. So before using Waf, you need
to install Python on your system.
@@ -540,7 +557,7 @@
% ./waf install
</pre>
<div class="section">
-<h4><a class="toc-backref" href="#id22" id="waf-cache" name="waf-cache">Waf Cache</a></h4>
+<h4><a class="toc-backref" href="#id23" id="waf-cache" name="waf-cache">Waf Cache</a></h4>
<p>The Waf build system has a nice and interesting feature which can help a lot to avoid
unnecessary rebuilding of unchanged code. This often happens when developing new features
or trying to debug something.
@@ -560,7 +577,7 @@
<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="#id23" id="cleaning-the-cache" name="cleaning-the-cache">Cleaning the Cache</a></h5>
+<h5><a class="toc-backref" href="#id24" id="cleaning-the-cache" name="cleaning-the-cache">Cleaning the Cache</a></h5>
<p>You should take care about the size of the cache directory as it may grow rapidly by time.
Waf doesn't do any cleaning or other house-keeping of the cache yet so you need to keep it
clean by yourself.
@@ -575,7 +592,7 @@
</div>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id24" id="custom-installation" name="custom-installation">Custom installation</a></h3>
+<h3><a class="toc-backref" href="#id25" id="custom-installation" name="custom-installation">Custom installation</a></h3>
<p>The configure script supports several common options, for a detailed
list, type:</p>
<pre class="literal-block">
@@ -593,14 +610,14 @@
</ul>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id25" id="dynamic-linking-loader-support" name="dynamic-linking-loader-support">Dynamic linking loader support</a></h3>
+<h3><a class="toc-backref" href="#id26" id="dynamic-linking-loader-support" name="dynamic-linking-loader-support">Dynamic linking loader support</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>
script. This prevents compiling Geany with dynamic linking loader
support to automatically load <tt class="docutils literal"><span class="pre">libvte.so.4</span></tt> if available.</p>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id26" id="build-problems" name="build-problems">Build problems</a></h3>
+<h3><a class="toc-backref" href="#id27" id="build-problems" name="build-problems">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
@@ -608,7 +625,7 @@
</div>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id27" id="installation-prefix" name="installation-prefix">Installation prefix</a></h2>
+<h2><a class="toc-backref" href="#id28" id="installation-prefix" name="installation-prefix">Installation prefix</a></h2>
<p>If you want to edit any of Geany's system configuration files after
installation you will need to know the installation prefix. Usually this
is not necessary as you can just use user configuration files.</p>
@@ -619,9 +636,9 @@
</div>
</div>
<div class="section">
-<h1><a class="toc-backref" href="#id28" id="usage" name="usage">Usage</a></h1>
+<h1><a class="toc-backref" href="#id29" id="usage" name="usage">Usage</a></h1>
<div class="section">
-<h2><a class="toc-backref" href="#id29" id="getting-started" name="getting-started">Getting started</a></h2>
+<h2><a class="toc-backref" href="#id30" id="getting-started" name="getting-started">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>
@@ -638,7 +655,7 @@
</ul>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id30" id="command-line-options" name="command-line-options">Command line options</a></h2>
+<h2><a class="toc-backref" href="#id31" id="command-line-options" name="command-line-options">Command line options</a></h2>
<table border="1" class="docutils">
<colgroup>
<col width="13%" />
@@ -770,9 +787,9 @@
help screen.</p>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id31" id="general" name="general">General</a></h2>
+<h2><a class="toc-backref" href="#id32" id="general" name="general">General</a></h2>
<div class="section">
-<h3><a class="toc-backref" href="#id32" id="startup" name="startup">Startup</a></h3>
+<h3><a class="toc-backref" href="#id33" id="startup" name="startup">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-tab-in-preferences-dialog">General Startup tab in preferences dialog</a>). If you specify some
@@ -787,7 +804,7 @@
files in a running instance using the appropriate command line option.</p>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id33" 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>
+<h3><a class="toc-backref" href="#id34" 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>
<p>Geany detects an already running instance of itself and opens files
from the command-line in the already running instance. So, Geany can
be used to view and edit files by opening them from other programs
@@ -803,7 +820,7 @@
called <a class="reference" href="#command-line-options">Command line options</a>.</p>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id34" id="virtual-terminal-emulator-widget-vte" name="virtual-terminal-emulator-widget-vte">Virtual terminal emulator widget (VTE)</a></h3>
+<h3><a class="toc-backref" href="#id35" 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> in your system, it is loaded
automatically by Geany, and you will have a terminal widget in the
notebook at the bottom.</p>
@@ -847,7 +864,7 @@
./configure.</p>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id35" 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>
+<h3><a class="toc-backref" href="#id36" 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>
<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
@@ -888,9 +905,9 @@
</div>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id36" id="documents" name="documents">Documents</a></h2>
+<h2><a class="toc-backref" href="#id37" id="documents" name="documents">Documents</a></h2>
<div class="section">
-<h3><a class="toc-backref" href="#id37" id="switching-between-documents" name="switching-between-documents">Switching between documents</a></h3>
+<h3><a class="toc-backref" href="#id38" id="switching-between-documents" name="switching-between-documents">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
@@ -901,9 +918,9 @@
</div>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id38" 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>
+<h2><a class="toc-backref" href="#id39" 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="#id39" id="using-character-sets" name="using-character-sets">Using character sets</a></h3>
+<h3><a class="toc-backref" href="#id40" id="using-character-sets" name="using-character-sets">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
can convert a file from a character set to another one. To do this,
@@ -949,7 +966,7 @@
</ul>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id40" id="in-file-encoding-specification" name="in-file-encoding-specification">In-file encoding specification</a></h3>
+<h3><a class="toc-backref" href="#id41" id="in-file-encoding-specification" name="in-file-encoding-specification">In-file encoding specification</a></h3>
<p>Geany detects meta tags of HTML files which contain charset information
like:</p>
<pre class="literal-block">
@@ -991,7 +1008,7 @@
</div>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id41" id="special-encoding-none" name="special-encoding-none">Special encoding "None"</a></h3>
+<h3><a class="toc-backref" href="#id42" id="special-encoding-none" name="special-encoding-none">Special encoding "None"</a></h3>
<p>There is a special encoding "None" which is actually no real
encoding. It is useful when you know that Geany cannot auto-detect
the encoding of a file and it is not displayed correctly. Especially
@@ -1001,7 +1018,7 @@
without any character conversion.</p>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id42" id="unicode-byte-order-mark-bom" name="unicode-byte-order-mark-bom">Unicode Byte-Order-Mark (BOM)</a></h3>
+<h3><a class="toc-backref" href="#id43" id="unicode-byte-order-mark-bom" name="unicode-byte-order-mark-bom">Unicode Byte-Order-Mark (BOM)</a></h3>
<p>Furthermore, Geany detects an 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,
this feature is only available if the opened file is in an Unicode
@@ -1022,9 +1039,9 @@
</div>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id43" id="editing" name="editing">Editing</a></h2>
+<h2><a class="toc-backref" href="#id44" id="editing" name="editing">Editing</a></h2>
<div class="section">
-<h3><a class="toc-backref" href="#id44" id="folding" name="folding">Folding</a></h3>
+<h3><a class="toc-backref" href="#id45" id="folding" name="folding">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
@@ -1048,7 +1065,7 @@
it for this click and vice versa.</p>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id45" id="column-mode-editing-rectangular-selections" name="column-mode-editing-rectangular-selections">Column mode editing (rectangular selections)</a></h3>
+<h3><a class="toc-backref" href="#id46" id="column-mode-editing-rectangular-selections" name="column-mode-editing-rectangular-selections">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
@@ -1059,7 +1076,7 @@
selection.</p>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id46" id="drag-and-drop-of-text" name="drag-and-drop-of-text">Drag and drop of text</a></h3>
+<h3><a class="toc-backref" href="#id47" id="drag-and-drop-of-text" name="drag-and-drop-of-text">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
@@ -1067,7 +1084,7 @@
before the selected text was copied to the new position.</p>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id47" id="indentation" name="indentation">Indentation</a></h3>
+<h3><a class="toc-backref" href="#id48" id="indentation" name="indentation">Indentation</a></h3>
<p>Geany allows each document to indent either with a tab character or
multiple spaces. The default indent mode is set in the <a class="reference" href="#editor-features-tab-in-preferences-dialog">Editor Features
tab in preferences dialog</a> (see the link for more information). But
@@ -1088,7 +1105,7 @@
</dl>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id48" id="auto-indentation" name="auto-indentation">Auto-indentation</a></h3>
+<h3><a class="toc-backref" href="#id49" id="auto-indentation" name="auto-indentation">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>
@@ -1109,7 +1126,7 @@
</dl>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id49" id="bookmarks" name="bookmarks">Bookmarks</a></h3>
+<h3><a class="toc-backref" href="#id50" id="bookmarks" name="bookmarks">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>
@@ -1127,7 +1144,7 @@
navigate around multiple files.</p>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id50" id="code-navigation-history" name="code-navigation-history">Code Navigation History</a></h3>
+<h3><a class="toc-backref" href="#id51" id="code-navigation-history" name="code-navigation-history">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>
@@ -1146,7 +1163,7 @@
and between different files.</p>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id51" id="send-text-through-definable-commands" name="send-text-through-definable-commands">Send text through definable commands</a></h3>
+<h3><a class="toc-backref" href="#id52" id="send-text-through-definable-commands" name="send-text-through-definable-commands">Send text through definable commands</a></h3>
<p>You can define several custom commands in Geany and send the current
selection to one of these commands. The output of the command will be
used to replace the current selection. So, it is possible to use text
@@ -1163,7 +1180,7 @@
entry and press OK. It will be deleted automatically.</p>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id52" id="context-actions" name="context-actions">Context actions</a></h3>
+<h3><a class="toc-backref" href="#id53" id="context-actions" name="context-actions">Context actions</a></h3>
<p>You can execute a specified command on the current word near the
cursor position or an available selection and this word is passed
as an argument to this command. It can be used for example to open
@@ -1189,7 +1206,7 @@
called firefox) and it will open the address: <a class="reference" href="http://www.php.net/echo">http://www.php.net/echo</a>.</p>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id53" id="autocompletion" name="autocompletion">Autocompletion</a></h3>
+<h3><a class="toc-backref" href="#id54" id="autocompletion" name="autocompletion">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
@@ -1214,7 +1231,7 @@
preferences dialog</a>) then any characters after the cursor that match
a symbol or word are deleted.</p>
<div class="section">
-<h4><a class="toc-backref" href="#id54" id="scope-autocompletion" name="scope-autocompletion">Scope autocompletion</a></h4>
+<h4><a class="toc-backref" href="#id55" id="scope-autocompletion" name="scope-autocompletion">Scope autocompletion</a></h4>
<p>E.g.:</p>
<pre class="literal-block">
struct
@@ -1232,7 +1249,7 @@
</div>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id55" id="user-definable-snippets" name="user-definable-snippets">User-definable snippets</a></h3>
+<h3><a class="toc-backref" href="#id56" id="user-definable-snippets" name="user-definable-snippets">User-definable snippets</a></h3>
<p>Snippets are small strings or code constructs which can be replaced or
completed to a more complex string. So you can save a lot of time by
not typing often used strings and letting Geany do the work for you.
@@ -1332,7 +1349,7 @@
needs.</p>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id56" id="inserting-unicode-characters" name="inserting-unicode-characters">Inserting Unicode characters</a></h3>
+<h3><a class="toc-backref" href="#id57" id="inserting-unicode-characters" name="inserting-unicode-characters">Inserting Unicode characters</a></h3>
<p>With GTK 2.10 and above, you can hit Ctrl-Shift-u, then still holding
Ctrl-Shift, type some hex digits representing the code point for the
character you want, then let go of Ctrl-Shift and hit a key such as
@@ -1348,7 +1365,7 @@
</div>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id57" id="search-replace-and-go-to" name="search-replace-and-go-to">Search, replace and go to</a></h2>
+<h2><a class="toc-backref" href="#id58" id="search-replace-and-go-to" name="search-replace-and-go-to">Search, replace and go to</a></h2>
<p>This section describes search-related commands from the Search menu
and the editor window's popup menu:</p>
<ul class="simple">
@@ -1363,11 +1380,11 @@
<p>* These items are available from the editor window's popup menu, or by
using a keyboard shortcut (see the section called <a class="reference" href="#keybindings">Keybindings</a>).</p>
<div class="section">
-<h3><a class="toc-backref" href="#id58" id="find" name="find">Find</a></h3>
+<h3><a class="toc-backref" href="#id59" id="find" name="find">Find</a></h3>
<p>The Find dialog is used for finding text in one or more open documents.</p>
<img alt="./images/find_dialog.png" src="./images/find_dialog.png" />
<div class="section">
-<h4><a class="toc-backref" href="#id59" id="matching-options" name="matching-options">Matching options</a></h4>
+<h4><a class="toc-backref" href="#id60" id="matching-options" name="matching-options">Matching options</a></h4>
<p>The syntax for the Use regular expressions option is shown in
<a class="reference" href="#regular-expressions">Regular expressions</a>.</p>
<p>The Use escape sequences option will transform any escaped characters
@@ -1376,7 +1393,7 @@
(Unicode characters).</p>
</div>
<div class="section">
-<h4><a class="toc-backref" href="#id60" id="find-all" name="find-all">Find all</a></h4>
+<h4><a class="toc-backref" href="#id61" id="find-all" name="find-all">Find all</a></h4>
<p>To find all matches, click on the Find All expander. This will reveal
several options:</p>
<ul class="simple">
@@ -1392,7 +1409,7 @@
Remove Markers command from the Document menu.</p>
</div>
<div class="section">
-<h4><a class="toc-backref" href="#id61" id="change-font-in-search-dialog-text-fields" name="change-font-in-search-dialog-text-fields">Change font in search dialog text fields</a></h4>
+<h4><a class="toc-backref" href="#id62" id="change-font-in-search-dialog-text-fields" name="change-font-in-search-dialog-text-fields">Change font in search dialog text fields</a></h4>
<p>All search related dialogs use a Monospace for the text input fields to
increase the readability of input text. This is useful when you are
typing e.g. regular expressions with spaces, periods and commas which
@@ -1414,7 +1431,7 @@
</div>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id62" id="find-usage" name="find-usage">Find usage</a></h3>
+<h3><a class="toc-backref" href="#id63" id="find-usage" name="find-usage">Find usage</a></h3>
<p>Find usage searches all open files. It is similar to the Find All In
Session Find dialog command.</p>
<p>If there is a selection, then it is used as the search text; otherwise
@@ -1424,7 +1441,7 @@
shown in the Messages tab of the Message Window.</p>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id63" id="find-in-files" name="find-in-files">Find in files</a></h3>
+<h3><a class="toc-backref" href="#id64" id="find-in-files" name="find-in-files">Find in files</a></h3>
<p>Find in files is a more powerful version of Find usage that searches
all files in a certain directory using the Grep tool. The Grep tool
must be correctly set in Preferences to the path of the system's Grep
@@ -1436,7 +1453,7 @@
The Extra options field is used to pass any additional arguments to
the grep tool.</p>
<div class="section">
-<h4><a class="toc-backref" href="#id64" id="filtering-out-version-control-files" name="filtering-out-version-control-files">Filtering out version control files</a></h4>
+<h4><a class="toc-backref" href="#id65" id="filtering-out-version-control-files" name="filtering-out-version-control-files">Filtering out version control files</a></h4>
<p>When using the <em>Recurse in subfolders</em> option with a directory that's
under version control, you can set the <em>Extra options</em> field to use
grep's <tt class="docutils literal"><span class="pre">--exclude</span></tt> flag to filter out filenames.</p>
@@ -1448,7 +1465,7 @@
</div>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id65" id="replace" name="replace">Replace</a></h3>
+<h3><a class="toc-backref" href="#id66" id="replace" name="replace">Replace</a></h3>
<p>The Replace dialog is used for replacing text in one or more open
documents.</p>
<img alt="./images/replace_dialog.png" src="./images/replace_dialog.png" />
@@ -1458,7 +1475,7 @@
and to the replacement text; for the latter back references can be
used -- see the entry for '\n' in <a class="reference" href="#regular-expressions">Regular expressions</a>.</p>
<div class="section">
-<h4><a class="toc-backref" href="#id66" id="replace-all" name="replace-all">Replace all</a></h4>
+<h4><a class="toc-backref" href="#id67" id="replace-all" name="replace-all">Replace all</a></h4>
<p>To replace several matches, click on the <em>Replace All</em> expander. This
will reveal several options:</p>
<ul class="simple">
@@ -1473,7 +1490,7 @@
</div>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id67" id="go-to-tag-definition" name="go-to-tag-definition">Go to tag definition</a></h3>
+<h3><a class="toc-backref" href="#id68" id="go-to-tag-definition" name="go-to-tag-definition">Go to tag definition</a></h3>
<p>If the current word is the name of a tag definition (like a function
body) and the file containing the tag definition is open, this command
will switch to that file and go to the corresponding line number. The
@@ -1482,17 +1499,17 @@
menu is used.</p>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id68" id="go-to-tag-declaration" name="go-to-tag-declaration">Go to tag declaration</a></h3>
+<h3><a class="toc-backref" href="#id69" id="go-to-tag-declaration" name="go-to-tag-declaration">Go to tag declaration</a></h3>
<p>Like Go to tag definition, but for a forward declaration such as a
function prototype or <tt class="docutils literal"><span class="pre">extern</span></tt> declaration instead of a function
body.</p>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id69" id="go-to-line" name="go-to-line">Go to line</a></h3>
+<h3><a class="toc-backref" href="#id70" id="go-to-line" name="go-to-line">Go to line</a></h3>
<p>Go to a particular line number in the current file.</p>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id70" id="regular-expressions" name="regular-expressions">Regular expressions</a></h3>
+<h3><a class="toc-backref" href="#id71" id="regular-expressions" name="regular-expressions">Regular expressions</a></h3>
<p>You can use regular expressions in the Find and Replace dialogs
by selecting the Use regular expressions check box. The syntax is
POSIX-like, as described in the table below.</p>
@@ -1602,7 +1619,7 @@
</div>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id71" id="tags" name="tags">Tags</a></h2>
+<h2><a class="toc-backref" href="#id72" id="tags" name="tags">Tags</a></h2>
<p>Geany has built-in functionality for generating tag information (aka
"workspace tags") for supported filetypes when you open a file. You
can also have Geany automatically load external tag files (aka "global
@@ -1611,7 +1628,7 @@
(but is incompatible with ctags). You use Geany to generate global
tags files, as described below.</p>
<div class="section">
-<h3><a class="toc-backref" href="#id72" id="workspace-tags" name="workspace-tags">Workspace tags</a></h3>
+<h3><a class="toc-backref" href="#id73" id="workspace-tags" name="workspace-tags">Workspace tags</a></h3>
<p>Tags for each document are parsed whenever a file is loaded or
saved. These are shown in the Symbol list in the Sidebar. These tags
are also used for autocompletion of symbols and calltips for all documents
@@ -1620,7 +1637,7 @@
<a class="reference" href="#go-to-tag-definition">Go to tag definition</a>.</p>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id73" id="global-tags" name="global-tags">Global tags</a></h3>
+<h3><a class="toc-backref" href="#id74" id="global-tags" name="global-tags">Global tags</a></h3>
<p>Global tags are used to provide autocompletion of symbols and calltips
without having to open the corresponding source files. This is intended
for library APIs, as the tags file only has to be updated when you upgrade
@@ -1643,7 +1660,7 @@
with the tags. See the section called <a class="reference" href="#filetype-extensions">Filetype extensions</a> for
more information.</p>
<div class="section">
-<h4><a class="toc-backref" href="#id74" id="default-global-tags-files" name="default-global-tags-files">Default global tags files</a></h4>
+<h4><a class="toc-backref" href="#id75" id="default-global-tags-files" name="default-global-tags-files">Default global tags files</a></h4>
<p>For some languages, a list of global tags is loaded when the
corresponding filetype is first used. Currently these are for:</p>
<ul class="simple">
@@ -1656,7 +1673,7 @@
</ul>
</div>
<div class="section">
-<h4><a class="toc-backref" href="#id75" id="global-tags-file-format" name="global-tags-file-format">Global tags file format</a></h4>
+<h4><a class="toc-backref" href="#id76" id="global-tags-file-format" name="global-tags-file-format">Global tags file format</a></h4>
<p>Global tags files can have two different formats:</p>
<ul class="simple">
<li>Tagmanager format</li>
@@ -1693,7 +1710,7 @@
section <a class="reference" href="#global-tags">Global tags</a>.</p>
</div>
<div class="section">
-<h4><a class="toc-backref" href="#id76" id="generating-a-global-tags-file" name="generating-a-global-tags-file">Generating a global tags file</a></h4>
+<h4><a class="toc-backref" href="#id77" id="generating-a-global-tags-file" name="generating-a-global-tags-file">Generating a global tags file</a></h4>
<p>You can generate your own global tags files by parsing a list of
source files. The command is:</p>
<pre class="literal-block">
@@ -1738,7 +1755,7 @@
</div>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id77" id="ignore-tags" name="ignore-tags">Ignore tags</a></h3>
+<h3><a class="toc-backref" href="#id78" id="ignore-tags" name="ignore-tags">Ignore tags</a></h3>
<p>You can also ignore certain tags if they would lead to wrong parsing of
the code. Simply create a file called "ignore.tags" in your Geany
configuration directory (usually <tt class="docutils literal"><span class="pre">~/.config/geany/</span></tt>). Then list all tags
@@ -1762,7 +1779,7 @@
</div>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id78" id="preferences" name="preferences">Preferences</a></h2>
+<h2><a class="toc-backref" href="#id79" id="preferences" name="preferences">Preferences</a></h2>
<p>You may adjust Geany's settings using the Edit --> Preferences
dialog. Any changes you make there can be applied by hitting either
the Apply or the OK button. These settings will persist between Geany
@@ -1780,10 +1797,10 @@
comes after the screenshot of that tab.</p>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id79" id="general-startup-tab-in-preferences-dialog" name="general-startup-tab-in-preferences-dialog">General Startup tab in preferences dialog</a></h3>
+<h3><a class="toc-backref" href="#id80" id="general-startup-tab-in-preferences-dialog" name="general-startup-tab-in-preferences-dialog">General Startup tab in preferences dialog</a></h3>
<img alt="./images/pref_dialog_gen_startup.png" src="./images/pref_dialog_gen_startup.png" />
<div class="section">
-<h4><a class="toc-backref" href="#id80" id="id1" name="id1">Startup</a></h4>
+<h4><a class="toc-backref" href="#id81" id="id1" name="id1">Startup</a></h4>
<dl class="docutils">
<dt>Load files from the last session</dt>
<dd>On startup, load the same files you had open the last time you
@@ -1795,7 +1812,7 @@
</dl>
</div>
<div class="section">
-<h4><a class="toc-backref" href="#id81" id="shutdown" name="shutdown">Shutdown</a></h4>
+<h4><a class="toc-backref" href="#id82" id="shutdown" name="shutdown">Shutdown</a></h4>
<dl class="docutils">
<dt>Save window position and geometry</dt>
<dd>Save the current position and size of the main window so next time
@@ -1805,7 +1822,7 @@
</dl>
</div>
<div class="section">
-<h4><a class="toc-backref" href="#id82" id="paths" name="paths">Paths</a></h4>
+<h4><a class="toc-backref" href="#id83" id="paths" name="paths">Paths</a></h4>
<dl class="docutils">
<dt>Startup path</dt>
<dd>Path to start in when opening or saving files.
@@ -1824,10 +1841,10 @@
</div>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id83" id="general-miscellaneous-tab-in-preferences-dialog" name="general-miscellaneous-tab-in-preferences-dialog">General Miscellaneous tab in preferences dialog</a></h3>
+<h3><a class="toc-backref" href="#id84" id="general-miscellaneous-tab-in-preferences-dialog" name="general-miscellaneous-tab-in-preferences-dialog">General Miscellaneous tab in preferences dialog</a></h3>
<img alt="./images/pref_dialog_gen_misc.png" src="./images/pref_dialog_gen_misc.png" />
<div class="section">
-<h4><a class="toc-backref" href="#id84" id="miscellaneous" name="miscellaneous">Miscellaneous</a></h4>
+<h4><a class="toc-backref" href="#id85" id="miscellaneous" name="miscellaneous">Miscellaneous</a></h4>
<dl class="docutils">
<dt>Beep on errors when compilation has finished</dt>
<dd>Have the computer make a beeping sound when compilation of your program
@@ -1846,7 +1863,7 @@
</div>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id85" id="search" name="search">Search</a></h3>
+<h3><a class="toc-backref" href="#id86" id="search" name="search">Search</a></h3>
<dl class="docutils">
<dt>Always wrap search and hide the Find dialog</dt>
<dd>Always wrap search around the document and hide the Find dialog after clicking
@@ -1861,7 +1878,7 @@
dialog is used.</dd>
</dl>
<div class="section">
-<h4><a class="toc-backref" href="#id86" id="projects" name="projects">Projects</a></h4>
+<h4><a class="toc-backref" href="#id87" id="projects" name="projects">Projects</a></h4>
<dl class="docutils">
<dt>Use project-based session files</dt>
<dd>Save your current session when closing projects. You will be able to
@@ -1878,10 +1895,10 @@
</div>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id87" id="interface-tab-in-preferences-dialog" name="interface-tab-in-preferences-dialog">Interface tab in preferences dialog</a></h3>
+<h3><a class="toc-backref" href="#id88" id="interface-tab-in-preferences-dialog" name="interface-tab-in-preferences-dialog">Interface tab in preferences dialog</a></h3>
<img alt="./images/pref_dialog_interface.png" src="./images/pref_dialog_interface.png" />
<div class="section">
-<h4><a class="toc-backref" href="#id88" id="sidebar" name="sidebar">Sidebar</a></h4>
+<h4><a class="toc-backref" href="#id89" id="sidebar" name="sidebar">Sidebar</a></h4>
<dl class="docutils">
<dt>Show symbol list</dt>
<dd>Show the list of functions, variables, and other information in the
@@ -1893,7 +1910,7 @@
</dl>
</div>
<div class="section">
-<h4><a class="toc-backref" href="#id89" id="fonts" name="fonts">Fonts</a></h4>
+<h4><a class="toc-backref" href="#id90" id="fonts" name="fonts">Fonts</a></h4>
<dl class="docutils">
<dt>Editor</dt>
<dd>Change the font used to display documents.</dd>
@@ -1904,7 +1921,7 @@
</dl>
</div>
<div class="section">
-<h4><a class="toc-backref" href="#id90" id="editor-tabs" name="editor-tabs">Editor tabs</a></h4>
+<h4><a class="toc-backref" href="#id91" id="editor-tabs" name="editor-tabs">Editor tabs</a></h4>
<dl class="docutils">
<dt>Show editor tabs</dt>
<dd>Show a notebook tab for all documents so you can switch between them
@@ -1921,7 +1938,7 @@
</dl>
</div>
<div class="section">
-<h4><a class="toc-backref" href="#id91" id="tab-positions" name="tab-positions">Tab positions</a></h4>
+<h4><a class="toc-backref" href="#id92" id="tab-positions" name="tab-positions">Tab positions</a></h4>
<dl class="docutils">
<dt>Editor</dt>
<dd>Set the positioning of the editor's notebook tabs to the right,
@@ -1935,7 +1952,7 @@
</dl>
</div>
<div class="section">
-<h4><a class="toc-backref" href="#id92" id="id2" name="id2">Miscellaneous</a></h4>
+<h4><a class="toc-backref" href="#id93" id="id2" name="id2">Miscellaneous</a></h4>
<dl class="docutils">
<dt>Show status bar</dt>
<dd>Show the status bar at the bottom of the main window. It gives information about
@@ -1945,11 +1962,11 @@
</div>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id93" id="toolbar-tab-in-preferences-dialog" name="toolbar-tab-in-preferences-dialog">Toolbar tab in preferences dialog</a></h3>
+<h3><a class="toc-backref" href="#id94" id="toolbar-tab-in-preferences-dialog" name="toolbar-tab-in-preferences-dialog">Toolbar tab in preferences dialog</a></h3>
<p>Affects the main toolbar underneath the menu bar.</p>
<img alt="./images/pref_dialog_toolbar.png" src="./images/pref_dialog_toolbar.png" />
<div class="section">
-<h4><a class="toc-backref" href="#id94" id="toolbar" name="toolbar">Toolbar</a></h4>
+<h4><a class="toc-backref" href="#id95" id="toolbar" name="toolbar">Toolbar</a></h4>
<dl class="docutils">
<dt>Show Toolbar</dt>
<dd>Whether to show the toolbar.</dd>
@@ -1959,7 +1976,7 @@
</dl>
</div>
<div class="section">
-<h4><a class="toc-backref" href="#id95" id="appearance" name="appearance">Appearance</a></h4>
+<h4><a class="toc-backref" href="#id96" id="appearance" name="appearance">Appearance</a></h4>
<dl class="docutils">
<dt>Icon Style</dt>
<dd>Select the toolbar icon style to use - either icons and text, just
@@ -1970,10 +1987,10 @@
</div>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id96" id="editor-features-tab-in-preferences-dialog" name="editor-features-tab-in-preferences-dialog">Editor Features tab in preferences dialog</a></h3>
+<h3><a class="toc-backref" href="#id97" id="editor-features-tab-in-preferences-dialog" name="editor-features-tab-in-preferences-dialog">Editor Features tab in preferences dialog</a></h3>
<img alt="./images/pref_dialog_edit_features.png" src="./images/pref_dialog_edit_features.png" />
<div class="section">
-<h4><a class="toc-backref" href="#id97" id="features" name="features">Features</a></h4>
+<h4><a class="toc-backref" href="#id98" id="features" name="features">Features</a></h4>
<dl class="docutils">
<dt>Line wrapping</dt>
<dd>Show long lines wrapped around to new display lines.</dd>
@@ -2005,10 +2022,10 @@
</div>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id98" id="editor-indentation-tab-in-preferences-dialog" name="editor-indentation-tab-in-preferences-dialog">Editor Indentation tab in preferences dialog</a></h3>
+<h3><a class="toc-backref" href="#id99" id="editor-indentation-tab-in-preferences-dialog" name="editor-indentation-tab-in-preferences-dialog">Editor Indentation tab in preferences dialog</a></h3>
<img alt="./images/pref_dialog_edit_indentation.png" src="./images/pref_dialog_edit_indentation.png" />
<div class="section">
-<h4><a class="toc-backref" href="#id99" id="indentation-group" name="indentation-group">Indentation group</a></h4>
+<h4><a class="toc-backref" href="#id100" id="indentation-group" name="indentation-group">Indentation group</a></h4>
<p>See <a class="reference" href="#indentation">Indentation</a> for more information.</p>
<dl class="docutils">
<dt>Type</dt>
@@ -2061,10 +2078,10 @@
</div>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id100" id="editor-completions-tab-in-preferences-dialog" name="editor-completions-tab-in-preferences-dialog">Editor Completions tab in preferences dialog</a></h3>
+<h3><a class="toc-backref" href="#id101" id="editor-completions-tab-in-preferences-dialog" name="editor-completions-tab-in-preferences-dialog">Editor Completions tab in preferences dialog</a></h3>
<img alt="./images/pref_dialog_edit_completions.png" src="./images/pref_dialog_edit_completions.png" />
<div class="section">
-<h4><a class="toc-backref" href="#id101" id="completions" name="completions">Completions</a></h4>
+<h4><a class="toc-backref" href="#id102" id="completions" name="completions">Completions</a></h4>
<dl class="docutils">
<dt>Snippet Completion</dt>
<dd>Whether to replace special keywords after typing Tab into a
@@ -2109,7 +2126,7 @@
</dl>
</div>
<div class="section">
-<h4><a class="toc-backref" href="#id102" id="auto-close-quotes-and-brackets" name="auto-close-quotes-and-brackets">Auto-close quotes and brackets</a></h4>
+<h4><a class="toc-backref" href="#id103" id="auto-close-quotes-and-brackets" name="auto-close-quotes-and-brackets">Auto-close quotes and brackets</a></h4>
<p>Geany can automatically insert a closing bracket and quote characters when
you open them. For instance, you type a <tt class="docutils literal"><span class="pre">(</span></tt> and Geany will automatically
insert <tt class="docutils literal"><span class="pre">)</span></tt>. With the following options, you can define for which
@@ -2129,11 +2146,11 @@
</div>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id103" id="editor-display-tab-in-preferences-dialog" name="editor-display-tab-in-preferences-dialog">Editor Display tab in preferences dialog</a></h3>
+<h3><a class="toc-backref" href="#id104" id="editor-display-tab-in-preferences-dialog" name="editor-display-tab-in-preferences-dialog">Editor Display tab in preferences dialog</a></h3>
<p>This is for visual elements displayed in the editor window.</p>
<img alt="./images/pref_dialog_edit_display.png" src="./images/pref_dialog_edit_display.png" />
<div class="section">
-<h4><a class="toc-backref" href="#id104" id="display" name="display">Display</a></h4>
+<h4><a class="toc-backref" href="#id105" id="display" name="display">Display</a></h4>
<dl class="docutils">
<dt>Invert syntax highlighting colors</dt>
<dd><p class="first">Use white text on a black background and invert all colors.
@@ -2162,7 +2179,7 @@
</dl>
</div>
<div class="section">
-<h4><a class="toc-backref" href="#id105" id="long-line-marker" name="long-line-marker">Long line marker</a></h4>
+<h4><a class="toc-backref" href="#id106" id="long-line-marker" name="long-line-marker">Long line marker</a></h4>
<p>The long line marker helps to indicate overly-long lines, or as a hint
to the user for when to break the line.</p>
<dl class="docutils">
@@ -2188,10 +2205,10 @@
</div>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id106" id="files-tab-in-preferences-dialog" name="files-tab-in-preferences-dialog">Files tab in preferences dialog</a></h3>
+<h3><a class="toc-backref" href="#id107" id="files-tab-in-preferences-dialog" name="files-tab-in-preferences-dialog">Files tab in preferences dialog</a></h3>
<img alt="./images/pref_dialog_files.png" src="./images/pref_dialog_files.png" />
<div class="section">
-<h4><a class="toc-backref" href="#id107" id="new-files" name="new-files">New files</a></h4>
+<h4><a class="toc-backref" href="#id108" id="new-files" name="new-files">New files</a></h4>
<dl class="docutils">
<dt>Open new documents from the command-line</dt>
<dd>Whether to create new documents when passing filenames that don't
@@ -2211,7 +2228,7 @@
</dl>
</div>
<div class="section">
-<h4><a class="toc-backref" href="#id108" id="saving-files" name="saving-files">Saving files</a></h4>
+<h4><a class="toc-backref" href="#id109" id="saving-files" name="saving-files">Saving files</a></h4>
<p>Perform special formatting operations when a document is saved. These
can each be undone with the Undo command as usual.</p>
<dl class="docutils">
@@ -2230,7 +2247,7 @@
</dl>
</div>
<div class="section">
-<h4><a class="toc-backref" href="#id109" id="id3" name="id3">Miscellaneous</a></h4>
+<h4><a class="toc-backref" href="#id110" id="id3" name="id3">Miscellaneous</a></h4>
<dl class="docutils">
<dt>Recent files list length</dt>
<dd>The number of files to remember in the recently used files list.</dd>
@@ -2249,13 +2266,11 @@
</div>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id110" id="tools-tab-in-preferences-dialog" name="tools-tab-in-preferences-dialog">Tools tab in preferences dialog</a></h3>
+<h3><a class="toc-backref" href="#id111" id="tools-tab-in-preferences-dialog" name="tools-tab-in-preferences-dialog">Tools tab in preferences dialog</a></h3>
<img alt="./images/pref_dialog_tools.png" src="./images/pref_dialog_tools.png" />
<div class="section">
-<h4><a class="toc-backref" href="#id111" id="tool-paths" name="tool-paths">Tool paths</a></h4>
+<h4><a class="toc-backref" href="#id112" id="tool-paths" name="tool-paths">Tool paths</a></h4>
<dl class="docutils">
-<dt>Make</dt>
-<dd>The location of the make executable.</dd>
<dt>Terminal</dt>
<dd>The location of your terminal executable.</dd>
<dt>Browser</dt>
@@ -2272,7 +2287,7 @@
</div>
</div>
<div class="section">
-<h4><a class="toc-backref" href="#id112" id="commands" name="commands">Commands</a></h4>
+<h4><a class="toc-backref" href="#id113" id="commands" name="commands">Commands</a></h4>
<dl class="docutils">
<dt>Context action</dt>
<dd>Set this to a command to execute on the current word.
@@ -2282,7 +2297,7 @@
</div>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id113" id="template-tab-in-preferences-dialog" name="template-tab-in-preferences-dialog">Template tab in preferences dialog</a></h3>
+<h3><a class="toc-backref" href="#id114" id="template-tab-in-preferences-dialog" name="template-tab-in-preferences-dialog">Template tab in preferences dialog</a></h3>
<p>This data is used as meta data for various template text to insert into
a document, such as the file header. You only need to set fields that
you want to use in your template files.</p>
@@ -2292,7 +2307,7 @@
</div>
<img alt="./images/pref_dialog_templ.png" src="./images/pref_dialog_templ.png" />
<div class="section">
-<h4><a class="toc-backref" href="#id114" id="template-data" name="template-data">Template data</a></h4>
+<h4><a class="toc-backref" href="#id115" id="template-data" name="template-data">Template data</a></h4>
<dl class="docutils">
<dt>Developer</dt>
<dd>The name of the developer who will be creating files.</dd>
@@ -2325,7 +2340,7 @@
</div>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id115" id="keybinding-tab-in-preferences-dialog" name="keybinding-tab-in-preferences-dialog">Keybinding tab in preferences dialog</a></h3>
+<h3><a class="toc-backref" href="#id116" id="keybinding-tab-in-preferences-dialog" name="keybinding-tab-in-preferences-dialog">Keybinding tab in preferences dialog</a></h3>
<img alt="./images/pref_dialog_keys.png" src="./images/pref_dialog_keys.png" />
<p>There are some handy commands in here that are not, by default,
bound to a key combination, and may not be available as a menu item.</p>
@@ -2335,7 +2350,7 @@
</div>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id116" id="printing-tab-in-preferences-dialog" name="printing-tab-in-preferences-dialog">Printing tab in preferences dialog</a></h3>
+<h3><a class="toc-backref" href="#id117" id="printing-tab-in-preferences-dialog" name="printing-tab-in-preferences-dialog">Printing tab in preferences dialog</a></h3>
<img alt="./images/pref_dialog_printing.png" src="./images/pref_dialog_printing.png" />
<dl class="docutils">
<dt>Use external command for printing</dt>
@@ -2357,11 +2372,11 @@
</dl>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id117" id="terminal-vte-tab-in-preferences-dialog" name="terminal-vte-tab-in-preferences-dialog">Terminal (VTE) tab in preferences dialog</a></h3>
+<h3><a class="toc-backref" href="#id118" id="terminal-vte-tab-in-preferences-dialog" name="terminal-vte-tab-in-preferences-dialog">Terminal (VTE) tab in preferences dialog</a></h3>
<p>See also: <a class="reference" href="#virtual-terminal-emulator-widget-vte">Virtual terminal emulator widget (VTE)</a>.</p>
<img alt="./images/pref_dialog_vte.png" src="./images/pref_dialog_vte.png" />
<div class="section">
-<h4><a class="toc-backref" href="#id118" id="terminal-widget" name="terminal-widget">Terminal widget</a></h4>
+<h4><a class="toc-backref" href="#id119" id="terminal-widget" name="terminal-widget">Terminal widget</a></h4>
<dl class="docutils">
<dt>Terminal font</dt>
<dd>Select the font that will be used in the terminal emulation control.</dd>
@@ -2388,7 +2403,8 @@
current file.</dd>
<dt>Execute programs in VTE</dt>
<dd>Execute programs in the virtual terminal instead of using the external
-terminal tool.</dd>
+terminal tool. Note that if you run multiple execute commands at once
+the output may become mixed together in the VTE.</dd>
<dt>Don't use run script</dt>
<dd>Don't use the simple run script which is usually used to display
the exit status of the executed program.
@@ -2399,25 +2415,24 @@
</div>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id119" id="project-management" name="project-management">Project Management</a></h2>
+<h2><a class="toc-backref" href="#id120" id="project-management" name="project-management">Project Management</a></h2>
<p>Project Management is optional in Geany. Currently it can be used for:</p>
<ul class="simple">
<li>Storing and opening session files on a project basis.</li>
-<li>Running <em>Make</em> from the project's base directory.</li>
-<li>Setting a custom <em>Run</em> command specific to the project.</li>
+<li>Configuring the Build menu on a project basis.</li>
</ul>
<p>A list of session files can be stored and opened with the project
when the <em>Use project-based session files</em> preference is enabled,
in the <em>Project</em> group of the <a class="reference" href="#preferences">Preferences</a> dialog.</p>
-<p>As long as a project is open, the Make and Run commands will use
-the project's settings, instead of the defaults. These will be used
-whichever document is currently displayed.</p>
+<p>As long as a project is open, the Build menu will use
+the items defined in project's settings, instead of the defaults.
+See <cite>Build Menu Configuration</cite> for information on configuring the menu.</p>
<p>The current project's settings are saved when it is closed, or when
Geany is shutdown. When restarting Geany, the previously opened project
file that was in use at the end of the last session will be reopened.</p>
-<p>Below are the commands used to create, modify, open and close projects.</p>
+<p>The project menu items are detailed below.</p>
<div class="section">
-<h3><a class="toc-backref" href="#id120" id="new-project" name="new-project">New Project</a></h3>
+<h3><a class="toc-backref" href="#id121" id="new-project" name="new-project">New Project</a></h3>
<p>To create a new project, fill in the <em>Name</em> field. By default this
will setup a new project file <tt class="docutils literal"><span class="pre">~/projects/name.geany</span></tt>. Usually it's
best to store all your project files in the same directory (they are
@@ -2427,31 +2442,21 @@
structure contained in it.</p>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id121" id="project-properties" name="project-properties">Project Properties</a></h3>
+<h3><a class="toc-backref" href="#id122" id="project-properties" name="project-properties">Project Properties</a></h3>
<p>You can set an optional description for the project, but it is not
used elsewhere by Geany.</p>
-<p>The <em>Base path</em> field is used as the directory to run the Make and Make
-custom commands in. It is also used as working directory for the project
-specific <em>Run command</em>.
-The specified path can be an absolute path or relative to the project's
-file name.</p>
+<p>The <em>Base path</em> field is used as the directory to run the Build menu commands.
+The specified path can be an absolute path or it is considered to be
+relative to the project's file name.</p>
<div class="section">
-<h4><a class="toc-backref" href="#id122" id="make-in-base-path" name="make-in-base-path">Make in base path</a></h4>
-<p>This setting makes the <em>Build->Make</em> command use the project's base
-path. Uncheck this if you want to use the current file's directory
-instead.</p>
+<h4><a class="toc-backref" href="#id123" id="set-base-path-button" name="set-base-path-button">Set Base Path Button</a></h4>
+<p>This button is a convenience to set the working directory fields
+in the non-filetype Build menu items to %p to use the project base path.</p>
+<div class="note">
+<p class="first admonition-title">Note</p>
+<p class="last">Pressing the 'set' button will overright any working directories
+you have configured for the project.</p>
</div>
-<div class="section">
-<h4><a class="toc-backref" href="#id123" id="run-command" name="run-command">Run command</a></h4>
-<p>The <em>Run command</em> overrides the default run command. You can set this
-to the executable or main script file for the project, and append
-any command-line arguments.</p>
-<p>The following variables can be used:</p>
-<ul class="simple">
-<li>%f -- complete filename without path</li>
-<li>%e -- filename without path and without extension</li>
-</ul>
-<p>See <a class="reference" href="#build-settings-section">[build_settings] Section</a> for details.</p>
</div>
</div>
<div class="section">
@@ -2470,24 +2475,42 @@
</div>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id126" id="build-system" name="build-system">Build system</a></h2>
-<p>Geany has an integrated build system. Firstly this means that the
-current source file will be saved before it is processed. This is
-for convenience so that you don't need to keep saving small changes
-to the current file before building.</p>
-<p>Secondly the output for Compile, Build and Make actions will be captured
-in the Compiler notebook tab of the messages window. If there are
-any warnings or errors with line numbers shown in red in the Compiler
-output tab, you can click on them and Geany will switch to the relevant
-source file (or open it) and mark the line number so the problem can be
-corrected. Geany will also set indicators for warnings or errors with
-line numbers.</p>
+<h2><a class="toc-backref" href="#id126" id="build-menu" name="build-menu">Build Menu</a></h2>
+<p>After editing code with Geany, the next step is to compile, link, build,
+interpret, run etc. As Geany supports many languages each with a different
+approach to such operations, and as there are also many language independant
+software building systems, Geany does not have a built in build system, nor
+does it limit which system you can use. Instead the build menu provides
+a configurable and flexible means of running any external commands.</p>
+<p>This section provides a description of the default configuration of the
+build menu and then covers how to configure it, and where the defaults fit in.</p>
+<p>Running the commands from within Geany has two benefits:</p>
+<ul class="simple">
+<li>the current file is automatically saved before the command is run</li>
+<li>the output is captured in the Compiler notebook tab and parsed for
+warnings or errors</li>
+</ul>
+<p>Warnings and errors that can be parsed for line numbers will be shown in
+red in the Compiler tab and you can click on them to switch to the relevant
+source file (or open it) and mark the line number. Also lines with
+warnings or errors are marked in the source, see <a class="reference" href="#indicators">Indicators</a> below.</p>
<div class="tip">
<p class="first admonition-title">Tip</p>
<p class="last">If Geany's default error message parsing does not parse errors for
-the tool you're using, you can set a custom regex. See <a class="reference" href="#filetype-definition-files">Filetype
-definition files</a> and the <a class="reference" href="#build-settings-section">[build_settings] Section</a>.</p>
+the tool you're using, you can set a custom regex in the Build Commands
+Dialog, see <cite>Build Menu Configuration</cite></p>
</div>
+<div class="section">
+<h3><a class="toc-backref" href="#id127" id="indicators" name="indicators">Indicators</a></h3>
+<p>Indicators are red squiggly underlines which are used to highlight
+errors which occurred while compiling the current file. So you can
+easily see where your code failed to compile. To remove the indicators,
+just select "Remove all indicators" in the document file menu.</p>
+<p>If you do not like this feature, you can disable it in the preferences
+dialog.</p>
+</div>
+<div class="section">
+<h3><a class="toc-backref" href="#id128" id="default-build-menu-items" name="default-build-menu-items">Default Build Menu Items</a></h3>
<p>Depending on the current file's filetype, the Build menu will contain
the following items:</p>
<ul class="simple">
@@ -2496,21 +2519,23 @@
<li>Make All</li>
<li>Make Custom Target</li>
<li>Make Object</li>
+<li>Next Error</li>
+<li>Previous Error</li>
<li>Execute</li>
-<li>Set Includes and Arguments</li>
+<li>Set Build Menu Commands</li>
</ul>
<div class="section">
-<h3><a class="toc-backref" href="#id127" id="compile" name="compile">Compile</a></h3>
+<h4><a class="toc-backref" href="#id129" id="compile" name="compile">Compile</a></h4>
<p>The Compile command has different uses for different kinds of files.</p>
<p>For compilable languages such as C and C++, the Compile command is
setup to compile the current source file into a binary object file.</p>
-<p>Java source files will be compiled to class file bytecode. Interpreted
-languages such as Perl, Python, Ruby will compile to bytecode if the
-language supports it, or will run a syntax check, or failing that
-will run the file in its language interpreter.</p>
+<p>Java source files will be compiled to class file bytecode.</p>
+<p>Interpreted languages such as Perl, Python, Ruby will compile to
+bytecode if the language supports it, or will run a syntax check,
+or if that is not available will run the file in its language interpreter.</p>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id128" id="build" name="build">Build</a></h3>
+<h4><a class="toc-backref" href="#id130" id="build" name="build">Build</a></h4>
<p>For compilable languages such as C and C++, the Build command will link
@@ Diff output truncated at 100000 characters. @@
This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.
More information about the Commits
mailing list