Commits October 2010

commits@lists.geany.org

5 participants
87 discussions

Nightly build failed: Geany GTK 2.8 build test
by noreply＠nightly.geany.org 06 Oct '10

06 Oct '10

Geany GTK 2.8 build test failed at: waf build See http://geany.nightlybuilds.org/misc/build_gtk28_geany_stderr.log for details. Error messages: In file included from ../../gtk28_test/src/geanywraplabel.c:31: ../../gtk28_test/src/utils.h: In function 'utils_strv_join': ../../gtk28_test/src/utils.h:221: error: expected declaration specifiers before 'G_GNUC_WARN_UNUSED_RESULT' In file included from ../../gtk28_test/src/geanywraplabel.c:32: ... ../../gtk28_test/src/geanywraplabel.c:132: error: expected '=', ',', ';', 'asm' or '__attribute__' before '{' token ../../gtk28_test/src/geanywraplabel.c:141: error: expected '=', ',', ';', 'asm' or '__attribute__' before '{' token ../../gtk28_test/src/geanywraplabel.c:151: error: old-style parameter declarations in prototyped function definition ../../gtk28_test/src/geanywraplabel.c:151: error: expected '{' at end of input Build failed -> task failed (err #1): {task: cc geanywraplabel.c -> geanywraplabel_3.o} http://geany.nightlybuilds.org/

1 0

SF.net SVN: geany:[5281] trunk
by ntrel＠users.sourceforge.net 05 Oct '10

05 Oct '10

Revision: 5281 http://geany.svn.sourceforge.net/geany/?rev=5281&view=rev Author: ntrel Date: 2010-10-05 14:44:00 +0000 (Tue, 05 Oct 2010) Log Message: ----------- Parse property, constructor, destructor as functions (patch by pottersson, thanks - #2992167). Modified Paths: -------------- trunk/ChangeLog trunk/tagmanager/basic.c Modified: trunk/ChangeLog =================================================================== --- trunk/ChangeLog 2010-10-05 11:07:10 UTC (rev 5280) +++ trunk/ChangeLog 2010-10-05 14:44:00 UTC (rev 5281) @@ -4,6 +4,9 @@ Don't cache overridden lexer properties. Add foreach_strv() to plugin API. Add utils_strv_join(). + * tagmanager/basic.c: + Parse property, constructor, destructor as functions (patch by + pottersson, thanks - #2992167). 2010-10-01 Nick Treleaven <nick(dot)treleaven(at)btinternet(dot)com> Modified: trunk/tagmanager/basic.c =================================================================== --- trunk/tagmanager/basic.c 2010-10-05 11:07:10 UTC (rev 5280) +++ trunk/tagmanager/basic.c 2010-10-05 14:44:00 UTC (rev 5281) @@ -55,6 +55,9 @@ {"const", K_CONST}, /* must always be the third */ {"function", K_FUNCTION}, {"sub", K_FUNCTION}, + {"property", K_FUNCTION}, + {"constructor", K_FUNCTION}, + {"destructor", K_FUNCTION}, {"private sub", K_FUNCTION}, {"public sub", K_FUNCTION}, {"private function", K_FUNCTION}, This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

1 0

SF.net SVN: geany:[5280] trunk
by ntrel＠users.sourceforge.net 05 Oct '10

05 Oct '10

Revision: 5280 http://geany.svn.sourceforge.net/geany/?rev=5280&view=rev Author: ntrel Date: 2010-10-05 11:07:10 +0000 (Tue, 05 Oct 2010) Log Message: ----------- Don't cache overridden lexer properties. Add foreach_strv() to plugin API. Add utils_strv_join(). Modified Paths: -------------- trunk/ChangeLog trunk/src/editor.c trunk/src/highlighting.c trunk/src/utils.c trunk/src/utils.h Modified: trunk/ChangeLog =================================================================== --- trunk/ChangeLog 2010-10-04 14:33:21 UTC (rev 5279) +++ trunk/ChangeLog 2010-10-05 11:07:10 UTC (rev 5280) @@ -1,3 +1,11 @@ +2010-10-05 Nick Treleaven <nick(dot)treleaven(at)btinternet(dot)com> + + * src/utils.c, src/utils.h, src/highlighting.c, src/editor.c: + Don't cache overridden lexer properties. + Add foreach_strv() to plugin API. + Add utils_strv_join(). + + 2010-10-01 Nick Treleaven <nick(dot)treleaven(at)btinternet(dot)com> * src/tools.c, doc/geany.txt, doc/geany.html: Modified: trunk/src/editor.c =================================================================== --- trunk/src/editor.c 2010-10-04 14:33:21 UTC (rev 5279) +++ trunk/src/editor.c 2010-10-05 11:07:10 UTC (rev 5280) @@ -262,7 +262,7 @@ gchar **keys = g_key_file_get_keys(userconfig, kb_group, NULL, NULL); gchar **ptr; - /* remove overridden keys in sys file */ + /* remove overridden keys from system keyfile */ foreach_strv(ptr, keys) g_key_file_remove_key(sysconfig, kb_group, *ptr, NULL); Modified: trunk/src/highlighting.c =================================================================== --- trunk/src/highlighting.c 2010-10-04 14:33:21 UTC (rev 5279) +++ trunk/src/highlighting.c 2010-10-05 11:07:10 UTC (rev 5280) @@ -3191,26 +3191,17 @@ static void read_properties(GeanyFiletype *ft, GKeyFile *config, GKeyFile *configh) { gchar group[] = "lexer_properties"; - gchar **keys = g_key_file_get_keys(config, group, NULL, NULL); + gchar **keys; gchar **keysh = g_key_file_get_keys(configh, group, NULL, NULL); + gchar **ptr; - /* move/merge keysh into keys */ - if (!keys) - keys = keysh; - else if (keysh) - { - gchar **strv = g_new0(gchar*, g_strv_length(keys) + g_strv_length(keysh) + 1); - gchar **read, **write = strv; + /* remove overridden keys from system keyfile */ + foreach_strv(ptr, keysh) + g_key_file_remove_key(config, group, *ptr, NULL); - /* may have same key in each, but home will override so it's OK */ - foreach_strv(read, keys) - *write++ = *read; - foreach_strv(read, keysh) - *write++ = *read; - g_free(keys); - g_free(keysh); - keys = strv; - } + /* merge sys and user keys */ + keys = g_key_file_get_keys(config, group, NULL, NULL); + keys = utils_strv_join(keys, keysh); if (keys) { Modified: trunk/src/utils.c =================================================================== --- trunk/src/utils.c 2010-10-04 14:33:21 UTC (rev 5279) +++ trunk/src/utils.c 2010-10-05 11:07:10 UTC (rev 5280) @@ -2036,3 +2036,29 @@ } +/* Joins @a first and @a second into a new string vector, freeing the originals. + * The original contents are reused. */ +gchar **utils_strv_join(gchar **first, gchar **second) +{ + gchar **strv; + gchar **rptr, **wptr; + + if (!first) + return second; + if (!second) + return first; + + strv = g_new0(gchar*, g_strv_length(first) + g_strv_length(second) + 1); + wptr = strv; + + foreach_strv(rptr, first) + *wptr++ = *rptr; + foreach_strv(rptr, second) + *wptr++ = *rptr; + + g_free(first); + g_free(second); + return strv; +} + + Modified: trunk/src/utils.h =================================================================== --- trunk/src/utils.h 2010-10-04 14:33:21 UTC (rev 5279) +++ trunk/src/utils.h 2010-10-05 11:07:10 UTC (rev 5280) @@ -115,8 +115,12 @@ #define foreach_str(char_ptr, string) \ for (char_ptr = string; *char_ptr; char_ptr++) -/* Iterate NULL-terminated string vector */ -#define foreach_strv foreach_str +/** Iterates a null-terminated string vector. + * @param str_ptr @c gchar** pointer to string element. + * @param strv Can be @c NULL. + * @since Geany 0.20 */ +#define foreach_strv(str_ptr, strv)\ + if (!(strv)) {} else foreach_str(str_ptr, strv) /** Iterates from 0 to @a size. * @param i Integer. @@ -214,6 +218,8 @@ gchar **utils_strv_new(const gchar *first, ...) G_GNUC_NULL_TERMINATED; +gchar **utils_strv_join(gchar **first, gchar **second) G_GNUC_WARN_UNUSED_RESULT; + gint utils_mkdir(const gchar *path, gboolean create_parent_dirs); GSList *utils_get_file_list(const gchar *path, guint *length, GError **error); This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

1 0

SF.net SVN: geany:[5279] trunk/src/editor.c
by ntrel＠users.sourceforge.net 04 Oct '10

04 Oct '10

Revision: 5279 http://geany.svn.sourceforge.net/geany/?rev=5279&view=rev Author: ntrel Date: 2010-10-04 14:33:21 +0000 (Mon, 04 Oct 2010) Log Message: ----------- Avoid global variable. Modified Paths: -------------- trunk/src/editor.c Modified: trunk/src/editor.c =================================================================== --- trunk/src/editor.c 2010-10-04 14:29:44 UTC (rev 5278) +++ trunk/src/editor.c 2010-10-04 14:33:21 UTC (rev 5279) @@ -229,9 +229,7 @@ } -static const gchar kb_group[] = "Keybindings"; - -static void add_kb(GKeyFile *keyfile, gchar **keys) +static void add_kb(GKeyFile *keyfile, const gchar *group, gchar **keys) { gsize i; @@ -241,7 +239,7 @@ { guint key; GdkModifierType mods; - gchar *accel_string = g_key_file_get_value(keyfile, kb_group, keys[i], NULL); + gchar *accel_string = g_key_file_get_value(keyfile, group, keys[i], NULL); gtk_accelerator_parse(accel_string, &key, &mods); g_free(accel_string); @@ -260,6 +258,7 @@ static void load_kb(GKeyFile *sysconfig, GKeyFile *userconfig) { + const gchar kb_group[] = "Keybindings"; gchar **keys = g_key_file_get_keys(userconfig, kb_group, NULL, NULL); gchar **ptr; @@ -267,11 +266,11 @@ foreach_strv(ptr, keys) g_key_file_remove_key(sysconfig, kb_group, *ptr, NULL); - add_kb(userconfig, keys); + add_kb(userconfig, kb_group, keys); g_strfreev(keys); keys = g_key_file_get_keys(sysconfig, kb_group, NULL, NULL); - add_kb(sysconfig, keys); + add_kb(sysconfig, kb_group, keys); g_strfreev(keys); } This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

1 0

SF.net SVN: geany:[5278] trunk
by ntrel＠users.sourceforge.net 04 Oct '10

04 Oct '10

Revision: 5278 http://geany.svn.sourceforge.net/geany/?rev=5278&view=rev Author: ntrel Date: 2010-10-04 14:29:44 +0000 (Mon, 04 Oct 2010) Log Message: ----------- Read snippet keybindings from system keyfile also. Add keybinding example to default snippet.conf. Modified Paths: -------------- trunk/ChangeLog trunk/data/snippets.conf trunk/src/editor.c Modified: trunk/ChangeLog =================================================================== --- trunk/ChangeLog 2010-10-04 14:20:40 UTC (rev 5277) +++ trunk/ChangeLog 2010-10-04 14:29:44 UTC (rev 5278) @@ -12,6 +12,9 @@ Add snippet keybindings docs. * src/highlighting.c, src/utils.h: Move foreach_strv to utils.h. + * src/editor.c, data/snippets.conf: + Read snippet keybindings from system keyfile also. + Add keybinding example to default snippet.conf. 2010-09-30 Nick Treleaven <nick(dot)treleaven(at)btinternet(dot)com> Modified: trunk/data/snippets.conf =================================================================== --- trunk/data/snippets.conf 2010-10-04 14:20:40 UTC (rev 5277) +++ trunk/data/snippets.conf 2010-10-04 14:29:44 UTC (rev 5278) @@ -39,6 +39,11 @@ block_cursor=\n{\n\t%cursor%\n}\n%cursor% #wordchars=_abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789 +# Optional keybindings to insert snippets +# Note: these can be overridden by Geany's configurable keybindings +[Keybindings] +#for=<Ctrl>7 + [C++] for=for (int i = 0; i < %cursor%; i++)%brace_open%\n%brace_close% Modified: trunk/src/editor.c =================================================================== --- trunk/src/editor.c 2010-10-04 14:20:40 UTC (rev 5277) +++ trunk/src/editor.c 2010-10-04 14:29:44 UTC (rev 5278) @@ -229,19 +229,19 @@ } -static void load_kb(GKeyFile *userconfig) +static const gchar kb_group[] = "Keybindings"; + +static void add_kb(GKeyFile *keyfile, gchar **keys) { - gchar group[] = "Keybindings"; - gsize len, j; - gchar **keys = g_key_file_get_keys(userconfig, group, &len, NULL); + gsize i; if (!keys) return; - for (j = 0; j < len; j++) + for (i = 0; i < g_strv_length(keys); i++) { guint key; GdkModifierType mods; - gchar *accel_string = g_key_file_get_value(userconfig, group, keys[j], NULL); + gchar *accel_string = g_key_file_get_value(keyfile, kb_group, keys[i], NULL); gtk_accelerator_parse(accel_string, &key, &mods); g_free(accel_string); @@ -253,9 +253,26 @@ } gtk_accel_group_connect(snippet_accel_group, key, mods, 0, g_cclosure_new_swap((GCallback)on_snippet_keybinding_activate, - g_strdup(keys[j]), (GClosureNotify)g_free)); + g_strdup(keys[i]), (GClosureNotify)g_free)); } +} + + +static void load_kb(GKeyFile *sysconfig, GKeyFile *userconfig) +{ + gchar **keys = g_key_file_get_keys(userconfig, kb_group, NULL, NULL); + gchar **ptr; + + /* remove overridden keys in sys file */ + foreach_strv(ptr, keys) + g_key_file_remove_key(sysconfig, kb_group, *ptr, NULL); + + add_kb(userconfig, keys); g_strfreev(keys); + + keys = g_key_file_get_keys(sysconfig, kb_group, NULL, NULL); + add_kb(sysconfig, keys); + g_strfreev(keys); } @@ -284,7 +301,7 @@ /* setup snippet keybindings */ snippet_accel_group = gtk_accel_group_new(); gtk_window_add_accel_group(GTK_WINDOW(main_widgets.window), snippet_accel_group); - load_kb(userconfig); + load_kb(sysconfig, userconfig); g_free(sysconfigfile); g_free(userconfigfile); This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

1 0

SF.net SVN: geany:[5277] trunk
by ntrel＠users.sourceforge.net 04 Oct '10

04 Oct '10

Revision: 5277 http://geany.svn.sourceforge.net/geany/?rev=5277&view=rev Author: ntrel Date: 2010-10-04 14:20:40 +0000 (Mon, 04 Oct 2010) Log Message: ----------- Move foreach_strv to utils.h. Modified Paths: -------------- trunk/ChangeLog trunk/src/highlighting.c trunk/src/utils.h Modified: trunk/ChangeLog =================================================================== --- trunk/ChangeLog 2010-10-04 11:05:59 UTC (rev 5276) +++ trunk/ChangeLog 2010-10-04 14:20:40 UTC (rev 5277) @@ -10,6 +10,8 @@ Add some subheadings for Snippets section. * doc/geany.txt, doc/geany.html: Add snippet keybindings docs. + * src/highlighting.c, src/utils.h: + Move foreach_strv to utils.h. 2010-09-30 Nick Treleaven <nick(dot)treleaven(at)btinternet(dot)com> Modified: trunk/src/highlighting.c =================================================================== --- trunk/src/highlighting.c 2010-10-04 11:05:59 UTC (rev 5276) +++ trunk/src/highlighting.c 2010-10-04 14:20:40 UTC (rev 5277) @@ -3188,9 +3188,6 @@ } -#define foreach_strv(strptr, strv) \ - for (strptr = strv; *strptr; strptr++) - static void read_properties(GeanyFiletype *ft, GKeyFile *config, GKeyFile *configh) { gchar group[] = "lexer_properties"; Modified: trunk/src/utils.h =================================================================== --- trunk/src/utils.h 2010-10-04 11:05:59 UTC (rev 5276) +++ trunk/src/utils.h 2010-10-04 14:20:40 UTC (rev 5277) @@ -115,6 +115,9 @@ #define foreach_str(char_ptr, string) \ for (char_ptr = string; *char_ptr; char_ptr++) +/* Iterate NULL-terminated string vector */ +#define foreach_strv foreach_str + /** Iterates from 0 to @a size. * @param i Integer. * @param size Number of iterations. This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

1 0

SF.net SVN: geany:[5276] trunk
by ntrel＠users.sourceforge.net 04 Oct '10

04 Oct '10

