Revision: 4676 http://geany.svn.sourceforge.net/geany/?rev=4676&view=rev Author: dmaphy Date: 2010-02-20 13:56:57 +0000 (Sat, 20 Feb 2010)
Log Message: ----------- add more detailed hints about reloading configuration (thanks to Tony Ricks)
Modified Paths: -------------- trunk/doc/geany.txt
Modified: trunk/doc/geany.txt =================================================================== --- trunk/doc/geany.txt 2010-02-19 19:27:06 UTC (rev 4675) +++ trunk/doc/geany.txt 2010-02-20 13:56:57 UTC (rev 4676) @@ -1068,10 +1068,10 @@ hit Enter or Return.
For this to work in Geany, you'll need to first unbind Ctrl-Shift-u -in the `keybinding preferences`_, then 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. +in the `keybinding preferences`_, then select *Tools->Reload Configuration* +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.
For GTK < 2.10, it is also possible, but typing the first Ctrl-Shift-u is not necessary. One problem is that you may find the alphabetic @@ -2137,7 +2137,9 @@ a document, such as the file header. You only need to set fields that you want to use in your template files.
-.. note:: For changes made here to take effect a restart of geany is required. +.. note:: + For changes made here to take effect, either selecting + *Tools->Reload Configuration* or restarting Geany is required.
.. image:: ./images/pref_dialog_templ.png
@@ -3321,17 +3323,20 @@ reload the file after you have saved it.
.. note:: - Other configuration files are not shown here and you will need to open - them manually and usually restart Geany to see any changes. + Other configuration files not shown here will need to be opened + manually, and will not be automatically reloaded when saved. + (see *Reload Configuration* below).
There's also a *Reload Configuration* item which can be used if you -updated a configuration file outside of the current instance. This -item is also necessary to update syntax highlighting colors. +updated one of the other configuration files, or modified or added +template files.
+*Reload Configuration* is also necessary to update syntax highlighting colors. + .. note:: - Syntax highlighting colors aren't updated after saving - filetypes.common as this can take a short while depending on which - documents are open. + Syntax highlighting colors aren't updated in open documents after + saving filetypes.common as this can possibly take a significant + amount of time.
Global configuration file @@ -3914,7 +3919,8 @@
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: +selecting *Tools->Reload Configuration* or restarting Geany. Search for the +key name, then edit the value. Example:
``brace_match_ltgt=true``
@@ -4084,10 +4090,9 @@ meta data is only used for the ChangeLog and File header templates.
In the configuration dialog you can find a tab "Templates" (see -`Template preferences`_). You can define the -default values which will be inserted in the templates. You should -restart Geany after making changes, because they are only read -at startup. +`Template preferences`_). You can define the default values +which will be inserted in the templates. You should select +*Tools->Reload Configuration* or restart Geany after making changes.
File templates @@ -4099,7 +4104,8 @@
By default, file templates are installed for some filetypes. Custom file templates can be added by creating the appropriate template file -and restarting Geany. You can also edit the default file templates. +and then selecting *Tools->Reload Configuration* or restarting Geany. You can +also edit the default file templates.
The file's contents are just the text to place in the document, with optional template wildcards like ``{fileheader}``. The fileheader @@ -4120,8 +4126,8 @@ which created a new document with the filetype set to 'C'.
The template file is read from disk when the corresponding menu item is -clicked, so you don't need to restart Geany after editing a custom file -template, only after adding a new one. +clicked, so you don't need to select *Tools->Reload Configuration* or restart +Geany after editing a custom file template.
Filetype templates ``````````````````
This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.