vim ex명령에서 :helptags ~/.vim/doc 또는 :helptags add-local-help 라고 입력하면
vim 메인 help 화면에서 도움말 확인할 수있음...
/cvscommand 나 /local 로 검색하고 cvscommand.txt 위에 커서를 놓고
^](CTRL-])를 누르면 cvscommand help로 이동한다.
다운로드 페이지 : http://www.vim.org/scripts/script.php?script_id=90
*cvscommand.txt* CVSCommand
For instructions on installing this file, type
:help add-local-help
inside Vim.
Author: Bob Hiestand
Credits: Benji Fisher's excellent MatchIt documentation
==============================================================================
1. Contents *cvscommand-contents*
Installation : cvscommand-install
CVSCommand Intro : cvscommand
CVSCommand Manual : cvscommand-manual
Customization : cvscommand-customize
SSH "integration" : cvscommand-ssh
Bugs : cvscommand-bugs
==============================================================================
2. CVSCommand Installation *cvscommand-install*
The CVSCommand plugin comprises two files, cvscommand.vim and cvscommand.txt
(this file). In order to install the plugin, place the cvscommand.vim file
into a plugin' directory in your runtime path (please see add-global-plugin
and 'runtimepath'.
CVSCommand may be customized by setting variables, creating maps, and
specifying event handlers. Please see cvscommand-customize for more
details.
This help file can be included in the VIM help system by copying it into a
'doc' directory in your runtime path and then executing the :helptags
command, specifying the full path of the 'doc' directory. Please see
add-local-help for more details.
==============================================================================
3. CVSCommand Intro *cvscommand*
*cvscommand-intro*
The CVSCommand plugin provides global ex commands for manipulating
CVS-controlled source files. In general, each command operates on the current
buffer and accomplishes a separate cvs function, such as update, commit, log,
and others (please see cvscommand-commands for a list of all available
commands). The results of each operation are displayed in a scratch buffer.
Several buffer variables are defined for those scratch buffers (please see
cvscommand-buffer-variables).
The notion of "current file" means either the current buffer, or, in the case
of a directory buffer, the file on the current line within the buffer.
For convenience, any CVSCommand invoked on a CVSCommand scratch buffer acts as
though it was invoked on the original file and splits the screen so that the
output appears in a new window.
Many of the commands accept revisions as arguments. By default, most operate
on the most recent revision on the current branch if no revision is specified
(though see CVSCommandInteractive to prompt instead).
Each CVSCommand is mapped to a key sequence starting with the
keystroke. The default mappings may be overridden by supplying different
mappings before the plugin is loaded, such as in the vimrc, in the standard
fashion for plugin mappings. For examples, please see
cvscommand-mappings-override.
The CVSCommand plugin may be configured in several ways. For more details,
please see cvscommand-customize.
==============================================================================
4. CVSCommand Manual *cvscommand-manual*
4.1 CVSCommand commands *cvscommand-commands*
CVSCommand defines the following commands:
:CVSAdd
:CVSAnnotate
:CVSCommit
:CVSDiff
:CVSEdit
:CVSEditors
:CVSGotoOriginal
:CVSLog
:CVSRevert
:CVSReview
:CVSStatus
:CVSUnedit
:CVSUpdate
:CVSVimDiff
:CVSWatch
:CVSWatchAdd
:CVSWatchOn
:CVSWatchOff
:CVSWatchRemove
:CVSWatchers
:CVSAdd *:CVSAdd*
This command performs "cvs add" on the current file. Please note, this does
not commit the newly-added file.
:CVSAnnotate *:CVSAnnotate*
This command performs "cvs annotate" on the current file. If an argument is
given, the argument is used as a revision number to display. If not given an
argument, it uses the most recent version of the file on the current branch.
Additionally, if the current buffer is a CVSAnnotate buffer already, the
version number on the current line is used.
If the CVSCommandAnnotateParent variable is set to a non-zero value, the
version previous to the one on the current line is used instead. This allows
one to navigate back to examine the previous version of a line.
The filetype of the CVSCommand scratch buffer is set to 'CVSAnnotate', to take
advantage of the bundled syntax file.
:CVSCommit[!] *:CVSCommit*
If called with arguments, this performs "cvs commit" using the arguments as
the log message.
If '!' is used with no arguments, an empty log message is committed.
If called with no arguments, this is a two-step command. The first step opens
a buffer to accept a log message. When that buffer is written, it is
automatically closed and the file is committed using the information from that
log message. The commit can be abandoned if the log message buffer is deleted
or wiped before being written.
Alternatively, the mapping that is used to invoke :CVSCommit (by default
is useful if the CVSCommandCommitOnWrite variable is set to 0 to disable the
normal commit-on-write behavior.
:CVSDiff *:CVSDiff*
With no arguments, this performs "cvs diff" on the current file against the
current repository version.
With one argument, "cvs diff" is performed on the current file against the
specified revision.
With two arguments, cvs diff is performed between the specified
revisions of the current file.
This command uses the 'CVSCommandDiffOpt' variable to specify diff options.
If that variable does not exist, then 'wbBc' is assumed. If you wish to have
no options, then set it to the empty string.
:CVSEdit *:CVSEdit*
This command performs "cvs edit" on the current file. Yes, the output buffer
in this case is almost completely useless.
:CVSEditors *:CVSEditors*
This command performs "cvs edit" on the current file.
:CVSGotoOriginal *:CVSGotoOriginal*
This command returns the current window to the source buffer, if the current
buffer is a CVS command output buffer.
:CVSGotoOriginal!
Like ":CVSGotoOriginal" but also executes :bufwipeout on all CVS command
output buffers for the source buffer.
:CVSLog *:CVSLog*
Performs "cvs log" on the current file.
If an argument is given, it is passed as an argument to the "-r" option of
"cvs log".
:CVSRevert *:CVSRevert*
Replaces the current file with the most recent version from the repository in
order to wipe out any undesired changes.
:CVSReview *:CVSReview*
Retrieves a particular version of the current file. If no argument is given,
the most recent version of the file on the current branch is retrieved.
Otherwise, the specified version is retrieved.
:CVSStatus *:CVSStatus*
Performs "cvs status" on the current file.
:CVSUnedit *:CVSUnedit*
Performs "cvs unedit" on the current file. Again, yes, the output buffer here
is basically useless.
:CVSUpdate *:CVSUpdate*
Performs "cvs update" on the current file. This intentionally does not
automatically reload the current buffer, though vim should prompt the user to
do so if the underlying file is altered by this command.
:CVSVimDiff *:CVSVimDiff*
With no arguments, this prompts the user for a revision and then uses vimdiff
to display the differences between the current file and the specified
revision. If no revision is specified, the most recent version of the file on
the current branch is used.
With one argument, that argument is used as the revision as above. With two
arguments, the differences between the two revisions is displayed using
vimdiff.
With either zero or one argument, the original buffer is used to perform the
vimdiff. When the other buffer is closed, the original buffer will be
returned to normal mode.
Once vimdiff mode is started using the above methods, additional vimdiff
buffers may be added by passing a single version argument to the command.
There may be up to 4 vimdiff buffers total.
Using the 2-argument form of the command resets the vimdiff to only those 2
versions. Additionally, invoking the command on a different file will close
the previous vimdiff buffers.
:CVSWatch *:CVSWatch*
This command takes an argument which must be one of [onoffaddremove]. The
command performs "cvs watch" with the given argument on the current file.
:CVSWatchAdd *:CVSWatchAdd*
This command is an alias for ":CVSWatch add"
:CVSWatchOn *:CVSWatchOn*
This command is an alias for ":CVSWatch on"
:CVSWatchOff *:CVSWatchOff*
This command is an alias for ":CVSWatch off"
:CVSWatchRemove *:CVSWatchRemove*
This command is an alias for ":CVSWatch remove"
:CVSWatchers *:CVSWatchers*
This command performs "cvs watchers" on the current file.
4.2 Mappings *cvscommand-mappings*
By default, a mapping is defined for each command. These mappings execute the
default (no-argument) form of each command.
*cvscommand-mappings-override*
The default mappings can be overriden by user-provided instead by mapping to
other existing mappings (vim will warn of this during plugin initialization,
but will not clobber the existing mappings).
For instance, to override the default mapping for :CVSAdd to set it to '\add',
add the following to the vimrc:
nmap \add
4.3 Automatic buffer variables *cvscommand-buffer-variables*
Several buffer variables are defined in each CVSCommand result buffer. These
may be useful for additional customization in callbacks defined in the event
handlers (please see cvscommand-events).
The following variables are automatically defined:
b:cvsOrigBuffNR *b:cvsOrigBuffNR*
This variable is set to the buffer number of the source file.
b:cvscmd *b:cvscmd*
This variable is set to the name of the cvs command that created the result
buffer.
==============================================================================
5. Configuration and customization *cvscommand-customize*
*cvscommand-config*
The CVSCommand plugin can be configured in two ways: by setting configuration
variables (see cvscommand-options) or by defining CVSCommand event handlers
(see cvscommand-events). Additionally, the CVSCommand plugin provides
several option for naming the CVS result buffers (see cvscommand-naming) and
supported a customized status line (see cvscommand-statusline and
cvscommand-buffer-management).
5.1 CVSCommand configuration variables *cvscommand-options*
Several variables affect the plugin's behavior. These variables are checked
at time of execution, and may be defined at the window, buffer, or global
level and are checked in that order of precedence.
The following variables are available:
CVSCommandAnnotateParent
CVSCommandCommitOnWrite
CVSCommandCVSExec
CVSCommandDeleteOnHide
CVSCommandDiffOpt
CVSCommandDiffSplit
CVSCommandEdit
CVSCommandEnableBufferSetup
CVSCommandInteractive
CVSCommandNameMarker
CVSCommandNameResultBuffers
CVSCommandSplit
CVSCommandAnnotateParent *CVSCommandAnnotateParent*
This variable, if set to a non-zero value, causes the zero-argument form of
CVSAnnotate when invoked on a CVSAnnotate buffer to go to the version previous
to that displayed on the current line. If not set, it defaults to 0.
CVSCommandCommitOnWrite *CVSCommandCommitOnWrite*
This variable, if set to a non-zero value, causes the pending cvs commit
to take place immediately as soon as the log message buffer is written.
If set to zero, only the CVSCommit mapping will cause the pending commit to
occur. If not set, it defaults to 1.
CVSCommandCVSExec *CVSCommandCVSExec*
This variable controls the executable used for all CVS commands If not set,
it defaults to "cvs".
CVSCommandDeleteOnHide *CVSCommandDeleteOnHide*
This variable, if set to a non-zero value, causes the temporary CVS result
buffers to automatically delete themselves when hidden.
CVSCommandDiffOpt *CVSCommandDiffOpt*
This variable, if set, determines the options passed to the diff command of
CVS. If not set, it defaults to 'wbBc'.
CVSCommandDiffSplit *CVSCommandDiffSplit*
This variable overrides the CVSCommandSplit variable, but only for buffers
created with :CVSVimDiff.
CVSCommandEdit *CVSCommandEdit*
This variable controls whether the original buffer is replaced ('edit') or
split ('split'). If not set, it defaults to 'edit'.
CVSCommandEnableBufferSetup *CVSCommandEnableBufferSetup*
This variable, if set to a non-zero value, activates CVS buffer management
mode see (cvscommand-buffer-management). This mode means that two buffer
variables, 'CVSRevision' and 'CVSBranch', are set if the file is
CVS-controlled. This is useful for displaying version information in the
status bar.
CVSCommandInteractive *CVSCommandInteractive*
This variable, if set to a non-zero value, causes appropriate commands (for
the moment, only :CVSReview) to query the user for a revision to use instead
of the current revision if none is specified.
CVSCommandNameMarker *CVSCommandNameMarker*
This variable, if set, configures the special attention-getting characters
that appear on either side of the cvs buffer type in the buffer name. This
has no effect unless CVSCommandNameResultBuffers is set to a true value. If
not set, it defaults to '_'.
CVSCommandNameResultBuffers *CVSCommandNameResultBuffers*
This variable, if set to a true value, causes the cvs result buffers to be
named in the old way ('
or set to a false value, the result buffer is nameless.
CVSCommandSplit *CVSCommandSplit*
This variable controls the orientation of the various window splits that
may occur (such as with CVSVimDiff, when using a CVS command on a CVS
command buffer, or when the CVSCommandEdit variable is set to 'split'.
If set to 'horizontal', the resulting windows will be on stacked on top of
one another. If set to 'vertical', the resulting windows will be
side-by-side. If not set, it defaults to 'horizontal' for all but
CVSVimDiff windows.
5.2 CVSCommand events *cvscommand-events*
For additional customization, CVSCommand can trigger user-defined events.
Event handlers are provided by defining User event autocommands (see
autocommand, User) in the CVSCommand group with patterns matching the
event name.
For instance, the following could be added to the vimrc to provide a 'q'
mapping to quit a CVSCommand scratch buffer:
augroup CVSCommand
au CVSCommand User CVSBufferCreated silent! nmap
augroup END
The following hooks are available:
CVSBufferCreated This event is fired just after a cvs command
result buffer is created and filled with the
result of a cvs command. It is executed within
the context of the CVS command buffer. The
CVSCommand buffer variables may be useful for
handlers of this event (please see
cvscommand-buffer-variables).
CVSBufferSetup This event is fired just after CVS buffer setup
occurs, if enabled.
CVSPluginInit This event is fired when the CVSCommand plugin
first loads.
CVSPluginFinish This event is fired just after the CVSCommand
plugin loads.
CVSVimDiffFinish This event is fired just after the CVSVimDiff
command executes to allow customization of,
for instance, window placement and focus.
5.3 CVSCommand buffer naming *cvscommand-naming*
By default, the buffers containing the result of CVS commands are nameless
scratch buffers. It is intended that buffer variables of those buffers be
used to customize the statusline option so that the user may fully control the
display of result buffers.
If the old-style naming is desired, please enable the
CVSCommandNameResultBuffers variable. Then, each result buffer will receive
a unique name that includes the source file name, the CVS command, and any
extra data (such as revision numbers) that were part of the command.
5.4 CVSCommand status line support *cvscommand-statusline*
It is intended that the user will customize the 'statusline' option to
include CVS result buffer attributes. A sample function that may be used in
the 'statusline' option is provided by the plugin, CVSGetStatusLine(). In
order to use that function in the status line, do something like the
following:
set statusline=%
댓글 없음:
댓글 쓰기