summaryrefslogtreecommitdiffstats
path: root/.vim/doc/vtreeexplorer.txt
blob: 78933231dd446ed1f01fd6aa1225b121d8007d39 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
*vtreeexplorer.txt*	Vim Tree Explorer		Dec 28, 2007

Authors:  T. Scott Urban  <thomas.scott.urban@HORMELgmail.com>

          (remove the source of SPAM from my email first)

0. DESCRIPTION					*vtreeexplorer*

This plugin creates a tree based file explorer within vim.  The tree view is
similar to the output of the unix 'tree' command, with the addition that
directories are foldable and the tree is lazy loaded as you navigate the tree.
The tree is highlighted and several mapping are created for navigation and
opening files from the tree.

==============================================================================
1. CONTENTS					*vtreeexplorer-contents*

	0. DESCRIPTION ..................: |vtreeexplorer|
	1. CONTENTS......................: |vtreeexplorer-contents|
	2. VTREEEXPLORER INSTALLATION ...: |vtreeexplorer-install|
	3. VTREEEXPLORER CONFIGURATION ..: |vtreeexplorer-config|
	4. VTREEEXPLORER TERMS ..........: |vtreeexplorer-terms|
	5. VTREEEXPLORER MAPPINGS .......: |vtreeexplorer-mapping|
	     '<enter>' ..................: |vtreeexplorer-enter|
	     'o' ........................: |vtreeexplorer-o|
	     'o' ........................: |vtreeexplorer-O|
	     't' ........................: |vtreeexplorer-t|
	     'X' ........................: |vtreeexplorer-X|
	     'E' ........................: |vtreeexplorer-E|
	     'C' ........................: |vtreeexplorer-C|
	     'H' ........................: |vtreeexplorer-H|
	     'u' ........................: |vtreeexplorer-u|
	     'p' ........................: |vtreeexplorer-p|
	     'r' ........................: |vtreeexplorer-r|
	     'R' ........................: |vtreeexplorer-R|
	     'S' ........................: |vtreeexplorer-S|
	     'D' ........................: |vtreeexplorer-D|
	     'a' ........................: |vtreeexplorer-a|
	     '?' ........................: |vtreeexplorer-?|
	6. VTREEEXPLORER COMMANDS .......: |vtreeexplorer-commands|
	     :CD ........................: |vtreeexplorer-CD|
	     :Yank ......................: |vtreeexplorer-Yank|

==============================================================================
2. VTREEEXPLORER INSTALLATION			*vtreeexplorer-install*

To install, un-gzip and un-tar in your $HOME/.vim or $VIMRUNTIME directory, or
the equivalent for the OS you are using.  To add this documentation to the
searchable help index, do ":helptags ~/.vim/doc" or equivalent.

==============================================================================
3. VTREEEXPLORER CONFIGURATION			*vtreeexplorer-config*

There are four global variables that affect vtreeexplorer on startup.  These
variables only affect the initial behavior after using |VTreeExplore| or
|VSTreeExplore| to start the tree explorer.  Setting these variables after the
start of the tree explorer with those commands will have no affect on
currently running tree explorers.  Settings can be changed with the
commands/functions/mappings in running tree explorers.  This allows for the
creation of mutliple tree explorer windows with different settings.  The
global variables affecting tree explorer startup are:

treeExplVertical				*treeExplVertical*

Set this variable in your vimrc to use a vertical split when using the
splitting version of the explorer |VSTreeExplore|.

treeExplWinSize					*treeExplWinSize*

