Revision: 2912 http://geany.svn.sourceforge.net/geany/?rev=2912&view=rev Author: ntrel Date: 2008-08-29 12:33:44 +0000 (Fri, 29 Aug 2008)
Log Message: ----------- Separate runtime requirements and build requirements subsections. Mention that usually building GTK manually is not necessary. Run 'make install' as root. Add some subsection titles.
Modified Paths: -------------- trunk/ChangeLog trunk/doc/geany.html trunk/doc/geany.txt
Modified: trunk/ChangeLog =================================================================== --- trunk/ChangeLog 2008-08-28 16:59:20 UTC (rev 2911) +++ trunk/ChangeLog 2008-08-29 12:33:44 UTC (rev 2912) @@ -1,3 +1,12 @@ +2008-08-29 Nick Treleaven <nick(dot)treleaven(at)btinternet(dot)com> + + * doc/geany.txt, doc/geany.html: + Separate runtime requirements and build requirements subsections. + Mention that usually building GTK manually is not necessary. + Run 'make install' as root. + Add some subsection titles. + + 2008-08-28 Nick Treleaven <nick(dot)treleaven(at)btinternet(dot)com>
* src/symbols.c:
Modified: trunk/doc/geany.html =================================================================== --- trunk/doc/geany.html 2008-08-28 16:59:20 UTC (rev 2911) +++ trunk/doc/geany.html 2008-08-29 12:33:44 UTC (rev 2912) @@ -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="2008-08-14" /> +<meta name="date" content="2008-08-27" /> <style type="text/css">
/* @@ -139,7 +139,7 @@ <br />Nick Treleaven <br />Frank Lanitz</td></tr> <tr><th class="docinfo-name">Date:</th> -<td>2008-08-14</td></tr> +<td>2008-08-27</td></tr> <tr><th class="docinfo-name">Version:</th> <td>0.15</td></tr> </tbody> @@ -162,225 +162,231 @@ </li> <li><a class="reference" href="#installation" id="id14" name="id14">Installation</a><ul> <li><a class="reference" href="#requirements" id="id15" name="id15">Requirements</a></li> -<li><a class="reference" href="#source-compilation" id="id16" name="id16">Source compilation</a></li> -<li><a class="reference" href="#binary-packages" id="id17" name="id17">Binary packages</a></li> +<li><a class="reference" href="#binary-packages" id="id16" name="id16">Binary packages</a></li> +<li><a class="reference" href="#source-compilation" id="id17" name="id17">Source compilation</a><ul> +<li><a class="reference" href="#custom-installation" id="id18" name="id18">Custom installation</a></li> +<li><a class="reference" href="#dynamic-linking-loader-support" id="id19" name="id19">Dynamic linking loader support</a></li> +<li><a class="reference" href="#supported-systems" id="id20" name="id20">Supported systems</a></li> +<li><a class="reference" href="#build-problems" id="id21" name="id21">Build problems</a></li> </ul> </li> -<li><a class="reference" href="#usage" id="id18" name="id18">Usage</a><ul> -<li><a class="reference" href="#getting-started" id="id19" name="id19">Getting started</a></li> -<li><a class="reference" href="#command-line-options" id="id20" name="id20">Command line options</a></li> -<li><a class="reference" href="#general" id="id21" name="id21">General</a><ul> -<li><a class="reference" href="#startup" id="id22" name="id22">Startup</a></li> -<li><a class="reference" href="#opening-files-from-the-command-line-in-a-running-instance" id="id23" name="id23">Opening files from the command-line in a running instance</a></li> -<li><a class="reference" href="#virtual-terminal-emulator-widget-vte" id="id24" name="id24">Virtual terminal emulator widget (VTE)</a></li> -<li><a class="reference" href="#defining-own-widget-styles-using-gtkrc-2-0" id="id25" name="id25">Defining own widget styles using .gtkrc-2.0</a></li> </ul> </li> -<li><a class="reference" href="#documents" id="id26" name="id26">Documents</a><ul> -<li><a class="reference" href="#switching-between-documents" id="id27" name="id27">Switching between documents</a></li> +<li><a class="reference" href="#usage" id="id22" name="id22">Usage</a><ul> +<li><a class="reference" href="#getting-started" id="id23" name="id23">Getting started</a></li> +<li><a class="reference" href="#command-line-options" id="id24" name="id24">Command line options</a></li> +<li><a class="reference" href="#general" id="id25" name="id25">General</a><ul> +<li><a class="reference" href="#startup" id="id26" name="id26">Startup</a></li> +<li><a class="reference" href="#opening-files-from-the-command-line-in-a-running-instance" id="id27" name="id27">Opening files from the command-line in a running instance</a></li> +<li><a class="reference" href="#virtual-terminal-emulator-widget-vte" id="id28" name="id28">Virtual terminal emulator widget (VTE)</a></li> +<li><a class="reference" href="#defining-own-widget-styles-using-gtkrc-2-0" id="id29" name="id29">Defining own widget styles using .gtkrc-2.0</a></li> </ul> </li> -<li><a class="reference" href="#character-sets-and-unicode-byte-order-mark-bom" id="id28" name="id28">Character sets and Unicode Byte-Order-Mark (BOM)</a><ul> -<li><a class="reference" href="#using-character-sets" id="id29" name="id29">Using character sets</a></li> -<li><a class="reference" href="#in-file-encoding-specification" id="id30" name="id30">In-file encoding specification</a></li> -<li><a class="reference" href="#special-encoding-none" id="id31" name="id31">Special encoding "None"</a></li> -<li><a class="reference" href="#unicode-byte-order-mark-bom" id="id32" name="id32">Unicode Byte-Order-Mark (BOM)</a></li> +<li><a class="reference" href="#documents" id="id30" name="id30">Documents</a><ul> +<li><a class="reference" href="#switching-between-documents" id="id31" name="id31">Switching between documents</a></li> </ul> </li> -<li><a class="reference" href="#editing" id="id33" name="id33">Editing</a><ul> -<li><a class="reference" href="#folding" id="id34" name="id34">Folding</a></li> -<li><a class="reference" href="#column-mode-editing" id="id35" name="id35">Column mode editing</a></li> -<li><a class="reference" href="#drag-and-drop-of-text" id="id36" name="id36">Drag and drop of text</a></li> -<li><a class="reference" href="#indentation" id="id37" name="id37">Indentation</a></li> -<li><a class="reference" href="#auto-indentation" id="id38" name="id38">Auto-indentation</a></li> -<li><a class="reference" href="#bookmarks" id="id39" name="id39">Bookmarks</a></li> -<li><a class="reference" href="#code-navigation-history" id="id40" name="id40">Code Navigation History</a></li> -<li><a class="reference" href="#send-text-through-definable-commands" id="id41" name="id41">Send text through definable commands</a></li> -<li><a class="reference" href="#context-actions" id="id42" name="id42">Context actions</a></li> -<li><a class="reference" href="#user-definable-snippets" id="id43" name="id43">User-definable snippets</a></li> -<li><a class="reference" href="#inserting-unicode-characters" id="id44" name="id44">Inserting unicode characters</a></li> +<li><a class="reference" href="#character-sets-and-unicode-byte-order-mark-bom" id="id32" name="id32">Character sets and Unicode Byte-Order-Mark (BOM)</a><ul> +<li><a class="reference" href="#using-character-sets" id="id33" name="id33">Using character sets</a></li> +<li><a class="reference" href="#in-file-encoding-specification" id="id34" name="id34">In-file encoding specification</a></li> +<li><a class="reference" href="#special-encoding-none" id="id35" name="id35">Special encoding "None"</a></li> +<li><a class="reference" href="#unicode-byte-order-mark-bom" id="id36" name="id36">Unicode Byte-Order-Mark (BOM)</a></li> </ul> </li> -<li><a class="reference" href="#search-replace-and-go-to" id="id45" name="id45">Search, replace and go to</a><ul> -<li><a class="reference" href="#find" id="id46" name="id46">Find</a><ul> -<li><a class="reference" href="#matching-options" id="id47" name="id47">Matching options</a></li> -<li><a class="reference" href="#find-all" id="id48" name="id48">Find all</a></li> -<li><a class="reference" href="#change-font-in-search-dialog-text-fields" id="id49" name="id49">Change font in search dialog text fields</a></li> +<li><a class="reference" href="#editing" id="id37" name="id37">Editing</a><ul> +<li><a class="reference" href="#folding" id="id38" name="id38">Folding</a></li> +<li><a class="reference" href="#column-mode-editing" id="id39" name="id39">Column mode editing</a></li> +<li><a class="reference" href="#drag-and-drop-of-text" id="id40" name="id40">Drag and drop of text</a></li> +<li><a class="reference" href="#indentation" id="id41" name="id41">Indentation</a></li> +<li><a class="reference" href="#auto-indentation" id="id42" name="id42">Auto-indentation</a></li> +<li><a class="reference" href="#bookmarks" id="id43" name="id43">Bookmarks</a></li> +<li><a class="reference" href="#code-navigation-history" id="id44" name="id44">Code Navigation History</a></li> +<li><a class="reference" href="#send-text-through-definable-commands" id="id45" name="id45">Send text through definable commands</a></li> +<li><a class="reference" href="#context-actions" id="id46" name="id46">Context actions</a></li> +<li><a class="reference" href="#user-definable-snippets" id="id47" name="id47">User-definable snippets</a></li> +<li><a class="reference" href="#inserting-unicode-characters" id="id48" name="id48">Inserting unicode characters</a></li> </ul> </li> -<li><a class="reference" href="#find-usage" id="id50" name="id50">Find usage</a></li> -<li><a class="reference" href="#find-in-files" id="id51" name="id51">Find in files</a><ul> -<li><a class="reference" href="#filtering-out-version-control-files" id="id52" name="id52">Filtering out version control files</a></li> +<li><a class="reference" href="#search-replace-and-go-to" id="id49" name="id49">Search, replace and go to</a><ul> +<li><a class="reference" href="#find" id="id50" name="id50">Find</a><ul> +<li><a class="reference" href="#matching-options" id="id51" name="id51">Matching options</a></li> +<li><a class="reference" href="#find-all" id="id52" name="id52">Find all</a></li> +<li><a class="reference" href="#change-font-in-search-dialog-text-fields" id="id53" name="id53">Change font in search dialog text fields</a></li> </ul> </li> -<li><a class="reference" href="#replace" id="id53" name="id53">Replace</a><ul> -<li><a class="reference" href="#replace-all" id="id54" name="id54">Replace all</a></li> +<li><a class="reference" href="#find-usage" id="id54" name="id54">Find usage</a></li> +<li><a class="reference" href="#find-in-files" id="id55" name="id55">Find in files</a><ul> +<li><a class="reference" href="#filtering-out-version-control-files" id="id56" name="id56">Filtering out version control files</a></li> </ul> </li> -<li><a class="reference" href="#go-to-tag-definition" id="id55" name="id55">Go to tag definition</a></li> -<li><a class="reference" href="#go-to-tag-declaration" id="id56" name="id56">Go to tag declaration</a></li> -<li><a class="reference" href="#go-to-line" id="id57" name="id57">Go to line</a></li> -<li><a class="reference" href="#regular-expressions" id="id58" name="id58">Regular expressions</a><ul> -<li><a class="reference" href="#partial-posix-compatibility" id="id59" name="id59">Partial POSIX compatibility</a></li> +<li><a class="reference" href="#replace" id="id57" name="id57">Replace</a><ul> +<li><a class="reference" href="#replace-all" id="id58" name="id58">Replace all</a></li> </ul> </li> +<li><a class="reference" href="#go-to-tag-definition" id="id59" name="id59">Go to tag definition</a></li> +<li><a class="reference" href="#go-to-tag-declaration" id="id60" name="id60">Go to tag declaration</a></li> +<li><a class="reference" href="#go-to-line" id="id61" name="id61">Go to line</a></li> +<li><a class="reference" href="#regular-expressions" id="id62" name="id62">Regular expressions</a><ul> +<li><a class="reference" href="#partial-posix-compatibility" id="id63" name="id63">Partial POSIX compatibility</a></li> </ul> </li> -<li><a class="reference" href="#tags" id="id60" name="id60">Tags</a><ul> -<li><a class="reference" href="#workspace-tags" id="id61" name="id61">Workspace tags</a></li> -<li><a class="reference" href="#global-tags" id="id62" name="id62">Global tags</a><ul> -<li><a class="reference" href="#default-global-tags-files" id="id63" name="id63">Default global tags files</a></li> -<li><a class="reference" href="#generating-a-global-tags-file" id="id64" name="id64">Generating a global tags file</a></li> </ul> </li> -<li><a class="reference" href="#ignore-tags" id="id65" name="id65">Ignore tags</a></li> +<li><a class="reference" href="#tags" id="id64" name="id64">Tags</a><ul> +<li><a class="reference" href="#workspace-tags" id="id65" name="id65">Workspace tags</a></li> +<li><a class="reference" href="#global-tags" id="id66" name="id66">Global tags</a><ul> +<li><a class="reference" href="#default-global-tags-files" id="id67" name="id67">Default global tags files</a></li> +<li><a class="reference" href="#generating-a-global-tags-file" id="id68" name="id68">Generating a global tags file</a></li> </ul> </li> -<li><a class="reference" href="#preferences" id="id66" name="id66">Preferences</a><ul> -<li><a class="reference" href="#general-tab-in-preferences-dialog" id="id67" name="id67">General tab in preferences dialog</a><ul> -<li><a class="reference" href="#id1" id="id68" name="id68">Startup</a></li> -<li><a class="reference" href="#shutdown" id="id69" name="id69">Shutdown</a></li> -<li><a class="reference" href="#projects" id="id70" name="id70">Projects</a></li> -<li><a class="reference" href="#miscellaneous" id="id71" name="id71">Miscellaneous</a></li> +<li><a class="reference" href="#ignore-tags" id="id69" name="id69">Ignore tags</a></li> </ul> </li> -<li><a class="reference" href="#interface-tab-in-preferences-dialog" id="id72" name="id72">Interface tab in preferences dialog</a><ul> -<li><a class="reference" href="#sidebar" id="id73" name="id73">Sidebar</a></li> -<li><a class="reference" href="#fonts" id="id74" name="id74">Fonts</a></li> -<li><a class="reference" href="#editor-tabs" id="id75" name="id75">Editor tabs</a></li> -<li><a class="reference" href="#tab-positions" id="id76" name="id76">Tab positions</a></li> -<li><a class="reference" href="#id2" id="id77" name="id77">Miscellaneous</a></li> +<li><a class="reference" href="#preferences" id="id70" name="id70">Preferences</a><ul> +<li><a class="reference" href="#general-tab-in-preferences-dialog" id="id71" name="id71">General tab in preferences dialog</a><ul> +<li><a class="reference" href="#id1" id="id72" name="id72">Startup</a></li> +<li><a class="reference" href="#shutdown" id="id73" name="id73">Shutdown</a></li> +<li><a class="reference" href="#projects" id="id74" name="id74">Projects</a></li> +<li><a class="reference" href="#miscellaneous" id="id75" name="id75">Miscellaneous</a></li> </ul> </li> -<li><a class="reference" href="#toolbar-tab-in-preferences-dialog" id="id78" name="id78">Toolbar tab in preferences dialog</a><ul> -<li><a class="reference" href="#toolbar" id="id79" name="id79">Toolbar</a></li> -<li><a class="reference" href="#items" id="id80" name="id80">Items</a></li> -<li><a class="reference" href="#appearance" id="id81" name="id81">Appearance</a></li> +<li><a class="reference" href="#interface-tab-in-preferences-dialog" id="id76" name="id76">Interface tab in preferences dialog</a><ul> +<li><a class="reference" href="#sidebar" id="id77" name="id77">Sidebar</a></li> +<li><a class="reference" href="#fonts" id="id78" name="id78">Fonts</a></li> +<li><a class="reference" href="#editor-tabs" id="id79" name="id79">Editor tabs</a></li> +<li><a class="reference" href="#tab-positions" id="id80" name="id80">Tab positions</a></li> +<li><a class="reference" href="#id2" id="id81" name="id81">Miscellaneous</a></li> </ul> </li> -<li><a class="reference" href="#editor-features-tab-in-preferences-dialog" id="id82" name="id82">Editor Features tab in preferences dialog</a><ul> -<li><a class="reference" href="#indentation-group" id="id83" name="id83">Indentation group</a></li> -<li><a class="reference" href="#features" id="id84" name="id84">Features</a></li> +<li><a class="reference" href="#toolbar-tab-in-preferences-dialog" id="id82" name="id82">Toolbar tab in preferences dialog</a><ul> +<li><a class="reference" href="#toolbar" id="id83" name="id83">Toolbar</a></li> +<li><a class="reference" href="#items" id="id84" name="id84">Items</a></li> +<li><a class="reference" href="#appearance" id="id85" name="id85">Appearance</a></li> </ul> </li> -<li><a class="reference" href="#editor-completions-tab-in-preferences-dialog" id="id85" name="id85">Editor Completions tab in preferences dialog</a></li> -<li><a class="reference" href="#editor-display-tab-in-preferences-dialog" id="id86" name="id86">Editor Display tab in preferences dialog</a><ul> -<li><a class="reference" href="#display" id="id87" name="id87">Display</a></li> -<li><a class="reference" href="#long-line-marker" id="id88" name="id88">Long line marker</a></li> +<li><a class="reference" href="#editor-features-tab-in-preferences-dialog" id="id86" name="id86">Editor Features tab in preferences dialog</a><ul> +<li><a class="reference" href="#indentation-group" id="id87" name="id87">Indentation group</a></li> +<li><a class="reference" href="#features" id="id88" name="id88">Features</a></li> </ul> </li> -<li><a class="reference" href="#files-tab-in-preferences-dialog" id="id89" name="id89">Files tab in preferences dialog</a><ul> -<li><a class="reference" href="#new-files" id="id90" name="id90">New files</a></li> -<li><a class="reference" href="#saving-files" id="id91" name="id91">Saving files</a></li> -<li><a class="reference" href="#id3" id="id92" name="id92">Miscellaneous</a></li> +<li><a class="reference" href="#editor-completions-tab-in-preferences-dialog" id="id89" name="id89">Editor Completions tab in preferences dialog</a></li> +<li><a class="reference" href="#editor-display-tab-in-preferences-dialog" id="id90" name="id90">Editor Display tab in preferences dialog</a><ul> +<li><a class="reference" href="#display" id="id91" name="id91">Display</a></li> +<li><a class="reference" href="#long-line-marker" id="id92" name="id92">Long line marker</a></li> </ul> </li> -<li><a class="reference" href="#tools-tab-in-preferences-dialog" id="id93" name="id93">Tools tab in preferences dialog</a><ul> -<li><a class="reference" href="#tool-paths" id="id94" name="id94">Tool paths</a></li> -<li><a class="reference" href="#commands" id="id95" name="id95">Commands</a></li> +<li><a class="reference" href="#files-tab-in-preferences-dialog" id="id93" name="id93">Files tab in preferences dialog</a><ul> +<li><a class="reference" href="#new-files" id="id94" name="id94">New files</a></li> +<li><a class="reference" href="#saving-files" id="id95" name="id95">Saving files</a></li> +<li><a class="reference" href="#id3" id="id96" name="id96">Miscellaneous</a></li> </ul> </li> -<li><a class="reference" href="#template-tab-in-preferences-dialog" id="id96" name="id96">Template tab in preferences dialog</a><ul> -<li><a class="reference" href="#template-data" id="id97" name="id97">Template data</a></li> +<li><a class="reference" href="#tools-tab-in-preferences-dialog" id="id97" name="id97">Tools tab in preferences dialog</a><ul> +<li><a class="reference" href="#tool-paths" id="id98" name="id98">Tool paths</a></li> +<li><a class="reference" href="#commands" id="id99" name="id99">Commands</a></li> </ul> </li> -<li><a class="reference" href="#keybinding-tab-in-preferences-dialog" id="id98" name="id98">Keybinding tab in preferences dialog</a></li> -<li><a class="reference" href="#printing-tab-in-preferences-dialog" id="id99" name="id99">Printing tab in preferences dialog</a></li> -<li><a class="reference" href="#vte-tab-in-preferences-dialog" id="id100" name="id100">VTE tab in preferences dialog</a><ul> -<li><a class="reference" href="#terminal-widget" id="id101" name="id101">Terminal widget</a></li> +<li><a class="reference" href="#template-tab-in-preferences-dialog" id="id100" name="id100">Template tab in preferences dialog</a><ul> +<li><a class="reference" href="#template-data" id="id101" name="id101">Template data</a></li> </ul> </li> +<li><a class="reference" href="#keybinding-tab-in-preferences-dialog" id="id102" name="id102">Keybinding tab in preferences dialog</a></li> +<li><a class="reference" href="#printing-tab-in-preferences-dialog" id="id103" name="id103">Printing tab in preferences dialog</a></li> +<li><a class="reference" href="#vte-tab-in-preferences-dialog" id="id104" name="id104">VTE tab in preferences dialog</a><ul> +<li><a class="reference" href="#terminal-widget" id="id105" name="id105">Terminal widget</a></li> </ul> </li> -<li><a class="reference" href="#project-management" id="id102" name="id102">Project Management</a><ul> -<li><a class="reference" href="#new-project" id="id103" name="id103">New Project</a></li> -<li><a class="reference" href="#project-properties" id="id104" name="id104">Project Properties</a><ul> -<li><a class="reference" href="#make-in-base-path" id="id105" name="id105">Make in base path</a></li> -<li><a class="reference" href="#run-command" id="id106" name="id106">Run command</a></li> </ul> </li> -<li><a class="reference" href="#open-project" id="id107" name="id107">Open Project</a></li> -<li><a class="reference" href="#close-project" id="id108" name="id108">Close Project</a></li> +<li><a class="reference" href="#project-management" id="id106" name="id106">Project Management</a><ul> +<li><a class="reference" href="#new-project" id="id107" name="id107">New Project</a></li> +<li><a class="reference" href="#project-properties" id="id108" name="id108">Project Properties</a><ul> +<li><a class="reference" href="#make-in-base-path" id="id109" name="id109">Make in base path</a></li> +<li><a class="reference" href="#run-command" id="id110" name="id110">Run command</a></li> </ul> </li> -<li><a class="reference" href="#build-system" id="id109" name="id109">Build system</a><ul> -<li><a class="reference" href="#compile" id="id110" name="id110">Compile</a></li> -<li><a class="reference" href="#build" id="id111" name="id111">Build</a></li> -<li><a class="reference" href="#make-all" id="id112" name="id112">Make all</a></li> -<li><a class="reference" href="#make-custom-target" id="id113" name="id113">Make custom target</a></li> -<li><a class="reference" href="#make-object" id="id114" name="id114">Make object</a></li> -<li><a class="reference" href="#execute" id="id115" name="id115">Execute</a></li> -<li><a class="reference" href="#stopping-running-processes" id="id116" name="id116">Stopping running processes</a><ul> -<li><a class="reference" href="#terminal-emulators" id="id117" name="id117">Terminal emulators</a></li> +<li><a class="reference" href="#open-project" id="id111" name="id111">Open Project</a></li> +<li><a class="reference" href="#close-project" id="id112" name="id112">Close Project</a></li> </ul> </li> -<li><a class="reference" href="#set-includes-and-arguments" id="id118" name="id118">Set Includes and Arguments</a><ul> -<li><a class="reference" href="#one-step-compilation" id="id119" name="id119">One step compilation</a></li> +<li><a class="reference" href="#build-system" id="id113" name="id113">Build system</a><ul> +<li><a class="reference" href="#compile" id="id114" name="id114">Compile</a></li> +<li><a class="reference" href="#build" id="id115" name="id115">Build</a></li> +<li><a class="reference" href="#make-all" id="id116" name="id116">Make all</a></li> +<li><a class="reference" href="#make-custom-target" id="id117" name="id117">Make custom target</a></li> +<li><a class="reference" href="#make-object" id="id118" name="id118">Make object</a></li> +<li><a class="reference" href="#execute" id="id119" name="id119">Execute</a></li> +<li><a class="reference" href="#stopping-running-processes" id="id120" name="id120">Stopping running processes</a><ul> +<li><a class="reference" href="#terminal-emulators" id="id121" name="id121">Terminal emulators</a></li> </ul> </li> -<li><a class="reference" href="#indicators" id="id120" name="id120">Indicators</a></li> +<li><a class="reference" href="#set-includes-and-arguments" id="id122" name="id122">Set Includes and Arguments</a><ul> +<li><a class="reference" href="#one-step-compilation" id="id123" name="id123">One step compilation</a></li> </ul> </li> -<li><a class="reference" href="#printing-support" id="id121" name="id121">Printing support</a></li> -<li><a class="reference" href="#plugins" id="id122" name="id122">Plugins</a></li> -<li><a class="reference" href="#keybindings" id="id123" name="id123">Keybindings</a><ul> -<li><a class="reference" href="#switching-documents" id="id124" name="id124">Switching documents</a></li> -<li><a class="reference" href="#configurable-keybindings" id="id125" name="id125">Configurable keybindings</a></li> +<li><a class="reference" href="#indicators" id="id124" name="id124">Indicators</a></li> </ul> </li> +<li><a class="reference" href="#printing-support" id="id125" name="id125">Printing support</a></li> +<li><a class="reference" href="#plugins" id="id126" name="id126">Plugins</a></li> +<li><a class="reference" href="#keybindings" id="id127" name="id127">Keybindings</a><ul> +<li><a class="reference" href="#switching-documents" id="id128" name="id128">Switching documents</a></li> +<li><a class="reference" href="#configurable-keybindings" id="id129" name="id129">Configurable keybindings</a></li> </ul> </li> -<li><a class="reference" href="#configuration-files" id="id126" name="id126">Configuration files</a><ul> -<li><a class="reference" href="#global-configuration-file" id="id127" name="id127">Global configuration file</a></li> -<li><a class="reference" href="#filetype-definition-files" id="id128" name="id128">Filetype definition files</a><ul> -<li><a class="reference" href="#format" id="id129" name="id129">Format</a><ul> -<li><a class="reference" href="#styling-section" id="id130" name="id130">[styling] Section</a></li> -<li><a class="reference" href="#keywords-section" id="id131" name="id131">[keywords] Section</a></li> -<li><a class="reference" href="#settings-section" id="id132" name="id132">[settings] Section</a></li> -<li><a class="reference" href="#build-settings-section" id="id133" name="id133">[build_settings] Section</a></li> </ul> </li> -<li><a class="reference" href="#special-file-filetypes-common" id="id134" name="id134">Special file filetypes.common</a></li> +<li><a class="reference" href="#configuration-files" id="id130" name="id130">Configuration files</a><ul> +<li><a class="reference" href="#global-configuration-file" id="id131" name="id131">Global configuration file</a></li> +<li><a class="reference" href="#filetype-definition-files" id="id132" name="id132">Filetype definition files</a><ul> +<li><a class="reference" href="#format" id="id133" name="id133">Format</a><ul> +<li><a class="reference" href="#styling-section" id="id134" name="id134">[styling] Section</a></li> +<li><a class="reference" href="#keywords-section" id="id135" name="id135">[keywords] Section</a></li> +<li><a class="reference" href="#settings-section" id="id136" name="id136">[settings] Section</a></li> +<li><a class="reference" href="#build-settings-section" id="id137" name="id137">[build_settings] Section</a></li> </ul> </li> -<li><a class="reference" href="#filetype-extensions" id="id135" name="id135">Filetype extensions</a></li> -<li><a class="reference" href="#templates" id="id136" name="id136">Templates</a><ul> -<li><a class="reference" href="#template-metadata" id="id137" name="id137">Template metadata</a></li> -<li><a class="reference" href="#file-templates" id="id138" name="id138">File templates</a><ul> -<li><a class="reference" href="#custom-file-templates" id="id139" name="id139">Custom file templates</a></li> -<li><a class="reference" href="#filetype-templates" id="id140" name="id140">Filetype templates</a></li> +<li><a class="reference" href="#special-file-filetypes-common" id="id138" name="id138">Special file filetypes.common</a></li> </ul> </li> -<li><a class="reference" href="#customizing-templates" id="id141" name="id141">Customizing templates</a><ul> -<li><a class="reference" href="#template-wildcards" id="id142" name="id142">Template wildcards</a></li> +<li><a class="reference" href="#filetype-extensions" id="id139" name="id139">Filetype extensions</a></li> +<li><a class="reference" href="#templates" id="id140" name="id140">Templates</a><ul> +<li><a class="reference" href="#template-metadata" id="id141" name="id141">Template metadata</a></li> +<li><a class="reference" href="#file-templates" id="id142" name="id142">File templates</a><ul> +<li><a class="reference" href="#custom-file-templates" id="id143" name="id143">Custom file templates</a></li> +<li><a class="reference" href="#filetype-templates" id="id144" name="id144">Filetype templates</a></li> </ul> </li> +<li><a class="reference" href="#customizing-templates" id="id145" name="id145">Customizing templates</a><ul> +<li><a class="reference" href="#template-wildcards" id="id146" name="id146">Template wildcards</a></li> </ul> </li> </ul> </li> -<li><a class="reference" href="#contributing-to-this-document" id="id143" name="id143">Contributing to this document</a></li> -<li><a class="reference" href="#scintilla-keyboard-commands" id="id144" name="id144">Scintilla keyboard commands</a><ul> -<li><a class="reference" href="#keyboard-commands" id="id145" name="id145">Keyboard commands</a></li> </ul> </li> -<li><a class="reference" href="#tips-and-tricks" id="id146" name="id146">Tips and tricks</a><ul> -<li><a class="reference" href="#document-notebook" id="id147" name="id147">Document notebook</a></li> -<li><a class="reference" href="#symbols" id="id148" name="id148">Symbols</a></li> -<li><a class="reference" href="#gtk-related" id="id149" name="id149">GTK-related</a></li> +<li><a class="reference" href="#contributing-to-this-document" id="id147" name="id147">Contributing to this document</a></li> +<li><a class="reference" href="#scintilla-keyboard-commands" id="id148" name="id148">Scintilla keyboard commands</a><ul> +<li><a class="reference" href="#keyboard-commands" id="id149" name="id149">Keyboard commands</a></li> </ul> </li> -<li><a class="reference" href="#hidden-preferences" id="id150" name="id150">Hidden preferences</a></li> -<li><a class="reference" href="#compile-time-options" id="id151" name="id151">Compile-time options</a><ul> -<li><a class="reference" href="#src-geany-h" id="id152" name="id152">src/geany.h</a></li> -<li><a class="reference" href="#project-h" id="id153" name="id153">project.h</a></li> -<li><a class="reference" href="#editor-h" id="id154" name="id154">editor.h</a></li> -<li><a class="reference" href="#keyfile-c" id="id155" name="id155">keyfile.c</a></li> +<li><a class="reference" href="#tips-and-tricks" id="id150" name="id150">Tips and tricks</a><ul> +<li><a class="reference" href="#document-notebook" id="id151" name="id151">Document notebook</a></li> +<li><a class="reference" href="#symbols" id="id152" name="id152">Symbols</a></li> +<li><a class="reference" href="#gtk-related" id="id153" name="id153">GTK-related</a></li> </ul> </li> -<li><a class="reference" href="#gnu-general-public-license" id="id156" name="id156">GNU General Public License</a></li> -<li><a class="reference" href="#license-for-scintilla-and-scite" id="id157" name="id157">License for Scintilla and SciTE</a></li> +<li><a class="reference" href="#hidden-preferences" id="id154" name="id154">Hidden preferences</a></li> +<li><a class="reference" href="#compile-time-options" id="id155" name="id155">Compile-time options</a><ul> +<li><a class="reference" href="#src-geany-h" id="id156" name="id156">src/geany.h</a></li> +<li><a class="reference" href="#project-h" id="id157" name="id157">project.h</a></li> +<li><a class="reference" href="#editor-h" id="id158" name="id158">editor.h</a></li> +<li><a class="reference" href="#keyfile-c" id="id159" name="id159">keyfile.c</a></li> </ul> +</li> +<li><a class="reference" href="#gnu-general-public-license" id="id160" name="id160">GNU General Public License</a></li> +<li><a class="reference" href="#license-for-scintilla-and-scite" id="id161" name="id161">License for Scintilla and SciTE</a></li> +</ul> </div> <div class="section"> <h1><a class="toc-backref" href="#id9" id="introduction" name="introduction">Introduction</a></h1> @@ -431,51 +437,75 @@ <h1><a class="toc-backref" href="#id14" id="installation" name="installation">Installation</a></h1> <div class="section"> <h2><a class="toc-backref" href="#id15" id="requirements" name="requirements">Requirements</a></h2> +<p>You will need the GTK (>= 2.6.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="#id16" 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://geany.uvena.de/Download/Releases">http://geany.uvena.de/Download/Releases</a>.</p> +</div> +<div class="section"> +<h2><a class="toc-backref" href="#id17" id="source-compilation" name="source-compilation">Source compilation</a></h2> <p>For compiling Geany yourself, you will need the GTK (>= 2.6.0) -libraries and header files. You will also need the Pango, Glib and +libraries and header files. You will also need the Pango, GLib and ATK libraries and header files. All these files are available at -<a class="reference" href="http://www.gtk.org">http://www.gtk.org</a>.</p> +<a class="reference" href="http://www.gtk.org">http://www.gtk.org</a>, but very often your distro will provide development +packages to save the trouble of building these yourself.</p> <p>Furthermore you need, of course, a C compiler and the Make tool; a -C++ compiler is also required for the included Scintilla library. The +C++ compiler is also required (for the included Scintilla library). The GNU versions of these tools are recommended.</p> -</div> -<div class="section"> -<h2><a class="toc-backref" href="#id16" id="source-compilation" name="source-compilation">Source compilation</a></h2> <p>Compiling Geany is quite easy. The following should do it:</p> <pre class="literal-block"> -% ./configure -% make +$ ./configure +$ make +</pre> +<p>Then as root:</p> +<pre class="literal-block"> % make install </pre> +<div class="section"> +<h3><a class="toc-backref" href="#id18" 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"> -% ./configure --help +$ ./configure --help </pre> +<p>You may also want to read the INSTALL file for advanced installation +options.</p> <p>There also some compile time options which can be found in <tt class="docutils literal"><span class="pre">src/geany.h</span></tt>. Please see <a class="reference" href="#compile-time-options">Compile-time options</a> for more information.</p> +</div> +<div class="section"> +<h3><a class="toc-backref" href="#id19" 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="#id20" id="supported-systems" name="supported-systems">Supported systems</a></h3> <p>Geany has been successfully compiled and tested under Debian 3.1 Sarge, Debian 4.0 Etch, Fedora Core 3/4/5, LinuxFromScratch and -FreeBSD 6.0. It also compiles under Microsoft Windows™.</p> -<p>If there are any errors during compilation, check your build -environment and try to find the error, otherwise contact the author -at <enrico(dot)troeger(at)uvena(dot)de>.</p> +FreeBSD 6.0. It also compiles under Microsoft Windows™ (using the +Windows makefiles - see the website for details).</p> </div> <div class="section"> -<h2><a class="toc-backref" href="#id17" 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://geany.uvena.de/Download/Releases">http://geany.uvena.de/Download/Releases</a>.</p> +<h3><a class="toc-backref" href="#id21" 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 the author - <enrico(dot)troeger(at)uvena(dot)de>. Sometimes +you might need to ask for specific help from your distro.</p> </div> </div> +</div> <div class="section"> -<h1><a class="toc-backref" href="#id18" id="usage" name="usage">Usage</a></h1> +<h1><a class="toc-backref" href="#id22" id="usage" name="usage">Usage</a></h1> <div class="section"> -<h2><a class="toc-backref" href="#id19" id="getting-started" name="getting-started">Getting started</a></h2> +<h2><a class="toc-backref" href="#id23" 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> @@ -492,7 +522,7 @@ </ul> </div> <div class="section"> -<h2><a class="toc-backref" href="#id20" id="command-line-options" name="command-line-options">Command line options</a></h2> +<h2><a class="toc-backref" href="#id24" id="command-line-options" name="command-line-options">Command line options</a></h2> <table border="1" class="docutils"> <colgroup> <col width="13%" /> @@ -621,9 +651,9 @@ help screen.</p> </div> <div class="section"> -<h2><a class="toc-backref" href="#id21" id="general" name="general">General</a></h2> +<h2><a class="toc-backref" href="#id25" id="general" name="general">General</a></h2> <div class="section"> -<h3><a class="toc-backref" href="#id22" id="startup" name="startup">Startup</a></h3> +<h3><a class="toc-backref" href="#id26" 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-tab-in-preferences-dialog">General tab in preferences dialog</a>). If you specify some @@ -638,7 +668,7 @@ files in a running instance using the appropriate command line option.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id23" 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="#id27" 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 @@ -647,7 +677,7 @@ line option -- see the section called <a class="reference" href="#command-line-options">Command line options</a>.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id24" 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="#id28" 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> @@ -691,7 +721,7 @@ ./configure.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id25" 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="#id29" 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 @@ -730,9 +760,9 @@ </div> </div> <div class="section"> -<h2><a class="toc-backref" href="#id26" id="documents" name="documents">Documents</a></h2> +<h2><a class="toc-backref" href="#id30" id="documents" name="documents">Documents</a></h2> <div class="section"> -<h3><a class="toc-backref" href="#id27" id="switching-between-documents" name="switching-between-documents">Switching between documents</a></h3> +<h3><a class="toc-backref" href="#id31" 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 @@ -741,9 +771,9 @@ </div> </div> <div class="section"> -<h2><a class="toc-backref" href="#id28" 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="#id32" 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="#id29" id="using-character-sets" name="using-character-sets">Using character sets</a></h3> +<h3><a class="toc-backref" href="#id33" 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, @@ -789,7 +819,7 @@ </ul> </div> <div class="section"> -<h3><a class="toc-backref" href="#id30" id="in-file-encoding-specification" name="in-file-encoding-specification">In-file encoding specification</a></h3> +<h3><a class="toc-backref" href="#id34" 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"> @@ -831,7 +861,7 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id31" id="special-encoding-none" name="special-encoding-none">Special encoding "None"</a></h3> +<h3><a class="toc-backref" href="#id35" 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 @@ -841,7 +871,7 @@ without any character conversion.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id32" 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="#id36" 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 @@ -862,9 +892,9 @@ </div> </div> <div class="section"> -<h2><a class="toc-backref" href="#id33" id="editing" name="editing">Editing</a></h2> +<h2><a class="toc-backref" href="#id37" id="editing" name="editing">Editing</a></h2> <div class="section"> -<h3><a class="toc-backref" href="#id34" id="folding" name="folding">Folding</a></h3> +<h3><a class="toc-backref" href="#id38" 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 @@ -888,7 +918,7 @@ it for this click and vice versa.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id35" id="column-mode-editing" name="column-mode-editing">Column mode editing</a></h3> +<h3><a class="toc-backref" href="#id39" id="column-mode-editing" name="column-mode-editing">Column mode editing</a></h3> <p>There is basic support for column mode editing. To use it, create a rectangular selection by holding down the Control key while selecting some text. It is also possible to create a zero-column selection but @@ -898,7 +928,7 @@ selection.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id36" 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="#id40" 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 @@ -906,7 +936,7 @@ before the selected text was copied to the new position.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id37" id="indentation" name="indentation">Indentation</a></h3> +<h3><a class="toc-backref" href="#id41" 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>. But this can be overridden using either @@ -924,7 +954,7 @@ </dl> </div> <div class="section"> -<h3><a class="toc-backref" href="#id38" id="auto-indentation" name="auto-indentation">Auto-indentation</a></h3> +<h3><a class="toc-backref" href="#id42" 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> @@ -945,7 +975,7 @@ </dl> </div> <div class="section"> -<h3><a class="toc-backref" href="#id39" id="bookmarks" name="bookmarks">Bookmarks</a></h3> +<h3><a class="toc-backref" href="#id43" 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> @@ -963,7 +993,7 @@ navigate around multiple files.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id40" id="code-navigation-history" name="code-navigation-history">Code Navigation History</a></h3> +<h3><a class="toc-backref" href="#id44" 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> @@ -982,7 +1012,7 @@ and between different files.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id41" 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="#id45" 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 @@ -999,7 +1029,7 @@ entry and press OK. It will be deleted automatically.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id42" id="context-actions" name="context-actions">Context actions</a></h3> +<h3><a class="toc-backref" href="#id46" 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 @@ -1025,7 +1055,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="#id43" id="user-definable-snippets" name="user-definable-snippets">User-definable snippets</a></h3> +<h3><a class="toc-backref" href="#id47" 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. @@ -1121,7 +1151,7 @@ needs.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id44" id="inserting-unicode-characters" name="inserting-unicode-characters">Inserting unicode characters</a></h3> +<h3><a class="toc-backref" href="#id48" 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 @@ -1137,7 +1167,7 @@ </div> </div> <div class="section"> -<h2><a class="toc-backref" href="#id45" 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="#id49" 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"> @@ -1152,11 +1182,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="#id46" id="find" name="find">Find</a></h3> +<h3><a class="toc-backref" href="#id50" 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="#id47" id="matching-options" name="matching-options">Matching options</a></h4> +<h4><a class="toc-backref" href="#id51" 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 @@ -1165,7 +1195,7 @@ (Unicode chararacters).</p> </div> <div class="section"> -<h4><a class="toc-backref" href="#id48" id="find-all" name="find-all">Find all</a></h4> +<h4><a class="toc-backref" href="#id52" 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"> @@ -1182,7 +1212,7 @@ removed by selecting the Remove Markers command from the Document menu.</p> </div> <div class="section"> -<h4><a class="toc-backref" href="#id49" 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="#id53" 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 readibility of input text. This is useful when you are typing e.g. regular expressions with spaces, periods and commas which @@ -1204,7 +1234,7 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id50" id="find-usage" name="find-usage">Find usage</a></h3> +<h3><a class="toc-backref" href="#id54" 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 @@ -1214,7 +1244,7 @@ shown in the Messages tab of the Message Window.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id51" id="find-in-files" name="find-in-files">Find in files</a></h3> +<h3><a class="toc-backref" href="#id55" 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 @@ -1223,7 +1253,7 @@ <p>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="#id52" 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="#id56" 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> @@ -1235,7 +1265,7 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id53" id="replace" name="replace">Replace</a></h3> +<h3><a class="toc-backref" href="#id57" 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" /> @@ -1245,7 +1275,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="#id54" id="replace-all" name="replace-all">Replace all</a></h4> +<h4><a class="toc-backref" href="#id58" 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"> @@ -1260,7 +1290,7 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id55" id="go-to-tag-definition" name="go-to-tag-definition">Go to tag definition</a></h3> +<h3><a class="toc-backref" href="#id59" 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 @@ -1269,17 +1299,17 @@ menu is used.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id56" id="go-to-tag-declaration" name="go-to-tag-declaration">Go to tag declaration</a></h3> +<h3><a class="toc-backref" href="#id60" 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="#id57" id="go-to-line" name="go-to-line">Go to line</a></h3> +<h3><a class="toc-backref" href="#id61" 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="#id58" id="regular-expressions" name="regular-expressions">Regular expressions</a></h3> +<h3><a class="toc-backref" href="#id62" 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> @@ -1352,14 +1382,14 @@ </tbody> </table> <div class="section"> -<h4><a class="toc-backref" href="#id59" id="partial-posix-compatibility" name="partial-posix-compatibility">Partial POSIX compatibility</a></h4> +<h4><a class="toc-backref" href="#id63" id="partial-posix-compatibility" name="partial-posix-compatibility">Partial POSIX compatibility</a></h4> <p>Note that the POSIX '?' regular expression character for optional matching is not supported by the Find and Replace dialogs.</p> </div> </div> </div> <div class="section"> -<h2><a class="toc-backref" href="#id60" id="tags" name="tags">Tags</a></h2> +<h2><a class="toc-backref" href="#id64" 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 @@ -1369,7 +1399,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="#id61" id="workspace-tags" name="workspace-tags">Workspace tags</a></h3> +<h3><a class="toc-backref" href="#id65" 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 @@ -1378,7 +1408,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="#id62" id="global-tags" name="global-tags">Global tags</a></h3> +<h3><a class="toc-backref" href="#id66" 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 @@ -1398,7 +1428,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="#id63" id="default-global-tags-files" name="default-global-tags-files">Default global tags files</a></h4> +<h4><a class="toc-backref" href="#id67" 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"> @@ -1410,7 +1440,7 @@ </ul> </div> <div class="section"> -<h4><a class="toc-backref" href="#id64" 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="#id68" id="generating-a-global-tags-file" name="generating-a-global-tags-file">Generating a global tags file</a></h4> <p><em>Filetypes support:</em></p> <p>Currently this is not yet supported for Pascal, PHP and LaTeX filetypes.</p> @@ -1458,7 +1488,7 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id65" id="ignore-tags" name="ignore-tags">Ignore tags</a></h3> +<h3><a class="toc-backref" href="#id69" 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">~/.geany/</span></tt>). Then list all tags @@ -1482,7 +1512,7 @@ </div> </div> <div class="section"> -<h2><a class="toc-backref" href="#id66" id="preferences" name="preferences">Preferences</a></h2> +<h2><a class="toc-backref" href="#id70" 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 @@ -1500,10 +1530,10 @@ comes after the screenshot of that tab.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id67" id="general-tab-in-preferences-dialog" name="general-tab-in-preferences-dialog">General tab in preferences dialog</a></h3> +<h3><a class="toc-backref" href="#id71" id="general-tab-in-preferences-dialog" name="general-tab-in-preferences-dialog">General tab in preferences dialog</a></h3> <img alt="./images/pref_dialog_gen.png" src="./images/pref_dialog_gen.png" /> <div class="section"> -<h4><a class="toc-backref" href="#id68" id="id1" name="id1">Startup</a></h4> +<h4><a class="toc-backref" href="#id72" 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 @@ -1515,7 +1545,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id69" id="shutdown" name="shutdown">Shutdown</a></h4> +<h4><a class="toc-backref" href="#id73" 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 @@ -1525,7 +1555,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id70" id="projects" name="projects">Projects</a></h4> +<h4><a class="toc-backref" href="#id74" 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 @@ -1534,7 +1564,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id71" id="miscellaneous" name="miscellaneous">Miscellaneous</a></h4> +<h4><a class="toc-backref" href="#id75" 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 @@ -1552,10 +1582,10 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id72" 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="#id76" 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="#id73" id="sidebar" name="sidebar">Sidebar</a></h4> +<h4><a class="toc-backref" href="#id77" 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 @@ -1570,7 +1600,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id74" id="fonts" name="fonts">Fonts</a></h4> +<h4><a class="toc-backref" href="#id78" id="fonts" name="fonts">Fonts</a></h4> <dl class="docutils"> <dt>Editor</dt> <dd>Change the font used to display documents.</dd> @@ -1581,7 +1611,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id75" id="editor-tabs" name="editor-tabs">Editor tabs</a></h4> +<h4><a class="toc-backref" href="#id79" 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 @@ -1595,7 +1625,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id76" id="tab-positions" name="tab-positions">Tab positions</a></h4> +<h4><a class="toc-backref" href="#id80" 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, @@ -1609,7 +1639,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id77" id="id2" name="id2">Miscellaneous</a></h4> +<h4><a class="toc-backref" href="#id81" 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 @@ -1619,18 +1649,18 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id78" 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="#id82" 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="#id79" id="toolbar" name="toolbar">Toolbar</a></h4> +<h4><a class="toc-backref" href="#id83" id="toolbar" name="toolbar">Toolbar</a></h4> <dl class="docutils"> <dt>Show Toolbar</dt> <dd>Whether to show the toolbar.</dd> </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id80" id="items" name="items">Items</a></h4> +<h4><a class="toc-backref" href="#id84" id="items" name="items">Items</a></h4> <dl class="docutils"> <dt>Show file operation buttons</dt> <dd>Show the buttons to open a new file, open an existing file, save a file, @@ -1660,7 +1690,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id81" id="appearance" name="appearance">Appearance</a></h4> +<h4><a class="toc-backref" href="#id85" 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 @@ -1671,10 +1701,10 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id82" 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="#id86" 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.png" src="./images/pref_dialog_edit.png" /> <div class="section"> -<h4><a class="toc-backref" href="#id83" id="indentation-group" name="indentation-group">Indentation group</a></h4> +<h4><a class="toc-backref" href="#id87" 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> @@ -1699,7 +1729,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id84" id="features" name="features">Features</a></h4> +<h4><a class="toc-backref" href="#id88" 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> @@ -1731,7 +1761,7 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id85" 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="#id89" id="editor-completions-tab-in-preferences-dialog" name="editor-completions-tab-in-preferences-dialog">Editor Completions tab in preferences dialog</a></h3> <dl class="docutils"> <dt>Snippet Completion</dt> <dd>Whether to replace special keywords after typing Tab into a @@ -1767,11 +1797,11 @@ </dl> </div> <div class="section"> -<h3><a class="toc-backref" href="#id86" 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="#id90" 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_display.png" src="./images/pref_dialog_display.png" /> <div class="section"> -<h4><a class="toc-backref" href="#id87" id="display" name="display">Display</a></h4> +<h4><a class="toc-backref" href="#id91" id="display" name="display">Display</a></h4> <dl class="docutils"> <dt>Show indendation guides</dt> <dd>Show vertical lines to help show how much leading indentation there @@ -1785,7 +1815,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id88" id="long-line-marker" name="long-line-marker">Long line marker</a></h4> +<h4><a class="toc-backref" href="#id92" 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"> @@ -1811,10 +1841,10 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id89" 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="#id93" 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="#id90" id="new-files" name="new-files">New files</a></h4> +<h4><a class="toc-backref" href="#id94" id="new-files" name="new-files">New files</a></h4> <dl class="docutils"> <dt>Default encoding (new files)</dt> <dd>The type of file encoding you wish to use when creating files.</dd> @@ -1831,7 +1861,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id91" id="saving-files" name="saving-files">Saving files</a></h4> +<h4><a class="toc-backref" href="#id95" 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"> @@ -1850,7 +1880,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id92" id="id3" name="id3">Miscellaneous</a></h4> +<h4><a class="toc-backref" href="#id96" 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> @@ -1861,10 +1891,10 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id93" 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="#id97" 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="#id94" id="tool-paths" name="tool-paths">Tool paths</a></h4> +<h4><a class="toc-backref" href="#id98" id="tool-paths" name="tool-paths">Tool paths</a></h4> <dl class="docutils"> <dt>Make</dt> <dd>The location of the make executable.</dd> @@ -1884,7 +1914,7 @@ </div> </div> <div class="section"> -<h4><a class="toc-backref" href="#id95" id="commands" name="commands">Commands</a></h4> +<h4><a class="toc-backref" href="#id99" 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. @@ -1894,7 +1924,7 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id96" 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="#id100" 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 metadata 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> @@ -1904,7 +1934,7 @@ </div> <img alt="./images/pref_dialog_templ.png" src="./images/pref_dialog_templ.png" /> <div class="section"> -<h4><a class="toc-backref" href="#id97" id="template-data" name="template-data">Template data</a></h4> +<h4><a class="toc-backref" href="#id101" 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> @@ -1937,7 +1967,7 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id98" 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="#id102" 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> @@ -1947,7 +1977,7 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id99" 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="#id103" 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> @@ -1969,11 +1999,11 @@ </dl> </div> <div class="section"> -<h3><a class="toc-backref" href="#id100" id="vte-tab-in-preferences-dialog" name="vte-tab-in-preferences-dialog">VTE tab in preferences dialog</a></h3> +<h3><a class="toc-backref" href="#id104" id="vte-tab-in-preferences-dialog" name="vte-tab-in-preferences-dialog">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="#id101" id="terminal-widget" name="terminal-widget">Terminal widget</a></h4> +<h4><a class="toc-backref" href="#id105" 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> @@ -2014,7 +2044,7 @@ </div> </div> <div class="section"> -<h2><a class="toc-backref" href="#id102" id="project-management" name="project-management">Project Management</a></h2> +<h2><a class="toc-backref" href="#id106" 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> @@ -2032,7 +2062,7 @@ 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> <div class="section"> -<h3><a class="toc-backref" href="#id103" id="new-project" name="new-project">New Project</a></h3> +<h3><a class="toc-backref" href="#id107" 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 @@ -2042,7 +2072,7 @@ structure contained in it.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id104" id="project-properties" name="project-properties">Project Properties</a></h3> +<h3><a class="toc-backref" href="#id108" 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 @@ -2051,13 +2081,13 @@ The specified path can be an absolute path or relative to the project's file name.</p> <div class="section"> -<h4><a class="toc-backref" href="#id105" id="make-in-base-path" name="make-in-base-path">Make in base path</a></h4> +<h4><a class="toc-backref" href="#id109" 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> </div> <div class="section"> -<h4><a class="toc-backref" href="#id106" id="run-command" name="run-command">Run command</a></h4> +<h4><a class="toc-backref" href="#id110" 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> @@ -2070,7 +2100,7 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id107" id="open-project" name="open-project">Open Project</a></h3> +<h3><a class="toc-backref" href="#id111" id="open-project" name="open-project">Open Project</a></h3> <p>The Open command displays a standard file chooser, starting in <tt class="docutils literal"><span class="pre">~/projects</span></tt>. Choose a project file named with the <tt class="docutils literal"><span class="pre">.geany</span></tt> extension.</p> @@ -2078,14 +2108,14 @@ open files and open the session files associated with the project.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id108" id="close-project" name="close-project">Close Project</a></h3> +<h3><a class="toc-backref" href="#id112" id="close-project" name="close-project">Close Project</a></h3> <p>Project file settings are saved when the project is closed.</p> <p>When project session support is enabled, Geany will close the project session files and open any previously closed default session files.</p> </div> </div> <div class="section"> -<h2><a class="toc-backref" href="#id109" id="build-system" name="build-system">Build system</a></h2> +<h2><a class="toc-backref" href="#id113" 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 @@ -2109,7 +2139,7 @@ <li>Set Includes and Arguments</li> </ul> <div class="section"> -<h3><a class="toc-backref" href="#id110" id="compile" name="compile">Compile</a></h3> +<h3><a class="toc-backref" href="#id114" id="compile" name="compile">Compile</a></h3> <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> @@ -2119,7 +2149,7 @@ will run the file in its language interpreter.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id111" id="build" name="build">Build</a></h3> +<h3><a class="toc-backref" href="#id115" id="build" name="build">Build</a></h3> <p>For compilable languages such as C and C++, the Build command will link the current source file's equivalent object file into an executable. If the object file does not exist, the source will be compiled and linked @@ -2127,7 +2157,7 @@ <p>Interpreted languages do not use the Build command.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id112" id="make-all" name="make-all">Make all</a></h3> +<h3><a class="toc-backref" href="#id116" id="make-all" name="make-all">Make all</a></h3> <p>This effectively runs "make all" in the same directory as the current file.</p> <div class="note"> @@ -2137,19 +2167,19 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id113" id="make-custom-target" name="make-custom-target">Make custom target</a></h3> +<h3><a class="toc-backref" href="#id117" id="make-custom-target" name="make-custom-target">Make custom target</a></h3> <p>This is similar to running 'Make all' but you will be prompted for the make target name to be passed to the Make tool. For example, typing 'clean' in the dialog prompt will run "make clean".</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id114" id="make-object" name="make-object">Make object</a></h3> +<h3><a class="toc-backref" href="#id118" id="make-object" name="make-object">Make object</a></h3> <p>Make object will run "make current_file.o" in the same directory as the current file, using its prefix for 'current_file'. It is useful for compiling just the current file without building the whole project.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id115" id="execute" name="execute">Execute</a></h3> +<h3><a class="toc-backref" href="#id119" id="execute" name="execute">Execute</a></h3> <p>Execute will run the corresponding executable file, shell script or interpreted script in a terminal window. Note that the Terminal tool path must be correctly set in the Tools tab of the Preferences dialog - @@ -2160,7 +2190,7 @@ output from the program before the terminal window is closed.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id116" id="stopping-running-processes" name="stopping-running-processes">Stopping running processes</a></h3> +<h3><a class="toc-backref" href="#id120" id="stopping-running-processes" name="stopping-running-processes">Stopping running processes</a></h3> <p>When there is a running program, the Run button in the toolbar becomes a stop button and you can stop the current action. This works by sending a signal to the process (and its child process(es)) @@ -2169,7 +2199,7 @@ cannot be stopped. This can happen when the process creates more than one child process.</p> <div class="section"> -<h4><a class="toc-backref" href="#id117" id="terminal-emulators" name="terminal-emulators">Terminal emulators</a></h4> +<h4><a class="toc-backref" href="#id121" id="terminal-emulators" name="terminal-emulators">Terminal emulators</a></h4> <p>Xterm is known to work properly. If you are using "Terminal" (the terminal program of Xfce), you should add the command line option <tt class="docutils literal"><span class="pre">--disable-server</span></tt> otherwise the started process cannot be @@ -2178,7 +2208,7 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id118" id="set-includes-and-arguments" name="set-includes-and-arguments">Set Includes and Arguments</a></h3> +<h3><a class="toc-backref" href="#id122" id="set-includes-and-arguments" name="set-includes-and-arguments">Set Includes and Arguments</a></h3> <p>By default the Compile and Build commands invoke the compiler and linker with only the basic arguments needed by all programs. Using Set Includes and Arguments you can add any include paths and compile @@ -2195,14 +2225,14 @@ different settings, then writing a Makefile and using the Make commands is recommended.</p> <div class="section"> -<h4><a class="toc-backref" href="#id119" id="one-step-compilation" name="one-step-compilation">One step compilation</a></h4> +<h4><a class="toc-backref" href="#id123" id="one-step-compilation" name="one-step-compilation">One step compilation</a></h4> <p>If you are using the Build command to compile and link in one step, you will need to set both the compiler arguments and the linker arguments in the linker command setting.</p> </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id120" id="indicators" name="indicators">Indicators</a></h3> +<h3><a class="toc-backref" href="#id124" id="indicators" name="indicators">Indicators</a></h3> <p>Indicators are red squiggly underlines which are used to highlight errors which occured while compiling the current file. So you can easily see where your code failed to compile. To remove the indicators, @@ -2212,7 +2242,7 @@ </div> </div> <div class="section"> -<h2><a class="toc-backref" href="#id121" id="printing-support" name="printing-support">Printing support</a></h2> +<h2><a class="toc-backref" href="#id125" id="printing-support" name="printing-support">Printing support</a></h2> <p>Since Geany 0.13 there is full printing support using GTK's printing API. The printed page(s) will look nearly the same as on your screen in Geany. Additionally, there are some options to modify the printed page(s). You @@ -2260,7 +2290,7 @@ gtklp or similar programs can be used.</p> </div> <div class="section"> -<h2><a class="toc-backref" href="#id122" id="plugins" name="plugins">Plugins</a></h2> +<h2><a class="toc-backref" href="#id126" id="plugins" name="plugins">Plugins</a></h2> <p>Plugins are loaded at startup, if the <em>Enable plugin support</em> general preference is set. There is also a command-line option, <tt class="docutils literal"><span class="pre">-p</span></tt>, which prevents plugins being loaded. Plugins are scanned in @@ -2280,13 +2310,13 @@ provides some.</p> </div> <div class="section"> -<h2><a class="toc-backref" href="#id123" id="keybindings" name="keybindings">Keybindings</a></h2> +<h2><a class="toc-backref" href="#id127" id="keybindings" name="keybindings">Keybindings</a></h2> <p>Geany supports the default keyboard shortcuts for the Scintilla editing widget. For a list of these commands, see <a class="reference" href="#scintilla-keyboard-commands">Scintilla keyboard commands</a>. The Scintilla keyboard shortcuts will be overridden by any custom keybindings with the same keyboard shortcut.</p> <div class="section"> -<h3><a class="toc-backref" href="#id124" id="switching-documents" name="switching-documents">Switching documents</a></h3> +<h3><a class="toc-backref" href="#id128" id="switching-documents" name="switching-documents">Switching documents</a></h3> <p>There are a few non-configurable bindings to switch between documents, listed below. These can also be overridden by custom keybindings.</p> <table border="1" class="docutils"> @@ -2316,7 +2346,7 @@ </table> </div> <div class="section"> -<h3><a class="toc-backref" href="#id125" id="configurable-keybindings" name="configurable-keybindings">Configurable keybindings</a></h3> +<h3><a class="toc-backref" href="#id129" id="configurable-keybindings" name="configurable-keybindings">Configurable keybindings</a></h3> <p>For all actions listed below you can define your own keybindings. Open the Preferences dialog, select the desired action and click on change. In the opening dialog you can press any key combination you @@ -2864,9 +2894,9 @@ </div> </div> <div class="section"> -<h1><a class="toc-backref" href="#id126" id="configuration-files" name="configuration-files">Configuration files</a></h1> +<h1><a class="toc-backref" href="#id130" id="configuration-files" name="configuration-files">Configuration files</a></h1> <div class="section"> -<h2><a class="toc-backref" href="#id127" id="global-configuration-file" name="global-configuration-file">Global configuration file</a></h2> +<h2><a class="toc-backref" href="#id131" id="global-configuration-file" name="global-configuration-file">Global configuration file</a></h2> <p>You can use a global configuration file for Geany which will be used if the user starts Geany for the first time and an user's configuration file was not yet created or in case an user deleted the configuration @@ -2886,7 +2916,7 @@ </div> </div> <div class="section"> -<h2><a class="toc-backref" href="#id128" id="filetype-definition-files" name="filetype-definition-files">Filetype definition files</a></h2> +<h2><a class="toc-backref" href="#id132" id="filetype-definition-files" name="filetype-definition-files">Filetype definition files</a></h2> <p>All colour definitions and other filetype specific settings are stored in the filetype definition files. Those settings are colours for syntax highlighting, general settings like comment characters or @@ -2914,9 +2944,9 @@ to change. All missing settings will be read from the corresponding global definition file in <tt class="docutils literal"><span class="pre">$prefix/share/geany</span></tt>.</p> <div class="section"> -<h3><a class="toc-backref" href="#id129" id="format" name="format">Format</a></h3> +<h3><a class="toc-backref" href="#id133" id="format" name="format">Format</a></h3> <div class="section"> -<h4><a class="toc-backref" href="#id130" id="styling-section" name="styling-section">[styling] Section</a></h4> +<h4><a class="toc-backref" href="#id134" id="styling-section" name="styling-section">[styling] Section</a></h4> <p>In this section the colours for syntax highlighting are defined. The format is always: key=forground_colour;background_colour;bold;italic</p> <p>Colours have to be specified as RGB hex values prefixed by @@ -2926,7 +2956,7 @@ value is something other than "true" or "false", "false" is assumed.</p> </div> <div class="section"> -<h4><a class="toc-backref" href="#id131" id="keywords-section" name="keywords-section">[keywords] Section</a></h4> +<h4><a class="toc-backref" href="#id135" id="keywords-section" name="keywords-section">[keywords] Section</a></h4> <p>This section contains keys for different keyword lists specific to the filetype. Some filetypes do not support keywords, so adding a new key will not work. You can only add or remove keywords to/from @@ -2937,7 +2967,7 @@ </div> </div> <div class="section"> -<h4><a class="toc-backref" href="#id132" id="settings-section" name="settings-section">[settings] Section</a></h4> +<h4><a class="toc-backref" href="#id136" id="settings-section" name="settings-section">[settings] Section</a></h4> <dl class="docutils"> <dt>extension</dt> <dd><p class="first">This is the default file extension used when saving files, not @@ -2998,7 +3028,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id133" id="build-settings-section" name="build-settings-section">[build_settings] Section</a></h4> +<h4><a class="toc-backref" href="#id137" id="build-settings-section" name="build-settings-section">[build_settings] Section</a></h4> <dl class="docutils"> <dt>compiler</dt> <dd><p class="first">This item specifies the command to compile source code files. But @@ -3031,7 +3061,7 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id134" id="special-file-filetypes-common" name="special-file-filetypes-common">Special file filetypes.common</a></h3> +<h3><a class="toc-backref" href="#id138" id="special-file-filetypes-common" name="special-file-filetypes-common">Special file filetypes.common</a></h3> <p>There is a special filetype definition file called filetypes.common. This file defines some general non-filetype-specific settings.</p> @@ -3197,7 +3227,7 @@ </div> </div> <div class="section"> -<h2><a class="toc-backref" href="#id135" id="filetype-extensions" name="filetype-extensions">Filetype extensions</a></h2> +<h2><a class="toc-backref" href="#id139" id="filetype-extensions" name="filetype-extensions">Filetype extensions</a></h2> <p>To change the default filetype extension used when saving a new file, see <a class="reference" href="#filetype-definition-files">Filetype definition files</a>.</p> <p>You can override the list of file extensions that Geany uses for each @@ -3223,7 +3253,7 @@ </pre> </div> <div class="section"> -<h2><a class="toc-backref" href="#id136" id="templates" name="templates">Templates</a></h2> +<h2><a class="toc-backref" href="#id140" id="templates" name="templates">Templates</a></h2> <p>Geany supports the following templates:</p> <ul class="simple"> <li>ChangeLog entry</li> @@ -3246,7 +3276,7 @@ function description won't contain the correct function name but "unknown" instead.</p> <div class="section"> -<h3><a class="toc-backref" href="#id137" id="template-metadata" name="template-metadata">Template metadata</a></h3> +<h3><a class="toc-backref" href="#id141" id="template-metadata" name="template-metadata">Template metadata</a></h3> <p>Metadata can be used with all templates, but by default user set metadata is only used for the ChangeLog and File header templates.</p> <p>In the configuration dialog you can find a tab "Templates" (see @@ -3256,7 +3286,7 @@ at startup.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id138" id="file-templates" name="file-templates">File templates</a></h3> +<h3><a class="toc-backref" href="#id142" id="file-templates" name="file-templates">File templates</a></h3> <p>File templates are templates used as the basis of a new file. To use them, choose the <em>New (with Template)</em> menu item from the <em>File</em> menu.</p> @@ -3268,7 +3298,7 @@ be placed anywhere, but is usually on the first line of the file, followed by a blank line.</p> <div class="section"> -<h4><a class="toc-backref" href="#id139" id="custom-file-templates" name="custom-file-templates">Custom file templates</a></h4> +<h4><a class="toc-backref" href="#id143" id="custom-file-templates" name="custom-file-templates">Custom file templates</a></h4> <p>These are read from the <tt class="docutils literal"><span class="pre">~/.geany/templates/files</span></tt> directory (created the first time Geany is started). The filetype to use is detected from the template file's extension, if any. For example, creating a file @@ -3279,7 +3309,7 @@ template.</p> </div> <div class="section"> -<h4><a class="toc-backref" href="#id140" id="filetype-templates" name="filetype-templates">Filetype templates</a></h4> +<h4><a class="toc-backref" href="#id144" id="filetype-templates" name="filetype-templates">Filetype templates</a></h4> <p>Filetype template files are read from the <tt class="docutils literal"><span class="pre">~/.geany/templates</span></tt> directory, and are named "filetype." followed by the filetype name, e.g. "filetype.python", "filetype.sh", etc. If you are @@ -3291,7 +3321,7 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id141" id="customizing-templates" name="customizing-templates">Customizing templates</a></h3> +<h3><a class="toc-backref" href="#id145" id="customizing-templates" name="customizing-templates">Customizing templates</a></h3> <p>Each template can be customized to your needs. The templates are stored in the <tt class="docutils literal"><span class="pre">~/.geany/templates/</span></tt> directory (see the section called <a class="reference" href="#command-line-options">Command line options</a> for further information about the configuration @@ -3299,7 +3329,7 @@ Geany ;-) ) and edit the template to your needs. There are some wildcards which will be automatically replaced by Geany at startup.</p> <div class="section"> -<h4><a class="toc-backref" href="#id142" id="template-wildcards" name="template-wildcards">Template wildcards</a></h4> +<h4><a class="toc-backref" href="#id146" id="template-wildcards" name="template-wildcards">Template wildcards</a></h4> <p>All wildcards must be enclosed by "{" and "}", e.g. {date}.</p> <table border="1" class="docutils"> <colgroup> @@ -3418,7 +3448,7 @@ </div> </div> <div class="section"> -<h1><a class="toc-backref" href="#id143" id="contributing-to-this-document" name="contributing-to-this-document">Contributing to this document</a></h1> +<h1><a class="toc-backref" href="#id147" id="contributing-to-this-document" name="contributing-to-this-document">Contributing to this document</a></h1> <p>This document (<tt class="docutils literal"><span class="pre">geany.txt</span></tt>) is written in <a class="reference" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a> (or "reST"). The source file for it is located in Geany's <tt class="docutils literal"><span class="pre">doc</span></tt> subdirectory. If you intend on making changes, you should grab the @@ -3438,7 +3468,7 @@ and Fedora systems.</p> </div> <div class="section"> -<h1><a class="toc-backref" href="#id144" id="scintilla-keyboard-commands" name="scintilla-keyboard-commands">Scintilla keyboard commands</a></h1> +<h1><a class="toc-backref" href="#id148" id="scintilla-keyboard-commands" name="scintilla-keyboard-commands">Scintilla keyboard commands</a></h1> <p>Copyright © 1998, 2006 Neil Hodgson <neilh(at)scintilla(dot)org></p> <p>This appendix is distributed under the terms of the License for Scintilla and SciTE. A copy of this license can be found in the file @@ -3447,7 +3477,7 @@ Scintilla and SciTE</a>.</p> <p>20 June 2006</p> <div class="section"> -<h2><a class="toc-backref" href="#id145" id="keyboard-commands" name="keyboard-commands">Keyboard commands</a></h2> +<h2><a class="toc-backref" href="#id149" id="keyboard-commands" name="keyboard-commands">Keyboard commands</a></h2> <p>Keyboard commands for Scintilla mostly follow common Windows and GTK+ conventions. All move keys (arrows, page up/down, home and end) allows to extend or reduce the stream selection when holding the @@ -3541,9 +3571,9 @@ </div> </div> <div class="section"> -<h1><a class="toc-backref" href="#id146" id="tips-and-tricks" name="tips-and-tricks">Tips and tricks</a></h1> +<h1><a class="toc-backref" href="#id150" id="tips-and-tricks" name="tips-and-tricks">Tips and tricks</a></h1> <div class="section"> -<h2><a class="toc-backref" href="#id147" id="document-notebook" name="document-notebook">Document notebook</a></h2> +<h2><a class="toc-backref" href="#id151" id="document-notebook" name="document-notebook">Document notebook</a></h2> <ul class="simple"> <li>Double-click on empty space in the notebook tab bar to open a new document.</li> @@ -3553,14 +3583,14 @@ </ul> </div> <div class="section"> -<h2><a class="toc-backref" href="#id148" id="symbols" name="symbols">Symbols</a></h2> +<h2><a class="toc-backref" href="#id152" id="symbols" name="symbols">Symbols</a></h2> <ul class="simple"> <li>Ctrl-click on a word in a document to perform <em>Go to Tag Definition</em>.</li> <li>Double-click on a symbol-list group to expand or compact it.</li> </ul> </div> <div class="section"> -<h2><a class="toc-backref" href="#id149" id="gtk-related" name="gtk-related">GTK-related</a></h2> +<h2><a class="toc-backref" href="#id153" id="gtk-related" name="gtk-related">GTK-related</a></h2> <ul class="simple"> <li>Scrolling the mouse wheel over a notebook tab bar will switch notebook pages.</li> @@ -3575,7 +3605,7 @@ </div> </div> <div class="section"> -<h1><a class="toc-backref" href="#id150" id="hidden-preferences" name="hidden-preferences">Hidden preferences</a></h1> +<h1><a class="toc-backref" href="#id154" id="hidden-preferences" name="hidden-preferences">Hidden preferences</a></h1> <p>There are some uncommon preferences that are not shown in the Preferences dialog. These can be set by editing <tt class="docutils literal"><span class="pre">~/.geany/geany.conf</span></tt>, then restarting Geany. Search for the key name, then edit the value. Example:</p> @@ -3647,7 +3677,7 @@ </table> </div> <div class="section"> -<h1><a class="toc-backref" href="#id151" id="compile-time-options" name="compile-time-options">Compile-time options</a></h1>
@@ Diff output truncated at 100000 characters. @@
This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.