Updated the readme and help file with details about the new customizable size option for indent guides

This commit is contained in:
Nate Kane 2011-01-05 13:22:40 +10:00
parent f2608db67e
commit d53103f9a8
2 changed files with 27 additions and 2 deletions

View File

@ -7,6 +7,7 @@ Indent Guides is a plugin for visually displaying indent levels in Vim.
* Will highlight indent levels with alternating colors. * Will highlight indent levels with alternating colors.
* Full support for gVim and basic support for Terminal Vim. * Full support for gVim and basic support for Terminal Vim.
* Seems to work on Windows gVim 7.3 (haven't done any extensive tests though). * Seems to work on Windows gVim 7.3 (haven't done any extensive tests though).
* Customizable size for indent guides, eg. skinny guides (soft-tabs only).
## Requirements ## Requirements
* Vim 7.2+ * Vim 7.2+

View File

@ -9,8 +9,8 @@
Author: Nate Kane <nathanaelkane AT gmail DOT com> Author: Nate Kane <nathanaelkane AT gmail DOT com>
Version: 1.1 Version: 1.2
Last Change: 29 Dec 2010 Last Change: 5 Jan 2011
============================================================================== ==============================================================================
CONTENTS *indent-guides-contents* CONTENTS *indent-guides-contents*
@ -39,6 +39,7 @@ Features:~
* Full support for gVim and basic support for Terminal Vim. * Full support for gVim and basic support for Terminal Vim.
* Seems to work on Windows gVim 7.3 (haven't done any extensive tests * Seems to work on Windows gVim 7.3 (haven't done any extensive tests
though). though).
* Customizable size for indent guides, eg. skinny guides (soft-tabs only).
============================================================================== ==============================================================================
2. COMMANDS *indent-guides-commands* 2. COMMANDS *indent-guides-commands*
@ -63,6 +64,7 @@ Features:~
------------------------------------------------------------------------------ ------------------------------------------------------------------------------
*'indent_guides_indent_levels'* *'indent_guides_indent_levels'*
Use this option to control how many indent levels to display guides for. Use this option to control how many indent levels to display guides for.
Default: 30. Values: integer. Default: 30. Values: integer.
> >
let g:indent_guides_indent_levels = 30 let g:indent_guides_indent_levels = 30
@ -73,6 +75,7 @@ Default: 30. Values: integer.
Use this option to control whether or not the plugin automatically calculates Use this option to control whether or not the plugin automatically calculates
the highlight colors. Will use the current colorscheme's background color as a the highlight colors. Will use the current colorscheme's background color as a
base color. base color.
Default: 1. Values: 0 or 1. Default: 1. Values: 0 or 1.
> >
let g:indent_guides_auto_colors = 1 let g:indent_guides_auto_colors = 1
@ -90,11 +93,29 @@ in an autocmd.
*'indent_guides_color_change_percent'* *'indent_guides_color_change_percent'*
Use this option to control the percent at which the highlight colors will be Use this option to control the percent at which the highlight colors will be
lightened or darkened. lightened or darkened.
Default: 0.05. Values: between 0 and 1. Default: 0.05. Values: between 0 and 1.
> >
let g:indent_guides_color_change_percent = 0.05 let g:indent_guides_color_change_percent = 0.05
< <
------------------------------------------------------------------------------
*'indent_guides_indent_guide_size'*
Use this option to customize the size of the indent guide. By default the
value is set to 0, which will set the guide size to be the same as the
|shiftwidth|. Setting this value to be larger than the |shiftwidth| is essentially
the same as setting it to 0.
A common use of this setting is to create skinny indent guides, which look
great with a |shiftwidth| of 4 or more.
NOTE: This option only works for soft-tabs (spaces) and not for hard-tabs.
Default: 0. Values: between 0 and |shiftwidth|.
>
let g:indent_guides_indent_guide_size = 1
<
============================================================================== ==============================================================================
4. MAPPINGS *indent-guides-mappings* 4. MAPPINGS *indent-guides-mappings*
@ -172,6 +193,9 @@ Bug reports, feedback, suggestions etc are welcomed.
============================================================================== ==============================================================================
7. CHANGELOG *indent-guides-changelog* 7. CHANGELOG *indent-guides-changelog*
1.2~
* Customizable size for indent guides, eg. skinny guides (soft-tabs only).
* Refactored some internal logic.
1.1~ 1.1~
* Added basic support for Terminal Vim. See |indent-guides-terminal-vim| for * Added basic support for Terminal Vim. See |indent-guides-terminal-vim| for
more information. more information.