Set this variable to a number in your vimrc to control the windows size (width
or height, depending on |treeExplVertical| when using the splitting version of
the explorer |VSTreeExplore|.

treeExplHidden					*treeExplHidden*

Set this variable in your vimrc to start the exlorer with hidden files shown.
Otherwise, the explorer will be started with hidden files (start with '.' for
Unix) not shown.

This setting can be be toggled with the 'a' mapping (|vtreeexplorer-a|).

treeExplHidePattern				*treeExplHidePattern*

Set this variable to a regular expression to avoid showing matching files and
directories when the hidden option is set (in addition to hidden 'dotfiles').
This variable can be changed at anytime and it will be reflected in the next
refresh or directory load.

treeExplDirSort					*treeExplDirSort*

Set this variable in your vimrc to start the explorer with the desired
directory sorting. Possible values:

	 0 : no directory sorting
	 1 : directories sorted first
	-1 : directories sorted last

This setting can be switched with the 'D' mapping (|vtreeexplorer-D|.

treeExplIndent                                  *treeExplIndent*

This variable is used on initialization to determine the width of the tree
structures drawn at the left of the browser.  The default value is 3 which
yields a more compact view.  A value of 4 will emulate the old behavior.  the
maximum and minimum values for this setting are 2 and 8, respectively.

treeExplNoList					 treeExplNoList

This variable is used on initialization to tell the TreeExplorer not to list
itself in the buffer list. Use of this setting prevents restore of the
explorer with sessions.

==============================================================================
4. VTREEEXPLORER TERMS				*vtreeexplorer-terms*

The following terms are defined for brevity in the remainder of the
documentation:

cursordir					*vtreeexplorer-cursordir*

This term refers to the directory where the cursor is in the explorer.  If the
cursor is on a line with a directory, that is the cursordir.  If the cursor is
on a file, then the cursor dir is the parent directory of the file on the
cursor line.

topdir						*vtreeexplorer-topdir*

This term refers to the directory where the tree explorerer is rooted - that
is, the top-most directory shown in the tree.

==============================================================================
5. VTREEEXPLORER MAPPINGS			*vtreeexplorer-mappings*

'<enter>'					*vtreeexplorer-enter*

Same as |vtreeexplorer-o| below.

'o'						*vtreeexplorer-o*

If the cursor is on a line with a file, open that file in another window.  The
last window visitied is where the file will be opened, unless the previous
window contains an unmodified buffer or there is only one window, in which
case a new window will be opened for the file.

If the cursor is on a line with a directory, load the directory if it isn't
loaded, or toggle the fold for that directory, if the directory is loaded.

'O'						*vtreeexplorer-O*

Same as |vtreeexplorer-o| but use use the explorer window when opening the
file (closing the explorer).

't'						*vtreeexplorer-t*

Same as |vtreeexplorer-o| but use new tab instead window when opening the file.

'X'						*vtreeexplorer-X*

Recursively expand the |vtreeexplorer-cursordir|.

'E'						*vtreeexplorer-E*

Open the standard vim |file-explorer| on the |vtreeexplorer-cursordir|.

'C'						*vtreeexplorer-C*

Change the |vtreeexplorer-topdir| to the |vtreeexplorer-cursordir|.

'H'						*vtreeexplorer-H*

Change the |vtreeexplorer-topdir| to your home directory, defined by the
environement variable $HOME.

'u'						*vtreeexplorer-u*

Change the |vtreeexplorer-topdir| up one level, to the parent directory of the
current topdir.

'p'						*vtreeexplorer-p*

Move the cursor to the parent directory of the |vtreeexplorer-cursordir|.
Hitting 'p' mutliple times will quickly take you to the top of the tree.

'r'						*vtreeexplorer-r*

Refresh the |vtreeexplorer-cursordir|.  This command might unload
subdirectories of the cursordir, depending on current expansion.

'R'						*vtreeexplorer-R*

Refresh the |vtreeexplorer-topdir|.This command might unload subdirectories of
the cursordir, depending on current expansion.

'S'						*vtreeexplorer-S*

Start a shell in the |vtreeexplorer-cursordir|.

'D'						*vtreeexplorer-D*

Switch between the three directory sorting modes, described at
|treeExplDirSort|.  Initial value can be set with global variable
|treeExplDirSort|.

'a'						*vtreeexplorer-a*

Toggle showing hidden files.  Initial value can be set with global variable
|treeExplHidden|. Hidden files are those starting with a dot or those defined
by the regular expression in the variable |treeExplHidePattern|.

'?'						*vtreeexplorer-?*

Toggle long help display at top of window.

==============================================================================
5. VTREEEXPLORER COMMANDS			*vtreeexplorer-commands*

:CD						*vtreeexplorer-CD*

Change |vtreeexplorer-topdir| to argument of command.

:Yank						*vtreeexplorer-Yank*

Yank selection of tree with foldmarkers stripped from register.

vim:tw=78:ts=8:ft=help