Revision: 5473 http://geany.svn.sourceforge.net/geany/?rev=5473&view=rev Author: ntrel Date: 2010-12-07 17:42:31 +0000 (Tue, 07 Dec 2010)
Log Message: ----------- Add 'Configuration file paths' section and link to it instead of repeating typical system data and user config directory paths. List 2 Tools->Configuration Files menu items. Add 'Plugin Manager' section break. Edit some related sections.
Modified Paths: -------------- trunk/ChangeLog trunk/doc/geany.html trunk/doc/geany.txt
Modified: trunk/ChangeLog =================================================================== --- trunk/ChangeLog 2010-12-07 13:25:11 UTC (rev 5472) +++ trunk/ChangeLog 2010-12-07 17:42:31 UTC (rev 5473) @@ -10,6 +10,12 @@ * src/main.c: Disable 'Send Selection to Terminal' item when not available instead of removing it to avoid trailing separator. + * doc/geany.txt, doc/geany.html: + Add 'Configuration file paths' section and link to it instead of + repeating typical system data and user config directory paths. + List 2 Tools->Configuration Files menu items. + Add 'Plugin Manager' section break. + Edit some related sections.
2010-12-06 Nick Treleaven <nick(dot)treleaven(at)btinternet(dot)com>
Modified: trunk/doc/geany.html =================================================================== --- trunk/doc/geany.html 2010-12-07 13:25:11 UTC (rev 5472) +++ trunk/doc/geany.html 2010-12-07 17:42:31 UTC (rev 5473) @@ -153,223 +153,226 @@ <div class="contents topic"> <p class="topic-title first"><a id="contents" name="contents">Contents</a></p> <ul class="simple"> -<li><a class="reference" href="#introduction" id="id8" name="id8">Introduction</a><ul> -<li><a class="reference" href="#about-geany" id="id9" name="id9">About Geany</a></li> -<li><a class="reference" href="#where-to-get-it" id="id10" name="id10">Where to get it</a></li> -<li><a class="reference" href="#license" id="id11" name="id11">License</a></li> -<li><a class="reference" href="#about-this-document" id="id12" name="id12">About this document</a></li> +<li><a class="reference" href="#introduction" id="id7" name="id7">Introduction</a><ul> +<li><a class="reference" href="#about-geany" id="id8" name="id8">About Geany</a></li> +<li><a class="reference" href="#where-to-get-it" id="id9" name="id9">Where to get it</a></li> +<li><a class="reference" href="#license" id="id10" name="id10">License</a></li> +<li><a class="reference" href="#about-this-document" id="id11" name="id11">About this document</a></li> </ul> </li> -<li><a class="reference" href="#installation" id="id13" name="id13">Installation</a><ul> -<li><a class="reference" href="#requirements" id="id14" name="id14">Requirements</a></li> -<li><a class="reference" href="#binary-packages" id="id15" name="id15">Binary packages</a></li> -<li><a class="reference" href="#source-compilation" id="id16" name="id16">Source compilation</a><ul> -<li><a class="reference" href="#autotools-based-build-system" id="id17" name="id17">Autotools based build system</a></li> -<li><a class="reference" href="#waf-based-build-system" id="id18" name="id18">Waf based build system</a><ul> -<li><a class="reference" href="#waf-cache" id="id19" name="id19">Waf Cache</a><ul> -<li><a class="reference" href="#cleaning-the-cache" id="id20" name="id20">Cleaning the Cache</a></li> +<li><a class="reference" href="#installation" id="id12" name="id12">Installation</a><ul> +<li><a class="reference" href="#requirements" id="id13" name="id13">Requirements</a></li> +<li><a class="reference" href="#binary-packages" id="id14" name="id14">Binary packages</a></li> +<li><a class="reference" href="#source-compilation" id="id15" name="id15">Source compilation</a><ul> +<li><a class="reference" href="#autotools-based-build-system" id="id16" name="id16">Autotools based build system</a></li> +<li><a class="reference" href="#waf-based-build-system" id="id17" name="id17">Waf based build system</a><ul> +<li><a class="reference" href="#waf-cache" id="id18" name="id18">Waf Cache</a><ul> +<li><a class="reference" href="#cleaning-the-cache" id="id19" name="id19">Cleaning the Cache</a></li> </ul> </li> </ul> </li> -<li><a class="reference" href="#custom-installation" id="id21" name="id21">Custom installation</a></li> -<li><a class="reference" href="#dynamic-linking-loader-support-and-vte" id="id22" name="id22">Dynamic linking loader support and VTE</a></li> -<li><a class="reference" href="#build-problems" id="id23" name="id23">Build problems</a></li> +<li><a class="reference" href="#custom-installation" id="id20" name="id20">Custom installation</a></li> +<li><a class="reference" href="#dynamic-linking-loader-support-and-vte" id="id21" name="id21">Dynamic linking loader support and VTE</a></li> +<li><a class="reference" href="#build-problems" id="id22" name="id22">Build problems</a></li> </ul> </li> -<li><a class="reference" href="#installation-prefix" id="id24" name="id24">Installation prefix</a></li> +<li><a class="reference" href="#installation-prefix" id="id23" name="id23">Installation prefix</a></li> </ul> </li> -<li><a class="reference" href="#usage" id="id25" name="id25">Usage</a><ul> -<li><a class="reference" href="#getting-started" id="id26" name="id26">Getting started</a></li> -<li><a class="reference" href="#the-geany-workspace" id="id27" name="id27">The Geany workspace</a></li> -<li><a class="reference" href="#command-line-options" id="id28" name="id28">Command line options</a></li> -<li><a class="reference" href="#general" id="id29" name="id29">General</a><ul> -<li><a class="reference" href="#startup" id="id30" name="id30">Startup</a></li> -<li><a class="reference" href="#opening-files-from-the-command-line-in-a-running-instance" id="id31" name="id31">Opening files from the command-line in a running instance</a></li> -<li><a class="reference" href="#virtual-terminal-emulator-widget-vte" id="id32" name="id32">Virtual terminal emulator widget (VTE)</a></li> -<li><a class="reference" href="#defining-own-widget-styles-using-gtkrc-2-0" id="id33" name="id33">Defining own widget styles using .gtkrc-2.0</a></li> +<li><a class="reference" href="#usage" id="id24" name="id24">Usage</a><ul> +<li><a class="reference" href="#getting-started" id="id25" name="id25">Getting started</a></li> +<li><a class="reference" href="#the-geany-workspace" id="id26" name="id26">The Geany workspace</a></li> +<li><a class="reference" href="#command-line-options" id="id27" name="id27">Command line options</a></li> +<li><a class="reference" href="#general" id="id28" name="id28">General</a><ul> +<li><a class="reference" href="#startup" id="id29" name="id29">Startup</a></li> +<li><a class="reference" href="#opening-files-from-the-command-line-in-a-running-instance" id="id30" name="id30">Opening files from the command-line in a running instance</a></li> +<li><a class="reference" href="#virtual-terminal-emulator-widget-vte" id="id31" name="id31">Virtual terminal emulator widget (VTE)</a></li> +<li><a class="reference" href="#defining-own-widget-styles-using-gtkrc-2-0" id="id32" name="id32">Defining own widget styles using .gtkrc-2.0</a></li> </ul> </li> -<li><a class="reference" href="#documents" id="id34" name="id34">Documents</a><ul> -<li><a class="reference" href="#switching-between-documents" id="id35" name="id35">Switching between documents</a></li> +<li><a class="reference" href="#documents" id="id33" name="id33">Documents</a><ul> +<li><a class="reference" href="#switching-between-documents" id="id34" name="id34">Switching between documents</a></li> </ul> </li> -<li><a class="reference" href="#character-sets-and-unicode-byte-order-mark-bom" id="id36" name="id36">Character sets and Unicode Byte-Order-Mark (BOM)</a><ul> -<li><a class="reference" href="#using-character-sets" id="id37" name="id37">Using character sets</a></li> -<li><a class="reference" href="#in-file-encoding-specification" id="id38" name="id38">In-file encoding specification</a></li> -<li><a class="reference" href="#special-encoding-none" id="id39" name="id39">Special encoding "None"</a></li> -<li><a class="reference" href="#unicode-byte-order-mark-bom" id="id40" name="id40">Unicode Byte-Order-Mark (BOM)</a></li> +<li><a class="reference" href="#character-sets-and-unicode-byte-order-mark-bom" id="id35" name="id35">Character sets and Unicode Byte-Order-Mark (BOM)</a><ul> +<li><a class="reference" href="#using-character-sets" id="id36" name="id36">Using character sets</a></li> +<li><a class="reference" href="#in-file-encoding-specification" id="id37" name="id37">In-file encoding specification</a></li> +<li><a class="reference" href="#special-encoding-none" id="id38" name="id38">Special encoding "None"</a></li> +<li><a class="reference" href="#unicode-byte-order-mark-bom" id="id39" name="id39">Unicode Byte-Order-Mark (BOM)</a></li> </ul> </li> -<li><a class="reference" href="#editing" id="id41" name="id41">Editing</a><ul> -<li><a class="reference" href="#folding" id="id42" name="id42">Folding</a></li> -<li><a class="reference" href="#column-mode-editing-rectangular-selections" id="id43" name="id43">Column mode editing (rectangular selections)</a></li> -<li><a class="reference" href="#drag-and-drop-of-text" id="id44" name="id44">Drag and drop of text</a></li> -<li><a class="reference" href="#indentation" id="id45" name="id45">Indentation</a><ul> -<li><a class="reference" href="#applying-new-indentation-settings" id="id46" name="id46">Applying new indentation settings</a></li> -<li><a class="reference" href="#detecting-indent-type" id="id47" name="id47">Detecting indent type</a></li> +<li><a class="reference" href="#editing" id="id40" name="id40">Editing</a><ul> +<li><a class="reference" href="#folding" id="id41" name="id41">Folding</a></li> +<li><a class="reference" href="#column-mode-editing-rectangular-selections" id="id42" name="id42">Column mode editing (rectangular selections)</a></li> +<li><a class="reference" href="#drag-and-drop-of-text" id="id43" name="id43">Drag and drop of text</a></li> +<li><a class="reference" href="#indentation" id="id44" name="id44">Indentation</a><ul> +<li><a class="reference" href="#applying-new-indentation-settings" id="id45" name="id45">Applying new indentation settings</a></li> +<li><a class="reference" href="#detecting-indent-type" id="id46" name="id46">Detecting indent type</a></li> </ul> </li> -<li><a class="reference" href="#auto-indentation" id="id48" name="id48">Auto-indentation</a></li> -<li><a class="reference" href="#bookmarks" id="id49" name="id49">Bookmarks</a></li> -<li><a class="reference" href="#code-navigation-history" id="id50" name="id50">Code navigation history</a></li> -<li><a class="reference" href="#sending-text-through-custom-commands" id="id51" name="id51">Sending text through custom commands</a></li> -<li><a class="reference" href="#context-actions" id="id52" name="id52">Context actions</a></li> -<li><a class="reference" href="#autocompletion" id="id53" name="id53">Autocompletion</a><ul> -<li><a class="reference" href="#word-part-completion" id="id54" name="id54">Word part completion</a></li> -<li><a class="reference" href="#scope-autocompletion" id="id55" name="id55">Scope autocompletion</a></li> +<li><a class="reference" href="#auto-indentation" id="id47" name="id47">Auto-indentation</a></li> +<li><a class="reference" href="#bookmarks" id="id48" name="id48">Bookmarks</a></li> +<li><a class="reference" href="#code-navigation-history" id="id49" name="id49">Code navigation history</a></li> +<li><a class="reference" href="#sending-text-through-custom-commands" id="id50" name="id50">Sending text through custom commands</a></li> +<li><a class="reference" href="#context-actions" id="id51" name="id51">Context actions</a></li> +<li><a class="reference" href="#autocompletion" id="id52" name="id52">Autocompletion</a><ul> +<li><a class="reference" href="#word-part-completion" id="id53" name="id53">Word part completion</a></li> +<li><a class="reference" href="#scope-autocompletion" id="id54" name="id54">Scope autocompletion</a></li> </ul> </li> -<li><a class="reference" href="#user-definable-snippets" id="id56" name="id56">User-definable snippets</a><ul> -<li><a class="reference" href="#snippet-keybindings" id="id57" name="id57">Snippet keybindings</a></li> +<li><a class="reference" href="#user-definable-snippets" id="id55" name="id55">User-definable snippets</a><ul> +<li><a class="reference" href="#snippet-keybindings" id="id56" name="id56">Snippet keybindings</a></li> </ul> </li> -<li><a class="reference" href="#inserting-unicode-characters" id="id58" name="id58">Inserting Unicode characters</a></li> +<li><a class="reference" href="#inserting-unicode-characters" id="id57" name="id57">Inserting Unicode characters</a></li> </ul> </li> -<li><a class="reference" href="#search-replace-and-go-to" id="id59" name="id59">Search, replace and go to</a><ul> -<li><a class="reference" href="#toolbar-entries" id="id60" name="id60">Toolbar entries</a><ul> -<li><a class="reference" href="#search-bar" id="id61" name="id61">Search bar</a></li> +<li><a class="reference" href="#search-replace-and-go-to" id="id58" name="id58">Search, replace and go to</a><ul> +<li><a class="reference" href="#toolbar-entries" id="id59" name="id59">Toolbar entries</a><ul> +<li><a class="reference" href="#search-bar" id="id60" name="id60">Search bar</a></li> </ul> </li> -<li><a class="reference" href="#find" id="id62" name="id62">Find</a><ul> -<li><a class="reference" href="#matching-options" id="id63" name="id63">Matching options</a></li> -<li><a class="reference" href="#find-all" id="id64" name="id64">Find all</a></li> -<li><a class="reference" href="#change-font-in-search-dialog-text-fields" id="id65" name="id65">Change font in search dialog text fields</a></li> +<li><a class="reference" href="#find" id="id61" name="id61">Find</a><ul> +<li><a class="reference" href="#matching-options" id="id62" name="id62">Matching options</a></li> +<li><a class="reference" href="#find-all" id="id63" name="id63">Find all</a></li> +<li><a class="reference" href="#change-font-in-search-dialog-text-fields" id="id64" name="id64">Change font in search dialog text fields</a></li> </ul> </li> -<li><a class="reference" href="#find-selection" id="id66" name="id66">Find selection</a></li> -<li><a class="reference" href="#find-usage" id="id67" name="id67">Find usage</a></li> -<li><a class="reference" href="#find-in-files" id="id68" name="id68">Find in files</a><ul> -<li><a class="reference" href="#filtering-out-version-control-files" id="id69" name="id69">Filtering out version control files</a></li> +<li><a class="reference" href="#find-selection" id="id65" name="id65">Find selection</a></li> +<li><a class="reference" href="#find-usage" id="id66" name="id66">Find usage</a></li> +<li><a class="reference" href="#find-in-files" id="id67" name="id67">Find in files</a><ul> +<li><a class="reference" href="#filtering-out-version-control-files" id="id68" name="id68">Filtering out version control files</a></li> </ul> </li> -<li><a class="reference" href="#replace" id="id70" name="id70">Replace</a><ul> -<li><a class="reference" href="#replace-all" id="id71" name="id71">Replace all</a></li> +<li><a class="reference" href="#replace" id="id69" name="id69">Replace</a><ul> +<li><a class="reference" href="#replace-all" id="id70" name="id70">Replace all</a></li> </ul> </li> -<li><a class="reference" href="#go-to-tag-definition" id="id72" name="id72">Go to tag definition</a></li> -<li><a class="reference" href="#go-to-tag-declaration" id="id73" name="id73">Go to tag declaration</a></li> -<li><a class="reference" href="#go-to-line" id="id74" name="id74">Go to line</a></li> -<li><a class="reference" href="#regular-expressions" id="id75" name="id75">Regular expressions</a></li> +<li><a class="reference" href="#go-to-tag-definition" id="id71" name="id71">Go to tag definition</a></li> +<li><a class="reference" href="#go-to-tag-declaration" id="id72" name="id72">Go to tag declaration</a></li> +<li><a class="reference" href="#go-to-line" id="id73" name="id73">Go to line</a></li> +<li><a class="reference" href="#regular-expressions" id="id74" name="id74">Regular expressions</a></li> </ul> </li> -<li><a class="reference" href="#tags" id="id76" name="id76">Tags</a><ul> -<li><a class="reference" href="#workspace-tags" id="id77" name="id77">Workspace tags</a></li> -<li><a class="reference" href="#global-tags" id="id78" name="id78">Global tags</a><ul> -<li><a class="reference" href="#default-global-tags-files" id="id79" name="id79">Default global tags files</a></li> -<li><a class="reference" href="#global-tags-file-format" id="id80" name="id80">Global tags file format</a></li> -<li><a class="reference" href="#generating-a-global-tags-file" id="id81" name="id81">Generating a global tags file</a></li> +<li><a class="reference" href="#tags" id="id75" name="id75">Tags</a><ul> +<li><a class="reference" href="#workspace-tags" id="id76" name="id76">Workspace tags</a></li> +<li><a class="reference" href="#global-tags" id="id77" name="id77">Global tags</a><ul> +<li><a class="reference" href="#default-global-tags-files" id="id78" name="id78">Default global tags files</a></li> +<li><a class="reference" href="#global-tags-file-format" id="id79" name="id79">Global tags file format</a></li> +<li><a class="reference" href="#generating-a-global-tags-file" id="id80" name="id80">Generating a global tags file</a></li> </ul> </li> -<li><a class="reference" href="#ignore-tags" id="id82" name="id82">Ignore tags</a></li> +<li><a class="reference" href="#ignore-tags" id="id81" name="id81">Ignore tags</a></li> </ul> </li> -<li><a class="reference" href="#preferences" id="id83" name="id83">Preferences</a><ul> -<li><a class="reference" href="#general-startup-preferences" id="id84" name="id84">General Startup preferences</a><ul> -<li><a class="reference" href="#id1" id="id85" name="id85">Startup</a></li> -<li><a class="reference" href="#shutdown" id="id86" name="id86">Shutdown</a></li> -<li><a class="reference" href="#paths" id="id87" name="id87">Paths</a></li> +<li><a class="reference" href="#preferences" id="id82" name="id82">Preferences</a><ul> +<li><a class="reference" href="#general-startup-preferences" id="id83" name="id83">General Startup preferences</a><ul> +<li><a class="reference" href="#id1" id="id84" name="id84">Startup</a></li> +<li><a class="reference" href="#shutdown" id="id85" name="id85">Shutdown</a></li> +<li><a class="reference" href="#paths" id="id86" name="id86">Paths</a></li> </ul> </li> -<li><a class="reference" href="#general-miscellaneous-preferences" id="id88" name="id88">General Miscellaneous preferences</a><ul> -<li><a class="reference" href="#miscellaneous" id="id89" name="id89">Miscellaneous</a></li> -<li><a class="reference" href="#search" id="id90" name="id90">Search</a></li> -<li><a class="reference" href="#projects" id="id91" name="id91">Projects</a></li> +<li><a class="reference" href="#general-miscellaneous-preferences" id="id87" name="id87">General Miscellaneous preferences</a><ul> +<li><a class="reference" href="#miscellaneous" id="id88" name="id88">Miscellaneous</a></li> +<li><a class="reference" href="#search" id="id89" name="id89">Search</a></li> +<li><a class="reference" href="#projects" id="id90" name="id90">Projects</a></li> </ul> </li> -<li><a class="reference" href="#interface-preferences" id="id92" name="id92">Interface preferences</a><ul> -<li><a class="reference" href="#sidebar" id="id93" name="id93">Sidebar</a></li> -<li><a class="reference" href="#fonts" id="id94" name="id94">Fonts</a></li> -<li><a class="reference" href="#editor-tabs" id="id95" name="id95">Editor tabs</a></li> -<li><a class="reference" href="#tab-positions" id="id96" name="id96">Tab positions</a></li> -<li><a class="reference" href="#id2" id="id97" name="id97">Miscellaneous</a></li> +<li><a class="reference" href="#interface-preferences" id="id91" name="id91">Interface preferences</a><ul> +<li><a class="reference" href="#sidebar" id="id92" name="id92">Sidebar</a></li> +<li><a class="reference" href="#fonts" id="id93" name="id93">Fonts</a></li> +<li><a class="reference" href="#editor-tabs" id="id94" name="id94">Editor tabs</a></li> +<li><a class="reference" href="#tab-positions" id="id95" name="id95">Tab positions</a></li> +<li><a class="reference" href="#id2" id="id96" name="id96">Miscellaneous</a></li> </ul> </li> -<li><a class="reference" href="#toolbar-preferences" id="id98" name="id98">Toolbar preferences</a><ul> -<li><a class="reference" href="#toolbar" id="id99" name="id99">Toolbar</a></li> -<li><a class="reference" href="#appearance" id="id100" name="id100">Appearance</a></li> +<li><a class="reference" href="#toolbar-preferences" id="id97" name="id97">Toolbar preferences</a><ul> +<li><a class="reference" href="#toolbar" id="id98" name="id98">Toolbar</a></li> +<li><a class="reference" href="#appearance" id="id99" name="id99">Appearance</a></li> </ul> </li> -<li><a class="reference" href="#editor-features-preferences" id="id101" name="id101">Editor Features preferences</a><ul> -<li><a class="reference" href="#features" id="id102" name="id102">Features</a></li> +<li><a class="reference" href="#editor-features-preferences" id="id100" name="id100">Editor Features preferences</a><ul> +<li><a class="reference" href="#features" id="id101" name="id101">Features</a></li> </ul> </li> -<li><a class="reference" href="#editor-indentation-preferences" id="id103" name="id103">Editor Indentation preferences</a><ul> -<li><a class="reference" href="#indentation-group" id="id104" name="id104">Indentation group</a></li> +<li><a class="reference" href="#editor-indentation-preferences" id="id102" name="id102">Editor Indentation preferences</a><ul> +<li><a class="reference" href="#indentation-group" id="id103" name="id103">Indentation group</a></li> </ul> </li> -<li><a class="reference" href="#editor-completions-preferences" id="id105" name="id105">Editor Completions preferences</a><ul> -<li><a class="reference" href="#completions" id="id106" name="id106">Completions</a></li> -<li><a class="reference" href="#auto-close-quotes-and-brackets" id="id107" name="id107">Auto-close quotes and brackets</a></li> +<li><a class="reference" href="#editor-completions-preferences" id="id104" name="id104">Editor Completions preferences</a><ul> +<li><a class="reference" href="#completions" id="id105" name="id105">Completions</a></li> +<li><a class="reference" href="#auto-close-quotes-and-brackets" id="id106" name="id106">Auto-close quotes and brackets</a></li> </ul> </li> -<li><a class="reference" href="#editor-display-preferences" id="id108" name="id108">Editor Display preferences</a><ul> -<li><a class="reference" href="#display" id="id109" name="id109">Display</a></li> -<li><a class="reference" href="#long-line-marker" id="id110" name="id110">Long line marker</a></li> -<li><a class="reference" href="#virtual-spaces" id="id111" name="id111">Virtual spaces</a></li> +<li><a class="reference" href="#editor-display-preferences" id="id107" name="id107">Editor Display preferences</a><ul> +<li><a class="reference" href="#display" id="id108" name="id108">Display</a></li> +<li><a class="reference" href="#long-line-marker" id="id109" name="id109">Long line marker</a></li> +<li><a class="reference" href="#virtual-spaces" id="id110" name="id110">Virtual spaces</a></li> </ul> </li> -<li><a class="reference" href="#files-preferences" id="id112" name="id112">Files preferences</a><ul> -<li><a class="reference" href="#new-files" id="id113" name="id113">New files</a></li> -<li><a class="reference" href="#saving-files" id="id114" name="id114">Saving files</a></li> -<li><a class="reference" href="#id3" id="id115" name="id115">Miscellaneous</a></li> +<li><a class="reference" href="#files-preferences" id="id111" name="id111">Files preferences</a><ul> +<li><a class="reference" href="#new-files" id="id112" name="id112">New files</a></li> +<li><a class="reference" href="#saving-files" id="id113" name="id113">Saving files</a></li> +<li><a class="reference" href="#id3" id="id114" name="id114">Miscellaneous</a></li> </ul> </li> -<li><a class="reference" href="#tools-preferences" id="id116" name="id116">Tools preferences</a><ul> -<li><a class="reference" href="#tool-paths" id="id117" name="id117">Tool paths</a></li> -<li><a class="reference" href="#commands" id="id118" name="id118">Commands</a></li> +<li><a class="reference" href="#tools-preferences" id="id115" name="id115">Tools preferences</a><ul> +<li><a class="reference" href="#tool-paths" id="id116" name="id116">Tool paths</a></li> +<li><a class="reference" href="#commands" id="id117" name="id117">Commands</a></li> </ul> </li> -<li><a class="reference" href="#template-preferences" id="id119" name="id119">Template preferences</a><ul> -<li><a class="reference" href="#template-data" id="id120" name="id120">Template data</a></li> +<li><a class="reference" href="#template-preferences" id="id118" name="id118">Template preferences</a><ul> +<li><a class="reference" href="#template-data" id="id119" name="id119">Template data</a></li> </ul> </li> -<li><a class="reference" href="#keybinding-preferences" id="id121" name="id121">Keybinding preferences</a></li> -<li><a class="reference" href="#printing-preferences" id="id122" name="id122">Printing preferences</a></li> -<li><a class="reference" href="#terminal-vte-preferences" id="id123" name="id123">Terminal (VTE) preferences</a><ul> -<li><a class="reference" href="#terminal-widget" id="id124" name="id124">Terminal widget</a></li> +<li><a class="reference" href="#keybinding-preferences" id="id120" name="id120">Keybinding preferences</a></li> +<li><a class="reference" href="#printing-preferences" id="id121" name="id121">Printing preferences</a></li> +<li><a class="reference" href="#terminal-vte-preferences" id="id122" name="id122">Terminal (VTE) preferences</a><ul> +<li><a class="reference" href="#terminal-widget" id="id123" name="id123">Terminal widget</a></li> </ul> </li> </ul> </li> -<li><a class="reference" href="#project-management" id="id125" name="id125">Project Management</a><ul> -<li><a class="reference" href="#new-project" id="id126" name="id126">New Project</a></li> -<li><a class="reference" href="#project-properties" id="id127" name="id127">Project Properties</a></li> -<li><a class="reference" href="#open-project" id="id128" name="id128">Open Project</a></li> -<li><a class="reference" href="#close-project" id="id129" name="id129">Close Project</a></li> +<li><a class="reference" href="#project-management" id="id124" name="id124">Project Management</a><ul> +<li><a class="reference" href="#new-project" id="id125" name="id125">New Project</a></li> +<li><a class="reference" href="#project-properties" id="id126" name="id126">Project Properties</a></li> +<li><a class="reference" href="#open-project" id="id127" name="id127">Open Project</a></li> +<li><a class="reference" href="#close-project" id="id128" name="id128">Close Project</a></li> </ul> </li> -<li><a class="reference" href="#build-menu" id="id130" name="id130">Build Menu</a><ul> -<li><a class="reference" href="#indicators" id="id131" name="id131">Indicators</a></li> -<li><a class="reference" href="#default-build-menu-items" id="id132" name="id132">Default Build Menu Items</a><ul> -<li><a class="reference" href="#compile" id="id133" name="id133">Compile</a></li> -<li><a class="reference" href="#build" id="id134" name="id134">Build</a></li> -<li><a class="reference" href="#make" id="id135" name="id135">Make</a></li> -<li><a class="reference" href="#make-custom-target" id="id136" name="id136">Make custom target</a></li> -<li><a class="reference" href="#make-object" id="id137" name="id137">Make object</a></li> -<li><a class="reference" href="#next-error" id="id138" name="id138">Next Error</a></li> -<li><a class="reference" href="#previous-error" id="id139" name="id139">Previous Error</a></li> -<li><a class="reference" href="#execute" id="id140" name="id140">Execute</a></li> -<li><a class="reference" href="#stopping-running-processes" id="id141" name="id141">Stopping running processes</a><ul> -<li><a class="reference" href="#terminal-emulators" id="id142" name="id142">Terminal emulators</a></li> +<li><a class="reference" href="#build-menu" id="id129" name="id129">Build Menu</a><ul> +<li><a class="reference" href="#indicators" id="id130" name="id130">Indicators</a></li> +<li><a class="reference" href="#default-build-menu-items" id="id131" name="id131">Default Build Menu Items</a><ul> +<li><a class="reference" href="#compile" id="id132" name="id132">Compile</a></li> +<li><a class="reference" href="#build" id="id133" name="id133">Build</a></li> +<li><a class="reference" href="#make" id="id134" name="id134">Make</a></li> +<li><a class="reference" href="#make-custom-target" id="id135" name="id135">Make custom target</a></li> +<li><a class="reference" href="#make-object" id="id136" name="id136">Make object</a></li> +<li><a class="reference" href="#next-error" id="id137" name="id137">Next Error</a></li> +<li><a class="reference" href="#previous-error" id="id138" name="id138">Previous Error</a></li> +<li><a class="reference" href="#execute" id="id139" name="id139">Execute</a></li> +<li><a class="reference" href="#stopping-running-processes" id="id140" name="id140">Stopping running processes</a><ul> +<li><a class="reference" href="#terminal-emulators" id="id141" name="id141">Terminal emulators</a></li> </ul> </li> -<li><a class="reference" href="#set-build-commands" id="id143" name="id143">Set Build Commands</a></li> +<li><a class="reference" href="#set-build-commands" id="id142" name="id142">Set Build Commands</a></li> </ul> </li> -<li><a class="reference" href="#build-menu-configuration" id="id144" name="id144">Build Menu Configuration</a></li> -<li><a class="reference" href="#build-menu-commands-dialog" id="id145" name="id145">Build Menu Commands Dialog</a><ul> -<li><a class="reference" href="#substitutions-in-commands-and-working-directories" id="id146" name="id146">Substitutions in Commands and Working Directories</a></li> -<li><a class="reference" href="#build-menu-keyboard-shortcuts" id="id147" name="id147">Build Menu Keyboard Shortcuts</a></li> -<li><a class="reference" href="#configuration-files" id="id148" name="id148">Configuration Files</a></li> +<li><a class="reference" href="#build-menu-configuration" id="id143" name="id143">Build Menu Configuration</a></li> +<li><a class="reference" href="#build-menu-commands-dialog" id="id144" name="id144">Build Menu Commands Dialog</a><ul> +<li><a class="reference" href="#substitutions-in-commands-and-working-directories" id="id145" name="id145">Substitutions in Commands and Working Directories</a></li> +<li><a class="reference" href="#build-menu-keyboard-shortcuts" id="id146" name="id146">Build Menu Keyboard Shortcuts</a></li> +<li><a class="reference" href="#old-settings" id="id147" name="id147">Old settings</a></li> </ul> </li> </ul> </li> -<li><a class="reference" href="#printing-support" id="id149" name="id149">Printing support</a></li> -<li><a class="reference" href="#plugins" id="id150" name="id150">Plugins</a></li> +<li><a class="reference" href="#printing-support" id="id148" name="id148">Printing support</a></li> +<li><a class="reference" href="#plugins" id="id149" name="id149">Plugins</a><ul> +<li><a class="reference" href="#plugin-manager" id="id150" name="id150">Plugin Manager</a></li> +</ul> +</li> <li><a class="reference" href="#keybindings" id="id151" name="id151">Keybindings</a><ul> <li><a class="reference" href="#switching-documents" id="id152" name="id152">Switching documents</a></li> <li><a class="reference" href="#configurable-keybindings" id="id153" name="id153">Configurable keybindings</a><ul> @@ -395,110 +398,114 @@ </li> </ul> </li> -<li><a class="reference" href="#id4" id="id170" name="id170">Configuration files</a><ul> -<li><a class="reference" href="#tools-menu-items" id="id171" name="id171">Tools menu items</a></li> -<li><a class="reference" href="#global-configuration-file" id="id172" name="id172">Global configuration file</a></li> -<li><a class="reference" href="#filetype-definition-files" id="id173" name="id173">Filetype definition files</a><ul> -<li><a class="reference" href="#custom-filetypes" id="id174" name="id174">Custom filetypes</a></li> -<li><a class="reference" href="#system-files" id="id175" name="id175">System files</a></li> -<li><a class="reference" href="#user-files" id="id176" name="id176">User files</a></li> -<li><a class="reference" href="#filetype-configuration" id="id177" name="id177">Filetype configuration</a><ul> -<li><a class="reference" href="#styling-section" id="id178" name="id178">[styling] Section</a><ul> -<li><a class="reference" href="#using-a-named-style" id="id179" name="id179">Using a named style</a></li> +<li><a class="reference" href="#configuration-files" id="id170" name="id170">Configuration files</a><ul> +<li><a class="reference" href="#configuration-file-paths" id="id171" name="id171">Configuration file paths</a><ul> +<li><a class="reference" href="#paths-on-unix-like-systems" id="id172" name="id172">Paths on Unix-like systems</a></li> </ul> </li> -<li><a class="reference" href="#keywords-section" id="id180" name="id180">[keywords] Section</a></li> -<li><a class="reference" href="#lexer-properties-section" id="id181" name="id181">[lexer_properties] Section</a></li> -<li><a class="reference" href="#settings-section" id="id182" name="id182">[settings] Section</a></li> -<li><a class="reference" href="#build-settings-section" id="id183" name="id183">[build_settings] Section</a></li> +<li><a class="reference" href="#tools-menu-items" id="id173" name="id173">Tools menu items</a></li> +<li><a class="reference" href="#global-configuration-file" id="id174" name="id174">Global configuration file</a></li> +<li><a class="reference" href="#filetype-definition-files" id="id175" name="id175">Filetype definition files</a><ul> +<li><a class="reference" href="#custom-filetypes" id="id176" name="id176">Custom filetypes</a></li> +<li><a class="reference" href="#system-files" id="id177" name="id177">System files</a></li> +<li><a class="reference" href="#user-files" id="id178" name="id178">User files</a></li> +<li><a class="reference" href="#filetype-configuration" id="id179" name="id179">Filetype configuration</a><ul> +<li><a class="reference" href="#styling-section" id="id180" name="id180">[styling] Section</a><ul> +<li><a class="reference" href="#using-a-named-style" id="id181" name="id181">Using a named style</a></li> </ul> </li> -<li><a class="reference" href="#special-file-filetypes-common" id="id184" name="id184">Special file filetypes.common</a><ul> -<li><a class="reference" href="#named-styles-section" id="id185" name="id185">[named_styles] Section</a></li> -<li><a class="reference" href="#id5" id="id186" name="id186">[styling] Section</a></li> -<li><a class="reference" href="#id6" id="id187" name="id187">[settings] Section</a></li> +<li><a class="reference" href="#keywords-section" id="id182" name="id182">[keywords] Section</a></li> +<li><a class="reference" href="#lexer-properties-section" id="id183" name="id183">[lexer_properties] Section</a></li> +<li><a class="reference" href="#settings-section" id="id184" name="id184">[settings] Section</a></li> +<li><a class="reference" href="#build-settings-section" id="id185" name="id185">[build_settings] Section</a></li> </ul> </li> +<li><a class="reference" href="#special-file-filetypes-common" id="id186" name="id186">Special file filetypes.common</a><ul> +<li><a class="reference" href="#named-styles-section" id="id187" name="id187">[named_styles] Section</a></li> +<li><a class="reference" href="#id4" id="id188" name="id188">[styling] Section</a></li> +<li><a class="reference" href="#id5" id="id189" name="id189">[settings] Section</a></li> </ul> </li> -<li><a class="reference" href="#filetype-extensions" id="id188" name="id188">Filetype extensions</a></li> -<li><a class="reference" href="#preferences-file-format" id="id189" name="id189">Preferences File Format</a><ul> -<li><a class="reference" href="#hidden-preferences" id="id190" name="id190">Hidden preferences</a></li> -<li><a class="reference" href="#build-menu-section" id="id191" name="id191">[build-menu] Section</a></li> </ul> </li> -<li><a class="reference" href="#project-file-format" id="id192" name="id192">Project File Format</a><ul> -<li><a class="reference" href="#build-menu-additions" id="id193" name="id193">[build-menu] Additions</a></li> +<li><a class="reference" href="#filetype-extensions" id="id190" name="id190">Filetype extensions</a></li> +<li><a class="reference" href="#preferences-file-format" id="id191" name="id191">Preferences File Format</a><ul> +<li><a class="reference" href="#hidden-preferences" id="id192" name="id192">Hidden preferences</a></li> +<li><a class="reference" href="#build-menu-section" id="id193" name="id193">[build-menu] Section</a></li> </ul> </li> -<li><a class="reference" href="#templates" id="id194" name="id194">Templates</a><ul> -<li><a class="reference" href="#template-meta-data" id="id195" name="id195">Template meta data</a></li> -<li><a class="reference" href="#file-templates" id="id196" name="id196">File templates</a><ul> -<li><a class="reference" href="#custom-file-templates" id="id197" name="id197">Custom file templates</a></li> -<li><a class="reference" href="#filetype-templates" id="id198" name="id198">Filetype templates</a></li> +<li><a class="reference" href="#project-file-format" id="id194" name="id194">Project File Format</a><ul> +<li><a class="reference" href="#build-menu-additions" id="id195" name="id195">[build-menu] Additions</a></li> </ul> </li> -<li><a class="reference" href="#customizing-templates" id="id199" name="id199">Customizing templates</a><ul> -<li><a class="reference" href="#template-wildcards" id="id200" name="id200">Template wildcards</a><ul> -<li><a class="reference" href="#special-command-wildcard" id="id201" name="id201">Special {command:} wildcard</a></li> +<li><a class="reference" href="#templates" id="id196" name="id196">Templates</a><ul> +<li><a class="reference" href="#template-meta-data" id="id197" name="id197">Template meta data</a></li> +<li><a class="reference" href="#file-templates" id="id198" name="id198">File templates</a><ul> +<li><a class="reference" href="#custom-file-templates" id="id199" name="id199">Custom file templates</a></li> +<li><a class="reference" href="#filetype-templates" id="id200" name="id200">Filetype templates</a></li> </ul> </li> +<li><a class="reference" href="#customizing-templates" id="id201" name="id201">Customizing templates</a><ul> +<li><a class="reference" href="#template-wildcards" id="id202" name="id202">Template wildcards</a><ul> +<li><a class="reference" href="#special-command-wildcard" id="id203" name="id203">Special {command:} wildcard</a></li> </ul> </li> </ul> </li> -<li><a class="reference" href="#customizing-the-toolbar" id="id202" name="id202">Customizing the toolbar</a><ul> -<li><a class="reference" href="#manually-editing-of-the-toolbar-layout" id="id203" name="id203">Manually editing of the toolbar layout</a></li> -<li><a class="reference" href="#available-toolbar-elements" id="id204" name="id204">Available toolbar elements</a></li> </ul> </li> +<li><a class="reference" href="#customizing-the-toolbar" id="id204" name="id204">Customizing the toolbar</a><ul> +<li><a class="reference" href="#manually-editing-the-toolbar-layout" id="id205" name="id205">Manually editing the toolbar layout</a></li> +<li><a class="reference" href="#available-toolbar-elements" id="id206" name="id206">Available toolbar elements</a></li> </ul> </li> -<li><a class="reference" href="#plugin-documentation" id="id205" name="id205">Plugin documentation</a><ul> -<li><a class="reference" href="#htmlchars" id="id206" name="id206">HTMLChars</a><ul> -<li><a class="reference" href="#insert-entity-dialog" id="id207" name="id207">Insert entity dialog</a></li> -<li><a class="reference" href="#replace-special-chars-by-its-entity" id="id208" name="id208">Replace special chars by its entity</a><ul> -<li><a class="reference" href="#at-typing-time" id="id209" name="id209">At typing time</a></li> -<li><a class="reference" href="#bulk-replacement" id="id210" name="id210">Bulk replacement</a></li> </ul> </li> +<li><a class="reference" href="#plugin-documentation" id="id207" name="id207">Plugin documentation</a><ul> +<li><a class="reference" href="#htmlchars" id="id208" name="id208">HTMLChars</a><ul> +<li><a class="reference" href="#insert-entity-dialog" id="id209" name="id209">Insert entity dialog</a></li> +<li><a class="reference" href="#replace-special-chars-by-its-entity" id="id210" name="id210">Replace special chars by its entity</a><ul> +<li><a class="reference" href="#at-typing-time" id="id211" name="id211">At typing time</a></li> +<li><a class="reference" href="#bulk-replacement" id="id212" name="id212">Bulk replacement</a></li> </ul> </li> -<li><a class="reference" href="#save-actions" id="id211" name="id211">Save Actions</a><ul> -<li><a class="reference" href="#instant-save" id="id212" name="id212">Instant Save</a></li> -<li><a class="reference" href="#backup-copy" id="id213" name="id213">Backup Copy</a></li> </ul> </li> +<li><a class="reference" href="#save-actions" id="id213" name="id213">Save Actions</a><ul> +<li><a class="reference" href="#instant-save" id="id214" name="id214">Instant Save</a></li> +<li><a class="reference" href="#backup-copy" id="id215" name="id215">Backup Copy</a></li> </ul> </li> -<li><a class="reference" href="#contributing-to-this-document" id="id214" name="id214">Contributing to this document</a></li> -<li><a class="reference" href="#scintilla-keyboard-commands" id="id215" name="id215">Scintilla keyboard commands</a><ul> -<li><a class="reference" href="#keyboard-commands" id="id216" name="id216">Keyboard commands</a></li> </ul> </li> -<li><a class="reference" href="#tips-and-tricks" id="id217" name="id217">Tips and tricks</a><ul> -<li><a class="reference" href="#document-notebook" id="id218" name="id218">Document notebook</a></li> -<li><a class="reference" href="#editor" id="id219" name="id219">Editor</a></li> -<li><a class="reference" href="#interface" id="id220" name="id220">Interface</a></li> -<li><a class="reference" href="#gtk-related" id="id221" name="id221">GTK-related</a></li> +<li><a class="reference" href="#contributing-to-this-document" id="id216" name="id216">Contributing to this document</a></li> +<li><a class="reference" href="#scintilla-keyboard-commands" id="id217" name="id217">Scintilla keyboard commands</a><ul> +<li><a class="reference" href="#keyboard-commands" id="id218" name="id218">Keyboard commands</a></li> </ul> </li> -<li><a class="reference" href="#compile-time-options" id="id222" name="id222">Compile-time options</a><ul> -<li><a class="reference" href="#src-geany-h" id="id223" name="id223">src/geany.h</a></li> -<li><a class="reference" href="#project-h" id="id224" name="id224">project.h</a></li> -<li><a class="reference" href="#editor-h" id="id225" name="id225">editor.h</a></li> -<li><a class="reference" href="#keyfile-c" id="id226" name="id226">keyfile.c</a></li> -<li><a class="reference" href="#build-c" id="id227" name="id227">build.c</a></li> +<li><a class="reference" href="#tips-and-tricks" id="id219" name="id219">Tips and tricks</a><ul> +<li><a class="reference" href="#document-notebook" id="id220" name="id220">Document notebook</a></li> +<li><a class="reference" href="#editor" id="id221" name="id221">Editor</a></li> +<li><a class="reference" href="#interface" id="id222" name="id222">Interface</a></li> +<li><a class="reference" href="#gtk-related" id="id223" name="id223">GTK-related</a></li> </ul> </li> -<li><a class="reference" href="#gnu-general-public-license" id="id228" name="id228">GNU General Public License</a></li> -<li><a class="reference" href="#license-for-scintilla-and-scite" id="id229" name="id229">License for Scintilla and SciTE</a></li> +<li><a class="reference" href="#compile-time-options" id="id224" name="id224">Compile-time options</a><ul> +<li><a class="reference" href="#src-geany-h" id="id225" name="id225">src/geany.h</a></li> +<li><a class="reference" href="#project-h" id="id226" name="id226">project.h</a></li> +<li><a class="reference" href="#editor-h" id="id227" name="id227">editor.h</a></li> +<li><a class="reference" href="#keyfile-c" id="id228" name="id228">keyfile.c</a></li> +<li><a class="reference" href="#build-c" id="id229" name="id229">build.c</a></li> </ul> +</li> +<li><a class="reference" href="#gnu-general-public-license" id="id230" name="id230">GNU General Public License</a></li> +<li><a class="reference" href="#license-for-scintilla-and-scite" id="id231" name="id231">License for Scintilla and SciTE</a></li> +</ul> </div> <div class="section"> -<h1><a class="toc-backref" href="#id8" id="introduction" name="introduction">Introduction</a></h1> +<h1><a class="toc-backref" href="#id7" id="introduction" name="introduction">Introduction</a></h1> <div class="section"> -<h2><a class="toc-backref" href="#id9" id="about-geany" name="about-geany">About Geany</a></h2> +<h2><a class="toc-backref" href="#id8" id="about-geany" name="about-geany">About Geany</a></h2> <p>Geany is a small and lightweight Integrated Development Environment. It was developed to provide a small and fast IDE, which has only a few dependencies on other packages. Another goal was to be as independent @@ -522,13 +529,13 @@ </ul> </div> <div class="section"> -<h2><a class="toc-backref" href="#id10" id="where-to-get-it" name="where-to-get-it">Where to get it</a></h2> +<h2><a class="toc-backref" href="#id9" id="where-to-get-it" name="where-to-get-it">Where to get it</a></h2> <p>You can obtain Geany from <a class="reference" href="http://www.geany.org/">http://www.geany.org/</a> or perhaps also from your distribution. For a list of available packages, please see <a class="reference" href="http://www.geany.org/Download/ThirdPartyPackages">http://www.geany.org/Download/ThirdPartyPackages</a>.</p> </div> <div class="section"> -<h2><a class="toc-backref" href="#id11" id="license" name="license">License</a></h2> +<h2><a class="toc-backref" href="#id10" id="license" name="license">License</a></h2> <p>Geany is distributed under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. A copy of this @@ -539,28 +546,28 @@ <a class="reference" href="#license-for-scintilla-and-scite">License for Scintilla and SciTE</a>.</p> </div> <div class="section"> -<h2><a class="toc-backref" href="#id12" id="about-this-document" name="about-this-document">About this document</a></h2> +<h2><a class="toc-backref" href="#id11" id="about-this-document" name="about-this-document">About this document</a></h2> <p>This documentation is available in HTML and text formats. The latest version can always be found at <a class="reference" href="http://www.geany.org/">http://www.geany.org/</a>.</p> <p>If you want to contribute to it, see <a class="reference" href="#contributing-to-this-document">Contributing to this document</a>.</p> </div> </div> <div class="section"> -<h1><a class="toc-backref" href="#id13" id="installation" name="installation">Installation</a></h1> +<h1><a class="toc-backref" href="#id12" id="installation" name="installation">Installation</a></h1> <div class="section"> -<h2><a class="toc-backref" href="#id14" id="requirements" name="requirements">Requirements</a></h2> +<h2><a class="toc-backref" href="#id13" id="requirements" name="requirements">Requirements</a></h2> <p>You will need the GTK (>= 2.8.0) libraries and their dependencies (Pango, GLib and ATK). Your distro should provide packages for these, usually installed by default. For Windows, you can download an installer from the website which bundles these libraries.</p> </div> <div class="section"> -<h2><a class="toc-backref" href="#id15" id="binary-packages" name="binary-packages">Binary packages</a></h2> +<h2><a class="toc-backref" href="#id14" id="binary-packages" name="binary-packages">Binary packages</a></h2> <p>There are many binary packages available. For an up-to-date but maybe incomplete list see <a class="reference" href="http://www.geany.org/Download/ThirdPartyPackages">http://www.geany.org/Download/ThirdPartyPackages</a>.</p> </div> <div class="section"> -<h2><a class="toc-backref" href="#id16" id="source-compilation" name="source-compilation">Source compilation</a></h2> +<h2><a class="toc-backref" href="#id15" id="source-compilation" name="source-compilation">Source compilation</a></h2> <p>Compiling Geany is quite easy. To do so, you need the GTK (>= 2.8.0) libraries and header files. You also need the Pango, GLib and ATK libraries and header files. @@ -570,7 +577,7 @@ <p>Furthermore you need, of course, a C and C++ compiler. The GNU versions of these tools are recommended.</p> <div class="section"> -<h3><a class="toc-backref" href="#id17" id="autotools-based-build-system" name="autotools-based-build-system">Autotools based build system</a></h3> +<h3><a class="toc-backref" href="#id16" id="autotools-based-build-system" name="autotools-based-build-system">Autotools based build system</a></h3> <p>The Autotools based build system is very mature and has been well tested. To use it, you just need the Make tool, preferably GNU Make.</p> <p>Then run the following commands:</p> @@ -584,7 +591,7 @@ </pre> </div> <div class="section"> -<h3><a class="toc-backref" href="#id18" id="waf-based-build-system" name="waf-based-build-system">Waf based build system</a></h3> +<h3><a class="toc-backref" href="#id17" id="waf-based-build-system" name="waf-based-build-system">Waf based build system</a></h3> <p>The Waf build system is still quite young and under heavy development but already in a usable state. In contrast to the Autotools system, Waf needs Python. So before using Waf, you need to install Python on your system. @@ -603,7 +610,7 @@ % ./waf install </pre> <div class="section"> -<h4><a class="toc-backref" href="#id19" id="waf-cache" name="waf-cache">Waf Cache</a></h4> +<h4><a class="toc-backref" href="#id18" id="waf-cache" name="waf-cache">Waf Cache</a></h4> <p>The Waf build system has a nice and interesting feature which can help to avoid a lot of unnecessary rebuilding of unchanged code. This often happens when developing new features or trying to debug something in Geany. @@ -623,7 +630,7 @@ <p>More information about the Waf cache feature are available at <a class="reference" href="http://code.google.com/p/waf/wiki/CacheObjectFiles">http://code.google.com/p/waf/wiki/CacheObjectFiles</a>.</p> <div class="section"> -<h5><a class="toc-backref" href="#id20" id="cleaning-the-cache" name="cleaning-the-cache">Cleaning the Cache</a></h5> +<h5><a class="toc-backref" href="#id19" id="cleaning-the-cache" name="cleaning-the-cache">Cleaning the Cache</a></h5> <p>You should be careful about the size of the cache directory as it may grow rapidly over time. Waf doesn't do any cleaning or other house-keeping of the cache yet, so you need to keep it @@ -639,7 +646,7 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id21" id="custom-installation" name="custom-installation">Custom installation</a></h3> +<h3><a class="toc-backref" href="#id20" 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"> @@ -657,14 +664,14 @@ </ul> </div> <div class="section"> -<h3><a class="toc-backref" href="#id22" id="dynamic-linking-loader-support-and-vte" name="dynamic-linking-loader-support-and-vte">Dynamic linking loader support and VTE</a></h3> +<h3><a class="toc-backref" href="#id21" id="dynamic-linking-loader-support-and-vte" name="dynamic-linking-loader-support-and-vte">Dynamic linking loader support and VTE</a></h3> <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 for automatically loading <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="#id23" id="build-problems" name="build-problems">Build problems</a></h3> +<h3><a class="toc-backref" href="#id22" id="build-problems" name="build-problems">Build problems</a></h3> <p>If there are any errors during compilation, check your build environment and try to find the error, otherwise contact the mailing list or one the authors. Sometimes you might need to ask for specific @@ -672,21 +679,25 @@ </div> </div> <div class="section"> -<h2><a class="toc-backref" href="#id24" id="installation-prefix" name="installation-prefix">Installation prefix</a></h2> -<p>If you want to edit any of Geany's system configuration files after -installation you will need to know the installation prefix. Usually this -is not necessary as you can just use per user configuration files and -you will not need root permissions.</p> -<p>Use the <tt class="docutils literal"><span class="pre">--print-prefix</span></tt> option to Geany to check - see <a class="reference" href="#command-line-options">Command line -options</a>. The first path is the prefix.</p> -<p>This is commonly <tt class="docutils literal"><span class="pre">/usr</span></tt> if you installed from a binary package, or -<tt class="docutils literal"><span class="pre">/usr/local</span></tt> if you build from source.</p> +<h2><a class="toc-backref" href="#id23" id="installation-prefix" name="installation-prefix">Installation prefix</a></h2> +<p>If you want to find Geany's system files after installation you may +want to know the installation prefix.</p> +<p>Pass the <tt class="docutils literal"><span class="pre">--print-prefix</span></tt> option to Geany to check this - see +<a class="reference" href="#command-line-options">Command line options</a>. The first path is the prefix.</p> +<p>On Unix-like systems this is commonly <tt class="docutils literal"><span class="pre">/usr</span></tt> if you installed from +a binary package, or <tt class="docutils literal"><span class="pre">/usr/local</span></tt> if you build from source.</p> +<div class="note"> +<p class="first admonition-title">Note</p> +<p class="last">Editing system files is not necessary as you can use the +per-user configuration files instead, which don't need root +permissions. See <a class="reference" href="#configuration-files">Configuration files</a>.</p> </div> </div> +</div> <div class="section"> -<h1><a class="toc-backref" href="#id25" id="usage" name="usage">Usage</a></h1> +<h1><a class="toc-backref" href="#id24" id="usage" name="usage">Usage</a></h1> <div class="section"> -<h2><a class="toc-backref" href="#id26" id="getting-started" name="getting-started">Getting started</a></h2> +<h2><a class="toc-backref" href="#id25" 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> @@ -703,7 +714,7 @@ </ul> </div> <div class="section"> -<h2><a class="toc-backref" href="#id27" id="the-geany-workspace" name="the-geany-workspace">The Geany workspace</a></h2> +<h2><a class="toc-backref" href="#id26" id="the-geany-workspace" name="the-geany-workspace">The Geany workspace</a></h2> <p>The Geany window is shown in the following figure:</p> <img alt="./images/main_window.png" src="./images/main_window.png" /> <p>The workspace has the following parts:</p> @@ -732,7 +743,7 @@ dragging the dividers.</p> </div> <div class="section"> -<h2><a class="toc-backref" href="#id28" id="command-line-options" name="command-line-options">Command line options</a></h2> +<h2><a class="toc-backref" href="#id27" id="command-line-options" name="command-line-options">Command line options</a></h2> <table border="1" class="docutils"> <colgroup> <col width="9%" /> @@ -816,7 +827,7 @@ <tr><td><em>none</em></td> <td>--print-prefix</td> <td>Print installation prefix, the data directory, the lib -directory and the locale directory (in this order) to +directory and the locale directory (in that order) to stdout, one line each. This is mainly intended for plugin authors to detect installation paths.</td> </tr> @@ -886,9 +897,9 @@ help screen.</p> </div> <div class="section"> -<h2><a class="toc-backref" href="#id29" id="general" name="general">General</a></h2> +<h2><a class="toc-backref" href="#id28" id="general" name="general">General</a></h2> <div class="section"> -<h3><a class="toc-backref" href="#id30" id="startup" name="startup">Startup</a></h3> +<h3><a class="toc-backref" href="#id29" id="startup" name="startup">Startup</a></h3> <p>At startup, Geany loads all files from the last time Geany was launched. You can disable this feature in the preferences dialog (see <a class="reference" href="#general-startup-preferences">General Startup preferences</a>). If you specify some @@ -903,7 +914,7 @@ files in a running instance using the appropriate command line option.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id31" 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="#id30" id="opening-files-from-the-command-line-in-a-running-instance" name="opening-files-from-the-command-line-in-a-running-instance">Opening files from the command-line in a running instance</a></h3> <p>Geany detects if there is an an instance of itself already running and opens files from the command-line in that instance. So, Geany can be used to view and edit files by opening them from other programs @@ -919,7 +930,7 @@ called <a class="reference" href="#command-line-options">Command line options</a>.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id32" 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="#id31" id="virtual-terminal-emulator-widget-vte" name="virtual-terminal-emulator-widget-vte">Virtual terminal emulator widget (VTE)</a></h3> <p>If you have installed <tt class="docutils literal"><span class="pre">libvte.so</span></tt> on your system, it is loaded automatically by Geany, and you will have a terminal widget in the notebook at the bottom.</p> @@ -963,7 +974,7 @@ ./configure.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id33" 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="#id32" id="defining-own-widget-styles-using-gtkrc-2-0" name="defining-own-widget-styles-using-gtkrc-2-0">Defining own widget styles using .gtkrc-2.0</a></h3> <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 @@ -1004,9 +1015,9 @@ </div> </div> <div class="section"> -<h2><a class="toc-backref" href="#id34" id="documents" name="documents">Documents</a></h2> +<h2><a class="toc-backref" href="#id33" id="documents" name="documents">Documents</a></h2> <div class="section"> -<h3><a class="toc-backref" href="#id35" id="switching-between-documents" name="switching-between-documents">Switching between documents</a></h3> +<h3><a class="toc-backref" href="#id34" 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 @@ -1019,9 +1030,9 @@ </div> </div> <div class="section"> -<h2><a class="toc-backref" href="#id36" 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="#id35" id="character-sets-and-unicode-byte-order-mark-bom" name="character-sets-and-unicode-byte-order-mark-bom">Character sets and Unicode Byte-Order-Mark (BOM)</a></h2> <div class="section"> -<h3><a class="toc-backref" href="#id37" id="using-character-sets" name="using-character-sets">Using character sets</a></h3> +<h3><a class="toc-backref" href="#id36" 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 convert a file from one character set to another. To do this, @@ -1068,7 +1079,7 @@ </ul> </div> <div class="section"> -<h3><a class="toc-backref" href="#id38" id="in-file-encoding-specification" name="in-file-encoding-specification">In-file encoding specification</a></h3> +<h3><a class="toc-backref" href="#id37" 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"> @@ -1111,7 +1122,7 @@ </pre> </div> <div class="section"> -<h3><a class="toc-backref" href="#id39" id="special-encoding-none" name="special-encoding-none">Special encoding "None"</a></h3> +<h3><a class="toc-backref" href="#id38" id="special-encoding-none" name="special-encoding-none">Special encoding "None"</a></h3> <p>There is a special encoding "None" which uses no encoding. It is useful when you know that Geany cannot auto-detect the encoding of a file and it is not displayed correctly. Especially @@ -1121,7 +1132,7 @@ without any character conversion.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id40" 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="#id39" id="unicode-byte-order-mark-bom" name="unicode-byte-order-mark-bom">Unicode Byte-Order-Mark (BOM)</a></h3> <p>Furthermore, Geany detects a Unicode Byte Order Mark (see <a class="reference" href="http://en.wikipedia.org/wiki/Byte_Order_Mark">http://en.wikipedia.org/wiki/Byte_Order_Mark</a> for details). Of course, this feature is only available if the opened file is in a Unicode @@ -1144,9 +1155,9 @@ </div> </div> <div class="section"> -<h2><a class="toc-backref" href="#id41" id="editing" name="editing">Editing</a></h2> +<h2><a class="toc-backref" href="#id40" id="editing" name="editing">Editing</a></h2> <div class="section"> -<h3><a class="toc-backref" href="#id42" id="folding" name="folding">Folding</a></h3> +<h3><a class="toc-backref" href="#id41" 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 @@ -1176,7 +1187,7 @@ it for this click and vice versa.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id43" id="column-mode-editing-rectangular-selections" name="column-mode-editing-rectangular-selections">Column mode editing (rectangular selections)</a></h3> +<h3><a class="toc-backref" href="#id42" id="column-mode-editing-rectangular-selections" name="column-mode-editing-rectangular-selections">Column mode editing (rectangular selections)</a></h3> <p>There is basic support for column mode editing. To use it, create a rectangular selection by holding down the Control and Shift keys (or Control and Alt if it doesn't work) while @@ -1186,7 +1197,7 @@ selection.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id44" 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="#id43" 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 @@ -1194,7 +1205,7 @@ before the selected text was copied to the new position.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id45" id="indentation" name="indentation">Indentation</a></h3> +<h3><a class="toc-backref" href="#id44" id="indentation" name="indentation">Indentation</a></h3> <p>Geany allows each document to indent either with a tab character, multiple spaces or a combination of both. The default indent settings are set in <a class="reference" href="#editor-indentation-preferences">Editor Indentation preferences</a> (see the link @@ -1214,20 +1225,20 @@ on a line.</dd> </dl> <div class="section"> -<h4><a class="toc-backref" href="#id46" id="applying-new-indentation-settings" name="applying-new-indentation-settings">Applying new indentation settings</a></h4> +<h4><a class="toc-backref" href="#id45" id="applying-new-indentation-settings" name="applying-new-indentation-settings">Applying new indentation settings</a></h4> <p>After changing the default settings you may wish to apply the new settings to every document in the current session. To do this use the <em>Project->Apply Default Indentation</em> menu item.</p> </div> <div class="section"> -<h4><a class="toc-backref" href="#id47" id="detecting-indent-type" name="detecting-indent-type">Detecting indent type</a></h4> +<h4><a class="toc-backref" href="#id46" id="detecting-indent-type" name="detecting-indent-type">Detecting indent type</a></h4> <p>The <em>Detect from file</em> indentation preference can be used to scan each file as it's opened and set the indent type based on how many lines start with a tab vs. 2 or more spaces.</p> </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id48" id="auto-indentation" name="auto-indentation">Auto-indentation</a></h3> +<h3><a class="toc-backref" href="#id47" 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> @@ -1251,7 +1262,7 @@ setting - see <a class="reference" href="#xml-indent-tags">xml_indent_tags</a>.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id49" id="bookmarks" name="bookmarks">Bookmarks</a></h3> +<h3><a class="toc-backref" href="#id48" 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> @@ -1269,7 +1280,7 @@ navigate around multiple files.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id50" id="code-navigation-history" name="code-navigation-history">Code navigation history</a></h3> +<h3><a class="toc-backref" href="#id49" 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> @@ -1288,7 +1299,7 @@ and between different files.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id51" id="sending-text-through-custom-commands" name="sending-text-through-custom-commands">Sending text through custom commands</a></h3> +<h3><a class="toc-backref" href="#id50" id="sending-text-through-custom-commands" name="sending-text-through-custom-commands">Sending text through custom commands</a></h3> <p>You can define several custom commands in Geany and send the current selection to one of these commands using the <em>Edit->Format->Send Selection to</em> menu or keybindings. The output of the command will be @@ -1313,7 +1324,7 @@ function, but it can be handy to have common commands already set up.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id52" id="context-actions" name="context-actions">Context actions</a></h3> +<h3><a class="toc-backref" href="#id51" id="context-actions" name="context-actions">Context actions</a></h3> <p>You can execute the context action command on the current word at the cursor position or the available selection. This word or selection can be used as an argument to the command. @@ -1340,7 +1351,7 @@ called firefox) and it will open the address: <a class="reference" href="http://www.php.net/echo">http://www.php.net/echo</a>.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id53" id="autocompletion" name="autocompletion">Autocompletion</a></h3> +<h3><a class="toc-backref" href="#id52" id="autocompletion" name="autocompletion">Autocompletion</a></h3> <p>Geany can offer a list of possible completions for symbols defined in the tags and for all words in a document.</p> <p>The autocompletion list for symbols is presented when the first few @@ -1365,7 +1376,7 @@ preferences</a>) then any characters after the cursor that match a symbol or word are deleted.</p> <div class="section"> -<h4><a class="toc-backref" href="#id54" id="word-part-completion" name="word-part-completion">Word part completion</a></h4> +<h4><a class="toc-backref" href="#id53" id="word-part-completion" name="word-part-completion">Word part completion</a></h4> <p>By default, pressing Tab will complete the selected item by word part; useful e.g. for adding the prefix <tt class="docutils literal"><span class="pre">gtk_combo_box_entry_</span></tt> without typing it manually:</p> @@ -1381,7 +1392,7 @@ will complete the whole word instead, like Enter.</p> </div> <div class="section"> -<h4><a class="toc-backref" href="#id55" id="scope-autocompletion" name="scope-autocompletion">Scope autocompletion</a></h4> +<h4><a class="toc-backref" href="#id54" id="scope-autocompletion" name="scope-autocompletion">Scope autocompletion</a></h4> <p>E.g.:</p> <pre class="literal-block"> struct @@ -1399,7 +1410,7 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id56" id="user-definable-snippets" name="user-definable-snippets">User-definable snippets</a></h3> +<h3><a class="toc-backref" href="#id55" 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 when typing common strings and letting Geany do the work for you. @@ -1413,24 +1424,15 @@ <p>Every time you write <tt class="docutils literal"><span class="pre">myname</span></tt> <TAB> in Geany, it will replace "myname" with "Enrico Tröger". The key to start autocompletion can be changed in the preferences dialog, by default it is TAB. The corresponding keybinding -is called <tt class="docutils literal"><span class="pre">Complete</span> <span class="pre">snippet</span></tt>.</p> +is called <cite>Complete snippet</cite>.</p> <p><strong>Paths</strong></p> -<p>The system-wide configuration file can be found in -<tt class="docutils literal"><span class="pre">$prefix/share/geany</span></tt>, where <tt class="docutils literal"><span class="pre">$prefix</span></tt> is the path where Geany is -installed (see <a class="reference" href="#installation-prefix">Installation prefix</a>). It is not recommended to edit the -system-wide file, because it will be overridden when Geany is updated.</p> -<p>To change the settings, copy the file from <tt class="docutils literal"><span class="pre">$prefix/share/geany</span></tt> -in your configuration directory (usually <tt class="docutils literal"><span class="pre">~/.config/geany/</span></tt>).</p> -<p>For example:</p> -<pre class="literal-block"> -% cp /usr/local/share/geany/snippets.conf /home/username/.config/geany/ -</pre> -<p>Then you can edit the file and the changes will remain available -after an update of Geany because the file resides in your -configuration directory. Alternatively, you can create a file -<tt class="docutils literal"><span class="pre">~/.config/geany/snippets.conf</span></tt> and add only these settings you want -to change. All missing settings will be read from the global snippets -file in <tt class="docutils literal"><span class="pre">$prefix/share/geany</span></tt>.</p> +<p>You can override the default snippets using the user +<tt class="docutils literal"><span class="pre">snippets.conf</span></tt> file. Use the <em>Tools->Configuration +Files->snippets.conf</em> menu item. See also <a class="reference" href="#configuration-file-paths">Configuration file paths</a>.</p> +<p>This adds the default settings to the user file if the file doesn't +exist. Alternatively the file can be created manually, adding only +the settings you want to change. All missing settings will be read +from the system snippets file.</p> <p><strong>Snippet groups</strong></p> <p>The file <tt class="docutils literal"><span class="pre">snippets.conf</span></tt> contains sections defining snippets that are available for particular filetypes and in general.</p> @@ -1469,7 +1471,7 @@ <tr><td>%cursor%</td> <td>Place the cursor at this position after completion has been done. You can define multiple %cursor% wildcards -and use the keybinding <tt class="docutils literal"><span class="pre">Move</span> <span class="pre">cursor</span> <span class="pre">in</span> <span class="pre">snippet</span></tt> to jump +and use the keybinding <cite>Move cursor in snippet</cite> to jump to the next defined cursor position in the completed snippet.</td> </tr> @@ -1505,7 +1507,7 @@ default characters or define it to add or remove characters to fit your needs.</p> <div class="section"> -<h4><a class="toc-backref" href="#id57" id="snippet-keybindings" name="snippet-keybindings">Snippet keybindings</a></h4> +<h4><a class="toc-backref" href="#id56" id="snippet-keybindings" name="snippet-keybindings">Snippet keybindings</a></h4> <p>Normally you would type the snippet name and press Tab. However, you can define keybindings for snippets under the <em>Keybindings</em> group in <tt class="docutils literal"><span class="pre">snippets.conf</span></tt>:</p> @@ -1522,7 +1524,7 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id58" id="inserting-unicode-characters" name="inserting-unicode-characters">Inserting Unicode characters</a></h3> +<h3><a class="toc-backref" href="#id57" id="inserting-unicode-characters" name="inserting-unicode-characters">Inserting Unicode characters</a></h3> <p>With GTK 2.10 and above, you can insert Unicode code points by hitting Ctrl-Shift-u, then still holding Ctrl-Shift, type some hex digits representing the code point for the character you want and hit Enter or Return (still @@ -1541,7 +1543,7 @@ </div> </div> <div class="section"> -<h2><a class="toc-backref" href="#id59" id="search-replace-and-go-to" name="search-replace-and-go-to">Search, replace and go to</a></h2> +<h2><a class="toc-backref" href="#id58" id="search-replace-and-go-to" name="search-replace-and-go-to">Search, replace and go to</a></h2> <p>This section describes search-related commands from the Search menu and the editor window's popup menu:</p> <ul class="simple"> @@ -1555,7 +1557,7 @@ <li>Go to line</li> </ul> <div class="section"> -<h3><a class="toc-backref" href="#id60" id="toolbar-entries" name="toolbar-entries">Toolbar entries</a></h3> +<h3><a class="toc-backref" href="#id59" id="toolbar-entries" name="toolbar-entries">Toolbar entries</a></h3> <p>There are also two toolbar entries:</p> <ul class="simple"> <li>Search bar</li> @@ -1564,18 +1566,18 @@ <p>There are keybindings to focus each of these - see <a class="reference" href="#focus-keybindings">Focus keybindings</a>. Pressing Escape will then focus the editor.</p> <div class="section"> -<h4><a class="toc-backref" href="#id61" id="search-bar" name="search-bar">Search bar</a></h4> +<h4><a class="toc-backref" href="#id60" id="search-bar" name="search-bar">Search bar</a></h4> <p>The quickest way to find some text is to use the search bar entry in the toolbar. This performs a case-insensitive search in the current document whilst you type. Pressing Enter will search again.</p> </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id62" id="find" name="find">Find</a></h3> +<h3><a class="toc-backref" href="#id61" 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="#id63" id="matching-options" name="matching-options">Matching options</a></h4> +<h4><a class="toc-backref" href="#id62" id="matching-options" name="matching-options">Matching options</a></h4> <p>The syntax for the <em>Use regular expressions</em> option is shown in <a class="reference" href="#regular-expressions">Regular expressions</a>.</p> <div class="note"> @@ -1588,7 +1590,7 @@ (Unicode characters).</p> </div> <div class="section"> -<h4><a class="toc-backref" href="#id64" id="find-all" name="find-all">Find all</a></h4> +<h4><a class="toc-backref" href="#id63" 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"> @@ -1604,7 +1606,7 @@ Remove Markers command from the Document menu.</p> </div> <div class="section"> -<h4><a class="toc-backref" href="#id65" 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="#id64" id="change-font-in-search-dialog-text-fields" name="change-font-in-search-dialog-text-fields">Change font in search dialog text fields</a></h4> <p>All search related dialogs use a Monospace for the text input fields to increase the readability of input text. This is useful when you are typing input such as regular expressions with spaces, periods and commas which @@ -1626,7 +1628,7 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id66" id="find-selection" name="find-selection">Find selection</a></h3> +<h3><a class="toc-backref" href="#id65" id="find-selection" name="find-selection">Find selection</a></h3> <p>The <em>Find Next/Previous Selection</em> commands perform a search for the current selected text. If nothing is selected, by default the current word is used instead. This can be customized by the @@ -1655,7 +1657,7 @@ </table> </div> <div class="section"> -<h3><a class="toc-backref" href="#id67" id="find-usage" name="find-usage">Find usage</a></h3> +<h3><a class="toc-backref" href="#id66" 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 option in the Find dialog.</p> <p>If there is a selection, then it is used as the search text; otherwise @@ -1665,7 +1667,7 @@ shown in the Messages tab of the Message Window.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id68" id="find-in-files" name="find-in-files">Find in files</a></h3> +<h3><a class="toc-backref" href="#id67" 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 @@ -1686,7 +1688,7 @@ Grep implementations.</p> </div> <div class="section"> -<h4><a class="toc-backref" href="#id69" 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="#id68" 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 filter out version control files.</p> @@ -1700,7 +1702,7 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id70" id="replace" name="replace">Replace</a></h3> +<h3><a class="toc-backref" href="#id69" 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" /> @@ -1710,7 +1712,7 @@ be used in the search string and back references in the replacement text -- 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="#id71" id="replace-all" name="replace-all">Replace all</a></h4> +<h4><a class="toc-backref" href="#id70" 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"> @@ -1725,7 +1727,7 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id72" id="go-to-tag-definition" name="go-to-tag-definition">Go to tag definition</a></h3> +<h3><a class="toc-backref" href="#id71" 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 @@ -1741,17 +1743,17 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id73" id="go-to-tag-declaration" name="go-to-tag-declaration">Go to tag declaration</a></h3> +<h3><a class="toc-backref" href="#id72" 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 C 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="#id74" id="go-to-line" name="go-to-line">Go to line</a></h3> +<h3><a class="toc-backref" href="#id73" 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="#id75" id="regular-expressions" name="regular-expressions">Regular expressions</a></h3> +<h3><a class="toc-backref" href="#id74" 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 <em>Use regular expressions</em> check box (see <a class="reference" href="#matching-options">Matching options</a>). The syntax is POSIX compatible, as described in the table @@ -1865,7 +1867,7 @@ </div> </div> <div class="section"> -<h2><a class="toc-backref" href="#id76" id="tags" name="tags">Tags</a></h2> +<h2><a class="toc-backref" href="#id75" id="tags" name="tags">Tags</a></h2> <p>Tags are information that relates symbols in a program with the source file location of the declaration and definition.</p> <p>Geany has built-in functionality for generating tag information (aka @@ -1876,7 +1878,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="#id77" id="workspace-tags" name="workspace-tags">Workspace tags</a></h3> +<h3><a class="toc-backref" href="#id76" 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 @@ -1885,7 +1887,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="#id78" id="global-tags" name="global-tags">Global tags</a></h3> +<h3><a class="toc-backref" href="#id77" 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 @@ -1893,11 +1895,8 @@ <p>You can load a custom global tags file in two ways:</p> <ul class="simple"> <li>Using the <em>Load Tags</em> command in the Tools menu.</li> -<li>By creating a directory <tt class="docutils literal"><span class="pre">~/.config/geany/tags</span></tt>, and moving or symlinking -the tags files there before starting Geany.</li> -<li>By creating a directory <tt class="docutils literal"><span class="pre">$prefix/share/geany/tags</span></tt>, and moving -or symlinking the tags files there before starting Geany. -<tt class="docutils literal"><span class="pre">$prefix</span></tt> is the installation prefix (see <a class="reference" href="#installation-prefix">Installation prefix</a>).</li> +<li>By moving or symlinking tags files to the <tt class="docutils literal"><span class="pre">tags</span></tt> subdirectory of +one of the <a class="reference" href="#configuration-file-paths">configuration file paths</a> before starting Geany.</li> </ul> <p>You can either download these files or generate your own. They have the format:</p> @@ -1908,7 +1907,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="#id79" id="default-global-tags-files" name="default-global-tags-files">Default global tags files</a></h4> +<h4><a class="toc-backref" href="#id78" 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"> @@ -1921,7 +1920,7 @@ </ul> </div> <div class="section"> -<h4><a class="toc-backref" href="#id80" id="global-tags-file-format" name="global-tags-file-format">Global tags file format</a></h4> +<h4><a class="toc-backref" href="#id79" id="global-tags-file-format" name="global-tags-file-format">Global tags file format</a></h4> <p>Global tags files can have two different formats:</p> <ul class="simple"> <li>Tagmanager format</li> @@ -1958,7 +1957,7 @@ section <a class="reference" href="#global-tags">Global tags</a>.</p> </div> <div class="section"> -<h4><a class="toc-backref" href="#id81" 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="#id80" id="generating-a-global-tags-file" name="generating-a-global-tags-file">Generating a global tags file</a></h4> <p>You can generate your own global tags files by parsing a list of source files. The command is:</p> <pre class="literal-block"> @@ -2003,7 +2002,7 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id82" id="ignore-tags" name="ignore-tags">Ignore tags</a></h3> +<h3><a class="toc-backref" href="#id81" id="ignore-tags" name="ignore-tags">Ignore tags</a></h3> <p>You can also ignore certain tags if they would lead to wrong parsing of the code. Simply create a file called "ignore.tags" in your Geany configuration directory (usually <tt class="docutils literal"><span class="pre">~/.config/geany/</span></tt>). Then list all tags @@ -2027,7 +2026,7 @@ </div> </div> <div class="section"> -<h2><a class="toc-backref" href="#id83" id="preferences" name="preferences">Preferences</a></h2> +<h2><a class="toc-backref" href="#id82" 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 @@ -2045,10 +2044,10 @@ comes after the screenshot of that tab.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id84" id="general-startup-preferences" name="general-startup-preferences">General Startup preferences</a></h3> +<h3><a class="toc-backref" href="#id83" id="general-startup-preferences" name="general-startup-preferences">General Startup preferences</a></h3> <img alt="./images/pref_dialog_gen_startup.png" src="./images/pref_dialog_gen_startup.png" /> <div class="section"> -<h4><a class="toc-backref" href="#id85" id="id1" name="id1">Startup</a></h4> +<h4><a class="toc-backref" href="#id84" 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 @@ -2060,7 +2059,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id86" id="shutdown" name="shutdown">Shutdown</a></h4> +<h4><a class="toc-backref" href="#id85" 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 @@ -2070,7 +2069,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id87" id="paths" name="paths">Paths</a></h4> +<h4><a class="toc-backref" href="#id86" id="paths" name="paths">Paths</a></h4> <dl class="docutils"> <dt>Startup path</dt> <dd>Path to start in when opening or saving files. @@ -2089,10 +2088,10 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id88" id="general-miscellaneous-preferences" name="general-miscellaneous-preferences">General Miscellaneous preferences</a></h3> +<h3><a class="toc-backref" href="#id87" id="general-miscellaneous-preferences" name="general-miscellaneous-preferences">General Miscellaneous preferences</a></h3> <img alt="./images/pref_dialog_gen_misc.png" src="./images/pref_dialog_gen_misc.png" /> <div class="section"> -<h4><a class="toc-backref" href="#id89" id="miscellaneous" name="miscellaneous">Miscellaneous</a></h4> +<h4><a class="toc-backref" href="#id88" 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 @@ -2120,7 +2119,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id90" id="search" name="search">Search</a></h4> +<h4><a class="toc-backref" href="#id89" id="search" name="search">Search</a></h4> <dl class="docutils"> <dt>Always wrap search and hide the Find dialog</dt> <dd>Always wrap search around the document and hide the Find dialog after clicking @@ -2136,7 +2135,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id91" id="projects" name="projects">Projects</a></h4> +<h4><a class="toc-backref" href="#id90" 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 @@ -2153,10 +2152,10 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id92" id="interface-preferences" name="interface-preferences">Interface preferences</a></h3> +<h3><a class="toc-backref" href="#id91" id="interface-preferences" name="interface-preferences">Interface preferences</a></h3> <img alt="./images/pref_dialog_interface.png" src="./images/pref_dialog_interface.png" /> <div class="section"> -<h4><a class="toc-backref" href="#id93" id="sidebar" name="sidebar">Sidebar</a></h4> +<h4><a class="toc-backref" href="#id92" id="sidebar" name="sidebar">Sidebar</a></h4> <dl class="docutils"> <dt>Show sidebar</dt> <dd>Whether to show the sidebar at all.</dd> @@ -2172,7 +2171,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id94" id="fonts" name="fonts">Fonts</a></h4> +<h4><a class="toc-backref" href="#id93" id="fonts" name="fonts">Fonts</a></h4> <dl class="docutils"> <dt>Editor</dt> <dd>Change the font used to display documents.</dd> @@ -2183,7 +2182,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id95" id="editor-tabs" name="editor-tabs">Editor tabs</a></h4> +<h4><a class="toc-backref" href="#id94" 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 @@ -2203,7 +2202,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id96" id="tab-positions" name="tab-positions">Tab positions</a></h4> +<h4><a class="toc-backref" href="#id95" 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, @@ -2217,7 +2216,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id97" id="id2" name="id2">Miscellaneous</a></h4> +<h4><a class="toc-backref" href="#id96" 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 @@ -2227,11 +2226,11 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id98" id="toolbar-preferences" name="toolbar-preferences">Toolbar preferences</a></h3> +<h3><a class="toc-backref" href="#id97" id="toolbar-preferences" name="toolbar-preferences">Toolbar preferences</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="#id99" id="toolbar" name="toolbar">Toolbar</a></h4> +<h4><a class="toc-backref" href="#id98" id="toolbar" name="toolbar">Toolbar</a></h4> <dl class="docutils"> <dt>Show Toolbar</dt> <dd>Whether to show the toolbar.</dd> @@ -2243,7 +2242,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id100" id="appearance" name="appearance">Appearance</a></h4> +<h4><a class="toc-backref" href="#id99" 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 @@ -2256,10 +2255,10 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id101" id="editor-features-preferences" name="editor-features-preferences">Editor Features preferences</a></h3> +<h3><a class="toc-backref" href="#id100" id="editor-features-preferences" name="editor-features-preferences">Editor Features preferences</a></h3> <img alt="./images/pref_dialog_edit_features.png" src="./images/pref_dialog_edit_features.png" /> <div class="section"> -<h4><a class="toc-backref" href="#id102" id="features" name="features">Features</a></h4> +<h4><a class="toc-backref" href="#id101" 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> @@ -2291,10 +2290,10 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id103" id="editor-indentation-preferences" name="editor-indentation-preferences">Editor Indentation preferences</a></h3> +<h3><a class="toc-backref" href="#id102" id="editor-indentation-preferences" name="editor-indentation-preferences">Editor Indentation preferences</a></h3> <img alt="./images/pref_dialog_edit_indentation.png" src="./images/pref_dialog_edit_indentation.png" /> <div class="section"> -<h4><a class="toc-backref" href="#id104" id="indentation-group" name="indentation-group">Indentation group</a></h4> +<h4><a class="toc-backref" href="#id103" 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> @@ -2343,10 +2342,10 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id105" id="editor-completions-preferences" name="editor-completions-preferences">Editor Completions preferences</a></h3> +<h3><a class="toc-backref" href="#id104" id="editor-completions-preferences" name="editor-completions-preferences">Editor Completions preferences</a></h3> <img alt="./images/pref_dialog_edit_completions.png" src="./images/pref_dialog_edit_completions.png" /> <div class="section"> -<h4><a class="toc-backref" href="#id106" id="completions" name="completions">Completions</a></h4> +<h4><a class="toc-backref" href="#id105" id="completions" name="completions">Completions</a></h4> <dl class="docutils"> <dt>Snippet Completion</dt> <dd>Whether to replace special keywords after typing Tab into a @@ -2392,7 +2391,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id107" id="auto-close-quotes-and-brackets" name="auto-close-quotes-and-brackets">Auto-close quotes and brackets</a></h4> +<h4><a class="toc-backref" href="#id106" id="auto-close-quotes-and-brackets" name="auto-close-quotes-and-brackets">Auto-close quotes and brackets</a></h4> <p>Geany can automatically insert a closing bracket and quote characters when you open them. For instance, you type a <tt class="docutils literal"><span class="pre">(</span></tt> and Geany will automatically insert <tt class="docutils literal"><span class="pre">)</span></tt>. With the following options, you can define for which @@ -2412,11 +2411,11 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id108" id="editor-display-preferences" name="editor-display-preferences">Editor Display preferences</a></h3> +<h3><a class="toc-backref" href="#id107" id="editor-display-preferences" name="editor-display-preferences">Editor Display preferences</a></h3> <p>This is for visual elements displayed in the editor window.</p> <img alt="./images/pref_dialog_edit_display.png" src="./images/pref_dialog_edit_display.png" /> <div class="section"> -<h4><a class="toc-backref" href="#id109" id="display" name="display">Display</a></h4> +<h4><a class="toc-backref" href="#id108" id="display" name="display">Display</a></h4> <dl class="docutils"> <dt>Invert syntax highlighting colors</dt> <dd>Invert all colors, by default this makes white text on a black @@ -2441,7 +2440,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id110" id="long-line-marker" name="long-line-marker">Long line marker</a></h4> +<h4><a class="toc-backref" href="#id109" 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"> @@ -2466,7 +2465,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id111" id="virtual-spaces" name="virtual-spaces">Virtual spaces</a></h4> +<h4><a class="toc-backref" href="#id110" id="virtual-spaces" name="virtual-spaces">Virtual spaces</a></h4> <p>Virtual space is space beyond the end of each line. The cursor may be moved into virtual space but no real space will be added to the document until there is some text typed or some other @@ -2482,10 +2481,10 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id112" id="files-preferences" name="files-preferences">Files preferences</a></h3> +<h3><a class="toc-backref" href="#id111" id="files-preferences" name="files-preferences">Files preferences</a></h3> <img alt="./images/pref_dialog_files.png" src="./images/pref_dialog_files.png" /> <div class="section"> -<h4><a class="toc-backref" href="#id113" id="new-files" name="new-files">New files</a></h4> +<h4><a class="toc-backref" href="#id112" id="new-files" name="new-files">New files</a></h4> <dl class="docutils"> <dt>Open new documents from the command-line</dt> <dd>Whether to create new documents when passing filenames that don't @@ -2505,7 +2504,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id114" id="saving-files" name="saving-files">Saving files</a></h4> +<h4><a class="toc-backref" href="#id113" id="saving-files" name="saving-files">Saving files</a></h4> <p>Perform formatting operations when a document is saved. These can each be undone with the Undo command.</p> <dl class="docutils"> @@ -2527,7 +2526,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id115" id="id3" name="id3">Miscellaneous</a></h4> +<h4><a class="toc-backref" href="#id114" 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> @@ -2546,10 +2545,10 @@ </div> </div>
@@ Diff output truncated at 100000 characters. @@
This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.