Differences between revisions 1 and 12 (spanning 11 versions)
Revision 1 as of 2011-10-22 14:15:26
Size: 1445
Editor: broadband-188-32-136-141
Comment:
Revision 12 as of 2012-03-04 15:28:11
Size: 3590
Editor: broadband-188-32-136-141
Comment: Syncronized page contents with plugin help on commit e94520bcd0b9805f878a9856d62d36892c3c1a7a(done by pkgdo.pl)
Deletions are marked like this. Additions are marked like this.
Line 16: Line 16:
Web page: ''https://bitbucket.org/ZyX_I/aurum'' Web page: ''https://bitbucket.org/ZyX_I/aurum'', ''http://www.vim.org/scripts/script.php?script_id=3828''
Line 20: Line 20:
This plugin provides a vim VCS (now only Mercurial is supported) integration for your
projects. Features:
This plugin provides a vim <--> VCS (currently mercurial, git and subversion) integration for your projects. Features:
Line 23: Line 22:
 * Partially committing changes ({{{:AuRecord}}})  * Partially committing changes ([[http://vimpluginloader.sourceforge.net/doc/aurum.txt.html#line372-0|:AuRecord]]).
Line 25: Line 24:
 * Viewing file state at particular revision ({{{aurum://file}}}, {{{:AuFile}}})  * Viewing file state at particular revision ([[http://vimpluginloader.sourceforge.net/doc/aurum.txt.html#line614-0|aurum://file]], [[http://vimpluginloader.sourceforge.net/doc/aurum.txt.html#line158-0|:AuFile]]).
Line 27: Line 26:
 * Viewing uncommited changes in a vimdiff ({{{:AuVimDiff}}}).  * Viewing uncommited changes in a vimdiff, as well as changes between specific revisions ([[http://vimpluginloader.sourceforge.net/doc/aurum.txt.html#line415-0|:AuVimDiff]]). It is also possible to open multiple tabs with all changes to all files viewed as side-by-side diffs.
Line 29: Line 28:
 * Viewing revisions log ({{{:AuLog}}}). Output is highly customizable.  * Viewing revisions log ([[http://vimpluginloader.sourceforge.net/doc/aurum.txt.html#line239-0|:AuLog]]). Output is highly customizable.
Line 31: Line 30:
 * Viewing working directory status ({{{:AuStatus}}}).  * Viewing working directory status ([[http://vimpluginloader.sourceforge.net/doc/aurum.txt.html#line376-0|:AuStatus]]).
Line 33: Line 32:
 * Frontends for various VCS commands.
Most commands can be reached with a set of mappings (see ''Global mappings'' section on the help page),
all mappings are customizable.
 * Commiting changes ([[http://vimpluginloader.sourceforge.net/doc/aurum.txt.html#line99-0|:AuCommit]]), commit messages are remembered in case of rollback ([[http://vimpluginloader.sourceforge.net/doc/aurum.txt.html#line896-0|g:aurum_remembermsg]]).
Line 37: Line 34:
Documentation is available online at http://vimpluginloader.sourceforge.net/doc/aurum.txt.html.  * Obtaining various URL’s out of remote repository URL (like URL of the HTML version of the current file with URL fragment pointing to the current line attached: useful for sharing) ([[http://vimpluginloader.sourceforge.net/doc/aurum.txt.html#line189-0|:AuHyperlink]]).

 * [[http://vimpluginloader.sourceforge.net/doc/aurum.txt.html#line463-0|aurum#changeset()]], [[http://vimpluginloader.sourceforge.net/doc/aurum.txt.html#line459-0|aurum#repository()]] and [[http://vimpluginloader.sourceforge.net/doc/aurum.txt.html#line467-0|aurum#status()]] functions that are to be used from modeline.

 * Frontends for various other VCS commands.

Most commands can be reached with a set of mappings (see [[http://vimpluginloader.sourceforge.net/doc/aurum.txt.html#line769-0|aurum-mappings]]), all mappings are customizable.


Plugin’s mercurial driver is able to use mercurial python API as well as its CLI, but remember that the former is much slower and less tested. In order to use mercurial python API you must have vim compiled with +python (mercurial currently does not support python 3) and have mercurial in python’s sys.path (note: on windows msi installer is not adding mercurial to sys.path, so you won’t be able to use its python API).


Plugin requires some additional plugins:

 * [[https://bitbucket.org/ZyX_I/frawor|frawor]]

(with their dependencies).


Note: aurum supports [[https://github.com/MarcWeber/vim-addon-manager|VAM]]. It is prefered that you use it for aurum installation.

Aurum

Vim plugin providing Mercurial ↔ Vim integration

1. Status

This plugin is not distributed with Mercurial or Vim.

Author: Nikolay Pavlov

Repository: https://bitbucket.org/ZyX_I/aurum

Web page: https://bitbucket.org/ZyX_I/aurum, http://www.vim.org/scripts/script.php?script_id=3828

2. Overview

This plugin provides a vim <--> VCS (currently mercurial, git and subversion) integration for your projects. Features:

  • Partially committing changes (:AuRecord).

  • Viewing file state at particular revision (aurum://file, :AuFile).

  • Viewing uncommited changes in a vimdiff, as well as changes between specific revisions (:AuVimDiff). It is also possible to open multiple tabs with all changes to all files viewed as side-by-side diffs.

  • Viewing revisions log (:AuLog). Output is highly customizable.

  • Viewing working directory status (:AuStatus).

  • Commiting changes (:AuCommit), commit messages are remembered in case of rollback (g:aurum_remembermsg).

  • Obtaining various URL’s out of remote repository URL (like URL of the HTML version of the current file with URL fragment pointing to the current line attached: useful for sharing) (:AuHyperlink).

  • aurum#changeset(), aurum#repository() and aurum#status() functions that are to be used from modeline.

  • Frontends for various other VCS commands.

Most commands can be reached with a set of mappings (see aurum-mappings), all mappings are customizable.

Plugin’s mercurial driver is able to use mercurial python API as well as its CLI, but remember that the former is much slower and less tested. In order to use mercurial python API you must have vim compiled with +python (mercurial currently does not support python 3) and have mercurial in python’s sys.path (note: on windows msi installer is not adding mercurial to sys.path, so you won’t be able to use its python API).

Plugin requires some additional plugins:

(with their dependencies).

Note: aurum supports VAM. It is prefered that you use it for aurum installation.

3. Configuration

This plugin does not require any modifications to .hgrc. You can use vim-addon-manager to install it or manually clone https://bitbucket.org/ZyX_I/aurum and https://bitbucket.org/ZyX_I/frawor somewhere and add

set rtp+=/path/to/aurum,/path/to/frawor

to your vimrc.

Aurum (last edited 2013-10-11 03:49:24 by ZyX)