From 15fb2f321ad400ca911c8b69a9b1a78b3baa3b51 Mon Sep 17 00:00:00 2001 From: Nick Treleaven Date: Fri, 11 Oct 2013 16:41:16 +0100 Subject: [PATCH] Improve custom filetype formatting/links --- doc/geany.txt | 18 +++++++++++------- 1 file changed, 11 insertions(+), 7 deletions(-) diff --git a/doc/geany.txt b/doc/geany.txt index 4e64306a86..c5a8d5dbc9 100644 --- a/doc/geany.txt +++ b/doc/geany.txt @@ -3952,13 +3952,14 @@ the '``*``' wildcard - e.g. ``filetypes.Bar.conf``. Custom filetypes are not as powerful as built-in filetypes, but support for the following has been implemented: -* Recognizing and setting the filetype (after the user has manually edited - ``filetype_extensions.conf``). +* Recognizing and setting the filetype (after the user has manually updated + the `filetype extensions`_ file). +* `Filetype group membership`_. * Reading filetype settings in the ``[settings]`` section, including: * Using an existing syntax highlighting lexer (`lexer_filetype`_ key). - * Using an existing tag parser (``tag_parser`` key). + * Using an existing tag parser (`tag_parser`_ key). * Build commands (``[build-menu]`` section). -* Loading global tags files (sharing the ``tag_parser`` namespace). +* Loading global tags files (sharing the ``tag_parser`` filetype's namespace). See `Filetype configuration`_ for details on each setting. @@ -4166,6 +4167,8 @@ context_action_cmd *Example:* ``context_action_cmd=devhelp -s "%s"`` +.. _tag_parser: + tag_parser The TagManager language name, e.g. "C". Usually the same as the filetype name. @@ -4576,8 +4579,9 @@ whitespace_chars Filetype extensions ------------------- -To change the default filetype extension used when saving a new file, -see `Filetype definition files`_. +.. note:: + To change the default filetype extension used when saving a new file, + see `Filetype definition files`_. You can override the list of file extensions that Geany uses to detect filetypes using the user ``filetype_extensions.conf`` file. Use the @@ -4597,7 +4601,7 @@ should look like:: Make=Makefile*;*.mk;Buildfile; Filetype group membership -------------------------- +^^^^^^^^^^^^^^^^^^^^^^^^^ Group membership is also stored in ``filetype_extensions.conf``. This file is used to store information Geany needs at startup, whereas the separate filetype definition files hold information only needed when