Version 3.0

- Organisational changes: The project is now hosted on github. Snippets are
  now shipped separately - please track honza/vim-snippets.
- UltiSnips is now a drop in replacement for snipMate - it parses snipMate
  snippets and expands them emulating snipMates smaller feature set.
- Filetype tab completion for UltiSnipsEdit.
- UltiSnipsEdit now only edits private snippet files. Use UltiSnipsEdit! if
  you want to edit shipped files.
- New option 's' which strips trailing whitespace before jumping to next
  tabstop
- New option 'a' which converts non-ascii characters into ascii characters
  in transformations.
- New keyword in snippet files: priority defines which snippets should
  overwrite others. This deprecates the '!' option.
  *UltiSnips-adding-snippets*
- Remove common whitespace of visual line selections before inserting in an
  indented tabstop.
- Support for overwriting the snippet directory name on a per buffer basis
  to support per project snippets. *UltiSnips-snippet-search-path*
- The keymaps for jumping in snippets are now only mapped when a snippet is
  active, allowing them to be used for something else otherwise.
- Expanding and jumping no longer overwrites the unnamed register.
- Integration with Valloric/YouCompleteMe and Shougo/neocomplete.vim.
- Other plugins can add sources for snippets to create snippets on the fly.
  *UltiSnips-extending*
- Vim functions now indicates if it did any work.
  *UltiSnips-trigger-functions*
- For python extensions: UltiSnips adds itself to the sys.path and can be
  easily imported if it is available. *UltiSnips-python-module-path*
- A new function giving programmatic access to the snippets currently
  available for expansion for other plugins integrating with UltiSnips.
  *UltiSnips_SnippetsInCurrentScope*
- New or improved snippets (now in a different repo): all, bib, c, cpp, cs,
  d, django, eruby, go, haskell, html, html, htmljinja, java, javascript,
  js, ledger, ocaml, perl, php, puppet, python, ruby, scss, sh, tex, vim,
  xml, zsh.

Author: SirVer

.bzrignore

@@ -0,0 +1,2 @@
+doc/tags
+.bzr-repo

ChangeLog

@@ -1,4 +1,41 @@
-version 2.2:
+version 3.0 (02-Mar-2014):
+	- Organisational changes: The project is now hosted on github. Snippets are
+	  now shipped separately - please track honza/vim-snippets.
+	- UltiSnips is now a drop in replacement for snipMate - it parses snipMate
+	  snippets and expands them emulating snipMates smaller feature set.
+	- Filetype tab completion for UltiSnipsEdit.
+	- UltiSnipsEdit now only edits private snippet files. Use UltiSnipsEdit! if
+	  you want to edit shipped files.
+	- New option 's' which strips trailing whitespace before jumping to next
+	  tabstop 
+	- New option 'a' which converts non-ascii characters into ascii characters
+	  in transformations. 
+	- New keyword in snippet files: priority defines which snippets should
+	  overwrite others. This deprecates the '!' option.
+	  *UltiSnips-adding-snippets*
+	- Remove common whitespace of visual line selections before inserting in an
+	  indented tabstop.
+	- Support for overwriting the snippet directory name on a per buffer basis
+	  to support per project snippets. *UltiSnips-snippet-search-path* 
+	- The keymaps for jumping in snippets are now only mapped when a snippet is
+	  active, allowing them to be used for something else otherwise.
+	- Expanding and jumping no longer overwrites the unnamed register.
+	- Integration with Valloric/YouCompleteMe and Shougo/neocomplete.vim.
+	- Other plugins can add sources for snippets to create snippets on the fly.
+	  *UltiSnips-extending*
+	- Vim functions now indicates if it did any work.
+	  *UltiSnips-trigger-functions*
+	- For python extensions: UltiSnips adds itself to the sys.path and can be
+	  easily imported if it is available. *UltiSnips-python-module-path*
+	- A new function giving programmatic access to the snippets currently
+	  available for expansion for other plugins integrating with UltiSnips.
+	  *UltiSnips_SnippetsInCurrentScope*
+	- New or improved snippets (now in a different repo): all, bib, c, cpp, cs,
+	  d, django, eruby, go, haskell, html, html, htmljinja, java, javascript,
+	  js, ledger, ocaml, perl, php, puppet, python, ruby, scss, sh, tex, vim,
+	  xml, zsh.
+
+version 2.2 (01-Sep-2012):
 	- Support to silence Python-not-found warnings. *UltiSnips-python-warning*
 	- Matchit support for snippet files.
 	- Improvements to syntax file.
