HybridDog/geany
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Add a note about column mode editing.

Browse Source 
git-svn-id: https://geany.svn.sourceforge.net/svnroot/geany/trunk@2351 ea778897-0a13-0410-b9d1-a72fbfd435f5
This commit is contained in:
Enrico Tröger 2008-03-17 12:56:10 +00:00
parent 3e0efbf7fa
commit d5da60a242
3 changed files with 216 additions and 179 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
ChangeLog
View File

@ -1,3 +1,8 @@
2008-03-17 Enrico Tröger <enrico(dot)troeger(at)uvena(dot)de>
* doc/geany.txt, doc/geany.html: Add a note about column mode editing.
2008-03-15 Enrico Tröger <enrico(dot)troeger(at)uvena(dot)de> 2008-03-15 Enrico Tröger <enrico(dot)troeger(at)uvena(dot)de>
* src/projects.c: Fix wrong directory when choosing project filename * src/projects.c: Fix wrong directory when choosing project filename

374
doc/geany.html
View File

@ -6,7 +6,7 @@
<meta name="generator" content="Docutils 0.4.1: http://docutils.sourceforge.net/" /> <meta name="generator" content="Docutils 0.4.1: http://docutils.sourceforge.net/" />
<title>Geany</title> <title>Geany</title>
<meta name="authors" content="Enrico Tröger Nick Treleaven Frank Lanitz" /> <meta name="authors" content="Enrico Tröger Nick Treleaven Frank Lanitz" />
<meta name="date" content="2008-03-12" /> <meta name="date" content="2008-03-13" />
<style type="text/css"> <style type="text/css">
/* /*
@ -133,7 +133,7 @@ dt {
<br />Nick Treleaven <br />Nick Treleaven
<br />Frank Lanitz</td></tr> <br />Frank Lanitz</td></tr>
<tr><th class="docinfo-name">Date:</th> <tr><th class="docinfo-name">Date:</th>
<td>2008-03-12</td></tr> <td>2008-03-13</td></tr>
<tr><th class="docinfo-name">Version:</th> <tr><th class="docinfo-name">Version:</th>
<td>0.14</td></tr> <td>0.14</td></tr>
</tbody> </tbody>
@ -179,138 +179,139 @@ of this program, and also in the chapter <a class="reference" href="#gnu-general
</li> </li>
<li><a class="reference" href="#editing" id="id24" name="id24">Editing</a><ul> <li><a class="reference" href="#editing" id="id24" name="id24">Editing</a><ul>
<li><a class="reference" href="#folding" id="id25" name="id25">Folding</a></li> <li><a class="reference" href="#folding" id="id25" name="id25">Folding</a></li>
<li><a class="reference" href="#drag-and-drop-of-text" id="id26" name="id26">Drag and drop of text</a></li> <li><a class="reference" href="#column-mode-editing" id="id26" name="id26">Column mode editing</a></li>
<li><a class="reference" href="#indentation" id="id27" name="id27">Indentation</a></li> <li><a class="reference" href="#drag-and-drop-of-text" id="id27" name="id27">Drag and drop of text</a></li>
<li><a class="reference" href="#auto-indentation" id="id28" name="id28">Auto-indentation</a></li> <li><a class="reference" href="#indentation" id="id28" name="id28">Indentation</a></li>
<li><a class="reference" href="#bookmarks" id="id29" name="id29">Bookmarks</a></li> <li><a class="reference" href="#auto-indentation" id="id29" name="id29">Auto-indentation</a></li>
<li><a class="reference" href="#code-navigation-history" id="id30" name="id30">Code Navigation History</a></li> <li><a class="reference" href="#bookmarks" id="id30" name="id30">Bookmarks</a></li>
<li><a class="reference" href="#send-text-through-definable-commands" id="id31" name="id31">Send text through definable commands</a></li> <li><a class="reference" href="#code-navigation-history" id="id31" name="id31">Code Navigation History</a></li>
<li><a class="reference" href="#context-actions" id="id32" name="id32">Context actions</a></li> <li><a class="reference" href="#send-text-through-definable-commands" id="id32" name="id32">Send text through definable commands</a></li>
<li><a class="reference" href="#user-definable-snippets" id="id33" name="id33">User-definable snippets</a></li> <li><a class="reference" href="#context-actions" id="id33" name="id33">Context actions</a></li>
<li><a class="reference" href="#inserting-unicode-characters" id="id34" name="id34">Inserting unicode characters</a></li> <li><a class="reference" href="#user-definable-snippets" id="id34" name="id34">User-definable snippets</a></li>
<li><a class="reference" href="#inserting-unicode-characters" id="id35" name="id35">Inserting unicode characters</a></li>
</ul> </ul>
</li> </li>
<li><a class="reference" href="#search-replace-and-go-to" id="id35" name="id35">Search, replace and go to</a><ul> <li><a class="reference" href="#search-replace-and-go-to" id="id36" name="id36">Search, replace and go to</a><ul>
<li><a class="reference" href="#find" id="id36" name="id36">Find</a><ul> <li><a class="reference" href="#find" id="id37" name="id37">Find</a><ul>
<li><a class="reference" href="#matching-options" id="id37" name="id37">Matching options</a></li> <li><a class="reference" href="#matching-options" id="id38" name="id38">Matching options</a></li>
<li><a class="reference" href="#find-all" id="id38" name="id38">Find all</a></li> <li><a class="reference" href="#find-all" id="id39" name="id39">Find all</a></li>
<li><a class="reference" href="#change-font-in-search-dialog-text-fields" id="id39" name="id39">Change font in search dialog text fields</a></li> <li><a class="reference" href="#change-font-in-search-dialog-text-fields" id="id40" name="id40">Change font in search dialog text fields</a></li>
</ul> </ul>
</li> </li>
<li><a class="reference" href="#find-usage" id="id40" name="id40">Find usage</a></li> <li><a class="reference" href="#find-usage" id="id41" name="id41">Find usage</a></li>
<li><a class="reference" href="#find-in-files" id="id41" name="id41">Find in files</a><ul> <li><a class="reference" href="#find-in-files" id="id42" name="id42">Find in files</a><ul>
<li><a class="reference" href="#filtering-out-version-control-files" id="id42" name="id42">Filtering out version control files</a></li> <li><a class="reference" href="#filtering-out-version-control-files" id="id43" name="id43">Filtering out version control files</a></li>
</ul> </ul>
</li> </li>
<li><a class="reference" href="#replace" id="id43" name="id43">Replace</a><ul> <li><a class="reference" href="#replace" id="id44" name="id44">Replace</a><ul>
<li><a class="reference" href="#replace-all" id="id44" name="id44">Replace all</a></li> <li><a class="reference" href="#replace-all" id="id45" name="id45">Replace all</a></li>
</ul> </ul>
</li> </li>
<li><a class="reference" href="#go-to-tag-definition" id="id45" name="id45">Go to tag definition</a></li> <li><a class="reference" href="#go-to-tag-definition" id="id46" name="id46">Go to tag definition</a></li>
<li><a class="reference" href="#go-to-tag-declaration" id="id46" name="id46">Go to tag declaration</a></li> <li><a class="reference" href="#go-to-tag-declaration" id="id47" name="id47">Go to tag declaration</a></li>
<li><a class="reference" href="#go-to-line" id="id47" name="id47">Go to line</a></li> <li><a class="reference" href="#go-to-line" id="id48" name="id48">Go to line</a></li>
<li><a class="reference" href="#regular-expressions" id="id48" name="id48">Regular expressions</a><ul> <li><a class="reference" href="#regular-expressions" id="id49" name="id49">Regular expressions</a><ul>
<li><a class="reference" href="#partial-posix-compatibility" id="id49" name="id49">Partial POSIX compatibility</a></li> <li><a class="reference" href="#partial-posix-compatibility" id="id50" name="id50">Partial POSIX compatibility</a></li>
</ul> </ul>
</li> </li>
</ul> </ul>
</li> </li>
<li><a class="reference" href="#tags" id="id50" name="id50">Tags</a><ul> <li><a class="reference" href="#tags" id="id51" name="id51">Tags</a><ul>
<li><a class="reference" href="#workspace-tags" id="id51" name="id51">Workspace tags</a></li> <li><a class="reference" href="#workspace-tags" id="id52" name="id52">Workspace tags</a></li>
<li><a class="reference" href="#global-tags" id="id52" name="id52">Global tags</a><ul> <li><a class="reference" href="#global-tags" id="id53" name="id53">Global tags</a><ul>
<li><a class="reference" href="#default-global-tags-files" id="id53" name="id53">Default global tags files</a></li> <li><a class="reference" href="#default-global-tags-files" id="id54" name="id54">Default global tags files</a></li>
<li><a class="reference" href="#generating-a-global-tags-file" id="id54" name="id54">Generating a global tags file</a></li> <li><a class="reference" href="#generating-a-global-tags-file" id="id55" name="id55">Generating a global tags file</a></li>
</ul> </ul>
</li> </li>
<li><a class="reference" href="#ignore-tags" id="id55" name="id55">Ignore tags</a></li> <li><a class="reference" href="#ignore-tags" id="id56" name="id56">Ignore tags</a></li>
</ul> </ul>
</li> </li>
<li><a class="reference" href="#preferences" id="id56" name="id56">Preferences</a><ul> <li><a class="reference" href="#preferences" id="id57" name="id57">Preferences</a><ul>
<li><a class="reference" href="#general-tab-in-preferences-dialog" id="id57" name="id57">General tab in preferences dialog</a></li> <li><a class="reference" href="#general-tab-in-preferences-dialog" id="id58" name="id58">General tab in preferences dialog</a></li>
<li><a class="reference" href="#interface-tab-in-preferences-dialog" id="id58" name="id58">Interface tab in preferences dialog</a></li> <li><a class="reference" href="#interface-tab-in-preferences-dialog" id="id59" name="id59">Interface tab in preferences dialog</a></li>
<li><a class="reference" href="#toolbar-tab-in-preferences-dialog" id="id59" name="id59">Toolbar tab in preferences dialog</a></li> <li><a class="reference" href="#toolbar-tab-in-preferences-dialog" id="id60" name="id60">Toolbar tab in preferences dialog</a></li>
<li><a class="reference" href="#display-tab-in-preferences-dialog" id="id60" name="id60">Display tab in preferences dialog</a></li> <li><a class="reference" href="#display-tab-in-preferences-dialog" id="id61" name="id61">Display tab in preferences dialog</a></li>
<li><a class="reference" href="#editor-tab-in-preferences-dialog" id="id61" name="id61">Editor tab in preferences dialog</a></li> <li><a class="reference" href="#editor-tab-in-preferences-dialog" id="id62" name="id62">Editor tab in preferences dialog</a></li>
<li><a class="reference" href="#files-tab-in-preferences-dialog" id="id62" name="id62">Files tab in preferences dialog</a></li> <li><a class="reference" href="#files-tab-in-preferences-dialog" id="id63" name="id63">Files tab in preferences dialog</a></li>
<li><a class="reference" href="#tools-tab-in-preferences-dialog" id="id63" name="id63">Tools tab in preferences dialog</a></li> <li><a class="reference" href="#tools-tab-in-preferences-dialog" id="id64" name="id64">Tools tab in preferences dialog</a></li>
<li><a class="reference" href="#template-tab-in-preferences-dialog" id="id64" name="id64">Template tab in preferences dialog</a></li> <li><a class="reference" href="#template-tab-in-preferences-dialog" id="id65" name="id65">Template tab in preferences dialog</a></li>
<li><a class="reference" href="#keybinding-tab-in-preferences-dialog" id="id65" name="id65">Keybinding tab in preferences dialog</a></li> <li><a class="reference" href="#keybinding-tab-in-preferences-dialog" id="id66" name="id66">Keybinding tab in preferences dialog</a></li>
<li><a class="reference" href="#printing-tab-in-preferences-dialog" id="id66" name="id66">Printing tab in preferences dialog</a></li> <li><a class="reference" href="#printing-tab-in-preferences-dialog" id="id67" name="id67">Printing tab in preferences dialog</a></li>
<li><a class="reference" href="#vte-tab-in-preferences-dialog" id="id67" name="id67">VTE tab in preferences dialog</a></li> <li><a class="reference" href="#vte-tab-in-preferences-dialog" id="id68" name="id68">VTE tab in preferences dialog</a></li>
</ul> </ul>
</li> </li>
<li><a class="reference" href="#project-management" id="id68" name="id68">Project Management</a><ul> <li><a class="reference" href="#project-management" id="id69" name="id69">Project Management</a><ul>
<li><a class="reference" href="#new-project" id="id69" name="id69">New Project</a></li> <li><a class="reference" href="#new-project" id="id70" name="id70">New Project</a></li>
<li><a class="reference" href="#project-properties" id="id70" name="id70">Project Properties</a><ul> <li><a class="reference" href="#project-properties" id="id71" name="id71">Project Properties</a><ul>
<li><a class="reference" href="#make-in-base-path" id="id71" name="id71">Make in base path</a></li> <li><a class="reference" href="#make-in-base-path" id="id72" name="id72">Make in base path</a></li>
<li><a class="reference" href="#run-command" id="id72" name="id72">Run command</a></li> <li><a class="reference" href="#run-command" id="id73" name="id73">Run command</a></li>
</ul> </ul>
</li> </li>
<li><a class="reference" href="#open-project" id="id73" name="id73">Open Project</a></li> <li><a class="reference" href="#open-project" id="id74" name="id74">Open Project</a></li>
<li><a class="reference" href="#close-project" id="id74" name="id74">Close Project</a></li> <li><a class="reference" href="#close-project" id="id75" name="id75">Close Project</a></li>
</ul> </ul>
</li> </li>
<li><a class="reference" href="#build-system" id="id75" name="id75">Build system</a><ul> <li><a class="reference" href="#build-system" id="id76" name="id76">Build system</a><ul>
<li><a class="reference" href="#compile" id="id76" name="id76">Compile</a></li> <li><a class="reference" href="#compile" id="id77" name="id77">Compile</a></li>
<li><a class="reference" href="#build" id="id77" name="id77">Build</a></li> <li><a class="reference" href="#build" id="id78" name="id78">Build</a></li>
<li><a class="reference" href="#make-all" id="id78" name="id78">Make all</a></li> <li><a class="reference" href="#make-all" id="id79" name="id79">Make all</a></li>
<li><a class="reference" href="#make-custom-target" id="id79" name="id79">Make custom target</a></li> <li><a class="reference" href="#make-custom-target" id="id80" name="id80">Make custom target</a></li>
<li><a class="reference" href="#make-object" id="id80" name="id80">Make object</a></li> <li><a class="reference" href="#make-object" id="id81" name="id81">Make object</a></li>
<li><a class="reference" href="#execute" id="id81" name="id81">Execute</a></li> <li><a class="reference" href="#execute" id="id82" name="id82">Execute</a></li>
<li><a class="reference" href="#stopping-running-processes" id="id82" name="id82">Stopping running processes</a><ul> <li><a class="reference" href="#stopping-running-processes" id="id83" name="id83">Stopping running processes</a><ul>
<li><a class="reference" href="#terminal-emulators" id="id83" name="id83">Terminal emulators</a></li> <li><a class="reference" href="#terminal-emulators" id="id84" name="id84">Terminal emulators</a></li>
</ul> </ul>
</li> </li>
<li><a class="reference" href="#set-includes-and-arguments" id="id84" name="id84">Set Includes and Arguments</a><ul> <li><a class="reference" href="#set-includes-and-arguments" id="id85" name="id85">Set Includes and Arguments</a><ul>
<li><a class="reference" href="#one-step-compilation" id="id85" name="id85">One step compilation</a></li> <li><a class="reference" href="#one-step-compilation" id="id86" name="id86">One step compilation</a></li>
</ul> </ul>
</li> </li>
<li><a class="reference" href="#indicators" id="id86" name="id86">Indicators</a></li> <li><a class="reference" href="#indicators" id="id87" name="id87">Indicators</a></li>
</ul> </ul>
</li> </li>
<li><a class="reference" href="#printing-support" id="id87" name="id87">Printing support</a></li> <li><a class="reference" href="#printing-support" id="id88" name="id88">Printing support</a></li>
<li><a class="reference" href="#plugins" id="id88" name="id88">Plugins</a></li> <li><a class="reference" href="#plugins" id="id89" name="id89">Plugins</a></li>
<li><a class="reference" href="#keybindings" id="id89" name="id89">Keybindings</a><ul> <li><a class="reference" href="#keybindings" id="id90" name="id90">Keybindings</a><ul>
<li><a class="reference" href="#switching-documents" id="id90" name="id90">Switching documents</a></li> <li><a class="reference" href="#switching-documents" id="id91" name="id91">Switching documents</a></li>
<li><a class="reference" href="#configurable-keybindings" id="id91" name="id91">Configurable keybindings</a></li> <li><a class="reference" href="#configurable-keybindings" id="id92" name="id92">Configurable keybindings</a></li>
</ul> </ul>
</li> </li>
</ul> </ul>
</li> </li>
<li><a class="reference" href="#configuration-files" id="id92" name="id92">Configuration files</a><ul> <li><a class="reference" href="#configuration-files" id="id93" name="id93">Configuration files</a><ul>
<li><a class="reference" href="#global-configuration-file" id="id93" name="id93">Global configuration file</a></li> <li><a class="reference" href="#global-configuration-file" id="id94" name="id94">Global configuration file</a></li>
<li><a class="reference" href="#filetype-definition-files" id="id94" name="id94">Filetype definition files</a><ul> <li><a class="reference" href="#filetype-definition-files" id="id95" name="id95">Filetype definition files</a><ul>
<li><a class="reference" href="#format" id="id95" name="id95">Format</a><ul> <li><a class="reference" href="#format" id="id96" name="id96">Format</a><ul>
<li><a class="reference" href="#styling-section" id="id96" name="id96">[styling] Section</a></li> <li><a class="reference" href="#styling-section" id="id97" name="id97">[styling] Section</a></li>
<li><a class="reference" href="#keywords-section" id="id97" name="id97">[keywords] Section</a></li> <li><a class="reference" href="#keywords-section" id="id98" name="id98">[keywords] Section</a></li>
<li><a class="reference" href="#settings-section" id="id98" name="id98">[settings] Section</a></li> <li><a class="reference" href="#settings-section" id="id99" name="id99">[settings] Section</a></li>
<li><a class="reference" href="#build-settings-section" id="id99" name="id99">[build_settings] Section</a></li> <li><a class="reference" href="#build-settings-section" id="id100" name="id100">[build_settings] Section</a></li>
</ul> </ul>
</li> </li>
<li><a class="reference" href="#special-file-filetypes-common" id="id100" name="id100">Special file filetypes.common</a></li> <li><a class="reference" href="#special-file-filetypes-common" id="id101" name="id101">Special file filetypes.common</a></li>
</ul> </ul>
</li> </li>
<li><a class="reference" href="#filetype-extensions" id="id101" name="id101">Filetype extensions</a></li> <li><a class="reference" href="#filetype-extensions" id="id102" name="id102">Filetype extensions</a></li>
<li><a class="reference" href="#templates" id="id102" name="id102">Templates</a><ul> <li><a class="reference" href="#templates" id="id103" name="id103">Templates</a><ul>
<li><a class="reference" href="#template-metadata" id="id103" name="id103">Template metadata</a></li> <li><a class="reference" href="#template-metadata" id="id104" name="id104">Template metadata</a></li>
<li><a class="reference" href="#filetype-templates" id="id104" name="id104">Filetype templates</a></li> <li><a class="reference" href="#filetype-templates" id="id105" name="id105">Filetype templates</a></li>
<li><a class="reference" href="#customizing-templates" id="id105" name="id105">Customizing templates</a><ul> <li><a class="reference" href="#customizing-templates" id="id106" name="id106">Customizing templates</a><ul>
<li><a class="reference" href="#template-wildcards" id="id106" name="id106">Template wildcards</a></li> <li><a class="reference" href="#template-wildcards" id="id107" name="id107">Template wildcards</a></li>
</ul> </ul>
</li> </li>
</ul> </ul>
</li> </li>
</ul> </ul>
</li> </li>
<li><a class="reference" href="#contributing-to-this-document" id="id107" name="id107">Contributing to this document</a></li> <li><a class="reference" href="#contributing-to-this-document" id="id108" name="id108">Contributing to this document</a></li>
<li><a class="reference" href="#scintilla-keyboard-commands" id="id108" name="id108">Scintilla keyboard commands</a><ul> <li><a class="reference" href="#scintilla-keyboard-commands" id="id109" name="id109">Scintilla keyboard commands</a><ul>
<li><a class="reference" href="#keyboard-commands" id="id109" name="id109">Keyboard commands</a></li> <li><a class="reference" href="#keyboard-commands" id="id110" name="id110">Keyboard commands</a></li>
</ul> </ul>
</li> </li>
<li><a class="reference" href="#hidden-preferences" id="id110" name="id110">Hidden preferences</a></li> <li><a class="reference" href="#hidden-preferences" id="id111" name="id111">Hidden preferences</a></li>
<li><a class="reference" href="#compile-time-options" id="id111" name="id111">Compile-time options</a></li> <li><a class="reference" href="#compile-time-options" id="id112" name="id112">Compile-time options</a></li>
<li><a class="reference" href="#gnu-general-public-license" id="id112" name="id112">GNU General Public License</a></li> <li><a class="reference" href="#gnu-general-public-license" id="id113" name="id113">GNU General Public License</a></li>
<li><a class="reference" href="#license-for-scintilla-and-scite" id="id113" name="id113">License for Scintilla and SciTE</a></li> <li><a class="reference" href="#license-for-scintilla-and-scite" id="id114" name="id114">License for Scintilla and SciTE</a></li>
</ul> </ul>
</div> </div>
<div class="section"> <div class="section">
@ -797,7 +798,22 @@ children of a fold point&quot; option is enabled, pressing Shift will disable
it for this click and vice versa.</p> it for this click and vice versa.</p>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id26" 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="#id26" id="column-mode-editing" name="column-mode-editing">Column mode editing</a></h3>
<p>There is basic support for column mode editing. To use it, create a
rectangular selection by holding down the Control key while selecting
some text. It is also possible to create a zero-column selection but
be careful because there is no visual indication of this selection.
Once a rectangular selection exists you can start editing the text within
this selection and the modifications will be done for every line in the
selection.</p>
<div class="note">
<p class="first admonition-title">Note</p>
<p class="last">Copying and pasting text with rectangular selections doesn't work.
It might give unexpected results and damage your text.</p>
</div>
</div>
<div class="section">
<h3><a class="toc-backref" href="#id27" 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 <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 moved to the position where the mouse pointer is when releasing the
mouse button. Holding Control when releasing the mouse button will mouse button. Holding Control when releasing the mouse button will
@ -805,7 +821,7 @@ copy the text instead. This behaviour was changed in Geany 0.11 -
before the selected text was copied to the new position.</p> before the selected text was copied to the new position.</p>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id27" id="indentation" name="indentation">Indentation</a></h3> <h3><a class="toc-backref" href="#id28" id="indentation" name="indentation">Indentation</a></h3>
<p>Geany allows each document to indent either with a tab character <p>Geany allows each document to indent either with a tab character
or multiple spaces. The default indent mode is set in the <a class="reference" href="#editor-tab-in-preferences-dialog">Editor or multiple spaces. The default indent mode is set in the <a class="reference" href="#editor-tab-in-preferences-dialog">Editor
tab in preferences dialog</a>. But this can be overridden using either tab in preferences dialog</a>. But this can be overridden using either
@ -823,7 +839,7 @@ as follows:</p>
</dl> </dl>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id28" id="auto-indentation" name="auto-indentation">Auto-indentation</a></h3> <h3><a class="toc-backref" href="#id29" id="auto-indentation" name="auto-indentation">Auto-indentation</a></h3>
<p>When enabled, auto-indentation happens when pressing <em>Enter</em> in the <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 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> user doesn't always have to indent each line manually.</p>
@ -844,7 +860,7 @@ match the indentation of the line with the opening brace.</dd>
</dl> </dl>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id29" id="bookmarks" name="bookmarks">Bookmarks</a></h3> <h3><a class="toc-backref" href="#id30" id="bookmarks" name="bookmarks">Bookmarks</a></h3>
<p>Geany provides a handy bookmarking feature that lets you mark one <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 or more lines in a document, and return the cursor to them using a
key combination.</p> key combination.</p>
@ -862,7 +878,7 @@ together with the commands to switch from one editor tab to another
navigate around multiple files.</p> navigate around multiple files.</p>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id30" id="code-navigation-history" name="code-navigation-history">Code Navigation History</a></h3> <h3><a class="toc-backref" href="#id31" id="code-navigation-history" name="code-navigation-history">Code Navigation History</a></h3>
<p>To ease navigation in source files and especially between <p>To ease navigation in source files and especially between
different files, Geany lets you jump between different navigation different files, Geany lets you jump between different navigation
points. Currently, this works when using the <a class="reference" href="#go-to-tag-declaration">Go to tag declaration</a>, points. Currently, this works when using the <a class="reference" href="#go-to-tag-declaration">Go to tag declaration</a>,
@ -876,7 +892,7 @@ location&quot;. This makes it easier to navigate in e.g. foreign code
and between different files.</p> and between different files.</p>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id31" id="send-text-through-definable-commands" name="send-text-through-definable-commands">Send text through definable commands</a></h3> <h3><a class="toc-backref" href="#id32" id="send-text-through-definable-commands" name="send-text-through-definable-commands">Send text through definable commands</a></h3>
<p>You can define several custom commands in Geany and send the current <p>You can define several custom commands in Geany and send the current
selection to one of these commands. The output of the command will be selection to one of these commands. The output of the command will be
used to replace the current selection. So, it is possible to use text used to replace the current selection. So, it is possible to use text
@ -893,7 +909,7 @@ some command line options. To delete a command, just clear the text
entry and press Ok. It will be deleted automatically.</p> entry and press Ok. It will be deleted automatically.</p>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id32" id="context-actions" name="context-actions">Context actions</a></h3> <h3><a class="toc-backref" href="#id33" id="context-actions" name="context-actions">Context actions</a></h3>
<p>You can execute a specified command on the current word near the <p>You can execute a specified command on the current word near the
cursor position or an available selection and this word is passed cursor position or an available selection and this word is passed
as an argument to this command. It can be used for example to open as an argument to this command. It can be used for example to open
@ -919,7 +935,7 @@ the word &quot;echo&quot;, a browser window will open(assumed your browser is
called firefox) and it will open the address: <a class="reference" href="http://www.php.net/echo">http://www.php.net/echo</a>.</p> called firefox) and it will open the address: <a class="reference" href="http://www.php.net/echo">http://www.php.net/echo</a>.</p>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id33" id="user-definable-snippets" name="user-definable-snippets">User-definable snippets</a></h3> <h3><a class="toc-backref" href="#id34" 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 <p>Snippets are small strings or code constructs which can be replaced or
completed to a more complex string. So you can save a lot of time by completed to a more complex string. So you can save a lot of time by
not typing often used strings and letting Geany do the work for you. not typing often used strings and letting Geany do the work for you.
@ -1006,7 +1022,7 @@ default characters or define it to add or remove characters to fit your
needs.</p> needs.</p>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id34" id="inserting-unicode-characters" name="inserting-unicode-characters">Inserting unicode characters</a></h3> <h3><a class="toc-backref" href="#id35" id="inserting-unicode-characters" name="inserting-unicode-characters">Inserting unicode characters</a></h3>
<p>With GTK 2.10 and above, you can hit Ctrl-Shift-u, then still holding <p>With GTK 2.10 and above, you can hit Ctrl-Shift-u, then still holding
Ctrl-Shift, type some hex digits representing the code point for the Ctrl-Shift, type some hex digits representing the code point for the
character you want, then let go of Ctrl-Shift and hit a key such as character you want, then let go of Ctrl-Shift and hit a key such as
@ -1022,7 +1038,7 @@ keys conflict with other Geany keybindings.</p>
</div> </div>
</div> </div>
<div class="section"> <div class="section">
<h2><a class="toc-backref" href="#id35" 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="#id36" 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 <p>This section describes search-related commands from the Search menu
and the editor window's popup menu:</p> and the editor window's popup menu:</p>
<ul class="simple"> <ul class="simple">
@ -1037,11 +1053,11 @@ and the editor window's popup menu:</p>
<p>* These items are available from the editor window's popup menu, or by <p>* These items are available from the editor window's popup menu, or by
using a keyboard shortcut (see the section called <a class="reference" href="#keybindings">Keybindings</a>).</p> using a keyboard shortcut (see the section called <a class="reference" href="#keybindings">Keybindings</a>).</p>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id36" id="find" name="find">Find</a></h3> <h3><a class="toc-backref" href="#id37" id="find" name="find">Find</a></h3>
<p>The Find dialog is used for finding text in one or more open documents.</p> <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" /> <img alt="./images/find_dialog.png" src="./images/find_dialog.png" />
<div class="section"> <div class="section">
<h4><a class="toc-backref" href="#id37" id="matching-options" name="matching-options">Matching options</a></h4> <h4><a class="toc-backref" href="#id38" id="matching-options" name="matching-options">Matching options</a></h4>
<p>The syntax for the Use regular expressions option is shown in <p>The syntax for the Use regular expressions option is shown in
<a class="reference" href="#regular-expressions">Regular expressions</a>.</p> <a class="reference" href="#regular-expressions">Regular expressions</a>.</p>
<p>The Use escape sequences option will transform any escaped characters <p>The Use escape sequences option will transform any escaped characters
@ -1050,7 +1066,7 @@ a tab character. Other recognised symbols are: \\, \n, \r, \uXXXX
(Unicode chararacters).</p> (Unicode chararacters).</p>
</div> </div>
<div class="section"> <div class="section">
<h4><a class="toc-backref" href="#id38" id="find-all" name="find-all">Find all</a></h4> <h4><a class="toc-backref" href="#id39" id="find-all" name="find-all">Find all</a></h4>
<p>To find all matches, click on the Find All expander. This will reveal <p>To find all matches, click on the Find All expander. This will reveal
several options:</p> several options:</p>
<ul class="simple"> <ul class="simple">
@ -1067,7 +1083,7 @@ matching lines will be highlighted. Markers and highlighting can be
removed by selecting the Remove Markers command from the Document menu.</p> removed by selecting the Remove Markers command from the Document menu.</p>
</div> </div>
<div class="section"> <div class="section">
<h4><a class="toc-backref" href="#id39" 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="#id40" 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 <p>All search related dialogs use a Monospace for the text input fields to
increase the readibility of input text. This is useful when you are increase the readibility of input text. This is useful when you are
typing e.g. regular expressions with spaces, periods and commas which typing e.g. regular expressions with spaces, periods and commas which
@ -1089,7 +1105,7 @@ for the search dialogs.</p>
</div> </div>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id40" id="find-usage" name="find-usage">Find usage</a></h3> <h3><a class="toc-backref" href="#id41" 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 <p>Find usage searches all open files. It is similar to the Find All In
Session Find dialog command.</p> Session Find dialog command.</p>
<p>If there is a selection, then it is used as the search text; otherwise <p>If there is a selection, then it is used as the search text; otherwise
@ -1099,7 +1115,7 @@ click position when the popup menu is used. The search results are
shown in the Messages tab of the Message Window.</p> shown in the Messages tab of the Message Window.</p>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id41" id="find-in-files" name="find-in-files">Find in files</a></h3> <h3><a class="toc-backref" href="#id42" 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 <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 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 must be correctly set in Preferences to the path of the system's Grep
@ -1108,7 +1124,7 @@ utility. GNU Grep is recommended.</p>
<p>The Extra options field is used to pass any additional arguments to <p>The Extra options field is used to pass any additional arguments to
the grep tool.</p> the grep tool.</p>
<div class="section"> <div class="section">
<h4><a class="toc-backref" href="#id42" 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="#id43" 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 <p>When using the <em>Recurse in subfolders</em> option with a directory that's
under version control, you can set the <em>Extra options</em> field to use under version control, you can set the <em>Extra options</em> field to use
grep's <tt class="docutils literal"><span class="pre">--exclude</span></tt> flag to filter out filenames.</p> grep's <tt class="docutils literal"><span class="pre">--exclude</span></tt> flag to filter out filenames.</p>
@ -1120,7 +1136,7 @@ filter out CVS and hidden directories like <tt class="docutils literal"><span cl
</div> </div>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id43" id="replace" name="replace">Replace</a></h3> <h3><a class="toc-backref" href="#id44" id="replace" name="replace">Replace</a></h3>
<p>The Replace dialog is used for replacing text in one or more open <p>The Replace dialog is used for replacing text in one or more open
documents.</p> documents.</p>
<img alt="./images/replace_dialog.png" src="./images/replace_dialog.png" /> <img alt="./images/replace_dialog.png" src="./images/replace_dialog.png" />
@ -1130,7 +1146,7 @@ dialog. See the section called <a class="reference" href="#matching-options">Mat
and to the replacement text; for the latter back references can be and to the replacement text; for the latter back references can be
used -- see the entry for '\n' in <a class="reference" href="#regular-expressions">Regular expressions</a>.</p> used -- see the entry for '\n' in <a class="reference" href="#regular-expressions">Regular expressions</a>.</p>
<div class="section"> <div class="section">
<h4><a class="toc-backref" href="#id44" id="replace-all" name="replace-all">Replace all</a></h4> <h4><a class="toc-backref" href="#id45" id="replace-all" name="replace-all">Replace all</a></h4>
<p>To replace several matches, click on the <em>Replace All</em> expander. This <p>To replace several matches, click on the <em>Replace All</em> expander. This
will reveal several options:</p> will reveal several options:</p>
<ul class="simple"> <ul class="simple">
@ -1145,7 +1161,7 @@ in the current selection of the current document.</p>
</div> </div>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id45" id="go-to-tag-definition" name="go-to-tag-definition">Go to tag definition</a></h3> <h3><a class="toc-backref" href="#id46" 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 <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 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 will switch to that file and go to the corresponding line number. The
@ -1154,17 +1170,17 @@ or the word underneath the popup menu click position when the popup
menu is used.</p> menu is used.</p>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id46" id="go-to-tag-declaration" name="go-to-tag-declaration">Go to tag declaration</a></h3> <h3><a class="toc-backref" href="#id47" 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 <p>Like Go to tag definition, but for a forward declaration such as a
function prototype or <tt class="docutils literal"><span class="pre">extern</span></tt> declaration instead of a function function prototype or <tt class="docutils literal"><span class="pre">extern</span></tt> declaration instead of a function
body.</p> body.</p>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id47" id="go-to-line" name="go-to-line">Go to line</a></h3> <h3><a class="toc-backref" href="#id48" 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> <p>Go to a particular line number in the current file.</p>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id48" id="regular-expressions" name="regular-expressions">Regular expressions</a></h3> <h3><a class="toc-backref" href="#id49" id="regular-expressions" name="regular-expressions">Regular expressions</a></h3>
<p>You can use regular expressions in the Find and Replace dialogs <p>You can use regular expressions in the Find and Replace dialogs
by selecting the Use regular expressions check box. The syntax is by selecting the Use regular expressions check box. The syntax is
POSIX-like, as described below in <a class="reference" href="#regular-expressions">Regular expressions</a>.</p> POSIX-like, as described below in <a class="reference" href="#regular-expressions">Regular expressions</a>.</p>
@ -1233,14 +1249,14 @@ Saam, Saaam and so on.</td>
</tbody> </tbody>
</table> </table>
<div class="section"> <div class="section">
<h4><a class="toc-backref" href="#id49" id="partial-posix-compatibility" name="partial-posix-compatibility">Partial POSIX compatibility</a></h4> <h4><a class="toc-backref" href="#id50" id="partial-posix-compatibility" name="partial-posix-compatibility">Partial POSIX compatibility</a></h4>
<p>Note that the POSIX '?' regular expression character for optional <p>Note that the POSIX '?' regular expression character for optional
matching is not supported by the Find and Replace dialogs.</p> matching is not supported by the Find and Replace dialogs.</p>
</div> </div>
</div> </div>
</div> </div>
<div class="section"> <div class="section">
<h2><a class="toc-backref" href="#id50" id="tags" name="tags">Tags</a></h2> <h2><a class="toc-backref" href="#id51" id="tags" name="tags">Tags</a></h2>
<p>Geany has built-in functionality for generating tag information (aka <p>Geany has built-in functionality for generating tag information (aka
&quot;workspace tags&quot;) for supported filetypes when you open a file. You &quot;workspace tags&quot;) for supported filetypes when you open a file. You
can also have Geany automatically load external tag files (aka &quot;global can also have Geany automatically load external tag files (aka &quot;global
@ -1250,7 +1266,7 @@ manually using <em>File --&gt; Load Tags</em>.</p>
(but is incompatible with ctags). You use Geany to generate global (but is incompatible with ctags). You use Geany to generate global
tags files, as described below.</p> tags files, as described below.</p>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id51" id="workspace-tags" name="workspace-tags">Workspace tags</a></h3> <h3><a class="toc-backref" href="#id52" id="workspace-tags" name="workspace-tags">Workspace tags</a></h3>
<p>Tags for each document are parsed whenever a file is loaded or <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 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 are also used for autocompletion of symbols and calltips for all documents
@ -1259,7 +1275,7 @@ open in the current session that have the same filetype.</p>
<a class="reference" href="#go-to-tag-definition">Go to tag definition</a>.</p> <a class="reference" href="#go-to-tag-definition">Go to tag definition</a>.</p>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id52" id="global-tags" name="global-tags">Global tags</a></h3> <h3><a class="toc-backref" href="#id53" id="global-tags" name="global-tags">Global tags</a></h3>
<p>Global tags are used to provide autocompletion of symbols and calltips <p>Global tags are used to provide autocompletion of symbols and calltips
without having to open the corresponding source files. This is intended 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 for library APIs, as the tags file only has to be updated when you upgrade
@ -1279,7 +1295,7 @@ name.lang_ext.tags
with the tags. See the section called <a class="reference" href="#filetype-extensions">Filetype extensions</a> for with the tags. See the section called <a class="reference" href="#filetype-extensions">Filetype extensions</a> for
more information.</p> more information.</p>
<div class="section"> <div class="section">
<h4><a class="toc-backref" href="#id53" id="default-global-tags-files" name="default-global-tags-files">Default global tags files</a></h4> <h4><a class="toc-backref" href="#id54" 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 <p>For some languages, a list of global tags is loaded when the
corresponding filetype is first used. Currently these are for:</p> corresponding filetype is first used. Currently these are for:</p>
<ul class="simple"> <ul class="simple">
@ -1291,7 +1307,7 @@ corresponding filetype is first used. Currently these are for:</p>
</ul> </ul>
</div> </div>
<div class="section"> <div class="section">
<h4><a class="toc-backref" href="#id54" 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="#id55" id="generating-a-global-tags-file" name="generating-a-global-tags-file">Generating a global tags file</a></h4>
<p><em>Filetypes support:</em></p> <p><em>Filetypes support:</em></p>
<p>Currently this is not yet supported for Pascal, PHP and LaTeX <p>Currently this is not yet supported for Pascal, PHP and LaTeX
filetypes.</p> filetypes.</p>
@ -1339,7 +1355,7 @@ upgrading Geany.</p>
</div> </div>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id55" id="ignore-tags" name="ignore-tags">Ignore tags</a></h3> <h3><a class="toc-backref" href="#id56" 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 <p>You can also ignore certain tags if they would lead to wrong parsing of
the code. Simply create a file called &quot;ignore.tags&quot; in your Geany the code. Simply create a file called &quot;ignore.tags&quot; in your Geany
configuration directory (usually <tt class="docutils literal"><span class="pre">~/.geany/</span></tt>). Then list all tags configuration directory (usually <tt class="docutils literal"><span class="pre">~/.geany/</span></tt>). Then list all tags
@ -1363,7 +1379,7 @@ Exuberant Ctags.</p>
</div> </div>
</div> </div>
<div class="section"> <div class="section">
<h2><a class="toc-backref" href="#id56" id="preferences" name="preferences">Preferences</a></h2> <h2><a class="toc-backref" href="#id57" id="preferences" name="preferences">Preferences</a></h2>
<p>You may adjust Geany's settings using the Edit --&gt; Preferences <p>You may adjust Geany's settings using the Edit --&gt; Preferences
dialog. Any changes you make there can be applied by hitting either dialog. Any changes you make there can be applied by hitting either
the Apply or the Ok button. These settings will persist between Geany the Apply or the Ok button. These settings will persist between Geany
@ -1381,12 +1397,12 @@ when restarting Geany.</p>
(if present) comes after the screenshot of that tab.</p> (if present) comes after the screenshot of that tab.</p>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id57" id="general-tab-in-preferences-dialog" name="general-tab-in-preferences-dialog">General tab in preferences dialog</a></h3> <h3><a class="toc-backref" href="#id58" id="general-tab-in-preferences-dialog" name="general-tab-in-preferences-dialog">General tab in preferences dialog</a></h3>
<p>General tab in preferences dialog</p> <p>General tab in preferences dialog</p>
<img alt="./images/pref_dialog_gen.png" src="./images/pref_dialog_gen.png" /> <img alt="./images/pref_dialog_gen.png" src="./images/pref_dialog_gen.png" />
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id58" id="interface-tab-in-preferences-dialog" name="interface-tab-in-preferences-dialog">Interface tab in preferences dialog</a></h3> <h3><a class="toc-backref" href="#id59" id="interface-tab-in-preferences-dialog" name="interface-tab-in-preferences-dialog">Interface tab in preferences dialog</a></h3>
<p>Interface tab in preferences dialog</p> <p>Interface tab in preferences dialog</p>
<img alt="./images/pref_dialog_interface.png" src="./images/pref_dialog_interface.png" /> <img alt="./images/pref_dialog_interface.png" src="./images/pref_dialog_interface.png" />
<p>The documents list and the editor tabs are two different ways <p>The documents list and the editor tabs are two different ways
@ -1396,17 +1412,17 @@ order, not alphabetical as shown in the documents list (regardless
whether or not editor tabs are visible).</p> whether or not editor tabs are visible).</p>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id59" id="toolbar-tab-in-preferences-dialog" name="toolbar-tab-in-preferences-dialog">Toolbar tab in preferences dialog</a></h3> <h3><a class="toc-backref" href="#id60" id="toolbar-tab-in-preferences-dialog" name="toolbar-tab-in-preferences-dialog">Toolbar tab in preferences dialog</a></h3>
<p>Toolbar tab in preferences dialog</p> <p>Toolbar tab in preferences dialog</p>
<img alt="./images/pref_dialog_toolbar.png" src="./images/pref_dialog_toolbar.png" /> <img alt="./images/pref_dialog_toolbar.png" src="./images/pref_dialog_toolbar.png" />
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id60" id="display-tab-in-preferences-dialog" name="display-tab-in-preferences-dialog">Display tab in preferences dialog</a></h3> <h3><a class="toc-backref" href="#id61" id="display-tab-in-preferences-dialog" name="display-tab-in-preferences-dialog">Display tab in preferences dialog</a></h3>
<p>This is for visual elements displayed in the editor window.</p> <p>This is for visual elements displayed in the editor window.</p>
<img alt="./images/pref_dialog_display.png" src="./images/pref_dialog_display.png" /> <img alt="./images/pref_dialog_display.png" src="./images/pref_dialog_display.png" />
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id61" id="editor-tab-in-preferences-dialog" name="editor-tab-in-preferences-dialog">Editor tab in preferences dialog</a></h3> <h3><a class="toc-backref" href="#id62" id="editor-tab-in-preferences-dialog" name="editor-tab-in-preferences-dialog">Editor tab in preferences dialog</a></h3>
<p>Editor tab in preferences dialog</p> <p>Editor tab in preferences dialog</p>
<img alt="./images/pref_dialog_edit.png" src="./images/pref_dialog_edit.png" /> <img alt="./images/pref_dialog_edit.png" src="./images/pref_dialog_edit.png" />
<p>Line wrapping refers to the display of the text in the <p>Line wrapping refers to the display of the text in the
@ -1414,22 +1430,22 @@ editor. (Currently, there is no setting to have Geany automatically
insert newlines into your document while you type.)</p> insert newlines into your document while you type.)</p>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id62" id="files-tab-in-preferences-dialog" name="files-tab-in-preferences-dialog">Files tab in preferences dialog</a></h3> <h3><a class="toc-backref" href="#id63" id="files-tab-in-preferences-dialog" name="files-tab-in-preferences-dialog">Files tab in preferences dialog</a></h3>
<p>Files tab in preferences dialog</p> <p>Files tab in preferences dialog</p>
<img alt="./images/pref_dialog_files.png" src="./images/pref_dialog_files.png" /> <img alt="./images/pref_dialog_files.png" src="./images/pref_dialog_files.png" />
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id63" id="tools-tab-in-preferences-dialog" name="tools-tab-in-preferences-dialog">Tools tab in preferences dialog</a></h3> <h3><a class="toc-backref" href="#id64" id="tools-tab-in-preferences-dialog" name="tools-tab-in-preferences-dialog">Tools tab in preferences dialog</a></h3>
<p>Tools tab in preferences dialog</p> <p>Tools tab in preferences dialog</p>
<img alt="./images/pref_dialog_tools.png" src="./images/pref_dialog_tools.png" /> <img alt="./images/pref_dialog_tools.png" src="./images/pref_dialog_tools.png" />
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id64" id="template-tab-in-preferences-dialog" name="template-tab-in-preferences-dialog">Template tab in preferences dialog</a></h3> <h3><a class="toc-backref" href="#id65" id="template-tab-in-preferences-dialog" name="template-tab-in-preferences-dialog">Template tab in preferences dialog</a></h3>
<p>Template tab in preferences dialog</p> <p>Template tab in preferences dialog</p>
<img alt="./images/pref_dialog_templ.png" src="./images/pref_dialog_templ.png" /> <img alt="./images/pref_dialog_templ.png" src="./images/pref_dialog_templ.png" />
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id65" id="keybinding-tab-in-preferences-dialog" name="keybinding-tab-in-preferences-dialog">Keybinding tab in preferences dialog</a></h3> <h3><a class="toc-backref" href="#id66" id="keybinding-tab-in-preferences-dialog" name="keybinding-tab-in-preferences-dialog">Keybinding tab in preferences dialog</a></h3>
<p>Keybinding tab in preferences dialog</p> <p>Keybinding tab in preferences dialog</p>
<img alt="./images/pref_dialog_keys.png" src="./images/pref_dialog_keys.png" /> <img alt="./images/pref_dialog_keys.png" src="./images/pref_dialog_keys.png" />
<p>There are some handy commands in here that are not, by default, <p>There are some handy commands in here that are not, by default,
@ -1440,18 +1456,18 @@ bound to a key combination, and may not be available as a menu item.</p>
</div> </div>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id66" id="printing-tab-in-preferences-dialog" name="printing-tab-in-preferences-dialog">Printing tab in preferences dialog</a></h3> <h3><a class="toc-backref" href="#id67" id="printing-tab-in-preferences-dialog" name="printing-tab-in-preferences-dialog">Printing tab in preferences dialog</a></h3>
<p>Printing tab in preferences dialog</p> <p>Printing tab in preferences dialog</p>
<img alt="./images/pref_dialog_printing.png" src="./images/pref_dialog_printing.png" /> <img alt="./images/pref_dialog_printing.png" src="./images/pref_dialog_printing.png" />
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id67" id="vte-tab-in-preferences-dialog" name="vte-tab-in-preferences-dialog">VTE tab in preferences dialog</a></h3> <h3><a class="toc-backref" href="#id68" id="vte-tab-in-preferences-dialog" name="vte-tab-in-preferences-dialog">VTE tab in preferences dialog</a></h3>
<p>VTE tab in preferences dialog</p> <p>VTE tab in preferences dialog</p>
<img alt="./images/pref_dialog_vte.png" src="./images/pref_dialog_vte.png" /> <img alt="./images/pref_dialog_vte.png" src="./images/pref_dialog_vte.png" />
</div> </div>
</div> </div>
<div class="section"> <div class="section">
<h2><a class="toc-backref" href="#id68" id="project-management" name="project-management">Project Management</a></h2> <h2><a class="toc-backref" href="#id69" id="project-management" name="project-management">Project Management</a></h2>
<p>Project Management is optional in Geany. Currently it can be used for:</p> <p>Project Management is optional in Geany. Currently it can be used for:</p>
<ul class="simple"> <ul class="simple">
<li>Storing and opening session files on a project basis.</li> <li>Storing and opening session files on a project basis.</li>
@ -1469,7 +1485,7 @@ Geany is shutdown. When restarting Geany, the previously opened project
file that was in use at the end of the last session will be reopened.</p> file that was in use at the end of the last session will be reopened.</p>
<p>Below are the commands used to create, modify, open and close projects.</p> <p>Below are the commands used to create, modify, open and close projects.</p>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id69" id="new-project" name="new-project">New Project</a></h3> <h3><a class="toc-backref" href="#id70" id="new-project" name="new-project">New Project</a></h3>
<p>To create a new project, fill in the <em>Name</em> field. By default this <p>To create a new project, fill in the <em>Name</em> field. By default this
will setup a new project file <tt class="docutils literal"><span class="pre">~/projects/name.geany</span></tt>. Usually it's will setup a new project file <tt class="docutils literal"><span class="pre">~/projects/name.geany</span></tt>. Usually it's
best to store all your project files in the same directory (they are best to store all your project files in the same directory (they are
@ -1479,7 +1495,7 @@ can safely be set to any existing path -- it will not touch the file
structure contained in it.</p> structure contained in it.</p>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id70" id="project-properties" name="project-properties">Project Properties</a></h3> <h3><a class="toc-backref" href="#id71" id="project-properties" name="project-properties">Project Properties</a></h3>
<p>You can set an optional description for the project, but it is not <p>You can set an optional description for the project, but it is not
used elsewhere by Geany.</p> used elsewhere by Geany.</p>
<p>The <em>Base path</em> field is used as the directory to run the Make and Make <p>The <em>Base path</em> field is used as the directory to run the Make and Make
@ -1488,13 +1504,13 @@ specific <em>Run command</em>.
The specified path can be an absolute path or relative to the project's The specified path can be an absolute path or relative to the project's
file name.</p> file name.</p>
<div class="section"> <div class="section">
<h4><a class="toc-backref" href="#id71" id="make-in-base-path" name="make-in-base-path">Make in base path</a></h4> <h4><a class="toc-backref" href="#id72" id="make-in-base-path" name="make-in-base-path">Make in base path</a></h4>
<p>This setting makes the <em>Build-&gt;Make</em> command use the project's base <p>This setting makes the <em>Build-&gt;Make</em> command use the project's base
path. Uncheck this if you want to use the current file's directory path. Uncheck this if you want to use the current file's directory
instead.</p> instead.</p>
</div> </div>
<div class="section"> <div class="section">
<h4><a class="toc-backref" href="#id72" id="run-command" name="run-command">Run command</a></h4> <h4><a class="toc-backref" href="#id73" id="run-command" name="run-command">Run command</a></h4>
<p>The <em>Run command</em> overrides the default run command. You can set this <p>The <em>Run command</em> overrides the default run command. You can set this
to the executable or main script file for the project, and append to the executable or main script file for the project, and append
any command-line arguments.</p> any command-line arguments.</p>
@ -1507,7 +1523,7 @@ any command-line arguments.</p>
</div> </div>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id73" id="open-project" name="open-project">Open Project</a></h3> <h3><a class="toc-backref" href="#id74" id="open-project" name="open-project">Open Project</a></h3>
<p>The Open command displays a standard file chooser, starting in <p>The Open command displays a standard file chooser, starting in
<tt class="docutils literal"><span class="pre">~/projects</span></tt>. Choose a project file named with the <tt class="docutils literal"><span class="pre">.geany</span></tt> <tt class="docutils literal"><span class="pre">~/projects</span></tt>. Choose a project file named with the <tt class="docutils literal"><span class="pre">.geany</span></tt>
extension.</p> extension.</p>
@ -1515,14 +1531,14 @@ extension.</p>
open files and open the session files associated with the project.</p> open files and open the session files associated with the project.</p>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id74" id="close-project" name="close-project">Close Project</a></h3> <h3><a class="toc-backref" href="#id75" id="close-project" name="close-project">Close Project</a></h3>
<p>Project file settings are saved when the project is closed.</p> <p>Project file settings are saved when the project is closed.</p>
<p>When project session support is enabled, Geany will close the project <p>When project session support is enabled, Geany will close the project
session files and open any previously closed default session files.</p> session files and open any previously closed default session files.</p>
</div> </div>
</div> </div>
<div class="section"> <div class="section">
<h2><a class="toc-backref" href="#id75" id="build-system" name="build-system">Build system</a></h2> <h2><a class="toc-backref" href="#id76" id="build-system" name="build-system">Build system</a></h2>
<p>Geany has an integrated build system. Firstly this means that the <p>Geany has an integrated build system. Firstly this means that the
current source file will be saved before it is processed. This is current source file will be saved before it is processed. This is
for convenience so that you don't need to keep saving small changes for convenience so that you don't need to keep saving small changes
@ -1546,7 +1562,7 @@ the following items:</p>
<li>Set Includes and Arguments</li> <li>Set Includes and Arguments</li>
</ul> </ul>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id76" id="compile" name="compile">Compile</a></h3> <h3><a class="toc-backref" href="#id77" id="compile" name="compile">Compile</a></h3>
<p>The Compile command has different uses for different kinds of files.</p> <p>The Compile command has different uses for different kinds of files.</p>
<p>For compilable languages such as C and C++, the Compile command is <p>For compilable languages such as C and C++, the Compile command is
setup to compile the current source file into a binary object file.</p> setup to compile the current source file into a binary object file.</p>
@ -1556,7 +1572,7 @@ language supports it, or will run a syntax check, or failing that
will run the file in its language interpreter.</p> will run the file in its language interpreter.</p>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id77" id="build" name="build">Build</a></h3> <h3><a class="toc-backref" href="#id78" id="build" name="build">Build</a></h3>
<p>For compilable languages such as C and C++, the Build command will link <p>For compilable languages such as C and C++, the Build command will link
the current source file's equivalent object file into an executable. If the current source file's equivalent object file into an executable. If
the object file does not exist, the source will be compiled and linked the object file does not exist, the source will be compiled and linked
@ -1564,7 +1580,7 @@ in one step, producing just the executable binary.</p>
<p>Interpreted languages do not use the Build command.</p> <p>Interpreted languages do not use the Build command.</p>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id78" id="make-all" name="make-all">Make all</a></h3> <h3><a class="toc-backref" href="#id79" id="make-all" name="make-all">Make all</a></h3>
<p>This effectively runs &quot;make all&quot; in the same directory as the <p>This effectively runs &quot;make all&quot; in the same directory as the
current file.</p> current file.</p>
<div class="note"> <div class="note">
@ -1574,19 +1590,19 @@ set in the Tools tab of the Preferences dialog.</p>
</div> </div>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id79" id="make-custom-target" name="make-custom-target">Make custom target</a></h3> <h3><a class="toc-backref" href="#id80" id="make-custom-target" name="make-custom-target">Make custom target</a></h3>
<p>This is similar to running 'Make all' but you will be prompted for <p>This is similar to running 'Make all' but you will be prompted for
the make target name to be passed to the Make tool. For example, the make target name to be passed to the Make tool. For example,
typing 'clean' in the dialog prompt will run &quot;make clean&quot;.</p> typing 'clean' in the dialog prompt will run &quot;make clean&quot;.</p>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id80" id="make-object" name="make-object">Make object</a></h3> <h3><a class="toc-backref" href="#id81" id="make-object" name="make-object">Make object</a></h3>
<p>Make object will run &quot;make current_file.o&quot; in the same directory as <p>Make object will run &quot;make current_file.o&quot; in the same directory as
the current file, using its prefix for 'current_file'. It is useful the current file, using its prefix for 'current_file'. It is useful
for compiling just the current file without building the whole project.</p> for compiling just the current file without building the whole project.</p>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id81" id="execute" name="execute">Execute</a></h3> <h3><a class="toc-backref" href="#id82" id="execute" name="execute">Execute</a></h3>
<p>Execute will run the corresponding executable file, shell script or <p>Execute will run the corresponding executable file, shell script or
interpreted script in a terminal window. Note that the Terminal tool interpreted script in a terminal window. Note that the Terminal tool
path must be correctly set in the Tools tab of the Preferences dialog - path must be correctly set in the Tools tab of the Preferences dialog -
@ -1597,7 +1613,7 @@ prompted to press the return key. This allows you to review any text
output from the program before the terminal window is closed.</p> output from the program before the terminal window is closed.</p>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id82" id="stopping-running-processes" name="stopping-running-processes">Stopping running processes</a></h3> <h3><a class="toc-backref" href="#id83" id="stopping-running-processes" name="stopping-running-processes">Stopping running processes</a></h3>
<p>When there is a running program, the Run button in the toolbar <p>When there is a running program, the Run button in the toolbar
becomes a stop button and you can stop the current action. This becomes a stop button and you can stop the current action. This
works by sending a signal to the process (and its child process(es)) works by sending a signal to the process (and its child process(es))
@ -1606,7 +1622,7 @@ to stop the process. The used signal is SIGQUIT.</p>
cannot be stopped. This can happen when the process creates more than cannot be stopped. This can happen when the process creates more than
one child process.</p> one child process.</p>
<div class="section"> <div class="section">
<h4><a class="toc-backref" href="#id83" id="terminal-emulators" name="terminal-emulators">Terminal emulators</a></h4> <h4><a class="toc-backref" href="#id84" id="terminal-emulators" name="terminal-emulators">Terminal emulators</a></h4>
<p>Xterm is known to work properly. If you are using &quot;Terminal&quot; <p>Xterm is known to work properly. If you are using &quot;Terminal&quot;
(the terminal program of Xfce), you should add the command line (the terminal program of Xfce), you should add the command line
option <tt class="docutils literal"><span class="pre">--disable-server</span></tt> otherwise the started process cannot be option <tt class="docutils literal"><span class="pre">--disable-server</span></tt> otherwise the started process cannot be
@ -1615,7 +1631,7 @@ tab in the terminal field.</p>
</div> </div>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id84" id="set-includes-and-arguments" name="set-includes-and-arguments">Set Includes and Arguments</a></h3> <h3><a class="toc-backref" href="#id85" id="set-includes-and-arguments" name="set-includes-and-arguments">Set Includes and Arguments</a></h3>
<p>By default the Compile and Build commands invoke the compiler and <p>By default the Compile and Build commands invoke the compiler and
linker with only the basic arguments needed by all programs. Using linker with only the basic arguments needed by all programs. Using
Set Includes and Arguments you can add any include paths and compile Set Includes and Arguments you can add any include paths and compile
@ -1632,14 +1648,14 @@ and any arguments you want to use when running Execute.</p>
different settings, then writing a Makefile and using the Make commands different settings, then writing a Makefile and using the Make commands
is recommended.</p> is recommended.</p>
<div class="section"> <div class="section">
<h4><a class="toc-backref" href="#id85" id="one-step-compilation" name="one-step-compilation">One step compilation</a></h4> <h4><a class="toc-backref" href="#id86" id="one-step-compilation" name="one-step-compilation">One step compilation</a></h4>
<p>If you are using the Build command to compile and link in one step, <p>If you are using the Build command to compile and link in one step,
you will need to set both the compiler arguments and the linker you will need to set both the compiler arguments and the linker
arguments in the linker command setting.</p> arguments in the linker command setting.</p>
</div> </div>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id86" id="indicators" name="indicators">Indicators</a></h3> <h3><a class="toc-backref" href="#id87" id="indicators" name="indicators">Indicators</a></h3>
<p>Indicators are red squiggly underlines which are used to highlight <p>Indicators are red squiggly underlines which are used to highlight
errors which occured while compiling the current file. So you can errors which occured while compiling the current file. So you can
easily see where your code failed to compile. To remove the indicators, easily see where your code failed to compile. To remove the indicators,
@ -1649,7 +1665,7 @@ dialog.</p>
</div> </div>
</div> </div>
<div class="section"> <div class="section">
<h2><a class="toc-backref" href="#id87" id="printing-support" name="printing-support">Printing support</a></h2> <h2><a class="toc-backref" href="#id88" id="printing-support" name="printing-support">Printing support</a></h2>
<p>Since Geany 0.13 there is full printing support using GTK's printing API. <p>Since Geany 0.13 there is full printing support using GTK's printing API.
The printed page(s) will look nearly the same as on your screen in Geany. The printed page(s) will look nearly the same as on your screen in Geany.
Additionally, there are some options to modify the printed page(s). You Additionally, there are some options to modify the printed page(s). You
@ -1697,7 +1713,7 @@ command line).</p>
gtklp or similar programs can be used.</p> gtklp or similar programs can be used.</p>
</div> </div>
<div class="section"> <div class="section">
<h2><a class="toc-backref" href="#id88" id="plugins" name="plugins">Plugins</a></h2> <h2><a class="toc-backref" href="#id89" id="plugins" name="plugins">Plugins</a></h2>
<p>Plugins are loaded at startup, if the <em>Enable plugin support</em> <p>Plugins are loaded at startup, if the <em>Enable plugin support</em>
general preference is set. There is also a command-line option, general preference is set. There is also a command-line option,
<tt class="docutils literal"><span class="pre">-p</span></tt>, which prevents plugins being loaded. Plugins are scanned in <tt class="docutils literal"><span class="pre">-p</span></tt>, which prevents plugins being loaded. Plugins are scanned in
@ -1717,13 +1733,13 @@ You can also configure some plugin specific options when the plugin
provides some.</p> provides some.</p>
</div> </div>
<div class="section"> <div class="section">
<h2><a class="toc-backref" href="#id89" id="keybindings" name="keybindings">Keybindings</a></h2> <h2><a class="toc-backref" href="#id90" id="keybindings" name="keybindings">Keybindings</a></h2>
<p>Geany supports the default keyboard shortcuts for the Scintilla <p>Geany supports the default keyboard shortcuts for the Scintilla
editing widget. For a list of these commands, see <a class="reference" href="#scintilla-keyboard-commands">Scintilla editing widget. For a list of these commands, see <a class="reference" href="#scintilla-keyboard-commands">Scintilla
keyboard commands</a>. The Scintilla keyboard shortcuts will be overridden keyboard commands</a>. The Scintilla keyboard shortcuts will be overridden
by any custom keybindings with the same keyboard shortcut.</p> by any custom keybindings with the same keyboard shortcut.</p>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id90" id="switching-documents" name="switching-documents">Switching documents</a></h3> <h3><a class="toc-backref" href="#id91" id="switching-documents" name="switching-documents">Switching documents</a></h3>
<p>There are a few non-configurable bindings to switch between documents, <p>There are a few non-configurable bindings to switch between documents,
listed below. These can also be overridden by custom keybindings.</p> listed below. These can also be overridden by custom keybindings.</p>
<table border="1" class="docutils"> <table border="1" class="docutils">
@ -1753,7 +1769,7 @@ listed below. These can also be overridden by custom keybindings.</p>
</table> </table>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id91" id="configurable-keybindings" name="configurable-keybindings">Configurable keybindings</a></h3> <h3><a class="toc-backref" href="#id92" id="configurable-keybindings" name="configurable-keybindings">Configurable keybindings</a></h3>
<p>For all actions listed below you can define your own keybindings. Open <p>For all actions listed below you can define your own keybindings. Open
the Preferences dialog, select the desired action and click on the Preferences dialog, select the desired action and click on
change. In the opening dialog you can press any key combination you change. In the opening dialog you can press any key combination you
@ -2256,9 +2272,9 @@ actions</a>.</td>
</div> </div>
</div> </div>
<div class="section"> <div class="section">
<h1><a class="toc-backref" href="#id92" id="configuration-files" name="configuration-files">Configuration files</a></h1> <h1><a class="toc-backref" href="#id93" id="configuration-files" name="configuration-files">Configuration files</a></h1>
<div class="section"> <div class="section">
<h2><a class="toc-backref" href="#id93" id="global-configuration-file" name="global-configuration-file">Global configuration file</a></h2> <h2><a class="toc-backref" href="#id94" id="global-configuration-file" name="global-configuration-file">Global configuration file</a></h2>
<p>You can use a global configuration file for Geany which will be used if <p>You can use a global configuration file for Geany which will be used if
the user starts Geany for the first time and an user's configuration the user starts Geany for the first time and an user's configuration
file was not yet created or in case an user deleted the configuration file was not yet created or in case an user deleted the configuration
@ -2278,7 +2294,7 @@ need to do that.</p>
</div> </div>
</div> </div>
<div class="section"> <div class="section">
<h2><a class="toc-backref" href="#id94" id="filetype-definition-files" name="filetype-definition-files">Filetype definition files</a></h2> <h2><a class="toc-backref" href="#id95" id="filetype-definition-files" name="filetype-definition-files">Filetype definition files</a></h2>
<p>All colour definitions and other filetype specific settings are <p>All colour definitions and other filetype specific settings are
stored in the filetype definition files. Those settings are colours stored in the filetype definition files. Those settings are colours
for syntax highlighting, general settings like comment characters or for syntax highlighting, general settings like comment characters or
@ -2306,9 +2322,9 @@ configuration directory. Alternatively, you can create a file
to change. All missing settings will be read from the corresponding to change. All missing settings will be read from the corresponding
global definition file in <tt class="docutils literal"><span class="pre">$prefix/share/geany</span></tt>.</p> global definition file in <tt class="docutils literal"><span class="pre">$prefix/share/geany</span></tt>.</p>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id95" id="format" name="format">Format</a></h3> <h3><a class="toc-backref" href="#id96" id="format" name="format">Format</a></h3>
<div class="section"> <div class="section">
<h4><a class="toc-backref" href="#id96" id="styling-section" name="styling-section">[styling] Section</a></h4> <h4><a class="toc-backref" href="#id97" id="styling-section" name="styling-section">[styling] Section</a></h4>
<p>In this section the colours for syntax highlighting are defined. The <p>In this section the colours for syntax highlighting are defined. The
format is always: key=forground_colour;background_colour;bold;italic</p> format is always: key=forground_colour;background_colour;bold;italic</p>
<p>Colours have to be specified as RGB hex values prefixed by <p>Colours have to be specified as RGB hex values prefixed by
@ -2318,7 +2334,7 @@ and italic are flags and should only be &quot;true&quot; or &quot;false&quot;. I
value is something other than &quot;true&quot; or &quot;false&quot;, &quot;false&quot; is assumed.</p> value is something other than &quot;true&quot; or &quot;false&quot;, &quot;false&quot; is assumed.</p>
</div> </div>
<div class="section"> <div class="section">
<h4><a class="toc-backref" href="#id97" id="keywords-section" name="keywords-section">[keywords] Section</a></h4> <h4><a class="toc-backref" href="#id98" id="keywords-section" name="keywords-section">[keywords] Section</a></h4>
<p>This section contains keys for different keyword lists specific to <p>This section contains keys for different keyword lists specific to
the filetype. Some filetypes do not support keywords, so adding a the filetype. Some filetypes do not support keywords, so adding a
new key will not work. You can only add or remove keywords to/from new key will not work. You can only add or remove keywords to/from
@ -2329,7 +2345,7 @@ an existing list.</p>
</div> </div>
</div> </div>
<div class="section"> <div class="section">
<h4><a class="toc-backref" href="#id98" id="settings-section" name="settings-section">[settings] Section</a></h4> <h4><a class="toc-backref" href="#id99" id="settings-section" name="settings-section">[settings] Section</a></h4>
<dl class="docutils"> <dl class="docutils">
<dt>extension</dt> <dt>extension</dt>
<dd><p class="first">This is the default file extension used when saving files, not <dd><p class="first">This is the default file extension used when saving files, not
@ -2390,7 +2406,7 @@ context_action_cmd=firefox &quot;<a class="reference" href="http://www.php.net/%
</dl> </dl>
</div> </div>
<div class="section"> <div class="section">
<h4><a class="toc-backref" href="#id99" id="build-settings-section" name="build-settings-section">[build_settings] Section</a></h4> <h4><a class="toc-backref" href="#id100" id="build-settings-section" name="build-settings-section">[build_settings] Section</a></h4>
<dl class="docutils"> <dl class="docutils">
<dt>compiler</dt> <dt>compiler</dt>
<dd><p class="first">This item specifies the command to compile source code files. But <dd><p class="first">This item specifies the command to compile source code files. But
@ -2423,7 +2439,7 @@ complete filename, e.g. for shell scripts.</p>
</div> </div>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id100" id="special-file-filetypes-common" name="special-file-filetypes-common">Special file filetypes.common</a></h3> <h3><a class="toc-backref" href="#id101" id="special-file-filetypes-common" name="special-file-filetypes-common">Special file filetypes.common</a></h3>
<p>There is a special filetype definition file called <p>There is a special filetype definition file called
filetypes.common. This file defines some general non-filetype-specific filetypes.common. This file defines some general non-filetype-specific
settings.</p> settings.</p>
@ -2567,7 +2583,7 @@ when moving, selecting and deleting across word boundaries
</div> </div>
</div> </div>
<div class="section"> <div class="section">
<h2><a class="toc-backref" href="#id101" id="filetype-extensions" name="filetype-extensions">Filetype extensions</a></h2> <h2><a class="toc-backref" href="#id102" id="filetype-extensions" name="filetype-extensions">Filetype extensions</a></h2>
<p>To change the default filetype extension used when saving a new file, <p>To change the default filetype extension used when saving a new file,
see <a class="reference" href="#filetype-definition-files">Filetype definition files</a>.</p> see <a class="reference" href="#filetype-definition-files">Filetype definition files</a>.</p>
<p>You can override the list of file extensions that Geany uses for each <p>You can override the list of file extensions that Geany uses for each
@ -2593,7 +2609,7 @@ Make=Makefile*;*.mk;Buildfile;
</pre> </pre>
</div> </div>
<div class="section"> <div class="section">
<h2><a class="toc-backref" href="#id102" id="templates" name="templates">Templates</a></h2> <h2><a class="toc-backref" href="#id103" id="templates" name="templates">Templates</a></h2>
<p>Geany supports the following templates:</p> <p>Geany supports the following templates:</p>
<ul class="simple"> <ul class="simple">
<li>ChangeLog entry</li> <li>ChangeLog entry</li>
@ -2616,7 +2632,7 @@ of a function or the function name cannot be determined, the inserted
function description won't contain the correct function name but &quot;unknown&quot; function description won't contain the correct function name but &quot;unknown&quot;
instead.</p> instead.</p>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id103" id="template-metadata" name="template-metadata">Template metadata</a></h3> <h3><a class="toc-backref" href="#id104" id="template-metadata" name="template-metadata">Template metadata</a></h3>
<p>Metadata can be used with all templates, but by default user set <p>Metadata can be used with all templates, but by default user set
metadata is only used for the ChangeLog and File header templates.</p> metadata is only used for the ChangeLog and File header templates.</p>
<p>In the configuration dialog you can find a tab &quot;Templates&quot; (see <p>In the configuration dialog you can find a tab &quot;Templates&quot; (see
@ -2626,7 +2642,7 @@ restart Geany after making changes, because they are only read
at startup.</p> at startup.</p>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id104" id="filetype-templates" name="filetype-templates">Filetype templates</a></h3> <h3><a class="toc-backref" href="#id105" id="filetype-templates" name="filetype-templates">Filetype templates</a></h3>
<p>Filetype templates are templates used as the basis of a new file. To <p>Filetype templates are templates used as the basis of a new file. To
use them, choose the <em>New (with Template)</em> menu item from the <em>File</em> use them, choose the <em>New (with Template)</em> menu item from the <em>File</em>
menu.</p> menu.</p>
@ -2647,7 +2663,7 @@ followed by a blank line.</p>
the New command is used without a filetype. This is empty by default.</p> the New command is used without a filetype. This is empty by default.</p>
</div> </div>
<div class="section"> <div class="section">
<h3><a class="toc-backref" href="#id105" id="customizing-templates" name="customizing-templates">Customizing templates</a></h3> <h3><a class="toc-backref" href="#id106" id="customizing-templates" name="customizing-templates">Customizing templates</a></h3>
<p>Each template can be customized to your needs. The templates are <p>Each template can be customized to your needs. The templates are
stored in the <tt class="docutils literal"><span class="pre">~/.geany/templates/</span></tt> directory (see the section called stored in the <tt class="docutils literal"><span class="pre">~/.geany/templates/</span></tt> directory (see the section called
<a class="reference" href="#command-line-options">Command line options</a> for further information about the configuration <a class="reference" href="#command-line-options">Command line options</a> for further information about the configuration
@ -2655,7 +2671,7 @@ directory). Just open the desired template with an editor (ideally,
Geany ;-) ) and edit the template to your needs. There are some Geany ;-) ) and edit the template to your needs. There are some
wildcards which will be automatically replaced by Geany at startup.</p> wildcards which will be automatically replaced by Geany at startup.</p>
<div class="section"> <div class="section">
<h4><a class="toc-backref" href="#id106" id="template-wildcards" name="template-wildcards">Template wildcards</a></h4> <h4><a class="toc-backref" href="#id107" id="template-wildcards" name="template-wildcards">Template wildcards</a></h4>
<p>All wildcards must be enclosed by &quot;{&quot; and &quot;}&quot;, e.g. {date}.</p> <p>All wildcards must be enclosed by &quot;{&quot; and &quot;}&quot;, e.g. {date}.</p>
<table border="1" class="docutils"> <table border="1" class="docutils">
<colgroup> <colgroup>
@ -2764,7 +2780,7 @@ templates.</td>
</div> </div>
</div> </div>
<div class="section"> <div class="section">
<h1><a class="toc-backref" href="#id107" id="contributing-to-this-document" name="contributing-to-this-document">Contributing to this document</a></h1> <h1><a class="toc-backref" href="#id108" id="contributing-to-this-document" name="contributing-to-this-document">Contributing to this document</a></h1>
<p>This document (<tt class="docutils literal"><span class="pre">geany.txt</span></tt>) is written in <a class="reference" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a> <p>This document (<tt class="docutils literal"><span class="pre">geany.txt</span></tt>) is written in <a class="reference" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a>
(or &quot;reST&quot;). The source file for it is located in Geany's <tt class="docutils literal"><span class="pre">doc</span></tt> (or &quot;reST&quot;). The source file for it is located in Geany's <tt class="docutils literal"><span class="pre">doc</span></tt>
subdirectory. If you intend on making changes, you should grab the subdirectory. If you intend on making changes, you should grab the
@ -2784,7 +2800,7 @@ to build the docs. The package is named <tt class="docutils literal"><span class
and Fedora systems.</p> and Fedora systems.</p>
</div> </div>
<div class="section"> <div class="section">
<h1><a class="toc-backref" href="#id108" id="scintilla-keyboard-commands" name="scintilla-keyboard-commands">Scintilla keyboard commands</a></h1> <h1><a class="toc-backref" href="#id109" id="scintilla-keyboard-commands" name="scintilla-keyboard-commands">Scintilla keyboard commands</a></h1>
<p>Copyright © 1998, 2006 Neil Hodgson &lt;neilh(at)scintilla(dot)org&gt;</p> <p>Copyright © 1998, 2006 Neil Hodgson &lt;neilh(at)scintilla(dot)org&gt;</p>
<p>This appendix is distributed under the terms of the License for <p>This appendix is distributed under the terms of the License for
Scintilla and SciTE. A copy of this license can be found in the file Scintilla and SciTE. A copy of this license can be found in the file
@ -2793,7 +2809,7 @@ program and in the appendix of this document. See <a class="reference" href="#li
Scintilla and SciTE</a>.</p> Scintilla and SciTE</a>.</p>
<p>20 June 2006</p> <p>20 June 2006</p>
<div class="section"> <div class="section">
<h2><a class="toc-backref" href="#id109" id="keyboard-commands" name="keyboard-commands">Keyboard commands</a></h2> <h2><a class="toc-backref" href="#id110" id="keyboard-commands" name="keyboard-commands">Keyboard commands</a></h2>
<p>Keyboard commands for Scintilla mostly follow common Windows and GTK+ <p>Keyboard commands for Scintilla mostly follow common Windows and GTK+
conventions. All move keys (arrows, page up/down, home and end) conventions. All move keys (arrows, page up/down, home and end)
allows to extend or reduce the stream selection when holding the allows to extend or reduce the stream selection when holding the
@ -2893,7 +2909,7 @@ menus. Some less common commands with no menu equivalent are:</p>
</div> </div>
</div> </div>
<div class="section"> <div class="section">
<h1><a class="toc-backref" href="#id110" id="hidden-preferences" name="hidden-preferences">Hidden preferences</a></h1> <h1><a class="toc-backref" href="#id111" id="hidden-preferences" name="hidden-preferences">Hidden preferences</a></h1>
<p>There are some uncommon preferences that are not shown in the Preferences <p>There are some uncommon preferences that are not shown in the Preferences
dialog. These can be set by editing <tt class="docutils literal"><span class="pre">~/.geany/geany.conf</span></tt>, then dialog. These can be set by editing <tt class="docutils literal"><span class="pre">~/.geany/geany.conf</span></tt>, then
restarting Geany. Search for the key name, then edit the value. Example:</p> restarting Geany. Search for the key name, then edit the value. Example:</p>
@ -2965,7 +2981,7 @@ available with GTK 2.12 or above).</td>
</table> </table>
</div> </div>
<div class="section"> <div class="section">
<h1><a class="toc-backref" href="#id111" id="compile-time-options" name="compile-time-options">Compile-time options</a></h1> <h1><a class="toc-backref" href="#id112" id="compile-time-options" name="compile-time-options">Compile-time options</a></h1>
<p>There are some options which can only be changed at compile time. To <p>There are some options which can only be changed at compile time. To
change these options, edit the file src/geany.h. Look for a block of change these options, edit the file src/geany.h. Look for a block of
lines starting with <tt class="docutils literal"><span class="pre">#define</span> <span class="pre">GEANY_*</span></tt>. Any definitions which are lines starting with <tt class="docutils literal"><span class="pre">#define</span> <span class="pre">GEANY_*</span></tt>. Any definitions which are
@ -3115,7 +3131,7 @@ when building on a non-Win32 system.</em></td>
</table> </table>
</div> </div>
<div class="section"> <div class="section">
<h1><a class="toc-backref" href="#id112" id="gnu-general-public-license" name="gnu-general-public-license">GNU General Public License</a></h1> <h1><a class="toc-backref" href="#id113" id="gnu-general-public-license" name="gnu-general-public-license">GNU General Public License</a></h1>
<pre class="literal-block"> <pre class="literal-block">
GNU GENERAL PUBLIC LICENSE GNU GENERAL PUBLIC LICENSE
Version 2, June 1991 Version 2, June 1991
@ -3460,7 +3476,7 @@ Public License instead of this License.
</pre> </pre>
</div> </div>
<div class="section"> <div class="section">
<h1><a class="toc-backref" href="#id113" id="license-for-scintilla-and-scite" name="license-for-scintilla-and-scite">License for Scintilla and SciTE</a></h1> <h1><a class="toc-backref" href="#id114" id="license-for-scintilla-and-scite" name="license-for-scintilla-and-scite">License for Scintilla and SciTE</a></h1>
<p>Copyright 1998-2003 by Neil Hodgson &lt;neilh(at)scintilla(dot)org&gt;</p> <p>Copyright 1998-2003 by Neil Hodgson &lt;neilh(at)scintilla(dot)org&gt;</p>
<p>All Rights Reserved</p> <p>All Rights Reserved</p>
<p>Permission to use, copy, modify, and distribute this software and <p>Permission to use, copy, modify, and distribute this software and
@ -3480,7 +3496,7 @@ USE OR PERFORMANCE OF THIS SOFTWARE.</p>
<div class="footer"> <div class="footer">
<hr class="footer" /> <hr class="footer" />
<a class="reference" href="geany.txt">View document source</a>. <a class="reference" href="geany.txt">View document source</a>.
Generated on: 2008-03-13 07:03 UTC. Generated on: 2008-03-17 12:54 UTC.
Generated by <a class="reference" href="http://docutils.sourceforge.net/">Docutils</a> from <a class="reference" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a> source. Generated by <a class="reference" href="http://docutils.sourceforge.net/">Docutils</a> from <a class="reference" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a> source.
</div> </div>

16
doc/geany.txt
View File

@ -533,6 +533,22 @@ children of a fold point" option is enabled, pressing Shift will disable
it for this click and vice versa. it for this click and vice versa.
Column mode editing
^^^^^^^^^^^^^^^^^^^
There is basic support for column mode editing. To use it, create a
rectangular selection by holding down the Control key while selecting
some text. It is also possible to create a zero-column selection but
be careful because there is no visual indication of this selection.
Once a rectangular selection exists you can start editing the text within
this selection and the modifications will be done for every line in the
selection.
.. note::
Copying and pasting text with rectangular selections doesn't work.
It might give unexpected results and damage your text.
Drag and drop of text Drag and drop of text
^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^