Revision: 5276 http://geany.svn.sourceforge.net/geany/?rev=5276&view=rev Author: ntrel Date: 2010-10-04 11:05:59 +0000 (Mon, 04 Oct 2010) Log Message: ----------- Add snippet keybindings docs. Modified Paths: -------------- trunk/ChangeLog trunk/doc/geany.html trunk/doc/geany.txt Modified: trunk/ChangeLog =================================================================== --- trunk/ChangeLog 2010-10-04 10:51:03 UTC (rev 5275) +++ trunk/ChangeLog 2010-10-04 11:05:59 UTC (rev 5276) @@ -8,6 +8,8 @@ on patch by Eugene Arshinov, thanks). No docs yet. * doc/geany.txt, doc/geany.html: Add some subheadings for Snippets section. + * doc/geany.txt, doc/geany.html: + Add snippet keybindings docs. 2010-09-30 Nick Treleaven <nick(dot)treleaven(at)btinternet(dot)com> Modified: trunk/doc/geany.html =================================================================== --- trunk/doc/geany.html 2010-10-04 10:51:03 UTC (rev 5275) +++ trunk/doc/geany.html 2010-10-04 11:05:59 UTC (rev 5276) @@ -217,267 +217,270 @@ <li><a class="reference" href="#scope-autocompletion" id="id53" name="id53">Scope autocompletion</a></li> </ul> </li> -<li><a class="reference" href="#user-definable-snippets" id="id54" name="id54">User-definable snippets</a></li> -<li><a class="reference" href="#inserting-unicode-characters" id="id55" name="id55">Inserting Unicode characters</a></li> +<li><a class="reference" href="#user-definable-snippets" id="id54" name="id54">User-definable snippets</a><ul> +<li><a class="reference" href="#snippet-keybindings" id="id55" name="id55">Snippet keybindings</a></li> </ul> </li> -<li><a class="reference" href="#search-replace-and-go-to" id="id56" name="id56">Search, replace and go to</a><ul> -<li><a class="reference" href="#toolbar-entries" id="id57" name="id57">Toolbar entries</a><ul> -<li><a class="reference" href="#search-bar" id="id58" name="id58">Search bar</a></li> +<li><a class="reference" href="#inserting-unicode-characters" id="id56" name="id56">Inserting Unicode characters</a></li> </ul> </li> -<li><a class="reference" href="#find" id="id59" name="id59">Find</a><ul> -<li><a class="reference" href="#matching-options" id="id60" name="id60">Matching options</a></li> -<li><a class="reference" href="#find-all" id="id61" name="id61">Find all</a></li> -<li><a class="reference" href="#change-font-in-search-dialog-text-fields" id="id62" name="id62">Change font in search dialog text fields</a></li> +<li><a class="reference" href="#search-replace-and-go-to" id="id57" name="id57">Search, replace and go to</a><ul> +<li><a class="reference" href="#toolbar-entries" id="id58" name="id58">Toolbar entries</a><ul> +<li><a class="reference" href="#search-bar" id="id59" name="id59">Search bar</a></li> </ul> </li> -<li><a class="reference" href="#find-selection" id="id63" name="id63">Find selection</a></li> -<li><a class="reference" href="#find-usage" id="id64" name="id64">Find usage</a></li> -<li><a class="reference" href="#find-in-files" id="id65" name="id65">Find in files</a><ul> -<li><a class="reference" href="#filtering-out-version-control-files" id="id66" name="id66">Filtering out version control files</a></li> +<li><a class="reference" href="#find" id="id60" name="id60">Find</a><ul> +<li><a class="reference" href="#matching-options" id="id61" name="id61">Matching options</a></li> +<li><a class="reference" href="#find-all" id="id62" name="id62">Find all</a></li> +<li><a class="reference" href="#change-font-in-search-dialog-text-fields" id="id63" name="id63">Change font in search dialog text fields</a></li> </ul> </li> -<li><a class="reference" href="#replace" id="id67" name="id67">Replace</a><ul> -<li><a class="reference" href="#replace-all" id="id68" name="id68">Replace all</a></li> +<li><a class="reference" href="#find-selection" id="id64" name="id64">Find selection</a></li> +<li><a class="reference" href="#find-usage" id="id65" name="id65">Find usage</a></li> +<li><a class="reference" href="#find-in-files" id="id66" name="id66">Find in files</a><ul> +<li><a class="reference" href="#filtering-out-version-control-files" id="id67" name="id67">Filtering out version control files</a></li> </ul> </li> -<li><a class="reference" href="#go-to-tag-definition" id="id69" name="id69">Go to tag definition</a></li> -<li><a class="reference" href="#go-to-tag-declaration" id="id70" name="id70">Go to tag declaration</a></li> -<li><a class="reference" href="#go-to-line" id="id71" name="id71">Go to line</a></li> -<li><a class="reference" href="#regular-expressions" id="id72" name="id72">Regular expressions</a></li> +<li><a class="reference" href="#replace" id="id68" name="id68">Replace</a><ul> +<li><a class="reference" href="#replace-all" id="id69" name="id69">Replace all</a></li> </ul> </li> -<li><a class="reference" href="#tags" id="id73" name="id73">Tags</a><ul> -<li><a class="reference" href="#workspace-tags" id="id74" name="id74">Workspace tags</a></li> -<li><a class="reference" href="#global-tags" id="id75" name="id75">Global tags</a><ul> -<li><a class="reference" href="#default-global-tags-files" id="id76" name="id76">Default global tags files</a></li> -<li><a class="reference" href="#global-tags-file-format" id="id77" name="id77">Global tags file format</a></li> -<li><a class="reference" href="#generating-a-global-tags-file" id="id78" name="id78">Generating a global tags file</a></li> +<li><a class="reference" href="#go-to-tag-definition" id="id70" name="id70">Go to tag definition</a></li> +<li><a class="reference" href="#go-to-tag-declaration" id="id71" name="id71">Go to tag declaration</a></li> +<li><a class="reference" href="#go-to-line" id="id72" name="id72">Go to line</a></li> +<li><a class="reference" href="#regular-expressions" id="id73" name="id73">Regular expressions</a></li> </ul> </li> -<li><a class="reference" href="#ignore-tags" id="id79" name="id79">Ignore tags</a></li> +<li><a class="reference" href="#tags" id="id74" name="id74">Tags</a><ul> +<li><a class="reference" href="#workspace-tags" id="id75" name="id75">Workspace tags</a></li> +<li><a class="reference" href="#global-tags" id="id76" name="id76">Global tags</a><ul> +<li><a class="reference" href="#default-global-tags-files" id="id77" name="id77">Default global tags files</a></li> +<li><a class="reference" href="#global-tags-file-format" id="id78" name="id78">Global tags file format</a></li> +<li><a class="reference" href="#generating-a-global-tags-file" id="id79" name="id79">Generating a global tags file</a></li> </ul> </li> -<li><a class="reference" href="#preferences" id="id80" name="id80">Preferences</a><ul> -<li><a class="reference" href="#general-startup-preferences" id="id81" name="id81">General Startup preferences</a><ul> -<li><a class="reference" href="#id1" id="id82" name="id82">Startup</a></li> -<li><a class="reference" href="#shutdown" id="id83" name="id83">Shutdown</a></li> -<li><a class="reference" href="#paths" id="id84" name="id84">Paths</a></li> +<li><a class="reference" href="#ignore-tags" id="id80" name="id80">Ignore tags</a></li> </ul> </li> -<li><a class="reference" href="#general-miscellaneous-preferences" id="id85" name="id85">General Miscellaneous preferences</a><ul> -<li><a class="reference" href="#miscellaneous" id="id86" name="id86">Miscellaneous</a></li> -<li><a class="reference" href="#search" id="id87" name="id87">Search</a></li> -<li><a class="reference" href="#projects" id="id88" name="id88">Projects</a></li> +<li><a class="reference" href="#preferences" id="id81" name="id81">Preferences</a><ul> +<li><a class="reference" href="#general-startup-preferences" id="id82" name="id82">General Startup preferences</a><ul> +<li><a class="reference" href="#id1" id="id83" name="id83">Startup</a></li> +<li><a class="reference" href="#shutdown" id="id84" name="id84">Shutdown</a></li> +<li><a class="reference" href="#paths" id="id85" name="id85">Paths</a></li> </ul> </li> -<li><a class="reference" href="#interface-preferences" id="id89" name="id89">Interface preferences</a><ul> -<li><a class="reference" href="#sidebar" id="id90" name="id90">Sidebar</a></li> -<li><a class="reference" href="#fonts" id="id91" name="id91">Fonts</a></li> -<li><a class="reference" href="#editor-tabs" id="id92" name="id92">Editor tabs</a></li> -<li><a class="reference" href="#tab-positions" id="id93" name="id93">Tab positions</a></li> -<li><a class="reference" href="#id2" id="id94" name="id94">Miscellaneous</a></li> +<li><a class="reference" href="#general-miscellaneous-preferences" id="id86" name="id86">General Miscellaneous preferences</a><ul> +<li><a class="reference" href="#miscellaneous" id="id87" name="id87">Miscellaneous</a></li> +<li><a class="reference" href="#search" id="id88" name="id88">Search</a></li> +<li><a class="reference" href="#projects" id="id89" name="id89">Projects</a></li> </ul> </li> -<li><a class="reference" href="#toolbar-preferences" id="id95" name="id95">Toolbar preferences</a><ul> -<li><a class="reference" href="#toolbar" id="id96" name="id96">Toolbar</a></li> -<li><a class="reference" href="#appearance" id="id97" name="id97">Appearance</a></li> +<li><a class="reference" href="#interface-preferences" id="id90" name="id90">Interface preferences</a><ul> +<li><a class="reference" href="#sidebar" id="id91" name="id91">Sidebar</a></li> +<li><a class="reference" href="#fonts" id="id92" name="id92">Fonts</a></li> +<li><a class="reference" href="#editor-tabs" id="id93" name="id93">Editor tabs</a></li> +<li><a class="reference" href="#tab-positions" id="id94" name="id94">Tab positions</a></li> +<li><a class="reference" href="#id2" id="id95" name="id95">Miscellaneous</a></li> </ul> </li> -<li><a class="reference" href="#editor-features-preferences" id="id98" name="id98">Editor Features preferences</a><ul> -<li><a class="reference" href="#features" id="id99" name="id99">Features</a></li> +<li><a class="reference" href="#toolbar-preferences" id="id96" name="id96">Toolbar preferences</a><ul> +<li><a class="reference" href="#toolbar" id="id97" name="id97">Toolbar</a></li> +<li><a class="reference" href="#appearance" id="id98" name="id98">Appearance</a></li> </ul> </li> -<li><a class="reference" href="#editor-indentation-preferences" id="id100" name="id100">Editor Indentation preferences</a><ul> -<li><a class="reference" href="#indentation-group" id="id101" name="id101">Indentation group</a></li> +<li><a class="reference" href="#editor-features-preferences" id="id99" name="id99">Editor Features preferences</a><ul> +<li><a class="reference" href="#features" id="id100" name="id100">Features</a></li> </ul> </li> -<li><a class="reference" href="#editor-completions-preferences" id="id102" name="id102">Editor Completions preferences</a><ul> -<li><a class="reference" href="#completions" id="id103" name="id103">Completions</a></li> -<li><a class="reference" href="#auto-close-quotes-and-brackets" id="id104" name="id104">Auto-close quotes and brackets</a></li> +<li><a class="reference" href="#editor-indentation-preferences" id="id101" name="id101">Editor Indentation preferences</a><ul> +<li><a class="reference" href="#indentation-group" id="id102" name="id102">Indentation group</a></li> </ul> </li> -<li><a class="reference" href="#editor-display-preferences" id="id105" name="id105">Editor Display preferences</a><ul> -<li><a class="reference" href="#display" id="id106" name="id106">Display</a></li> -<li><a class="reference" href="#long-line-marker" id="id107" name="id107">Long line marker</a></li> -<li><a class="reference" href="#virtual-spaces" id="id108" name="id108">Virtual spaces</a></li> +<li><a class="reference" href="#editor-completions-preferences" id="id103" name="id103">Editor Completions preferences</a><ul> +<li><a class="reference" href="#completions" id="id104" name="id104">Completions</a></li> +<li><a class="reference" href="#auto-close-quotes-and-brackets" id="id105" name="id105">Auto-close quotes and brackets</a></li> </ul> </li> -<li><a class="reference" href="#files-preferences" id="id109" name="id109">Files preferences</a><ul> -<li><a class="reference" href="#new-files" id="id110" name="id110">New files</a></li> -<li><a class="reference" href="#saving-files" id="id111" name="id111">Saving files</a></li> -<li><a class="reference" href="#id3" id="id112" name="id112">Miscellaneous</a></li> +<li><a class="reference" href="#editor-display-preferences" id="id106" name="id106">Editor Display preferences</a><ul> +<li><a class="reference" href="#display" id="id107" name="id107">Display</a></li> +<li><a class="reference" href="#long-line-marker" id="id108" name="id108">Long line marker</a></li> +<li><a class="reference" href="#virtual-spaces" id="id109" name="id109">Virtual spaces</a></li> </ul> </li> -<li><a class="reference" href="#tools-preferences" id="id113" name="id113">Tools preferences</a><ul> -<li><a class="reference" href="#tool-paths" id="id114" name="id114">Tool paths</a></li> -<li><a class="reference" href="#commands" id="id115" name="id115">Commands</a></li> +<li><a class="reference" href="#files-preferences" id="id110" name="id110">Files preferences</a><ul> +<li><a class="reference" href="#new-files" id="id111" name="id111">New files</a></li> +<li><a class="reference" href="#saving-files" id="id112" name="id112">Saving files</a></li> +<li><a class="reference" href="#id3" id="id113" name="id113">Miscellaneous</a></li> </ul> </li> -<li><a class="reference" href="#template-preferences" id="id116" name="id116">Template preferences</a><ul> -<li><a class="reference" href="#template-data" id="id117" name="id117">Template data</a></li> +<li><a class="reference" href="#tools-preferences" id="id114" name="id114">Tools preferences</a><ul> +<li><a class="reference" href="#tool-paths" id="id115" name="id115">Tool paths</a></li> +<li><a class="reference" href="#commands" id="id116" name="id116">Commands</a></li> </ul> </li> -<li><a class="reference" href="#keybinding-preferences" id="id118" name="id118">Keybinding preferences</a></li> -<li><a class="reference" href="#printing-preferences" id="id119" name="id119">Printing preferences</a></li> -<li><a class="reference" href="#terminal-vte-preferences" id="id120" name="id120">Terminal (VTE) preferences</a><ul> -<li><a class="reference" href="#terminal-widget" id="id121" name="id121">Terminal widget</a></li> +<li><a class="reference" href="#template-preferences" id="id117" name="id117">Template preferences</a><ul> +<li><a class="reference" href="#template-data" id="id118" name="id118">Template data</a></li> </ul> </li> +<li><a class="reference" href="#keybinding-preferences" id="id119" name="id119">Keybinding preferences</a></li> +<li><a class="reference" href="#printing-preferences" id="id120" name="id120">Printing preferences</a></li> +<li><a class="reference" href="#terminal-vte-preferences" id="id121" name="id121">Terminal (VTE) preferences</a><ul> +<li><a class="reference" href="#terminal-widget" id="id122" name="id122">Terminal widget</a></li> </ul> </li> -<li><a class="reference" href="#project-management" id="id122" name="id122">Project Management</a><ul> -<li><a class="reference" href="#new-project" id="id123" name="id123">New Project</a></li> -<li><a class="reference" href="#project-properties" id="id124" name="id124">Project Properties</a></li> -<li><a class="reference" href="#open-project" id="id125" name="id125">Open Project</a></li> -<li><a class="reference" href="#close-project" id="id126" name="id126">Close Project</a></li> </ul> </li> -<li><a class="reference" href="#build-menu" id="id127" name="id127">Build Menu</a><ul> -<li><a class="reference" href="#indicators" id="id128" name="id128">Indicators</a></li> -<li><a class="reference" href="#default-build-menu-items" id="id129" name="id129">Default Build Menu Items</a><ul> -<li><a class="reference" href="#compile" id="id130" name="id130">Compile</a></li> -<li><a class="reference" href="#build" id="id131" name="id131">Build</a></li> -<li><a class="reference" href="#make" id="id132" name="id132">Make</a></li> -<li><a class="reference" href="#make-custom-target" id="id133" name="id133">Make custom target</a></li> -<li><a class="reference" href="#make-object" id="id134" name="id134">Make object</a></li> -<li><a class="reference" href="#next-error" id="id135" name="id135">Next Error</a></li> -<li><a class="reference" href="#previous-error" id="id136" name="id136">Previous Error</a></li> -<li><a class="reference" href="#execute" id="id137" name="id137">Execute</a></li> -<li><a class="reference" href="#stopping-running-processes" id="id138" name="id138">Stopping running processes</a><ul> -<li><a class="reference" href="#terminal-emulators" id="id139" name="id139">Terminal emulators</a></li> +<li><a class="reference" href="#project-management" id="id123" name="id123">Project Management</a><ul> +<li><a class="reference" href="#new-project" id="id124" name="id124">New Project</a></li> +<li><a class="reference" href="#project-properties" id="id125" name="id125">Project Properties</a></li> +<li><a class="reference" href="#open-project" id="id126" name="id126">Open Project</a></li> +<li><a class="reference" href="#close-project" id="id127" name="id127">Close Project</a></li> </ul> </li> -<li><a class="reference" href="#set-build-commands" id="id140" name="id140">Set Build Commands</a></li> +<li><a class="reference" href="#build-menu" id="id128" name="id128">Build Menu</a><ul> +<li><a class="reference" href="#indicators" id="id129" name="id129">Indicators</a></li> +<li><a class="reference" href="#default-build-menu-items" id="id130" name="id130">Default Build Menu Items</a><ul> +<li><a class="reference" href="#compile" id="id131" name="id131">Compile</a></li> +<li><a class="reference" href="#build" id="id132" name="id132">Build</a></li> +<li><a class="reference" href="#make" id="id133" name="id133">Make</a></li> +<li><a class="reference" href="#make-custom-target" id="id134" name="id134">Make custom target</a></li> +<li><a class="reference" href="#make-object" id="id135" name="id135">Make object</a></li> +<li><a class="reference" href="#next-error" id="id136" name="id136">Next Error</a></li> +<li><a class="reference" href="#previous-error" id="id137" name="id137">Previous Error</a></li> +<li><a class="reference" href="#execute" id="id138" name="id138">Execute</a></li> +<li><a class="reference" href="#stopping-running-processes" id="id139" name="id139">Stopping running processes</a><ul> +<li><a class="reference" href="#terminal-emulators" id="id140" name="id140">Terminal emulators</a></li> </ul> </li> -<li><a class="reference" href="#build-menu-configuration" id="id141" name="id141">Build Menu Configuration</a></li> -<li><a class="reference" href="#build-menu-commands-dialog" id="id142" name="id142">Build Menu Commands Dialog</a><ul> -<li><a class="reference" href="#substitutions-in-commands-and-working-directories" id="id143" name="id143">Substitutions in Commands and Working Directories</a></li> -<li><a class="reference" href="#build-menu-keyboard-shortcuts" id="id144" name="id144">Build Menu Keyboard Shortcuts</a></li> -<li><a class="reference" href="#configuration-files" id="id145" name="id145">Configuration Files</a></li> +<li><a class="reference" href="#set-build-commands" id="id141" name="id141">Set Build Commands</a></li> </ul> </li> +<li><a class="reference" href="#build-menu-configuration" id="id142" name="id142">Build Menu Configuration</a></li> +<li><a class="reference" href="#build-menu-commands-dialog" id="id143" name="id143">Build Menu Commands Dialog</a><ul> +<li><a class="reference" href="#substitutions-in-commands-and-working-directories" id="id144" name="id144">Substitutions in Commands and Working Directories</a></li> +<li><a class="reference" href="#build-menu-keyboard-shortcuts" id="id145" name="id145">Build Menu Keyboard Shortcuts</a></li> +<li><a class="reference" href="#configuration-files" id="id146" name="id146">Configuration Files</a></li> </ul> </li> -<li><a class="reference" href="#printing-support" id="id146" name="id146">Printing support</a></li> -<li><a class="reference" href="#plugins" id="id147" name="id147">Plugins</a></li> -<li><a class="reference" href="#keybindings" id="id148" name="id148">Keybindings</a><ul> -<li><a class="reference" href="#switching-documents" id="id149" name="id149">Switching documents</a></li> -<li><a class="reference" href="#configurable-keybindings" id="id150" name="id150">Configurable keybindings</a><ul> -<li><a class="reference" href="#file-keybindings" id="id151" name="id151">File keybindings</a></li> -<li><a class="reference" href="#editor-keybindings" id="id152" name="id152">Editor keybindings</a></li> -<li><a class="reference" href="#clipboard-keybindings" id="id153" name="id153">Clipboard keybindings</a></li> -<li><a class="reference" href="#select-keybindings" id="id154" name="id154">Select keybindings</a></li> -<li><a class="reference" href="#insert-keybindings" id="id155" name="id155">Insert keybindings</a></li> -<li><a class="reference" href="#format-keybindings" id="id156" name="id156">Format keybindings</a></li> -<li><a class="reference" href="#settings-keybindings" id="id157" name="id157">Settings keybindings</a></li> -<li><a class="reference" href="#search-keybindings" id="id158" name="id158">Search keybindings</a></li> -<li><a class="reference" href="#go-to-keybindings" id="id159" name="id159">Go to keybindings</a></li> -<li><a class="reference" href="#view-keybindings" id="id160" name="id160">View keybindings</a></li> -<li><a class="reference" href="#focus-keybindings" id="id161" name="id161">Focus keybindings</a></li> -<li><a class="reference" href="#notebook-tab-keybindings" id="id162" name="id162">Notebook tab keybindings</a></li> -<li><a class="reference" href="#document-keybindings" id="id163" name="id163">Document keybindings</a></li> -<li><a class="reference" href="#build-keybindings" id="id164" name="id164">Build keybindings</a></li> -<li><a class="reference" href="#tools-keybindings" id="id165" name="id165">Tools keybindings</a></li> -<li><a class="reference" href="#help-keybindings" id="id166" name="id166">Help keybindings</a></li> </ul> </li> +<li><a class="reference" href="#printing-support" id="id147" name="id147">Printing support</a></li> +<li><a class="reference" href="#plugins" id="id148" name="id148">Plugins</a></li> +<li><a class="reference" href="#keybindings" id="id149" name="id149">Keybindings</a><ul> +<li><a class="reference" href="#switching-documents" id="id150" name="id150">Switching documents</a></li> +<li><a class="reference" href="#configurable-keybindings" id="id151" name="id151">Configurable keybindings</a><ul> +<li><a class="reference" href="#file-keybindings" id="id152" name="id152">File keybindings</a></li> +<li><a class="reference" href="#editor-keybindings" id="id153" name="id153">Editor keybindings</a></li> +<li><a class="reference" href="#clipboard-keybindings" id="id154" name="id154">Clipboard keybindings</a></li> +<li><a class="reference" href="#select-keybindings" id="id155" name="id155">Select keybindings</a></li> +<li><a class="reference" href="#insert-keybindings" id="id156" name="id156">Insert keybindings</a></li> +<li><a class="reference" href="#format-keybindings" id="id157" name="id157">Format keybindings</a></li> +<li><a class="reference" href="#settings-keybindings" id="id158" name="id158">Settings keybindings</a></li> +<li><a class="reference" href="#search-keybindings" id="id159" name="id159">Search keybindings</a></li> +<li><a class="reference" href="#go-to-keybindings" id="id160" name="id160">Go to keybindings</a></li> +<li><a class="reference" href="#view-keybindings" id="id161" name="id161">View keybindings</a></li> +<li><a class="reference" href="#focus-keybindings" id="id162" name="id162">Focus keybindings</a></li> +<li><a class="reference" href="#notebook-tab-keybindings" id="id163" name="id163">Notebook tab keybindings</a></li> +<li><a class="reference" href="#document-keybindings" id="id164" name="id164">Document keybindings</a></li> +<li><a class="reference" href="#build-keybindings" id="id165" name="id165">Build keybindings</a></li> +<li><a class="reference" href="#tools-keybindings" id="id166" name="id166">Tools keybindings</a></li> +<li><a class="reference" href="#help-keybindings" id="id167" name="id167">Help keybindings</a></li> </ul> </li> </ul> </li> -<li><a class="reference" href="#id4" id="id167" name="id167">Configuration files</a><ul> -<li><a class="reference" href="#tools-menu-items" id="id168" name="id168">Tools menu items</a></li> -<li><a class="reference" href="#global-configuration-file" id="id169" name="id169">Global configuration file</a></li> -<li><a class="reference" href="#filetype-definition-files" id="id170" name="id170">Filetype definition files</a><ul> -<li><a class="reference" href="#custom-filetypes" id="id171" name="id171">Custom filetypes</a></li> -<li><a class="reference" href="#system-files" id="id172" name="id172">System files</a></li> -<li><a class="reference" href="#user-files" id="id173" name="id173">User files</a></li> -<li><a class="reference" href="#format" id="id174" name="id174">Format</a><ul> -<li><a class="reference" href="#styling-section" id="id175" name="id175">[styling] Section</a><ul> -<li><a class="reference" href="#using-a-named-style" id="id176" name="id176">Using a named style</a></li> </ul> </li> -<li><a class="reference" href="#keywords-section" id="id177" name="id177">[keywords] Section</a></li> -<li><a class="reference" href="#lexer-properties-section" id="id178" name="id178">[lexer_properties] Section</a></li> -<li><a class="reference" href="#settings-section" id="id179" name="id179">[settings] Section</a></li> -<li><a class="reference" href="#build-settings-section" id="id180" name="id180">[build_settings] Section</a></li> +<li><a class="reference" href="#id4" id="id168" name="id168">Configuration files</a><ul> +<li><a class="reference" href="#tools-menu-items" id="id169" name="id169">Tools menu items</a></li> +<li><a class="reference" href="#global-configuration-file" id="id170" name="id170">Global configuration file</a></li> +<li><a class="reference" href="#filetype-definition-files" id="id171" name="id171">Filetype definition files</a><ul> +<li><a class="reference" href="#custom-filetypes" id="id172" name="id172">Custom filetypes</a></li> +<li><a class="reference" href="#system-files" id="id173" name="id173">System files</a></li> +<li><a class="reference" href="#user-files" id="id174" name="id174">User files</a></li> +<li><a class="reference" href="#format" id="id175" name="id175">Format</a><ul> +<li><a class="reference" href="#styling-section" id="id176" name="id176">[styling] Section</a><ul> +<li><a class="reference" href="#using-a-named-style" id="id177" name="id177">Using a named style</a></li> </ul> </li> -<li><a class="reference" href="#special-file-filetypes-common" id="id181" name="id181">Special file filetypes.common</a><ul> -<li><a class="reference" href="#named-styles-section" id="id182" name="id182">[named_styles] Section</a></li> -<li><a class="reference" href="#id5" id="id183" name="id183">[styling] Section</a></li> -<li><a class="reference" href="#id6" id="id184" name="id184">[settings] Section</a></li> +<li><a class="reference" href="#keywords-section" id="id178" name="id178">[keywords] Section</a></li> +<li><a class="reference" href="#lexer-properties-section" id="id179" name="id179">[lexer_properties] Section</a></li> +<li><a class="reference" href="#settings-section" id="id180" name="id180">[settings] Section</a></li> +<li><a class="reference" href="#build-settings-section" id="id181" name="id181">[build_settings] Section</a></li> </ul> </li> +<li><a class="reference" href="#special-file-filetypes-common" id="id182" name="id182">Special file filetypes.common</a><ul> +<li><a class="reference" href="#named-styles-section" id="id183" name="id183">[named_styles] Section</a></li> +<li><a class="reference" href="#id5" id="id184" name="id184">[styling] Section</a></li> +<li><a class="reference" href="#id6" id="id185" name="id185">[settings] Section</a></li> </ul> </li> -<li><a class="reference" href="#filetype-extensions" id="id185" name="id185">Filetype extensions</a></li> -<li><a class="reference" href="#preferences-file-format" id="id186" name="id186">Preferences File Format</a><ul> -<li><a class="reference" href="#hidden-preferences" id="id187" name="id187">Hidden preferences</a></li> -<li><a class="reference" href="#build-menu-section" id="id188" name="id188">[build-menu] Section</a></li> </ul> </li> -<li><a class="reference" href="#project-file-format" id="id189" name="id189">Project File Format</a><ul> -<li><a class="reference" href="#build-menu-additions" id="id190" name="id190">[build-menu] Additions</a></li> +<li><a class="reference" href="#filetype-extensions" id="id186" name="id186">Filetype extensions</a></li> +<li><a class="reference" href="#preferences-file-format" id="id187" name="id187">Preferences File Format</a><ul> +<li><a class="reference" href="#hidden-preferences" id="id188" name="id188">Hidden preferences</a></li> +<li><a class="reference" href="#build-menu-section" id="id189" name="id189">[build-menu] Section</a></li> </ul> </li> -<li><a class="reference" href="#templates" id="id191" name="id191">Templates</a><ul> -<li><a class="reference" href="#template-meta-data" id="id192" name="id192">Template meta data</a></li> -<li><a class="reference" href="#file-templates" id="id193" name="id193">File templates</a><ul> -<li><a class="reference" href="#custom-file-templates" id="id194" name="id194">Custom file templates</a></li> -<li><a class="reference" href="#filetype-templates" id="id195" name="id195">Filetype templates</a></li> +<li><a class="reference" href="#project-file-format" id="id190" name="id190">Project File Format</a><ul> +<li><a class="reference" href="#build-menu-additions" id="id191" name="id191">[build-menu] Additions</a></li> </ul> </li> -<li><a class="reference" href="#customizing-templates" id="id196" name="id196">Customizing templates</a><ul> -<li><a class="reference" href="#template-wildcards" id="id197" name="id197">Template wildcards</a><ul> -<li><a class="reference" href="#special-command-wildcard" id="id198" name="id198">Special {command:} wildcard</a></li> +<li><a class="reference" href="#templates" id="id192" name="id192">Templates</a><ul> +<li><a class="reference" href="#template-meta-data" id="id193" name="id193">Template meta data</a></li> +<li><a class="reference" href="#file-templates" id="id194" name="id194">File templates</a><ul> +<li><a class="reference" href="#custom-file-templates" id="id195" name="id195">Custom file templates</a></li> +<li><a class="reference" href="#filetype-templates" id="id196" name="id196">Filetype templates</a></li> </ul> </li> +<li><a class="reference" href="#customizing-templates" id="id197" name="id197">Customizing templates</a><ul> +<li><a class="reference" href="#template-wildcards" id="id198" name="id198">Template wildcards</a><ul> +<li><a class="reference" href="#special-command-wildcard" id="id199" name="id199">Special {command:} wildcard</a></li> </ul> </li> </ul> </li> -<li><a class="reference" href="#customizing-the-toolbar" id="id199" name="id199">Customizing the toolbar</a><ul> -<li><a class="reference" href="#manually-editing-of-the-toolbar-layout" id="id200" name="id200">Manually editing of the toolbar layout</a></li> -<li><a class="reference" href="#available-toolbar-elements" id="id201" name="id201">Available toolbar elements</a></li> </ul> </li> +<li><a class="reference" href="#customizing-the-toolbar" id="id200" name="id200">Customizing the toolbar</a><ul> +<li><a class="reference" href="#manually-editing-of-the-toolbar-layout" id="id201" name="id201">Manually editing of the toolbar layout</a></li> +<li><a class="reference" href="#available-toolbar-elements" id="id202" name="id202">Available toolbar elements</a></li> </ul> </li> -<li><a class="reference" href="#plugin-documentation" id="id202" name="id202">Plugin documentation</a><ul> -<li><a class="reference" href="#save-actions" id="id203" name="id203">Save Actions</a><ul> -<li><a class="reference" href="#instant-save" id="id204" name="id204">Instant Save</a></li> -<li><a class="reference" href="#backup-copy" id="id205" name="id205">Backup Copy</a></li> </ul> </li> +<li><a class="reference" href="#plugin-documentation" id="id203" name="id203">Plugin documentation</a><ul> +<li><a class="reference" href="#save-actions" id="id204" name="id204">Save Actions</a><ul> +<li><a class="reference" href="#instant-save" id="id205" name="id205">Instant Save</a></li> +<li><a class="reference" href="#backup-copy" id="id206" name="id206">Backup Copy</a></li> </ul> </li> -<li><a class="reference" href="#contributing-to-this-document" id="id206" name="id206">Contributing to this document</a></li> -<li><a class="reference" href="#scintilla-keyboard-commands" id="id207" name="id207">Scintilla keyboard commands</a><ul> -<li><a class="reference" href="#keyboard-commands" id="id208" name="id208">Keyboard commands</a></li> </ul> </li> -<li><a class="reference" href="#tips-and-tricks" id="id209" name="id209">Tips and tricks</a><ul> -<li><a class="reference" href="#document-notebook" id="id210" name="id210">Document notebook</a></li> -<li><a class="reference" href="#editor" id="id211" name="id211">Editor</a></li> -<li><a class="reference" href="#interface" id="id212" name="id212">Interface</a></li> -<li><a class="reference" href="#gtk-related" id="id213" name="id213">GTK-related</a></li> +<li><a class="reference" href="#contributing-to-this-document" id="id207" name="id207">Contributing to this document</a></li> +<li><a class="reference" href="#scintilla-keyboard-commands" id="id208" name="id208">Scintilla keyboard commands</a><ul> +<li><a class="reference" href="#keyboard-commands" id="id209" name="id209">Keyboard commands</a></li> </ul> </li> -<li><a class="reference" href="#compile-time-options" id="id214" name="id214">Compile-time options</a><ul> -<li><a class="reference" href="#src-geany-h" id="id215" name="id215">src/geany.h</a></li> -<li><a class="reference" href="#project-h" id="id216" name="id216">project.h</a></li> -<li><a class="reference" href="#editor-h" id="id217" name="id217">editor.h</a></li> -<li><a class="reference" href="#keyfile-c" id="id218" name="id218">keyfile.c</a></li> -<li><a class="reference" href="#build-c" id="id219" name="id219">build.c</a></li> +<li><a class="reference" href="#tips-and-tricks" id="id210" name="id210">Tips and tricks</a><ul> +<li><a class="reference" href="#document-notebook" id="id211" name="id211">Document notebook</a></li> +<li><a class="reference" href="#editor" id="id212" name="id212">Editor</a></li> +<li><a class="reference" href="#interface" id="id213" name="id213">Interface</a></li> +<li><a class="reference" href="#gtk-related" id="id214" name="id214">GTK-related</a></li> </ul> </li> -<li><a class="reference" href="#gnu-general-public-license" id="id220" name="id220">GNU General Public License</a></li> -<li><a class="reference" href="#license-for-scintilla-and-scite" id="id221" name="id221">License for Scintilla and SciTE</a></li> +<li><a class="reference" href="#compile-time-options" id="id215" name="id215">Compile-time options</a><ul> +<li><a class="reference" href="#src-geany-h" id="id216" name="id216">src/geany.h</a></li> +<li><a class="reference" href="#project-h" id="id217" name="id217">project.h</a></li> +<li><a class="reference" href="#editor-h" id="id218" name="id218">editor.h</a></li> +<li><a class="reference" href="#keyfile-c" id="id219" name="id219">keyfile.c</a></li> +<li><a class="reference" href="#build-c" id="id220" name="id220">build.c</a></li> </ul> +</li> +<li><a class="reference" href="#gnu-general-public-license" id="id221" name="id221">GNU General Public License</a></li> +<li><a class="reference" href="#license-for-scintilla-and-scite" id="id222" name="id222">License for Scintilla and SciTE</a></li> +</ul> </div> <div class="section"> <h1><a class="toc-backref" href="#id8" id="introduction" name="introduction">Introduction</a></h1> @@ -1473,9 +1476,25 @@ to be recognized as a word for completion. Leave it commented to use default characters or define it to add or remove characters to fit your needs.</p> +<div class="section"> +<h4><a class="toc-backref" href="#id55" id="snippet-keybindings" name="snippet-keybindings">Snippet keybindings</a></h4> +<p>Normally you would type the snippet name and press Tab. However, you +can define keybindings for snippets under the <em>Keybindings</em> group in +<tt class="docutils literal"><span class="pre">snippets.conf</span></tt>:</p> +<pre class="literal-block"> +[Keybindings] +for=<Ctrl>7 +block_cursor=<Ctrl>8 +</pre> +<div class="note"> +<p class="first admonition-title">Note</p> +<p class="last">Snippet keybindings may be overridden by Geany's configurable +keybindings.</p> </div> +</div> +</div> <div class="section"> -<h3><a class="toc-backref" href="#id55" id="inserting-unicode-characters" name="inserting-unicode-characters">Inserting Unicode characters</a></h3> +<h3><a class="toc-backref" href="#id56" id="inserting-unicode-characters" name="inserting-unicode-characters">Inserting Unicode characters</a></h3> <p>With GTK 2.10 and above, you can insert Unicode code points by hitting Ctrl-Shift-u, then still holding Ctrl-Shift, type some hex digits representing the code point for the character you want and hit Enter or Return (still @@ -1494,7 +1513,7 @@ </div> </div> <div class="section"> -<h2><a class="toc-backref" href="#id56" 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="#id57" id="search-replace-and-go-to" name="search-replace-and-go-to">Search, replace and go to</a></h2> <p>This section describes search-related commands from the Search menu and the editor window's popup menu:</p> <ul class="simple"> @@ -1508,7 +1527,7 @@ <li>Go to line</li> </ul> <div class="section"> -<h3><a class="toc-backref" href="#id57" id="toolbar-entries" name="toolbar-entries">Toolbar entries</a></h3> +<h3><a class="toc-backref" href="#id58" id="toolbar-entries" name="toolbar-entries">Toolbar entries</a></h3> <p>There are also two toolbar entries:</p> <ul class="simple"> <li>Search bar</li> @@ -1517,18 +1536,18 @@ <p>There are keybindings to focus each of these - see <a class="reference" href="#focus-keybindings">Focus keybindings</a>. Pressing Escape will then focus the editor.</p> <div class="section"> -<h4><a class="toc-backref" href="#id58" id="search-bar" name="search-bar">Search bar</a></h4> +<h4><a class="toc-backref" href="#id59" id="search-bar" name="search-bar">Search bar</a></h4> <p>The quickest way to find some text is to use the search bar entry in the toolbar. This performs a case-insensitive search in the current document whilst you type. Pressing Enter will search again.</p> </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id59" id="find" name="find">Find</a></h3> +<h3><a class="toc-backref" href="#id60" id="find" name="find">Find</a></h3> <p>The Find dialog is used for finding text in one or more open documents.</p> <img alt="./images/find_dialog.png" src="./images/find_dialog.png" /> <div class="section"> -<h4><a class="toc-backref" href="#id60" id="matching-options" name="matching-options">Matching options</a></h4> +<h4><a class="toc-backref" href="#id61" id="matching-options" name="matching-options">Matching options</a></h4> <p>The syntax for the <em>Use regular expressions</em> option is shown in <a class="reference" href="#regular-expressions">Regular expressions</a>.</p> <div class="note"> @@ -1541,7 +1560,7 @@ (Unicode characters).</p> </div> <div class="section"> -<h4><a class="toc-backref" href="#id61" id="find-all" name="find-all">Find all</a></h4> +<h4><a class="toc-backref" href="#id62" id="find-all" name="find-all">Find all</a></h4> <p>To find all matches, click on the Find All expander. This will reveal several options:</p> <ul class="simple"> @@ -1557,7 +1576,7 @@ Remove Markers command from the Document menu.</p> </div> <div class="section"> -<h4><a class="toc-backref" href="#id62" id="change-font-in-search-dialog-text-fields" name="change-font-in-search-dialog-text-fields">Change font in search dialog text fields</a></h4> +<h4><a class="toc-backref" href="#id63" id="change-font-in-search-dialog-text-fields" name="change-font-in-search-dialog-text-fields">Change font in search dialog text fields</a></h4> <p>All search related dialogs use a Monospace for the text input fields to increase the readability of input text. This is useful when you are typing input such as regular expressions with spaces, periods and commas which @@ -1579,7 +1598,7 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id63" id="find-selection" name="find-selection">Find selection</a></h3> +<h3><a class="toc-backref" href="#id64" id="find-selection" name="find-selection">Find selection</a></h3> <p>The <em>Find Next/Previous Selection</em> commands perform a search for the current selected text. If nothing is selected, by default the current word is used instead. This can be customized by the @@ -1608,7 +1627,7 @@ </table> </div> <div class="section"> -<h3><a class="toc-backref" href="#id64" id="find-usage" name="find-usage">Find usage</a></h3> +<h3><a class="toc-backref" href="#id65" id="find-usage" name="find-usage">Find usage</a></h3> <p>Find usage searches all open files. It is similar to the Find All In Session option in the Find dialog.</p> <p>If there is a selection, then it is used as the search text; otherwise @@ -1618,7 +1637,7 @@ shown in the Messages tab of the Message Window.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id65" id="find-in-files" name="find-in-files">Find in files</a></h3> +<h3><a class="toc-backref" href="#id66" id="find-in-files" name="find-in-files">Find in files</a></h3> <p>Find in files is a more powerful version of Find usage that searches all files in a certain directory using the Grep tool. The Grep tool must be correctly set in Preferences to the path of the system's Grep @@ -1639,7 +1658,7 @@ Grep implementations.</p> </div> <div class="section"> -<h4><a class="toc-backref" href="#id66" 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="#id67" id="filtering-out-version-control-files" name="filtering-out-version-control-files">Filtering out version control files</a></h4> <p>When using the <em>Recurse in subfolders</em> option with a directory that's under version control, you can set the <em>Extra options</em> field to filter out version control files.</p> @@ -1653,7 +1672,7 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id67" id="replace" name="replace">Replace</a></h3> +<h3><a class="toc-backref" href="#id68" id="replace" name="replace">Replace</a></h3> <p>The Replace dialog is used for replacing text in one or more open documents.</p> <img alt="./images/replace_dialog.png" src="./images/replace_dialog.png" /> @@ -1663,7 +1682,7 @@ be used in the search string and back references in the replacement text -- see the entry for '\n' in <a class="reference" href="#regular-expressions">Regular expressions</a>.</p> <div class="section"> -<h4><a class="toc-backref" href="#id68" id="replace-all" name="replace-all">Replace all</a></h4> +<h4><a class="toc-backref" href="#id69" id="replace-all" name="replace-all">Replace all</a></h4> <p>To replace several matches, click on the <em>Replace All</em> expander. This will reveal several options:</p> <ul class="simple"> @@ -1678,7 +1697,7 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id69" id="go-to-tag-definition" name="go-to-tag-definition">Go to tag definition</a></h3> +<h3><a class="toc-backref" href="#id70" id="go-to-tag-definition" name="go-to-tag-definition">Go to tag definition</a></h3> <p>If the current word is the name of a tag definition (like a function body) and the file containing the tag definition is open, this command will switch to that file and go to the corresponding line number. The @@ -1687,17 +1706,17 @@ menu is used.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id70" id="go-to-tag-declaration" name="go-to-tag-declaration">Go to tag declaration</a></h3> +<h3><a class="toc-backref" href="#id71" id="go-to-tag-declaration" name="go-to-tag-declaration">Go to tag declaration</a></h3> <p>Like Go to tag definition, but for a forward declaration such as a C function prototype or <tt class="docutils literal"><span class="pre">extern</span></tt> declaration instead of a function body.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id71" id="go-to-line" name="go-to-line">Go to line</a></h3> +<h3><a class="toc-backref" href="#id72" id="go-to-line" name="go-to-line">Go to line</a></h3> <p>Go to a particular line number in the current file.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id72" id="regular-expressions" name="regular-expressions">Regular expressions</a></h3> +<h3><a class="toc-backref" href="#id73" id="regular-expressions" name="regular-expressions">Regular expressions</a></h3> <p>You can use regular expressions in the Find and Replace dialogs by selecting the <em>Use regular expressions</em> check box (see <a class="reference" href="#matching-options">Matching options</a>). The syntax is POSIX compatible, as described in the table @@ -1811,7 +1830,7 @@ </div> </div> <div class="section"> -<h2><a class="toc-backref" href="#id73" id="tags" name="tags">Tags</a></h2> +<h2><a class="toc-backref" href="#id74" id="tags" name="tags">Tags</a></h2> <p>Tags are information that relates symbols in a program with the source file location of the declaration and definition.</p> <p>Geany has built-in functionality for generating tag information (aka @@ -1822,7 +1841,7 @@ (but is incompatible with ctags). You use Geany to generate global tags files, as described below.</p> <div class="section"> -<h3><a class="toc-backref" href="#id74" id="workspace-tags" name="workspace-tags">Workspace tags</a></h3> +<h3><a class="toc-backref" href="#id75" id="workspace-tags" name="workspace-tags">Workspace tags</a></h3> <p>Tags for each document are parsed whenever a file is loaded or saved. These are shown in the Symbol list in the Sidebar. These tags are also used for autocompletion of symbols and calltips for all documents @@ -1831,7 +1850,7 @@ <a class="reference" href="#go-to-tag-definition">Go to tag definition</a>.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id75" id="global-tags" name="global-tags">Global tags</a></h3> +<h3><a class="toc-backref" href="#id76" id="global-tags" name="global-tags">Global tags</a></h3> <p>Global tags are used to provide autocompletion of symbols and calltips without having to open the corresponding source files. This is intended for library APIs, as the tags file only has to be updated when you upgrade @@ -1854,7 +1873,7 @@ with the tags. See the section called <a class="reference" href="#filetype-extensions">Filetype extensions</a> for more information.</p> <div class="section"> -<h4><a class="toc-backref" href="#id76" id="default-global-tags-files" name="default-global-tags-files">Default global tags files</a></h4> +<h4><a class="toc-backref" href="#id77" id="default-global-tags-files" name="default-global-tags-files">Default global tags files</a></h4> <p>For some languages, a list of global tags is loaded when the corresponding filetype is first used. Currently these are for:</p> <ul class="simple"> @@ -1867,7 +1886,7 @@ </ul> </div> <div class="section"> -<h4><a class="toc-backref" href="#id77" id="global-tags-file-format" name="global-tags-file-format">Global tags file format</a></h4> +<h4><a class="toc-backref" href="#id78" id="global-tags-file-format" name="global-tags-file-format">Global tags file format</a></h4> <p>Global tags files can have two different formats:</p> <ul class="simple"> <li>Tagmanager format</li> @@ -1904,7 +1923,7 @@ section <a class="reference" href="#global-tags">Global tags</a>.</p> </div> <div class="section"> -<h4><a class="toc-backref" href="#id78" 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="#id79" id="generating-a-global-tags-file" name="generating-a-global-tags-file">Generating a global tags file</a></h4> <p>You can generate your own global tags files by parsing a list of source files. The command is:</p> <pre class="literal-block"> @@ -1949,7 +1968,7 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id79" id="ignore-tags" name="ignore-tags">Ignore tags</a></h3> +<h3><a class="toc-backref" href="#id80" id="ignore-tags" name="ignore-tags">Ignore tags</a></h3> <p>You can also ignore certain tags if they would lead to wrong parsing of the code. Simply create a file called "ignore.tags" in your Geany configuration directory (usually <tt class="docutils literal"><span class="pre">~/.config/geany/</span></tt>). Then list all tags @@ -1973,7 +1992,7 @@ </div> </div> <div class="section"> -<h2><a class="toc-backref" href="#id80" id="preferences" name="preferences">Preferences</a></h2> +<h2><a class="toc-backref" href="#id81" id="preferences" name="preferences">Preferences</a></h2> <p>You may adjust Geany's settings using the Edit --> Preferences dialog. Any changes you make there can be applied by hitting either the Apply or the OK button. These settings will persist between Geany @@ -1991,10 +2010,10 @@ comes after the screenshot of that tab.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id81" id="general-startup-preferences" name="general-startup-preferences">General Startup preferences</a></h3> +<h3><a class="toc-backref" href="#id82" id="general-startup-preferences" name="general-startup-preferences">General Startup preferences</a></h3> <img alt="./images/pref_dialog_gen_startup.png" src="./images/pref_dialog_gen_startup.png" /> <div class="section"> -<h4><a class="toc-backref" href="#id82" id="id1" name="id1">Startup</a></h4> +<h4><a class="toc-backref" href="#id83" id="id1" name="id1">Startup</a></h4> <dl class="docutils"> <dt>Load files from the last session</dt> <dd>On startup, load the same files you had open the last time you @@ -2006,7 +2025,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id83" id="shutdown" name="shutdown">Shutdown</a></h4> +<h4><a class="toc-backref" href="#id84" id="shutdown" name="shutdown">Shutdown</a></h4> <dl class="docutils"> <dt>Save window position and geometry</dt> <dd>Save the current position and size of the main window so next time @@ -2016,7 +2035,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id84" id="paths" name="paths">Paths</a></h4> +<h4><a class="toc-backref" href="#id85" id="paths" name="paths">Paths</a></h4> <dl class="docutils"> <dt>Startup path</dt> <dd>Path to start in when opening or saving files. @@ -2035,10 +2054,10 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id85" id="general-miscellaneous-preferences" name="general-miscellaneous-preferences">General Miscellaneous preferences</a></h3> +<h3><a class="toc-backref" href="#id86" id="general-miscellaneous-preferences" name="general-miscellaneous-preferences">General Miscellaneous preferences</a></h3> <img alt="./images/pref_dialog_gen_misc.png" src="./images/pref_dialog_gen_misc.png" /> <div class="section"> -<h4><a class="toc-backref" href="#id86" id="miscellaneous" name="miscellaneous">Miscellaneous</a></h4> +<h4><a class="toc-backref" href="#id87" id="miscellaneous" name="miscellaneous">Miscellaneous</a></h4> <dl class="docutils"> <dt>Beep on errors when compilation has finished</dt> <dd>Have the computer make a beeping sound when compilation of your program @@ -2066,7 +2085,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id87" id="search" name="search">Search</a></h4> +<h4><a class="toc-backref" href="#id88" id="search" name="search">Search</a></h4> <dl class="docutils"> <dt>Always wrap search and hide the Find dialog</dt> <dd>Always wrap search around the document and hide the Find dialog after clicking @@ -2082,7 +2101,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id88" id="projects" name="projects">Projects</a></h4> +<h4><a class="toc-backref" href="#id89" id="projects" name="projects">Projects</a></h4> <dl class="docutils"> <dt>Use project-based session files</dt> <dd>Save your current session when closing projects. You will be able to @@ -2099,10 +2118,10 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id89" id="interface-preferences" name="interface-preferences">Interface preferences</a></h3> +<h3><a class="toc-backref" href="#id90" id="interface-preferences" name="interface-preferences">Interface preferences</a></h3> <img alt="./images/pref_dialog_interface.png" src="./images/pref_dialog_interface.png" /> <div class="section"> -<h4><a class="toc-backref" href="#id90" id="sidebar" name="sidebar">Sidebar</a></h4> +<h4><a class="toc-backref" href="#id91" id="sidebar" name="sidebar">Sidebar</a></h4> <dl class="docutils"> <dt>Show sidebar</dt> <dd>Whether to show the sidebar at all.</dd> @@ -2118,7 +2137,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id91" id="fonts" name="fonts">Fonts</a></h4> +<h4><a class="toc-backref" href="#id92" id="fonts" name="fonts">Fonts</a></h4> <dl class="docutils"> <dt>Editor</dt> <dd>Change the font used to display documents.</dd> @@ -2129,7 +2148,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id92" id="editor-tabs" name="editor-tabs">Editor tabs</a></h4> +<h4><a class="toc-backref" href="#id93" id="editor-tabs" name="editor-tabs">Editor tabs</a></h4> <dl class="docutils"> <dt>Show editor tabs</dt> <dd>Show a notebook tab for all documents so you can switch between them @@ -2149,7 +2168,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id93" id="tab-positions" name="tab-positions">Tab positions</a></h4> +<h4><a class="toc-backref" href="#id94" id="tab-positions" name="tab-positions">Tab positions</a></h4> <dl class="docutils"> <dt>Editor</dt> <dd>Set the positioning of the editor's notebook tabs to the right, @@ -2163,7 +2182,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id94" id="id2" name="id2">Miscellaneous</a></h4> +<h4><a class="toc-backref" href="#id95" id="id2" name="id2">Miscellaneous</a></h4> <dl class="docutils"> <dt>Show status bar</dt> <dd>Show the status bar at the bottom of the main window. It gives information about @@ -2173,11 +2192,11 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id95" id="toolbar-preferences" name="toolbar-preferences">Toolbar preferences</a></h3> +<h3><a class="toc-backref" href="#id96" id="toolbar-preferences" name="toolbar-preferences">Toolbar preferences</a></h3> <p>Affects the main toolbar underneath the menu bar.</p> <img alt="./images/pref_dialog_toolbar.png" src="./images/pref_dialog_toolbar.png" /> <div class="section"> -<h4><a class="toc-backref" href="#id96" id="toolbar" name="toolbar">Toolbar</a></h4> +<h4><a class="toc-backref" href="#id97" id="toolbar" name="toolbar">Toolbar</a></h4> <dl class="docutils"> <dt>Show Toolbar</dt> <dd>Whether to show the toolbar.</dd> @@ -2189,7 +2208,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id97" id="appearance" name="appearance">Appearance</a></h4> +<h4><a class="toc-backref" href="#id98" id="appearance" name="appearance">Appearance</a></h4> <dl class="docutils"> <dt>Icon Style</dt> <dd>Select the toolbar icon style to use - either icons and text, just @@ -2202,10 +2221,10 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id98" id="editor-features-preferences" name="editor-features-preferences">Editor Features preferences</a></h3> +<h3><a class="toc-backref" href="#id99" id="editor-features-preferences" name="editor-features-preferences">Editor Features preferences</a></h3> <img alt="./images/pref_dialog_edit_features.png" src="./images/pref_dialog_edit_features.png" /> <div class="section"> -<h4><a class="toc-backref" href="#id99" id="features" name="features">Features</a></h4> +<h4><a class="toc-backref" href="#id100" id="features" name="features">Features</a></h4> <dl class="docutils"> <dt>Line wrapping</dt> <dd>Show long lines wrapped around to new display lines.</dd> @@ -2237,10 +2256,10 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id100" id="editor-indentation-preferences" name="editor-indentation-preferences">Editor Indentation preferences</a></h3> +<h3><a class="toc-backref" href="#id101" id="editor-indentation-preferences" name="editor-indentation-preferences">Editor Indentation preferences</a></h3> <img alt="./images/pref_dialog_edit_indentation.png" src="./images/pref_dialog_edit_indentation.png" /> <div class="section"> -<h4><a class="toc-backref" href="#id101" id="indentation-group" name="indentation-group">Indentation group</a></h4> +<h4><a class="toc-backref" href="#id102" id="indentation-group" name="indentation-group">Indentation group</a></h4> <p>See <a class="reference" href="#indentation">Indentation</a> for more information.</p> <dl class="docutils"> <dt>Type</dt> @@ -2289,10 +2308,10 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id102" id="editor-completions-preferences" name="editor-completions-preferences">Editor Completions preferences</a></h3> +<h3><a class="toc-backref" href="#id103" id="editor-completions-preferences" name="editor-completions-preferences">Editor Completions preferences</a></h3> <img alt="./images/pref_dialog_edit_completions.png" src="./images/pref_dialog_edit_completions.png" /> <div class="section"> -<h4><a class="toc-backref" href="#id103" id="completions" name="completions">Completions</a></h4> +<h4><a class="toc-backref" href="#id104" id="completions" name="completions">Completions</a></h4> <dl class="docutils"> <dt>Snippet Completion</dt> <dd>Whether to replace special keywords after typing Tab into a @@ -2337,7 +2356,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id104" id="auto-close-quotes-and-brackets" name="auto-close-quotes-and-brackets">Auto-close quotes and brackets</a></h4> +<h4><a class="toc-backref" href="#id105" id="auto-close-quotes-and-brackets" name="auto-close-quotes-and-brackets">Auto-close quotes and brackets</a></h4> <p>Geany can automatically insert a closing bracket and quote characters when you open them. For instance, you type a <tt class="docutils literal"><span class="pre">(</span></tt> and Geany will automatically insert <tt class="docutils literal"><span class="pre">)</span></tt>. With the following options, you can define for which @@ -2357,11 +2376,11 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id105" id="editor-display-preferences" name="editor-display-preferences">Editor Display preferences</a></h3> +<h3><a class="toc-backref" href="#id106" id="editor-display-preferences" name="editor-display-preferences">Editor Display preferences</a></h3> <p>This is for visual elements displayed in the editor window.</p> <img alt="./images/pref_dialog_edit_display.png" src="./images/pref_dialog_edit_display.png" /> <div class="section"> -<h4><a class="toc-backref" href="#id106" id="display" name="display">Display</a></h4> +<h4><a class="toc-backref" href="#id107" id="display" name="display">Display</a></h4> <dl class="docutils"> <dt>Invert syntax highlighting colors</dt> <dd>Invert all colors, by default this makes white text on a black @@ -2386,7 +2405,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id107" id="long-line-marker" name="long-line-marker">Long line marker</a></h4> +<h4><a class="toc-backref" href="#id108" id="long-line-marker" name="long-line-marker">Long line marker</a></h4> <p>The long line marker helps to indicate overly-long lines, or as a hint to the user for when to break the line.</p> <dl class="docutils"> @@ -2411,7 +2430,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id108" id="virtual-spaces" name="virtual-spaces">Virtual spaces</a></h4> +<h4><a class="toc-backref" href="#id109" id="virtual-spaces" name="virtual-spaces">Virtual spaces</a></h4> <p>Virtual space is space beyond the end of each line. The cursor may be moved into virtual space but no real space will be added to the document until there is some text typed or some other @@ -2427,10 +2446,10 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id109" id="files-preferences" name="files-preferences">Files preferences</a></h3> +<h3><a class="toc-backref" href="#id110" id="files-preferences" name="files-preferences">Files preferences</a></h3> <img alt="./images/pref_dialog_files.png" src="./images/pref_dialog_files.png" /> <div class="section"> -<h4><a class="toc-backref" href="#id110" id="new-files" name="new-files">New files</a></h4> +<h4><a class="toc-backref" href="#id111" id="new-files" name="new-files">New files</a></h4> <dl class="docutils"> <dt>Open new documents from the command-line</dt> <dd>Whether to create new documents when passing filenames that don't @@ -2450,7 +2469,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id111" id="saving-files" name="saving-files">Saving files</a></h4> +<h4><a class="toc-backref" href="#id112" id="saving-files" name="saving-files">Saving files</a></h4> <p>Perform formatting operations when a document is saved. These can each be undone with the Undo command.</p> <dl class="docutils"> @@ -2469,7 +2488,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id112" id="id3" name="id3">Miscellaneous</a></h4> +<h4><a class="toc-backref" href="#id113" id="id3" name="id3">Miscellaneous</a></h4> <dl class="docutils"> <dt>Recent files list length</dt> <dd>The number of files to remember in the recently used files list.</dd> @@ -2488,10 +2507,10 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id113" id="tools-preferences" name="tools-preferences">Tools preferences</a></h3> +<h3><a class="toc-backref" href="#id114" id="tools-preferences" name="tools-preferences">Tools preferences</a></h3> <img alt="./images/pref_dialog_tools.png" src="./images/pref_dialog_tools.png" /> <div class="section"> -<h4><a class="toc-backref" href="#id114" id="tool-paths" name="tool-paths">Tool paths</a></h4> +<h4><a class="toc-backref" href="#id115" id="tool-paths" name="tool-paths">Tool paths</a></h4> <dl class="docutils"> <dt>Terminal</dt> <dd>The location of your terminal executable.</dd> @@ -2509,7 +2528,7 @@ </div> </div> <div class="section"> -<h4><a class="toc-backref" href="#id115" id="commands" name="commands">Commands</a></h4> +<h4><a class="toc-backref" href="#id116" id="commands" name="commands">Commands</a></h4> <dl class="docutils"> <dt>Context action</dt> <dd>Set this to a command to execute on the current word. @@ -2519,7 +2538,7 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id116" id="template-preferences" name="template-preferences">Template preferences</a></h3> +<h3><a class="toc-backref" href="#id117" id="template-preferences" name="template-preferences">Template preferences</a></h3> <p>This data is used as meta data for various template text to insert into a document, such as the file header. You only need to set fields that you want to use in your template files.</p> @@ -2530,7 +2549,7 @@ </div> <img alt="./images/pref_dialog_templ.png" src="./images/pref_dialog_templ.png" /> <div class="section"> -<h4><a class="toc-backref" href="#id117" id="template-data" name="template-data">Template data</a></h4> +<h4><a class="toc-backref" href="#id118" id="template-data" name="template-data">Template data</a></h4> <dl class="docutils"> <dt>Developer</dt> <dd>The name of the developer who will be creating files.</dd> @@ -2563,7 +2582,7 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id118" id="keybinding-preferences" name="keybinding-preferences">Keybinding preferences</a></h3> +<h3><a class="toc-backref" href="#id119" id="keybinding-preferences" name="keybinding-preferences">Keybinding preferences</a></h3> <img alt="./images/pref_dialog_keys.png" src="./images/pref_dialog_keys.png" /> <p>There are some commands listed in the keybinding dialog that are not, by default, bound to a key combination, and may not be available as a menu item.</p> @@ -2573,7 +2592,7 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id119" id="printing-preferences" name="printing-preferences">Printing preferences</a></h3> +<h3><a class="toc-backref" href="#id120" id="printing-preferences" name="printing-preferences">Printing preferences</a></h3> <img alt="./images/pref_dialog_printing.png" src="./images/pref_dialog_printing.png" /> <dl class="docutils"> <dt>Use external command for printing</dt> @@ -2595,11 +2614,11 @@ </dl> </div> <div class="section"> -<h3><a class="toc-backref" href="#id120" id="terminal-vte-preferences" name="terminal-vte-preferences">Terminal (VTE) preferences</a></h3> +<h3><a class="toc-backref" href="#id121" id="terminal-vte-preferences" name="terminal-vte-preferences">Terminal (VTE) preferences</a></h3> <p>See also: <a class="reference" href="#virtual-terminal-emulator-widget-vte">Virtual terminal emulator widget (VTE)</a>.</p> <img alt="./images/pref_dialog_vte.png" src="./images/pref_dialog_vte.png" /> <div class="section"> -<h4><a class="toc-backref" href="#id121" id="terminal-widget" name="terminal-widget">Terminal widget</a></h4> +<h4><a class="toc-backref" href="#id122" id="terminal-widget" name="terminal-widget">Terminal widget</a></h4> <dl class="docutils"> <dt>Terminal font</dt> <dd>Select the font that will be used in the terminal emulation control.</dd> @@ -2638,7 +2657,7 @@ </div> </div> <div class="section"> -<h2><a class="toc-backref" href="#id122" id="project-management" name="project-management">Project Management</a></h2> +<h2><a class="toc-backref" href="#id123" id="project-management" name="project-management">Project Management</a></h2> <p>Project Management is optional in Geany. Currently it can be used for:</p> <ul class="simple"> <li>Storing and opening session files on a project basis.</li> @@ -2655,7 +2674,7 @@ file that was in use at the end of the last session will be reopened.</p> <p>The project menu items are detailed below.</p> <div class="section"> -<h3><a class="toc-backref" href="#id123" id="new-project" name="new-project">New Project</a></h3> +<h3><a class="toc-backref" href="#id124" id="new-project" name="new-project">New Project</a></h3> <p>To create a new project, fill in the <em>Name</em> field. By default this will setup a new project file <tt class="docutils literal"><span class="pre">~/projects/name.geany</span></tt>. Usually it's best to store all your project files in the same directory (they are @@ -2665,7 +2684,7 @@ structure contained in it.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id124" id="project-properties" name="project-properties">Project Properties</a></h3> +<h3><a class="toc-backref" href="#id125" id="project-properties" name="project-properties">Project Properties</a></h3> <p>You can set an optional description for the project, but it is not used elsewhere by Geany.</p> <p>The <em>Base path</em> field is used as the directory to run the Build menu commands. @@ -2673,7 +2692,7 @@ relative to the project's file name.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id125" id="open-project" name="open-project">Open Project</a></h3> +<h3><a class="toc-backref" href="#id126" id="open-project" name="open-project">Open Project</a></h3> <p>The Open command displays a standard file chooser, starting in <tt class="docutils literal"><span class="pre">~/projects</span></tt>. Choose a project file named with the <tt class="docutils literal"><span class="pre">.geany</span></tt> extension.</p> @@ -2681,14 +2700,14 @@ open files and open the session files associated with the project.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id126" id="close-project" name="close-project">Close Project</a></h3> +<h3><a class="toc-backref" href="#id127" id="close-project" name="close-project">Close Project</a></h3> <p>Project file settings are saved when the project is closed.</p> <p>When project session support is enabled, Geany will close the project session files and open any previously closed default session files.</p> </div> </div> <div class="section"> -<h2><a class="toc-backref" href="#id127" id="build-menu" name="build-menu">Build Menu</a></h2> +<h2><a class="toc-backref" href="#id128" id="build-menu" name="build-menu">Build Menu</a></h2> <p>After editing code with Geany, the next step is to compile, link, build, interpret, run etc. As Geany supports many languages each with a different approach to such operations, and as there are also many language independent @@ -2715,7 +2734,7 @@ Dialog, see <a class="reference" href="#build-menu-configuration">Build Menu Configuration</a>.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id128" id="indicators" name="indicators">Indicators</a></h3> +<h3><a class="toc-backref" href="#id129" id="indicators" name="indicators">Indicators</a></h3> <p>Indicators are red squiggly underlines which are used to highlight errors which occurred while compiling the current file. So you can easily see where your code failed to compile. You can remove them by @@ -2724,7 +2743,7 @@ preferences</a>.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id129" id="default-build-menu-items" name="default-build-menu-items">Default Build Menu Items</a></h3> +<h3><a class="toc-backref" href="#id130" id="default-build-menu-items" name="default-build-menu-items">Default Build Menu Items</a></h3> <p>Depending on the current file's filetype, the default Build menu will contain the following items:</p> <ul class="simple"> @@ -2739,7 +2758,7 @@ <li>Set Build Menu Commands</li> </ul> <div class="section"> -<h4><a class="toc-backref" href="#id130" id="compile" name="compile">Compile</a></h4> +<h4><a class="toc-backref" href="#id131" id="compile" name="compile">Compile</a></h4> <p>The Compile command has different uses for different kinds of files.</p> <p>For compilable languages such as C and C++, the Compile command is set up to compile the current source file into a binary object file.</p> @@ -2749,7 +2768,7 @@ or if that is not available will run the file in its language interpreter.</p> </div> <div class="section"> -<h4><a class="toc-backref" href="#id131" id="build" name="build">Build</a></h4> +<h4><a class="toc-backref" href="#id132" id="build" name="build">Build</a></h4> <p>For compilable languages such as C and C++, the Build command will link the current source file's equivalent object file into an executable. If the object file does not exist, the source will be compiled and linked @@ -2764,32 +2783,32 @@ </div> </div> <div class="section"> -<h4><a class="toc-backref" href="#id132" id="make" name="make">Make</a></h4> +<h4><a class="toc-backref" href="#id133" id="make" name="make">Make</a></h4> <p>This runs "make" in the same directory as the current file.</p> </div> <div class="section"> -<h4><a class="toc-backref" href="#id133" id="make-custom-target" name="make-custom-target">Make custom target</a></h4> +<h4><a class="toc-backref" href="#id134" id="make-custom-target" name="make-custom-target">Make custom target</a></h4> <p>This is similar to running 'Make' but you will be prompted for the make target name to be passed to the Make tool. For example, typing 'clean' in the dialog prompt will run "make clean".</p> </div> <div class="section"> -<h4><a class="toc-backref" href="#id134" id="make-object" name="make-object">Make object</a></h4> +<h4><a class="toc-backref" href="#id135" id="make-object" name="make-object">Make object</a></h4> <p>Make object will run "make current_file.o" in the same directory as the current file, using the filename for 'current_file'. It is useful for building just the current file without building the whole project.</p> </div> <div class="section"> -<h4><a class="toc-backref" href="#id135" id="next-error" name="next-error">Next Error</a></h4> +<h4><a class="toc-backref" href="#id136" id="next-error" name="next-error">Next Error</a></h4> <p>The next error item will move to the next detected error in the file.</p> </div> <div class="section"> -<h4><a class="toc-backref" href="#id136" id="previous-error" name="previous-error">Previous Error</a></h4> +<h4><a class="toc-backref" href="#id137" id="previous-error" name="previous-error">Previous Error</a></h4> <p>The previous error item will move to the previous detected error in the file.</p> </div> <div class="section"> -<h4><a class="toc-backref" href="#id137" id="execute" name="execute">Execute</a></h4> +<h4><a class="toc-backref" href="#id138" id="execute" name="execute">Execute</a></h4> <p>Execute will run the corresponding executable file, shell script or interpreted script in a terminal window. Note that the Terminal tool path must be correctly set in the Tools tab of the Preferences dialog - @@ -2806,7 +2825,7 @@ </div> </div> <div class="section"> -<h4><a class="toc-backref" href="#id138" id="stopping-running-processes" name="stopping-running-processes">Stopping running processes</a></h4> +<h4><a class="toc-backref" href="#id139" id="stopping-running-processes" name="stopping-running-processes">Stopping running processes</a></h4> <p>When there is a running program, the Execute menu item in the menu and the Run button in the toolbar each become a stop button so you can stop the current running program (and @@ -2815,7 +2834,7 @@ cannot be stopped. For example this can happen when the process creates more than one child process.</p> <div class="section"> -<h5><a class="toc-backref" href="#id139" id="terminal-emulators" name="terminal-emulators">Terminal emulators</a></h5> +<h5><a class="toc-backref" href="#id140" id="terminal-emulators" name="terminal-emulators">Terminal emulators</a></h5> <p>Xterm is known to work properly. If you are using "Terminal" (the terminal program of Xfce), you should add the command line option <tt class="docutils literal"><span class="pre">--disable-server</span></tt> otherwise the started process cannot be @@ -2824,7 +2843,7 @@ </div> </div> <div class="section"> -<h4><a class="toc-backref" href="#id140" id="set-build-commands" name="set-build-commands">Set Build Commands</a></h4> +<h4><a class="toc-backref" href="#id141" id="set-build-commands" name="set-build-commands">Set Build Commands</a></h4> <p>By default the Compile and Build commands invoke the GCC compiler and linker with only the basic arguments needed by all programs. Using <em>Set Build Commands</em> you can add any include paths and compile @@ -2833,7 +2852,7 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id141" id="build-menu-configuration" name="build-menu-configuration">Build Menu Configuration</a></h3> +<h3><a class="toc-backref" href="#id142" id="build-menu-configuration" name="build-menu-configuration">Build Menu Configuration</a></h3> <p>The build menu has considerable flexibility and configurability, allowing both menu labels the commands they execute and the directory they execute in to be configured.</p> @@ -2996,7 +3015,7 @@ </ul> </div> <div class="section"> -<h3><a class="toc-backref" href="#id142" id="build-menu-commands-dialog" name="build-menu-commands-dialog">Build Menu Commands Dialog</a></h3> +<h3><a class="toc-backref" href="#id143" id="build-menu-commands-dialog" name="build-menu-commands-dialog">Build Menu Commands Dialog</a></h3> <p>Most of the configuration of the build menu is done through the Build Menu Commands Dialog. You edit the configuration sourced from preferences in the dialog opened from the Build->Build Menu Commands item and you edit the @@ -3029,7 +3048,7 @@ To hide lower priority menu items without having anything show in the menu configure with a nothing in the label but at least one character in the command.</p> <div class="section"> -<h4><a class="toc-backref" href="#id143" id="substitutions-in-commands-and-working-directories" name="substitutions-in-commands-and-working-directories">Substitutions in Commands and Working Directories</a></h4> +<h4><a class="toc-backref" href="#id144" id="substitutions-in-commands-and-working-directories" name="substitutions-in-commands-and-working-directories">Substitutions in Commands and Working Directories</a></h4> <p>The first occurence of each of the following character sequences in each of the command and working directory fields is substituted by the items specified below before the command is run.</p> @@ -3050,7 +3069,7 @@ </div> </div> <div class="section"> -<h4><a class="toc-backref" href="#id144" id="build-menu-keyboard-shortcuts" name="build-menu-keyboard-shortcuts">Build Menu Keyboard Shortcuts</a></h4> +<h4><a class="toc-backref" href="#id145" id="build-menu-keyboard-shortcuts" name="build-menu-keyboard-shortcuts">Build Menu Keyboard Shortcuts</a></h4> <p>Keyboard shortcuts can be defined for the first two filetype menu items, the first three non-filetype menu items, the first two execute menu items and the fixed menu items. In the keybindings configuration dialog (see <a class="reference" href="#keybinding-preferences">Keybinding preferences</a>) @@ -3059,7 +3078,7 @@ <p>You can also use underlines in the labels to set mnemonic characters.</p> </div> <div class="section"> -<h4><a class="toc-backref" href="#id145" id="configuration-files" name="configuration-files">Configuration Files</a></h4> +<h4><a class="toc-backref" href="#id146" id="configuration-files" name="configuration-files">Configuration Files</a></h4> <p>The configurable Build Menu capability was introduced in Geany 0.19 and required a new section to be added to the configuration files (See <a class="reference" href="#preferences-file-format">Preferences File Format</a>). Geany will still load older format project, @@ -3075,7 +3094,7 @@ </div> </div> <div class="section"> -<h2><a class="toc-backref" href="#id146" id="printing-support" name="printing-support">Printing support</a></h2> +<h2><a class="toc-backref" href="#id147" id="printing-support" name="printing-support">Printing support</a></h2> <p>Since Geany 0.13 there has been printing support using GTK's printing API. The printed page(s) will look nearly the same as on your screen in Geany. Additionally, there are some options to modify the printed page(s).</p> @@ -3129,7 +3148,7 @@ gtklp or similar programs can be used.</p> </div> <div class="section"> -<h2><a class="toc-backref" href="#id147" id="plugins" name="plugins">Plugins</a></h2> +<h2><a class="toc-backref" href="#id148" id="plugins" name="plugins">Plugins</a></h2> <p>Plugins are loaded at startup, if the <em>Enable plugin support</em> general preference is set. There is also a command-line option, <tt class="docutils literal"><span class="pre">-p</span></tt>, which prevents plugins being loaded. Plugins are scanned in @@ -3150,13 +3169,13 @@ which are included in Geany.</p> </div> <div class="section"> -<h2><a class="toc-backref" href="#id148" id="keybindings" name="keybindings">Keybindings</a></h2> +<h2><a class="toc-backref" href="#id149" id="keybindings" name="keybindings">Keybindings</a></h2> <p>Geany supports the default keyboard shortcuts for the Scintilla editing widget. For a list of these commands, see <a class="reference" href="#scintilla-keyboard-commands">Scintilla keyboard commands</a>. The Scintilla keyboard shortcuts will be overridden by any custom keybindings with the same keyboard shortcut.</p> <div class="section"> -<h3><a class="toc-backref" href="#id149" id="switching-documents" name="switching-documents">Switching documents</a></h3> +<h3><a class="toc-backref" href="#id150" id="switching-documents" name="switching-documents">Switching documents</a></h3> <p>There are a few non-configurable bindings to switch between documents, listed below. These can also be overridden by custom keybindings.</p> <table border="1" class="docutils"> @@ -3186,7 +3205,7 @@ </table> </div> <div class="section"> -<h3><a class="toc-backref" href="#id150" id="configurable-keybindings" name="configurable-keybindings">Configurable keybindings</a></h3> +<h3><a class="toc-backref" href="#id151" id="configurable-keybindings" name="configurable-keybindings">Configurable keybindings</a></h3> <p>For all actions listed below you can define your own keybindings. Open the Preferences dialog, select the desired action and click on change. In the resulting dialog you can press the key combination you @@ -3204,7 +3223,7 @@ which are common to many applications are marked with (C) after the shortcut.</p> <div class="section"> -<h4><a class="toc-backref" href="#id151" id="file-keybindings" name="file-keybindings">File keybindings</a></h4> +<h4><a class="toc-backref" href="#id152" id="file-keybindings" name="file-keybindings">File keybindings</a></h4> <table border="1" class="docutils"> <colgroup> <col width="29%" /> @@ -3267,7 +3286,7 @@ </table> </div> <div class="section"> -<h4><a class="toc-backref" href="#id152" id="editor-keybindings" name="editor-keybindings">Editor keybindings</a></h4> +<h4><a class="toc-backref" href="#id153" id="editor-keybindings" name="editor-keybindings">Editor keybindings</a></h4> <table border="1" class="docutils"> <colgroup> <col width="29%" /> @@ -3389,7 +3408,7 @@ </table> </div> <div class="section"> -<h4><a class="toc-backref" href="#id153" id="clipboard-keybindings" name="clipboard-keybindings">Clipboard keybindings</a></h4> +<h4><a class="toc-backref" href="#id154" id="clipboard-keybindings" name="clipboard-keybindings">Clipboard keybindings</a></h4> <table border="1" class="docutils"> <colgroup> <col width="29%" /> @@ -3429,7 +3448,7 @@ </table> </div> <div class="section"> -<h4><a class="toc-backref" href="#id154" id="select-keybindings" name="select-keybindings">Select keybindings</a></h4> +<h4><a class="toc-backref" href="#id155" id="select-keybindings" name="select-keybindings">Select keybindings</a></h4> <table border="1" class="docutils"> <colgroup> <col width="29%" /> @@ -3474,7 +3493,7 @@ </table> </div> <div class="section"> -<h4><a class="toc-backref" href="#id155" id="insert-keybindings" name="insert-keybindings">Insert keybindings</a></h4> +<h4><a class="toc-backref" href="#id156" id="insert-keybindings" name="insert-keybindings">Insert keybindings</a></h4> <table border="1" class="docutils"> <colgroup> <col width="29%" /> @@ -3503,7 +3522,7 @@ </table> </div> <div class="section"> -<h4><a class="toc-backref" href="#id156" id="format-keybindings" name="format-keybindings">Format keybindings</a></h4> +<h4><a class="toc-backref" href="#id157" id="format-keybindings" name="format-keybindings">Format keybindings</a></h4> <table border="1" class="docutils"> <colgroup> <col width="29%" /> @@ -3591,7 +3610,7 @@ </table> </div> <div class="section"> -<h4><a class="toc-backref" href="#id157" id="settings-keybindings" name="settings-keybindings">Settings keybindings</a></h4> +<h4><a class="toc-backref" href="#id158" id="settings-keybindings" name="settings-keybindings">Settings keybindings</a></h4> <table border="1" class="docutils"> <colgroup> <col width="29%" /> @@ -3617,7 +3636,7 @@ </table> </div> <div class="section"> -<h4><a class="toc-backref" href="#id158" id="search-keybindings" name="search-keybindings">Search keybindings</a></h4> +<h4><a class="toc-backref" href="#id159" id="search-keybindings" name="search-keybindings">Search keybindings</a></h4> <table border="1" class="docutils"> <colgroup> <col width="29%" /> @@ -3694,7 +3713,7 @@ </table> </div> <div class="section"> -<h4><a class="toc-backref" href="#id159" id="go-to-keybindings" name="go-to-keybindings">Go to keybindings</a></h4> +<h4><a class="toc-backref" href="#id160" id="go-to-keybindings" name="go-to-keybindings">Go to keybindings</a></h4> <table border="1" class="docutils"> <colgroup> <col width="29%" /> @@ -3792,7 +3811,7 @@ </table> </div> <div class="section"> -<h4><a class="toc-backref" href="#id160" id="view-keybindings" name="view-keybindings">View keybindings</a></h4> +<h4><a class="toc-backref" href="#id161" id="view-keybindings" name="view-keybindings">View keybindings</a></h4> <table border="1" class="docutils"> <colgroup> <col width="29%" /> @@ -3841,7 +3860,7 @@ </table> </div> <div class="section"> -<h4><a class="toc-backref" href="#id161" id="focus-keybindings" name="focus-keybindings">Focus keybindings</a></h4> +<h4><a class="toc-backref" href="#id162" id="focus-keybindings" name="focus-keybindings">Focus keybindings</a></h4> <table border="1" class="docutils"> <colgroup> <col width="30%" /> @@ -3904,7 +3923,7 @@ </table> </div> <div class="section"> -<h4><a class="toc-backref" href="#id162" id="notebook-tab-keybindings" name="notebook-tab-keybindings">Notebook tab keybindings</a></h4> +<h4><a class="toc-backref" href="#id163" id="notebook-tab-keybindings" name="notebook-tab-keybindings">Notebook tab keybindings</a></h4> <table border="1" class="docutils"> <colgroup> <col width="28%" /> @@ -3958,7 +3977,7 @@ </table> </div> <div class="section"> -<h4><a class="toc-backref" href="#id163" id="document-keybindings" name="document-keybindings">Document keybindings</a></h4> +<h4><a class="toc-backref" href="#id164" id="document-keybindings" name="document-keybindings">Document keybindings</a></h4> <table border="1" class="docutils"> <colgroup> <col width="29%" /> @@ -4020,7 +4039,7 @@ </table> </div> <div class="section"> -<h4><a class="toc-backref" href="#id164" id="build-keybindings" name="build-keybindings">Build keybindings</a></h4> +<h4><a class="toc-backref" href="#id165" id="build-keybindings" name="build-keybindings">Build keybindings</a></h4> <table border="1" class="docutils"> <colgroup> <col width="29%" /> @@ -4078,7 +4097,7 @@ </table> </div> <div class="section"> -<h4><a class="toc-backref" href="#id165" id="tools-keybindings" name="tools-keybindings">Tools keybindings</a></h4> +<h4><a class="toc-backref" href="#id166" id="tools-keybindings" name="tools-keybindings">Tools keybindings</a></h4> <table border="1" class="docutils"> <colgroup> <col width="29%" /> @@ -4100,7 +4119,7 @@ </table> </div> <div class="section"> -<h4><a class="toc-backref" href="#id166" id="help-keybindings" name="help-keybindings">Help keybindings</a></h4> +<h4><a class="toc-backref" href="#id167" id="help-keybindings" name="help-keybindings">Help keybindings</a></h4> <table border="1" class="docutils"> <colgroup> <col width="29%" /> @@ -4125,13 +4144,13 @@ </div> </div> <div class="section"> -<h1><a class="toc-backref" href="#id167" id="id4" name="id4">Configuration files</a></h1> +<h1><a class="toc-backref" href="#id168" id="id4" name="id4">Configuration files</a></h1> <div class="warning"> <p class="first admonition-title">Warning</p> <p class="last">You must use UTF-8 encoding <em>without BOM</em> for configuration files.</p> </div> <div class="section"> -<h2><a class="toc-backref" href="#id168" id="tools-menu-items" name="tools-menu-items">Tools menu items</a></h2> +<h2><a class="toc-backref" href="#id169" id="tools-menu-items" name="tools-menu-items">Tools menu items</a></h2> <p>There's a <em>Configuration files</em> submenu in the <em>Tools</em> menu that contains items for some of the available user configuration files. Clicking on one opens it in the editor for you to update. Geany will @@ -4154,7 +4173,7 @@ </div> </div> <div class="section"> -<h2><a class="toc-backref" href="#id169" id="global-configuration-file" name="global-configuration-file">Global configuration file</a></h2> +<h2><a class="toc-backref" href="#id170" id="global-configuration-file" name="global-configuration-file">Global configuration file</a></h2> <p>There is a global configuration file for Geany which will be used for any settings not defined in the users local configuration file. Settings present in the local configuration file override those in the global @@ -4174,13 +4193,13 @@ </div> </div> <div class="section"> -<h2><a class="toc-backref" href="#id170" id="filetype-definition-files" name="filetype-definition-files">Filetype definition files</a></h2> +<h2><a class="toc-backref" href="#id171" id="filetype-definition-files" name="filetype-definition-files">Filetype definition files</a></h2> <p>All color definitions and other filetype specific settings are stored in the filetype definition files. Those settings are colors for syntax highlighting, general settings like comment characters or word delimiter characters as well as compiler and linker settings.</p> <div class="section"> -<h3><a class="toc-backref" href="#id171" id="custom-filetypes" name="custom-filetypes">Custom filetypes</a></h3> +<h3><a class="toc-backref" href="#id172" id="custom-filetypes" name="custom-filetypes">Custom filetypes</a></h3> <p>At startup Geany looks for <tt class="docutils literal"><span class="pre">filetypes.*.conf</span></tt> files in the system and user filetype paths, adding any filetypes found with the name matching the '<tt class="docutils literal"><span class="pre">*</span></tt>' wildcard.</p> @@ -4207,7 +4226,7 @@ </ul> </div> <div class="section"> -<h3><a class="toc-backref" href="#id172" id="system-files" name="system-files">System files</a></h3> +<h3><a class="toc-backref" href="#id173" id="system-files" name="system-files">System files</a></h3> <p>The system-wide configuration files can be found in <tt class="docutils literal"><span class="pre">$prefix/share/geany</span></tt> and are called <tt class="docutils literal"><span class="pre">filetypes.$ext</span></tt>, where <tt class="docutils literal"><span class="pre">$prefix</span></tt> is the path where Geany is installed (see @@ -4222,7 +4241,7 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id173" id="user-files" name="user-files">User files</a></h3> +<h3><a class="toc-backref" href="#id174" id="user-files" name="user-files">User files</a></h3> <p>To change the settings, copy a file from <tt class="docutils literal"><span class="pre">$prefix/share/geany</span></tt> to the subdirectory filedefs in your configuration directory (usually <tt class="docutils literal"><span class="pre">~/.config/geany/</span></tt>).</p> @@ -4240,9 +4259,9 @@ a [build-menu] section as described in <a class="reference" href="#build-menu-section">[build-menu] Section</a>.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id174" id="format" name="format">Format</a></h3> +<h3><a class="toc-backref" href="#id175" id="format" name="format">Format</a></h3> <div class="section"> -<h4><a class="toc-backref" href="#id175" id="styling-section" name="styling-section">[styling] Section</a></h4> +<h4><a class="toc-backref" href="#id176" id="styling-section" name="styling-section">[styling] Section</a></h4> <p>In this section the colors for syntax highlighting are defined. The manual format is:</p> <ul class="simple"> @@ -4258,7 +4277,7 @@ <p>This makes the key style have red foreground text, default background color text and bold emphasis.</p> <div class="section"> -<h5><a class="toc-backref" href="#id176" id="using-a-named-style" name="using-a-named-style">Using a named style</a></h5> +<h5><a class="toc-backref" href="#id177" id="using-a-named-style" name="using-a-named-style">Using a named style</a></h5> <p>The second format uses a <em>named style</em> name to reference a style defined in filetypes.common.</p> <ul class="simple"> @@ -4277,7 +4296,7 @@ </div> </div> <div class="section"> -<h4><a class="toc-backref" href="#id177" id="keywords-section" name="keywords-section">[keywords] Section</a></h4> +<h4><a class="toc-backref" href="#id178" id="keywords-section" name="keywords-section">[keywords] Section</a></h4> <p>This section contains keys for different keyword lists specific to the filetype. Some filetypes do not support keywords, so adding a new key will not work. You can only add or remove keywords to/from @@ -4288,12 +4307,12 @@ </div> </div> <div class="section"> -<h4><a class="toc-backref" href="#id178" id="lexer-properties-section" name="lexer-properties-section">[lexer_properties] Section</a></h4> +<h4><a class="toc-backref" href="#id179" id="lexer-properties-section" name="lexer-properties-section">[lexer_properties] Section</a></h4> <p>Here any special properties for the Scintilla lexer can be set in the format <tt class="docutils literal"><span class="pre">key.name.field=some.value</span></tt>.</p> </div> <div class="section"> -<h4><a class="toc-backref" href="#id179" id="settings-section" name="settings-section">[settings] Section</a></h4> +<h4><a class="toc-backref" href="#id180" id="settings-section" name="settings-section">[settings] Section</a></h4> <dl class="docutils"> <dt>extension</dt> <dd><p class="first">This is the default file extension used when saving files, not @@ -4389,7 +4408,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id180" id="build-settings-section" name="build-settings-section">[build_settings] Section</a></h4> +<h4><a class="toc-backref" href="#id181" id="build-settings-section" name="build-settings-section">[build_settings] Section</a></h4> <p>As of Geany 0.19 this section is supplemented by the <a class="reference" href="#build-menu-section">[build-menu] Section</a>. Values that are set in the [build-menu] section will override those in this section.</p> <dl class="docutils"> @@ -4442,13 +4461,13 @@ </div> </div> <div class="section"> -<h3><a class="toc-backref" href="#id181" id="special-file-filetypes-common" name="special-file-filetypes-common">Special file filetypes.common</a></h3> +<h3><a class="toc-backref" href="#id182" id="special-file-filetypes-common" name="special-file-filetypes-common">Special file filetypes.common</a></h3> <p>There is a special filetype definition file called filetypes.common. This file defines some general non-filetype-specific settings.</p> <p>See the <a class="reference" href="#format">Format</a> section for how to define styles.</p> <div class="section"> -<h4><a class="toc-backref" href="#id182" id="named-styles-section" name="named-styles-section">[named_styles] Section</a></h4> +<h4><a class="toc-backref" href="#id183" id="named-styles-section" name="named-styles-section">[named_styles] Section</a></h4> <p>Named styles declared here can be used in the [styling] section of any filetypes.* file.</p> <p>For example:</p> @@ -4473,7 +4492,7 @@ </div> </div> <div class="section"> -<h4><a class="toc-backref" href="#id183" id="id5" name="id5">[styling] Section</a></h4> +<h4><a class="toc-backref" href="#id184" id="id5" name="id5">[styling] Section</a></h4> <dl class="docutils"> <dt>default</dt> <dd><p class="first">This is the default style. It is used for styling files without a @@ -4657,7 +4676,7 @@ </dl> </div> <div class="section"> -<h4><a class="toc-backref" href="#id184" id="id6" name="id6">[settings] Section</a></h4> +<h4><a class="toc-backref" href="#id185" id="id6" name="id6">[settings] Section</a></h4> <dl class="docutils"> <dt>whitespace_chars</dt> <dd><p class="first">Characters to treat as whitespace. These characters are ignored @@ -4671,7 +4690,7 @@ </div> </div> <div class="section"> -<h2><a class="toc-backref" href="#id185" id="filetype-extensions" name="filetype-extensions">Filetype extensions</a></h2> +<h2><a class="toc-backref" href="#id186" id="filetype-extensions" name="filetype-extensions">Filetype extensions</a></h2> <p>To change the default filetype extension used when saving a new file, see <a class="reference" href="#filetype-definition-files">Filetype definition files</a>.</p> <p>You can override the list of file extensions that Geany uses for each @@ -4697,13 +4716,13 @@ </pre> </div> <div class="section"> -<h2><a class="toc-backref" href="#id186" id="preferences-file-format" name="preferences-file-format">Preferences File Format</a></h2> +<h2><a class="toc-backref" href="#id187" id="preferences-file-format" name="preferences-file-format">Preferences File Format</a></h2> <p>The preferences file <tt class="docutils literal"><span class="pre">~/.config/geany/geany.conf</span></tt> holds settings for all the items configured in the preferences dialog. This file should not be edited while Geany is running as the file will be overwritten when the preferences in Geany are changed or Geany is quitted.</p> <div class="section"> -<h3><a class="toc-backref" href="#id187" id="hidden-preferences" name="hidden-preferences">Hidden preferences</a></h3> +<h3><a class="toc-backref" href="#id188" id="hidden-preferences" name="hidden-preferences">Hidden preferences</a></h3> <p>There are some rarely used preferences that are not shown in the Preferences dialog. These can be set by editing the preferences file, then restarting Geany. Search for the key name, then edit the value. Example:</p> @@ -4911,7 +4930,7 @@ </table> </div> <div class="section"> -<h3><a class="toc-backref" href="#id188" id="build-menu-section" name="build-menu-section">[build-menu] Section</a></h3> +<h3><a class="toc-backref" href="#id189" id="build-menu-section" name="build-menu-section">[build-menu] Section</a></h3> <p>The [build-menu] section contains the configuration of the build menu. This section can occur in filetype, preferences and project files and always has the format described here. Different menu items are loaded @@ -4943,11 +4962,11 @@ </div> </div> <div class="section"> -<h2><a class="toc-backref" href="#id189" id="project-file-format" name="project-file-format">Project File Format</a></h2> +<h2><a class="toc-backref" href="#id190" id="project-file-format" name="project-file-format">Project File Format</a></h2> <p>The project file contains project related settings and possibly a record of the current session files.</p> <div class="section"> -<h3><a class="toc-backref" href="#id190" id="build-menu-additions" name="build-menu-additions">[build-menu] Additions</a></h3> +<h3><a class="toc-backref" href="#id191" id="build-menu-additions" name="build-menu-additions">[build-menu] Additions</a></h3> <p>The project file also can have extra fields in the [build-menu] section in addition to those listed in <a class="reference" href="#build-menu-section">[build-menu] Section</a> above.</p> <p>When filetype menu items are configured for the project they are stored @@ -4963,7 +4982,7 @@ </div> </div> <div class="section"> -<h2><a class="toc-backref" href="#id191" id="templates" name="templates">Templates</a></h2> +<h2><a class="toc-backref" href="#id192" id="templates" name="templates">Templates</a></h2> <p>Geany supports the following templates:</p> <ul class="simple"> <li>ChangeLog entry</li> @@ -4992,7 +5011,7 @@ also force this by selecting <em>Tools->Reload Configuration</em>.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id192" id="template-meta-data" name="template-meta-data">Template meta data</a></h3> +<h3><a class="toc-backref" href="#id193" id="template-meta-data" name="template-meta-data">Template meta data</a></h3> <p>Meta data can be used with all templates, but by default user set meta data is only used for the ChangeLog and File header templates.</p> <p>In the configuration dialog you can find a tab "Templates" (see @@ -5001,7 +5020,7 @@ <em>Tools->Reload Configuration</em> or restart Geany after making changes.</p> </div> <div class="section"> -<h3><a class="toc-backref" href="#id193" id="file-templates" name="file-templates">File templates</a></h3> +<h3><a class="toc-backref" href="#id194" id="file-templates" name="file-templates">File templates</a></h3> <p>File templates are templates used as the basis of a new file. To use them, choose the <em>New (with Template)</em> menu item from the <em>File</em> menu.</p> @@ -5013,7 +5032,7 @@ wildcard can be placed anywhere, but it's usually put on the first line of the file, followed by a blank line.</p> <div class="section"> -<h4><a class="toc-backref" href="#id194" id="custom-file-templates" name="custom-file-templates">Custom file templates</a></h4> +<h4><a class="toc-backref" href="#id195" id="custom-file-templates" name="custom-file-templates">Custom file templates</a></h4> <p>These are read from the following directories:</p> <ul class="simple"> <li><tt class="docutils literal"><span class="pre">$prefix/share/geany/templates/files</span></tt> (see <a class="reference" href="#installation-prefix">Installation prefix</a>)</li> @@ -5027,7 +5046,7 @@ @@ Diff output truncated at 100000 characters. @@ This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

