Branch: refs/heads/master Author: elextr elextr@gmail.com Committer: elextr elextr@gmail.com Date: Wed, 26 Jun 2013 04:52:52 UTC Commit: d4398d7fd0c028bf51b58b229c6b4d4a7b4b96f1 https://github.com/geany/geany/commit/d4398d7fd0c028bf51b58b229c6b4d4a7b4b96...
Log Message: ----------- Add some more explanation to indentation documentation
Explain operation of tabs and spaces setting. Explain relation of autoindent settings and indentation type. Add note regarding filetypes to match braces.
Modified Paths: -------------- doc/geany.txt
Modified: doc/geany.txt 29 files changed, 24 insertions(+), 5 deletions(-) =================================================================== @@ -786,9 +786,22 @@ Indentation ^^^^^^^^^^^
Geany allows each document to indent either with a tab character, -multiple spaces or a combination of both. The default indent -settings are set in `Editor Indentation preferences`_ (see the link -for more information). +multiple spaces or a combination of both. + +The *Tabs* setting indents with one tab character per indent level, and +displays tabs as the indent width. + +The *Spaces* setting indents with the number of spaces set in the indent +width for each level. + +The *Tabs and Spaces* setting indents with spaces as above, then converts +as many spaces as it can to tab characters at the rate of one tab for +each multiple of the `Various preference` setting +*indent_hard_tab_width* (default 8) and displays tabs as the +*indent_hard_tab_width* value. + +The default indent settings are set in `Editor Indentation +preferences`_ (see the link for more information).
The default settings can be overridden per-document using the Document menu. They can also be overridden by projects - see @@ -830,7 +843,10 @@ Geany has four types of auto-indentation: None Disables auto-indentation completely. Basic - Adds the same amount of whitespace on a new line as on the last line. + Adds the same amount of whitespace on a new line as on the previous line. + For the *Tabs* and the *Spaces* indent types the indentation will use the + same combination of characters as the previous line. The + *Tabs and Spaces* indentation type converts as explained above. Current chars Does the same as *Basic* but also indents a new line after an opening brace '{', and de-indents when typing a closing brace '}'. For Python, @@ -838,7 +854,10 @@ Current chars previous line. Match braces Similar to *Current chars* but the closing brace will be aligned to - match the indentation of the line with the opening brace. + match the indentation of the line with the opening brace. This + requires the filetype to be one where Geany knows that the Scintilla + lexer understands matching braces (C, C++, D, HTML, Pascal, Bash, + Perl, TCL).
There is also XML-tag auto-indentation. This is enabled when the mode is more than just Basic, and is also controlled by a filetype
-------------- This E-Mail was brought to you by github_commit_mail.py (Source: https://github.com/geany/infrastructure).