@@ -9,12 +46,12 @@ version 2.2:
 	  json, html, coffee, coffee_jasmine, javascript_jasmine, ruby, php,
 	  markdown.
 
-version 2.1:
+version 2.1 (14-Feb-2012):
 	- Python interpolation access to text from visual selection via snip.v.
 	- Support for transformations of ${VISUAL} texts.
 	- New or improved snippets: python, tex, texmath, ruby, rails, html, django
 
-version 2.0:
+version 2.0 (05-Feb-2012):
 	- Backwards incompatible change: Support for normal mode editing. Snippets
 	  are no longer exited when leaving insert mode but only by leaving the
 	  text span of the snippets. This allows usage of normal mode commands and
@@ -28,20 +65,20 @@ version 2.0:
 	- Full support for :py3. UltiSnips now works with python >= 2.6 or >= 3.2.
 	- New or improved snippets: python, all
 
-version 1.6:
+version 1.6 (30-Dec-2011):
 	- Significant speed improvements and a few bugs fixed.
 	- Better handling of non ASCII chars in snippets by assuming UTF-8 encoding
 	  when no other information is available.
 	- Contributions for UltiSnips are now also accepted on GitHub: https://github.com/SirVer/ultisnips/
 	- New or improved snippets: ruby, rails, xhtml
 
-version 1.5:
+version 1.5 (24-Sep-2011):
 	- Some critical bug fixes for new vim versions.
 	- New or improved snippets: tex, texmath, python, jinja2, go, puppet, xhtml
 	- Configuration of search path for snippets *UltiSnips-snippet-search-path* 
 	- New parser implementation: A little faster, more flexible and less bugged.
 
-version 1.4:
+version 1.4 (17-Jul-2011):
 	- New or improved snippets: php, html, djangohtml, mako, lua 
 	- Snippets are now listed alphabetically by their trigger, no longer in
 	  order of appearance
@@ -55,7 +92,7 @@ version 1.4:
 	- snippets definition files now have the filetype 'snippets'. It used to be
 	  'snippet'.
 
-version 1.3:
+version 1.3 (14-Feb-2011):
 	- Erlang snippets (g0rdin)
 	- Other VimScripts can now define and immediately expand anonymous snippets
 	  ( *UltiSnips_Anon* ) (Ryan Wooden)
@@ -68,7 +105,7 @@ version 1.3:
 	  missing. (Rupa Deadwyler)
 	- Added UltiSnipsReset and UltiSnipsEdit (Idea by JCEB)
 
-version 1.2:
+version 1.2 (24-Aug-2010):
 	- many bugs were fixed
 	- smode mappings for printable characters are now removed before expanding a
 	  snippet. This is configurable. *UltiSnips-warning-smappings*
@@ -87,7 +124,7 @@ version 1.2:
 	  in c, but a c trigger is valuable for cpp. 
 	- UltiSnips now adheres to expandtab and tabstop options of vim
 
-version 1.1:
+version 1.1 (21-Jul-2009):
 	- Made triggers configurable. You can also use the same trigger for
 	  expanding and tabbing. The TextMate configuration <tab> and <s-tab> is now
 	  possible.

README

@@ -1,61 +1,5 @@
 This is a mirror of http://www.vim.org/scripts/script.php?script_id=2715
 
-UltiSnips is the Ultimate solution for snippets under Vim. Snippets are intelligent texts that spare you a lot of typing. Like many snippets solutions, this one ins heavily inspired by TextMates Snippet Syntax and offers all features that TextMate offers plus some more. But in Vim.
+UltiSnips is the Ultimate solution for snippets under Vim.
 