1 0

SF.net SVN: geany:[5275] trunk
by ntrel＠users.sourceforge.net 04 Oct '10

04 Oct '10

Revision: 5275 http://geany.svn.sourceforge.net/geany/?rev=5275&view=rev Author: ntrel Date: 2010-10-04 10:51:03 +0000 (Mon, 04 Oct 2010) Log Message: ----------- Add some subheadings for Snippets section. Modified Paths: -------------- trunk/ChangeLog trunk/doc/geany.html trunk/doc/geany.txt Modified: trunk/ChangeLog =================================================================== --- trunk/ChangeLog 2010-10-04 10:41:06 UTC (rev 5274) +++ trunk/ChangeLog 2010-10-04 10:51:03 UTC (rev 5275) @@ -1,11 +1,3 @@ -2010-10-02 Enrico Tröger <enrico(dot)troeger(at)uvena(dot)de> - - * src/templates.c: - Strip the output of {command: } templates (closes #3079063). - * doc/geany.txt, doc/geany.html: - Document hidden msgwin_*_visible preferences. - - 2010-10-01 Nick Treleaven <nick(dot)treleaven(at)btinternet(dot)com> * src/tools.c, doc/geany.txt, doc/geany.html: @@ -14,6 +6,8 @@ * src/editor.c: Add snippet keybinding support for keys in user snippets.conf (based on patch by Eugene Arshinov, thanks). No docs yet. + * doc/geany.txt, doc/geany.html: + Add some subheadings for Snippets section. 2010-09-30 Nick Treleaven <nick(dot)treleaven(at)btinternet(dot)com> Modified: trunk/doc/geany.html =================================================================== --- trunk/doc/geany.html 2010-10-04 10:41:06 UTC (rev 5274) +++ trunk/doc/geany.html 2010-10-04 10:51:03 UTC (rev 5275) @@ -3,7 +3,7 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> -<meta name="generator" content="Docutils 0.7: http://docutils.sourceforge.net/" /> +<meta name="generator" content="Docutils 0.4: http://docutils.sourceforge.net/" /> <title>Geany</title> <meta name="authors" content="Enrico Tröger Nick Treleaven Frank Lanitz" /> <meta name="date" content="2010-10-01" /> @@ -149,340 +149,340 @@ License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. A copy of this license can be found in the file COPYING included with the source code -of this program, and also in the chapter <a class="reference internal" href="#gnu-general-public-license">GNU General Public License</a>.</p> -<div class="contents topic" id="contents"> -<p class="topic-title first">Contents</p> +of this program, and also in the chapter <a class="reference" href="#gnu-general-public-license">GNU General Public License</a>.</p> +<div class="contents topic"> +<p class="topic-title first"><a id="contents" name="contents">Contents</a></p> <ul class="simple"> -<li><a class="reference internal" href="#introduction" id="id8">Introduction</a><ul> -<li><a class="reference internal" href="#about-geany" id="id9">About Geany</a></li> -<li><a class="reference internal" href="#where-to-get-it" id="id10">Where to get it</a></li> -<li><a class="reference internal" href="#license" id="id11">License</a></li> -<li><a class="reference internal" href="#about-this-document" id="id12">About this document</a></li> +<li><a class="reference" href="#introduction" id="id8" name="id8">Introduction</a><ul> +<li><a class="reference" href="#about-geany" id="id9" name="id9">About Geany</a></li> +<li><a class="reference" href="#where-to-get-it" id="id10" name="id10">Where to get it</a></li> +<li><a class="reference" href="#license" id="id11" name="id11">License</a></li> +<li><a class="reference" href="#about-this-document" id="id12" name="id12">About this document</a></li> </ul> </li> -<li><a class="reference internal" href="#installation" id="id13">Installation</a><ul> -<li><a class="reference internal" href="#requirements" id="id14">Requirements</a></li> -<li><a class="reference internal" href="#binary-packages" id="id15">Binary packages</a></li> -<li><a class="reference internal" href="#source-compilation" id="id16">Source compilation</a><ul> -<li><a class="reference internal" href="#autotools-based-build-system" id="id17">Autotools based build system</a></li> -<li><a class="reference internal" href="#waf-based-build-system" id="id18">Waf based build system</a><ul> -<li><a class="reference internal" href="#waf-cache" id="id19">Waf Cache</a><ul> -<li><a class="reference internal" href="#cleaning-the-cache" id="id20">Cleaning the Cache</a></li> +<li><a class="reference" href="#installation" id="id13" name="id13">Installation</a><ul> +<li><a class="reference" href="#requirements" id="id14" name="id14">Requirements</a></li> +<li><a class="reference" href="#binary-packages" id="id15" name="id15">Binary packages</a></li> +<li><a class="reference" href="#source-compilation" id="id16" name="id16">Source compilation</a><ul> +<li><a class="reference" href="#autotools-based-build-system" id="id17" name="id17">Autotools based build system</a></li> +<li><a class="reference" href="#waf-based-build-system" id="id18" name="id18">Waf based build system</a><ul> +<li><a class="reference" href="#waf-cache" id="id19" name="id19">Waf Cache</a><ul> +<li><a class="reference" href="#cleaning-the-cache" id="id20" name="id20">Cleaning the Cache</a></li> </ul> </li> </ul> </li> -<li><a class="reference internal" href="#custom-installation" id="id21">Custom installation</a></li> -<li><a class="reference internal" href="#dynamic-linking-loader-support-and-vte" id="id22">Dynamic linking loader support and VTE</a></li> -<li><a class="reference internal" href="#build-problems" id="id23">Build problems</a></li> +<li><a class="reference" href="#custom-installation" id="id21" name="id21">Custom installation</a></li> +<li><a class="reference" href="#dynamic-linking-loader-support-and-vte" id="id22" name="id22">Dynamic linking loader support and VTE</a></li> +<li><a class="reference" href="#build-problems" id="id23" name="id23">Build problems</a></li> </ul> </li> -<li><a class="reference internal" href="#installation-prefix" id="id24">Installation prefix</a></li> +<li><a class="reference" href="#installation-prefix" id="id24" name="id24">Installation prefix</a></li> </ul> </li> -<li><a class="reference internal" href="#usage" id="id25">Usage</a><ul> -<li><a class="reference internal" href="#getting-started" id="id26">Getting started</a></li> -<li><a class="reference internal" href="#the-geany-workspace" id="id27">The Geany workspace</a></li> -<li><a class="reference internal" href="#command-line-options" id="id28">Command line options</a></li> -<li><a class="reference internal" href="#general" id="id29">General</a><ul> -<li><a class="reference internal" href="#startup" id="id30">Startup</a></li> -<li><a class="reference internal" href="#opening-files-from-the-command-line-in-a-running-instance" id="id31">Opening files from the command-line in a running instance</a></li> -<li><a class="reference internal" href="#virtual-terminal-emulator-widget-vte" id="id32">Virtual terminal emulator widget (VTE)</a></li> -<li><a class="reference internal" href="#defining-own-widget-styles-using-gtkrc-2-0" id="id33">Defining own widget styles using .gtkrc-2.0</a></li> +<li><a class="reference" href="#usage" id="id25" name="id25">Usage</a><ul> +<li><a class="reference" href="#getting-started" id="id26" name="id26">Getting started</a></li> +<li><a class="reference" href="#the-geany-workspace" id="id27" name="id27">The Geany workspace</a></li> +<li><a class="reference" href="#command-line-options" id="id28" name="id28">Command line options</a></li> +<li><a class="reference" href="#general" id="id29" name="id29">General</a><ul> +<li><a class="reference" href="#startup" id="id30" name="id30">Startup</a></li> +<li><a class="reference" href="#opening-files-from-the-command-line-in-a-running-instance" id="id31" name="id31">Opening files from the command-line in a running instance</a></li> +<li><a class="reference" href="#virtual-terminal-emulator-widget-vte" id="id32" name="id32">Virtual terminal emulator widget (VTE)</a></li> +<li><a class="reference" href="#defining-own-widget-styles-using-gtkrc-2-0" id="id33" name="id33">Defining own widget styles using .gtkrc-2.0</a></li> </ul> </li> -<li><a class="reference internal" href="#documents" id="id34">Documents</a><ul> -<li><a class="reference internal" href="#switching-between-documents" id="id35">Switching between documents</a></li> +<li><a class="reference" href="#documents" id="id34" name="id34">Documents</a><ul> +<li><a class="reference" href="#switching-between-documents" id="id35" name="id35">Switching between documents</a></li> </ul> </li> -<li><a class="reference internal" href="#character-sets-and-unicode-byte-order-mark-bom" id="id36">Character sets and Unicode Byte-Order-Mark (BOM)</a><ul> -<li><a class="reference internal" href="#using-character-sets" id="id37">Using character sets</a></li> -<li><a class="reference internal" href="#in-file-encoding-specification" id="id38">In-file encoding specification</a></li> -<li><a class="reference internal" href="#special-encoding-none" id="id39">Special encoding "None"</a></li> -<li><a class="reference internal" href="#unicode-byte-order-mark-bom" id="id40">Unicode Byte-Order-Mark (BOM)</a></li> +<li><a class="reference" href="#character-sets-and-unicode-byte-order-mark-bom" id="id36" name="id36">Character sets and Unicode Byte-Order-Mark (BOM)</a><ul> +<li><a class="reference" href="#using-character-sets" id="id37" name="id37">Using character sets</a></li> +<li><a class="reference" href="#in-file-encoding-specification" id="id38" name="id38">In-file encoding specification</a></li> +<li><a class="reference" href="#special-encoding-none" id="id39" name="id39">Special encoding "None"</a></li> +<li><a class="reference" href="#unicode-byte-order-mark-bom" id="id40" name="id40">Unicode Byte-Order-Mark (BOM)</a></li> </ul> </li> -<li><a class="reference internal" href="#editing" id="id41">Editing</a><ul> -<li><a class="reference internal" href="#folding" id="id42">Folding</a></li> -<li><a class="reference internal" href="#column-mode-editing-rectangular-selections" id="id43">Column mode editing (rectangular selections)</a></li> -<li><a class="reference internal" href="#drag-and-drop-of-text" id="id44">Drag and drop of text</a></li> -<li><a class="reference internal" href="#indentation" id="id45">Indentation</a></li> -<li><a class="reference internal" href="#auto-indentation" id="id46">Auto-indentation</a></li> -<li><a class="reference internal" href="#bookmarks" id="id47">Bookmarks</a></li> -<li><a class="reference internal" href="#code-navigation-history" id="id48">Code navigation history</a></li> -<li><a class="reference internal" href="#sending-text-through-custom-commands" id="id49">Sending text through custom commands</a></li> -<li><a class="reference internal" href="#context-actions" id="id50">Context actions</a></li> -<li><a class="reference internal" href="#autocompletion" id="id51">Autocompletion</a><ul> -<li><a class="reference internal" href="#word-part-completion" id="id52">Word part completion</a></li> -<li><a class="reference internal" href="#scope-autocompletion" id="id53">Scope autocompletion</a></li> +<li><a class="reference" href="#editing" id="id41" name="id41">Editing</a><ul> +<li><a class="reference" href="#folding" id="id42" name="id42">Folding</a></li> +<li><a class="reference" href="#column-mode-editing-rectangular-selections" id="id43" name="id43">Column mode editing (rectangular selections)</a></li> +<li><a class="reference" href="#drag-and-drop-of-text" id="id44" name="id44">Drag and drop of text</a></li> +<li><a class="reference" href="#indentation" id="id45" name="id45">Indentation</a></li> +<li><a class="reference" href="#auto-indentation" id="id46" name="id46">Auto-indentation</a></li> +<li><a class="reference" href="#bookmarks" id="id47" name="id47">Bookmarks</a></li> +<li><a class="reference" href="#code-navigation-history" id="id48" name="id48">Code navigation history</a></li> +<li><a class="reference" href="#sending-text-through-custom-commands" id="id49" name="id49">Sending text through custom commands</a></li> +<li><a class="reference" href="#context-actions" id="id50" name="id50">Context actions</a></li> +<li><a class="reference" href="#autocompletion" id="id51" name="id51">Autocompletion</a><ul> +<li><a class="reference" href="#word-part-completion" id="id52" name="id52">Word part completion</a></li> +<li><a class="reference" href="#scope-autocompletion" id="id53" name="id53">Scope autocompletion</a></li> </ul> </li> -<li><a class="reference internal" href="#user-definable-snippets" id="id54">User-definable snippets</a></li> -<li><a class="reference internal" href="#inserting-unicode-characters" id="id55">Inserting Unicode characters</a></li> +<li><a class="reference" href="#user-definable-snippets" id="id54" name="id54">User-definable snippets</a></li> +<li><a class="reference" href="#inserting-unicode-characters" id="id55" name="id55">Inserting Unicode characters</a></li> </ul> </li> -<li><a class="reference internal" href="#search-replace-and-go-to" id="id56">Search, replace and go to</a><ul> -<li><a class="reference internal" href="#toolbar-entries" id="id57">Toolbar entries</a><ul> -<li><a class="reference internal" href="#search-bar" id="id58">Search bar</a></li> +<li><a class="reference" href="#search-replace-and-go-to" id="id56" name="id56">Search, replace and go to</a><ul> +<li><a class="reference" href="#toolbar-entries" id="id57" name="id57">Toolbar entries</a><ul> +<li><a class="reference" href="#search-bar" id="id58" name="id58">Search bar</a></li> </ul> </li> -<li><a class="reference internal" href="#find" id="id59">Find</a><ul> -<li><a class="reference internal" href="#matching-options" id="id60">Matching options</a></li> -<li><a class="reference internal" href="#find-all" id="id61">Find all</a></li> -<li><a class="reference internal" href="#change-font-in-search-dialog-text-fields" id="id62">Change font in search dialog text fields</a></li> +<li><a class="reference" href="#find" id="id59" name="id59">Find</a><ul> +<li><a class="reference" href="#matching-options" id="id60" name="id60">Matching options</a></li> +<li><a class="reference" href="#find-all" id="id61" name="id61">Find all</a></li> +<li><a class="reference" href="#change-font-in-search-dialog-text-fields" id="id62" name="id62">Change font in search dialog text fields</a></li> </ul> </li> -<li><a class="reference internal" href="#find-selection" id="id63">Find selection</a></li> -<li><a class="reference internal" href="#find-usage" id="id64">Find usage</a></li> -<li><a class="reference internal" href="#find-in-files" id="id65">Find in files</a><ul> -<li><a class="reference internal" href="#filtering-out-version-control-files" id="id66">Filtering out version control files</a></li> +<li><a class="reference" href="#find-selection" id="id63" name="id63">Find selection</a></li> +<li><a class="reference" href="#find-usage" id="id64" name="id64">Find usage</a></li> +<li><a class="reference" href="#find-in-files" id="id65" name="id65">Find in files</a><ul> +<li><a class="reference" href="#filtering-out-version-control-files" id="id66" name="id66">Filtering out version control files</a></li> </ul> </li> -<li><a class="reference internal" href="#replace" id="id67">Replace</a><ul> -<li><a class="reference internal" href="#replace-all" id="id68">Replace all</a></li> +<li><a class="reference" href="#replace" id="id67" name="id67">Replace</a><ul> +<li><a class="reference" href="#replace-all" id="id68" name="id68">Replace all</a></li> </ul> </li> -<li><a class="reference internal" href="#go-to-tag-definition" id="id69">Go to tag definition</a></li> -<li><a class="reference internal" href="#go-to-tag-declaration" id="id70">Go to tag declaration</a></li> -<li><a class="reference internal" href="#go-to-line" id="id71">Go to line</a></li> -<li><a class="reference internal" href="#regular-expressions" id="id72">Regular expressions</a></li> +<li><a class="reference" href="#go-to-tag-definition" id="id69" name="id69">Go to tag definition</a></li> +<li><a class="reference" href="#go-to-tag-declaration" id="id70" name="id70">Go to tag declaration</a></li> +<li><a class="reference" href="#go-to-line" id="id71" name="id71">Go to line</a></li> +<li><a class="reference" href="#regular-expressions" id="id72" name="id72">Regular expressions</a></li> </ul> </li> -<li><a class="reference internal" href="#tags" id="id73">Tags</a><ul> -<li><a class="reference internal" href="#workspace-tags" id="id74">Workspace tags</a></li> -<li><a class="reference internal" href="#global-tags" id="id75">Global tags</a><ul> -<li><a class="reference internal" href="#default-global-tags-files" id="id76">Default global tags files</a></li> -<li><a class="reference internal" href="#global-tags-file-format" id="id77">Global tags file format</a></li> -<li><a class="reference internal" href="#generating-a-global-tags-file" id="id78">Generating a global tags file</a></li> +<li><a class="reference" href="#tags" id="id73" name="id73">Tags</a><ul> +<li><a class="reference" href="#workspace-tags" id="id74" name="id74">Workspace tags</a></li> +<li><a class="reference" href="#global-tags" id="id75" name="id75">Global tags</a><ul> +<li><a class="reference" href="#default-global-tags-files" id="id76" name="id76">Default global tags files</a></li> +<li><a class="reference" href="#global-tags-file-format" id="id77" name="id77">Global tags file format</a></li> +<li><a class="reference" href="#generating-a-global-tags-file" id="id78" name="id78">Generating a global tags file</a></li> </ul> </li> -<li><a class="reference internal" href="#ignore-tags" id="id79">Ignore tags</a></li> +<li><a class="reference" href="#ignore-tags" id="id79" name="id79">Ignore tags</a></li> </ul> </li> -<li><a class="reference internal" href="#preferences" id="id80">Preferences</a><ul> -<li><a class="reference internal" href="#general-startup-preferences" id="id81">General Startup preferences</a><ul> -<li><a class="reference internal" href="#id1" id="id82">Startup</a></li> -<li><a class="reference internal" href="#shutdown" id="id83">Shutdown</a></li> -<li><a class="reference internal" href="#paths" id="id84">Paths</a></li> +<li><a class="reference" href="#preferences" id="id80" name="id80">Preferences</a><ul> +<li><a class="reference" href="#general-startup-preferences" id="id81" name="id81">General Startup preferences</a><ul> +<li><a class="reference" href="#id1" id="id82" name="id82">Startup</a></li> +<li><a class="reference" href="#shutdown" id="id83" name="id83">Shutdown</a></li> +<li><a class="reference" href="#paths" id="id84" name="id84">Paths</a></li> </ul> </li> -<li><a class="reference internal" href="#general-miscellaneous-preferences" id="id85">General Miscellaneous preferences</a><ul> -<li><a class="reference internal" href="#miscellaneous" id="id86">Miscellaneous</a></li> -<li><a class="reference internal" href="#search" id="id87">Search</a></li> -<li><a class="reference internal" href="#projects" id="id88">Projects</a></li> +<li><a class="reference" href="#general-miscellaneous-preferences" id="id85" name="id85">General Miscellaneous preferences</a><ul> +<li><a class="reference" href="#miscellaneous" id="id86" name="id86">Miscellaneous</a></li> +<li><a class="reference" href="#search" id="id87" name="id87">Search</a></li> +<li><a class="reference" href="#projects" id="id88" name="id88">Projects</a></li> </ul> </li> -<li><a class="reference internal" href="#interface-preferences" id="id89">Interface preferences</a><ul> -<li><a class="reference internal" href="#sidebar" id="id90">Sidebar</a></li> -<li><a class="reference internal" href="#fonts" id="id91">Fonts</a></li> -<li><a class="reference internal" href="#editor-tabs" id="id92">Editor tabs</a></li> -<li><a class="reference internal" href="#tab-positions" id="id93">Tab positions</a></li> -<li><a class="reference internal" href="#id2" id="id94">Miscellaneous</a></li> +<li><a class="reference" href="#interface-preferences" id="id89" name="id89">Interface preferences</a><ul> +<li><a class="reference" href="#sidebar" id="id90" name="id90">Sidebar</a></li> +<li><a class="reference" href="#fonts" id="id91" name="id91">Fonts</a></li> +<li><a class="reference" href="#editor-tabs" id="id92" name="id92">Editor tabs</a></li> +<li><a class="reference" href="#tab-positions" id="id93" name="id93">Tab positions</a></li> +<li><a class="reference" href="#id2" id="id94" name="id94">Miscellaneous</a></li> </ul> </li> -<li><a class="reference internal" href="#toolbar-preferences" id="id95">Toolbar preferences</a><ul> -<li><a class="reference internal" href="#toolbar" id="id96">Toolbar</a></li> -<li><a class="reference internal" href="#appearance" id="id97">Appearance</a></li> +<li><a class="reference" href="#toolbar-preferences" id="id95" name="id95">Toolbar preferences</a><ul> +<li><a class="reference" href="#toolbar" id="id96" name="id96">Toolbar</a></li> +<li><a class="reference" href="#appearance" id="id97" name="id97">Appearance</a></li> </ul> </li> -<li><a class="reference internal" href="#editor-features-preferences" id="id98">Editor Features preferences</a><ul> -<li><a class="reference internal" href="#features" id="id99">Features</a></li> +<li><a class="reference" href="#editor-features-preferences" id="id98" name="id98">Editor Features preferences</a><ul> +<li><a class="reference" href="#features" id="id99" name="id99">Features</a></li> </ul> </li> -<li><a class="reference internal" href="#editor-indentation-preferences" id="id100">Editor Indentation preferences</a><ul> -<li><a class="reference internal" href="#indentation-group" id="id101">Indentation group</a></li> +<li><a class="reference" href="#editor-indentation-preferences" id="id100" name="id100">Editor Indentation preferences</a><ul> +<li><a class="reference" href="#indentation-group" id="id101" name="id101">Indentation group</a></li> </ul> </li> -<li><a class="reference internal" href="#editor-completions-preferences" id="id102">Editor Completions preferences</a><ul> -<li><a class="reference internal" href="#completions" id="id103">Completions</a></li> -<li><a class="reference internal" href="#auto-close-quotes-and-brackets" id="id104">Auto-close quotes and brackets</a></li> +<li><a class="reference" href="#editor-completions-preferences" id="id102" name="id102">Editor Completions preferences</a><ul> +<li><a class="reference" href="#completions" id="id103" name="id103">Completions</a></li> +<li><a class="reference" href="#auto-close-quotes-and-brackets" id="id104" name="id104">Auto-close quotes and brackets</a></li> </ul> </li> -<li><a class="reference internal" href="#editor-display-preferences" id="id105">Editor Display preferences</a><ul> -<li><a class="reference internal" href="#display" id="id106">Display</a></li> -<li><a class="reference internal" href="#long-line-marker" id="id107">Long line marker</a></li> -<li><a class="reference internal" href="#virtual-spaces" id="id108">Virtual spaces</a></li> +<li><a class="reference" href="#editor-display-preferences" id="id105" name="id105">Editor Display preferences</a><ul> +<li><a class="reference" href="#display" id="id106" name="id106">Display</a></li> +<li><a class="reference" href="#long-line-marker" id="id107" name="id107">Long line marker</a></li> +<li><a class="reference" href="#virtual-spaces" id="id108" name="id108">Virtual spaces</a></li> </ul> </li> -<li><a class="reference internal" href="#files-preferences" id="id109">Files preferences</a><ul> -<li><a class="reference internal" href="#new-files" id="id110">New files</a></li> -<li><a class="reference internal" href="#saving-files" id="id111">Saving files</a></li> -<li><a class="reference internal" href="#id3" id="id112">Miscellaneous</a></li> +<li><a class="reference" href="#files-preferences" id="id109" name="id109">Files preferences</a><ul> +<li><a class="reference" href="#new-files" id="id110" name="id110">New files</a></li> +<li><a class="reference" href="#saving-files" id="id111" name="id111">Saving files</a></li> +<li><a class="reference" href="#id3" id="id112" name="id112">Miscellaneous</a></li> </ul> </li> -<li><a class="reference internal" href="#tools-preferences" id="id113">Tools preferences</a><ul> -<li><a class="reference internal" href="#tool-paths" id="id114">Tool paths</a></li> -<li><a class="reference internal" href="#commands" id="id115">Commands</a></li> +<li><a class="reference" href="#tools-preferences" id="id113" name="id113">Tools preferences</a><ul> +<li><a class="reference" href="#tool-paths" id="id114" name="id114">Tool paths</a></li> +<li><a class="reference" href="#commands" id="id115" name="id115">Commands</a></li> </ul> </li> -<li><a class="reference internal" href="#template-preferences" id="id116">Template preferences</a><ul> -<li><a class="reference internal" href="#template-data" id="id117">Template data</a></li> +<li><a class="reference" href="#template-preferences" id="id116" name="id116">Template preferences</a><ul> +<li><a class="reference" href="#template-data" id="id117" name="id117">Template data</a></li> </ul> </li> -<li><a class="reference internal" href="#keybinding-preferences" id="id118">Keybinding preferences</a></li> -<li><a class="reference internal" href="#printing-preferences" id="id119">Printing preferences</a></li> -<li><a class="reference internal" href="#terminal-vte-preferences" id="id120">Terminal (VTE) preferences</a><ul> -<li><a class="reference internal" href="#terminal-widget" id="id121">Terminal widget</a></li> +<li><a class="reference" href="#keybinding-preferences" id="id118" name="id118">Keybinding preferences</a></li> +<li><a class="reference" href="#printing-preferences" id="id119" name="id119">Printing preferences</a></li> +<li><a class="reference" href="#terminal-vte-preferences" id="id120" name="id120">Terminal (VTE) preferences</a><ul> +<li><a class="reference" href="#terminal-widget" id="id121" name="id121">Terminal widget</a></li> </ul> </li> </ul> </li> -<li><a class="reference internal" href="#project-management" id="id122">Project Management</a><ul> -<li><a class="reference internal" href="#new-project" id="id123">New Project</a></li> -<li><a class="reference internal" href="#project-properties" id="id124">Project Properties</a></li> -<li><a class="reference internal" href="#open-project" id="id125">Open Project</a></li> -<li><a class="reference internal" href="#close-project" id="id126">Close Project</a></li> +<li><a class="reference" href="#project-management" id="id122" name="id122">Project Management</a><ul> +<li><a class="reference" href="#new-project" id="id123" name="id123">New Project</a></li> +<li><a class="reference" href="#project-properties" id="id124" name="id124">Project Properties</a></li> +<li><a class="reference" href="#open-project" id="id125" name="id125">Open Project</a></li> +<li><a class="reference" href="#close-project" id="id126" name="id126">Close Project</a></li> </ul> </li> -<li><a class="reference internal" href="#build-menu" id="id127">Build Menu</a><ul> -<li><a class="reference internal" href="#indicators" id="id128">Indicators</a></li> -<li><a class="reference internal" href="#default-build-menu-items" id="id129">Default Build Menu Items</a><ul> -<li><a class="reference internal" href="#compile" id="id130">Compile</a></li> -<li><a class="reference internal" href="#build" id="id131">Build</a></li> -<li><a class="reference internal" href="#make" id="id132">Make</a></li> -<li><a class="reference internal" href="#make-custom-target" id="id133">Make custom target</a></li> -<li><a class="reference internal" href="#make-object" id="id134">Make object</a></li> -<li><a class="reference internal" href="#next-error" id="id135">Next Error</a></li> -<li><a class="reference internal" href="#previous-error" id="id136">Previous Error</a></li> -<li><a class="reference internal" href="#execute" id="id137">Execute</a></li> -<li><a class="reference internal" href="#stopping-running-processes" id="id138">Stopping running processes</a><ul> -<li><a class="reference internal" href="#terminal-emulators" id="id139">Terminal emulators</a></li> +<li><a class="reference" href="#build-menu" id="id127" name="id127">Build Menu</a><ul> +<li><a class="reference" href="#indicators" id="id128" name="id128">Indicators</a></li> +<li><a class="reference" href="#default-build-menu-items" id="id129" name="id129">Default Build Menu Items</a><ul> +<li><a class="reference" href="#compile" id="id130" name="id130">Compile</a></li> +<li><a class="reference" href="#build" id="id131" name="id131">Build</a></li> +<li><a class="reference" href="#make" id="id132" name="id132">Make</a></li> +<li><a class="reference" href="#make-custom-target" id="id133" name="id133">Make custom target</a></li> +<li><a class="reference" href="#make-object" id="id134" name="id134">Make object</a></li> +<li><a class="reference" href="#next-error" id="id135" name="id135">Next Error</a></li> +<li><a class="reference" href="#previous-error" id="id136" name="id136">Previous Error</a></li> +<li><a class="reference" href="#execute" id="id137" name="id137">Execute</a></li> +<li><a class="reference" href="#stopping-running-processes" id="id138" name="id138">Stopping running processes</a><ul> +<li><a class="reference" href="#terminal-emulators" id="id139" name="id139">Terminal emulators</a></li> </ul> </li> -<li><a class="reference internal" href="#set-build-commands" id="id140">Set Build Commands</a></li> +<li><a class="reference" href="#set-build-commands" id="id140" name="id140">Set Build Commands</a></li> </ul> </li> -<li><a class="reference internal" href="#build-menu-configuration" id="id141">Build Menu Configuration</a></li> -<li><a class="reference internal" href="#build-menu-commands-dialog" id="id142">Build Menu Commands Dialog</a><ul> -<li><a class="reference internal" href="#substitutions-in-commands-and-working-directories" id="id143">Substitutions in Commands and Working Directories</a></li> -<li><a class="reference internal" href="#build-menu-keyboard-shortcuts" id="id144">Build Menu Keyboard Shortcuts</a></li> -<li><a class="reference internal" href="#configuration-files" id="id145">Configuration Files</a></li> +<li><a class="reference" href="#build-menu-configuration" id="id141" name="id141">Build Menu Configuration</a></li> +<li><a class="reference" href="#build-menu-commands-dialog" id="id142" name="id142">Build Menu Commands Dialog</a><ul> +<li><a class="reference" href="#substitutions-in-commands-and-working-directories" id="id143" name="id143">Substitutions in Commands and Working Directories</a></li> +<li><a class="reference" href="#build-menu-keyboard-shortcuts" id="id144" name="id144">Build Menu Keyboard Shortcuts</a></li> +<li><a class="reference" href="#configuration-files" id="id145" name="id145">Configuration Files</a></li> </ul> </li> </ul> </li> -<li><a class="reference internal" href="#printing-support" id="id146">Printing support</a></li> -<li><a class="reference internal" href="#plugins" id="id147">Plugins</a></li> -<li><a class="reference internal" href="#keybindings" id="id148">Keybindings</a><ul> -<li><a class="reference internal" href="#switching-documents" id="id149">Switching documents</a></li> -<li><a class="reference internal" href="#configurable-keybindings" id="id150">Configurable keybindings</a><ul> -<li><a class="reference internal" href="#file-keybindings" id="id151">File keybindings</a></li> -<li><a class="reference internal" href="#editor-keybindings" id="id152">Editor keybindings</a></li> -<li><a class="reference internal" href="#clipboard-keybindings" id="id153">Clipboard keybindings</a></li> -<li><a class="reference internal" href="#select-keybindings" id="id154">Select keybindings</a></li> -<li><a class="reference internal" href="#insert-keybindings" id="id155">Insert keybindings</a></li> -<li><a class="reference internal" href="#format-keybindings" id="id156">Format keybindings</a></li> -<li><a class="reference internal" href="#settings-keybindings" id="id157">Settings keybindings</a></li> -<li><a class="reference internal" href="#search-keybindings" id="id158">Search keybindings</a></li> -<li><a class="reference internal" href="#go-to-keybindings" id="id159">Go to keybindings</a></li> -<li><a class="reference internal" href="#view-keybindings" id="id160">View keybindings</a></li> -<li><a class="reference internal" href="#focus-keybindings" id="id161">Focus keybindings</a></li> -<li><a class="reference internal" href="#notebook-tab-keybindings" id="id162">Notebook tab keybindings</a></li> -<li><a class="reference internal" href="#document-keybindings" id="id163">Document keybindings</a></li> -<li><a class="reference internal" href="#build-keybindings" id="id164">Build keybindings</a></li> -<li><a class="reference internal" href="#tools-keybindings" id="id165">Tools keybindings</a></li> -<li><a class="reference internal" href="#help-keybindings" id="id166">Help keybindings</a></li> +<li><a class="reference" href="#printing-support" id="id146" name="id146">Printing support</a></li> +<li><a class="reference" href="#plugins" id="id147" name="id147">Plugins</a></li> +<li><a class="reference" href="#keybindings" id="id148" name="id148">Keybindings</a><ul> +<li><a class="reference" href="#switching-documents" id="id149" name="id149">Switching documents</a></li> +<li><a class="reference" href="#configurable-keybindings" id="id150" name="id150">Configurable keybindings</a><ul> +<li><a class="reference" href="#file-keybindings" id="id151" name="id151">File keybindings</a></li> +<li><a class="reference" href="#editor-keybindings" id="id152" name="id152">Editor keybindings</a></li> +<li><a class="reference" href="#clipboard-keybindings" id="id153" name="id153">Clipboard keybindings</a></li> +<li><a class="reference" href="#select-keybindings" id="id154" name="id154">Select keybindings</a></li> +<li><a class="reference" href="#insert-keybindings" id="id155" name="id155">Insert keybindings</a></li> +<li><a class="reference" href="#format-keybindings" id="id156" name="id156">Format keybindings</a></li> +<li><a class="reference" href="#settings-keybindings" id="id157" name="id157">Settings keybindings</a></li> +<li><a class="reference" href="#search-keybindings" id="id158" name="id158">Search keybindings</a></li> +<li><a class="reference" href="#go-to-keybindings" id="id159" name="id159">Go to keybindings</a></li> +<li><a class="reference" href="#view-keybindings" id="id160" name="id160">View keybindings</a></li> +<li><a class="reference" href="#focus-keybindings" id="id161" name="id161">Focus keybindings</a></li> +<li><a class="reference" href="#notebook-tab-keybindings" id="id162" name="id162">Notebook tab keybindings</a></li> +<li><a class="reference" href="#document-keybindings" id="id163" name="id163">Document keybindings</a></li> +<li><a class="reference" href="#build-keybindings" id="id164" name="id164">Build keybindings</a></li> +<li><a class="reference" href="#tools-keybindings" id="id165" name="id165">Tools keybindings</a></li> +<li><a class="reference" href="#help-keybindings" id="id166" name="id166">Help keybindings</a></li> </ul> </li> </ul> </li> </ul> </li> -<li><a class="reference internal" href="#id4" id="id167">Configuration files</a><ul> -<li><a class="reference internal" href="#tools-menu-items" id="id168">Tools menu items</a></li> -<li><a class="reference internal" href="#global-configuration-file" id="id169">Global configuration file</a></li> -<li><a class="reference internal" href="#filetype-definition-files" id="id170">Filetype definition files</a><ul> -<li><a class="reference internal" href="#custom-filetypes" id="id171">Custom filetypes</a></li> -<li><a class="reference internal" href="#system-files" id="id172">System files</a></li> -<li><a class="reference internal" href="#user-files" id="id173">User files</a></li> -<li><a class="reference internal" href="#format" id="id174">Format</a><ul> -<li><a class="reference internal" href="#styling-section" id="id175">[styling] Section</a><ul> -<li><a class="reference internal" href="#using-a-named-style" id="id176">Using a named style</a></li> +<li><a class="reference" href="#id4" id="id167" name="id167">Configuration files</a><ul> +<li><a class="reference" href="#tools-menu-items" id="id168" name="id168">Tools menu items</a></li> +<li><a class="reference" href="#global-configuration-file" id="id169" name="id169">Global configuration file</a></li> +<li><a class="reference" href="#filetype-definition-files" id="id170" name="id170">Filetype definition files</a><ul> +<li><a class="reference" href="#custom-filetypes" id="id171" name="id171">Custom filetypes</a></li> +<li><a class="reference" href="#system-files" id="id172" name="id172">System files</a></li> +<li><a class="reference" href="#user-files" id="id173" name="id173">User files</a></li> +<li><a class="reference" href="#format" id="id174" name="id174">Format</a><ul> +<li><a class="reference" href="#styling-section" id="id175" name="id175">[styling] Section</a><ul> +<li><a class="reference" href="#using-a-named-style" id="id176" name="id176">Using a named style</a></li> </ul> </li> -<li><a class="reference internal" href="#keywords-section" id="id177">[keywords] Section</a></li> -<li><a class="reference internal" href="#lexer-properties-section" id="id178">[lexer_properties] Section</a></li> -<li><a class="reference internal" href="#settings-section" id="id179">[settings] Section</a></li> -<li><a class="reference internal" href="#build-settings-section" id="id180">[build_settings] Section</a></li> +<li><a class="reference" href="#keywords-section" id="id177" name="id177">[keywords] Section</a></li> +<li><a class="reference" href="#lexer-properties-section" id="id178" name="id178">[lexer_properties] Section</a></li> +<li><a class="reference" href="#settings-section" id="id179" name="id179">[settings] Section</a></li> +<li><a class="reference" href="#build-settings-section" id="id180" name="id180">[build_settings] Section</a></li> </ul> </li> -<li><a class="reference internal" href="#special-file-filetypes-common" id="id181">Special file filetypes.common</a><ul> -<li><a class="reference internal" href="#named-styles-section" id="id182">[named_styles] Section</a></li> -<li><a class="reference internal" href="#id5" id="id183">[styling] Section</a></li> -<li><a class="reference internal" href="#id6" id="id184">[settings] Section</a></li> +<li><a class="reference" href="#special-file-filetypes-common" id="id181" name="id181">Special file filetypes.common</a><ul> +<li><a class="reference" href="#named-styles-section" id="id182" name="id182">[named_styles] Section</a></li> +<li><a class="reference" href="#id5" id="id183" name="id183">[styling] Section</a></li> +<li><a class="reference" href="#id6" id="id184" name="id184">[settings] Section</a></li> </ul> </li> </ul> </li> -<li><a class="reference internal" href="#filetype-extensions" id="id185">Filetype extensions</a></li> -<li><a class="reference internal" href="#preferences-file-format" id="id186">Preferences File Format</a><ul> -<li><a class="reference internal" href="#hidden-preferences" id="id187">Hidden preferences</a></li> -<li><a class="reference internal" href="#build-menu-section" id="id188">[build-menu] Section</a></li> +<li><a class="reference" href="#filetype-extensions" id="id185" name="id185">Filetype extensions</a></li> +<li><a class="reference" href="#preferences-file-format" id="id186" name="id186">Preferences File Format</a><ul> +<li><a class="reference" href="#hidden-preferences" id="id187" name="id187">Hidden preferences</a></li> +<li><a class="reference" href="#build-menu-section" id="id188" name="id188">[build-menu] Section</a></li> </ul> </li> -<li><a class="reference internal" href="#project-file-format" id="id189">Project File Format</a><ul> -<li><a class="reference internal" href="#build-menu-additions" id="id190">[build-menu] Additions</a></li> +<li><a class="reference" href="#project-file-format" id="id189" name="id189">Project File Format</a><ul> +<li><a class="reference" href="#build-menu-additions" id="id190" name="id190">[build-menu] Additions</a></li> </ul> </li> -<li><a class="reference internal" href="#templates" id="id191">Templates</a><ul> -<li><a class="reference internal" href="#template-meta-data" id="id192">Template meta data</a></li> -<li><a class="reference internal" href="#file-templates" id="id193">File templates</a><ul> -<li><a class="reference internal" href="#custom-file-templates" id="id194">Custom file templates</a></li> -<li><a class="reference internal" href="#filetype-templates" id="id195">Filetype templates</a></li> +<li><a class="reference" href="#templates" id="id191" name="id191">Templates</a><ul> +<li><a class="reference" href="#template-meta-data" id="id192" name="id192">Template meta data</a></li> +<li><a class="reference" href="#file-templates" id="id193" name="id193">File templates</a><ul> +<li><a class="reference" href="#custom-file-templates" id="id194" name="id194">Custom file templates</a></li> +<li><a class="reference" href="#filetype-templates" id="id195" name="id195">Filetype templates</a></li> </ul> </li> -<li><a class="reference internal" href="#customizing-templates" id="id196">Customizing templates</a><ul> -<li><a class="reference internal" href="#template-wildcards" id="id197">Template wildcards</a><ul> -<li><a class="reference internal" href="#special-command-wildcard" id="id198">Special {command:} wildcard</a></li> +<li><a class="reference" href="#customizing-templates" id="id196" name="id196">Customizing templates</a><ul> +<li><a class="reference" href="#template-wildcards" id="id197" name="id197">Template wildcards</a><ul> +<li><a class="reference" href="#special-command-wildcard" id="id198" name="id198">Special {command:} wildcard</a></li> </ul> </li> </ul> </li> </ul> </li> -<li><a class="reference internal" href="#customizing-the-toolbar" id="id199">Customizing the toolbar</a><ul> -<li><a class="reference internal" href="#manually-editing-of-the-toolbar-layout" id="id200">Manually editing of the toolbar layout</a></li> -<li><a class="reference internal" href="#available-toolbar-elements" id="id201">Available toolbar elements</a></li> +<li><a class="reference" href="#customizing-the-toolbar" id="id199" name="id199">Customizing the toolbar</a><ul> +<li><a class="reference" href="#manually-editing-of-the-toolbar-layout" id="id200" name="id200">Manually editing of the toolbar layout</a></li> +<li><a class="reference" href="#available-toolbar-elements" id="id201" name="id201">Available toolbar elements</a></li> </ul> </li> </ul> </li> -<li><a class="reference internal" href="#plugin-documentation" id="id202">Plugin documentation</a><ul> -<li><a class="reference internal" href="#save-actions" id="id203">Save Actions</a><ul> -<li><a class="reference internal" href="#instant-save" id="id204">Instant Save</a></li> -<li><a class="reference internal" href="#backup-copy" id="id205">Backup Copy</a></li> +<li><a class="reference" href="#plugin-documentation" id="id202" name="id202">Plugin documentation</a><ul> +<li><a class="reference" href="#save-actions" id="id203" name="id203">Save Actions</a><ul> +<li><a class="reference" href="#instant-save" id="id204" name="id204">Instant Save</a></li> +<li><a class="reference" href="#backup-copy" id="id205" name="id205">Backup Copy</a></li> </ul> </li> </ul> </li> -<li><a class="reference internal" href="#contributing-to-this-document" id="id206">Contributing to this document</a></li> -<li><a class="reference internal" href="#scintilla-keyboard-commands" id="id207">Scintilla keyboard commands</a><ul> -<li><a class="reference internal" href="#keyboard-commands" id="id208">Keyboard commands</a></li> +<li><a class="reference" href="#contributing-to-this-document" id="id206" name="id206">Contributing to this document</a></li> +<li><a class="reference" href="#scintilla-keyboard-commands" id="id207" name="id207">Scintilla keyboard commands</a><ul> +<li><a class="reference" href="#keyboard-commands" id="id208" name="id208">Keyboard commands</a></li> </ul> </li> -<li><a class="reference internal" href="#tips-and-tricks" id="id209">Tips and tricks</a><ul> -<li><a class="reference internal" href="#document-notebook" id="id210">Document notebook</a></li> -<li><a class="reference internal" href="#editor" id="id211">Editor</a></li> -<li><a class="reference internal" href="#interface" id="id212">Interface</a></li> -<li><a class="reference internal" href="#gtk-related" id="id213">GTK-related</a></li> +<li><a class="reference" href="#tips-and-tricks" id="id209" name="id209">Tips and tricks</a><ul> +<li><a class="reference" href="#document-notebook" id="id210" name="id210">Document notebook</a></li> +<li><a class="reference" href="#editor" id="id211" name="id211">Editor</a></li> +<li><a class="reference" href="#interface" id="id212" name="id212">Interface</a></li> +<li><a class="reference" href="#gtk-related" id="id213" name="id213">GTK-related</a></li> </ul> </li> -<li><a class="reference internal" href="#compile-time-options" id="id214">Compile-time options</a><ul> -<li><a class="reference internal" href="#src-geany-h" id="id215">src/geany.h</a></li> -<li><a class="reference internal" href="#project-h" id="id216">project.h</a></li> -<li><a class="reference internal" href="#editor-h" id="id217">editor.h</a></li> -<li><a class="reference internal" href="#keyfile-c" id="id218">keyfile.c</a></li> -<li><a class="reference internal" href="#build-c" id="id219">build.c</a></li> +<li><a class="reference" href="#compile-time-options" id="id214" name="id214">Compile-time options</a><ul> +<li><a class="reference" href="#src-geany-h" id="id215" name="id215">src/geany.h</a></li> +<li><a class="reference" href="#project-h" id="id216" name="id216">project.h</a></li> +<li><a class="reference" href="#editor-h" id="id217" name="id217">editor.h</a></li> +<li><a class="reference" href="#keyfile-c" id="id218" name="id218">keyfile.c</a></li> +<li><a class="reference" href="#build-c" id="id219" name="id219">build.c</a></li> </ul> </li> -<li><a class="reference internal" href="#gnu-general-public-license" id="id220">GNU General Public License</a></li> -<li><a class="reference internal" href="#license-for-scintilla-and-scite" id="id221">License for Scintilla and SciTE</a></li> +<li><a class="reference" href="#gnu-general-public-license" id="id220" name="id220">GNU General Public License</a></li> +<li><a class="reference" href="#license-for-scintilla-and-scite" id="id221" name="id221">License for Scintilla and SciTE</a></li> </ul> </div> -<div class="section" id="introduction"> -<h1><a class="toc-backref" href="#id8">Introduction</a></h1> -<div class="section" id="about-geany"> -<h2><a class="toc-backref" href="#id9">About Geany</a></h2> +<div class="section"> +<h1><a class="toc-backref" href="#id8" id="introduction" name="introduction">Introduction</a></h1> +<div class="section"> +<h2><a class="toc-backref" href="#id9" id="about-geany" name="about-geany">About Geany</a></h2> <p>Geany is a small and lightweight Integrated Development Environment. It was developed to provide a small and fast IDE, which has only a few dependencies on other packages. Another goal was to be as independent @@ -505,56 +505,56 @@ <li>Plugin interface</li> </ul> </div> -<div class="section" id="where-to-get-it"> -<h2><a class="toc-backref" href="#id10">Where to get it</a></h2> -<p>You can obtain Geany from <a class="reference external" href="http://www.geany.org/">http://www.geany.org/</a> or perhaps also from +<div class="section"> +<h2><a class="toc-backref" href="#id10" id="where-to-get-it" name="where-to-get-it">Where to get it</a></h2> +<p>You can obtain Geany from <a class="reference" href="http://www.geany.org/">http://www.geany.org/</a> or perhaps also from your distribution. For a list of available packages, please see -<a class="reference external" href="http://www.geany.org/Download/ThirdPartyPackages">http://www.geany.org/Download/ThirdPartyPackages</a>.</p> +<a class="reference" href="http://www.geany.org/Download/ThirdPartyPackages">http://www.geany.org/Download/ThirdPartyPackages</a>.</p> </div> -<div class="section" id="license"> -<h2><a class="toc-backref" href="#id11">License</a></h2> +<div class="section"> +<h2><a class="toc-backref" href="#id11" id="license" name="license">License</a></h2> <p>Geany is distributed under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. A copy of this license can be found in the file COPYING included with the source -code of this program and in the chapter, <a class="reference internal" href="#gnu-general-public-license">GNU General Public License</a>.</p> +code of this program and in the chapter, <a class="reference" href="#gnu-general-public-license">GNU General Public License</a>.</p> <p>The included Scintilla library (found in the subdirectory -<tt class="docutils literal">scintilla/</tt>) has its own license, which can be found in the chapter, -<a class="reference internal" href="#license-for-scintilla-and-scite">License for Scintilla and SciTE</a>.</p> +<tt class="docutils literal"><span class="pre">scintilla/</span></tt>) has its own license, which can be found in the chapter, +<a class="reference" href="#license-for-scintilla-and-scite">License for Scintilla and SciTE</a>.</p> </div> -<div class="section" id="about-this-document"> -<h2><a class="toc-backref" href="#id12">About this document</a></h2> +<div class="section"> +<h2><a class="toc-backref" href="#id12" id="about-this-document" name="about-this-document">About this document</a></h2> <p>This documentation is available in HTML and text formats. -The latest version can always be found at <a class="reference external" href="http://www.geany.org/">http://www.geany.org/</a>.</p> -<p>If you want to contribute to it, see <a class="reference internal" href="#contributing-to-this-document">Contributing to this document</a>.</p> +The latest version can always be found at <a class="reference" href="http://www.geany.org/">http://www.geany.org/</a>.</p> +<p>If you want to contribute to it, see <a class="reference" href="#contributing-to-this-document">Contributing to this document</a>.</p> </div> </div> -<div class="section" id="installation"> -<h1><a class="toc-backref" href="#id13">Installation</a></h1> -<div class="section" id="requirements"> -<h2><a class="toc-backref" href="#id14">Requirements</a></h2> +<div class="section"> +<h1><a class="toc-backref" href="#id13" id="installation" name="installation">Installation</a></h1> +<div class="section"> +<h2><a class="toc-backref" href="#id14" id="requirements" name="requirements">Requirements</a></h2> <p>You will need the GTK (>= 2.8.0) libraries and their dependencies (Pango, GLib and ATK). Your distro should provide packages for these, usually installed by default. For Windows, you can download an installer from the website which bundles these libraries.</p> </div> -<div class="section" id="binary-packages"> -<h2><a class="toc-backref" href="#id15">Binary packages</a></h2> +<div class="section"> +<h2><a class="toc-backref" href="#id15" id="binary-packages" name="binary-packages">Binary packages</a></h2> <p>There are many binary packages available. For an up-to-date but maybe -incomplete list see <a class="reference external" href="http://www.geany.org/Download/ThirdPartyPackages">http://www.geany.org/Download/ThirdPartyPackages</a>.</p> +incomplete list see <a class="reference" href="http://www.geany.org/Download/ThirdPartyPackages">http://www.geany.org/Download/ThirdPartyPackages</a>.</p> </div> -<div class="section" id="source-compilation"> -<h2><a class="toc-backref" href="#id16">Source compilation</a></h2> +<div class="section"> +<h2><a class="toc-backref" href="#id16" id="source-compilation" name="source-compilation">Source compilation</a></h2> <p>Compiling Geany is quite easy. To do so, you need the GTK (>= 2.8.0) libraries and header files. You also need the Pango, GLib and ATK libraries and header files. -All these files are available at <a class="reference external" href="http://www.gtk.org">http://www.gtk.org</a>, but very often +All these files are available at <a class="reference" href="http://www.gtk.org">http://www.gtk.org</a>, but very often your distro will provide development packages to save the trouble of building these yourself.</p> <p>Furthermore you need, of course, a C and C++ compiler. The GNU versions of these tools are recommended.</p> -<div class="section" id="autotools-based-build-system"> -<h3><a class="toc-backref" href="#id17">Autotools based build system</a></h3> +<div class="section"> +<h3><a class="toc-backref" href="#id17" id="autotools-based-build-system" name="autotools-based-build-system">Autotools based build system</a></h3> <p>The Autotools based build system is very mature and has been well tested. To use it, you just need the Make tool, preferably GNU Make.</p> <p>Then run the following commands:</p> @@ -567,8 +567,8 @@ % make install </pre> </div> -<div class="section" id="waf-based-build-system"> -<h3><a class="toc-backref" href="#id18">Waf based build system</a></h3> +<div class="section"> +<h3><a class="toc-backref" href="#id18" id="waf-based-build-system" name="waf-based-build-system">Waf based build system</a></h3> <p>The Waf build system is still quite young and under heavy development but already in a usable state. In contrast to the Autotools system, Waf needs Python. So before using Waf, you need to install Python on your system. @@ -576,7 +576,7 @@ build process might be a bit faster. Especially when you use the Waf cache feature for repetitive builds (e.g. when changing only a few source files to test something) will become much faster since Waf will cache and re-use the -unchanged built files and only compile the changed code again. See <a class="reference internal" href="#waf-cache">Waf Cache</a> for details. +unchanged built files and only compile the changed code again. See <a class="reference" href="#waf-cache">Waf Cache</a> for details. To build Geany with Waf as run:</p> <pre class="literal-block"> $ ./waf configure @@ -586,13 +586,13 @@ <pre class="literal-block"> % ./waf install </pre> -<div class="section" id="waf-cache"> -<h4><a class="toc-backref" href="#id19">Waf Cache</a></h4> +<div class="section"> +<h4><a class="toc-backref" href="#id19" id="waf-cache" name="waf-cache">Waf Cache</a></h4> <p>The Waf build system has a nice and interesting feature which can help to avoid a lot of unnecessary rebuilding of unchanged code. This often happens when developing new features or trying to debug something in Geany. Waf is able to store and retrieve the object files from a cache. This cache is declared -using the environment variable <tt class="docutils literal">WAFCACHE</tt>. +using the environment variable <tt class="docutils literal"><span class="pre">WAFCACHE</span></tt>. A possible location of the cache directory could be <tt class="docutils literal"><span class="pre">~/.cache/waf</span></tt>. In order to make use of this, you first need to create this directory:</p> <pre class="literal-block"> @@ -603,11 +603,11 @@ <pre class="literal-block"> export WAFCACHE=/home/username/.cache/waf </pre> -<p>Remember to replace <tt class="docutils literal">username</tt> with your actual username.</p> +<p>Remember to replace <tt class="docutils literal"><span class="pre">username</span></tt> with your actual username.</p> <p>More information about the Waf cache feature are available at -<a class="reference external" href="http://code.google.com/p/waf/wiki/CacheObjectFiles">http://code.google.com/p/waf/wiki/CacheObjectFiles</a>.</p> -<div class="section" id="cleaning-the-cache"> -<h5><a class="toc-backref" href="#id20">Cleaning the Cache</a></h5> +<a class="reference" href="http://code.google.com/p/waf/wiki/CacheObjectFiles">http://code.google.com/p/waf/wiki/CacheObjectFiles</a>.</p> +<div class="section"> +<h5><a class="toc-backref" href="#id20" id="cleaning-the-cache" name="cleaning-the-cache">Cleaning the Cache</a></h5> <p>You should be careful about the size of the cache directory as it may grow rapidly over time. Waf doesn't do any cleaning or other house-keeping of the cache yet, so you need to keep it @@ -618,12 +618,12 @@ $ find /home/username/.cache/waf -mtime +14 -exec rm {} \; </pre> <p>This will delete all files in the cache directory which are older than 14 days.</p> -<p>For details about the <tt class="docutils literal">find</tt> command and its options, check its manual page.</p> +<p>For details about the <tt class="docutils literal"><span class="pre">find</span></tt> command and its options, check its manual page.</p> </div> </div> </div> -<div class="section" id="custom-installation"> -<h3><a class="toc-backref" href="#id21">Custom installation</a></h3> +<div class="section"> +<h3><a class="toc-backref" href="#id21" id="custom-installation" name="custom-installation">Custom installation</a></h3> <p>The configure script supports several common options, for a detailed list, type:</p> <pre class="literal-block"> @@ -637,40 +637,40 @@ <p>You may also want to read the INSTALL file for advanced installation options.</p> <ul class="simple"> -<li>See also <a class="reference internal" href="#compile-time-options">Compile-time options</a>.</li> +<li>See also <a class="reference" href="#compile-time-options">Compile-time options</a>.</li> </ul> </div> -<div class="section" id="dynamic-linking-loader-support-and-vte"> -<h3><a class="toc-backref" href="#id22">Dynamic linking loader support and VTE</a></h3> +<div class="section"> +<h3><a class="toc-backref" href="#id22" id="dynamic-linking-loader-support-and-vte" name="dynamic-linking-loader-support-and-vte">Dynamic linking loader support and VTE</a></h3> <p>In the case that your system lacks dynamic linking loader support, you -probably want to pass the option <tt class="docutils literal"><span class="pre">--disable-vte</span></tt> to the <tt class="docutils literal">configure</tt> +probably want to pass the option <tt class="docutils literal"><span class="pre">--disable-vte</span></tt> to the <tt class="docutils literal"><span class="pre">configure</span></tt> script. This prevents compiling Geany with dynamic linking loader -support for automatically loading <tt class="docutils literal">libvte.so.4</tt> if available.</p> +support for automatically loading <tt class="docutils literal"><span class="pre">libvte.so.4</span></tt> if available.</p> </div> -<div class="section" id="build-problems"> -<h3><a class="toc-backref" href="#id23">Build problems</a></h3> +<div class="section"> +<h3><a class="toc-backref" href="#id23" id="build-problems" name="build-problems">Build problems</a></h3> <p>If there are any errors during compilation, check your build environment and try to find the error, otherwise contact the mailing list or one the authors. Sometimes you might need to ask for specific help from your distribution.</p> </div> </div> -<div class="section" id="installation-prefix"> -<h2><a class="toc-backref" href="#id24">Installation prefix</a></h2> +<div class="section"> +<h2><a class="toc-backref" href="#id24" id="installation-prefix" name="installation-prefix">Installation prefix</a></h2> <p>If you want to edit any of Geany's system configuration files after installation you will need to know the installation prefix. Usually this is not necessary as you can just use per user configuration files and you will not need root permissions.</p> -<p>Use the <tt class="docutils literal"><span class="pre">--print-prefix</span></tt> option to Geany to check - see <a class="reference internal" href="#command-line-options">Command line +<p>Use the <tt class="docutils literal"><span class="pre">--print-prefix</span></tt> option to Geany to check - see <a class="reference" href="#command-line-options">Command line options</a>. The first path is the prefix.</p> -<p>This is commonly <tt class="docutils literal">/usr</tt> if you installed from a binary package, or -<tt class="docutils literal">/usr/local</tt> if you build from source.</p> +<p>This is commonly <tt class="docutils literal"><span class="pre">/usr</span></tt> if you installed from a binary package, or +<tt class="docutils literal"><span class="pre">/usr/local</span></tt> if you build from source.</p> </div> </div> -<div class="section" id="usage"> -<h1><a class="toc-backref" href="#id25">Usage</a></h1> -<div class="section" id="getting-started"> -<h2><a class="toc-backref" href="#id26">Getting started</a></h2> +<div class="section"> +<h1><a class="toc-backref" href="#id25" id="usage" name="usage">Usage</a></h1> +<div class="section"> +<h2><a class="toc-backref" href="#id26" id="getting-started" name="getting-started">Getting started</a></h2> <p>You can start Geany in the following ways:</p> <ul> <li><p class="first">From the Desktop Environment menu:</p> @@ -686,8 +686,8 @@ </li> </ul> </div> -<div class="section" id="the-geany-workspace"> -<h2><a class="toc-backref" href="#id27">The Geany workspace</a></h2> +<div class="section"> +<h2><a class="toc-backref" href="#id27" id="the-geany-workspace" name="the-geany-workspace">The Geany workspace</a></h2> <p>The Geany window is shown in the following figure:</p> <img alt="./images/main_window.png" src="./images/main_window.png" /> <p>The workspace has the following parts:</p> @@ -715,8 +715,8 @@ <p>The sizes of the sidebar and message window can be adjusted by dragging the dividers.</p> </div> -<div class="section" id="command-line-options"> -<h2><a class="toc-backref" href="#id28">Command line options</a></h2> +<div class="section"> +<h2><a class="toc-backref" href="#id28" id="command-line-options" name="command-line-options">Command line options</a></h2> <table border="1" class="docutils"> <colgroup> <col width="13%" /> @@ -745,7 +745,7 @@ <td>--config=directory_name</td> <td>Use an alternate configuration directory. The default configuration directory is <tt class="docutils literal"><span class="pre">~/.config/geany/</span></tt> and that -is where <tt class="docutils literal">geany.conf</tt> and other configuration files +is where <tt class="docutils literal"><span class="pre">geany.conf</span></tt> and other configuration files reside.</td> </tr> <tr><td><em>none</em></td> @@ -756,7 +756,7 @@ <tr><td>-g</td> <td>--generate-tags</td> <td>Generate a global tags file (see -<a class="reference internal" href="#generating-a-global-tags-file">Generating a global tags file</a>).</td> +<a class="reference" href="#generating-a-global-tags-file">Generating a global tags file</a>).</td> </tr> <tr><td>-P</td> <td>--no-preprocessing</td> @@ -812,7 +812,7 @@ <td>--no-terminal</td> <td>Do not load terminal support. Use this option if you do not want to load the virtual terminal emulator widget -at startup. If you do not have <tt class="docutils literal">libvte.so.4</tt> installed, +at startup. If you do not have <tt class="docutils literal"><span class="pre">libvte.so.4</span></tt> installed, then terminal-support is automatically disabled. Only available if Geany was compiled with support for VTE.</td> </tr> @@ -830,7 +830,7 @@ <td>--vte-lib</td> <td>Specify explicitly the path including filename or only the filename to the VTE library, e.g. -<tt class="docutils literal">/usr/lib/libvte.so</tt> or <tt class="docutils literal">libvte.so</tt>. This option is +<tt class="docutils literal"><span class="pre">/usr/lib/libvte.so</span></tt> or <tt class="docutils literal"><span class="pre">libvte.so</span></tt>. This option is only needed when the auto-detection does not work. Only available if Geany was compiled with support for VTE.</td> </tr> @@ -869,13 +869,13 @@ <p>Geany supports all generic GTK options, a list is available on the help screen.</p> </div> -<div class="section" id="general"> -<h2><a class="toc-backref" href="#id29">General</a></h2> -<div class="section" id="startup"> -<h3><a class="toc-backref" href="#id30">Startup</a></h3> +<div class="section"> +<h2><a class="toc-backref" href="#id29" id="general" name="general">General</a></h2> +<div class="section"> +<h3><a class="toc-backref" href="#id30" id="startup" name="startup">Startup</a></h3> <p>At startup, Geany loads all files from the last time Geany was launched. You can disable this feature in the preferences dialog -(see <a class="reference internal" href="#general-startup-preferences">General Startup preferences</a>). If you specify some +(see <a class="reference" href="#general-startup-preferences">General Startup preferences</a>). If you specify some files on the command line, only these files will be opened, but you can find the files from the last session in the file menu under the "Recent files" item. By default this contains the last 10 recently @@ -886,8 +886,8 @@ do not specify any filenames on the command-line, or disable opening files in a running instance using the appropriate command line option.</p> </div> -<div class="section" id="opening-files-from-the-command-line-in-a-running-instance"> -<h3><a class="toc-backref" href="#id31">Opening files from the command-line in a running instance</a></h3> +<div class="section"> +<h3><a class="toc-backref" href="#id31" id="opening-files-from-the-command-line-in-a-running-instance" name="opening-files-from-the-command-line-in-a-running-instance">Opening files from the command-line in a running instance</a></h3> <p>Geany detects if there is an an instance of itself already running and opens files from the command-line in that instance. So, Geany can be used to view and edit files by opening them from other programs @@ -896,22 +896,22 @@ <pre class="literal-block"> geany some_file.foo:55:4 </pre> -<p>This would open the file <tt class="docutils literal">some_file.foo</tt> with the cursor on line 55, +<p>This would open the file <tt class="docutils literal"><span class="pre">some_file.foo</span></tt> with the cursor on line 55, column 4.</p> <p>If you do not like this for some reason, you can disable using the first instance by using the appropriate command line option -- see the section -called <a class="reference internal" href="#command-line-options">Command line options</a>.</p> +called <a class="reference" href="#command-line-options">Command line options</a>.</p> </div> -<div class="section" id="virtual-terminal-emulator-widget-vte"> -<h3><a class="toc-backref" href="#id32">Virtual terminal emulator widget (VTE)</a></h3> -<p>If you have installed <tt class="docutils literal">libvte.so</tt> on your system, it is loaded +<div class="section"> +<h3><a class="toc-backref" href="#id32" id="virtual-terminal-emulator-widget-vte" name="virtual-terminal-emulator-widget-vte">Virtual terminal emulator widget (VTE)</a></h3> +<p>If you have installed <tt class="docutils literal"><span class="pre">libvte.so</span></tt> on your system, it is loaded automatically by Geany, and you will have a terminal widget in the notebook at the bottom.</p> -<p>If Geany cannot find any <tt class="docutils literal">libvte.so</tt> at startup, the terminal widget +<p>If Geany cannot find any <tt class="docutils literal"><span class="pre">libvte.so</span></tt> at startup, the terminal widget will not be loaded. So there is no need to install the package containing this file in order to run Geany. Additionally, you can disable the use of the terminal widget by command line option, for more information -see the section called <a class="reference internal" href="#command-line-options">Command line options</a>.</p> +see the section called <a class="reference" href="#command-line-options">Command line options</a>.</p> <p>You can use this terminal (from now on called VTE) much as you would a terminal program like xterm. There is basic clipboard support. You can paste the contents of the clipboard by pressing the right mouse @@ -928,26 +928,26 @@ you can use the argument <tt class="docutils literal"><span class="pre">--login</span></tt>.</p> <div class="note"> <p class="first admonition-title">Note</p> -<p class="last">Geany tries to load <tt class="docutils literal">libvte.so</tt>. If this fails, it tries to load +<p class="last">Geany tries to load <tt class="docutils literal"><span class="pre">libvte.so</span></tt>. If this fails, it tries to load some other filenames. If this fails too, you should check whether you installed libvte correctly. Again note, Geany will run without this library.</p> </div> <p>It could be, that the library is called something else than -<tt class="docutils literal">libvte.so</tt> (e.g. on FreeBSD 6.0 it is called <tt class="docutils literal">libvte.so.8</tt>). If so +<tt class="docutils literal"><span class="pre">libvte.so</span></tt> (e.g. on FreeBSD 6.0 it is called <tt class="docutils literal"><span class="pre">libvte.so.8</span></tt>). If so please set a link to the correct file (as root):</p> <pre class="literal-block"> # ln -s /usr/lib/libvte.so.X /usr/lib/libvte.so </pre> <p>Obviously, you have to adjust the paths and set X to the number of your -<tt class="docutils literal">libvte.so</tt>.</p> +<tt class="docutils literal"><span class="pre">libvte.so</span></tt>.</p> <p>You can also specify the filename of the VTE library to use on the command -line (see the section called <a class="reference internal" href="#command-line-options">Command line options</a>) or at compile time +line (see the section called <a class="reference" href="#command-line-options">Command line options</a>) or at compile time by specifying the command line option <tt class="docutils literal"><span class="pre">--with-vte-module-path</span></tt> to ./configure.</p> </div> -<div class="section" id="defining-own-widget-styles-using-gtkrc-2-0"> -<h3><a class="toc-backref" href="#id33">Defining own widget styles using .gtkrc-2.0</a></h3> +<div class="section"> +<h3><a class="toc-backref" href="#id33" id="defining-own-widget-styles-using-gtkrc-2-0" name="defining-own-widget-styles-using-gtkrc-2-0">Defining own widget styles using .gtkrc-2.0</a></h3> <p>You can define your widget style for many of Geany's GUI parts. To do this, just edit your <tt class="docutils literal"><span class="pre">.gtkrc-2.0</span></tt> (usually found in your home directory on UNIX-like systems and in the etc subdirectory of your @@ -987,10 +987,10 @@ </pre> </div> </div> -<div class="section" id="documents"> -<h2><a class="toc-backref" href="#id34">Documents</a></h2> -<div class="section" id="switching-between-documents"> -<h3><a class="toc-backref" href="#id35">Switching between documents</a></h3> +<div class="section"> +<h2><a class="toc-backref" href="#id34" id="documents" name="documents">Documents</a></h2> +<div class="section"> +<h3><a class="toc-backref" href="#id35" id="switching-between-documents" name="switching-between-documents">Switching between documents</a></h3> <p>The documents list and the editor tabs are two different ways to switch between documents using the mouse. When you hit the key combination to move between tabs, the order is determined by the tab @@ -998,14 +998,14 @@ (regardless of whether or not editor tabs are visible).</p> <p>The tabs can be positioned at the top, bottom, left, or right of the main editing window, by a selection in the interface preferences.</p> -<p>See the <a class="reference internal" href="#notebook-tab-keybindings">Notebook tab keybindings</a> section for useful +<p>See the <a class="reference" href="#notebook-tab-keybindings">Notebook tab keybindings</a> section for useful shortcuts including for Most-Recently-Used document switching.</p> </div> </div> -<div class="section" id="character-sets-and-unicode-byte-order-mark-bom"> -<h2><a class="toc-backref" href="#id36">Character sets and Unicode Byte-Order-Mark (BOM)</a></h2> -<div class="section" id="using-character-sets"> -<h3><a class="toc-backref" href="#id37">Using character sets</a></h3> +<div class="section"> +<h2><a class="toc-backref" href="#id36" id="character-sets-and-unicode-byte-order-mark-bom" name="character-sets-and-unicode-byte-order-mark-bom">Character sets and Unicode Byte-Order-Mark (BOM)</a></h2> +<div class="section"> +<h3><a class="toc-backref" href="#id37" id="using-character-sets" name="using-character-sets">Using character sets</a></h3> <p>Geany provides support for detecting and converting character sets. So you can open and save files in different character sets, and even convert a file from one character set to another. To do this, @@ -1051,8 +1051,8 @@ </li> </ul> </div> -<div class="section" id="in-file-encoding-specification"> -<h3><a class="toc-backref" href="#id38">In-file encoding specification</a></h3> +<div class="section"> +<h3><a class="toc-backref" href="#id38" id="in-file-encoding-specification" name="in-file-encoding-specification">In-file encoding specification</a></h3> <p>Geany detects meta tags of HTML files which contain charset information like:</p> <pre class="literal-block"> @@ -1079,7 +1079,7 @@ correctly the next time.</p> <p>Since Geany 0.15 you can also use lines which match the regular expression used to find the encoding string: -<tt class="docutils literal"><span class="pre">coding[\t</span> <span class="pre">]*[:=][\t</span> <span class="pre">]*([a-z0-9-]+)[\t</span> ]*</tt></p> +<tt class="docutils literal"><span class="pre">coding[\t</span> <span class="pre">]*[:=][\t</span> <span class="pre">]*([a-z0-9-]+)[\t</span> <span class="pre">]*</span></tt></p> <div class="note"> <p class="first admonition-title">Note</p> <p class="last">These specifications must be in the first 512 bytes of the file. @@ -1094,8 +1094,8 @@ # coding: ISO-8859-15 </pre> </div> -<div class="section" id="special-encoding-none"> -<h3><a class="toc-backref" href="#id39">Special encoding "None"</a></h3> +<div class="section"> +<h3><a class="toc-backref" href="#id39" id="special-encoding-none" name="special-encoding-none">Special encoding "None"</a></h3> <p>There is a special encoding "None" which uses no encoding. It is useful when you know that Geany cannot auto-detect the encoding of a file and it is not displayed correctly. Especially @@ -1104,10 +1104,10 @@ of the first NULL-byte. Using this encoding opens the file as it is without any character conversion.</p> </div> -<div class="section" id="unicode-byte-order-mark-bom"> -<h3><a class="toc-backref" href="#id40">Unicode Byte-Order-Mark (BOM)</a></h3> +<div class="section"> +<h3><a class="toc-backref" href="#id40" id="unicode-byte-order-mark-bom" name="unicode-byte-order-mark-bom">Unicode Byte-Order-Mark (BOM)</a></h3> <p>Furthermore, Geany detects a Unicode Byte Order Mark (see -<a class="reference external" href="http://en.wikipedia.org/wiki/Byte_Order_Mark">http://en.wikipedia.org/wiki/Byte_Order_Mark</a> for details). Of course, +<a class="reference" href="http://en.wikipedia.org/wiki/Byte_Order_Mark">http://en.wikipedia.org/wiki/Byte_Order_Mark</a> for details). Of course, this feature is only available if the opened file is in a Unicode encoding. The Byte Order Mark helps to detect the encoding of a file, e.g. whether it is UTF-16LE or UTF-16BE and so on. On Unix-like systems @@ -1127,10 +1127,10 @@ </div> </div> </div> -<div class="section" id="editing"> -<h2><a class="toc-backref" href="#id41">Editing</a></h2> -<div class="section" id="folding"> -<h3><a class="toc-backref" href="#id42">Folding</a></h3> +<div class="section"> +<h2><a class="toc-backref" href="#id41" id="editing" name="editing">Editing</a></h2> +<div class="section"> +<h3><a class="toc-backref" href="#id42" id="folding" name="folding">Folding</a></h3> <p>Geany provides basic code folding support. Folding means the ability to show and hide parts of the text in the current file. You can hide unimportant code sections and concentrate on the parts you are working on @@ -1144,7 +1144,7 @@ <div class="note"> <p class="first admonition-title">Note</p> <p class="last">You can customize the folding icon and line styles - see the -filetypes.common <a class="reference internal" href="#folding-settings">Folding Settings</a>.</p> +filetypes.common <a class="reference" href="#folding-settings">Folding Settings</a>.</p> </div> <p>If you don't like it or don't need it at all, you can simply disable folding support completely in the preferences dialog.</p> @@ -1159,8 +1159,8 @@ children of a fold point" option is enabled, pressing Shift will disable it for this click and vice versa.</p> </div> -<div class="section" id="column-mode-editing-rectangular-selections"> -<h3><a class="toc-backref" href="#id43">Column mode editing (rectangular selections)</a></h3> +<div class="section"> +<h3><a class="toc-backref" href="#id43" id="column-mode-editing-rectangular-selections" name="column-mode-editing-rectangular-selections">Column mode editing (rectangular selections)</a></h3> <p>There is basic support for column mode editing. To use it, create a rectangular selection by holding down the Control and Shift keys (or Control and Alt if it doesn't work) while @@ -1169,18 +1169,18 @@ this selection and the modifications will be done for every line in the selection.</p> </div> -<div class="section" id="drag-and-drop-of-text"> -<h3><a class="toc-backref" href="#id44">Drag and drop of text</a></h3> +<div class="section"> +<h3><a class="toc-backref" href="#id44" id="drag-and-drop-of-text" name="drag-and-drop-of-text">Drag and drop of text</a></h3> <p>If you drag selected text in the editor widget of Geany the text is moved to the position where the mouse pointer is when releasing the mouse button. Holding Control when releasing the mouse button will copy the text instead. This behaviour was changed in Geany 0.11 - before the selected text was copied to the new position.</p> </div> -<div class="section" id="indentation"> -<h3><a class="toc-backref" href="#id45">Indentation</a></h3> +<div class="section"> +<h3><a class="toc-backref" href="#id45" id="indentation" name="indentation">Indentation</a></h3> <p>Geany allows each document to indent either with a tab character or -multiple spaces. The default indent mode is set in the <a class="reference internal" href="#editor-features-preferences">Editor Features +multiple spaces. The default indent mode is set in the <a class="reference" href="#editor-features-preferences">Editor Features preferences</a> (see the link for more information). But this can be overridden using either the <em>Document->Indent Type</em> menu, or by using the <em>Detect from file</em> indentation preference. When enabled, @@ -1198,8 +1198,8 @@ on a line.</dd> </dl> </div> -<div class="section" id="auto-indentation"> -<h3><a class="toc-backref" href="#id46">Auto-indentation</a></h3> +<div class="section"> +<h3><a class="toc-backref" href="#id46" id="auto-indentation" name="auto-indentation">Auto-indentation</a></h3> <p>When enabled, auto-indentation happens when pressing <em>Enter</em> in the Editor. It adds a certain amount of indentation to the new line so the user doesn't always have to indent each line manually.</p> @@ -1219,8 +1219,8 @@ match the indentation of the line with the opening brace.</dd> </dl> </div> -<div class="section" id="bookmarks"> -<h3><a class="toc-backref" href="#id47">Bookmarks</a></h3> +<div class="section"> +<h3><a class="toc-backref" href="#id47" id="bookmarks" name="bookmarks">Bookmarks</a></h3> <p>Geany provides a handy bookmarking feature that lets you mark one or more lines in a document, and return the cursor to them using a key combination.</p> @@ -1237,14 +1237,14 @@ (Ctrl-PgUp/PgDn and Ctrl-Tab) provides a particularly fast way to navigate around multiple files.</p> </div> -<div class="section" id="code-navigation-history"> -<h3><a class="toc-backref" href="#id48">Code navigation history</a></h3> +<div class="section"> +<h3><a class="toc-backref" href="#id48" id="code-navigation-history" name="code-navigation-history">Code navigation history</a></h3> <p>To ease navigation in source files and especially between different files, Geany lets you jump between different navigation points. Currently, this works for the following:</p> <ul class="simple"> -<li><a class="reference internal" href="#go-to-tag-declaration">Go to tag declaration</a></li> -<li><a class="reference internal" href="#go-to-tag-definition">Go to tag definition</a></li> +<li><a class="reference" href="#go-to-tag-declaration">Go to tag declaration</a></li> +<li><a class="reference" href="#go-to-tag-definition">Go to tag definition</a></li> <li>Symbol list items</li> <li>Build errors</li> <li>Message items</li> @@ -1256,8 +1256,8 @@ location". This makes it easier to navigate in e.g. foreign code and between different files.</p> </div> -<div class="section" id="sending-text-through-custom-commands"> -<h3><a class="toc-backref" href="#id49">Sending text through custom commands</a></h3> +<div class="section"> +<h3><a class="toc-backref" href="#id49" id="sending-text-through-custom-commands" name="sending-text-through-custom-commands">Sending text through custom commands</a></h3> <p>You can define several custom commands in Geany and send the current selection to one of these commands using the <em>Edit->Format->Send Selection to</em> menu or keybindings. The output of the command will be @@ -1276,22 +1276,22 @@ deleted automatically.</p> <p>Normal shell quoting is supported, so you can do things like:</p> <ul class="simple"> -<li><tt class="docutils literal">sed <span class="pre">'s/\./(dot)/g'</span></tt></li> +<li><tt class="docutils literal"><span class="pre">sed</span> <span class="pre">'s/\./(dot)/g'</span></tt></li> </ul> -<p>The above example would normally be done with the <a class="reference internal" href="#replace-all">Replace all</a> +<p>The above example would normally be done with the <a class="reference" href="#replace-all">Replace all</a> function, but it can be handy to have common commands already set up.</p> </div> -<div class="section" id="context-actions"> -<h3><a class="toc-backref" href="#id50">Context actions</a></h3> +<div class="section"> +<h3><a class="toc-backref" href="#id50" id="context-actions" name="context-actions">Context actions</a></h3> <p>You can execute the context action command on the current word at the cursor position or the available selection. This word or selection can be used as an argument to the command. The context action is invoked by a menu entry in the popup menu of the editor and also a keyboard shortcut (see the section called -<a class="reference internal" href="#keybindings">Keybindings</a>).</p> +<a class="reference" href="#keybindings">Keybindings</a>).</p> <p>The command can be specified in the preferences dialog and also for each filetype (see "context_action_cmd" in the section called -<a class="reference internal" href="#format">Format</a>). When the context action is invoked, the filetype +<a class="reference" href="#format">Format</a>). When the context action is invoked, the filetype specific command is used if available, otherwise the command specified in the preferences dialog is executed.</p> <p>The current word or selection can be referred with the wildcard "%s" @@ -1306,19 +1306,19 @@ <p>when executing the command, the %s is substituted by the word near the cursor position or by the current selection. If the cursor is at the word "echo", a browser window will open(assumed your browser is -called firefox) and it will open the address: <a class="reference external" href="http://www.php.net/echo">http://www.php.net/echo</a>.</p> +called firefox) and it will open the address: <a class="reference" href="http://www.php.net/echo">http://www.php.net/echo</a>.</p> </div> -<div class="section" id="autocompletion"> -<h3><a class="toc-backref" href="#id51">Autocompletion</a></h3> +<div class="section"> +<h3><a class="toc-backref" href="#id51" id="autocompletion" name="autocompletion">Autocompletion</a></h3> <p>Geany can offer a list of possible completions for symbols defined in the tags and for all words in a document.</p> <p>The autocompletion list for symbols is presented when the first few -characters of the symbol are typed (configurable, see <a class="reference internal" href="#editor-completions-preferences">Editor Completions +characters of the symbol are typed (configurable, see <a class="reference" href="#editor-completions-preferences">Editor Completions preferences</a>, default 4) or when the <em>Complete word</em> -keybinding is pressed (configurable, see <a class="reference internal" href="#editor-keybindings">Editor keybindings</a>, +keybinding is pressed (configurable, see <a class="reference" href="#editor-keybindings">Editor keybindings</a>, default Ctrl-Space).</p> <p>When the defined keybinding is typed and the <em>Autocomplete all words in -document</em> preference (in <a class="reference internal" href="#editor-completions-preferences">Editor Completions preferences</a>) +document</em> preference (in <a class="reference" href="#editor-completions-preferences">Editor Completions preferences</a>) is selected then the autocompletion list will show all matching words in the document, if there are no matching symbols.</p> <p>If you don't want to use autocompletion it can be dismissed until @@ -1330,13 +1330,13 @@ item on the autocompletion list can be chosen from the list by pressing Enter/Return. You can also double-click to select an item. The sequence will be completed to match the chosen item, and if the <em>Drop rest of -word on completion</em> preference is set (in <a class="reference internal" href="#editor-completions-preferences">Editor Completions +word on completion</em> preference is set (in <a class="reference" href="#editor-completions-preferences">Editor Completions preferences</a>) then any characters after the cursor that match a symbol or word are deleted.</p> -<div class="section" id="word-part-completion"> -<h4><a class="toc-backref" href="#id52">Word part completion</a></h4> +<div class="section"> +<h4><a class="toc-backref" href="#id52" id="word-part-completion" name="word-part-completion">Word part completion</a></h4> <p>By default, pressing Tab will complete the selected item by word part; -useful e.g. for adding the prefix <tt class="docutils literal">gtk_combo_box_entry_</tt> without typing it +useful e.g. for adding the prefix <tt class="docutils literal"><span class="pre">gtk_combo_box_entry_</span></tt> without typing it manually:</p> <ul class="simple"> <li>gtk_com<TAB></li> @@ -1345,12 +1345,12 @@ <li>gtk_combo_box_entry_<s><ENTER></li> <li>gtk_combo_box_entry_set_text_column</li> </ul> -<p>The key combination can be changed from Tab - See <a class="reference internal" href="#editor-keybindings">Editor keybindings</a>. +<p>The key combination can be changed from Tab - See <a class="reference" href="#editor-keybindings">Editor keybindings</a>. If you clear/change the key combination for word part completion, Tab will complete the whole word instead, like Enter.</p> </div> -<div class="section" id="scope-autocompletion"> -<h4><a class="toc-backref" href="#id53">Scope autocompletion</a></h4> +<div class="section"> +<h4><a class="toc-backref" href="#id53" id="scope-autocompletion" name="scope-autocompletion">Scope autocompletion</a></h4> <p>E.g.:</p> <pre class="literal-block"> struct @@ -1359,7 +1359,7 @@ char c; } foo; </pre> -<p>When you type <tt class="docutils literal">foo.</tt> it will show an autocompletion list with 'i' and +<p>When you type <tt class="docutils literal"><span class="pre">foo.</span></tt> it will show an autocompletion list with 'i' and 'c' symbols.</p> <p>It only works for languages that set parent scope names for e.g. struct members. Currently this means C-like languages. The C tag parser only @@ -1367,27 +1367,28 @@ in local scope.</p> </div> </div> -<div class="section" id="user-definable-snippets"> -<h3><a class="toc-backref" href="#id54">User-definable snippets</a></h3> +<div class="section"> +<h3><a class="toc-backref" href="#id54" id="user-definable-snippets" name="user-definable-snippets">User-definable snippets</a></h3> <p>Snippets are small strings or code constructs which can be replaced or completed to a more complex string. So you can save a lot of time when typing common strings and letting Geany do the work for you. To know what to complete or replace Geany reads a configuration file -called <tt class="docutils literal">snippets.conf</tt> at startup.</p> +called <tt class="docutils literal"><span class="pre">snippets.conf</span></tt> at startup.</p> <p>Maybe you need to often type your name, so define a snippet like this:</p> <pre class="literal-block"> [Default] myname=Enrico Tröger </pre> -<p>Every time you write <tt class="docutils literal">myname</tt> <TAB> in Geany, it will replace "myname" +<p>Every time you write <tt class="docutils literal"><span class="pre">myname</span></tt> <TAB> in Geany, it will replace "myname" with "Enrico Tröger". The key to start autocompletion can be changed in the preferences dialog, by default it is TAB. The corresponding keybinding -is called <tt class="docutils literal">Complete snippet</tt>.</p> +is called <tt class="docutils literal"><span class="pre">Complete</span> <span class="pre">snippet</span></tt>.</p> +<p><strong>Paths</strong></p> <p>The system-wide configuration file can be found in -<tt class="docutils literal">$prefix/share/geany</tt>, where <tt class="docutils literal">$prefix</tt> is the path where Geany is -installed (see <a class="reference internal" href="#installation-prefix">Installation prefix</a>). It is not recommended to edit the +<tt class="docutils literal"><span class="pre">$prefix/share/geany</span></tt>, where <tt class="docutils literal"><span class="pre">$prefix</span></tt> is the path where Geany is +installed (see <a class="reference" href="#installation-prefix">Installation prefix</a>). It is not recommended to edit the system-wide file, because it will be overridden when Geany is updated.</p> -<p>To change the settings, copy the file from <tt class="docutils literal">$prefix/share/geany</tt> +<p>To change the settings, copy the file from <tt class="docutils literal"><span class="pre">$prefix/share/geany</span></tt> in your configuration directory (usually <tt class="docutils literal"><span class="pre">~/.config/geany/</span></tt>).</p> <p>For example:</p> <pre class="literal-block"> @@ -1398,23 +1399,24 @@ configuration directory. Alternatively, you can create a file <tt class="docutils literal"><span class="pre">~/.config/geany/snippets.conf</span></tt> and add only these settings you want to change. All missing settings will be read from the global snippets -file in <tt class="docutils literal">$prefix/share/geany</tt>.</p> -<p>The file <tt class="docutils literal">snippets.conf</tt> contains sections defining snippets that +file in <tt class="docutils literal"><span class="pre">$prefix/share/geany</span></tt>.</p> +<p><strong>Snippet groups</strong></p> +<p>The file <tt class="docutils literal"><span class="pre">snippets.conf</span></tt> contains sections defining snippets that are available for particular filetypes and in general.</p> <p>The two sections "Default" and "Special" apply to all filetypes. "Default" contains all snippets which are available for every filetype and "Special" contains snippets which can only be used in other snippets. So you can define often used parts of snippets and just use the special snippet as a placeholder (see the -<tt class="docutils literal">snippets.conf</tt> for details).</p> +<tt class="docutils literal"><span class="pre">snippets.conf</span></tt> for details).</p> <p>You can define sections with the name of a filetype eg "C++". The snippets in that section are only available for use in files with that filetype. Snippets in filetype sections will hide snippets with the same name in the "Default" section when used in a file of that filetype.</p> +<p><strong>Substitution sequences for snippets</strong></p> <p>To define snippets you can use several special character sequences which will be replaced when using the snippet:</p> -<p><strong>Substitution Sequences for snippets</strong></p> <table border="1" class="docutils"> <colgroup> <col width="22%" /> @@ -1436,7 +1438,7 @@ <tr><td>%cursor%</td> <td>Place the cursor at this position after completion has been done. You can define multiple %cursor% wildcards -and use the keybinding <tt class="docutils literal">Move cursor in snippet</tt> to jump +and use the keybinding <tt class="docutils literal"><span class="pre">Move</span> <span class="pre">cursor</span> <span class="pre">in</span> <span class="pre">snippet</span></tt> to jump to the next defined cursor position in the completed snippet.</td> </tr> @@ -1450,18 +1452,20 @@ <p>Snippet names must not contain spaces otherwise they won't work correctly. But beside that you can define almost any string as a snippet and use it later in Geany. It is not limited -to existing contructs of certain programming languages(like <tt class="docutils literal">if</tt>, -<tt class="docutils literal">for</tt>, <tt class="docutils literal">switch</tt>). Define whatever you need.</p> +to existing contructs of certain programming languages(like <tt class="docutils literal"><span class="pre">if</span></tt>, +<tt class="docutils literal"><span class="pre">for</span></tt>, <tt class="docutils literal"><span class="pre">switch</span></tt>). Define whatever you need.</p> +<p><strong>Template wildcards</strong></p> <p>Since Geany 0.15 you can also use most of the available templates wildcards -listed in <a class="reference internal" href="#template-wildcards">Template wildcards</a>. All wildcards which are listed as +listed in <a class="reference" href="#template-wildcards">Template wildcards</a>. All wildcards which are listed as <cite>available in snippets</cite> can be used. For instance to improve the above example:</p> <pre class="literal-block"> [Default] myname=My name is {developer} mysystem=My system: {command:uname -a} </pre> -<p>this will replace <tt class="docutils literal">myname</tt> with "My name is " and the value of the template -preference <tt class="docutils literal">developer</tt>.</p> +<p>this will replace <tt class="docutils literal"><span class="pre">myname</span></tt> with "My name is " and the value of the template +preference <tt class="docutils literal"><span class="pre">developer</span></tt>.</p> +<p><strong>Word characters</strong></p> <p>You can change the way Geany recognizes the word to complete, that is how the start and end of a word is recognised when the snippet completion is requested. The section "Special" may @@ -1470,8 +1474,8 @@ default characters or define it to add or remove characters to fit your needs.</p> </div> -<div class="section" id="inserting-unicode-characters"> -<h3><a class="toc-backref" href="#id55">Inserting Unicode characters</a></h3> +<div class="section"> +<h3><a class="toc-backref" href="#id55" id="inserting-unicode-characters" name="inserting-unicode-characters">Inserting Unicode characters</a></h3> <p>With GTK 2.10 and above, you can insert Unicode code points by hitting Ctrl-Shift-u, then still holding Ctrl-Shift, type some hex digits representing the code point for the character you want and hit Enter or Return (still @@ -1480,7 +1484,7 @@ character is also entered. In the case of Enter/Return, it is a newline, as you might expect.</p> <p>In some earlier versions of Geany, you might need to first unbind Ctrl-Shift-u -in the <a class="reference internal" href="#keybinding-preferences">keybinding preferences</a>, then select <em>Tools->Reload Configuration</em> +in the <a class="reference" href="#keybinding-preferences">keybinding preferences</a>, then select <em>Tools->Reload Configuration</em> or restart Geany. Note that it works slightly differently from other GTK applications, in that you'll need to continue to hold down the Ctrl and Shift keys while typing the code point hex digits (and the Enter or Return to finish the code point).</p> @@ -1489,8 +1493,8 @@ keys conflict with other Geany keybindings.</p> </div> </div> -<div class="section" id="search-replace-and-go-to"> -<h2><a class="toc-backref" href="#id56">Search, replace and go to</a></h2> +<div class="section"> +<h2><a class="toc-backref" href="#id56" id="search-replace-and-go-to" name="search-replace-and-go-to">Search, replace and go to</a></h2> <p>This section describes search-related commands from the Search menu and the editor window's popup menu:</p> <ul class="simple"> @@ -1503,30 +1507,30 @@ <li>Go to tag declaration</li> <li>Go to line</li> </ul> -<div class="section" id="toolbar-entries"> -<h3><a class="toc-backref" href="#id57">Toolbar entries</a></h3> +<div class="section"> +<h3><a class="toc-backref" href="#id57" id="toolbar-entries" name="toolbar-entries">Toolbar entries</a></h3> <p>There are also two toolbar entries:</p> <ul class="simple"> <li>Search bar</li> <li>Go to line entry</li> </ul> -<p>There are keybindings to focus each of these - see <a class="reference internal" href="#focus-keybindings">Focus +<p>There are keybindings to focus each of these - see <a class="reference" href="#focus-keybindings">Focus keybindings</a>. Pressing Escape will then focus the editor.</p> -<div class="section" id="search-bar"> -<h4><a class="toc-backref" href="#id58">Search bar</a></h4> +<div class="section"> +<h4><a class="toc-backref" href="#id58" id="search-bar" name="search-bar">Search bar</a></h4> <p>The quickest way to find some text is to use the search bar entry in the toolbar. This performs a case-insensitive search in the current document whilst you type. Pressing Enter will search again.</p> </div> </div> -<div class="section" id="find"> -<h3><a class="toc-backref" href="#id59">Find</a></h3> +<div class="section"> +<h3><a class="toc-backref" href="#id59" id="find" name="find">Find</a></h3> <p>The Find dialog is used for finding text in one or more open documents.</p> <img alt="./images/find_dialog.png" src="./images/find_dialog.png" /> -<div class="section" id="matching-options"> -<h4><a class="toc-backref" href="#id60">Matching options</a></h4> +<div class="section"> +<h4><a class="toc-backref" href="#id60" id="matching-options" name="matching-options">Matching options</a></h4> <p>The syntax for the <em>Use regular expressions</em> option is shown in -<a class="reference internal" href="#regular-expressions">Regular expressions</a>.</p> +<a class="reference" href="#regular-expressions">Regular expressions</a>.</p> <div class="note"> <p class="first admonition-title">Note</p> <p class="last"><em>Use escape sequences</em> is implied for regular expressions.</p> @@ -1536,8 +1540,8 @@ a tab character. Other recognized symbols are: \\, \n, \r, \uXXXX (Unicode characters).</p> </div> -<div class="section" id="find-all"> -<h4><a class="toc-backref" href="#id61">Find all</a></h4> +<div class="section"> +<h4><a class="toc-backref" href="#id61" id="find-all" name="find-all">Find all</a></h4> <p>To find all matches, click on the Find All expander. This will reveal several options:</p> <ul class="simple"> @@ -1552,8 +1556,8 @@ colored box. These markers can be removed by selecting the Remove Markers command from the Document menu.</p> </div> -<div class="section" id="change-font-in-search-dialog-text-fields"> -<h4><a class="toc-backref" href="#id62">Change font in search dialog text fields</a></h4> +<div class="section"> +<h4><a class="toc-backref" href="#id62" id="change-font-in-search-dialog-text-fields" name="change-font-in-search-dialog-text-fields">Change font in search dialog text fields</a></h4> <p>All search related dialogs use a Monospace for the text input fields to increase the readability of input text. This is useful when you are typing input such as regular expressions with spaces, periods and commas which @@ -1574,12 +1578,12 @@ for the search dialogs.</p> </div> </div> -<div class="section" id="find-selection"> -<h3><a class="toc-backref" href="#id63">Find selection</a></h3> +<div class="section"> +<h3><a class="toc-backref" href="#id63" id="find-selection" name="find-selection">Find selection</a></h3> <p>The <em>Find Next/Previous Selection</em> commands perform a search for the current selected text. If nothing is selected, by default the current word is used instead. This can be customized by the -<em>find_selection_type</em> hidden pref - see <a class="reference internal" href="#hidden-preferences">Hidden preferences</a>.</p> +<em>find_selection_type</em> hidden pref - see <a class="reference" href="#hidden-preferences">Hidden preferences</a>.</p> <table border="1" class="docutils"> <colgroup> <col width="10%" /> @@ -1603,8 +1607,8 @@ </tbody> </table> </div> -<div class="section" id="find-usage"> -<h3><a class="toc-backref" href="#id64">Find usage</a></h3> +<div class="section"> +<h3><a class="toc-backref" href="#id64" id="find-usage" name="find-usage">Find usage</a></h3> <p>Find usage searches all open files. It is similar to the Find All In Session option in the Find dialog.</p> @@ Diff output truncated at 100000 characters. @@ This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

