The documentation has been split into separate parts:
1. [[file:snippet-organization.org][Organizing Snippets]]
- #+BEGIN_QUOTE
Describes ways to organize your snippets in the hard disk.
- #+END_QUOTE
2. [[file:snippet-expansion.org][Expanding Snippets]]
- #+BEGIN_QUOTE
Describes how YASnippet chooses snippets for expansion at point.
Maybe, you'll want some snippets to be expanded in a particular mode,
or only under certain conditions, or be prompted using =ido=, etc...
- #+END_QUOTE
3. [[file:snippet-development.org][Writing Snippets]]
- #+BEGIN_QUOTE
Describes the YASnippet definition syntax, which is very close (but
not equivalent) to Textmate's. Includes a section about converting
TextMate snippets.
- #+END_QUOTE
4. [[file:snippet-menu.org][The YASnippet menu]]
- #+BEGIN_QUOTE
Explains how to use the YASnippet menu to explore, learn and modify
snippets.
- #+END_QUOTE
5. [[file:snippet-reference.org][YASnippet Symbol Reference]]
- #+BEGIN_QUOTE
An automatically generated listing of all YASnippet commands,
(customization) variables, and functions.
- #+END_QUOTE
** Bugs, discussion, contributions, etc
- =M-x yas-load-snippet-buffer=
- #+BEGIN_QUOTE
When editing a snippet, this loads the snippet into the correct
mode and menu. Bound to =C-c C-c= by default while in
=snippet-mode=.
- #+END_QUOTE
- =M-x yas-tryout-snippet=
- #+BEGIN_QUOTE
When editing a snippet, this opens a new empty buffer, sets it to
the appropriate major mode and inserts the snippet there, so you
can see what it looks like. This is bound to =C-c C-t= while in
=snippet-mode=.
- #+END_QUOTE
There are also /snippets for writing snippets/: =vars=, =$f= and =$m=
:-).
There are a couple of tools that take TextMate's ".tmSnippet" xml files
and create YASnippet definitions:
-#+BEGIN_QUOTE
- [[http://code.nokrev.com/?p=snippet-copier.git;a=blob_plain;f=snippet_copier.py][a python script by Jeff Wheeler]]
- a [[http://yasnippet.googlecode.com/svn/trunk/extras/textmate_import.rb][ruby tool]] , =textmate_import.rb= adapted from [[http://www.neutronflux.net/2009/07/28/shoulda-snippets-for-emacs/][Rob Christie's]],
which I have uploaded to the repository.
-#+END_QUOTE
In this section, i'll shortly cover the *second* option.