-Screencasts:
-Intro: http://www.sirver.net/blog/2011/12/30/first-episode-of-ultisnips-screencast/
-Basic Snippets: http://www.sirver.net/blog/2012/01/08/second-episode-of-ultisnips-screencast/
-Version 2.0s new features: http://www.sirver.net/blog/2012/02/05/third-episode-of-ultisnips-screencast/
-Python Interpolation: http://www.sirver.net/blog/2012/03/31/fourth-episode-of-ultisnips-screencast/
-
-UltiSnips has the following features (incomplete list):
-
-- TextMates snippet syntax
-- Tabstops, Placeholders (also nested)
-- Mirrors and Transformations (also inside Placeholders)
-- ShellCode, VimCode and a very powerful PythonCode interpolation
-- Live update as you type
-- snippets for file types and snippets that are always defined
-- same name, multiple snippets
-- recursive snippets: snippet in snippet
-- forward and backward jumping to placeholders and tab stops
-- convert script to download and convert TM bundles, convert script to reuse snipmates snippets.
-- automatically reload snippet definition files when they changed.
-- extend existing snippet definitions. For example cpp extends c, so that all c snippets are also available in cpp.
-- options for snippets: expand only at the beginning of line, inword, convert tabs-to-spaces....
-- multi word or regular expression triggers are supported and awesome!
-- edit snippets with normal mode commands and move around in them freely while editing
-- support for anonymous triggers that other scripts can define on the fly e.g. for automatic completion of parameters of your own functions.
-- > 400 unit tests to guarantee that stuff works.
-- Tested on Linux, Mac OS X and Windows.
-
-There have been many attempts to do things right; I think, this one nails it.
-
-UltiSnips is a community project, more than 15 people have contributed to it so far. Join in by providing feedback, snippets or code!
-
-Try it:
-Example 1:
-- open /tmp/file.c
-type for<tab>endcounter<c-j>mycounter<c-j><c-j>int a = 3;
-yields:
-------------------- SNIP -------------------
-for(size_t mycounter = 0; mycounter < endcounter; ++mycounter)
-{
-	int a = 3;
-}
-------------------- SNAP -------------------
-
-Example 2:
-- open /tmp/blah.help
-- :set ft=help
-- type sec<tab>MY COOL SECTION<c-h>blah
-yields:
-------------------- SNIP -------------------
-=============================================================================
-MY COOL SECTION                                        *blah-my-cool-section*
-
-blah
-------------------- SNAP -------------------
-
-
-If you like the script, please contact me and vote for the script!
+https://github.com/sirver/ultisnips

README.md

@@ -0,0 +1,60 @@
+UltiSnips
+=========
+
+UltiSnips is the ultimate solution for snippets in Vim. It has tons of features
+and is very fast.
+
+![GIF Demo](https://raw.github.com/SirVer/ultisnips/master/doc/demo.gif)
+
+In this demo I am editing a python file. I first expand the `#!` snippet, then
+the `class` snippet. The completion menu comes from
+[YouCompleteMe](https://github.com/Valloric/YouCompleteMe), UltiSnips also
+integrates with [neocomplete](https://github.com/Shougo/neocomplete.vim). I can
+jump through placeholders and add text while the snippet inserts text in other
+places automatically: when I add `Animal` as a base class, `__init__` gets
+updated to call the base class constructor. When I add arguments to the
+constructor, they automatically get assigned to instance variables. I then
+insert my personal snippet for `print` debugging. Note that I left insert mode,
+inserted another snippet and went back to add an additional argument to
+`__init__` and the class snippet was still active and added another instance
+variable.
+
+The official home of UltiSnips is at <https://github.com/sirver/ultisnips>.
+Please add pull requests and issues there.
+
+Quick Start
+-----------
+
+This assumes you are using [Vundle](https://github.com/gmarik/Vundle.vim). Adapt
+for your plugin manager of choice. Put this into your `.vimrc`.
+
+    " Track the engine.
+    Bundle 'SirVer/ultisnips'
+
+    " Snippets are separated from the engine. Add this if you want them:
+    Bundle 'honza/vim-snippets'
+
+    " Trigger configuration. Do not use <tab> if you use https://github.com/Valloric/YouCompleteMe.
+    let g:UltiSnipsExpandTrigger="<tab>"
+    let g:UltiSnipsJumpForwardTrigger="<c-b>"
+    let g:UltiSnipsJumpBackwardTrigger="<c-z>"
+
+    " If you want :UltiSnipsEdit to split your window.
+    let g:UltiSnipsEditSplit="vertical"
+
+UltiSnips comes with comprehensive
+[documentation](https://github.com/SirVer/ultisnips/blob/master/doc/UltiSnips.txt).
+As there are more options and tons of features I suggest you at least skim it.
+
+Screencasts
+-----------
+
+From a gentle introduction to really advanced in a few minutes. The blog posts
+of the screencasts contain more advanced examples of the things
+discussed in the videos.
+
+- [Episode 1: What are snippets and do I need them?](http://www.sirver.net/blog/2011/12/30/first-episode-of-ultisnips-screencast/)
+- [Episode 2: Creating Basic Snippets](http://www.sirver.net/blog/2012/01/08/second-episode-of-ultisnips-screencast/)
+- [Episode 3: What's new in version 2.0](http://www.sirver.net/blog/2012/02/05/third-episode-of-ultisnips-screencast/)
+- [Episode 4: Python Interpolation](http://www.sirver.net/blog/2012/03/31/fourth-episode-of-ultisnips-screencast/)
+