1 0

SF.net SVN: geany:[5274] trunk/src/editor.c
by ntrel＠users.sourceforge.net 04 Oct '10

04 Oct '10

Revision: 5274 http://geany.svn.sourceforge.net/geany/?rev=5274&view=rev Author: ntrel Date: 2010-10-04 10:41:06 +0000 (Mon, 04 Oct 2010) Log Message: ----------- Rename snippets_init -> snippets_load. Modified Paths: -------------- trunk/src/editor.c Modified: trunk/src/editor.c =================================================================== --- trunk/src/editor.c 2010-10-02 14:52:48 UTC (rev 5273) +++ trunk/src/editor.c 2010-10-04 10:41:06 UTC (rev 5274) @@ -125,7 +125,7 @@ } -static void snippets_init(GKeyFile *sysconfig, GKeyFile *userconfig) +static void snippets_load(GKeyFile *sysconfig, GKeyFile *userconfig) { gsize i, j, len = 0, len_keys = 0; gchar **groups_user, **groups_sys; @@ -279,7 +279,7 @@ g_key_file_load_from_file(sysconfig, sysconfigfile, G_KEY_FILE_NONE, NULL); g_key_file_load_from_file(userconfig, userconfigfile, G_KEY_FILE_NONE, NULL); - snippets_init(sysconfig, userconfig); + snippets_load(sysconfig, userconfig); /* setup snippet keybindings */ snippet_accel_group = gtk_accel_group_new(); This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

