Source

aurum / README.markdown

ZyX_I f4dc8db 
ZyX_I 47ba2f7 

ZyX_I f4dc8db 
ZyX_I 4df1d8d 
ZyX_I f4dc8db 
ZyX_I 4df1d8d 
ZyX_I f4dc8db 
ZyX_I d48fa40 
ZyX_I 4df1d8d 
ZyX_I d48fa40 
ZyX_I f4dc8db 
ZyX_I 47ba2f7 
ZyX_I f4dc8db 
ZyX_I 4df1d8d 
ZyX_I f4dc8db 
ZyX_I 47ba2f7 
ZyX_I 4df1d8d 
ZyX_I 817118b 


ZyX_I 47ba2f7 
ZyX_I f4dc8db 
ZyX_I 4df1d8d 
ZyX_I ef2926d 
ZyX_I d48fa40 
ZyX_I ef2926d 

ZyX_I 4df1d8d 
ZyX_I f4dc8db 


ZyX_I 1533dba 
ZyX_I f4dc8db 

ZyX_I 1533dba 
ZyX_I f4dc8db 
ZyX_I 1533dba 
ZyX_I f4dc8db 



ZyX_I cf85020 
ZyX_I f4dc8db 



ZyX_I cf5fa37 
ZyX_I f4dc8db 

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

  - Partially committing changes ([:AuRecord](http://vimpluginloader.sourceforge.net/doc/aurum.txt.html#line372-0)).

  - Viewing file state at particular revision ([aurum://file](http://vimpluginloader.sourceforge.net/doc/aurum.txt.html#line614-0), [:AuFile](http://vimpluginloader.sourceforge.net/doc/aurum.txt.html#line158-0)).

  - Viewing uncommited changes in a vimdiff, as well as changes between 
    specific revisions ([:AuVimDiff](http://vimpluginloader.sourceforge.net/doc/aurum.txt.html#line415-0)). It is also possible to open multiple 
    tabs with all changes to all files viewed as side-by-side diffs.

  - Viewing revisions log ([:AuLog](http://vimpluginloader.sourceforge.net/doc/aurum.txt.html#line239-0)). Output is highly customizable.

  - Viewing working directory status ([:AuStatus](http://vimpluginloader.sourceforge.net/doc/aurum.txt.html#line376-0)).

  - Commiting changes ([:AuCommit](http://vimpluginloader.sourceforge.net/doc/aurum.txt.html#line99-0)), commit messages are remembered in case of 
    rollback ([g:aurum_remembermsg](http://vimpluginloader.sourceforge.net/doc/aurum.txt.html#line896-0)).

  - Obtaining various URLs 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](http://vimpluginloader.sourceforge.net/doc/aurum.txt.html#line189-0)).

  - [aurum#changeset()](http://vimpluginloader.sourceforge.net/doc/aurum.txt.html#line463-0), [aurum#repository()](http://vimpluginloader.sourceforge.net/doc/aurum.txt.html#line459-0) and [aurum#status()](http://vimpluginloader.sourceforge.net/doc/aurum.txt.html#line467-0) 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](http://vimpluginloader.sourceforge.net/doc/aurum.txt.html#line769-0)), 
all mappings are customizable.


Plugins 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 pythons sys.path 
(note: on windows msi installer is not adding mercurial to sys.path, so you 
wont be able to use its python API).


Plugin requires some additional plugins:

  - [frawor](https://bitbucket.org/ZyX_I/frawor)

(with their dependencies).


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

Documentation is available online at [http://vimpluginloader.sourceforge.net/doc/aurum.txt.html](http://vimpluginloader.sourceforge.net/doc/aurum.txt.html).
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.