-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
137 lines (97 loc) · 6.21 KB
/
README
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
This is a mirror of http://www.vim.org/scripts/script.php?script_id=4256
Basic usage
------------------------------------------------------------------------------------------
Ozzy is very straightforward to use. Once installed, you can start editing
files as always. Once you open a file Ozzy keeps track of it and from then
you can open that file with the following command:
:Ozzy <file name>
How Ozzy knows the right file to open when there are two or more files with
the same name? Ozzy by default opens the file who has been opened more
frequently. You can customize this behavior setting the 'g:ozzy_mode' variable
to the following values:
* 'most frequent': open the most frequently opened file.
* 'most recent': open the most recently opened file.
* 'context': open the closest file respect to the current working directory.
You are not limited to just file names. The 'Ozzy' command accepts even partial
paths such as 'directory/filename' and directory names such as 'directory/'.
In the latter case note the presence of a forward slash as the last character:
this cause Ozzy to open all the files contained in the directory (note that only
files tracked by Ozzy will be opened).
Command line tab completion is supported but only for file names.
Below are listed some basic available commands:
Ozzy (shortcut: O)
------------------------------------------------------------------------------------------
Depending to the type of the value passed as argument this command
performs different actions:
* if a file name is given then a file in the index that match the give name is
opened (the right file is selected depending on the current mode: most
frequent, most recent or context). See also the option `g:ozzy_ignore_ext`.
* if a partial path ending with a filename is given the the behavior descibed
above is retained but there might be less potenyial conflicts.
* if a partial path ending with a forward slash is given the all files
contained in that directory will be opened (only those files tracked by
Ozzy). If Ozzy has in its index two or more directories with the same name,
the right one is selected according to the current mode:
- 'most frequent': the directory that contains more frequently opened files is opened.
- 'most recent': the directory that contains more recently accessed files is opened.
- 'context': the closest directory is opened.
Note however that Ozzy does not really scan the physical directory on the
file system, but instead it will search exclusively in its database for possible
matches. You have to open files at least once manually or with the
OzzyAddDirectory command before Ozzy can open them.
OzzyInspect (shortcut: Oi)
------------------------------------------------------------------------------------------
Opens the Inspector buffer. This place is where you can inspect the whole file
index and perform some actions on single entries like increasing the access
frequency, setting the last access time, doing various sorts, ecc.. For more
information about available actions type `?` inside the Inspector buffer.
OzzyScope (shortcut: Oscope)
------------------------------------------------------------------------------------------
Sets the Ozzy scope to the given path. By default the scope is global but once
you set it to a certain `path` Ozzy will be no more able to open files that
reside outside that `path`. Further, they will be no more indexed and
included command line completion. Already indexed files won't be removed:
you can still interact with them throughout the Inspector. If you want to add
all files contained into the current working directory you can use the `.`
shortcut instead. To add the current parent directory use the `..` argument.
Use the `...` argument to add the project root directory (see the
`g:ozzy_what_in_project_root` option). By default *Ozzy* assumes the project
root directory as the one containing a `.git`, `.hg` or a `.svn` folder along
the current working directory path.
To restore the global scope use the command with no arguments.
You can customize the default behavior with the following options:
* -p <comma separated list>: override the global `g:ozzy_what_in_project_root`
options (works only with the special argument `...`)
OzzyAddDirectory (shortcut: Oadd)
------------------------------------------------------------------------------------------
To add all files contained into the given `path` (by default except those
contained into hidden directories). If you want to add all files contained into
the current working directory you can use the `.` shortcut instead. To add the
current parent directory use the `..` argument. Use the `...` argument to add
the project root directory (see the `g:ozzy_what_in_project_root` option). By
default Ozzy assumes the project root directory as the one containing
a `.git`, `.hg` or a `.svn` folder along the current working directory path.
You can customize the default behavior with the following options:
* -h: add files contained into hidden directories.
* -a <comma separated list>: add only specific files. See below for allowed patterns.
* -i <comma separated list>: ignore specific files. See below for allowed patterns.
* -p <comma separated list>: override the global `g:ozzy_what_in_project_root`
option (works only with the special argument `...`).
Allowed patterns:
* `*.<ext>`
all file names with extension `<ext>`.
examples: `*.py`, `*.cpp`
* `<file name>.*`
all files named `<file name>` regardless the extension (file names that
exactly match `<file name>` will be considered too).
examples: `doc.*`, `log.*`, `README.*`
* `<file name>`
all file names that exactly match `<file name>`.
examples: `test.py`, `junk.txt`, `LICENSE`
* `<partial path>/`
all paths that contain `<path>`.
examples: `doc/` (every file in a folder called 'doc')
------------------------------------------------------------------------------------------
For information about other available commands and settings see
the full documentation. (:help ozzy)
Get latest versions at: https://github.com/gcmt/ozzy.vim