1 0

SF.net SVN: geany:[5273] trunk
by eht16＠users.sourceforge.net 02 Oct '10

02 Oct '10

Revision: 5273 http://geany.svn.sourceforge.net/geany/?rev=5273&view=rev Author: eht16 Date: 2010-10-02 14:52:48 +0000 (Sat, 02 Oct 2010) Log Message: ----------- Document hidden msgwin_*_visible preferences. Modified Paths: -------------- trunk/ChangeLog trunk/doc/geany.html trunk/doc/geany.txt Modified: trunk/ChangeLog =================================================================== --- trunk/ChangeLog 2010-10-02 14:36:12 UTC (rev 5272) +++ trunk/ChangeLog 2010-10-02 14:52:48 UTC (rev 5273) @@ -2,6 +2,8 @@ * src/templates.c: Strip the output of {command: } templates (closes #3079063). + * doc/geany.txt, doc/geany.html: + Document hidden msgwin_*_visible preferences. 2010-10-01 Nick Treleaven <nick(dot)treleaven(at)btinternet(dot)com> Modified: trunk/doc/geany.html =================================================================== --- trunk/doc/geany.html 2010-10-02 14:36:12 UTC (rev 5272) +++ trunk/doc/geany.html 2010-10-02 14:52:48 UTC (rev 5273) @@ -3,10 +3,10 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> -<meta name="generator" content="Docutils 0.4: http://docutils.sourceforge.net/" /> +<meta name="generator" content="Docutils 0.7: http://docutils.sourceforge.net/" /> <title>Geany</title> <meta name="authors" content="Enrico Tröger Nick Treleaven Frank Lanitz" /> -<meta name="date" content="2010-09-30" /> +<meta name="date" content="2010-10-01" /> <style type="text/css"> /* @@ -139,7 +139,7 @@ <br />Nick Treleaven <br />Frank Lanitz</td></tr> <tr><th class="docinfo-name">Date:</th> -<td>2010-09-30</td></tr> +<td>2010-10-01</td></tr> <tr><th class="docinfo-name">Version:</th> <td>0.20</td></tr> </tbody> @@ -149,340 +149,340 @@ License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. A copy of this license can be found in the file COPYING included with the source code -of this program, and also in the chapter <a class="reference" href="#gnu-general-public-license">GNU General Public License</a>.</p> -<div class="contents topic"> -<p class="topic-title first"><a id="contents" name="contents">Contents</a></p> +of this program, and also in the chapter <a class="reference internal" href="#gnu-general-public-license">GNU General Public License</a>.</p> +<div class="contents topic" id="contents"> +<p class="topic-title first">Contents</p> <ul class="simple"> -<li><a class="reference" href="#introduction" id="id8" name="id8">Introduction</a><ul> -<li><a class="reference" href="#about-geany" id="id9" name="id9">About Geany</a></li> -<li><a class="reference" href="#where-to-get-it" id="id10" name="id10">Where to get it</a></li> -<li><a class="reference" href="#license" id="id11" name="id11">License</a></li> -<li><a class="reference" href="#about-this-document" id="id12" name="id12">About this document</a></li> +<li><a class="reference internal" href="#introduction" id="id8">Introduction</a><ul> +<li><a class="reference internal" href="#about-geany" id="id9">About Geany</a></li> +<li><a class="reference internal" href="#where-to-get-it" id="id10">Where to get it</a></li> +<li><a class="reference internal" href="#license" id="id11">License</a></li> +<li><a class="reference internal" href="#about-this-document" id="id12">About this document</a></li> </ul> </li> -<li><a class="reference" href="#installation" id="id13" name="id13">Installation</a><ul> -<li><a class="reference" href="#requirements" id="id14" name="id14">Requirements</a></li> -<li><a class="reference" href="#binary-packages" id="id15" name="id15">Binary packages</a></li> -<li><a class="reference" href="#source-compilation" id="id16" name="id16">Source compilation</a><ul> -<li><a class="reference" href="#autotools-based-build-system" id="id17" name="id17">Autotools based build system</a></li> -<li><a class="reference" href="#waf-based-build-system" id="id18" name="id18">Waf based build system</a><ul> -<li><a class="reference" href="#waf-cache" id="id19" name="id19">Waf Cache</a><ul> -<li><a class="reference" href="#cleaning-the-cache" id="id20" name="id20">Cleaning the Cache</a></li> +<li><a class="reference internal" href="#installation" id="id13">Installation</a><ul> +<li><a class="reference internal" href="#requirements" id="id14">Requirements</a></li> +<li><a class="reference internal" href="#binary-packages" id="id15">Binary packages</a></li> +<li><a class="reference internal" href="#source-compilation" id="id16">Source compilation</a><ul> +<li><a class="reference internal" href="#autotools-based-build-system" id="id17">Autotools based build system</a></li> +<li><a class="reference internal" href="#waf-based-build-system" id="id18">Waf based build system</a><ul> +<li><a class="reference internal" href="#waf-cache" id="id19">Waf Cache</a><ul> +<li><a class="reference internal" href="#cleaning-the-cache" id="id20">Cleaning the Cache</a></li> </ul> </li> </ul> </li> -<li><a class="reference" href="#custom-installation" id="id21" name="id21">Custom installation</a></li> -<li><a class="reference" href="#dynamic-linking-loader-support-and-vte" id="id22" name="id22">Dynamic linking loader support and VTE</a></li> -<li><a class="reference" href="#build-problems" id="id23" name="id23">Build problems</a></li> +<li><a class="reference internal" href="#custom-installation" id="id21">Custom installation</a></li> +<li><a class="reference internal" href="#dynamic-linking-loader-support-and-vte" id="id22">Dynamic linking loader support and VTE</a></li> +<li><a class="reference internal" href="#build-problems" id="id23">Build problems</a></li> </ul> </li> -<li><a class="reference" href="#installation-prefix" id="id24" name="id24">Installation prefix</a></li> +<li><a class="reference internal" href="#installation-prefix" id="id24">Installation prefix</a></li> </ul> </li> -<li><a class="reference" href="#usage" id="id25" name="id25">Usage</a><ul> -<li><a class="reference" href="#getting-started" id="id26" name="id26">Getting started</a></li> -<li><a class="reference" href="#the-geany-workspace" id="id27" name="id27">The Geany workspace</a></li> -<li><a class="reference" href="#command-line-options" id="id28" name="id28">Command line options</a></li> -<li><a class="reference" href="#general" id="id29" name="id29">General</a><ul> -<li><a class="reference" href="#startup" id="id30" name="id30">Startup</a></li> -<li><a class="reference" href="#opening-files-from-the-command-line-in-a-running-instance" id="id31" name="id31">Opening files from the command-line in a running instance</a></li> -<li><a class="reference" href="#virtual-terminal-emulator-widget-vte" id="id32" name="id32">Virtual terminal emulator widget (VTE)</a></li> -<li><a class="reference" href="#defining-own-widget-styles-using-gtkrc-2-0" id="id33" name="id33">Defining own widget styles using .gtkrc-2.0</a></li> +<li><a class="reference internal" href="#usage" id="id25">Usage</a><ul> +<li><a class="reference internal" href="#getting-started" id="id26">Getting started</a></li> +<li><a class="reference internal" href="#the-geany-workspace" id="id27">The Geany workspace</a></li> +<li><a class="reference internal" href="#command-line-options" id="id28">Command line options</a></li> +<li><a class="reference internal" href="#general" id="id29">General</a><ul> +<li><a class="reference internal" href="#startup" id="id30">Startup</a></li> +<li><a class="reference internal" href="#opening-files-from-the-command-line-in-a-running-instance" id="id31">Opening files from the command-line in a running instance</a></li> +<li><a class="reference internal" href="#virtual-terminal-emulator-widget-vte" id="id32">Virtual terminal emulator widget (VTE)</a></li> +<li><a class="reference internal" href="#defining-own-widget-styles-using-gtkrc-2-0" id="id33">Defining own widget styles using .gtkrc-2.0</a></li> </ul> </li> -<li><a class="reference" href="#documents" id="id34" name="id34">Documents</a><ul> -<li><a class="reference" href="#switching-between-documents" id="id35" name="id35">Switching between documents</a></li> +<li><a class="reference internal" href="#documents" id="id34">Documents</a><ul> +<li><a class="reference internal" href="#switching-between-documents" id="id35">Switching between documents</a></li> </ul> </li> -<li><a class="reference" href="#character-sets-and-unicode-byte-order-mark-bom" id="id36" name="id36">Character sets and Unicode Byte-Order-Mark (BOM)</a><ul> -<li><a class="reference" href="#using-character-sets" id="id37" name="id37">Using character sets</a></li> -<li><a class="reference" href="#in-file-encoding-specification" id="id38" name="id38">In-file encoding specification</a></li> -<li><a class="reference" href="#special-encoding-none" id="id39" name="id39">Special encoding "None"</a></li> -<li><a class="reference" href="#unicode-byte-order-mark-bom" id="id40" name="id40">Unicode Byte-Order-Mark (BOM)</a></li> +<li><a class="reference internal" href="#character-sets-and-unicode-byte-order-mark-bom" id="id36">Character sets and Unicode Byte-Order-Mark (BOM)</a><ul> +<li><a class="reference internal" href="#using-character-sets" id="id37">Using character sets</a></li> +<li><a class="reference internal" href="#in-file-encoding-specification" id="id38">In-file encoding specification</a></li> +<li><a class="reference internal" href="#special-encoding-none" id="id39">Special encoding "None"</a></li> +<li><a class="reference internal" href="#unicode-byte-order-mark-bom" id="id40">Unicode Byte-Order-Mark (BOM)</a></li> </ul> </li> -<li><a class="reference" href="#editing" id="id41" name="id41">Editing</a><ul> -<li><a class="reference" href="#folding" id="id42" name="id42">Folding</a></li> -<li><a class="reference" href="#column-mode-editing-rectangular-selections" id="id43" name="id43">Column mode editing (rectangular selections)</a></li> -<li><a class="reference" href="#drag-and-drop-of-text" id="id44" name="id44">Drag and drop of text</a></li> -<li><a class="reference" href="#indentation" id="id45" name="id45">Indentation</a></li> -<li><a class="reference" href="#auto-indentation" id="id46" name="id46">Auto-indentation</a></li> -<li><a class="reference" href="#bookmarks" id="id47" name="id47">Bookmarks</a></li> -<li><a class="reference" href="#code-navigation-history" id="id48" name="id48">Code navigation history</a></li> -<li><a class="reference" href="#sending-text-through-custom-commands" id="id49" name="id49">Sending text through custom commands</a></li> -<li><a class="reference" href="#context-actions" id="id50" name="id50">Context actions</a></li> -<li><a class="reference" href="#autocompletion" id="id51" name="id51">Autocompletion</a><ul> -<li><a class="reference" href="#word-part-completion" id="id52" name="id52">Word part completion</a></li> -<li><a class="reference" href="#scope-autocompletion" id="id53" name="id53">Scope autocompletion</a></li> +<li><a class="reference internal" href="#editing" id="id41">Editing</a><ul> +<li><a class="reference internal" href="#folding" id="id42">Folding</a></li> +<li><a class="reference internal" href="#column-mode-editing-rectangular-selections" id="id43">Column mode editing (rectangular selections)</a></li> +<li><a class="reference internal" href="#drag-and-drop-of-text" id="id44">Drag and drop of text</a></li> +<li><a class="reference internal" href="#indentation" id="id45">Indentation</a></li> +<li><a class="reference internal" href="#auto-indentation" id="id46">Auto-indentation</a></li> +<li><a class="reference internal" href="#bookmarks" id="id47">Bookmarks</a></li> +<li><a class="reference internal" href="#code-navigation-history" id="id48">Code navigation history</a></li> +<li><a class="reference internal" href="#sending-text-through-custom-commands" id="id49">Sending text through custom commands</a></li> +<li><a class="reference internal" href="#context-actions" id="id50">Context actions</a></li> +<li><a class="reference internal" href="#autocompletion" id="id51">Autocompletion</a><ul> +<li><a class="reference internal" href="#word-part-completion" id="id52">Word part completion</a></li> +<li><a class="reference internal" href="#scope-autocompletion" id="id53">Scope autocompletion</a></li> </ul> </li> -<li><a class="reference" href="#user-definable-snippets" id="id54" name="id54">User-definable snippets</a></li> -<li><a class="reference" href="#inserting-unicode-characters" id="id55" name="id55">Inserting Unicode characters</a></li> +<li><a class="reference internal" href="#user-definable-snippets" id="id54">User-definable snippets</a></li> +<li><a class="reference internal" href="#inserting-unicode-characters" id="id55">Inserting Unicode characters</a></li> </ul> </li> -<li><a class="reference" href="#search-replace-and-go-to" id="id56" name="id56">Search, replace and go to</a><ul> -<li><a class="reference" href="#toolbar-entries" id="id57" name="id57">Toolbar entries</a><ul> -<li><a class="reference" href="#search-bar" id="id58" name="id58">Search bar</a></li> +<li><a class="reference internal" href="#search-replace-and-go-to" id="id56">Search, replace and go to</a><ul> +<li><a class="reference internal" href="#toolbar-entries" id="id57">Toolbar entries</a><ul> +<li><a class="reference internal" href="#search-bar" id="id58">Search bar</a></li> </ul> </li> -<li><a class="reference" href="#find" id="id59" name="id59">Find</a><ul> -<li><a class="reference" href="#matching-options" id="id60" name="id60">Matching options</a></li> -<li><a class="reference" href="#find-all" id="id61" name="id61">Find all</a></li> -<li><a class="reference" href="#change-font-in-search-dialog-text-fields" id="id62" name="id62">Change font in search dialog text fields</a></li> +<li><a class="reference internal" href="#find" id="id59">Find</a><ul> +<li><a class="reference internal" href="#matching-options" id="id60">Matching options</a></li> +<li><a class="reference internal" href="#find-all" id="id61">Find all</a></li> +<li><a class="reference internal" href="#change-font-in-search-dialog-text-fields" id="id62">Change font in search dialog text fields</a></li> </ul> </li> -<li><a class="reference" href="#find-selection" id="id63" name="id63">Find selection</a></li> -<li><a class="reference" href="#find-usage" id="id64" name="id64">Find usage</a></li> -<li><a class="reference" href="#find-in-files" id="id65" name="id65">Find in files</a><ul> -<li><a class="reference" href="#filtering-out-version-control-files" id="id66" name="id66">Filtering out version control files</a></li> +<li><a class="reference internal" href="#find-selection" id="id63">Find selection</a></li> +<li><a class="reference internal" href="#find-usage" id="id64">Find usage</a></li> +<li><a class="reference internal" href="#find-in-files" id="id65">Find in files</a><ul> +<li><a class="reference internal" href="#filtering-out-version-control-files" id="id66">Filtering out version control files</a></li> </ul> </li> -<li><a class="reference" href="#replace" id="id67" name="id67">Replace</a><ul> -<li><a class="reference" href="#replace-all" id="id68" name="id68">Replace all</a></li> +<li><a class="reference internal" href="#replace" id="id67">Replace</a><ul> +<li><a class="reference internal" href="#replace-all" id="id68">Replace all</a></li> </ul> </li> -<li><a class="reference" href="#go-to-tag-definition" id="id69" name="id69">Go to tag definition</a></li> -<li><a class="reference" href="#go-to-tag-declaration" id="id70" name="id70">Go to tag declaration</a></li> -<li><a class="reference" href="#go-to-line" id="id71" name="id71">Go to line</a></li> -<li><a class="reference" href="#regular-expressions" id="id72" name="id72">Regular expressions</a></li> +<li><a class="reference internal" href="#go-to-tag-definition" id="id69">Go to tag definition</a></li> +<li><a class="reference internal" href="#go-to-tag-declaration" id="id70">Go to tag declaration</a></li> +<li><a class="reference internal" href="#go-to-line" id="id71">Go to line</a></li> +<li><a class="reference internal" href="#regular-expressions" id="id72">Regular expressions</a></li> </ul> </li> -<li><a class="reference" href="#tags" id="id73" name="id73">Tags</a><ul> -<li><a class="reference" href="#workspace-tags" id="id74" name="id74">Workspace tags</a></li> -<li><a class="reference" href="#global-tags" id="id75" name="id75">Global tags</a><ul> -<li><a class="reference" href="#default-global-tags-files" id="id76" name="id76">Default global tags files</a></li> -<li><a class="reference" href="#global-tags-file-format" id="id77" name="id77">Global tags file format</a></li> -<li><a class="reference" href="#generating-a-global-tags-file" id="id78" name="id78">Generating a global tags file</a></li> +<li><a class="reference internal" href="#tags" id="id73">Tags</a><ul> +<li><a class="reference internal" href="#workspace-tags" id="id74">Workspace tags</a></li> +<li><a class="reference internal" href="#global-tags" id="id75">Global tags</a><ul> +<li><a class="reference internal" href="#default-global-tags-files" id="id76">Default global tags files</a></li> +<li><a class="reference internal" href="#global-tags-file-format" id="id77">Global tags file format</a></li> +<li><a class="reference internal" href="#generating-a-global-tags-file" id="id78">Generating a global tags file</a></li> </ul> </li> -<li><a class="reference" href="#ignore-tags" id="id79" name="id79">Ignore tags</a></li> +<li><a class="reference internal" href="#ignore-tags" id="id79">Ignore tags</a></li> </ul> </li> -<li><a class="reference" href="#preferences" id="id80" name="id80">Preferences</a><ul> -<li><a class="reference" href="#general-startup-preferences" id="id81" name="id81">General Startup preferences</a><ul> -<li><a class="reference" href="#id1" id="id82" name="id82">Startup</a></li> -<li><a class="reference" href="#shutdown" id="id83" name="id83">Shutdown</a></li> -<li><a class="reference" href="#paths" id="id84" name="id84">Paths</a></li> +<li><a class="reference internal" href="#preferences" id="id80">Preferences</a><ul> +<li><a class="reference internal" href="#general-startup-preferences" id="id81">General Startup preferences</a><ul> +<li><a class="reference internal" href="#id1" id="id82">Startup</a></li> +<li><a class="reference internal" href="#shutdown" id="id83">Shutdown</a></li> +<li><a class="reference internal" href="#paths" id="id84">Paths</a></li> </ul> </li> -<li><a class="reference" href="#general-miscellaneous-preferences" id="id85" name="id85">General Miscellaneous preferences</a><ul> -<li><a class="reference" href="#miscellaneous" id="id86" name="id86">Miscellaneous</a></li> -<li><a class="reference" href="#search" id="id87" name="id87">Search</a></li> -<li><a class="reference" href="#projects" id="id88" name="id88">Projects</a></li> +<li><a class="reference internal" href="#general-miscellaneous-preferences" id="id85">General Miscellaneous preferences</a><ul> +<li><a class="reference internal" href="#miscellaneous" id="id86">Miscellaneous</a></li> +<li><a class="reference internal" href="#search" id="id87">Search</a></li> +<li><a class="reference internal" href="#projects" id="id88">Projects</a></li> </ul> </li> -<li><a class="reference" href="#interface-preferences" id="id89" name="id89">Interface preferences</a><ul> -<li><a class="reference" href="#sidebar" id="id90" name="id90">Sidebar</a></li> -<li><a class="reference" href="#fonts" id="id91" name="id91">Fonts</a></li> -<li><a class="reference" href="#editor-tabs" id="id92" name="id92">Editor tabs</a></li> -<li><a class="reference" href="#tab-positions" id="id93" name="id93">Tab positions</a></li> -<li><a class="reference" href="#id2" id="id94" name="id94">Miscellaneous</a></li> +<li><a class="reference internal" href="#interface-preferences" id="id89">Interface preferences</a><ul> +<li><a class="reference internal" href="#sidebar" id="id90">Sidebar</a></li> +<li><a class="reference internal" href="#fonts" id="id91">Fonts</a></li> +<li><a class="reference internal" href="#editor-tabs" id="id92">Editor tabs</a></li> +<li><a class="reference internal" href="#tab-positions" id="id93">Tab positions</a></li> +<li><a class="reference internal" href="#id2" id="id94">Miscellaneous</a></li> </ul> </li> -<li><a class="reference" href="#toolbar-preferences" id="id95" name="id95">Toolbar preferences</a><ul> -<li><a class="reference" href="#toolbar" id="id96" name="id96">Toolbar</a></li> -<li><a class="reference" href="#appearance" id="id97" name="id97">Appearance</a></li> +<li><a class="reference internal" href="#toolbar-preferences" id="id95">Toolbar preferences</a><ul> +<li><a class="reference internal" href="#toolbar" id="id96">Toolbar</a></li> +<li><a class="reference internal" href="#appearance" id="id97">Appearance</a></li> </ul> </li> -<li><a class="reference" href="#editor-features-preferences" id="id98" name="id98">Editor Features preferences</a><ul> -<li><a class="reference" href="#features" id="id99" name="id99">Features</a></li> +<li><a class="reference internal" href="#editor-features-preferences" id="id98">Editor Features preferences</a><ul> +<li><a class="reference internal" href="#features" id="id99">Features</a></li> </ul> </li> -<li><a class="reference" href="#editor-indentation-preferences" id="id100" name="id100">Editor Indentation preferences</a><ul> -<li><a class="reference" href="#indentation-group" id="id101" name="id101">Indentation group</a></li> +<li><a class="reference internal" href="#editor-indentation-preferences" id="id100">Editor Indentation preferences</a><ul> +<li><a class="reference internal" href="#indentation-group" id="id101">Indentation group</a></li> </ul> </li> -<li><a class="reference" href="#editor-completions-preferences" id="id102" name="id102">Editor Completions preferences</a><ul> -<li><a class="reference" href="#completions" id="id103" name="id103">Completions</a></li> -<li><a class="reference" href="#auto-close-quotes-and-brackets" id="id104" name="id104">Auto-close quotes and brackets</a></li> +<li><a class="reference internal" href="#editor-completions-preferences" id="id102">Editor Completions preferences</a><ul> +<li><a class="reference internal" href="#completions" id="id103">Completions</a></li> +<li><a class="reference internal" href="#auto-close-quotes-and-brackets" id="id104">Auto-close quotes and brackets</a></li> </ul> </li> -<li><a class="reference" href="#editor-display-preferences" id="id105" name="id105">Editor Display preferences</a><ul> -<li><a class="reference" href="#display" id="id106" name="id106">Display</a></li> -<li><a class="reference" href="#long-line-marker" id="id107" name="id107">Long line marker</a></li> -<li><a class="reference" href="#virtual-spaces" id="id108" name="id108">Virtual spaces</a></li> +<li><a class="reference internal" href="#editor-display-preferences" id="id105">Editor Display preferences</a><ul> +<li><a class="reference internal" href="#display" id="id106">Display</a></li> +<li><a class="reference internal" href="#long-line-marker" id="id107">Long line marker</a></li> +<li><a class="reference internal" href="#virtual-spaces" id="id108">Virtual spaces</a></li> </ul> </li> -<li><a class="reference" href="#files-preferences" id="id109" name="id109">Files preferences</a><ul> -<li><a class="reference" href="#new-files" id="id110" name="id110">New files</a></li> -<li><a class="reference" href="#saving-files" id="id111" name="id111">Saving files</a></li> -<li><a class="reference" href="#id3" id="id112" name="id112">Miscellaneous</a></li> +<li><a class="reference internal" href="#files-preferences" id="id109">Files preferences</a><ul> +<li><a class="reference internal" href="#new-files" id="id110">New files</a></li> +<li><a class="reference internal" href="#saving-files" id="id111">Saving files</a></li> +<li><a class="reference internal" href="#id3" id="id112">Miscellaneous</a></li> </ul> </li> -<li><a class="reference" href="#tools-preferences" id="id113" name="id113">Tools preferences</a><ul> -<li><a class="reference" href="#tool-paths" id="id114" name="id114">Tool paths</a></li> -<li><a class="reference" href="#commands" id="id115" name="id115">Commands</a></li> +<li><a class="reference internal" href="#tools-preferences" id="id113">Tools preferences</a><ul> +<li><a class="reference internal" href="#tool-paths" id="id114">Tool paths</a></li> +<li><a class="reference internal" href="#commands" id="id115">Commands</a></li> </ul> </li> -<li><a class="reference" href="#template-preferences" id="id116" name="id116">Template preferences</a><ul> -<li><a class="reference" href="#template-data" id="id117" name="id117">Template data</a></li> +<li><a class="reference internal" href="#template-preferences" id="id116">Template preferences</a><ul> +<li><a class="reference internal" href="#template-data" id="id117">Template data</a></li> </ul> </li> -<li><a class="reference" href="#keybinding-preferences" id="id118" name="id118">Keybinding preferences</a></li> -<li><a class="reference" href="#printing-preferences" id="id119" name="id119">Printing preferences</a></li> -<li><a class="reference" href="#terminal-vte-preferences" id="id120" name="id120">Terminal (VTE) preferences</a><ul> -<li><a class="reference" href="#terminal-widget" id="id121" name="id121">Terminal widget</a></li> +<li><a class="reference internal" href="#keybinding-preferences" id="id118">Keybinding preferences</a></li> +<li><a class="reference internal" href="#printing-preferences" id="id119">Printing preferences</a></li> +<li><a class="reference internal" href="#terminal-vte-preferences" id="id120">Terminal (VTE) preferences</a><ul> +<li><a class="reference internal" href="#terminal-widget" id="id121">Terminal widget</a></li> </ul> </li> </ul> </li> -<li><a class="reference" href="#project-management" id="id122" name="id122">Project Management</a><ul> -<li><a class="reference" href="#new-project" id="id123" name="id123">New Project</a></li> -<li><a class="reference" href="#project-properties" id="id124" name="id124">Project Properties</a></li> -<li><a class="reference" href="#open-project" id="id125" name="id125">Open Project</a></li> -<li><a class="reference" href="#close-project" id="id126" name="id126">Close Project</a></li> +<li><a class="reference internal" href="#project-management" id="id122">Project Management</a><ul> +<li><a class="reference internal" href="#new-project" id="id123">New Project</a></li> +<li><a class="reference internal" href="#project-properties" id="id124">Project Properties</a></li> +<li><a class="reference internal" href="#open-project" id="id125">Open Project</a></li> +<li><a class="reference internal" href="#close-project" id="id126">Close Project</a></li> </ul> </li> -<li><a class="reference" href="#build-menu" id="id127" name="id127">Build Menu</a><ul> -<li><a class="reference" href="#indicators" id="id128" name="id128">Indicators</a></li> -<li><a class="reference" href="#default-build-menu-items" id="id129" name="id129">Default Build Menu Items</a><ul> -<li><a class="reference" href="#compile" id="id130" name="id130">Compile</a></li> -<li><a class="reference" href="#build" id="id131" name="id131">Build</a></li> -<li><a class="reference" href="#make" id="id132" name="id132">Make</a></li> -<li><a class="reference" href="#make-custom-target" id="id133" name="id133">Make custom target</a></li> -<li><a class="reference" href="#make-object" id="id134" name="id134">Make object</a></li> -<li><a class="reference" href="#next-error" id="id135" name="id135">Next Error</a></li> -<li><a class="reference" href="#previous-error" id="id136" name="id136">Previous Error</a></li> -<li><a class="reference" href="#execute" id="id137" name="id137">Execute</a></li> -<li><a class="reference" href="#stopping-running-processes" id="id138" name="id138">Stopping running processes</a><ul> -<li><a class="reference" href="#terminal-emulators" id="id139" name="id139">Terminal emulators</a></li> +<li><a class="reference internal" href="#build-menu" id="id127">Build Menu</a><ul> +<li><a class="reference internal" href="#indicators" id="id128">Indicators</a></li> +<li><a class="reference internal" href="#default-build-menu-items" id="id129">Default Build Menu Items</a><ul> +<li><a class="reference internal" href="#compile" id="id130">Compile</a></li> +<li><a class="reference internal" href="#build" id="id131">Build</a></li> +<li><a class="reference internal" href="#make" id="id132">Make</a></li> +<li><a class="reference internal" href="#make-custom-target" id="id133">Make custom target</a></li> +<li><a class="reference internal" href="#make-object" id="id134">Make object</a></li> +<li><a class="reference internal" href="#next-error" id="id135">Next Error</a></li> +<li><a class="reference internal" href="#previous-error" id="id136">Previous Error</a></li> +<li><a class="reference internal" href="#execute" id="id137">Execute</a></li> +<li><a class="reference internal" href="#stopping-running-processes" id="id138">Stopping running processes</a><ul> +<li><a class="reference internal" href="#terminal-emulators" id="id139">Terminal emulators</a></li> </ul> </li> -<li><a class="reference" href="#set-build-commands" id="id140" name="id140">Set Build Commands</a></li> +<li><a class="reference internal" href="#set-build-commands" id="id140">Set Build Commands</a></li> </ul> </li> -<li><a class="reference" href="#build-menu-configuration" id="id141" name="id141">Build Menu Configuration</a></li> -<li><a class="reference" href="#build-menu-commands-dialog" id="id142" name="id142">Build Menu Commands Dialog</a><ul> -<li><a class="reference" href="#substitutions-in-commands-and-working-directories" id="id143" name="id143">Substitutions in Commands and Working Directories</a></li> -<li><a class="reference" href="#build-menu-keyboard-shortcuts" id="id144" name="id144">Build Menu Keyboard Shortcuts</a></li> -<li><a class="reference" href="#configuration-files" id="id145" name="id145">Configuration Files</a></li> +<li><a class="reference internal" href="#build-menu-configuration" id="id141">Build Menu Configuration</a></li> +<li><a class="reference internal" href="#build-menu-commands-dialog" id="id142">Build Menu Commands Dialog</a><ul> +<li><a class="reference internal" href="#substitutions-in-commands-and-working-directories" id="id143">Substitutions in Commands and Working Directories</a></li> +<li><a class="reference internal" href="#build-menu-keyboard-shortcuts" id="id144">Build Menu Keyboard Shortcuts</a></li> +<li><a class="reference internal" href="#configuration-files" id="id145">Configuration Files</a></li> </ul> </li> </ul> </li> -<li><a class="reference" href="#printing-support" id="id146" name="id146">Printing support</a></li> -<li><a class="reference" href="#plugins" id="id147" name="id147">Plugins</a></li> -<li><a class="reference" href="#keybindings" id="id148" name="id148">Keybindings</a><ul> -<li><a class="reference" href="#switching-documents" id="id149" name="id149">Switching documents</a></li> -<li><a class="reference" href="#configurable-keybindings" id="id150" name="id150">Configurable keybindings</a><ul> -<li><a class="reference" href="#file-keybindings" id="id151" name="id151">File keybindings</a></li> -<li><a class="reference" href="#editor-keybindings" id="id152" name="id152">Editor keybindings</a></li> -<li><a class="reference" href="#clipboard-keybindings" id="id153" name="id153">Clipboard keybindings</a></li> -<li><a class="reference" href="#select-keybindings" id="id154" name="id154">Select keybindings</a></li> -<li><a class="reference" href="#insert-keybindings" id="id155" name="id155">Insert keybindings</a></li> -<li><a class="reference" href="#format-keybindings" id="id156" name="id156">Format keybindings</a></li> -<li><a class="reference" href="#settings-keybindings" id="id157" name="id157">Settings keybindings</a></li> -<li><a class="reference" href="#search-keybindings" id="id158" name="id158">Search keybindings</a></li> -<li><a class="reference" href="#go-to-keybindings" id="id159" name="id159">Go to keybindings</a></li> -<li><a class="reference" href="#view-keybindings" id="id160" name="id160">View keybindings</a></li> -<li><a class="reference" href="#focus-keybindings" id="id161" name="id161">Focus keybindings</a></li> -<li><a class="reference" href="#notebook-tab-keybindings" id="id162" name="id162">Notebook tab keybindings</a></li> -<li><a class="reference" href="#document-keybindings" id="id163" name="id163">Document keybindings</a></li> -<li><a class="reference" href="#build-keybindings" id="id164" name="id164">Build keybindings</a></li> -<li><a class="reference" href="#tools-keybindings" id="id165" name="id165">Tools keybindings</a></li> -<li><a class="reference" href="#help-keybindings" id="id166" name="id166">Help keybindings</a></li> +<li><a class="reference internal" href="#printing-support" id="id146">Printing support</a></li> +<li><a class="reference internal" href="#plugins" id="id147">Plugins</a></li> +<li><a class="reference internal" href="#keybindings" id="id148">Keybindings</a><ul> +<li><a class="reference internal" href="#switching-documents" id="id149">Switching documents</a></li> +<li><a class="reference internal" href="#configurable-keybindings" id="id150">Configurable keybindings</a><ul> +<li><a class="reference internal" href="#file-keybindings" id="id151">File keybindings</a></li> +<li><a class="reference internal" href="#editor-keybindings" id="id152">Editor keybindings</a></li> +<li><a class="reference internal" href="#clipboard-keybindings" id="id153">Clipboard keybindings</a></li> +<li><a class="reference internal" href="#select-keybindings" id="id154">Select keybindings</a></li> +<li><a class="reference internal" href="#insert-keybindings" id="id155">Insert keybindings</a></li> +<li><a class="reference internal" href="#format-keybindings" id="id156">Format keybindings</a></li> +<li><a class="reference internal" href="#settings-keybindings" id="id157">Settings keybindings</a></li> +<li><a class="reference internal" href="#search-keybindings" id="id158">Search keybindings</a></li> +<li><a class="reference internal" href="#go-to-keybindings" id="id159">Go to keybindings</a></li> +<li><a class="reference internal" href="#view-keybindings" id="id160">View keybindings</a></li> +<li><a class="reference internal" href="#focus-keybindings" id="id161">Focus keybindings</a></li> +<li><a class="reference internal" href="#notebook-tab-keybindings" id="id162">Notebook tab keybindings</a></li> +<li><a class="reference internal" href="#document-keybindings" id="id163">Document keybindings</a></li> +<li><a class="reference internal" href="#build-keybindings" id="id164">Build keybindings</a></li> +<li><a class="reference internal" href="#tools-keybindings" id="id165">Tools keybindings</a></li> +<li><a class="reference internal" href="#help-keybindings" id="id166">Help keybindings</a></li> </ul> </li> </ul> </li> </ul> </li> -<li><a class="reference" href="#id4" id="id167" name="id167">Configuration files</a><ul> -<li><a class="reference" href="#tools-menu-items" id="id168" name="id168">Tools menu items</a></li> -<li><a class="reference" href="#global-configuration-file" id="id169" name="id169">Global configuration file</a></li> -<li><a class="reference" href="#filetype-definition-files" id="id170" name="id170">Filetype definition files</a><ul> -<li><a class="reference" href="#custom-filetypes" id="id171" name="id171">Custom filetypes</a></li> -<li><a class="reference" href="#system-files" id="id172" name="id172">System files</a></li> -<li><a class="reference" href="#user-files" id="id173" name="id173">User files</a></li> -<li><a class="reference" href="#format" id="id174" name="id174">Format</a><ul> -<li><a class="reference" href="#styling-section" id="id175" name="id175">[styling] Section</a><ul> -<li><a class="reference" href="#using-a-named-style" id="id176" name="id176">Using a named style</a></li> +<li><a class="reference internal" href="#id4" id="id167">Configuration files</a><ul> +<li><a class="reference internal" href="#tools-menu-items" id="id168">Tools menu items</a></li> +<li><a class="reference internal" href="#global-configuration-file" id="id169">Global configuration file</a></li> +<li><a class="reference internal" href="#filetype-definition-files" id="id170">Filetype definition files</a><ul> +<li><a class="reference internal" href="#custom-filetypes" id="id171">Custom filetypes</a></li> +<li><a class="reference internal" href="#system-files" id="id172">System files</a></li> +<li><a class="reference internal" href="#user-files" id="id173">User files</a></li> +<li><a class="reference internal" href="#format" id="id174">Format</a><ul> +<li><a class="reference internal" href="#styling-section" id="id175">[styling] Section</a><ul> +<li><a class="reference internal" href="#using-a-named-style" id="id176">Using a named style</a></li> </ul> </li> -<li><a class="reference" href="#keywords-section" id="id177" name="id177">[keywords] Section</a></li> -<li><a class="reference" href="#lexer-properties-section" id="id178" name="id178">[lexer_properties] Section</a></li> -<li><a class="reference" href="#settings-section" id="id179" name="id179">[settings] Section</a></li> -<li><a class="reference" href="#build-settings-section" id="id180" name="id180">[build_settings] Section</a></li> +<li><a class="reference internal" href="#keywords-section" id="id177">[keywords] Section</a></li> +<li><a class="reference internal" href="#lexer-properties-section" id="id178">[lexer_properties] Section</a></li> +<li><a class="reference internal" href="#settings-section" id="id179">[settings] Section</a></li> +<li><a class="reference internal" href="#build-settings-section" id="id180">[build_settings] Section</a></li> </ul> </li> -<li><a class="reference" href="#special-file-filetypes-common" id="id181" name="id181">Special file filetypes.common</a><ul> -<li><a class="reference" href="#named-styles-section" id="id182" name="id182">[named_styles] Section</a></li> -<li><a class="reference" href="#id5" id="id183" name="id183">[styling] Section</a></li> -<li><a class="reference" href="#id6" id="id184" name="id184">[settings] Section</a></li> +<li><a class="reference internal" href="#special-file-filetypes-common" id="id181">Special file filetypes.common</a><ul> +<li><a class="reference internal" href="#named-styles-section" id="id182">[named_styles] Section</a></li> +<li><a class="reference internal" href="#id5" id="id183">[styling] Section</a></li> +<li><a class="reference internal" href="#id6" id="id184">[settings] Section</a></li> </ul> </li> </ul> </li> -<li><a class="reference" href="#filetype-extensions" id="id185" name="id185">Filetype extensions</a></li> -<li><a class="reference" href="#preferences-file-format" id="id186" name="id186">Preferences File Format</a><ul> -<li><a class="reference" href="#hidden-preferences" id="id187" name="id187">Hidden preferences</a></li> -<li><a class="reference" href="#build-menu-section" id="id188" name="id188">[build-menu] Section</a></li> +<li><a class="reference internal" href="#filetype-extensions" id="id185">Filetype extensions</a></li> +<li><a class="reference internal" href="#preferences-file-format" id="id186">Preferences File Format</a><ul> +<li><a class="reference internal" href="#hidden-preferences" id="id187">Hidden preferences</a></li> +<li><a class="reference internal" href="#build-menu-section" id="id188">[build-menu] Section</a></li> </ul> </li> -<li><a class="reference" href="#project-file-format" id="id189" name="id189">Project File Format</a><ul> -<li><a class="reference" href="#build-menu-additions" id="id190" name="id190">[build-menu] Additions</a></li> +<li><a class="reference internal" href="#project-file-format" id="id189">Project File Format</a><ul> +<li><a class="reference internal" href="#build-menu-additions" id="id190">[build-menu] Additions</a></li> </ul> </li> -<li><a class="reference" href="#templates" id="id191" name="id191">Templates</a><ul> -<li><a class="reference" href="#template-meta-data" id="id192" name="id192">Template meta data</a></li> -<li><a class="reference" href="#file-templates" id="id193" name="id193">File templates</a><ul> -<li><a class="reference" href="#custom-file-templates" id="id194" name="id194">Custom file templates</a></li> -<li><a class="reference" href="#filetype-templates" id="id195" name="id195">Filetype templates</a></li> +<li><a class="reference internal" href="#templates" id="id191">Templates</a><ul> +<li><a class="reference internal" href="#template-meta-data" id="id192">Template meta data</a></li> +<li><a class="reference internal" href="#file-templates" id="id193">File templates</a><ul> +<li><a class="reference internal" href="#custom-file-templates" id="id194">Custom file templates</a></li> +<li><a class="reference internal" href="#filetype-templates" id="id195">Filetype templates</a></li> </ul> </li> -<li><a class="reference" href="#customizing-templates" id="id196" name="id196">Customizing templates</a><ul> -<li><a class="reference" href="#template-wildcards" id="id197" name="id197">Template wildcards</a><ul> -<li><a class="reference" href="#special-command-wildcard" id="id198" name="id198">Special {command:} wildcard</a></li> +<li><a class="reference internal" href="#customizing-templates" id="id196">Customizing templates</a><ul> +<li><a class="reference internal" href="#template-wildcards" id="id197">Template wildcards</a><ul> +<li><a class="reference internal" href="#special-command-wildcard" id="id198">Special {command:} wildcard</a></li> </ul> </li> </ul> </li> </ul> </li> -<li><a class="reference" href="#customizing-the-toolbar" id="id199" name="id199">Customizing the toolbar</a><ul> -<li><a class="reference" href="#manually-editing-of-the-toolbar-layout" id="id200" name="id200">Manually editing of the toolbar layout</a></li> -<li><a class="reference" href="#available-toolbar-elements" id="id201" name="id201">Available toolbar elements</a></li> +<li><a class="reference internal" href="#customizing-the-toolbar" id="id199">Customizing the toolbar</a><ul> +<li><a class="reference internal" href="#manually-editing-of-the-toolbar-layout" id="id200">Manually editing of the toolbar layout</a></li> +<li><a class="reference internal" href="#available-toolbar-elements" id="id201">Available toolbar elements</a></li> </ul> </li> </ul> </li> -<li><a class="reference" href="#plugin-documentation" id="id202" name="id202">Plugin documentation</a><ul> -<li><a class="reference" href="#save-actions" id="id203" name="id203">Save Actions</a><ul> -<li><a class="reference" href="#instant-save" id="id204" name="id204">Instant Save</a></li> -<li><a class="reference" href="#backup-copy" id="id205" name="id205">Backup Copy</a></li> +<li><a class="reference internal" href="#plugin-documentation" id="id202">Plugin documentation</a><ul> +<li><a class="reference internal" href="#save-actions" id="id203">Save Actions</a><ul> +<li><a class="reference internal" href="#instant-save" id="id204">Instant Save</a></li> +<li><a class="reference internal" href="#backup-copy" id="id205">Backup Copy</a></li> </ul> </li> </ul> </li> -<li><a class="reference" href="#contributing-to-this-document" id="id206" name="id206">Contributing to this document</a></li> -<li><a class="reference" href="#scintilla-keyboard-commands" id="id207" name="id207">Scintilla keyboard commands</a><ul> -<li><a class="reference" href="#keyboard-commands" id="id208" name="id208">Keyboard commands</a></li> +<li><a class="reference internal" href="#contributing-to-this-document" id="id206">Contributing to this document</a></li> +<li><a class="reference internal" href="#scintilla-keyboard-commands" id="id207">Scintilla keyboard commands</a><ul> +<li><a class="reference internal" href="#keyboard-commands" id="id208">Keyboard commands</a></li> </ul> </li> -<li><a class="reference" href="#tips-and-tricks" id="id209" name="id209">Tips and tricks</a><ul> -<li><a class="reference" href="#document-notebook" id="id210" name="id210">Document notebook</a></li> -<li><a class="reference" href="#editor" id="id211" name="id211">Editor</a></li> -<li><a class="reference" href="#interface" id="id212" name="id212">Interface</a></li> -<li><a class="reference" href="#gtk-related" id="id213" name="id213">GTK-related</a></li> +<li><a class="reference internal" href="#tips-and-tricks" id="id209">Tips and tricks</a><ul> +<li><a class="reference internal" href="#document-notebook" id="id210">Document notebook</a></li> +<li><a class="reference internal" href="#editor" id="id211">Editor</a></li> +<li><a class="reference internal" href="#interface" id="id212">Interface</a></li> +<li><a class="reference internal" href="#gtk-related" id="id213">GTK-related</a></li> </ul> </li> -<li><a class="reference" href="#compile-time-options" id="id214" name="id214">Compile-time options</a><ul> -<li><a class="reference" href="#src-geany-h" id="id215" name="id215">src/geany.h</a></li> -<li><a class="reference" href="#project-h" id="id216" name="id216">project.h</a></li> -<li><a class="reference" href="#editor-h" id="id217" name="id217">editor.h</a></li> -<li><a class="reference" href="#keyfile-c" id="id218" name="id218">keyfile.c</a></li> -<li><a class="reference" href="#build-c" id="id219" name="id219">build.c</a></li> +<li><a class="reference internal" href="#compile-time-options" id="id214">Compile-time options</a><ul> +<li><a class="reference internal" href="#src-geany-h" id="id215">src/geany.h</a></li> +<li><a class="reference internal" href="#project-h" id="id216">project.h</a></li> +<li><a class="reference internal" href="#editor-h" id="id217">editor.h</a></li> +<li><a class="reference internal" href="#keyfile-c" id="id218">keyfile.c</a></li> +<li><a class="reference internal" href="#build-c" id="id219">build.c</a></li> </ul> </li> -<li><a class="reference" href="#gnu-general-public-license" id="id220" name="id220">GNU General Public License</a></li> -<li><a class="reference" href="#license-for-scintilla-and-scite" id="id221" name="id221">License for Scintilla and SciTE</a></li> +<li><a class="reference internal" href="#gnu-general-public-license" id="id220">GNU General Public License</a></li> +<li><a class="reference internal" href="#license-for-scintilla-and-scite" id="id221">License for Scintilla and SciTE</a></li> </ul> </div> -<div class="section"> -<h1><a class="toc-backref" href="#id8" id="introduction" name="introduction">Introduction</a></h1> -<div class="section"> -<h2><a class="toc-backref" href="#id9" id="about-geany" name="about-geany">About Geany</a></h2> +<div class="section" id="introduction"> +<h1><a class="toc-backref" href="#id8">Introduction</a></h1> +<div class="section" id="about-geany"> +<h2><a class="toc-backref" href="#id9">About Geany</a></h2> <p>Geany is a small and lightweight Integrated Development Environment. It was developed to provide a small and fast IDE, which has only a few dependencies on other packages. Another goal was to be as independent @@ -505,56 +505,56 @@ <li>Plugin interface</li> </ul> </div> -<div class="section"> -<h2><a class="toc-backref" href="#id10" id="where-to-get-it" name="where-to-get-it">Where to get it</a></h2> -<p>You can obtain Geany from <a class="reference" href="http://www.geany.org/">http://www.geany.org/</a> or perhaps also from +<div class="section" id="where-to-get-it"> +<h2><a class="toc-backref" href="#id10">Where to get it</a></h2> +<p>You can obtain Geany from <a class="reference external" href="http://www.geany.org/">http://www.geany.org/</a> or perhaps also from your distribution. For a list of available packages, please see -<a class="reference" href="http://www.geany.org/Download/ThirdPartyPackages">http://www.geany.org/Download/ThirdPartyPackages</a>.</p> +<a class="reference external" href="http://www.geany.org/Download/ThirdPartyPackages">http://www.geany.org/Download/ThirdPartyPackages</a>.</p> </div> -<div class="section"> -<h2><a class="toc-backref" href="#id11" id="license" name="license">License</a></h2> +<div class="section" id="license"> +<h2><a class="toc-backref" href="#id11">License</a></h2> <p>Geany is distributed under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. A copy of this license can be found in the file COPYING included with the source -code of this program and in the chapter, <a class="reference" href="#gnu-general-public-license">GNU General Public License</a>.</p> +code of this program and in the chapter, <a class="reference internal" href="#gnu-general-public-license">GNU General Public License</a>.</p> <p>The included Scintilla library (found in the subdirectory -<tt class="docutils literal"><span class="pre">scintilla/</span></tt>) has its own license, which can be found in the chapter, -<a class="reference" href="#license-for-scintilla-and-scite">License for Scintilla and SciTE</a>.</p> +<tt class="docutils literal">scintilla/</tt>) has its own license, which can be found in the chapter, +<a class="reference internal" href="#license-for-scintilla-and-scite">License for Scintilla and SciTE</a>.</p> </div> -<div class="section"> -<h2><a class="toc-backref" href="#id12" id="about-this-document" name="about-this-document">About this document</a></h2> +<div class="section" id="about-this-document"> +<h2><a class="toc-backref" href="#id12">About this document</a></h2> <p>This documentation is available in HTML and text formats. -The latest version can always be found at <a class="reference" href="http://www.geany.org/">http://www.geany.org/</a>.</p> -<p>If you want to contribute to it, see <a class="reference" href="#contributing-to-this-document">Contributing to this document</a>.</p> +The latest version can always be found at <a class="reference external" href="http://www.geany.org/">http://www.geany.org/</a>.</p> +<p>If you want to contribute to it, see <a class="reference internal" href="#contributing-to-this-document">Contributing to this document</a>.</p> </div> </div> -<div class="section"> -<h1><a class="toc-backref" href="#id13" id="installation" name="installation">Installation</a></h1> -<div class="section"> -<h2><a class="toc-backref" href="#id14" id="requirements" name="requirements">Requirements</a></h2> +<div class="section" id="installation"> +<h1><a class="toc-backref" href="#id13">Installation</a></h1> +<div class="section" id="requirements"> +<h2><a class="toc-backref" href="#id14">Requirements</a></h2> <p>You will need the GTK (>= 2.8.0) libraries and their dependencies (Pango, GLib and ATK). Your distro should provide packages for these, usually installed by default. For Windows, you can download an installer from the website which bundles these libraries.</p> </div> -<div class="section"> -<h2><a class="toc-backref" href="#id15" id="binary-packages" name="binary-packages">Binary packages</a></h2> +<div class="section" id="binary-packages"> +<h2><a class="toc-backref" href="#id15">Binary packages</a></h2> <p>There are many binary packages available. For an up-to-date but maybe -incomplete list see <a class="reference" href="http://www.geany.org/Download/ThirdPartyPackages">http://www.geany.org/Download/ThirdPartyPackages</a>.</p> +incomplete list see <a class="reference external" href="http://www.geany.org/Download/ThirdPartyPackages">http://www.geany.org/Download/ThirdPartyPackages</a>.</p> </div> -<div class="section"> -<h2><a class="toc-backref" href="#id16" id="source-compilation" name="source-compilation">Source compilation</a></h2> +<div class="section" id="source-compilation"> +<h2><a class="toc-backref" href="#id16">Source compilation</a></h2> <p>Compiling Geany is quite easy. To do so, you need the GTK (>= 2.8.0) libraries and header files. You also need the Pango, GLib and ATK libraries and header files. -All these files are available at <a class="reference" href="http://www.gtk.org">http://www.gtk.org</a>, but very often +All these files are available at <a class="reference external" href="http://www.gtk.org">http://www.gtk.org</a>, but very often your distro will provide development packages to save the trouble of building these yourself.</p> <p>Furthermore you need, of course, a C and C++ compiler. The GNU versions of these tools are recommended.</p> -<div class="section"> -<h3><a class="toc-backref" href="#id17" id="autotools-based-build-system" name="autotools-based-build-system">Autotools based build system</a></h3> +<div class="section" id="autotools-based-build-system"> +<h3><a class="toc-backref" href="#id17">Autotools based build system</a></h3> <p>The Autotools based build system is very mature and has been well tested. To use it, you just need the Make tool, preferably GNU Make.</p> <p>Then run the following commands:</p> @@ -567,8 +567,8 @@ % make install </pre> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id18" id="waf-based-build-system" name="waf-based-build-system">Waf based build system</a></h3> +<div class="section" id="waf-based-build-system"> +<h3><a class="toc-backref" href="#id18">Waf based build system</a></h3> <p>The Waf build system is still quite young and under heavy development but already in a usable state. In contrast to the Autotools system, Waf needs Python. So before using Waf, you need to install Python on your system. @@ -576,7 +576,7 @@ build process might be a bit faster. Especially when you use the Waf cache feature for repetitive builds (e.g. when changing only a few source files to test something) will become much faster since Waf will cache and re-use the -unchanged built files and only compile the changed code again. See <a class="reference" href="#waf-cache">Waf Cache</a> for details. +unchanged built files and only compile the changed code again. See <a class="reference internal" href="#waf-cache">Waf Cache</a> for details. To build Geany with Waf as run:</p> <pre class="literal-block"> $ ./waf configure @@ -586,13 +586,13 @@ <pre class="literal-block"> % ./waf install </pre> -<div class="section"> -<h4><a class="toc-backref" href="#id19" id="waf-cache" name="waf-cache">Waf Cache</a></h4> +<div class="section" id="waf-cache"> +<h4><a class="toc-backref" href="#id19">Waf Cache</a></h4> <p>The Waf build system has a nice and interesting feature which can help to avoid a lot of unnecessary rebuilding of unchanged code. This often happens when developing new features or trying to debug something in Geany. Waf is able to store and retrieve the object files from a cache. This cache is declared -using the environment variable <tt class="docutils literal"><span class="pre">WAFCACHE</span></tt>. +using the environment variable <tt class="docutils literal">WAFCACHE</tt>. A possible location of the cache directory could be <tt class="docutils literal"><span class="pre">~/.cache/waf</span></tt>. In order to make use of this, you first need to create this directory:</p> <pre class="literal-block"> @@ -603,11 +603,11 @@ <pre class="literal-block"> export WAFCACHE=/home/username/.cache/waf </pre> -<p>Remember to replace <tt class="docutils literal"><span class="pre">username</span></tt> with your actual username.</p> +<p>Remember to replace <tt class="docutils literal">username</tt> with your actual username.</p> <p>More information about the Waf cache feature are available at -<a class="reference" href="http://code.google.com/p/waf/wiki/CacheObjectFiles">http://code.google.com/p/waf/wiki/CacheObjectFiles</a>.</p> -<div class="section"> -<h5><a class="toc-backref" href="#id20" id="cleaning-the-cache" name="cleaning-the-cache">Cleaning the Cache</a></h5> +<a class="reference external" href="http://code.google.com/p/waf/wiki/CacheObjectFiles">http://code.google.com/p/waf/wiki/CacheObjectFiles</a>.</p> +<div class="section" id="cleaning-the-cache"> +<h5><a class="toc-backref" href="#id20">Cleaning the Cache</a></h5> <p>You should be careful about the size of the cache directory as it may grow rapidly over time. Waf doesn't do any cleaning or other house-keeping of the cache yet, so you need to keep it @@ -618,12 +618,12 @@ $ find /home/username/.cache/waf -mtime +14 -exec rm {} \; </pre> <p>This will delete all files in the cache directory which are older than 14 days.</p> -<p>For details about the <tt class="docutils literal"><span class="pre">find</span></tt> command and its options, check its manual page.</p> +<p>For details about the <tt class="docutils literal">find</tt> command and its options, check its manual page.</p> </div> </div> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id21" id="custom-installation" name="custom-installation">Custom installation</a></h3> +<div class="section" id="custom-installation"> +<h3><a class="toc-backref" href="#id21">Custom installation</a></h3> <p>The configure script supports several common options, for a detailed list, type:</p> <pre class="literal-block"> @@ -637,40 +637,40 @@ <p>You may also want to read the INSTALL file for advanced installation options.</p> <ul class="simple"> -<li>See also <a class="reference" href="#compile-time-options">Compile-time options</a>.</li> +<li>See also <a class="reference internal" href="#compile-time-options">Compile-time options</a>.</li> </ul> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id22" id="dynamic-linking-loader-support-and-vte" name="dynamic-linking-loader-support-and-vte">Dynamic linking loader support and VTE</a></h3> +<div class="section" id="dynamic-linking-loader-support-and-vte"> +<h3><a class="toc-backref" href="#id22">Dynamic linking loader support and VTE</a></h3> <p>In the case that your system lacks dynamic linking loader support, you -probably want to pass the option <tt class="docutils literal"><span class="pre">--disable-vte</span></tt> to the <tt class="docutils literal"><span class="pre">configure</span></tt> +probably want to pass the option <tt class="docutils literal"><span class="pre">--disable-vte</span></tt> to the <tt class="docutils literal">configure</tt> script. This prevents compiling Geany with dynamic linking loader -support for automatically loading <tt class="docutils literal"><span class="pre">libvte.so.4</span></tt> if available.</p> +support for automatically loading <tt class="docutils literal">libvte.so.4</tt> if available.</p> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id23" id="build-problems" name="build-problems">Build problems</a></h3> +<div class="section" id="build-problems"> +<h3><a class="toc-backref" href="#id23">Build problems</a></h3> <p>If there are any errors during compilation, check your build environment and try to find the error, otherwise contact the mailing list or one the authors. Sometimes you might need to ask for specific help from your distribution.</p> </div> </div> -<div class="section"> -<h2><a class="toc-backref" href="#id24" id="installation-prefix" name="installation-prefix">Installation prefix</a></h2> +<div class="section" id="installation-prefix"> +<h2><a class="toc-backref" href="#id24">Installation prefix</a></h2> <p>If you want to edit any of Geany's system configuration files after installation you will need to know the installation prefix. Usually this is not necessary as you can just use per user configuration files and you will not need root permissions.</p> -<p>Use the <tt class="docutils literal"><span class="pre">--print-prefix</span></tt> option to Geany to check - see <a class="reference" href="#command-line-options">Command line +<p>Use the <tt class="docutils literal"><span class="pre">--print-prefix</span></tt> option to Geany to check - see <a class="reference internal" href="#command-line-options">Command line options</a>. The first path is the prefix.</p> -<p>This is commonly <tt class="docutils literal"><span class="pre">/usr</span></tt> if you installed from a binary package, or -<tt class="docutils literal"><span class="pre">/usr/local</span></tt> if you build from source.</p> +<p>This is commonly <tt class="docutils literal">/usr</tt> if you installed from a binary package, or +<tt class="docutils literal">/usr/local</tt> if you build from source.</p> </div> </div> -<div class="section"> -<h1><a class="toc-backref" href="#id25" id="usage" name="usage">Usage</a></h1> -<div class="section"> -<h2><a class="toc-backref" href="#id26" id="getting-started" name="getting-started">Getting started</a></h2> +<div class="section" id="usage"> +<h1><a class="toc-backref" href="#id25">Usage</a></h1> +<div class="section" id="getting-started"> +<h2><a class="toc-backref" href="#id26">Getting started</a></h2> <p>You can start Geany in the following ways:</p> <ul> <li><p class="first">From the Desktop Environment menu:</p> @@ -686,8 +686,8 @@ </li> </ul> </div> -<div class="section"> -<h2><a class="toc-backref" href="#id27" id="the-geany-workspace" name="the-geany-workspace">The Geany workspace</a></h2> +<div class="section" id="the-geany-workspace"> +<h2><a class="toc-backref" href="#id27">The Geany workspace</a></h2> <p>The Geany window is shown in the following figure:</p> <img alt="./images/main_window.png" src="./images/main_window.png" /> <p>The workspace has the following parts:</p> @@ -715,8 +715,8 @@ <p>The sizes of the sidebar and message window can be adjusted by dragging the dividers.</p> </div> -<div class="section"> -<h2><a class="toc-backref" href="#id28" id="command-line-options" name="command-line-options">Command line options</a></h2> +<div class="section" id="command-line-options"> +<h2><a class="toc-backref" href="#id28">Command line options</a></h2> <table border="1" class="docutils"> <colgroup> <col width="13%" /> @@ -745,7 +745,7 @@ <td>--config=directory_name</td> <td>Use an alternate configuration directory. The default configuration directory is <tt class="docutils literal"><span class="pre">~/.config/geany/</span></tt> and that -is where <tt class="docutils literal"><span class="pre">geany.conf</span></tt> and other configuration files +is where <tt class="docutils literal">geany.conf</tt> and other configuration files reside.</td> </tr> <tr><td><em>none</em></td> @@ -756,7 +756,7 @@ <tr><td>-g</td> <td>--generate-tags</td> <td>Generate a global tags file (see -<a class="reference" href="#generating-a-global-tags-file">Generating a global tags file</a>).</td> +<a class="reference internal" href="#generating-a-global-tags-file">Generating a global tags file</a>).</td> </tr> <tr><td>-P</td> <td>--no-preprocessing</td> @@ -812,7 +812,7 @@ <td>--no-terminal</td> <td>Do not load terminal support. Use this option if you do not want to load the virtual terminal emulator widget -at startup. If you do not have <tt class="docutils literal"><span class="pre">libvte.so.4</span></tt> installed, +at startup. If you do not have <tt class="docutils literal">libvte.so.4</tt> installed, then terminal-support is automatically disabled. Only available if Geany was compiled with support for VTE.</td> </tr> @@ -830,7 +830,7 @@ <td>--vte-lib</td> <td>Specify explicitly the path including filename or only the filename to the VTE library, e.g. -<tt class="docutils literal"><span class="pre">/usr/lib/libvte.so</span></tt> or <tt class="docutils literal"><span class="pre">libvte.so</span></tt>. This option is +<tt class="docutils literal">/usr/lib/libvte.so</tt> or <tt class="docutils literal">libvte.so</tt>. This option is only needed when the auto-detection does not work. Only available if Geany was compiled with support for VTE.</td> </tr> @@ -869,13 +869,13 @@ <p>Geany supports all generic GTK options, a list is available on the help screen.</p> </div> -<div class="section"> -<h2><a class="toc-backref" href="#id29" id="general" name="general">General</a></h2> -<div class="section"> -<h3><a class="toc-backref" href="#id30" id="startup" name="startup">Startup</a></h3> +<div class="section" id="general"> +<h2><a class="toc-backref" href="#id29">General</a></h2> +<div class="section" id="startup"> +<h3><a class="toc-backref" href="#id30">Startup</a></h3> <p>At startup, Geany loads all files from the last time Geany was launched. You can disable this feature in the preferences dialog -(see <a class="reference" href="#general-startup-preferences">General Startup preferences</a>). If you specify some +(see <a class="reference internal" href="#general-startup-preferences">General Startup preferences</a>). If you specify some files on the command line, only these files will be opened, but you can find the files from the last session in the file menu under the "Recent files" item. By default this contains the last 10 recently @@ -886,8 +886,8 @@ do not specify any filenames on the command-line, or disable opening files in a running instance using the appropriate command line option.</p> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id31" id="opening-files-from-the-command-line-in-a-running-instance" name="opening-files-from-the-command-line-in-a-running-instance">Opening files from the command-line in a running instance</a></h3> +<div class="section" id="opening-files-from-the-command-line-in-a-running-instance"> +<h3><a class="toc-backref" href="#id31">Opening files from the command-line in a running instance</a></h3> <p>Geany detects if there is an an instance of itself already running and opens files from the command-line in that instance. So, Geany can be used to view and edit files by opening them from other programs @@ -896,22 +896,22 @@ <pre class="literal-block"> geany some_file.foo:55:4 </pre> -<p>This would open the file <tt class="docutils literal"><span class="pre">some_file.foo</span></tt> with the cursor on line 55, +<p>This would open the file <tt class="docutils literal">some_file.foo</tt> with the cursor on line 55, column 4.</p> <p>If you do not like this for some reason, you can disable using the first instance by using the appropriate command line option -- see the section -called <a class="reference" href="#command-line-options">Command line options</a>.</p> +called <a class="reference internal" href="#command-line-options">Command line options</a>.</p> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id32" id="virtual-terminal-emulator-widget-vte" name="virtual-terminal-emulator-widget-vte">Virtual terminal emulator widget (VTE)</a></h3> -<p>If you have installed <tt class="docutils literal"><span class="pre">libvte.so</span></tt> on your system, it is loaded +<div class="section" id="virtual-terminal-emulator-widget-vte"> +<h3><a class="toc-backref" href="#id32">Virtual terminal emulator widget (VTE)</a></h3> +<p>If you have installed <tt class="docutils literal">libvte.so</tt> on your system, it is loaded automatically by Geany, and you will have a terminal widget in the notebook at the bottom.</p> -<p>If Geany cannot find any <tt class="docutils literal"><span class="pre">libvte.so</span></tt> at startup, the terminal widget +<p>If Geany cannot find any <tt class="docutils literal">libvte.so</tt> at startup, the terminal widget will not be loaded. So there is no need to install the package containing this file in order to run Geany. Additionally, you can disable the use of the terminal widget by command line option, for more information -see the section called <a class="reference" href="#command-line-options">Command line options</a>.</p> +see the section called <a class="reference internal" href="#command-line-options">Command line options</a>.</p> <p>You can use this terminal (from now on called VTE) much as you would a terminal program like xterm. There is basic clipboard support. You can paste the contents of the clipboard by pressing the right mouse @@ -928,26 +928,26 @@ you can use the argument <tt class="docutils literal"><span class="pre">--login</span></tt>.</p> <div class="note"> <p class="first admonition-title">Note</p> -<p class="last">Geany tries to load <tt class="docutils literal"><span class="pre">libvte.so</span></tt>. If this fails, it tries to load +<p class="last">Geany tries to load <tt class="docutils literal">libvte.so</tt>. If this fails, it tries to load some other filenames. If this fails too, you should check whether you installed libvte correctly. Again note, Geany will run without this library.</p> </div> <p>It could be, that the library is called something else than -<tt class="docutils literal"><span class="pre">libvte.so</span></tt> (e.g. on FreeBSD 6.0 it is called <tt class="docutils literal"><span class="pre">libvte.so.8</span></tt>). If so +<tt class="docutils literal">libvte.so</tt> (e.g. on FreeBSD 6.0 it is called <tt class="docutils literal">libvte.so.8</tt>). If so please set a link to the correct file (as root):</p> <pre class="literal-block"> # ln -s /usr/lib/libvte.so.X /usr/lib/libvte.so </pre> <p>Obviously, you have to adjust the paths and set X to the number of your -<tt class="docutils literal"><span class="pre">libvte.so</span></tt>.</p> +<tt class="docutils literal">libvte.so</tt>.</p> <p>You can also specify the filename of the VTE library to use on the command -line (see the section called <a class="reference" href="#command-line-options">Command line options</a>) or at compile time +line (see the section called <a class="reference internal" href="#command-line-options">Command line options</a>) or at compile time by specifying the command line option <tt class="docutils literal"><span class="pre">--with-vte-module-path</span></tt> to ./configure.</p> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id33" id="defining-own-widget-styles-using-gtkrc-2-0" name="defining-own-widget-styles-using-gtkrc-2-0">Defining own widget styles using .gtkrc-2.0</a></h3> +<div class="section" id="defining-own-widget-styles-using-gtkrc-2-0"> +<h3><a class="toc-backref" href="#id33">Defining own widget styles using .gtkrc-2.0</a></h3> <p>You can define your widget style for many of Geany's GUI parts. To do this, just edit your <tt class="docutils literal"><span class="pre">.gtkrc-2.0</span></tt> (usually found in your home directory on UNIX-like systems and in the etc subdirectory of your @@ -987,10 +987,10 @@ </pre> </div> </div> -<div class="section"> -<h2><a class="toc-backref" href="#id34" id="documents" name="documents">Documents</a></h2> -<div class="section"> -<h3><a class="toc-backref" href="#id35" id="switching-between-documents" name="switching-between-documents">Switching between documents</a></h3> +<div class="section" id="documents"> +<h2><a class="toc-backref" href="#id34">Documents</a></h2> +<div class="section" id="switching-between-documents"> +<h3><a class="toc-backref" href="#id35">Switching between documents</a></h3> <p>The documents list and the editor tabs are two different ways to switch between documents using the mouse. When you hit the key combination to move between tabs, the order is determined by the tab @@ -998,14 +998,14 @@ (regardless of whether or not editor tabs are visible).</p> <p>The tabs can be positioned at the top, bottom, left, or right of the main editing window, by a selection in the interface preferences.</p> -<p>See the <a class="reference" href="#notebook-tab-keybindings">Notebook tab keybindings</a> section for useful +<p>See the <a class="reference internal" href="#notebook-tab-keybindings">Notebook tab keybindings</a> section for useful shortcuts including for Most-Recently-Used document switching.</p> </div> </div> -<div class="section"> -<h2><a class="toc-backref" href="#id36" id="character-sets-and-unicode-byte-order-mark-bom" name="character-sets-and-unicode-byte-order-mark-bom">Character sets and Unicode Byte-Order-Mark (BOM)</a></h2> -<div class="section"> -<h3><a class="toc-backref" href="#id37" id="using-character-sets" name="using-character-sets">Using character sets</a></h3> +<div class="section" id="character-sets-and-unicode-byte-order-mark-bom"> +<h2><a class="toc-backref" href="#id36">Character sets and Unicode Byte-Order-Mark (BOM)</a></h2> +<div class="section" id="using-character-sets"> +<h3><a class="toc-backref" href="#id37">Using character sets</a></h3> <p>Geany provides support for detecting and converting character sets. So you can open and save files in different character sets, and even convert a file from one character set to another. To do this, @@ -1051,8 +1051,8 @@ </li> </ul> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id38" id="in-file-encoding-specification" name="in-file-encoding-specification">In-file encoding specification</a></h3> +<div class="section" id="in-file-encoding-specification"> +<h3><a class="toc-backref" href="#id38">In-file encoding specification</a></h3> <p>Geany detects meta tags of HTML files which contain charset information like:</p> <pre class="literal-block"> @@ -1079,7 +1079,7 @@ correctly the next time.</p> <p>Since Geany 0.15 you can also use lines which match the regular expression used to find the encoding string: -<tt class="docutils literal"><span class="pre">coding[\t</span> <span class="pre">]*[:=][\t</span> <span class="pre">]*([a-z0-9-]+)[\t</span> <span class="pre">]*</span></tt></p> +<tt class="docutils literal"><span class="pre">coding[\t</span> <span class="pre">]*[:=][\t</span> <span class="pre">]*([a-z0-9-]+)[\t</span> ]*</tt></p> <div class="note"> <p class="first admonition-title">Note</p> <p class="last">These specifications must be in the first 512 bytes of the file. @@ -1094,8 +1094,8 @@ # coding: ISO-8859-15 </pre> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id39" id="special-encoding-none" name="special-encoding-none">Special encoding "None"</a></h3> +<div class="section" id="special-encoding-none"> +<h3><a class="toc-backref" href="#id39">Special encoding "None"</a></h3> <p>There is a special encoding "None" which uses no encoding. It is useful when you know that Geany cannot auto-detect the encoding of a file and it is not displayed correctly. Especially @@ -1104,10 +1104,10 @@ of the first NULL-byte. Using this encoding opens the file as it is without any character conversion.</p> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id40" id="unicode-byte-order-mark-bom" name="unicode-byte-order-mark-bom">Unicode Byte-Order-Mark (BOM)</a></h3> +<div class="section" id="unicode-byte-order-mark-bom"> +<h3><a class="toc-backref" href="#id40">Unicode Byte-Order-Mark (BOM)</a></h3> <p>Furthermore, Geany detects a Unicode Byte Order Mark (see -<a class="reference" href="http://en.wikipedia.org/wiki/Byte_Order_Mark">http://en.wikipedia.org/wiki/Byte_Order_Mark</a> for details). Of course, +<a class="reference external" href="http://en.wikipedia.org/wiki/Byte_Order_Mark">http://en.wikipedia.org/wiki/Byte_Order_Mark</a> for details). Of course, this feature is only available if the opened file is in a Unicode encoding. The Byte Order Mark helps to detect the encoding of a file, e.g. whether it is UTF-16LE or UTF-16BE and so on. On Unix-like systems @@ -1127,10 +1127,10 @@ </div> </div> </div> -<div class="section"> -<h2><a class="toc-backref" href="#id41" id="editing" name="editing">Editing</a></h2> -<div class="section"> -<h3><a class="toc-backref" href="#id42" id="folding" name="folding">Folding</a></h3> +<div class="section" id="editing"> +<h2><a class="toc-backref" href="#id41">Editing</a></h2> +<div class="section" id="folding"> +<h3><a class="toc-backref" href="#id42">Folding</a></h3> <p>Geany provides basic code folding support. Folding means the ability to show and hide parts of the text in the current file. You can hide unimportant code sections and concentrate on the parts you are working on @@ -1144,7 +1144,7 @@ <div class="note"> <p class="first admonition-title">Note</p> <p class="last">You can customize the folding icon and line styles - see the -filetypes.common <a class="reference" href="#folding-settings">Folding Settings</a>.</p> +filetypes.common <a class="reference internal" href="#folding-settings">Folding Settings</a>.</p> </div> <p>If you don't like it or don't need it at all, you can simply disable folding support completely in the preferences dialog.</p> @@ -1159,8 +1159,8 @@ children of a fold point" option is enabled, pressing Shift will disable it for this click and vice versa.</p> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id43" id="column-mode-editing-rectangular-selections" name="column-mode-editing-rectangular-selections">Column mode editing (rectangular selections)</a></h3> +<div class="section" id="column-mode-editing-rectangular-selections"> +<h3><a class="toc-backref" href="#id43">Column mode editing (rectangular selections)</a></h3> <p>There is basic support for column mode editing. To use it, create a rectangular selection by holding down the Control and Shift keys (or Control and Alt if it doesn't work) while @@ -1169,18 +1169,18 @@ this selection and the modifications will be done for every line in the selection.</p> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id44" id="drag-and-drop-of-text" name="drag-and-drop-of-text">Drag and drop of text</a></h3> +<div class="section" id="drag-and-drop-of-text"> +<h3><a class="toc-backref" href="#id44">Drag and drop of text</a></h3> <p>If you drag selected text in the editor widget of Geany the text is moved to the position where the mouse pointer is when releasing the mouse button. Holding Control when releasing the mouse button will copy the text instead. This behaviour was changed in Geany 0.11 - before the selected text was copied to the new position.</p> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id45" id="indentation" name="indentation">Indentation</a></h3> +<div class="section" id="indentation"> +<h3><a class="toc-backref" href="#id45">Indentation</a></h3> <p>Geany allows each document to indent either with a tab character or -multiple spaces. The default indent mode is set in the <a class="reference" href="#editor-features-preferences">Editor Features +multiple spaces. The default indent mode is set in the <a class="reference internal" href="#editor-features-preferences">Editor Features preferences</a> (see the link for more information). But this can be overridden using either the <em>Document->Indent Type</em> menu, or by using the <em>Detect from file</em> indentation preference. When enabled, @@ -1198,8 +1198,8 @@ on a line.</dd> </dl> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id46" id="auto-indentation" name="auto-indentation">Auto-indentation</a></h3> +<div class="section" id="auto-indentation"> +<h3><a class="toc-backref" href="#id46">Auto-indentation</a></h3> <p>When enabled, auto-indentation happens when pressing <em>Enter</em> in the Editor. It adds a certain amount of indentation to the new line so the user doesn't always have to indent each line manually.</p> @@ -1219,8 +1219,8 @@ match the indentation of the line with the opening brace.</dd> </dl> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id47" id="bookmarks" name="bookmarks">Bookmarks</a></h3> +<div class="section" id="bookmarks"> +<h3><a class="toc-backref" href="#id47">Bookmarks</a></h3> <p>Geany provides a handy bookmarking feature that lets you mark one or more lines in a document, and return the cursor to them using a key combination.</p> @@ -1237,14 +1237,14 @@ (Ctrl-PgUp/PgDn and Ctrl-Tab) provides a particularly fast way to navigate around multiple files.</p> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id48" id="code-navigation-history" name="code-navigation-history">Code navigation history</a></h3> +<div class="section" id="code-navigation-history"> +<h3><a class="toc-backref" href="#id48">Code navigation history</a></h3> <p>To ease navigation in source files and especially between different files, Geany lets you jump between different navigation points. Currently, this works for the following:</p> <ul class="simple"> -<li><a class="reference" href="#go-to-tag-declaration">Go to tag declaration</a></li> -<li><a class="reference" href="#go-to-tag-definition">Go to tag definition</a></li> +<li><a class="reference internal" href="#go-to-tag-declaration">Go to tag declaration</a></li> +<li><a class="reference internal" href="#go-to-tag-definition">Go to tag definition</a></li> <li>Symbol list items</li> <li>Build errors</li> <li>Message items</li> @@ -1256,8 +1256,8 @@ location". This makes it easier to navigate in e.g. foreign code and between different files.</p> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id49" id="sending-text-through-custom-commands" name="sending-text-through-custom-commands">Sending text through custom commands</a></h3> +<div class="section" id="sending-text-through-custom-commands"> +<h3><a class="toc-backref" href="#id49">Sending text through custom commands</a></h3> <p>You can define several custom commands in Geany and send the current selection to one of these commands using the <em>Edit->Format->Send Selection to</em> menu or keybindings. The output of the command will be @@ -1276,22 +1276,22 @@ deleted automatically.</p> <p>Normal shell quoting is supported, so you can do things like:</p> <ul class="simple"> -<li><tt class="docutils literal"><span class="pre">sed</span> <span class="pre">'s/\./(dot)/g'</span></tt></li> +<li><tt class="docutils literal">sed <span class="pre">'s/\./(dot)/g'</span></tt></li> </ul> -<p>The above example would normally be done with the <a class="reference" href="#replace-all">Replace all</a> +<p>The above example would normally be done with the <a class="reference internal" href="#replace-all">Replace all</a> function, but it can be handy to have common commands already set up.</p> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id50" id="context-actions" name="context-actions">Context actions</a></h3> +<div class="section" id="context-actions"> +<h3><a class="toc-backref" href="#id50">Context actions</a></h3> <p>You can execute the context action command on the current word at the cursor position or the available selection. This word or selection can be used as an argument to the command. The context action is invoked by a menu entry in the popup menu of the editor and also a keyboard shortcut (see the section called -<a class="reference" href="#keybindings">Keybindings</a>).</p> +<a class="reference internal" href="#keybindings">Keybindings</a>).</p> <p>The command can be specified in the preferences dialog and also for each filetype (see "context_action_cmd" in the section called -<a class="reference" href="#format">Format</a>). When the context action is invoked, the filetype +<a class="reference internal" href="#format">Format</a>). When the context action is invoked, the filetype specific command is used if available, otherwise the command specified in the preferences dialog is executed.</p> <p>The current word or selection can be referred with the wildcard "%s" @@ -1306,19 +1306,19 @@ <p>when executing the command, the %s is substituted by the word near the cursor position or by the current selection. If the cursor is at the word "echo", a browser window will open(assumed your browser is -called firefox) and it will open the address: <a class="reference" href="http://www.php.net/echo">http://www.php.net/echo</a>.</p> +called firefox) and it will open the address: <a class="reference external" href="http://www.php.net/echo">http://www.php.net/echo</a>.</p> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id51" id="autocompletion" name="autocompletion">Autocompletion</a></h3> +<div class="section" id="autocompletion"> +<h3><a class="toc-backref" href="#id51">Autocompletion</a></h3> <p>Geany can offer a list of possible completions for symbols defined in the tags and for all words in a document.</p> <p>The autocompletion list for symbols is presented when the first few -characters of the symbol are typed (configurable, see <a class="reference" href="#editor-completions-preferences">Editor Completions +characters of the symbol are typed (configurable, see <a class="reference internal" href="#editor-completions-preferences">Editor Completions preferences</a>, default 4) or when the <em>Complete word</em> -keybinding is pressed (configurable, see <a class="reference" href="#editor-keybindings">Editor keybindings</a>, +keybinding is pressed (configurable, see <a class="reference internal" href="#editor-keybindings">Editor keybindings</a>, default Ctrl-Space).</p> <p>When the defined keybinding is typed and the <em>Autocomplete all words in -document</em> preference (in <a class="reference" href="#editor-completions-preferences">Editor Completions preferences</a>) +document</em> preference (in <a class="reference internal" href="#editor-completions-preferences">Editor Completions preferences</a>) is selected then the autocompletion list will show all matching words in the document, if there are no matching symbols.</p> <p>If you don't want to use autocompletion it can be dismissed until @@ -1330,13 +1330,13 @@ item on the autocompletion list can be chosen from the list by pressing Enter/Return. You can also double-click to select an item. The sequence will be completed to match the chosen item, and if the <em>Drop rest of -word on completion</em> preference is set (in <a class="reference" href="#editor-completions-preferences">Editor Completions +word on completion</em> preference is set (in <a class="reference internal" href="#editor-completions-preferences">Editor Completions preferences</a>) then any characters after the cursor that match a symbol or word are deleted.</p> -<div class="section"> -<h4><a class="toc-backref" href="#id52" id="word-part-completion" name="word-part-completion">Word part completion</a></h4> +<div class="section" id="word-part-completion"> +<h4><a class="toc-backref" href="#id52">Word part completion</a></h4> <p>By default, pressing Tab will complete the selected item by word part; -useful e.g. for adding the prefix <tt class="docutils literal"><span class="pre">gtk_combo_box_entry_</span></tt> without typing it +useful e.g. for adding the prefix <tt class="docutils literal">gtk_combo_box_entry_</tt> without typing it manually:</p> <ul class="simple"> <li>gtk_com<TAB></li> @@ -1345,12 +1345,12 @@ <li>gtk_combo_box_entry_<s><ENTER></li> <li>gtk_combo_box_entry_set_text_column</li> </ul> -<p>The key combination can be changed from Tab - See <a class="reference" href="#editor-keybindings">Editor keybindings</a>. +<p>The key combination can be changed from Tab - See <a class="reference internal" href="#editor-keybindings">Editor keybindings</a>. If you clear/change the key combination for word part completion, Tab will complete the whole word instead, like Enter.</p> </div> -<div class="section"> -<h4><a class="toc-backref" href="#id53" id="scope-autocompletion" name="scope-autocompletion">Scope autocompletion</a></h4> +<div class="section" id="scope-autocompletion"> +<h4><a class="toc-backref" href="#id53">Scope autocompletion</a></h4> <p>E.g.:</p> <pre class="literal-block"> struct @@ -1359,7 +1359,7 @@ char c; } foo; </pre> -<p>When you type <tt class="docutils literal"><span class="pre">foo.</span></tt> it will show an autocompletion list with 'i' and +<p>When you type <tt class="docutils literal">foo.</tt> it will show an autocompletion list with 'i' and 'c' symbols.</p> <p>It only works for languages that set parent scope names for e.g. struct members. Currently this means C-like languages. The C tag parser only @@ -1367,27 +1367,27 @@ in local scope.</p> </div> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id54" id="user-definable-snippets" name="user-definable-snippets">User-definable snippets</a></h3> +<div class="section" id="user-definable-snippets"> +<h3><a class="toc-backref" href="#id54">User-definable snippets</a></h3> <p>Snippets are small strings or code constructs which can be replaced or completed to a more complex string. So you can save a lot of time when typing common strings and letting Geany do the work for you. To know what to complete or replace Geany reads a configuration file -called <tt class="docutils literal"><span class="pre">snippets.conf</span></tt> at startup.</p> +called <tt class="docutils literal">snippets.conf</tt> at startup.</p> <p>Maybe you need to often type your name, so define a snippet like this:</p> <pre class="literal-block"> [Default] myname=Enrico Tröger </pre> -<p>Every time you write <tt class="docutils literal"><span class="pre">myname</span></tt> <TAB> in Geany, it will replace "myname" +<p>Every time you write <tt class="docutils literal">myname</tt> <TAB> in Geany, it will replace "myname" with "Enrico Tröger". The key to start autocompletion can be changed in the preferences dialog, by default it is TAB. The corresponding keybinding -is called <tt class="docutils literal"><span class="pre">Complete</span> <span class="pre">snippet</span></tt>.</p> +is called <tt class="docutils literal">Complete snippet</tt>.</p> <p>The system-wide configuration file can be found in -<tt class="docutils literal"><span class="pre">$prefix/share/geany</span></tt>, where <tt class="docutils literal"><span class="pre">$prefix</span></tt> is the path where Geany is -installed (see <a class="reference" href="#installation-prefix">Installation prefix</a>). It is not recommended to edit the +<tt class="docutils literal">$prefix/share/geany</tt>, where <tt class="docutils literal">$prefix</tt> is the path where Geany is +installed (see <a class="reference internal" href="#installation-prefix">Installation prefix</a>). It is not recommended to edit the system-wide file, because it will be overridden when Geany is updated.</p> -<p>To change the settings, copy the file from <tt class="docutils literal"><span class="pre">$prefix/share/geany</span></tt> +<p>To change the settings, copy the file from <tt class="docutils literal">$prefix/share/geany</tt> in your configuration directory (usually <tt class="docutils literal"><span class="pre">~/.config/geany/</span></tt>).</p> <p>For example:</p> <pre class="literal-block"> @@ -1398,15 +1398,15 @@ configuration directory. Alternatively, you can create a file <tt class="docutils literal"><span class="pre">~/.config/geany/snippets.conf</span></tt> and add only these settings you want to change. All missing settings will be read from the global snippets -file in <tt class="docutils literal"><span class="pre">$prefix/share/geany</span></tt>.</p> -<p>The file <tt class="docutils literal"><span class="pre">snippets.conf</span></tt> contains sections defining snippets that +file in <tt class="docutils literal">$prefix/share/geany</tt>.</p> +<p>The file <tt class="docutils literal">snippets.conf</tt> contains sections defining snippets that are available for particular filetypes and in general.</p> <p>The two sections "Default" and "Special" apply to all filetypes. "Default" contains all snippets which are available for every filetype and "Special" contains snippets which can only be used in other snippets. So you can define often used parts of snippets and just use the special snippet as a placeholder (see the -<tt class="docutils literal"><span class="pre">snippets.conf</span></tt> for details).</p> +<tt class="docutils literal">snippets.conf</tt> for details).</p> <p>You can define sections with the name of a filetype eg "C++". The snippets in that section are only available for use in files with that filetype. Snippets in filetype sections will hide snippets with the @@ -1436,7 +1436,7 @@ <tr><td>%cursor%</td> <td>Place the cursor at this position after completion has been done. You can define multiple %cursor% wildcards -and use the keybinding <tt class="docutils literal"><span class="pre">Move</span> <span class="pre">cursor</span> <span class="pre">in</span> <span class="pre">snippet</span></tt> to jump +and use the keybinding <tt class="docutils literal">Move cursor in snippet</tt> to jump to the next defined cursor position in the completed snippet.</td> </tr> @@ -1450,18 +1450,18 @@ <p>Snippet names must not contain spaces otherwise they won't work correctly. But beside that you can define almost any string as a snippet and use it later in Geany. It is not limited -to existing contructs of certain programming languages(like <tt class="docutils literal"><span class="pre">if</span></tt>, -<tt class="docutils literal"><span class="pre">for</span></tt>, <tt class="docutils literal"><span class="pre">switch</span></tt>). Define whatever you need.</p> +to existing contructs of certain programming languages(like <tt class="docutils literal">if</tt>, +<tt class="docutils literal">for</tt>, <tt class="docutils literal">switch</tt>). Define whatever you need.</p> <p>Since Geany 0.15 you can also use most of the available templates wildcards -listed in <a class="reference" href="#template-wildcards">Template wildcards</a>. All wildcards which are listed as +listed in <a class="reference internal" href="#template-wildcards">Template wildcards</a>. All wildcards which are listed as <cite>available in snippets</cite> can be used. For instance to improve the above example:</p> <pre class="literal-block"> [Default] myname=My name is {developer} mysystem=My system: {command:uname -a} </pre> -<p>this will replace <tt class="docutils literal"><span class="pre">myname</span></tt> with "My name is " and the value of the template -preference <tt class="docutils literal"><span class="pre">developer</span></tt>.</p> +<p>this will replace <tt class="docutils literal">myname</tt> with "My name is " and the value of the template +preference <tt class="docutils literal">developer</tt>.</p> <p>You can change the way Geany recognizes the word to complete, that is how the start and end of a word is recognised when the snippet completion is requested. The section "Special" may @@ -1470,8 +1470,8 @@ default characters or define it to add or remove characters to fit your needs.</p> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id55" id="inserting-unicode-characters" name="inserting-unicode-characters">Inserting Unicode characters</a></h3> +<div class="section" id="inserting-unicode-characters"> +<h3><a class="toc-backref" href="#id55">Inserting Unicode characters</a></h3> <p>With GTK 2.10 and above, you can insert Unicode code points by hitting Ctrl-Shift-u, then still holding Ctrl-Shift, type some hex digits representing the code point for the character you want and hit Enter or Return (still @@ -1480,7 +1480,7 @@ character is also entered. In the case of Enter/Return, it is a newline, as you might expect.</p> <p>In some earlier versions of Geany, you might need to first unbind Ctrl-Shift-u -in the <a class="reference" href="#keybinding-preferences">keybinding preferences</a>, then select <em>Tools->Reload Configuration</em> +in the <a class="reference internal" href="#keybinding-preferences">keybinding preferences</a>, then select <em>Tools->Reload Configuration</em> or restart Geany. Note that it works slightly differently from other GTK applications, in that you'll need to continue to hold down the Ctrl and Shift keys while typing the code point hex digits (and the Enter or Return to finish the code point).</p> @@ -1489,8 +1489,8 @@ keys conflict with other Geany keybindings.</p> </div> </div> -<div class="section"> -<h2><a class="toc-backref" href="#id56" id="search-replace-and-go-to" name="search-replace-and-go-to">Search, replace and go to</a></h2> +<div class="section" id="search-replace-and-go-to"> +<h2><a class="toc-backref" href="#id56">Search, replace and go to</a></h2> <p>This section describes search-related commands from the Search menu and the editor window's popup menu:</p> <ul class="simple"> @@ -1503,30 +1503,30 @@ <li>Go to tag declaration</li> <li>Go to line</li> </ul> -<div class="section"> -<h3><a class="toc-backref" href="#id57" id="toolbar-entries" name="toolbar-entries">Toolbar entries</a></h3> +<div class="section" id="toolbar-entries"> +<h3><a class="toc-backref" href="#id57">Toolbar entries</a></h3> <p>There are also two toolbar entries:</p> <ul class="simple"> <li>Search bar</li> <li>Go to line entry</li> </ul> -<p>There are keybindings to focus each of these - see <a class="reference" href="#focus-keybindings">Focus +<p>There are keybindings to focus each of these - see <a class="reference internal" href="#focus-keybindings">Focus keybindings</a>. Pressing Escape will then focus the editor.</p> -<div class="section"> -<h4><a class="toc-backref" href="#id58" id="search-bar" name="search-bar">Search bar</a></h4> +<div class="section" id="search-bar"> +<h4><a class="toc-backref" href="#id58">Search bar</a></h4> <p>The quickest way to find some text is to use the search bar entry in the toolbar. This performs a case-insensitive search in the current document whilst you type. Pressing Enter will search again.</p> </div> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id59" id="find" name="find">Find</a></h3> +<div class="section" id="find"> +<h3><a class="toc-backref" href="#id59">Find</a></h3> <p>The Find dialog is used for finding text in one or more open documents.</p> <img alt="./images/find_dialog.png" src="./images/find_dialog.png" /> -<div class="section"> -<h4><a class="toc-backref" href="#id60" id="matching-options" name="matching-options">Matching options</a></h4> +<div class="section" id="matching-options"> +<h4><a class="toc-backref" href="#id60">Matching options</a></h4> <p>The syntax for the <em>Use regular expressions</em> option is shown in -<a class="reference" href="#regular-expressions">Regular expressions</a>.</p> +<a class="reference internal" href="#regular-expressions">Regular expressions</a>.</p> <div class="note"> <p class="first admonition-title">Note</p> <p class="last"><em>Use escape sequences</em> is implied for regular expressions.</p> @@ -1536,8 +1536,8 @@ a tab character. Other recognized symbols are: \\, \n, \r, \uXXXX (Unicode characters).</p> </div> -<div class="section"> -<h4><a class="toc-backref" href="#id61" id="find-all" name="find-all">Find all</a></h4> +<div class="section" id="find-all"> +<h4><a class="toc-backref" href="#id61">Find all</a></h4> <p>To find all matches, click on the Find All expander. This will reveal several options:</p> <ul class="simple"> @@ -1552,8 +1552,8 @@ colored box. These markers can be removed by selecting the Remove Markers command from the Document menu.</p> </div> -<div class="section"> -<h4><a class="toc-backref" href="#id62" id="change-font-in-search-dialog-text-fields" name="change-font-in-search-dialog-text-fields">Change font in search dialog text fields</a></h4> +<div class="section" id="change-font-in-search-dialog-text-fields"> +<h4><a class="toc-backref" href="#id62">Change font in search dialog text fields</a></h4> <p>All search related dialogs use a Monospace for the text input fields to increase the readability of input text. This is useful when you are typing input such as regular expressions with spaces, periods and commas which @@ -1574,12 +1574,12 @@ for the search dialogs.</p> </div> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id63" id="find-selection" name="find-selection">Find selection</a></h3> +<div class="section" id="find-selection"> +<h3><a class="toc-backref" href="#id63">Find selection</a></h3> <p>The <em>Find Next/Previous Selection</em> commands perform a search for the current selected text. If nothing is selected, by default the current word is used instead. This can be customized by the -<em>find_selection_type</em> hidden pref - see <a class="reference" href="#hidden-preferences">Hidden preferences</a>.</p> +<em>find_selection_type</em> hidden pref - see <a class="reference internal" href="#hidden-preferences">Hidden preferences</a>.</p> <table border="1" class="docutils"> <colgroup> <col width="10%" /> @@ -1603,8 +1603,8 @@ </tbody> </table> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id64" id="find-usage" name="find-usage">Find usage</a></h3> +<div class="section" id="find-usage"> +<h3><a class="toc-backref" href="#id64">Find usage</a></h3> <p>Find usage searches all open files. It is similar to the Find All In Session option in the Find dialog.</p> <p>If there is a selection, then it is used as the search text; otherwise @@ -1613,8 +1613,8 @@ click position when the popup menu is used. The search results are shown in the Messages tab of the Message Window.</p> </div> -<div class="section"> -<h3><a class="toc-backref" href="#id65" id="find-in-files" name="find-in-files">Find in files</a></h3> +<div class="section" id="find-in-files"> +<h3><a class="toc-backref" href="#id65">Find in files</a></h3> <p>Find in files is a more powerful version of Find usage that searches all files in a certain directory using the Grep tool. The Grep tool must be correctly set in Preferences to the path of the system's Grep @@ -1622,7 +1622,7 @@ @@ Diff output truncated at 100000 characters. @@ This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

1 0

← Newer
1
2
3
4
5
6
7
8
9
Older →

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

2007

2006

Commits October 2010