ld/yasnippet
1
0
Fork 0
mirror of https://github.com/joaotavora/yasnippet.git synced 2025-10-14 05:23:04 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge branch '0.8-fsf-changes'

Browse Source
This commit is contained in:
João Távora 2012-08-15 15:03:45 +01:00
commit 145448b815
26 changed files with 4281 additions and 5438 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
README.mdown
View File

@ -1,13 +1,13 @@
# Intro # Intro
**yasnippet** is a template system for Emacs. It allows you to type an **YASnippet** is a template system for Emacs. It allows you to type an
abbreviation and automatically expand it into function abbreviation and automatically expand it into function
templates. Bundled language templates includes: C, C++, C#, Perl, templates. Bundled language templates includes: C, C++, C#, Perl,
Python, Ruby, Python, Ruby,
SQL, LaTeX, HTML, CSS and more. The snippet syntax is inspired from SQL, LaTeX, HTML, CSS and more. The snippet syntax is inspired from
[TextMate's][textmate-snippets] syntax, you can even [TextMate's][textmate-snippets] syntax, you can even
[import][import-docs] most TextMate templates to yasnippet. Watch [import][import-docs] most TextMate templates to YASnippet. Watch
[a demo on YouTube][youtube-demo] or download a [a demo on YouTube][youtube-demo] or download a
[higher resolution version][high-res-demo] [higher resolution version][high-res-demo]
@ -30,15 +30,14 @@ Add the following in your `.emacs` file:
(add-to-list 'load-path (add-to-list 'load-path
"~/.emacs.d/plugins/yasnippet") "~/.emacs.d/plugins/yasnippet")
(require 'yasnippet) (require 'yasnippet)
(yas/global-mode 1) (yas-global-mode 1)
Add your own snippets to `~/.emacs.d/snippets` by placing files there or invoking `yas/new-snippet`.
Add your own snippets to `~/.emacs.d/snippets` by placing files there or invoking `yas-new-snippet`.
## Install with `package-install` ## Install with `package-install`
In a recent emacs `M-x list-packages` is the recommended way to list and install packages. In a recent emacs `M-x list-packages` is the recommended way to list and install packages.
[MELPA][melpa] keeps a very recent snapshot of yasnippet, see http://melpa.milkbox.net/#installing. [MELPA][melpa] keeps a very recent snapshot of YASnippet, see http://melpa.milkbox.net/#installing.
## Install with el-get ## Install with el-get
@ -56,37 +55,37 @@ Consider using this "local" recipe.
:compile "yasnippet.el") :compile "yasnippet.el")
el-get-sources) el-get-sources)
## Use `yas/minor-mode` on a per-buffer basis ## Use `yas-minor-mode` on a per-buffer basis
To use yasnippet as a non-global minor mode, replace `(yas/global-mode 1)` with To use YASnippet as a non-global minor mode, replace `(yas-global-mode 1)` with
`(yas/reload-all)` to load the snippet tables. Then add a call to `(yas-reload-all)` to load the snippet tables. Then add a call to
`(yas/minor-mode)` to the major-modes where you to enable yasnippet. `(yas-minor-mode)` to the major-modes where you to enable YASnippet.
(add-hook 'prog-mode-hook (add-hook 'prog-mode-hook
'(lambda () '(lambda ()
(yas/minor-mode))) (yas-minor-mode)))
# (NOT) Contributing snippets # (NOT) Contributing snippets
Please **do not** open pull requests or ask me to add snippets to Please **do not** open pull requests or ask me to add snippets to
yasnippet. YASnippet.
The bundled collection under `/snippets` is considered frozen: **I The bundled collection under `/snippets` is considered frozen: **I
will not add more snippets to it**. will not add more snippets to it**.
You can point `yas/snippet-dirs` to good snippet collections out You can point `yas-snippet-dirs` to good snippet collections out
there. If you have created snippets for a mode, or multiple modes, there. If you have created snippets for a mode, or multiple modes,
consider creating a repository to host them, then tell users that it consider creating a repository to host them, then tell users that it
should be added like this to `yas/snippet-dirs`: should be added like this to `yas-snippet-dirs`:
(setq yas/snippet-dirs (setq yas-snippet-dirs
'("~/.emacs.d/snippets" ;; personal snippets '("~/.emacs.d/snippets" ;; personal snippets
"/path/to/some/collection/" ;; just some foo-mode snippets "/path/to/some/collection/" ;; just some foo-mode snippets
"/path/to/some/othercollection/" ;; some more foo-mode and a complete baz-mode "/path/to/some/othercollection/" ;; some more foo-mode and a complete baz-mode
"/path/to/yasnippet/snippets" ;; the default collection "/path/to/yasnippet/snippets" ;; the default collection
)) ))
(yas/global-mode 1) ;; or M-x yas/reload-all if you've started yasnippet already. (yas-global-mode 1) ;; or M-x yas-reload-all if you've started YASnippet already.
# Importing TextMate snippets # Importing TextMate snippets
@ -119,8 +118,8 @@ Then, in your `.emacs` file
(add-to-list 'load-path (add-to-list 'load-path
"~/.emacs.d/plugins/yasnippet") "~/.emacs.d/plugins/yasnippet")
(require 'yasnippet) (require 'yasnippet)
(setq yas/snippet-dirs '("~/.emacs.d/snippets" "~/.emacs.d/plugins/yasnippet/extras/imported")) (setq yas-snippet-dirs '("~/.emacs.d/snippets" "~/.emacs.d/plugins/yasnippet/extras/imported"))
(yas/global-mode 1) (yas-global-mode 1)
Open some rails file (model, app, etc) and start using the textmate Open some rails file (model, app, etc) and start using the textmate
snippets. Note that in the example above we have abandoned the snippets. Note that in the example above we have abandoned the
@ -134,8 +133,8 @@ and support. If you find a bug, please report it on
[the GitHub issue tracker][issues]. (please **do not** submit new issues to the old [the GitHub issue tracker][issues]. (please **do not** submit new issues to the old
[googlecode tracker][googlecode tracker]) [googlecode tracker][googlecode tracker])
If you run into problems using yasnippet, or have snippets to contribute, post If you run into problems using YASnippet, or have snippets to contribute, post
to the [yasnippet google group][forum]. Thank you very much for using yasnippet! to the [YASnippet google group][forum]. Thank you very much for using YASnippet!
[docs]: http://capitaomorte.github.com/yasnippet/ [docs]: http://capitaomorte.github.com/yasnippet/
[issues]: https://github.com/capitaomorte/yasnippet/issues [issues]: https://github.com/capitaomorte/yasnippet/issues

102
README.org Normal file
View File

@ -0,0 +1,102 @@
# -*- mode: org; fill-column: 80 -*-
#+TITLE: Yet another snippet extension
#+OPTIONS: toc:1
#+STARTUP: showall
#+STYLE: <link rel="stylesheet" type="text/css" href="assets/stylesheet.css" />
# External links
#
#+LINK: smart-snippet http://code.google.com/p/smart-snippet
#+LINK: pluskid http://pluskid.lifegoo.org
#+LINK: screencast http://www.youtube.com/watch?v=ZCGmZK4V7Sg
#+LINK: docs http://capitaomorte.github.com/yasnippet
#+LINK: issues https://github.com/capitaomorte/yasnippet/issues
#+LINK: googlecode-tracker http://code.google.com/p/yasnippet/issues/list
#+LINK: forum http://groups.google.com/group/smart-snippet
*YASnippet* is a template system for Emacs. It allows you to type an
abbreviation and automatically expand it into function templates. Bundled
language templates includes: C, C++, C#, Perl, Python, Ruby, SQL, LaTeX, HTML,
CSS and more. The snippet syntax is inspired from TextMate's syntax, you can
even [[#import-textmate][import most TextMate snippets]]
YASnippet is an original creation of [[pluskid]] who also wrote its predecessor
[[smart-snippet]].
* Watch a demo [[screencast]]
* Install the most recent version with git
Clone this repository somewhere
#+BEGIN_EXAMPLE
$ cd ~/.emacs.d/plugins
$ git clone https://github.com/capitaomorte/yasnippet
#+END_EXAMPLE
Add the following in your =.emacs= file:
#+BEGIN_EXAMPLE
(add-to-list 'load-path
"~/.emacs.d/plugins/yasnippet")
(require 'yasnippet)
(yas/global-mode 1)
#+END_EXAMPLE
Add your own snippets to `~/.emacs.d/snippets` by placing files there or invoking `yas/new-snippet`.
* Install yasnippet with el-get
[[https://github.com/dimitri/el-get.gti][El-get]] is a nice way to get the most recent version.
* Import textmate snippets (rails example)
:PROPERTIES:
:CUSTOM_ID: import-textmate
:END:
Clone the yasnippet repository to `~/.emacs.d/plugins/yasnippet`
#+BEGIN_EXAMPLE
cd ~/.emacs.d/plugins/yasnippet
git submodule init
git submodule update
gem install plist trollop
rake convert_bundles # will convert ruby, rails and html bundles from drnic
#+END_EXAMPLE
Then, in your .emacs file
#+BEGIN_EXAMPLE
(add-to-list 'load-path
"~/.emacs.d/plugins/yasnippet")
(require 'yasnippet)
(setq yas/snippet-dirs '("~/.emacs.d/snippets" "~/.emacs.d/extras/imported"))
(yas/global-mode 1)
#+END_EXAMPLE
Open some rails file (model, app, etc) and start using the textmate snippets.
* Contributing snippets
Please do not ask me to add snippets to the default collection under
=/snippets=. This is considered frozen and by customizing =yas/snippet-dirs= you
can point yasnippet to good snippet collections out there.
The =extras/textmate-import.rb= tool can import many actual Textmate
snippets. See [[import-textmate]].
I'm focusing on developping =textmate-import.rb= tool and the =yas-setup.el=
files that guide it with more difficult importation. In the future =/snippets=
snippets will be deprecated and replaced with =extras/imported=.
* Documentation, issues, etc
Please refer to the comprehensive [[docs][documentation]] for full customization and
support. If you think you've found a bug, please report it on [[issues][the GitHub issue
tracker]]. (please **do not** submit new issues to the old [[googlecode-tracker][googlecode tracker]])
If you run into problems using YASnippet, or have snippets to contribute, post
to the [[forum][yasnippet forum]]. Thank you very much for using YASnippet!

326
doc/changelog.rst
View File

@ -1,326 +0,0 @@
=========
ChangeLog
=========
.. _Organizing Snippets: snippet-organization.html
.. _Expanding Snippets: snippet-expansion.html
.. _Writing Snippets: snippet-development.html
.. _The YASnippet Menu: snippet-menu.html
0.7.0b / ????-??-??
===================
* Filenames can no longer be snippet triggers. Please upgrade your snippet
collections.
0.6.1c / 2009-08-13
===================
* Fixed `issues <http://code.google.com/p/yasnippet/issues>`_ 99, 98, 93,
90, 91, 88, 87. Thanks everybody.
* More compliant customization group `Issue94
<http://code.google.com/p/yasnippet/issues/detail?id=94>`_, (thanks
wyuenho).
* Added workaround for issue 97 in the FAQ
* Small updates to documentation.
0.6.1b / 2009-08-29
===================
* Much more powerful menu. See `The YASnippet menu`_.
* New ways to organize snippets. See `Organizing snippets`_.
* Added ``yas/also-auto-indent-first-line`` customization variable.
* Renamed directive ``# env:`` to ``# expand-env:``
* Rewrote much of the documentation.
* Added TextMate import tool ``textmate-import.rb`` to to svn
repository (see "extras/")
* Added *experimental* bundle of textmate snippets
``yasnippet-textmate-bundle.el``
* Fixed `Issue 74
<http://code.google.com/p/yasnippet/issues/detail?id=74>`_ (thanks
rmartin.k...@gmail.com)
* Fixed `Issues 80 through 84
<http://code.google.com/p/yasnippet/issues/detail?id=80>`_ (thanks
Moritz Bunkus)
* Fixed many more issues...
0.6.0c / 2009-07-27
===================
* Now byte compiles correctly with no warnings.
* Fixed `Issue 68
<http://code.google.com/p/yasnippet/issues/detail?id=68>`_ with
mouse-clicking alternatives in ``ido-mode``.
* Added ``yas/also-auto-indent-first-line`` customization variable.
0.6.0b / 2009-07-25
===================
* Nested placeholders of the type ``<div${1: id="${2:someid}"}> $0``.
* More robust undo/redo support.
* Stacked snippet expansion (*snippet in snippet*).
* Transformation on a primary field with syntax ``${1:default$(transform)}``
* Validations on field exit through the ``yas/verify-value``
primary field transformation.
* Wrapping the region in the exit marker ``$0`` of the snippet. Use
``yas/wrap-around-region``.
* Auto-indentation. Use ``yas/indent-line`` set to ``'auto``
* Easier definition of snippets. Use ``yas/find-snippets`` or
``yas/visit-snippet-file``. In the new ``snippet-mode`` use
``yas/load-snippet-buffer`` and ``yas/tryout-snippet``.
* Customization group ``yasnippet``.
* Overriding customization variables in snippets. Use the ``env:
let-form`` template keyword.
* Fixed `Issue 60
<http://code.google.com/p/yasnippet/issues/detail?id=60>`_
* Fixed `Issue 65
<http://code.google.com/p/yasnippet/issues/detail?id=65>`_
* Fixed `Issue 56
<http://code.google.com/p/yasnippet/issues/detail?id=56>`_
0.5.10 / 2009-02-11
===================
* Added *grouping* support so that the snippets in the menu can be
groupped together.
* Make the bundle `ELPA <http://tromey.com/elpa/index.html>`_
compatible.
0.5.9 / 2009-01-21
==================
* Fixed the bug of disabling the auto-indenting of ``cc-mode``.
0.5.8 / 2009-01-15
==================
* Added a ``key`` property in snippet definition for snippet names
that are not valid path name.
* Fixed some bugs of indenting (`Issue 44
<http://code.google.com/p/yasnippet/issues/detail?id=44>`_, `Issue
46 <http://code.google.com/p/yasnippet/issues/detail?id=46>`_).
* Fixed `Issue 45
<http://code.google.com/p/yasnippet/issues/detail?id=45>`_ by
providing a proper default value for ``yas/buffer-local-condition``.
* Added helper function ``yas/substr`` for convenient mirror
transformation.
* Make variable ``yas/registered-snippet`` properly initialized.
* Fixed the overlay error when overlay becomes empty (`Issue 49
<http://code.google.com/p/yasnippet/issues/detail?id=49>`_ and
`Issue 48
<http://code.google.com/p/yasnippet/issues/detail?id=48>`_). This
bug has occurred and been fixed earlier, and should not have
happened if we have proper regression test.
* Added a workaround for ``c-electric-`` serial commands (`Issue 27
<http://code.google.com/p/yasnippet/issues/detail?id=27>`_).
0.5.7 / 2008-12-03
==================
* Fixed `Issue 28
<http://code.google.com/p/yasnippet/issues/detail?id=28>`_ of
properly clean up snippet (by joaotavora).
* Added a new section "Field-level undo functionality" to correct
`Issue 33 <http://code.google.com/p/yasnippet/issues/detail?id=33>`_
(by joaotavora).
* Added some snippets from users for sql, erlang, scala, html, xml, latex, etc.
* Fixed `Issue 16
<http://code.google.com/p/yasnippet/issues/detail?id=16>`_ by adding
``$>`` support. Here's the `doc for $> indenting
<http://pluskid.lifegoo.com/upload/project/yasnippet/doc/define_snippet.html#indenting>`_.
0.5.6 / 2008-08-07
==================
* Added a buffer local variable ``yas/dont-activate`` to turn off
``yas/minor-mode`` in some major modes. See `Issue 29
<http://code.google.com/p/yasnippet/issues/detail?id=29>`_.
* Make the environment of elisp evaluation more friendly to
``(current-column)``.
* Fixed the regular expression bug in python-mode snippets.
* Use filename or full key extension for snippet name if no ``name``
property is defined.
0.5.5 / 2008-05-29
==================
* Tweak ``yas/extra-mode-hooks`` so that it can be more easily
customized.
* Add an entry in FAQ about why ``TAB`` key doesn't work in some
modes.
0.5.4 / 2008-05-15
==================
* Added ``ox-mode-hook`` and ``python-mode-hook`` to
``yas/extra-mode-hooks`` to fix the problem YASnippet is not enabled
in those modes.
0.5.3 / 2008-05-07
==================
* Fix indent of python-mode snippets.
* Fix a bug of dropdown-list: conflicts with color-theme (`Issue 23
<http://code.google.com/p/yasnippet/issues/detail?id=23>`_). Thanks
Mike.
* Fix a bug of condition system.
0.5.2 / 2008-04-20
==================
* Fix a bug for comparing string to symbol using ``string=`` (which
will fire an error).
0.5.1 / 2008-04-14
==================
* Use a beautiful css style in the document.
0.5.0 / 2008-04-10
==================
* Integrate with hippie-expand. Just add ``yas/hippie-try-expand`` to
``hippie-expand-try-functions-list``.
* If you set ``yas/fall-back-behavior`` to ``'return-nil``, YASnippet
will return nil when it can't find a snippet to expand.
* Defect fix: the condition of a snippet was evaluated twice in
earlier version.
* Deleting snippet (using ``C-w`` or ``C-k``) won't cause serious
problem now.
* Several complex snippet for python-mode from Yasser included in the
distribution.
0.4.5 / 2008-04-07
==================
* Merge the latest dropdown-list.el.
* Add snippets for f90-mode from Li Zhu.
* Bug fix: l-safe-expr-p: Lisp nesting exceeds ``max-lisp-eval-depth``
error when several (more than two) snippets overlaps. Thanks
sunwaybupt@newsmth for reporting this bug.
0.4.4 / 2008-03-24
==================
* Bug fix: dropdown-list.el doesn't recognize [return] properly.
0.4.3 / 2008-03-23
==================
* Bug fix: failed to recognize user customized yas/trigger-key.
0.4.2 / 2008-03-22
==================
* Make a separate document package for release. Also make document
available online.
0.4.1 / 2008-03-21
==================
* Make sure ``yas/minor-mode``'s key bindings always take priority to
other minor modes.
0.4.0 / 2008-03-20
==================
* Document refinement and released with YASnippet. Most of the Online
wiki document will be deprecated soon.
* Powerful condition system added to yasnippet!
* Incorporate ``dropdown-list.el`` and make it default way for
selecting multiple candidates. Thanks to `Jaeyoun Chung
<http://groups.google.com/group/smart-snippet/browse_thread/thread/c869158b76addeb3/e7c6372ba457189e>`_.
* yas/before-expand-snippet-hook
0.3.2 / 2008-03-19
==================
* Enhancement: A better way to define minor-mode. Thanks to Kentaro
Kuribayashi. See `this thread
<https://groups.google.com/group/smart-snippet/browse_thread/thread/65cb3b5583eda887?hl=en>`_
for more details.
0.3.1 / 2008-03-17
==================
* Bug fix: Emacs get confused when a field is deleted. See `issue 10
<http://code.google.com/p/yasnippet/issues/detail?id=10>`_.
0.3.0 / 2008-03-16
==================
* Add a ``yas/after-exit-snippet-hook`` so that you can do something like
``indent-region`` or ``fill-region`` after finish the snippet.
* Use minor-mode instead of ``global-set-key`` to bind the trigger
key. Now the trigger key and fall-back behavior can be more
flexible. Not constrained to ``<tab>``. Thanks to Trey Jackson. See
this `thread
<https://groups.google.com/group/smart-snippet/browse_thread/thread/937f32a2a6dea4f2?hl=en>`_
for more details.
* Now user can customize the popup function for selecting multiple
candidate for the same snippet key.
* Support ``dropdown-list.el`` to be a better way to select multiple
candidate when in text mode.
0.2.3 / 2008-03-15
==================
* Bug in non-window (-nw) mode when there's multiple candidate to
expand. See `issue 7
<http://code.google.com/p/yasnippet/issues/detail?id=7>`_.
* Allow expanding another snippet as long as not currently inside a
field.
0.2.2 / 2008-03-13
==================
* Added customized face for fields and mirrors. Better in dark
background. And users can customize it.
0.2.1 / 2008-03-10
==================
* Fix the insert-behind problem under both Emacs 22 and Emacs 23.
0.2.0 / 2008-03-10
==================
* Use big keymap overlay to detect ``insert-behind`` event manually to
avoid sometimes missed hook calls. See `issue 3
<http://code.google.com/p/yasnippet/issues/detail?id=3>`_ for more
details.
* Support parent snippet table. Now you can set (for example)
``cc-mode`` as common mode for ``c++-mode``, ``c-mode`` and
``java-mode``. They'll share snippets defined for ``cc-mode``.
0.1.1 / 2008-03-08
==================
* Add a rake task to upload to google code.
* Use elisp compile-bundle function instead of python scrip
0.1.0 / 2008-03-07
==================
* Embedded elisp support.
* Fields navigation support.
* Mirror of fields support.
* Menu-bar support.
* Multiple snippets with same name support.
* Popup menu for multiple snippet with same name support.
* Transformation of fields support.
* Load directory support.
* Compile bundle support.

110
doc/compile-doc.py
View File

@ -1,110 +0,0 @@
#!/usr/bin/python
# Compile document to HTML use docutils.
# ========================================
# Pygments syntax highlighting
# ========================================
from pygments.formatters import HtmlFormatter
# Set to True if you want inline CSS styles instead of classes
INLINESTYLES = True
from pygments.formatters import HtmlFormatter
# The default formatter
DEFAULT = HtmlFormatter(noclasses=INLINESTYLES)
# Add name -> formatter pairs for every variant you want to use
VARIANTS = {
# 'linenos': HtmlFormatter(noclasses=INLINESTYLES, linenos=True),
}
from docutils import nodes
from docutils.parsers.rst import directives
from pygments import highlight
from pygments.lexers import get_lexer_by_name, TextLexer
def pygments_directive(name, arguments, options, content, lineno,
content_offset, block_text, state, state_machine):
try:
lexer = get_lexer_by_name(arguments[0])
except ValueError:
# no lexer found - use the text one instead of an exception
lexer = TextLexer()
# take an arbitrary option if more than one is given
formatter = options and VARIANTS[options.keys()[0]] or DEFAULT
parsed = highlight(u'\n'.join(content), lexer, formatter)
return [nodes.raw('', parsed, format='html')]
pygments_directive.arguments = (1, 0, 1)
pygments_directive.content = 1
pygments_directive.options = dict([(key, directives.flag) for key in VARIANTS])
directives.register_directive('sourcecode', pygments_directive)
# =================
# Youtube embedding
# =================
from docutils import nodes
from docutils.parsers.rst import directives
CODE = """\
<object type="application/x-shockwave-flash"
width="%(width)s"
height="%(height)s"
align="%(align)s"
class="youtube-embed"
data="http://www.youtube.com/v/%(yid)s">
<param name="movie" value="http://www.youtube.com/v/%(yid)s"></param>
<param name="wmode" value="transparent"></param>%(extra)s
</object>
"""
PARAM = """\n <param name="%s" value="%s"></param>"""
def youtube(name, args, options, content, lineno,
contentOffset, blockText, state, stateMachine):
""" Restructured text extension for inserting youtube embedded videos """
if len(content) == 0:
return
string_vars = {
'yid': content[0],
'width': 425,
'height': 344,
'align': "right",
'extra': ''
}
extra_args = content[1:] # Because content[0] is ID
extra_args = [ea.strip().split("=") for ea in extra_args] # key=value
extra_args = [ea for ea in extra_args if len(ea) == 2] # drop bad lines
extra_args = dict(extra_args)
if 'width' in extra_args:
string_vars['width'] = extra_args.pop('width')
if 'align' in extra_args:
string_vars['align'] = extra_args.pop('align')
if 'height' in extra_args:
string_vars['height'] = extra_args.pop('height')
if extra_args:
params = [PARAM % (key, extra_args[key]) for key in extra_args]
string_vars['extra'] = "".join(params)
return [nodes.raw('', CODE % (string_vars), format='html')]
youtube.content = True
directives.register_directive('youtube', youtube)
# ========================================
# Command line processing
# ========================================
from docutils.core import publish_cmdline, default_description
description = ('Generates (X)HTML documents from standalone reStructuredText '
'sources. ' + default_description)
overrides = {'stylesheet_path' : 'styles.css',
'embed_stylesheet' : False,
'template' : 'doc/template.txt'}
publish_cmdline(writer_name='html',
description=description,
settings_overrides=overrides)

9
doc/define_snippet.rst
View File

@ -1,9 +0,0 @@
=====
Moved
=====
.. meta::
:http-equiv=Refresh: 3; URL=index.html
This page has been moved. Click `here <index.html>`_ if your browser
does not automatically redirect you

150
doc/faq.rst
View File

@ -1,150 +0,0 @@
============================
Frequently Asked Questions
============================
Why is there an extra newline?
==============================
If you have a newline at the end of the snippet definition file, then
YASnippet will add a newline when you expanding a snippet. Please
don't add a newline at the end if you don't want it when you saving
the snippet file.
Note some editors will automatically add a newline for you. In Emacs,
if you set ``require-final-newline`` to ``t``, it will add the final
newline for you automatically.
Why doesn't TAB expand a snippet?
=================================
First check the mode line to see if there's ``yas``. If not, then try
``M-x yas/minor-mode`` to manually turn on the minor mode and try to
expand the snippet again. If it works, then, you can add the following
code to your ``.emacs`` *before* loading YASnippet:
.. sourcecode:: lisp
(add-hook 'the-major-mode-hook 'yas/minor-mode-on)
where ``the-major-mode`` is the major mode in which ``yas/minor-mode``
isn't enabled by default.
From YASnippet 0.6 you can also use the command ``M-x
yas/global-mode`` to turn on YASnippet automatically for *all* major
modes.
If ``yas/minor-mode`` is on but the snippet still not expanded. Then
try to see what command is bound to the ``TAB`` key: press ``C-h k``
and then press ``TAB``. Emacs will show you the result.
You'll see a buffer prompted by Emacs saying that ``TAB runs the
command ...``. Alternatively, you might see ``<tab> runs the command
...``, note the difference between ``TAB`` and ``<tab>`` where the
latter has priority. If you see ``<tab>`` bound to a command other
than ``yas/expand``, (e.g. in ``org-mode``) you can try the following
code to work around:
.. sourcecode:: lisp
(add-hook 'org-mode-hook
(let ((original-command (lookup-key org-mode-map [tab])))
`(lambda ()
(setq yas/fallback-behavior
'(apply ,original-command))
(local-set-key [tab] 'yas/expand))))
replace ``org-mode-hook`` and ``org-mode-map`` with the major mode
hook you are dealing with (Use ``C-h m`` to see what major mode you
are in).
As an alternative, you can also try
.. sourcecode:: lisp
(defun yas/advise-indent-function (function-symbol)
(eval `(defadvice ,function-symbol (around yas/try-expand-first activate)
,(format
"Try to expand a snippet before point, then call `%s' as usual"
function-symbol)
(let ((yas/fallback-behavior nil))
(unless (and (interactive-p)
(yas/expand))
ad-do-it)))))
(yas/advise-indent-function 'ruby-indent-line)
To *advise* the modes indentation function bound to TAB, (in this case
``ruby-indent-line``) to first try to run ``yas/expand``.
If the output of ``C-h k RET <tab>`` tells you that ``<tab>`` is
indeed bound to ``yas/expand`` but YASnippet still doesn't work, check
your configuration and you may also ask for help on the `discussion
group <http://groups.google.com/group/smart-snippet>`_. See this
particular `thread
<http://code.google.com/p/yasnippet/issues/detail?id=93&can=1>`_ for
quite some solutions and alternatives.
Don't forget to attach the information on what command is bound to TAB
as well as the mode information (Can be obtained by ``C-h m``).
Why doesn't TAB navigation work with flyspell
=============================================
A workaround is to inhibit flyspell overlays while the snippet is active:
.. sourcecode:: lisp
(add-hook 'flyspell-incorrect-hook
#'(lambda (dummy1 dummy2 dymmy3)
(and yas/active-field-overlay
(overlay-buffer yas/active-field-overlay))))
This is apparently related to overlay priorities. For some reason, the
``keymap`` property of flyspell's overlays always takes priority over
the same property in yasnippet's overlays, even if one sets the
latter's ``priority`` property to something big. If you know
emacs-lisp and can solve this problem, drop a line in the `discussion
group`_.
How do I turn off the minor mode where in some buffers
======================================================
The best way, since version 0.6.1c, is to set the default value of the
variable ``yas/dont-activate`` to a lambda function like so:
.. sourcecode:: lisp
(set-default 'yas/dont-activate
#'(lambda ()
(and yas/root-directory
(null (yas/get-snippet-tables)))))
This is also the default value starting for that version. It skips the
minor mode in buffers where it is not applicable (no snippet tables),
but only once you have setup your yas/root-directory.
How do I define an abbrev key containing characters not supported by the filesystem?
====================================================================================
**Note**: This question applies if you're still defining snippets
whose key *is* the filename. This is behavior stil provided by
version 0.6 for backward compatibilty, but is somewhat deprecated...
For example, you want to define a snippet by the key ``<`` which is
not a valid character for filename on Windows. This means you can't
use the filename as a trigger key in this case.
You should rather use the ``# key:`` directive to specify the key of
the defined snippet explicitly and name your snippet with an arbitrary
valid filename, ``lt.yasnippet`` for example, using ``<`` for the
``# key:`` directive:
.. sourcecode:: text
# key: <
# name: <...></...>
# --
<${1:div}>$0</$1>
.. _discussion group: http://groups.google.com/group/smart-snippet

279
doc/html4css1.css
View File

@ -1,279 +0,0 @@
/*
:Author: David Goodger
:Contact: goodger@users.sourceforge.net
:Date: $Date: 2005-12-18 01:56:14 +0100 (Sun, 18 Dec 2005) $
:Revision: $Revision: 4224 $
:Copyright: This stylesheet has been placed in the public domain.
Default cascading style sheet for the HTML output of Docutils.
See http://docutils.sf.net/docs/howto/html-stylesheets.html for how to
customize this style sheet.
*/
/* used to remove borders from tables and images */
.borderless, table.borderless td, table.borderless th {
border: 0 }
table.borderless td, table.borderless th {
/* Override padding for "table.docutils td" with "! important".
The right padding separates the table cells. */
padding: 0 0.5em 0 0 ! important }
.first {
/* Override more specific margin styles with "! important". */
margin-top: 0 ! important }
.last, .with-subtitle {
margin-bottom: 0 ! important }
.hidden {
display: none }
a.toc-backref {
text-decoration: none ;
color: black }
blockquote.epigraph {
margin: 2em 5em ; }
dl.docutils dd {
margin-bottom: 0.5em }
/* Uncomment (and remove this text!) to get bold-faced definition list terms
dl.docutils dt {
font-weight: bold }
*/
div.abstract {
margin: 2em 5em }
div.abstract p.topic-title {
font-weight: bold ;
text-align: center }
div.admonition, div.attention, div.caution, div.danger, div.error,
div.hint, div.important, div.note, div.tip, div.warning {
margin: 2em ;
border: medium outset ;
padding: 1em }
div.admonition p.admonition-title, div.hint p.admonition-title,
div.important p.admonition-title, div.note p.admonition-title,
div.tip p.admonition-title {
font-weight: bold ;
font-family: sans-serif }
div.attention p.admonition-title, div.caution p.admonition-title,
div.danger p.admonition-title, div.error p.admonition-title,
div.warning p.admonition-title {
color: red ;
font-weight: bold ;
font-family: sans-serif }
/* Uncomment (and remove this text!) to get reduced vertical space in
compound paragraphs.
div.compound .compound-first, div.compound .compound-middle {
margin-bottom: 0.5em }
div.compound .compound-last, div.compound .compound-middle {
margin-top: 0.5em }
*/
div.dedication {
margin: 2em 5em ;
text-align: center ;
font-style: italic }
div.dedication p.topic-title {
font-weight: bold ;
font-style: normal }
div.figure {
margin-left: 2em ;
margin-right: 2em }
div.footer, div.header {
clear: both;
font-size: smaller }
div.line-block {
display: block ;
margin-top: 1em ;
margin-bottom: 1em }
div.line-block div.line-block {
margin-top: 0 ;
margin-bottom: 0 ;
margin-left: 1.5em }
div.sidebar {
margin-left: 1em ;
border: medium outset ;
padding: 1em ;
background-color: #ffffee ;
width: 40% ;
float: right ;
clear: right }
div.sidebar p.rubric {
font-family: sans-serif ;
font-size: medium }
div.system-messages {
margin: 5em }
div.system-messages h1 {
color: red }
div.system-message {
border: medium outset ;
padding: 1em }
div.system-message p.system-message-title {
color: red ;
font-weight: bold }
div.topic {
margin: 2em }
h1.section-subtitle, h2.section-subtitle, h3.section-subtitle,
h4.section-subtitle, h5.section-subtitle, h6.section-subtitle {
margin-top: 0.4em }
h1.title {
text-align: center }
h2.subtitle {
text-align: center }
hr.docutils {
width: 75% }
img.align-left {
clear: left }
img.align-right {
clear: right }
ol.simple, ul.simple {
margin-bottom: 1em }
ol.arabic {
list-style: decimal }
ol.loweralpha {
list-style: lower-alpha }
ol.upperalpha {
list-style: upper-alpha }
ol.lowerroman {
list-style: lower-roman }
ol.upperroman {
list-style: upper-roman }
p.attribution {
text-align: right ;
margin-left: 50% }
p.caption {
font-style: italic }
p.credits {
font-style: italic ;
font-size: smaller }
p.label {
white-space: nowrap }
p.rubric {
font-weight: bold ;
font-size: larger ;
color: maroon ;
text-align: center }
p.sidebar-title {
font-family: sans-serif ;
font-weight: bold ;
font-size: larger }
p.sidebar-subtitle {
font-family: sans-serif ;
font-weight: bold }
p.topic-title {
font-weight: bold }
pre.address {
margin-bottom: 0 ;
margin-top: 0 ;
font-family: serif ;
font-size: 100% }
pre.literal-block, pre.doctest-block {
margin-left: 2em ;
margin-right: 2em ;
background-color: #eeeeee }
span.classifier {
font-family: sans-serif ;
font-style: oblique }
span.classifier-delimiter {
font-family: sans-serif ;
font-weight: bold }
span.interpreted {
font-family: sans-serif }
span.option {
white-space: nowrap }
span.pre {
white-space: pre }
span.problematic {
color: red }
span.section-subtitle {
/* font-size relative to parent (h1..h6 element) */
font-size: 80% }
table.citation {
border-left: solid 1px gray;
margin-left: 1px }
table.docinfo {
margin: 2em 4em }
table.docutils {
margin-top: 0.5em ;
margin-bottom: 0.5em }
table.footnote {
border-left: solid 1px black;
margin-left: 1px }
table.docutils td, table.docutils th,
table.docinfo td, table.docinfo th {
padding-left: 0.5em ;
padding-right: 0.5em ;
vertical-align: top }
table.docutils th.field-name, table.docinfo th.docinfo-name {
font-weight: bold ;
text-align: left ;
white-space: nowrap ;
padding-left: 0 }
h1 tt.docutils, h2 tt.docutils, h3 tt.docutils,
h4 tt.docutils, h5 tt.docutils, h6 tt.docutils {
font-size: 100% }
tt.docutils {
background-color: #eeeeee }
ul.auto-toc {
list-style-type: none }

133
doc/index.rst
View File

@ -1,133 +0,0 @@
=============================
Yet Another Snippet extension
=============================
.. _Organizing Snippets: snippet-organization.html
.. _Expanding Snippets: snippet-expansion.html
.. _Writing Snippets: snippet-development.html
.. _The YASnippet Menu: snippet-menu.html
.. contents::
**YASnippet** is a template system for Emacs. It allows you to type an
abbreviation and automatically expand it into function
templates. Bundled language templates includes: C, C++, C#, Perl,
Python, Ruby, SQL, LaTeX, HTML, CSS and more.
The snippet syntax is inspired from TextMate's syntax, you can even
`import <snippet-development.html#importing-textmate-snippets>`_
import most TextMate templates. YASnippet is a re-write of the
extension `smart-snippet`_. Both are original creations of `pluskid
<http://pluskid.lifegoo.org>`_.
.. _smart-snippet: http://code.google.com/p/smart-snippet/
Video Demo
==========
.. youtube:: 76Ygeg9miao
:align: right
Watch the `demo at YouTube
<http://www.youtube.com/watch?v=76Ygeg9miao>`_ (download a higher
resolution version: `yasnippet.avi
<http://yasnippet.googlecode.com/files/yasnippet.avi>`_).
Installation
============
There are two archives you can download. To quickly tryout YASnippet,
download the simpler "bundle" version. If you plan to modify the
bundled templates and/or build your own, download the "normal"
package.
Install with ``yasnippet-bundle.el``
------------------------------------
1. Download the latest ``yasnippet-bundle-x.y.z.el.tgz`` and unpack it.
2. You'll get a file named ``yasnippet-bundle.el``, put it under
``~/.emacs.d/plugins/`` (create the directory if not exists).
3. Open the file in Emacs, and type ``Alt+x eval-buffer``.
That's it. Now open any one of your language file, you'll see a menu
YASnippet. you can pull the menu to insert a template. Or, you can
type the a *trigger key* then press ``TAB`` to expand it.
To have Emacs load YASnippet automatically when it starts, put the
following in your ``~/.emacs`` file:
.. sourcecode:: common-lisp
(add-to-list 'load-path
"~/.emacs.d/plugins")
(require 'yasnippet-bundle)
The `youtube video <http://www.youtube.com/watch?v=76Ygeg9miao>`_
demonstrates this quick installation.
Normal Install
--------------
To install YASnippet as a normal emacs package, download and unpack
the latest ``yasnippet-x.y.z.tar.bz2``. You'll get a directory named
``yasnippet-x.y.z``, which you can put it in your
``~/.emacs.d/plugins`` and add the following in your ``.emacs`` file:
.. sourcecode:: common-lisp
(add-to-list 'load-path
"~/.emacs.d/plugins/yasnippet-x.y.z")
(require 'yasnippet) ;; not yasnippet-bundle
(yas/initialize)
(yas/load-directory "~/.emacs.d/plugins/yasnippet-x.y.z/snippets")
Please refer to the documentation for full customization, or use the
customization group.
How to use YASnippet
====================
Since version 0.6, YASnippet contains more functionality. You don't
need to know all of it to use it successfully, but you it can improve
your snippeting experience.
Hence this section has been split into separate documents:
1. `Organizing Snippets`_
Describes ways to organize your snippets in the hard disk (or not
organize them at all and just use ``yasnippet-bundle.el``.
2. `Expanding Snippets`_
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...
3. `Writing Snippets`_
Describes the YASnippet definition syntax, which is very close (but
not equivalent) to Textmate's. Includes a section about converting
TextMate snippets.
4. `The YASnippet menu`_
Explains how to use the YASnippet menu to explore, learn and modify
snippets.
Bugs, Contribution and Support
==============================
* If you find a bug, please report it at `Issue List
<http://code.google.com/p/yasnippet/issues/list>`_.
* If you have problem using YASnippet, or have some new ideas,
including snippets, please post to the `discussion group`_.
.. _discussion group: http://groups.google.com/group/smart-snippet
.. _wish list: http://code.google.com/p/yasnippet/wiki/WishList
Thank you very much for using YASnippet!
.. LocalWords: YASnippet SQL LaTeX CSS yasnippet el eval html ido RET wiki

266
doc/manual.org Normal file
View File

@ -0,0 +1,266 @@
#+TITLE: Yet another snippet extension
#+OPTIONS: toc:1
#+STARTUP: showall
#+STYLE: <link rel="stylesheet" type="text/css" href="stylesheets/styles.css" />
# External links
#
#+LINK: smart-snippet http://code.google.com/p/smart-snippet
#+LINK: pluskid http://pluskid.lifegoo.org
#+LINK: screencast http://www.youtube.com/watch?v=ZCGmZK4V7Sg
#+LINK: docs http://capitaomorte.github.com/yasnippet
#+LINK: issues https://github.com/capitaomorte/yasnippet/issues
#+LINK: googlecode-tracker http://code.google.com/p/yasnippet/issues/list
#+LINK: forum http://groups.google.com/group/smart-snippet
* Quick start
*YASnippet* is a template system for Emacs. It allows you to type an
abbreviation and automatically expand it into function templates. Bundled
language templates includes: C, C++, C#, Perl, Python, Ruby, SQL, LaTeX, HTML,
CSS and more. The snippet syntax is inspired from TextMate's syntax, you can
even [[#import-textmate][import most TextMate snippets]]
YASnippet is an original creation of [[pluskid]] who also wrote its predecessor
[[smart-snippet]].
** Watch a demo
[[youtube]]
** Installation
Clone this repository somewhere
#+begin_example
$ cd ~/.emacs.d/plugins
$ git clone https://github.com/capitaomorte/yasnippet
#+end_example
Add the following in your =.emacs= file:
#+begin_src emacs-lisp :exports code
(add-to-list 'load-path
"~/.emacs.d/plugins/yasnippet")
(require 'yasnippet)
(yas/global-mode 1)
#+end_src
Add your own snippets to =~/.emacs.d/snippets= by placing files there or
invoking [[#yas-new-snippet][=yas-new-snippet=]].
** Import textmate snippets (rails example)
:PROPERTIES:
:CUSTOM_ID: import-textmate
:END:
YASnippet lets you use TextMate bundles directly:
#+begin_example
$ cd ~/.emacs.d/plugins
$ git clone https://github.com/capitaomorte/yasnippet
$ cd yasnippet
$ git submodule init
$ git submodule update
$ gem install plist trollop
$ rake convert_bundles # will convert ruby, rails and html bundles from drnic
#+end_example
Then, in your =.emacs= file
#+begin_example
(add-to-list 'load-path
"~/.emacs.d/plugins/yasnippet")
(require 'yasnippet)
(setq yas/snippet-dirs '("~/.emacs.d/snippets" "~/.emacs.d/extras/imported"))
(yas/global-mode 1)
#+end_example
Open some rails file (model, app, etc) and start using the textmate
snippets. Consider that this is a work-in-progress and many snippets/commands
might not work. Patches welcome!
** Contributing snippets
Please *do not ask me* to add snippets to the default collection under
=/snippets=. This collection is considered frozen. By customizing
[[#yas-snippet-dirs][=yas-snippet-dirs=]] you can point yasnippet to good
snippet collections out there.
The =extras/textmate-import.rb= tool can import many actual Textmate
snippets. I'm focusing on developing it and the accompanying =yas-setup.el=
files that guide it with more difficult importations. The idea is to deprecate
=/snippets= and replace it with =extras/imported=.
** Documentation, issues, etc
Please refer to the comprehensive [[docs][documentation]] for full
customization and support. If you think you've found a bug, please report it
on [[issues][the GitHub issue tracker]]. (please **do not** submit new
issues to the old [[googlecode-tracker][googlecode tracker]])
If you run into problems using YASnippet, or have snippets to contribute,
post to the [[forum][yasnippet forum]]. Thank you very much for using
YASnippet!
* Organizing snippets
** Basic structure
Snippet collections can be stored in plain text files. They are arranged by
sub-directories naming *snippet tables*. These mostly name Emacs major names.
#+begin_example
.
|-- c-mode
| `-- printf
|-- java-mode
| `-- println
`-- text-mode
|-- email
`-- time
#+end_example
The collections are loaded into *snippet tables* which the triggering
mechanism (see [[#expand-snippets][Expanding snippets]]) looks up and
(hopefully) cause the right snippet to be expanded for you.
** Setting up =yas-snippet-dirs=
The emacs variable [[#yas-snippet-dirs][=yas-snippet-dirs=]] tells YASnippet
which collections to consider. It's used when you activate
[[#yas-global-mode][=yas-global-mode=]] or call
[[#yas-reload-all][=yas-reload-all=]] interactively.
The default considers:
- a personal collection that lives in =~/.emacs.d/snippets=
- the bundled collection, taken as a relative path to =yasnippet.el= localtion
When you come across other snippet collections, do the following to try them
out:
#+begin_src emacs-lisp :exports code
;; Develop in ~/emacs.d/mysnippets, but also
;; try out snippets in ~/Downloads/interesting-snippets
(setq yas/snippet-dirs '("~/emacs.d/mysnippets"
"~/Downloads/interesting-snippets"))
;; OR, keeping yasnippet's defaults try out ~/Downloads/interesting-snippets
(setq yas/snippet-dirs (append yas/snippet-dirs
'("~/Downloads/interesting-snippets")))
#+end_src
Collections appearing earlier in the list shadow snippets with same names
appearing in collections later in the list. [[#yas-new-snippet][=yas-new-snippet=]] always stores
snippets in the first collection.
** The =.yas.parents= file
It's very useful to have certain modes share snippets between themselves. To do
this, choose a mode subdirectory and place a =.yas-parents= containing a
whitespace-separated list of other mode names. When you reload those modes
become parents of the original mode.
#+begin_example
.
|-- c-mode
| |-- .yas-parents # contains "cc-mode text-mode"
| `-- printf
|-- cc-mode
| |-- for
| `-- while
|-- java-mode
| |-- .yas-parents # contains "cc-mode text-mode"
| `-- println
`-- text-mode
|-- email
`-- time
#+end_example
** TODO The =.yas-make-groups= file
If you place an empty plain text file =.yas-make-groups= inside one of the
mode directories, the names of these sub-directories are considered groups of
snippets and [[snippet-menu][the menu]] is organized much more cleanly:
(TODO image)
Another alternative way to achieve this is to place a =# group:= directive
inside the snippet definition. See [[#writing-snippets][Writing Snippets]]
#+begin_example
$ tree ruby-mode/
ruby-mode/
|-- .yas-make-groups
|-- collections
| |-- each
| `-- ...
|-- control structure
| |-- forin
| `-- ...
|-- definitions
| `-- ...
`-- general
`-- ...
#+end_example
Yet another way to create a nice snippet menu is to write into
=.yas-make-groups= a menu definition. TODO
** TODO The =.yas-setup.el= file
*** TODO
** TODO The =.yas-compiled-snippet.el= file
*** TODO
** The =.yas-skip= file
* Expanding Snippets
:PROPERTIES:
:CUSTOM_ID: expand-snippets
:END:
This section 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
** Triggering expansion
To make a snippet expand after the cursor:
* Type an the snippet's *trigger key* then press the key defined in
[[#yas-trigger-key][=yas-trigger-key=]] (usually to "TAB").
* Use the snippet's *keybinding*.
* Call [[#yas-insert-snippet][=yas-insert-snippet=]] (use =M-x
yas-insert-snippet== or its keybinding =C-c & C-s=).
* By expanding directly from the "YASnippet" menu in the menu-bar
* Using hippie-expand
* Use m2m's excellent auto-complete
* Reference
#+BEGIN_SRC emacs-lisp :exports results :results value raw
(yas--document-symbols 2 `("Interactive functions" . ,#'interactive-form)
`("Customization variables" . ,#'(lambda (sym)
(and (boundp sym)
(get sym 'standard-value))))
`("Useful functions" . ,#'fboundp)
`("Useful variables" . ,#'boundp))
#+END_SRC
# Local Variables:
# mode: org
# fill-column: 80
# coding: utf-8
# End:

630
doc/snippet-development.rst
View File

@ -1,630 +0,0 @@
================
Writing snippets
================
.. _Organizing Snippets: snippet-organization.html
.. _Expanding Snippets: snippet-expansion.html
.. _Writing Snippets: snippet-development.html
.. _The YASnippet Menu: snippet-menu.html
.. contents::
Snippet development
===================
Quickly finding snippets
------------------------
There are some ways you can quickly find a snippet file:
* ``M-x yas/new-snippet``
Prompts you for a snippet name, then tries to guess a suitable
directory to store it, prompting you for creation if it does not
exist. Finally, places you in a new buffer set to ``snippet-mode``
so you can write your snippet.
* ``M-x yas/find-snippets``
Lets you find the snippet file in the directory the snippet was
loaded from (if it exists) like ``find-file-other-window``. The
directory searching logic is similar to ``M-x yas/new-snippet``.
* ``M-x yas/visit-snippet-file``
Prompts you for possible snippet expansions like
``yas/insert-snippet``, but instead of expanding it, takes you
directly to the snippet definition's file, if it exists.
Once you find this file it will be set to ``snippet-mode`` (see ahead)
and you can start editing your snippet.
Using the ``snippet-mode`` major mode
-------------------------------------
There is a major mode ``snippet-mode`` to edit snippets. You can set
the buffer to this mode with ``M-x snippet-mode``. It provides
reasonably useful syntax highlighting.
Two commands are defined in this mode:
* ``M-x yas/load-snippet-buffer``
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``.
* ``M-x yas/tryout-snippet``
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``.
There are also *snippets for writing snippets*: ``vars``, ``$f`` and
``$m`` :-).
File content
============
A file defining a snippet generally contains the template to be
expanded.
Optionally, if the file contains a line of ``# --``, the lines above
it count as comments, some of which can be *directives* (or meta
data). Snippet directives look like ``# property: value`` and tweak
certain snippets properties described below. If no ``# --`` is found,
the whole file is considered the snippet template.
Here's a typical example:
.. sourcecode:: text
# contributor: pluskid <pluskid@gmail.com>
# name: __...__
# --
__${init}__
Here's a list of currently supported directives:
``# key:`` snippet abbrev
--------------------------
This is the probably the most important directive, it's the abbreviation you
type to expand a snippet just before hitting ``yas/trigger-key``. If you don't
specify this the snippet will not be expandable through the key mechanism.
``# name:`` snippet name
------------------------
This is a one-line description of the snippet. It will be displayed in
the menu. It's a good idea to select a descriptive name for a
snippet -- especially distinguishable among similar snippets.
If you omit this name it will default to the file name the snippet was
loaded from.
``# condition:`` snippet condition
----------------------------------
This is a piece of Emacs-lisp code. If a snippet has a condition, then it
will only be expanded when the condition code evaluate to some non-nil
value.
See also ``yas/buffer-local-condition`` in `Expanding snippets`_
``# group:`` snippet menu grouping
----------------------------------
When expanding/visiting snippets from the menu-bar menu, snippets for a
given mode can be grouped into sub-menus . This is useful if one has
too many snippets for a mode which will make the menu too
long.
The ``# group:`` property only affect menu construction (See `the
YASnippet menu`_) and the same effect can be achieved by grouping
snippets into sub-directories and using the ``.yas-make-groups``
special file (for this see `Organizing Snippets`_
Refer to the bundled snippets for ``ruby-mode`` for examples on the
``# group:`` directive. Group can also be nested, e.g. ``control
structure.loops`` tells that the snippet is under the ``loops`` group
which is under the ``control structure`` group.
``# expand-env:`` expand environment
------------------------------------
This is another piece of Emacs-lisp code in the form of a ``let``
*varlist form*, i.e. a list of lists assigning values to variables. It
can be used to override variable values while the snippet is being
expanded.
Interesting variables to override are ``yas/wrap-around-region`` and
``yas/indent-line`` (see `Expanding Snippets`_).
As an example, you might normally have ``yas/indent-line`` set to
``'auto`` and ``yas/wrap-around-region`` set to ``t``, but for this
particularly brilliant piece of ASCII art these values would mess up
your hard work. You can then use:
.. sourcecode:: text
# name: ASCII home
# expand-env: ((yas/indent-line 'fixed) (yas/wrap-around-region 'nil))
# --
welcome to my
X humble
/ \ home,
/ \ $0
/ \
/-------\
| |
| +-+ |
| | | |
+--+-+--+
``# binding:`` direct keybinding
---------------------------------
You can use this directive to expand a snippet directly from a normal
Emacs keybinding. The keybinding will be registered in the Emacs
keymap named after the major mode the snippet is active
for.
Additionally a variable ``yas/prefix`` is set to to the prefix
argument you normally use for a command. This allows for small
variations on the same snippet, for example in this "html-mode"
snippet.
.. sourcecode:: text
# name: <p>...</p>
# binding: C-c C-c C-m
# --
<p>`(when yas/prefix "\n")`$0`(when yas/prefix "\n")`</p>
This binding will be recorded in the keymap
``html-mode-map``. To expand a paragraph tag newlines, just
press ``C-u C-c C-c C-m``. Omitting the ``C-u`` will expand the
paragraph tag without newlines.
``# contributor:`` snippet author
---------------------------------------------------
This is optional and has no effect whatsoever on snippet
functionality, but it looks nice.
Template syntax
===============
The syntax of the snippet template is simple but powerful, very
similar to TextMate's.
Plain Text
----------
Arbitrary text can be included as the content of a template. They are
usually interpreted as plain text, except ``$`` and `````. You need to
use ``\`` to escape them: ``\$`` and ``\```. The ``\`` itself may also
needed to be escaped as ``\\`` sometimes.
Embedded Emacs-lisp code
------------------------
Emacs-Lisp code can be embedded inside the template, written inside
back-quotes (`````). The lisp forms are evaluated when the snippet is
being expanded. The evaluation is done in the same buffer as the
snippet being expanded.
Here's an example for ``c-mode`` to calculate the header file guard
dynamically:
.. sourcecode:: text
#ifndef ${1:_`(upcase (file-name-nondirectory (file-name-sans-extension (buffer-file-name))))`_H_}
#define $1
$0
#endif /* $1 */
From version 0.6, snippets expansions are run with some special
Emacs-lisp variables bound. One of this is ``yas/selected-text``. You
can therefore define a snippet like:
.. sourcecode:: text
for ($1;$2;$3) {
`yas/selected-text`$0
}
to "wrap" the selected region inside your recently inserted
snippet. Alternatively, you can also customize the variable
``yas/wrap-around-region`` to ``t`` which will do this automatically.
Tab stop fields
---------------
Tab stops are fields that you can navigate back and forth by ``TAB``
and ``S-TAB``. They are written by ``$`` followed with a
number. ``$0`` has the special meaning of the *exit point* of a
snippet. That is the last place to go when you've traveled all the
fields. Here's a typical example:
.. sourcecode:: text
<div$1>
$0
</div>
Placeholder fields
------------------
Tab stops can have default values -- a.k.a placeholders. The syntax is
like this:
.. sourcecode:: text
${N:default value}
They acts as the default value for a tab stop. But when you firstly
type at a tab stop, the default value will be replaced by your
typing. The number can be omitted if you don't want to create
`mirrors`_ or `transformations`_ for this field.
.. _mirrors:
Mirrors
-------
We refer the tab stops with placeholders as a *field*. A field can have
mirrors. Its mirrors will get updated when you change the text of a
field. Here's an example:
.. sourcecode:: text
\begin{${1:enumerate}}
$0
\end{$1}
When you type ``"document"`` at ``${1:enumerate}``, the word
``"document"`` will also be inserted at ``\end{$1}``. The best
explanation is to see the screencast(`YouTube
<http://www.youtube.com/watch?v=vOj7btx3ATg>`_ or `avi video
<http://yasnippet.googlecode.com/files/yasnippet.avi>`_).
The tab stops with the same number to the field act as its mirrors. If
none of the tab stops has an initial value, the first one is selected
as the field and others mirrors.
.. _transformations:
Mirrors with transformations
----------------------------
If the value of an ``${n:``-construct starts with and contains ``$(``,
then it is interpreted as a mirror for field ``n`` with a
transformation. The mirror's text content is calculated according to
this transformation, which is Emacs-lisp code that gets evaluated in
an environment where the variable ``text`` (or ``yas/text``) is bound
to the text content (string) contained in the field ``n``.Here's an
example for Objective-C:
.. sourcecode:: text
- (${1:id})${2:foo}
{
return $2;
}
- (void)set${2:$(capitalize text)}:($1)aValue
{
[$2 autorelease];
$2 = [aValue retain];
}
$0
Look at ``${2:$(capitalize text)}``, it is a mirror with
transformation instead of a field. The actual field is at the first
line: ``${2:foo}``. When you type text in ``${2:foo}``, the
transformation will be evaluated and the result will be placed there
as the transformed text. So in this example, if you type "baz" in the
field, the transformed text will be "Baz". This example is also
available in the screencast.
Another example is for ``rst-mode``. In reStructuredText, the document
title can be some text surrounded by "===" below and above. The "==="
should be at least as long as the text. So
.. sourcecode:: text
=====
Title
=====
is a valid title but
.. sourcecode:: text
===
Title
===
is not. Here's an snippet for rst title:
.. sourcecode:: text
${1:$(make-string (string-width text) ?\=)}
${1:Title}
${1:$(make-string (string-width text) ?\=)}
$0
Fields with transformations
---------------------------
From version 0.6 on, you can also have lisp transformation inside
fields. These work mostly mirror transformations but are evaluated
when you first enter the field, after each change you make to the
field and also just before you exit the field.
The syntax is also a tiny bit different, so that the parser can
distinguish between fields and mirrors. In the following example
.. sourcecode:: text
#define "${1:mydefine$(upcase yas/text)}"
``mydefine`` gets automatically upcased to ``MYDEFINE`` once you enter
the field. As you type text, it gets filtered through the
transformation every time.
Note that to tell this kind of expression from a mirror with a
transformation, YASnippet needs extra text between the ``:`` and the
transformation's ``$``. If you don't want this extra-text, you can use
two ``$``'s instead.
.. sourcecode:: text
#define "${1:$$(upcase yas/text)}"
Please note that as soon as a transformation takes place, it changes
the value of the field and sets it its internal modification state to
``true``. As a consequence, the auto-deletion behaviour of normal
fields does not take place. This is by design.
Choosing fields value from a list and other tricks
--------------------------------------------------
As mentioned, the field transformation is invoked just after you enter
the field, and with some useful variables bound, notably
``yas/modified-p`` and ``yas/moving-away-p``. Because of this
feature you can place a transformation in the primary field that lets
you select default values for it.
The ``yas/choose-value`` does this work for you. For example:
.. sourcecode:: text
<div align="${2:$$(yas/choose-value '("right" "center" "left"))}">
$0
</div>
See the definition of ``yas/choose-value`` to see how it was written
using the two variables.
Here's another use, for LaTeX-mode, which calls reftex-label just as
you enter snippet field 2. This one makes use of ``yas/modified-p``
directly.
.. sourcecode:: text
\section{${1:"Titel der Tour"}}%
\index{$1}%
\label{{2:"waiting for reftex-label call..."$(unless yas/modified-p (reftex-label nil 'dont-
insert))}}%
The function ``yas/verify-value`` has another neat trick, and makes
use of ``yas/moving-away-p``. Try it and see! Also, check out this
`thread
<http://groups.google.com/group/smart-snippet/browse_thread/thread/282a90a118e1b662>`_
Nested placeholder fields
-------------------------
From version 0.6 on, you can also have nested placeholders of the type:
.. sourcecode:: text
<div${1: id="${2:some_id}"}>$0</div>
This allows you to choose if you want to give this ``div`` an ``id``
attribute. If you tab forward after expanding it will let you change
"some_id" to whatever you like. Alternatively, you can just press
``C-d`` (which executes ``yas/skip-and-clear-or-delete-char``) and go
straight to the exit marker.
By the way, ``C-d`` will only clear the field if you cursor is at the
beginning of the field *and* it hasn't been changed yet. Otherwise, it
performs the normal Emacs ``delete-char`` command.
Customizable variables
======================
``yas/trigger-key``
-------------------
The key bound to ``yas/expand`` when function ``yas/minor-mode`` is
active.
Value is a string that is converted to the internal Emacs key
representation using ``read-kbd-macro``.
Default value is ``"TAB"``.
``yas/next-field-key``
----------------------
The key to navigate to next field when a snippet is active.
Value is a string that is converted to the internal Emacs key
representation using ``read-kbd-macro``.
Can also be a list of keys.
Default value is ``"TAB"``.
``yas/prev-field-key``
----------------------
The key to navigate to previous field when a snippet is active.
Value is a string that is converted to the internal Emacs key
representation using ``read-kbd-macro``.
Can also be a list of keys.
Default value is ``("<backtab>" "<S-tab>)"``.
``yas/skip-and-clear-key``
--------------------------
The key to clear the currently active field.
Value is a string that is converted to the internal Emacs key
representation using ``read-kbd-macro``.
Can also be a list of keys.
Default value is ``"C-d"``.
``yas/good-grace``
------------------
If non-nil, don't raise errors in inline Emacs-lisp evaluation inside
snippet definitions. An error string "[yas] error" is returned instead.
``yas/indent-line``
-------------------
The variable ``yas/indent-line`` controls the indenting. It is bound
to ``'auto`` by default, which causes your snippet to be indented
according to the mode of the buffer it was inserted in.
Another variable ``yas/also-auto-indent-first-line``, when non-nil
does exactly that :-).
To use the hard-coded indentation in your snippet template, set this
variable to ``fixed``.
To control indentation on a per-snippet basis, see also the directive
``# expand-env:`` in `Writing Snippets`_.
For backward compatibility with earlier versions of YASnippet, you can
also place a ``$>`` in your snippet, an ``(indent-according-to-mode)``
will be executed there to indent the line. This only takes effect when
``yas/indent-line`` is set to something other than ``'auto``.
.. sourcecode:: text
for (${int i = 0}; ${i < 10}; ${++i})
{$>
$0$>
}$>
``yas/wrap-around-region``
--------------------------
If non-nil, YASnippet will try to expand the snippet's exit marker
around the currently selected region. When this variable is set to t,
this has the same effect has using the ```yas/selected-text``` inline
evaluation.
Because on most systems starting to type deletes the currently
selected region, this works mostly for snippets with direct
keybindings or with the ``yas/insert-snippet`` command.
However, when the value is of this variable is ``cua`` YASnippet will
additionally look-up any recently selected that you deleted by starting
typing. This allows you select a region, type a snippet key (deleting
the region), then press ``yas/trigger-key`` to see the deleted region
spring back to life inside your new snippet.
``yas/triggers-in-field``
--------------------------
If non-nil, ``yas/next-field-key`` can trigger stacked expansions,
that is a snippet expansion inside another snippet
expansion. Otherwise, ``yas/next-field-key`` just tries to move on to
the next field.
``yas/snippet-revival``
-----------------------
Non-nil means re-activate snippet fields after undo/redo.
``yas/after-exit-snippet-hook`` and ``yas/before-expand-snippet-hook``
----------------------------------------------------------------------
These hooks are called, respectively, before the insertion of a
snippet and after exiting the snippet. If you find any strange but
functional use for them, that's probably a design flaw in YASnippet,
so let us know.
Importing TextMate snippets
===========================
There are a couple of tools that take TextMate's ".tmSnippet" xml
files and create YASnippet definitions:
* `a python script by Jeff Wheeler
<http://code.nokrev.com/?p=snippet-copier.git;a=blob_plain;f=snippet_copier.py>`_
* a `ruby tool
<http://yasnippet.googlecode.com/svn/trunk/extras/textmate_import.rb>`_
, ``textmate_import.rb`` adapted from `Rob Christie's
<http://www.neutronflux.net/2009/07/28/shoulda-snippets-for-emacs/>`_,
which I have uploaded to the repository.
In this section, i'll shortly cover the **second** option.
Download the ``textmate_import.rb`` tool and the TextMate
bundle you're interested in.
.. sourcecode:: text
$ curl -O http://yasnippet.googlecode.com/svn/trunk/extras/textmate_import.rb
$ svn export http://svn.textmate.org/trunk/Bundles/HTML.tmbundle/
Then invoke ``textmate_import.rb`` like this:
.. sourcecode:: text
$ ./textmate_import.rb -d HTML.tmbundle/Snippets/ -o html-mode -g HTML.tmbundle/info.plist
You should end up with a ``html-mode`` subdir containing snippets
exported from textmate.
.. sourcecode:: text
$ tree html-mode # to view dir contents, if you have 'tree' installed
The ``-g`` is optional but helps the tool figure out the grouping.
According to `Organizing Snippets`_, don't forget to touch
``.yas-make-groups`` and ``.yas-ignore-filename-triggers`` inside the
``html-mode`` dir.
Also try ``textmate_import.rb --help`` for a list of options.
Please note that snippet importation is not yet perfect. You'll
probably have some adjustments to some/many snippets. Please
contribute these adjustments to the google group or, better yet, patch
the ``textmate_import.rb`` to automatically perform them and submit
that.
.. LocalWords: html YASnippet yas sourcecode pluskid init filenames filename
.. LocalWords: env varlist keybinding keymap rinari ifndef upcase endif
.. LocalWords: nondirectory autorelease aValue inline

406
doc/snippet-expansion.rst
View File

@ -1,406 +0,0 @@
==================
Expanding snippets
==================
.. _Organizing Snippets: snippet-organization.html
.. _Expanding Snippets: snippet-expansion.html
.. _Writing Snippets: snippet-development.html
.. _The YASnippet Menu: snippet-menu.html
.. contents::
Triggering expansion
====================
You can use YASnippet to expand snippets in different ways:
* By typing an abbrev, the snippet *trigger key*, and then pressing
the key defined in ``yas/trigger-key`` (which defaults to
"TAB"). This works in buffers where the minor mode
``yas/minor-mode`` is active;
* By invoking the command ``yas/insert-snippet`` (either by typing
``M-x yas/insert-snippet`` or its keybinding). This does *not*
require ``yas/minor-mode`` to be active.
* By using the keybinding associated with an active snippet. This also
requires ``yas/minor-mode`` to be active;
* By expanding directly from the "YASnippet" menu in the menu-bar
* By using hippie-expand
* Expanding from emacs-lisp code
Trigger key
-----------
When ``yas/minor-mode`` is enabled, the keybinding taken from
``yas/trigger-key`` will take effect.
``yas/trigger-key`` invokes ``yas/expand``, which tries to expand a
*snippet abbrev* (also known as *snippet key*) before point.
The default key is ``"TAB"``, however, you can freely set it to some
other key.
.. image:: images/minor-mode-indicator.png
:align: left
To enable the YASnippet minor mode in all buffers globally use the
command ``yas/global-mode``.
When you use ``yas/global-mode`` you can also selectively disable
YASnippet in some buffers by setting the buffer-local variable
``yas/dont-active`` in the buffer's mode hook.
Trouble when using or understanding the ``yas/trigger-key`` is easily
the most controversial issue in YASsnippet. See the `FAQ <faq.html>`_.
Fallback bahaviour
~~~~~~~~~~~~~~~~~~
``yas/fallback-behaviour`` is a customization variable bound to
``'call-other-command`` by default. If ``yas/expand`` failed to find
any suitable snippet to expand, it will disable the minor mode
temporarily and find if there's any other command bound the
``yas/trigger-key``.
If found, the command will be called. Usually this works very well --
when there's a snippet, expand it, otherwise, call whatever command
originally bind to the trigger key.
However, you can change this behavior by customizing the
``yas/fallback-behavior`` variable. If you set this variable to
``'return-nil``, it will return ``nil`` instead of trying to call the
*original* command when no snippet is found.
Insert at point
---------------
The command ``M-x yas/insert-snippet`` lets you insert snippets at
point *for you current major mode*. It prompts you for the snippet
key first, and then for a snippet template if more than one template
exists for the same key.
The list presented contains the snippets that can be inserted at
point, according to the condition system. If you want to see all
applicable snippets for the major mode, prefix this command with
``C-u``.
The prompting methods used are again controlled by
``yas/prompt-functions``.
Snippet keybinding
------------------
See the section of the ``# binding:`` directive in `Writing
Snippets`_.
Expanding from the menu
-----------------------
See `the YASnippet Menu`_.
Expanding with ``hippie-expand``
----------------------------------
To integrate with ``hippie-expand``, just put
``yas/hippie-try-expand`` in
``hippie-expand-try-functions-list``. This probably makes more sense
when placed at the top of the list, but it can be put anywhere you
prefer.
Expanding from emacs-lisp code
------------------------------
Sometimes you might want to expand a snippet directly from you own
elisp code. You should call ``yas/expand-snippet`` instead of
``yas/expand`` in this case.
As with expanding from the menubar, the condition system and multiple
candidates doesn't affect expansion. In fact, expanding from the
YASnippet menu has the same effect of evaluating the follow code:
.. sourcecode:: common-lisp
(yas/expand-snippet template)
See the internal documentation on ``yas/expand-snippet`` for more
information.
Controlling expansion
=====================
Eligible snippets
-----------------
YASnippet does quite a bit of filtering to find out which snippets are
eligible for expanding at the current cursor position.
In particular, the following things matter:
* Currently loaded snippets tables
These are loaded from a directory hierarchy in your file system. See
`Organizing Snippets`_. They are named after major modes like
``html-mode``, ``ruby-mode``, etc...
* Major mode of the current buffer
If the currrent major mode matches one of the loaded snippet tables,
then all that table's snippets are considered for expansion. Use
``M-x describe-variable RET major-mode RET`` to find out which major
mode you are in currently.
* Parent tables
Snippet tables defined as the parent of some other eligible table
are also considered. This works recursively, i.e. parents of parents
of eligible tables are also considered.
* Buffer-local ``yas/mode-symbol`` variable
This can be used to consider snippet tables whose name does not
correspond to a major mode. If you set this variable to a name ,
like ``rinari-minor-mode``, you can have some snippets expand only
in that minor mode. Naturally, you want to set this conditionally,
i.e. only when entering that minor mode, so using a hook is a good
idea.
.. sourcecode:: common-lisp
;; When entering rinari-minor-mode, consider also the snippets in the
;; snippet table "rails-mode"
(add-hook 'rinari-minor-mode-hook
#'(lambda ()
(setq yas/mode-symbol 'rails-mode)))
* Buffer-local ``yas/buffer-local-condition`` variable
This variable provides finer grained control over what snippets can
be expanded in the current buffer. The default value won't let you
expand snippets inside comments or string literals for example. See
`The condition system`_ for more info.
The condition system
--------------------
Consider this scenario: you are an old Emacs hacker. You like the
abbrev-way and set ``yas/trigger-key`` to ``"SPC"``. However,
you don't want ``if`` to be expanded as a snippet when you are typing
in a comment block or a string (e.g. in ``python-mode``).
If you use the ``# condition :`` directive (see `Writing Snippets`_)
you could just specify the condition for ``if`` to be ``(not
(python-in-string/comment))``. But how about ``while``, ``for``,
etc. ? Writing the same condition for all the snippets is just
boring. So has a buffer local variable
``yas/buffer-local-condition``. You can set this variable to ``(not
(python-in-string/comment))`` in ``python-mode-hook``.
Then, what if you really want some particular snippet to expand even
inside a comment? This is also possible! But let's stop telling the
story and look at the rules:
* If ``yas/buffer-local-condition`` evaluate to nil, no snippets will
be considered for expansion.
* If it evaluates to the a *cons cell* where the ``car`` is the symbol
``require-snippet-condition`` and the ``cdr`` is a symbol (let's
call it ``requirement``), then:
* Snippets having no ``# condition:`` directive won't be considered;
* Snippets with conditions that evaluate to nil (or produce an
error) won't be considered;
* If the snippet has a condition that evaluates to non-nil (let's
call it ``result``):
* If ``requirement`` is ``t``, the snippet is ready to be
expanded;
* If ``requirement`` is ``eq`` to ``result``, the snippet is ready
to be expanded;
* Otherwise the snippet won't be considered.
* If it evaluates to the symbol ``always``, all snippets are
considered for expansion, regardless of any conditions.
* If it evaluate to ``t`` or some other non-nil value:
* If the snippet has no condition, or has a condition that evaluate
to non-nil, it is ready to be expanded.
* Otherwise, it won't be considered.
In the mentioned scenario, set ``yas/buffer-local-condition`` like
this
.. sourcecode:: common-lisp
(add-hook 'python-mode-hook
'(lambda ()
(setq yas/buffer-local-condition
'(if (python-in-string/comment)
'(require-snippet-condition . force-in-comment)
t))))
... and specify the condition for a snippet that you're going to
expand in comment to be evaluated to the symbol
``force-in-comment``. Then it can be expanded as you expected, while
other snippets like ``if`` still can't expanded in comment.
Multiples snippet with the same key
-----------------------------------
The rules outlined `above <Eligible snippets>`_ can return more than
one snippet to be expanded at point.
When there are multiple candidates, YASnippet will let you select
one. The UI for selecting multiple candidate can be customized through
``yas/prompt-functions`` , which defines your preferred methods of
being prompted for snippets.
You can customize it with ``M-x customize-variable RET
yas/prompt-functions RET``. Alternatively you can put in your
emacs-file:
.. sourcecode:: common-lisp
(setq yas/prompt-functions '(yas/x-prompt yas/dropdown-prompt))
Currently there are some alternatives solution with YASnippet.
.. image:: images/x-menu.png
:align: right
Use the X window system
~~~~~~~~~~~~~~~~~~~~~~~
The function ``yas/x-prompt`` can be used to show a popup menu for you
to select. This menu will be part of you native window system widget,
which means:
* It usually looks beautiful. E.g. when you compile Emacs with gtk
support, this menu will be rendered with your gtk theme.
* Your window system may or may not allow to you use ``C-n``, ``C-p``
to navigate this menu.
* This function can't be used when in a terminal.
.. image:: images/ido-menu.png
:align: right
Minibuffer prompting
~~~~~~~~~~~~~~~~~~~~
You can use functions ``yas/completing-prompt`` for the classic emacs
completion method or ``yas/ido-prompt`` for a much nicer looking
method. The best way is to try it. This works in a terminal.
.. image:: images/dropdown-menu.png
:align: right
Use ``dropdown-menu.el``
~~~~~~~~~~~~~~~~~~~~~~~~
The function ``yas/dropdown-prompt`` can also be placed in the
``yas/prompt-functions`` list.
This works in both window system and terminal and is customizable, you
can use ``C-n``, ``C-p`` to navigate, ``q`` to quit and even press
``6`` as a shortcut to select the 6th candidate.
Roll your own
~~~~~~~~~~~~~
See below for the documentation on variable ``yas/prompt-functions``
Customizable Variables
======================
``yas/prompt-functions``
------------------------
You can write a function and add it to the ``yas/prompt-functions``
list. These functions are called with the following arguments:
* PROMPT: A string to prompt the user;
* CHOICES: A list of strings or objects;
* optional DISPLAY-FN : A function. When applied to each of the
objects in CHOICES it will return a string;
The return value of any function you put here should be one of
the objects in CHOICES, properly formatted with DISPLAY-FN (if
that is passed).
* To signal that your particular style of prompting is unavailable at
the moment, you can also have the function return nil.
* To signal that the user quit the prompting process, you can signal
``quit`` with ``(signal 'quit "user quit!")``
``yas/fallback-behavior``
-------------------------
How to act when ``yas/expand`` does *not* expand a snippet.
``call-other-command`` means try to temporarily disable YASnippet and
call the next command bound to ``yas/trigger-key``.
``return-nil`` means return nil. (i.e. do nothing)
An entry (apply COMMAND . ARGS) means interactively call COMMAND, if
ARGS is non-nil, call COMMAND non-interactively with ARGS as
arguments.
``yas/choose-keys-first``
-------------------------
If non-nil, prompt for snippet key first, then for template.
Otherwise prompts for all possible snippet names.
This affects ``yas/insert-snippet`` and ``yas/visit-snippet-file``.
``yas/choose-tables-first``
---------------------------
If non-nil, and multiple eligible snippet tables, prompts user for
tables first.
Otherwise, user chooses between the merging together of all
eligible tables.
This affects ``yas/insert-snippet``, ``yas/visit-snippet-file``
``yas/key-syntaxes``
--------------------
The default searching strategy is quite powerful. For example, in
``c-mode``, ``bar``, ``foo_bar``, ``"#foo_bar"`` can all be recognized
as a snippet key. Furthermore, the searching is in that order. In
other words, if ``bar`` is found to be a key to some *valid* snippet,
then that snippet is expanded and replaces the ``bar``. Snippets
pointed to by ``foo_bar`` and ``"#foobar`` won't be considered.
However, this strategy can also be customized easily from the
``yas/key-syntaxes`` variable. It is a list of syntax rules, the
default value is ``("w" "w_" "w_." "^ ")``. Which means search the
following thing until found one:
* a word.
* a symbol. In lisp, ``-`` and ``?`` can all be part of a symbol.
* a sequence of characters of either word, symbol or punctuation.
* a sequence of characters of non-whitespace characters.
But you'd better keep the default value unless you want to understand
how Emacs's syntax rules work...

85
doc/snippet-menu.rst
View File

@ -1,85 +0,0 @@
==============
YASnippet menu
==============
.. contents::
When ``yas/minor-mode`` is active, YASnippet will setup a menu just
after the "Buffers" menu in the menubar.
In this menu, you can find
* The currently loaded snippet definitions, organized by major mode,
and optional grouping.
* A rundown of the most common commands, (followed by their
keybindings) including commands to load directories and reload all
snippet definitions.
* A series of submenus for customizing and exploring YASnippet
behavior.
.. image:: images/menu-1.png
:align: right
Loading snippets from menu
--------------------------
Invoking "Load snippets..." from the menu invokes
``yas/load-directory`` and prompts you for a snippet directory
hierarchy to load.
Also useful is the "Reload all" options which uncondionally reloads
all the snippets directories defined in ``yas/root-directory`` and
rebuilds the menus.
Snippet menu behavior
---------------------
YASnippet will list in this section all the loaded snippet definitions
organized by snippet table name.
You can use this section to explore currently loaded snippets. If you
click on one of them, the default behavior is to expand it,
unconditionally, inside the current buffer.
You can however, customize variable ``yas/visit-from-menu`` to be
``t`` which will take you to the snippet definition file when you
select it from the menu.
If you want the menu show only snippet tables whose name corresponds
to a "real" major mode. You do this by setting ``yas/use-menu`` to
``'real-modes``.
Finally, to have the menu show only the tables for the currently
active mode, set ``yas/use-menu`` to ``abbreviate``.
These customizations can also be found in the menu itself, under the
"Snippet menu behavior" submenu.
Controlling indenting
---------------------
The "Indenting" submenu contains options to control the values of
``yas/indent-line`` and ``yas/also-auto-indent-first-line``. See
`Writing snippets <snippet-development.html>`_ .
Prompting method
----------------
The "Prompting method" submenu contains options to control the value
of ``yas/prompt-functions``. See `Expanding snippets <snippet-expansion.html>`_ .
Misc
----
The "Misc" submenu contains options to control the values of more
variables.

183
doc/snippet-organization.rst
View File

@ -1,183 +0,0 @@
===================
Organizing snippets
===================
.. _Organizing Snippets: snippet-organization.html
.. _Expanding Snippets: snippet-expansion.html
.. _Writing Snippets: snippet-development.html
.. _The YASnippet Menu: snippet-menu.html
.. contents::
Loading snippets
================
Snippet definitions are stored in files in the filesystem. Unless you
use the simpler `bundle version <index.html@installation>`_), these
are arranged so that YASnippet can load them into *snippet
tables*. The triggering mechanisms (see `Expanding snippets`_) will
look up these snippet tables and (hopefully) expand the snippet you
intended.
The non-bundle version of YASnippet, once unpacked, comes with a full
directory of snippets, which you can copy somewhere and use. You can
also create or download more directories.
Once these directories are in place reference them in the variable
``yas/root-directory`` and load them with ``yas/load-directory``:
.. sourcecode:: common-lisp
;; Develop and keep personal snippets under ~/emacs.d/mysnippets
(setq yas/root-directory "~/emacs.d/mysnippets")
;; Load the snippets
(yas/load-directory yas/root-directory)
The point in using ``yas/root-directory`` (as opposed to calling
``yas/load-directory`` directly) is considering "~/emacs.d/mysnippets"
for snippet development, so you can use commands like
``yas/new-snippet`` and others described in section `Writing
Snippets`_.
You can make this variable a list and store more items into it:
.. sourcecode:: common-lisp
;; Develop in ~/emacs.d/mysnippets, but also
;; try out snippets in ~/Downloads/interesting-snippets
(setq yas/root-directory '("~/emacs.d/mysnippets"
"~/Downloads/interesting-snippets"))
;; Map `yas/load-directory' to every element
(mapc 'yas/load-directory yas/root-directory)
In this last example, the all the directories are loaded and their
snippets considered for expansion. However development still happens
in the first element, "~/emacs.d/mysnippets".
Organizing snippets
===================
Once you've setup ``yas/root-directory`` , you can store snippets
inside sub-directories of these directories.
Snippet definitions are put in plain text files. They are arranged
by sub-directories, and the snippet tables are named after these
directories.
The name corresponds to the Emacs mode where you want expansion to
take place. For example, snippets for ``c-mode`` are put in the
``c-mode`` sub-directory.
The ``.yas.parents`` file
-------------------------
It's very useful to have certain modes share snippets between
themselves. To do this, choose a mode subdirectory and place a
``.yas-parents`` containing a whitespace-separated list of other
mode names. When you reload those modes become parents of the
original mode.
.. sourcecode:: text
$ tree
.
|-- c-mode
| |-- .yas-parents # contains "cc-mode text-mode"
| `-- printf
|-- cc-mode
| |-- for
| `-- while
|-- java-mode
| |-- .yas-parents # contains "cc-mode text-mode"
| `-- println
`-- text-mode
|-- email
`-- time
The ``.yas-make-groups`` file
-----------------------------
.. image:: images/menu-groups.png
:align: right
If you place an empty plain text file ``.yas-make-groups`` inside one
of the mode directories, the names of these sub-directories are
considered groups of snippets and `The YASnippet Menu`_ is organized
much more cleanly, as you can see in the image.
Another alternative way to achieve this is to place a ``# group:``
directive inside the snippet definition. See `Writing Snippets`_.
.. sourcecode:: text
$ tree ruby-mode/
ruby-mode/
|-- .yas-make-groups
|-- collections
| |-- each
| `-- ...
|-- control structure
| |-- forin
| `-- ...
|-- definitions
| `-- ...
`-- general
`-- ...
YASnippet bundle
================
The most convenient way to define snippets for YASnippet is to put
them in a directory arranged by the mode and use
``yas/load-directory`` to load them.
However, this might slow down the Emacs start-up speed if you have many
snippets. You can use ``yas/define-snippets`` to define a bunch of
snippets for a particular mode in an Emacs-lisp file.
Since this is hard to maintain, there's a better way: define your
snippets in directory and then call ``M-x yas/compile-bundle`` to
compile it into a bundle file when you modified your snippets.
The release bundle of YASnippet is produced by
``yas/compile-bundle``. The bundle uses ``yas/define-snippets`` to
define snippets. This avoids the IO and parsing overhead when loading
snippets.
Further more, the generated bundle is a stand-alone file not depending
on ``yasnippet.el``. The released bundles of YASnippet are all
generated this way.
See the internal documentation for these functions
* ``M-x describe-function RET yas/define-snippets RET``
* ``M-x describe-function RET yas/compile-bundle RET``.
Customizable variables
======================
``yas/root-directory``
----------------------
Root directory that stores the snippets for each major mode.
If you set this from your .emacs, can also be a list of strings,
for multiple root directories. If you make this a list, the first
element is always the user-created snippets directory. Other
directories are used for bulk reloading of all snippets using
``yas/reload-all``
``yas/ignore-filenames-as-triggers``
------------------------------------
If non-nil, don't derive tab triggers from filenames.
This means a snippet without a ``# key:`` directive wont have a tab
trigger.
.. LocalWords: html YASnippet filesystem yas sourcecode setq mapc printf perl
.. LocalWords: println cperl forin filenames filename ERb's yasnippet Avar el
.. LocalWords: rjs RET

142
doc/styles.css
View File

@ -1,142 +0,0 @@
/* Base stylesheet from Docutils distribution */
@import url(html4css1.css);
/* Theme stylesheet */
body {
background: #EDF5FA;
margin: 0;
padding: 0;
}
.clear-block {
display: block;
}
#header-region {
background: #D2E6F3 url(images/bg-navigation.png) repeat-x scroll 50% 100%;;
min-height: 1em;
}
#wrapper {
background: #EDF5FA url(images/body.png) repeat-x scroll 50% 0pt;
}
#container {
margin: 0pt auto;
padding: 0pt 20px;
}
#header {
height: 80px;
}
#sidebar-left {
float: left;
margin: 60px 0pt 5em;
position: relative;
width: 210px;
z-index: 2;
}
#center #squeeze {
background: #FFFFFF url(images/bg-content.png) repeat-x scroll 50% 0pt;
position: relative;
}
#center .right-corner {
background: transparent url(images/bg-content-right.png) no-repeat scroll 100% 0pt;
left: 10px;
position: relative;
}
#center .left-corner {
background: transparent url(images/bg-content-left.png) no-repeat scroll 0pt 0pt;
left: -10px;
margin-left: -10px;
min-height: 400px;
padding: 60px 25px 5em 35px;
position: relative;
}
ul.primary-links {
float: right;
margin: 0px;
padding: 0px;
position: relative;
z-index: 4;
}
ul.primary-links li {
list-style-type: none;
float: left;
margin: 0px;
font-size: 0.8em;
padding: 0px;
}
ul.primary-links li a {
background: transparent url(images/bg-navigation-item.png) no-repeat scroll 50% 0pt;
color: #FFFFFF;
display: block;
margin: 0pt 1em;
padding: 0.75em 0pt 0pt;
}
ul.primary-links li a:hover {
background: transparent url(images/bg-navigation-item-hover.png) no-repeat scroll 50% 0pt;
}
#logo-floater {
position: absolute;
color: #FFFFFF;
height: 80px;
font-weight: normal;
text-shadow: #1659AC 0px 1px 3px;
}
#logo-floater h1 {
margin-top: 25px;
margin-left: 10px;
font-family: Georgia, Serif;
}
/* Contents stylesheet */
body {
font-family: Georgia, Serif;
}
#contents {
margin-right: 0;
width: 340px;
overflow: hidden;
float: right;
}
#contents p.topic-title {
margin: 0 0 0 18px;
}
#contents ul.simple {
margin: 5px 0 5px 5px;
padding: 2px 0 8px 30px;
border-left: 1px solid #E0E5FB;
}
a {
color: #027AC6;
text-decoration: none;
}
a:hover {
color: #0062A0;
text-decoration: underline;
}
a.toc-backref:hover {
color: #000000;
}
a.external {
padding-right: 13px;
background: transparent url(images/external.png) no-repeat scroll right center;
}
tt.docutils {
background-color: #EAFFEA;
font-family: Monaco, Consolas, Courier New, Monospace;
}
div.highlight {
margin: 5px 40px 5px 15px;
overflow: auto;
padding: 0;
background: #F7F7F7;
border: 1px solid #E0E5FB;
}
div.highlight pre {
margin: 8px 15px 8px 15px;
font-family: Monaco, Consolas, Courier New, Monospace;
font-size: 0.9em;
line-height: 1.2em;
}
img {
margin: 8px;
}

93
doc/stylesheets/styles.css Normal file
View File

@ -0,0 +1,93 @@
@media all
{
body {
margin: 1em auto;
/*margin: 10px 18% 10px 18%;*/
font-family: Arial;
/*text-align: justify;*/
font-size: 14pt;
padding: 10px;
line-height: 1.2em;
max-width: 600pt;
}
div#table-of-contents {
position: fixed;
left: 0%;
right: 0%;
top: 0px;
z-index: 100;
background: black;
}
div#table-of-contents h2 {
display: none;
}
div#table-of-contents a {
text-decoration: none;
color: white;
}
div#table-of-contents a:visited {
color: white;
}
div#table-of-contents a:hover {
color: orange;
}
div.outline-2 h2{
padding-top: 50px;
}
div#text-table-of-contents {
text-color: white;
text-align: center;
margin-left: 30%;
margin-right: 30%;
}
div#text-table-of-contents ul {
height: 2em;
width: 500px;
list-style: none;
margin: auto;
}
div#text-table-of-contents ul li {
float: left;
margin-left:auto;
margin-right: auto;
padding-left: 10px;
}
div#postamble{
position: fixed;
width: 800px;
height: 250px;
left: 50%;
right: 50%;
margin:-75px 0 0 -400px;
bottom: -20px;
font-size: 10pt;
color: grey;
background: url('siscog-bottom-logo.png') no-repeat;
/* background-size: 100% 100%; */
}
div#postamble *{
display: none;
}
div#postamble p.date{
position: relative;
bottom: -200px;
text-align: center;
display: block;
}
}

67
doc/template.txt
View File

@ -1,67 +0,0 @@
%(head_prefix)s
%(head)s
%(stylesheet)s
%(body_prefix)s
<div id="header-region" class="clear-block"></div>
<div id="wrapper">
<div id="container" class="clear-block">
<div id="header">
<div id="logo-floater">
%(html_title)s
</div>
<ul class="primary-links">
<li>
<a title="" href="index.html">Intro and tutorial</a>
</li>
<li>
<a title="" href="snippet-organization.html">Howto: organize</a>
</li>
<li>
<a title="" href="snippet-expansion.html">Howto: expand</a>
</li>
<li>
<a title="" href="snippet-development.html">Howto: write </a>
</li>
<li>
<a title="" href="snippet-menu.html">Howto: menu </a>
</li>
<li>
<a title="" href="faq.html">FAQ</a>
</li>
<li>
<a title="" href="changelog.html">ChangeLog</a>
</li>
<li>
<a title="" href="http://code.google.com/p/yasnippet/downloads/list">Download</a>
</li>
</ul>
</div>
<div id="center">
<div id="squeeze">
<div class="right-corner">
<div class="left-corner">
<p>
<b>Important:</b> This documentation applies to
the <b>SVN trunk</b> of YASnippet, which you
get <a href="http://code.google.com/p/yasnippet/source/checkout">here</a>. Documentation
for other versions can be found <a title=""
href="http://code.google.com/p/yasnippet/downloads/list">here</a>.
</p>
%(body)s
</div>
</div>
</div>
</div>
</div>
</div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%%3E%%3C/script%%3E"));
</script>
<script type="text/javascript">
try {
var pageTracker = _gat._getTracker("UA-10536822-1");
pageTracker._trackPageview();
} catch(err) {}
</script>
%(body_suffix)s

102
doc/yas-doc-helper.el Executable file
View File

@ -0,0 +1,102 @@
;;; yas-doc-helper.el --- Help generate documentation for YASnippet
;; Copyright (C) 2012 João Távora
;; Author: João Távora <joaotavora@gmail.com>
;; Keywords: convenience
;; This program is free software; you can redistribute it and/or modify
;; it under the terms of the GNU General Public License as published by
;; the Free Software Foundation, either version 3 of the License, or
;; (at your option) any later version.
;; This program is distributed in the hope that it will be useful,
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
;; GNU General Public License for more details.
;; You should have received a copy of the GNU General Public License
;; along with this program. If not, see <http://www.gnu.org/licenses/>.
;;; Commentary:
;; Some functions to help generate YASnippet docs
;;; Code:
(defun yas--document-symbol (symbol level)
(flet ((concat-lines (&rest lines)
(mapconcat #'identity lines "\n")))
(let* ((stars (make-string level ?*))
(heading (cond ((fboundp symbol)
(format "%s =%s= (%s)"
stars
symbol
(mapconcat #'symbol-name
(help-function-arglist symbol t) " ")))
(t
(format "%s =%s=\n" stars symbol))))
(after-heading
(concat-lines ":PROPERTIES:"
(format ":CUSTOM_ID: %s" symbol)
":END:"))
(body (or (cond ((boundp symbol)
(documentation-property symbol 'variable-documentation t))
((fboundp symbol)
(documentation-property symbol 'function-documentation t))
(t
(format "*WARNING*: no symbol named =%s=" symbol)))
(format "*WARNING*: no doc for symbol =%s=" symbol)))
(case-fold-search nil))
;; do some transformations on the body: FOO becomes /foo/ and
;; `bar' becomes [[#bar][=bar=]]
(setq body (replace-regexp-in-string
"[A-Z][A-Z-]+" #'(lambda (match)
(format "/%s/" (downcase match)))
body)
body (replace-regexp-in-string "`\\([a-z-]+\\)'" #'(lambda (match)
(let* ((name (downcase (match-string 1 match)))
(sym (intern name)))
(if (and (or (boundp sym)
(fboundp sym))
(save-match-data
(string-match "^yas-" name)))
(format "[[#%s][=%s=]]"
name name)
(format "=%s=" name))))
body))
;; output the paragraph
;;
(concat-lines heading
after-heading
body))))
(defun yas--document-symbols (level &rest names-and-predicates)
(let ((sym-lists (make-vector (length names-and-predicates) (list)))
(retval ""))
(loop for sym in yas--exported-syms
do (loop for test in (mapcar #'cdr names-and-predicates)
for i from 0
do (when (funcall test sym)
(push sym (aref sym-lists i))
(return))))
(loop for slist across sym-lists
for name in (mapcar #'car names-and-predicates)
do (progn
(setq retval
(concat retval
(format "\n** %s\n" name)
(mapconcat #'yas--document-symbol slist "\n\n")))))
retval))
(defun yas--internal-link-snippet ()
(interactive)
(yas-expand-snippet "[[#$1][=${1:`yas/selected-text`}=]]"))
(define-key org-mode-map [M-f8] 'yas--internal-link-snippet)
(provide 'yas-doc-helper)
;;; yas-doc-helper.el ends here
;; Local Variables:
;; coding: utf-8
;; End:

604
extras/imported/html-mode/.yas-setup.el
View File

@ -1,19 +1,19 @@
;; .yas-setup.el for html-mode ;; .yas-setup.el for html-mode
(defvar yas/html-default-tag "p") (defvar yas-html-default-tag "p")
(defvar yas/html-xhtml-attr "") (defvar yas-html-xhtml-attr "")
(defvar yas/html-just-like-tm nil (defvar yas-html-just-like-tm nil
"Html-mode snippets behave as close to TextMate as possible.") "Html-mode snippets behave as close to TextMate as possible.")
(defun yas/html-activate () (defun yas-html-activate ()
(add-to-list (make-local-variable 'yas/mode-symbol) 'html-mode)) (add-to-list (make-local-variable 'yas-mode-symbol) 'html-mode))
(add-hook 'nxml-mode-hook 'yas/html-activate) (add-hook 'nxml-mode-hook 'yas-html-activate)
(add-hook 'rhtml-mode-hook 'yas/html-activate) (add-hook 'rhtml-mode-hook 'yas-html-activate)
(defun yas/html-remove-preceding-word () (defun yas-html-remove-preceding-word ()
(interactive) (interactive)
(let (word-begin (let (word-begin
word-end word-end
@ -38,59 +38,59 @@
retval)))) retval))))
(defun yas/html-first-word (string) (defun yas-html-first-word (string)
(replace-regexp-in-string "\\\W.*" "" string)) (replace-regexp-in-string "\\\W.*" "" string))
(defun yas/html-insert-tag-pair-snippet () (defun yas-html-insert-tag-pair-snippet ()
(let* ((tag-and-suffix (or (and yas/selected-text (let* ((tag-and-suffix (or (and yas-selected-text
(cons yas/selected-text nil)) (cons yas-selected-text nil))
(yas/html-remove-preceding-word))) (yas-html-remove-preceding-word)))
(tag (car tag-and-suffix)) (tag (car tag-and-suffix))
(suffix (or (cdr tag-and-suffix) "")) (suffix (or (cdr tag-and-suffix) ""))
(single-no-arg "\\(br\\|hr\\)") (single-no-arg "\\(br\\|hr\\)")
(single "\\(img\\|meta\\|link\\|input\\|base\\|area\\|col\\|frame\\|param\\)")) (single "\\(img\\|meta\\|link\\|input\\|base\\|area\\|col\\|frame\\|param\\)"))
(cond ((null tag) (cond ((null tag)
(yas/expand-snippet (format "<${1:%s}>%s</${1:$(yas/html-first-word yas/text)}>%s" (yas-expand-snippet (format "<${1:%s}>%s</${1:$(yas-html-first-word yas-text)}>%s"
(or yas/html-default-tag (or yas-html-default-tag
"p") "p")
(if yas/html-just-like-tm "$2" "$0") (if yas-html-just-like-tm "$2" "$0")
suffix))) suffix)))
((string-match single-no-arg tag) ((string-match single-no-arg tag)
(insert (format "<%s%s/>%s" tag yas/html-xhtml-attr suffix))) (insert (format "<%s%s/>%s" tag yas-html-xhtml-attr suffix)))
((string-match single tag) ((string-match single tag)
(yas/expand-snippet (format "<%s $1%s/>%s" tag yas/html-xhtml-attr suffix))) (yas-expand-snippet (format "<%s $1%s/>%s" tag yas-html-xhtml-attr suffix)))
(t (t
(yas/expand-snippet (format "<%s>%s</%s>%s" (yas-expand-snippet (format "<%s>%s</%s>%s"
tag tag
(if yas/html-just-like-tm "$1" "$0") (if yas-html-just-like-tm "$1" "$0")
(replace-regexp-in-string "\\\W.*" "" tag) (replace-regexp-in-string "\\\W.*" "" tag)
suffix)))))) suffix))))))
(defun yas/html-wrap-each-line-in-openclose-tag () (defun yas-html-wrap-each-line-in-openclose-tag ()
(let* ((mirror "${1:$(yas/html-first-word yas/text)}") (let* ((mirror "${1:$(yas-html-first-word yas-text)}")
(yas/html-wrap-newline (when (string-match "\n" yas/selected-text) "\n")) (yas-html-wrap-newline (when (string-match "\n" yas-selected-text) "\n"))
(template (concat (format "<${1:%s}>" (or yas/html-default-tag "p")) (template (concat (format "<${1:%s}>" (or yas-html-default-tag "p"))
yas/selected-text yas-selected-text
"</" mirror ">"))) "</" mirror ">")))
(setq template (replace-regexp-in-string "\n" (concat "</" mirror ">\n<$1>") template)) (setq template (replace-regexp-in-string "\n" (concat "</" mirror ">\n<$1>") template))
(yas/expand-snippet template))) (yas-expand-snippet template)))
(defun yas/html-toggle-wrap (string wrap) (defun yas-html-toggle-wrap (string wrap)
(or (and string (or (and string
(string-match (format "<%s>\\(.*\\)</%s>" wrap wrap) (string-match (format "<%s>\\(.*\\)</%s>" wrap wrap)
string) string)
(match-string 1 string)) (match-string 1 string))
(concat wrap string wrap))) (concat wrap string wrap)))
(defun yas/html-between-tag-pair-p () (defun yas-html-between-tag-pair-p ()
(save-excursion (save-excursion
(backward-word) (backward-word)
(looking-at "\\\w+></\\\w+>"))) (looking-at "\\\w+></\\\w+>")))
(defun yas/html-id-from-string (string) (defun yas-html-id-from-string (string)
(replace-regexp-in-string " " "_" (downcase string))) (replace-regexp-in-string " " "_" (downcase string)))
(defun yas/html-tidy () (defun yas-html-tidy ()
(interactive) (interactive)
(let ((start (or (and mark-active (let ((start (or (and mark-active
(region-beginning)) (region-beginning))
@ -104,11 +104,11 @@
(goto-char (min (point-max) orig)) (goto-char (min (point-max) orig))
(recenter (1- orig-line)))) (recenter (1- orig-line))))
(defun yas/html-tag-description () (defun yas-html-tag-description ()
(interactive) (interactive)
(let* ((tag-at-point (sgml-beginning-of-tag)) (let* ((tag-at-point (sgml-beginning-of-tag))
(fragment (and tag-at-point (fragment (and tag-at-point
(cdr (assoc (upcase tag-at-point) yas/html-tag-description-urls))))) (cdr (assoc (upcase tag-at-point) yas-html-tag-description-urls)))))
(if fragment (if fragment
(browse-url (concat "http://www.w3.org/TR/html4/index/" (browse-url (concat "http://www.w3.org/TR/html4/index/"
fragment)) fragment))
@ -116,7 +116,7 @@
(message "No documentation for " tag-at-point) (message "No documentation for " tag-at-point)
(message "Not on a HTML tag."))))) (message "Not on a HTML tag.")))))
(defvar yas/html-tag-description-urls (defvar yas-html-tag-description-urls
'(("A" . "../struct/links.html#edef-A") '(("A" . "../struct/links.html#edef-A")
("ABBR" . "../struct/text.html#edef-ABBR") ("ABBR" . "../struct/text.html#edef-ABBR")
("ACRONYM" . "../struct/text.html#edef-ACRONYM") ("ACRONYM" . "../struct/text.html#edef-ACRONYM")
@ -213,18 +213,18 @@
;; ;;
;; Substitutions for: content ;; Substitutions for: content
;; # as in Snippets/Emphasize.yasnippet ;; # as in Snippets/Emphasize.yasnippet
;; ${TM_SELECTED_TEXT/\A<em>(.*)<\/em>\z|.*/(?1:$1:<em>$0<\/em>)/m} =yyas> `(yas/html-toggle-wrap yas/selected-text "em")` ;; ${TM_SELECTED_TEXT/\A<em>(.*)<\/em>\z|.*/(?1:$1:<em>$0<\/em>)/m} =yyas> `(yas-html-toggle-wrap yas-selected-text "em")`
;; ${TM_SELECTED_TEXT/\A<strong>(.*)<\/strong>\z|.*/(?1:$1:<strong>$0<\/strong>)/m} =yyas> `(yas/html-toggle-wrap yas/selected-text "strong")` ;; ${TM_SELECTED_TEXT/\A<strong>(.*)<\/strong>\z|.*/(?1:$1:<strong>$0<\/strong>)/m} =yyas> `(yas-html-toggle-wrap yas-selected-text "strong")`
;; ${1/\s.*//} =yyas> ${1:$(replace-regexp-in-string "[\s\t\n].*" "" yas/text)} ;; ${1/\s.*//} =yyas> ${1:$(replace-regexp-in-string "[\s\t\n].*" "" yas-text)}
;; ${1/[[:alpha:]]+|( )/(?1:_:\L$0)/g} =yyas> ${1:$(replace-regexp-in-string " " "_" (downcase yas/text))} ;; ${1/[[:alpha:]]+|( )/(?1:_:\L$0)/g} =yyas> ${1:$(replace-regexp-in-string " " "_" (downcase yas-text))}
;; ${TM_XHTML} =yyas> `yas/html-xhtml-attr` ;; ${TM_XHTML} =yyas> `yas-html-xhtml-attr`
;; # as in Commands/Preview in All Active Browsers.yasnippet ;; # as in Commands/Preview in All Active Browsers.yasnippet
;; 970EE6B4-A091-11D9-A5A2-000D93C8BE28 =yyas> (browse-url-of-buffer) ;; 970EE6B4-A091-11D9-A5A2-000D93C8BE28 =yyas> (browse-url-of-buffer)
;; 637CEA2B-578C-429C-BB74-30E8D42BFA22 =yyas> (yas/html-tag-description) ;; 637CEA2B-578C-429C-BB74-30E8D42BFA22 =yyas> (yas-html-tag-description)
;; 2ED44A32-C353-447F-BAE4-E3522DB6944D =yyas> (yas/html-insert-tag-pair-snippet) ;; 2ED44A32-C353-447F-BAE4-E3522DB6944D =yyas> (yas-html-insert-tag-pair-snippet)
;; 991E7EBD-F3F5-469A-BA01-DC30E04AD472 =yyas> (yas/html-wrap-each-line-in-openclose-tag) ;; 991E7EBD-F3F5-469A-BA01-DC30E04AD472 =yyas> (yas-html-wrap-each-line-in-openclose-tag)
;; Substitutions for: binding ;; Substitutions for: binding
;; ;;
@ -248,28 +248,28 @@
;; ^@W =yyas> C-c M-W ;; ^@W =yyas> C-c M-W
;; ;;
;; # as in Snippets/XHTML &nbsp NonBreakingSpace.yasnippet ;; # as in Snippets/XHTML &nbsp NonBreakingSpace.yasnippet
;; ~ =yyas> (yas/unknown) ;; ~ =yyas> (yas-unknown)
;; ;;
;; # as in Commands/Insert Entity.yasnippet ;; # as in Commands/Insert Entity.yasnippet
;; @& =yyas> (yas/unknown) ;; @& =yyas> (yas-unknown)
;; ;;
;; # as in Commands/Refresh All Active Browsers.yasnippet ;; # as in Commands/Refresh All Active Browsers.yasnippet
;; @r =yyas> (yas/unknown) ;; @r =yyas> (yas-unknown)
;; ;;
;; # as in Commands/Persistent Include.yasnippet ;; # as in Commands/Persistent Include.yasnippet
;; ^@i =yyas> (yas/unknown) ;; ^@i =yyas> (yas-unknown)
;; ;;
;; # as in Commands/CodeCompletion HTML Tags.yasnippet ;; # as in Commands/CodeCompletion HTML Tags.yasnippet
;; ~ =yyas> (yas/unknown) ;; ~ =yyas> (yas-unknown)
;; ;;
;; # as in Commands/Update Includes.yasnippet ;; # as in Commands/Update Includes.yasnippet
;; ^@u =yyas> (yas/unknown) ;; ^@u =yyas> (yas-unknown)
;; ;;
;; # as in Macros/Delete whitespace between tags.yasnippet ;; # as in Macros/Delete whitespace between tags.yasnippet
;; ^~ =yyas> (yas/unknown) ;; ^~ =yyas> (yas-unknown)
;; ;;
;; # as in Commands/Tidy.yasnippet ;; # as in Commands/Tidy.yasnippet
;; ^H =yyas> (yas/unknown) ;; ^H =yyas> (yas-unknown)
;; ;;
;; ;;
;; --**-- ;; --**--
@ -277,180 +277,180 @@
;; ;;
;; Translated menu ;; Translated menu
;; ;;
(yas/define-menu 'html-mode (yas-define-menu 'html-mode
'(;; Documentation for Tag '(;; Documentation for Tag
(yas/item "637CEA2B-578C-429C-BB74-30E8D42BFA22") (yas-item "637CEA2B-578C-429C-BB74-30E8D42BFA22")
;; Ignoring Validate Syntax (W3C) ;; Ignoring Validate Syntax (W3C)
(yas/ignore-item "3F26240E-6E4A-11D9-B411-000D93589AF6") (yas-ignore-item "3F26240E-6E4A-11D9-B411-000D93589AF6")
;; Open Document in Running Browser(s) ;; Open Document in Running Browser(s)
(yas/item "970EE6B4-A091-11D9-A5A2-000D93C8BE28") (yas-item "970EE6B4-A091-11D9-A5A2-000D93C8BE28")
;; Ignoring Refresh Running Browser(s) ;; Ignoring Refresh Running Browser(s)
(yas/ignore-item "B8651C6E-A05E-11D9-86AC-000D93C8BE28") (yas-ignore-item "B8651C6E-A05E-11D9-86AC-000D93C8BE28")
(yas/submenu "Entities" (yas-submenu "Entities"
(;; Ignoring Convert Character / Selection to Entities (;; Ignoring Convert Character / Selection to Entities
(yas/ignore-item "3DD8406C-A116-11D9-A5A2-000D93C8BE28") (yas-ignore-item "3DD8406C-A116-11D9-A5A2-000D93C8BE28")
;; Ignoring Convert Character / Selection to Entities Excl. Tags ;; Ignoring Convert Character / Selection to Entities Excl. Tags
(yas/ignore-item "43C9E8AE-3E53-4B82-A1AF-56697BB3EF09") (yas-ignore-item "43C9E8AE-3E53-4B82-A1AF-56697BB3EF09")
;; Ignoring Decode Entities in Line / Selection ;; Ignoring Decode Entities in Line / Selection
(yas/ignore-item "C183920D-A126-11D9-A5A2-000D93C8BE28") (yas-ignore-item "C183920D-A126-11D9-A5A2-000D93C8BE28")
;; Non-Breaking Space ;; Non-Breaking Space
(yas/item "73B40BAE-A295-11D9-87F7-000D93C8BE28") (yas-item "73B40BAE-A295-11D9-87F7-000D93C8BE28")
;; → ;; →
(yas/item "C70BB693-0954-4440-AEB4-F2ADD6D923F0") (yas-item "C70BB693-0954-4440-AEB4-F2ADD6D923F0")
;; ← ;; ←
(yas/item "C0418A4A-7E42-4D49-8F86-6E339296CB84") (yas-item "C0418A4A-7E42-4D49-8F86-6E339296CB84")
;; ⇤ ;; ⇤
(yas/item "7F102705-27D8-4029-BF61-2F042FB61E06") (yas-item "7F102705-27D8-4029-BF61-2F042FB61E06")
;; ⌅ ;; ⌅
(yas/item "7062316B-4236-4793-AD35-05E4A6577393") (yas-item "7062316B-4236-4793-AD35-05E4A6577393")
;; ⌃ ;; ⌃
(yas/item "B4987DA5-9C2F-4D2D-AC14-678115079205") (yas-item "B4987DA5-9C2F-4D2D-AC14-678115079205")
;; ⌦ ;; ⌦
(yas/item "44E448B6-37CE-4BFE-8611-C5113593B74B") (yas-item "44E448B6-37CE-4BFE-8611-C5113593B74B")
;; ↩ ;; ↩
(yas/item "9B216475-D73D-4518-851F-CACD0066A909") (yas-item "9B216475-D73D-4518-851F-CACD0066A909")
;; ⇥ ;; ⇥
(yas/item "ADC78A82-40C2-4AAC-8968-93AF0ED98DF0") (yas-item "ADC78A82-40C2-4AAC-8968-93AF0ED98DF0")
;; ⌫ ;; ⌫
(yas/item "38E50882-27AF-4246-A039-355C3E1A699E") (yas-item "38E50882-27AF-4246-A039-355C3E1A699E")
;; ⌘ ;; ⌘
(yas/item "7214ACD1-93D9-4D3F-A428-8A7302E0A35E") (yas-item "7214ACD1-93D9-4D3F-A428-8A7302E0A35E")
;; ↓ ;; ↓
(yas/item "35654B4E-2D76-4CD3-8FBB-2DA1F314BA19") (yas-item "35654B4E-2D76-4CD3-8FBB-2DA1F314BA19")
;; → ;; →
(yas/item "AC15621A-8A16-40DD-A671-EA4C37637215") (yas-item "AC15621A-8A16-40DD-A671-EA4C37637215")
;; ↑ ;; ↑
(yas/item "0E2F4A47-EADE-4A05-931E-FC874FA28FC3") (yas-item "0E2F4A47-EADE-4A05-931E-FC874FA28FC3")
;; ⇧ ;; ⇧
(yas/item "1B8D58B9-D9DB-484C-AACD-5D5DF5385308") (yas-item "1B8D58B9-D9DB-484C-AACD-5D5DF5385308")
;; ⎋ ;; ⎋
(yas/item "D7CC7C7C-CD01-4357-AF91-AEFFD914DF98") (yas-item "D7CC7C7C-CD01-4357-AF91-AEFFD914DF98")
;; ⌥ ;; ⌥
(yas/item "980A8D39-CA8B-4EC2-9739-DC36A262F28E") (yas-item "980A8D39-CA8B-4EC2-9739-DC36A262F28E")
(yas/separator) (yas-separator)
;; Ignoring Insert Entity… ;; Ignoring Insert Entity…
(yas/ignore-item "89E5CC0A-3EFF-4DEF-A299-2E9651DE6529"))) (yas-ignore-item "89E5CC0A-3EFF-4DEF-A299-2E9651DE6529")))
(yas/submenu "URL Escapes" (yas-submenu "URL Escapes"
(;; Ignoring URL Escape Line / Selection (;; Ignoring URL Escape Line / Selection
(yas/ignore-item "6B024865-6095-4CE3-8EDD-DC6F2230C2FF") (yas-ignore-item "6B024865-6095-4CE3-8EDD-DC6F2230C2FF")
;; Ignoring URL Unescape Line / Selection ;; Ignoring URL Unescape Line / Selection
(yas/ignore-item "2C4C9673-B166-432A-8938-75A5CA622481"))) (yas-ignore-item "2C4C9673-B166-432A-8938-75A5CA622481")))
;; Ignoring Encrypt Line / Selection (ROT 13) ;; Ignoring Encrypt Line / Selection (ROT 13)
(yas/ignore-item "9B13543F-8356-443C-B6E7-D9259B604927") (yas-ignore-item "9B13543F-8356-443C-B6E7-D9259B604927")
;; Ignoring CodeCompletion HTML Attributes ;; Ignoring CodeCompletion HTML Attributes
(yas/ignore-item "CBD82CF3-74E9-4E7A-B3F6-9348754EB5AA") (yas-ignore-item "CBD82CF3-74E9-4E7A-B3F6-9348754EB5AA")
;; Insert Open/Close Tag (With Current Word) ;; Insert Open/Close Tag (With Current Word)
(yas/item "2ED44A32-C353-447F-BAE4-E3522DB6944D") (yas-item "2ED44A32-C353-447F-BAE4-E3522DB6944D")
;; Ignoring Insert Close Tag ;; Ignoring Insert Close Tag
(yas/ignore-item "0658019F-3635-462E-AAC2-74E4FE508A9B") (yas-ignore-item "0658019F-3635-462E-AAC2-74E4FE508A9B")
(yas/submenu "Insert DocType" (yas-submenu "Insert DocType"
(;; HTML — 4.01 Strict (;; HTML — 4.01 Strict
(yas/item "944F1410-188C-4D70-8340-CECAA56FC7F2") (yas-item "944F1410-188C-4D70-8340-CECAA56FC7F2")
;; HTML — 4.01 Transitional ;; HTML — 4.01 Transitional
(yas/item "B2AAEE56-42D8-42C3-8F67-865473F50E8D") (yas-item "B2AAEE56-42D8-42C3-8F67-865473F50E8D")
(yas/separator) (yas-separator)
;; XHTML — 1.0 Frameset ;; XHTML — 1.0 Frameset
(yas/item "9ED6ABBE-A802-11D9-BFC8-000D93C8BE28") (yas-item "9ED6ABBE-A802-11D9-BFC8-000D93C8BE28")
;; XHTML — 1.0 Strict ;; XHTML — 1.0 Strict
(yas/item "C8B83564-A802-11D9-BFC8-000D93C8BE28") (yas-item "C8B83564-A802-11D9-BFC8-000D93C8BE28")
;; XHTML — 1.0 Transitional ;; XHTML — 1.0 Transitional
(yas/item "7D8C2F74-A802-11D9-BFC8-000D93C8BE28") (yas-item "7D8C2F74-A802-11D9-BFC8-000D93C8BE28")
;; XHTML — 1.1 ;; XHTML — 1.1
(yas/item "5CE8FC6E-A802-11D9-BFC8-000D93C8BE28"))) (yas-item "5CE8FC6E-A802-11D9-BFC8-000D93C8BE28")))
(yas/submenu "Insert Tag" (yas-submenu "Insert Tag"
(;; Ignoring CodeCompletion HTML Tags (;; Ignoring CodeCompletion HTML Tags
(yas/ignore-item "3463E85F-F500-49A0-8631-D78ED85F9D60") (yas-ignore-item "3463E85F-F500-49A0-8631-D78ED85F9D60")
;; Base ;; Base
(yas/item "4462A6B8-A08A-11D9-A5A2-000D93C8BE28") (yas-item "4462A6B8-A08A-11D9-A5A2-000D93C8BE28")
;; Body ;; Body
(yas/item "4905D47B-A08B-11D9-A5A2-000D93C8BE28") (yas-item "4905D47B-A08B-11D9-A5A2-000D93C8BE28")
;; Br ;; Br
(yas/item "3E008E42-A5C9-11D9-9BCD-000D93C8BE28") (yas-item "3E008E42-A5C9-11D9-9BCD-000D93C8BE28")
;; Div ;; Div
(yas/item "576036C0-A60E-11D9-ABD6-000D93C8BE28") (yas-item "576036C0-A60E-11D9-ABD6-000D93C8BE28")
;; Embed QT Movie ;; Embed QT Movie
(yas/item "42F15753-9B6D-4DD8-984C-807B94363277") (yas-item "42F15753-9B6D-4DD8-984C-807B94363277")
;; Fieldset ;; Fieldset
(yas/item "9BD2BE01-A854-4D55-B584-725D04C075C0") (yas-item "9BD2BE01-A854-4D55-B584-725D04C075C0")
;; Form ;; Form
(yas/item "232C2E8B-A08E-11D9-A5A2-000D93C8BE28") (yas-item "232C2E8B-A08E-11D9-A5A2-000D93C8BE28")
;; Head ;; Head
(yas/item "9CF008C4-A086-11D9-A5A2-000D93C8BE28") (yas-item "9CF008C4-A086-11D9-A5A2-000D93C8BE28")
;; Heading ;; Heading
(yas/item "65BA66DC-A07F-11D9-A5A2-000D93C8BE28") (yas-item "65BA66DC-A07F-11D9-A5A2-000D93C8BE28")
;; Input ;; Input
(yas/item "44180979-A08E-11D9-A5A2-000D93C8BE28") (yas-item "44180979-A08E-11D9-A5A2-000D93C8BE28")
;; Input with Label ;; Input with Label
(yas/item "D8DCCC81-749A-4E2A-B4BC-D109D5799CAA") (yas-item "D8DCCC81-749A-4E2A-B4BC-D109D5799CAA")
;; Link ;; Link
(yas/item "77BFD0C0-A08A-11D9-A5A2-000D93C8BE28") (yas-item "77BFD0C0-A08A-11D9-A5A2-000D93C8BE28")
;; Mail Anchor ;; Mail Anchor
(yas/item "81DA4C74-A530-11D9-9BCD-000D93C8BE28") (yas-item "81DA4C74-A530-11D9-9BCD-000D93C8BE28")
;; Meta ;; Meta
(yas/item "DA99AC44-A083-11D9-A5A2-000D93C8BE28") (yas-item "DA99AC44-A083-11D9-A5A2-000D93C8BE28")
;; Option ;; Option
(yas/item "5820372E-A093-4F38-B25C-B0CCC50A0FC4") (yas-item "5820372E-A093-4F38-B25C-B0CCC50A0FC4")
;; Script ;; Script
(yas/item "6592050A-A087-11D9-A5A2-000D93C8BE28") (yas-item "6592050A-A087-11D9-A5A2-000D93C8BE28")
;; Script With External Source ;; Script With External Source
(yas/item "7D676C4C-A087-11D9-A5A2-000D93C8BE28") (yas-item "7D676C4C-A087-11D9-A5A2-000D93C8BE28")
;; Select Box ;; Select Box
(yas/item "26023CFF-C73F-4EF5-9803-E4DBA2CBEADD") (yas-item "26023CFF-C73F-4EF5-9803-E4DBA2CBEADD")
;; Style ;; Style
(yas/item "3C518074-A088-11D9-A5A2-000D93C8BE28") (yas-item "3C518074-A088-11D9-A5A2-000D93C8BE28")
;; Table ;; Table
(yas/item "57176082-A12F-11D9-A5A2-000D93C8BE28") (yas-item "57176082-A12F-11D9-A5A2-000D93C8BE28")
;; Text Area ;; Text Area
(yas/item "AAC9D7B8-A12C-11D9-A5A2-000D93C8BE28") (yas-item "AAC9D7B8-A12C-11D9-A5A2-000D93C8BE28")
;; Title ;; Title
(yas/item "B62ECABE-A086-11D9-A5A2-000D93C8BE28"))) (yas-item "B62ECABE-A086-11D9-A5A2-000D93C8BE28")))
(yas/submenu "Includes" (yas-submenu "Includes"
(;; Ignoring Add Persistent Include (;; Ignoring Add Persistent Include
(yas/ignore-item "0D814247-7A00-46EE-A2A4-45FBBF4B1181") (yas-ignore-item "0D814247-7A00-46EE-A2A4-45FBBF4B1181")
;; Ignoring Update Document ;; Ignoring Update Document
(yas/ignore-item "4400BCE9-20E3-426E-B1D7-2C0BCA53BCF8") (yas-ignore-item "4400BCE9-20E3-426E-B1D7-2C0BCA53BCF8")
;; Ignoring Help: Persistent Includes ;; Ignoring Help: Persistent Includes
(yas/ignore-item "9AFDEB2C-D9F0-423E-8211-EBB089F51F0C"))) (yas-ignore-item "9AFDEB2C-D9F0-423E-8211-EBB089F51F0C")))
(yas/submenu "Format" (yas-submenu "Format"
(;; Strong (;; Strong
(yas/item "4117D930-B6FA-4022-97E7-ECCAF4E70F63") (yas-item "4117D930-B6FA-4022-97E7-ECCAF4E70F63")
;; Emphasize ;; Emphasize
(yas/item "EBB98620-3292-4621-BA38-D8A9A65D9551"))) (yas-item "EBB98620-3292-4621-BA38-D8A9A65D9551")))
(yas/submenu "Conditional Comments" (yas-submenu "Conditional Comments"
(;; IE Conditional Comment: Internet Explorer (;; IE Conditional Comment: Internet Explorer
(yas/item "0ED6DA73-F38F-4A65-B18F-3379D2BA9387") (yas-item "0ED6DA73-F38F-4A65-B18F-3379D2BA9387")
;; IE Conditional Comment: Internet Explorer 5.0 only ;; IE Conditional Comment: Internet Explorer 5.0 only
(yas/item "3A517A94-001E-464D-8184-1FE56D0D0D70") (yas-item "3A517A94-001E-464D-8184-1FE56D0D0D70")
;; IE Conditional Comment: Internet Explorer 5.5 only ;; IE Conditional Comment: Internet Explorer 5.5 only
(yas/item "E3F8984E-7269-4981-9D30-967AB56A6ACE") (yas-item "E3F8984E-7269-4981-9D30-967AB56A6ACE")
;; IE Conditional Comment: Internet Explorer 5.x ;; IE Conditional Comment: Internet Explorer 5.x
(yas/item "F3512848-7889-45DA-993B-0547976C8E6D") (yas-item "F3512848-7889-45DA-993B-0547976C8E6D")
;; IE Conditional Comment: Internet Explorer 6 and below ;; IE Conditional Comment: Internet Explorer 6 and below
(yas/item "32BBB9AB-8732-4F91-A587-354941A27B69") (yas-item "32BBB9AB-8732-4F91-A587-354941A27B69")
;; IE Conditional Comment: Internet Explorer 6 only ;; IE Conditional Comment: Internet Explorer 6 only
(yas/item "48DF7485-52EA-49B3-88AF-3A41F933F325") (yas-item "48DF7485-52EA-49B3-88AF-3A41F933F325")
;; IE Conditional Comment: Internet Explorer 7 and above ;; IE Conditional Comment: Internet Explorer 7 and above
(yas/item "CBC24AF4-88E0-498B-BE50-934B9CF29EC7") (yas-item "CBC24AF4-88E0-498B-BE50-934B9CF29EC7")
;; IE Conditional Comment: NOT Internet Explorer ;; IE Conditional Comment: NOT Internet Explorer
(yas/item "F00170EE-4A82-413F-A88B-85293E69A88B"))) (yas-item "F00170EE-4A82-413F-A88B-85293E69A88B")))
;; Wrap Selection in Open/Close Tag ;; Wrap Selection in Open/Close Tag
(yas/item "BC8B8AE2-5F16-11D9-B9C3-000D93589AF6") (yas-item "BC8B8AE2-5F16-11D9-B9C3-000D93589AF6")
;; Wrap Each Selected Line in Open/Close Tag ;; Wrap Each Selected Line in Open/Close Tag
(yas/item "991E7EBD-F3F5-469A-BA01-DC30E04AD472") (yas-item "991E7EBD-F3F5-469A-BA01-DC30E04AD472")
;; Wrap in <?= … ?> ;; Wrap in <?= … ?>
(yas/item "912906A0-9A29-434B-AE98-E9DFDE6E48B4") (yas-item "912906A0-9A29-434B-AE98-E9DFDE6E48B4")
(yas/separator) (yas-separator)
;; Ignoring Strip HTML Tags from Document / Selection ;; Ignoring Strip HTML Tags from Document / Selection
(yas/ignore-item "20D760B5-A127-11D9-A5A2-000D93C8BE28") (yas-ignore-item "20D760B5-A127-11D9-A5A2-000D93C8BE28")
;; Ignoring Tidy ;; Ignoring Tidy
(yas/ignore-item "45F92B81-6F0E-11D9-A1E4-000D9332809C")) (yas-ignore-item "45F92B81-6F0E-11D9-A1E4-000D9332809C"))
'("7B7E945E-A112-11D9-A5A2-000D93C8BE28" '("7B7E945E-A112-11D9-A5A2-000D93C8BE28"
"3C44EABE-8D6F-4B1B-AB91-F419FAD1A0AD" "3C44EABE-8D6F-4B1B-AB91-F419FAD1A0AD"
"9AFDEB2C-D9F0-423E-8211-EBB089F51F0C" "9AFDEB2C-D9F0-423E-8211-EBB089F51F0C"
@ -485,205 +485,205 @@
;; ;;
;; Substitutions for: content ;; Substitutions for: content
;; ;;
;; # as in Templates/XHTML 1.1/info.yasnippet
;; CDE8EFD6-9DE2-4E8C-BB6A-52E8CCD2E977 =yyas> (yas/unknown)
;;
;; # as in Snippets/IE Conditional Comment Internet Explorer.yasnippet
;; `(or (yas/selected-text) " IE Conditional Comment: Internet Explorer ")` =yyas> (yas/unknown)
;;
;; # as in Snippets/IE Conditional Comment Internet Explorer 5_0 only.yasnippet
;; `(or (yas/selected-text) " IE Conditional Comment: Internet Explorer 5.0 only ")` =yyas> (yas/unknown)
;;
;; # as in Commands/CodeCompletion HTML Tags.yasnippet
;; 3463E85F-F500-49A0-8631-D78ED85F9D60 =yyas> (yas/unknown)
;;
;; # as in Snippets/Emphasize.yasnippet ;; # as in Snippets/Emphasize.yasnippet
;; `(yas/html-toggle-wrap yas/selected-text "em")` =yyas> (yas/unknown) ;; `(yas-html-toggle-wrap yas-selected-text "em")` =yyas> (yas-unknown)
;;
;; # as in Templates/HTML 4.0 Transitional/info.yasnippet
;; E6F19171-F664-4B4F-92DA-3E15E6CAD35C =yyas> (yas/unknown)
;;
;; # as in Snippets/XHTML form.yasnippet
;; ${TM_FILENAME/(.*?)\..*/$1_submit/} =yyas> (yas/unknown)
;;
;; # as in Snippets/XHTML body.yasnippet
;; ${TM_FILENAME/(.*)\..*/\L$1/} =yyas> (yas/unknown)
;;
;; # as in Commands/Insert Entity.yasnippet
;; 89E5CC0A-3EFF-4DEF-A299-2E9651DE6529 =yyas> (yas/unknown)
;;
;; # as in Commands/Convert to HTML Entities.yasnippet
;; 3DD8406C-A116-11D9-A5A2-000D93C8BE28 =yyas> (yas/unknown)
;;
;; # as in Commands/Persistent Include.yasnippet
;; 0D814247-7A00-46EE-A2A4-45FBBF4B1181 =yyas> (yas/unknown)
;;
;; # as in Commands/Refresh All Active Browsers.yasnippet
;; B8651C6E-A05E-11D9-86AC-000D93C8BE28 =yyas> (yas/unknown)
;;
;; # as in Snippets/Strong.yasnippet
;; `(yas/html-toggle-wrap yas/selected-text "strong")` =yyas> (yas/unknown)
;;
;; # as in Snippets/IE Conditional Comment Internet Explorer 5_5 only.yasnippet
;; `(or (yas/selected-text) " IE Conditional Comment: Internet Explorer 5.5 only ")` =yyas> (yas/unknown)
;;
;; # as in DragCommands/CSS Link.yasnippet
;; C8B717C2-6B33-11D9-BB47-000D93589AF6 =yyas> (yas/unknown)
;;
;; # as in Commands/Insert Close Tag.yasnippet
;; 0658019F-3635-462E-AAC2-74E4FE508A9B =yyas> (yas/unknown)
;;
;; # as in Commands/Decode Numeric URL Escapes in Line Selection.yasnippet
;; 2C4C9673-B166-432A-8938-75A5CA622481 =yyas> (yas/unknown)
;;
;; # as in Commands/Convert to named entities excl tags.yasnippet
;; 43C9E8AE-3E53-4B82-A1AF-56697BB3EF09 =yyas> (yas/unknown)
;;
;; # as in Commands/About Persistent Includes.yasnippet
;; 9AFDEB2C-D9F0-423E-8211-EBB089F51F0C =yyas> (yas/unknown)
;;
;; # as in Snippets/XHTML meta.yasnippet
;; `yas/html-xhtml-attr` =yyas> (yas/unknown)
;;
;; # as in Templates/HTML 4.0 Strict/info.yasnippet
;; 04332FA8-8157-46C4-9854-8C190FFD96C6 =yyas> (yas/unknown)
;;
;; # as in Macros/Delete whitespace between tags.yasnippet
;; 7B7E945E-A112-11D9-A5A2-000D93C8BE28 =yyas> (yas/unknown)
;;
;; # as in DragCommands/Anchor Tag.yasnippet
;; B23D6E15-6B33-11D9-86C1-000D93589AF6 =yyas> (yas/unknown)
;;
;; # as in Templates/XHTML 1.0 Transitional/info.yasnippet
;; 65D38039-6B0A-48E9-9E49-43832ECC4107 =yyas> (yas/unknown)
;;
;; # as in Snippets/XHTML title.yasnippet
;; ${TM_FILENAME/((.+)\..*)?/(?2:$2:Page Title)/} =yyas> (yas/unknown)
;;
;; # as in Commands/Tidy.yasnippet
;; 45F92B81-6F0E-11D9-A1E4-000D9332809C =yyas> (yas/unknown)
;;
;; # as in Commands/Strip HTML tags.yasnippet
;; 20D760B5-A127-11D9-A5A2-000D93C8BE28 =yyas> (yas/unknown)
;;
;; # as in Commands/Encrypt Line Selection (ROT 13).yasnippet
;; 9B13543F-8356-443C-B6E7-D9259B604927 =yyas> (yas/unknown)
;;
;; # as in Templates/XHTML 1.0 Strict/info.yasnippet
;; EBEE6B51-29C7-4362-818F-A190CACD5296 =yyas> (yas/unknown)
;;
;; # as in Commands/W3C validation.yasnippet
;; 3F26240E-6E4A-11D9-B411-000D93589AF6 =yyas> (yas/unknown)
;;
;; # as in Commands/Convert Line Selection to URL Escapes.yasnippet
;; 6B024865-6095-4CE3-8EDD-DC6F2230C2FF =yyas> (yas/unknown)
;;
;; # as in Commands/Update Includes.yasnippet
;; 4400BCE9-20E3-426E-B1D7-2C0BCA53BCF8 =yyas> (yas/unknown)
;;
;; # as in Commands/CodeCompletion HTML Attributes.yasnippet
;; CBD82CF3-74E9-4E7A-B3F6-9348754EB5AA =yyas> (yas/unknown)
;;
;; # as in Snippets/IE Conditional Comment Internet Explorer 6 and below.yasnippet
;; `(or (yas/selected-text) " IE Conditional Comment: Internet Explorer 6 and below ")` =yyas> (yas/unknown)
;;
;; # as in Snippets/IE Conditional Comment Internet Explorer 5_x.yasnippet
;; `(or (yas/selected-text) " IE Conditional Comment: Internet Explorer 5.x ")` =yyas> (yas/unknown)
;;
;; # as in DragCommands/Image Tag.yasnippet
;; CD6D2CC6-6B33-11D9-BDFD-000D93589AF6 =yyas> (yas/unknown)
;;
;; # as in Snippets/IE Conditional Comment NOT Internet Explorer.yasnippet
;; `(or (yas/selected-text) " IE Conditional Comment: NOT Internet Explorer ")` =yyas> (yas/unknown)
;; ;;
;; # as in Snippets/XHTML h1.yasnippet ;; # as in Snippets/XHTML h1.yasnippet
;; `yas/selected-text` =yyas> (yas/unknown) ;; `yas-selected-text` =yyas> (yas-unknown)
;; ;;
;; # as in Templates/XHTML 1.0 Frameset/info.yasnippet ;; # as in Snippets/IE Conditional Comment Internet Explorer 5_0 only.yasnippet
;; 26068A55-4C84-409D-BA00-162B55AF6961 =yyas> (yas/unknown) ;; `(or (yas-selected-text) " IE Conditional Comment: Internet Explorer 5.0 only ")` =yyas> (yas-unknown)
;; ;;
;; # as in Commands/Decode HTML Entities.yasnippet ;; # as in Snippets/IE Conditional Comment Internet Explorer 5_5 only.yasnippet
;; C183920D-A126-11D9-A5A2-000D93C8BE28 =yyas> (yas/unknown) ;; `(or (yas-selected-text) " IE Conditional Comment: Internet Explorer 5.5 only ")` =yyas> (yas-unknown)
;; ;;
;; # as in Snippets/IE Conditional Comment Internet Explorer 7+.yasnippet ;; # as in Snippets/IE Conditional Comment Internet Explorer 5_x.yasnippet
;; `(or (yas/selected-text) " IE Conditional Comment: Internet Explorer 7 and above ")` =yyas> (yas/unknown) ;; `(or (yas-selected-text) " IE Conditional Comment: Internet Explorer 5.x ")` =yyas> (yas-unknown)
;;
;; # as in Snippets/IE Conditional Comment Internet Explorer 6 and below.yasnippet
;; `(or (yas-selected-text) " IE Conditional Comment: Internet Explorer 6 and below ")` =yyas> (yas-unknown)
;; ;;
;; # as in Snippets/IE Conditional Comment Internet Explorer 6 only.yasnippet ;; # as in Snippets/IE Conditional Comment Internet Explorer 6 only.yasnippet
;; `(or (yas/selected-text) " IE Conditional Comment: Internet Explorer 6 only ")` =yyas> (yas/unknown) ;; `(or (yas-selected-text) " IE Conditional Comment: Internet Explorer 6 only ")` =yyas> (yas-unknown)
;;
;; # as in Snippets/IE Conditional Comment Internet Explorer 7+.yasnippet
;; `(or (yas-selected-text) " IE Conditional Comment: Internet Explorer 7 and above ")` =yyas> (yas-unknown)
;;
;; # as in Snippets/IE Conditional Comment Internet Explorer.yasnippet
;; `(or (yas-selected-text) " IE Conditional Comment: Internet Explorer ")` =yyas> (yas-unknown)
;;
;; # as in Snippets/IE Conditional Comment NOT Internet Explorer.yasnippet
;; `(or (yas-selected-text) " IE Conditional Comment: NOT Internet Explorer ")` =yyas> (yas-unknown)
;;
;; # as in Snippets/XHTML meta.yasnippet
;; `yas-html-xhtml-attr` =yyas> (yas-unknown)
;;
;; # as in Snippets/Strong.yasnippet
;; `(yas-html-toggle-wrap yas-selected-text "strong")` =yyas> (yas-unknown)
;;
;; # as in Commands/About Persistent Includes.yasnippet
;; 9AFDEB2C-D9F0-423E-8211-EBB089F51F0C =yyas> (yas-unknown)
;;
;; # as in Commands/CodeCompletion HTML Attributes.yasnippet
;; CBD82CF3-74E9-4E7A-B3F6-9348754EB5AA =yyas> (yas-unknown)
;;
;; # as in Commands/CodeCompletion HTML Tags.yasnippet
;; 3463E85F-F500-49A0-8631-D78ED85F9D60 =yyas> (yas-unknown)
;;
;; # as in Commands/Encrypt Line Selection (ROT 13).yasnippet
;; 9B13543F-8356-443C-B6E7-D9259B604927 =yyas> (yas-unknown)
;;
;; # as in Commands/Persistent Include.yasnippet
;; 0D814247-7A00-46EE-A2A4-45FBBF4B1181 =yyas> (yas-unknown)
;;
;; # as in Commands/Update Includes.yasnippet
;; 4400BCE9-20E3-426E-B1D7-2C0BCA53BCF8 =yyas> (yas-unknown)
;;
;; # as in Commands/Convert Line Selection to URL Escapes.yasnippet
;; 6B024865-6095-4CE3-8EDD-DC6F2230C2FF =yyas> (yas-unknown)
;;
;; # as in Commands/Convert to HTML Entities.yasnippet
;; 3DD8406C-A116-11D9-A5A2-000D93C8BE28 =yyas> (yas-unknown)
;;
;; # as in Commands/Convert to named entities excl tags.yasnippet
;; 43C9E8AE-3E53-4B82-A1AF-56697BB3EF09 =yyas> (yas-unknown)
;;
;; # as in Commands/Decode HTML Entities.yasnippet
;; C183920D-A126-11D9-A5A2-000D93C8BE28 =yyas> (yas-unknown)
;;
;; # as in Commands/Decode Numeric URL Escapes in Line Selection.yasnippet
;; 2C4C9673-B166-432A-8938-75A5CA622481 =yyas> (yas-unknown)
;;
;; # as in Commands/Insert Close Tag.yasnippet
;; 0658019F-3635-462E-AAC2-74E4FE508A9B =yyas> (yas-unknown)
;;
;; # as in Commands/Insert Entity.yasnippet
;; 89E5CC0A-3EFF-4DEF-A299-2E9651DE6529 =yyas> (yas-unknown)
;;
;; # as in Commands/Refresh All Active Browsers.yasnippet
;; B8651C6E-A05E-11D9-86AC-000D93C8BE28 =yyas> (yas-unknown)
;;
;; # as in Commands/Strip HTML tags.yasnippet
;; 20D760B5-A127-11D9-A5A2-000D93C8BE28 =yyas> (yas-unknown)
;;
;; # as in Commands/Tidy.yasnippet
;; 45F92B81-6F0E-11D9-A1E4-000D9332809C =yyas> (yas-unknown)
;;
;; # as in Commands/W3C validation.yasnippet
;; 3F26240E-6E4A-11D9-B411-000D93589AF6 =yyas> (yas-unknown)
;;
;; # as in DragCommands/Anchor Tag.yasnippet
;; B23D6E15-6B33-11D9-86C1-000D93589AF6 =yyas> (yas-unknown)
;;
;; # as in DragCommands/CSS Link.yasnippet
;; C8B717C2-6B33-11D9-BB47-000D93589AF6 =yyas> (yas-unknown)
;;
;; # as in DragCommands/Image Tag.yasnippet
;; CD6D2CC6-6B33-11D9-BDFD-000D93589AF6 =yyas> (yas-unknown)
;;
;; # as in Macros/Delete whitespace between tags.yasnippet
;; 7B7E945E-A112-11D9-A5A2-000D93C8BE28 =yyas> (yas-unknown)
;;
;; # as in Snippets/XHTML body.yasnippet
;; ${TM_FILENAME/(.*)\..*/\L$1/} =yyas> (yas-unknown)
;;
;; # as in Snippets/XHTML form.yasnippet
;; ${TM_FILENAME/(.*?)\..*/$1_submit/} =yyas> (yas-unknown)
;;
;; # as in Snippets/XHTML title.yasnippet
;; ${TM_FILENAME/((.+)\..*)?/(?2:$2:Page Title)/} =yyas> (yas-unknown)
;;
;; # as in Templates/HTML 4.0 Strict/info.yasnippet
;; 04332FA8-8157-46C4-9854-8C190FFD96C6 =yyas> (yas-unknown)
;;
;; # as in Templates/HTML 4.0 Transitional/info.yasnippet
;; E6F19171-F664-4B4F-92DA-3E15E6CAD35C =yyas> (yas-unknown)
;;
;; # as in Templates/XHTML 1.0 Frameset/info.yasnippet
;; 26068A55-4C84-409D-BA00-162B55AF6961 =yyas> (yas-unknown)
;;
;; # as in Templates/XHTML 1.0 Strict/info.yasnippet
;; EBEE6B51-29C7-4362-818F-A190CACD5296 =yyas> (yas-unknown)
;;
;; # as in Templates/XHTML 1.0 Transitional/info.yasnippet
;; 65D38039-6B0A-48E9-9E49-43832ECC4107 =yyas> (yas-unknown)
;;
;; # as in Templates/XHTML 1.1/info.yasnippet
;; CDE8EFD6-9DE2-4E8C-BB6A-52E8CCD2E977 =yyas> (yas-unknown)
;; ;;
;; ;;
;; Substitutions for: condition ;; Substitutions for: condition
;; ;;
;; # as in Snippets/XHTML head.yasnippet ;; # as in Templates/XHTML 1.1/info.yasnippet
;; text.html - text.html source =yyas> (yas/unknown) ;; text.html =yyas> (yas-unknown)
;; ;;
;; # as in Commands/CodeCompletion HTML Attributes.yasnippet ;; # as in Commands/CodeCompletion HTML Attributes.yasnippet
;; text.html punctuation.definition.tag -source, text.html meta.tag -entity.other.attribute-name -source =yyas> (yas/unknown) ;; text.html punctuation.definition.tag -source, text.html meta.tag -entity.other.attribute-name -source =yyas> (yas-unknown)
;;
;; # as in Snippets/Smart returnindent for tag pairs.yasnippet
;; meta.scope.between-tag-pair =yyas> (yas/unknown)
;; ;;
;; # as in Commands/CodeCompletion HTML Tags.yasnippet ;; # as in Commands/CodeCompletion HTML Tags.yasnippet
;; text.html -entity.other.attribute-name -string.quoted, invalid.illegal.incomplete.html =yyas> (yas/unknown) ;; text.html -entity.other.attribute-name -string.quoted, invalid.illegal.incomplete.html =yyas> (yas-unknown)
;;
;; # as in Snippets/Wrap Selection In Tag.yasnippet
;; text.html, =yyas> (yas/unknown)
;;
;; # as in Commands/Refresh All Active Browsers.yasnippet
;; text.html, source.css =yyas> (yas/unknown)
;;
;; # as in Templates/XHTML 1.1/info.yasnippet
;; text.html =yyas> (yas/unknown)
;; ;;
;; # as in Commands/Documentation for Tag.yasnippet ;; # as in Commands/Documentation for Tag.yasnippet
;; text.html, text.html entity.name.tag =yyas> (yas/unknown) ;; text.html, text.html entity.name.tag =yyas> (yas-unknown)
;; ;;
;; # as in Snippets/XHTML title.yasnippet ;; # as in Commands/Refresh All Active Browsers.yasnippet
;; text.html - text.blog =yyas> (yas/unknown) ;; text.html, source.css =yyas> (yas-unknown)
;;
;; # as in Snippets/Smart returnindent for tag pairs.yasnippet
;; meta.scope.between-tag-pair =yyas> (yas-unknown)
;;
;; # as in Snippets/Wrap Selection In Tag.yasnippet
;; text.html, =yyas> (yas-unknown)
;; ;;
;; # as in Snippets/Wrap in =.yasnippet ;; # as in Snippets/Wrap in =.yasnippet
;; text.html string =yyas> (yas/unknown) ;; text.html string =yyas> (yas-unknown)
;;
;; # as in Snippets/XHTML head.yasnippet
;; text.html - text.html source =yyas> (yas-unknown)
;;
;; # as in Snippets/XHTML title.yasnippet
;; text.html - text.blog =yyas> (yas-unknown)
;; ;;
;; ;;
;; Substitutions for: binding ;; Substitutions for: binding
;; ;;
;; # as in Commands/Persistent Include.yasnippet ;; # as in Commands/CodeCompletion HTML Tags.yasnippet
;; =yyas> (yas/unknown) ;; ~ =yyas> (yas-unknown)
;;
;; # as in Snippets/XHTML &nbsp NonBreakingSpace.yasnippet
;; ~ =yyas> (yas/unknown)
;;
;; # as in Snippets/Smart returnindent for tag pairs.yasnippet
;; =yyas> (yas/unknown)
;;
;; # as in Commands/W3C validation.yasnippet
;; ^V =yyas> (yas/unknown)
;;
;; # as in Commands/Insert Close Tag.yasnippet
;; ~@. =yyas> (yas/unknown)
;;
;; # as in Snippets/XHTML br.yasnippet
;; ^ =yyas> (yas/unknown)
;; ;;
;; # as in Commands/Insert Entity.yasnippet ;; # as in Commands/Insert Entity.yasnippet
;; @& =yyas> (yas/unknown) ;; @& =yyas> (yas-unknown)
;; ;;
;; # as in Commands/Refresh All Active Browsers.yasnippet ;; # as in Commands/Persistent Include.yasnippet
;; @r =yyas> (yas/unknown) ;; =yyas> (yas-unknown)
;;
;; # as in Commands/CodeCompletion HTML Tags.yasnippet
;; ~ =yyas> (yas/unknown)
;; ;;
;; # as in Commands/Update Includes.yasnippet ;; # as in Commands/Update Includes.yasnippet
;; ^@u =yyas> (yas/unknown) ;; ^@u =yyas> (yas-unknown)
;; ;;
;; # as in Macros/Delete whitespace between tags.yasnippet ;; # as in Commands/Insert Close Tag.yasnippet
;; ^~ =yyas> (yas/unknown) ;; ~@. =yyas> (yas-unknown)
;;
;; # as in Commands/Refresh All Active Browsers.yasnippet
;; @r =yyas> (yas-unknown)
;; ;;
;; # as in Commands/Tidy.yasnippet ;; # as in Commands/Tidy.yasnippet
;; ^H =yyas> (yas/unknown) ;; ^H =yyas> (yas-unknown)
;;
;; # as in Commands/W3C validation.yasnippet
;; ^V =yyas> (yas-unknown)
;;
;; # as in Macros/Delete whitespace between tags.yasnippet
;; ^~ =yyas> (yas-unknown)
;;
;; # as in Snippets/Smart returnindent for tag pairs.yasnippet
;; =yyas> (yas-unknown)
;;
;; # as in Snippets/XHTML &nbsp NonBreakingSpace.yasnippet
;; ~ =yyas> (yas-unknown)
;;
;; # as in Snippets/XHTML br.yasnippet
;; ^ =yyas> (yas-unknown)
;; ;;
;; ;;

38
extras/imported/objc-mode/.yas-setup.el
View File

@ -1,19 +1,19 @@
(defun yas/objc-docset-query (query) (defun yas-objc-docset-query (query)
) )
(defvar yas/objc-method-names (make-vector 1023 0)) (defvar yas-objc-method-names (make-vector 1023 0))
(defvar yas/objc-class-names (make-vector 1023 0)) (defvar yas-objc-class-names (make-vector 1023 0))
(defvar yas/objc-languages (list)) (defvar yas-objc-languages (list))
(defvar yas/objc-defkinds (list)) (defvar yas-objc-defkinds (list))
(defun yas/objc-extract-super-list () (defun yas-objc-extract-super-list ()
(interactive) (interactive)
(setq yas/objc-method-names (make-vector 1023 0) (setq yas-objc-method-names (make-vector 1023 0)
yas/objc-class-names (make-vector 1023 0) yas-objc-class-names (make-vector 1023 0)
yas/objc-languages (list) yas-objc-languages (list)
yas/objc-defkinds (list)) yas-objc-defkinds (list))
(with-temp-buffer (with-temp-buffer
(shell-command (shell-command
"/Developer/usr/bin/docsetutil dump -skip-text /Developer/Documentation/DocSets/com.apple.adc.documentation.AppleSnowLeopard.CoreReference.docset/" "/Developer/usr/bin/docsetutil dump -skip-text /Developer/Documentation/DocSets/com.apple.adc.documentation.AppleSnowLeopard.CoreReference.docset/"
@ -21,21 +21,21 @@
(goto-char (point-min)) (goto-char (point-min))
(search-forward-regexp "API index contains .* tokens") (search-forward-regexp "API index contains .* tokens")
(while (search-forward-regexp "^\\([^/]*\\)/\\([^/]*\\)/\\([^/]*\\)/\\([^/]*\\)$" nil 'noerror) (while (search-forward-regexp "^\\([^/]*\\)/\\([^/]*\\)/\\([^/]*\\)/\\([^/]*\\)$" nil 'noerror)
(intern (match-string 3) yas/objc-class-names) (intern (match-string 3) yas-objc-class-names)
(intern (match-string 4) yas/objc-method-names) (intern (match-string 4) yas-objc-method-names)
(add-to-list 'yas/objc-languages (match-string 1)) (add-to-list 'yas-objc-languages (match-string 1))
(add-to-list 'yas/objc-defkinds (match-string 2))))) (add-to-list 'yas-objc-defkinds (match-string 2)))))
;; (put (intern-soft (setq chosen (completing-read "Method: " yas/objc-method-names)) yas/objc-method-names) ;; (put (intern-soft (setq chosen (completing-read "Method: " yas-objc-method-names)) yas-objc-method-names)
;; 'someshit ;; 'someshit
;; 'someday) ;; 'someday)
;; (completing-read "Class: " yas/objc-class-names) ;; (completing-read "Class: " yas-objc-class-names)
;; (get (intern-soft (setq chosen (completing-read "hey: " yas/objc-method-names)) yas/objc-method-names) ;; (get (intern-soft (setq chosen (completing-read "hey: " yas-objc-method-names)) yas-objc-method-names)
;; 'someshit) ;; 'someshit)
(defun yas/objc-current-method-signature () (defun yas-objc-current-method-signature ()
(let ((orig-point (point)) (let ((orig-point (point))
(start-point nil) (start-point nil)
sig sig
@ -58,7 +58,7 @@
(concat (or sig "") (match-string-no-properties 0))))) (concat (or sig "") (match-string-no-properties 0)))))
sig)))) sig))))
(defun yas/objc-current-method-signature () (defun yas-objc-current-method-signature ()
(let ((orig-point (point)) (let ((orig-point (point))
(start-point nil) (start-point nil)
sig sig

1607
extras/imported/rails-mode/.yas-setup.el
View File

File diff suppressed because it is too large Load Diff

784
extras/imported/ruby-mode/.yas-setup.el
View File

File diff suppressed because it is too large Load Diff

34
extras/textmate_import.rb
View File

@ -39,7 +39,7 @@ Trollop::die :plist_file, "must exist" if opts.plist_file && File.directory?(opt
# Represents and is capable of outputting the representation of a # Represents and is capable of outputting the representation of a
# TextMate menu in terms of `yas/define-menu' # TextMate menu in terms of `yas-define-menu'
# #
class TmSubmenu class TmSubmenu
@ -74,22 +74,22 @@ class TmSubmenu
snippet = TmSnippet::snippets_by_uid[uuid] snippet = TmSnippet::snippets_by_uid[uuid]
unimplemented = TmSnippet::unknown_substitutions["content"][uuid] unimplemented = TmSnippet::unknown_substitutions["content"][uuid]
if submenu if submenu
str = "(yas/submenu " str = "(yas-submenu "
string += str + "\"" + submenu.name + "\"" string += str + "\"" + submenu.name + "\""
string += submenu.to_lisp(allsubmenus, deleteditems, string += submenu.to_lisp(allsubmenus, deleteditems,
indent + str.length + thingy[0].length) indent + str.length + thingy[0].length)
elsif snippet and not unimplemented elsif snippet and not unimplemented
string += ";; " + snippet.name + "\n" string += ";; " + snippet.name + "\n"
string += " " * (indent + thingy[0].length) string += " " * (indent + thingy[0].length)
string += "(yas/item \"" + uuid + "\")" string += "(yas-item \"" + uuid + "\")"
separator_useless = false; separator_useless = false;
elsif snippet and unimplemented elsif snippet and unimplemented
string += ";; Ignoring " + snippet.name + "\n" string += ";; Ignoring " + snippet.name + "\n"
string += " " * (indent + thingy[0].length) string += " " * (indent + thingy[0].length)
string += "(yas/ignore-item \"" + uuid + "\")" string += "(yas-ignore-item \"" + uuid + "\")"
separator_useless = true; separator_useless = true;
elsif (uuid =~ /---------------------/) elsif (uuid =~ /---------------------/)
string += "(yas/separator)" unless separator_useless string += "(yas-separator)" unless separator_useless
end end
first = false; first = false;
end end
@ -116,7 +116,7 @@ class TmSubmenu
"\"" + uuid + "\"" "\"" + uuid + "\""
end.join( "\n ") + "))" end.join( "\n ") + "))"
str = "(yas/define-menu " str = "(yas-define-menu "
return str + "'#{modename}" + root.to_lisp(all, return str + "'#{modename}" + root.to_lisp(all,
deleted, deleted,
str.length, str.length,
@ -144,13 +144,13 @@ class TmSnippet
"${TM_RAILS_TEMPLATE_START_RUBY_INLINE}" => "<% ", "${TM_RAILS_TEMPLATE_START_RUBY_INLINE}" => "<% ",
"${TM_RAILS_TEMPLATE_END_RUBY_INLINE}" => " -%>", "${TM_RAILS_TEMPLATE_END_RUBY_INLINE}" => " -%>",
"${TM_RAILS_TEMPLATE_END_RUBY_BLOCK}" => "end" , "${TM_RAILS_TEMPLATE_END_RUBY_BLOCK}" => "end" ,
"${0:$TM_SELECTED_TEXT}" => "${0:`yas/selected-text`}", "${0:$TM_SELECTED_TEXT}" => "${0:`yas-selected-text`}",
/\$\{(\d+)\}/ => "$\\1", /\$\{(\d+)\}/ => "$\\1",
"${1:$TM_SELECTED_TEXT}" => "${1:`yas/selected-text`}", "${1:$TM_SELECTED_TEXT}" => "${1:`yas-selected-text`}",
"${2:$TM_SELECTED_TEXT}" => "${2:`yas/selected-text`}", "${2:$TM_SELECTED_TEXT}" => "${2:`yas-selected-text`}",
'$TM_SELECTED_TEXT' => "`yas/selected-text`", '$TM_SELECTED_TEXT' => "`yas-selected-text`",
%r'\$\{TM_SELECTED_TEXT:([^\}]*)\}' => "`(or (yas/selected-text) \"\\1\")`", %r'\$\{TM_SELECTED_TEXT:([^\}]*)\}' => "`(or (yas-selected-text) \"\\1\")`",
%r'`[^`]+\n[^`]`' => Proc.new {|uuid, match| "(yas/multi-line-unknown " + uuid + ")"}}, %r'`[^`]+\n[^`]`' => Proc.new {|uuid, match| "(yas-multi-line-unknown " + uuid + ")"}},
"condition" => { "condition" => {
/^source\..*$/ => "" }, /^source\..*$/ => "" },
"binding" => {}, "binding" => {},
@ -239,7 +239,7 @@ class TmSnippet
%r'\$\{[^\d][^}]+\}', %r'\$\{[^\d][^}]+\}',
%r'`[^`]+`', %r'`[^`]+`',
%r'\$TM_[\w_]+', %r'\$TM_[\w_]+',
%r'\(yas/multi-line-unknown [^\)]*\)' %r'\(yas-multi-line-unknown [^\)]*\)'
].each do |reg| ].each do |reg|
ct.scan(reg) do |match| ct.scan(reg) do |match|
@@unknown_substitutions["content"][match] = self @@unknown_substitutions["content"][match] = self
@ -249,7 +249,7 @@ class TmSnippet
else else
@@unknown_substitutions["content"][uuid] = self @@unknown_substitutions["content"][uuid] = self
TmSubmenu::excluded_items.push(uuid) TmSubmenu::excluded_items.push(uuid)
return "(yas/unimplemented)" return "(yas-unimplemented)"
end end
end end
end end
@ -264,7 +264,7 @@ class TmSnippet
doc << (self.binding || "") doc << (self.binding || "")
doc << (self.condition || "") doc << (self.condition || "")
doc << "# --\n" doc << "# --\n"
doc << (self.content || "(yas/unimplemented)") doc << (self.content || "(yas-unimplemented)")
doc doc
end end
@ -383,7 +383,7 @@ if __FILE__ == $PROGRAM_NAME
lookfor.gsub!(/^[ ]*/, "") lookfor.gsub!(/^[ ]*/, "")
lookfor.gsub!(/[ ]*$/, "") lookfor.gsub!(/[ ]*$/, "")
# puts "found this wonderful substitution for #{directive} which is #{lookfor} => #{replacewith}" # puts "found this wonderful substitution for #{directive} which is #{lookfor} => #{replacewith}"
unless !directive or replacewith =~ /yas\/unknown/ then unless !directive or replacewith =~ /yas-unknown/ then
TmSnippet.extra_substitutions[directive][lookfor] = replacewith TmSnippet.extra_substitutions[directive][lookfor] = replacewith
end end
end end
@ -456,7 +456,7 @@ if __FILE__ == $PROGRAM_NAME
unknown = TmSnippet::unknown_substitutions[type]; unknown = TmSnippet::unknown_substitutions[type];
unknown.keys.uniq.each do |k| unknown.keys.uniq.each do |k|
file.puts ";; # as in " + unknown[k].yas_file file.puts ";; # as in " + unknown[k].yas_file
file.puts ";; " + k + "" + (" " * [1, 90-k.length].max) + " =yyas> (yas/unknown)" file.puts ";; " + k + "" + (" " * [1, 90-k.length].max) + " =yyas> (yas-unknown)"
file.puts ";; " file.puts ";; "
end end
file.puts ";; " file.puts ";; "

4
snippets/c++-mode/class
View File

@ -4,6 +4,6 @@
class ${1:Name} class ${1:Name}
{ {
public: public:
${1:$(yas/substr text "[^: ]*")}($2); ${1:$(yas-substr text "[^: ]*")}($2);
virtual ~${1:$(yas/substr text "[^: ]*")}(); virtual ~${1:$(yas-substr text "[^: ]*")}();
}; };

99
yasnippet-debug.el
View File

@ -1,8 +1,8 @@
;;; yasnippet-debug.el --- debug functions for yasnippet ;;; yasnippet-debug.el --- debug functions for yasnippet
;; Copyright (C) 2010 João Távora ;; Copyright (C) 2010 João Távora
;; Author: João Távora(defun yas/debug-snippet-vars () <joaotavora@gmail.com> ;; Author: João Távora
;; Keywords: emulations, convenience ;; Keywords: emulations, convenience
;; This program is free software; you can redistribute it and/or modify ;; This program is free software; you can redistribute it and/or modify
@ -26,7 +26,7 @@
(require 'yasnippet) (require 'yasnippet)
(defun yas/debug-snippet-vars () (defun yas-debug-snippet-vars ()
"Debug snippets, fields, mirrors and the `buffer-undo-list'." "Debug snippets, fields, mirrors and the `buffer-undo-list'."
(interactive) (interactive)
(with-output-to-temp-buffer "*YASnippet trace*" (with-output-to-temp-buffer "*YASnippet trace*"
@ -35,39 +35,39 @@
(princ (format "\nPost command hook: %s\n" post-command-hook)) (princ (format "\nPost command hook: %s\n" post-command-hook))
(princ (format "\nPre command hook: %s\n" pre-command-hook)) (princ (format "\nPre command hook: %s\n" pre-command-hook))
(princ (format "%s live snippets in total\n" (length (yas/snippets-at-point (quote all-snippets))))) (princ (format "%s live snippets in total\n" (length (yas--snippets-at-point (quote all-snippets)))))
(princ (format "%s overlays in buffer:\n\n" (length (overlays-in (point-min) (point-max))))) (princ (format "%s overlays in buffer:\n\n" (length (overlays-in (point-min) (point-max)))))
(princ (format "%s live snippets at point:\n\n" (length (yas/snippets-at-point)))) (princ (format "%s live snippets at point:\n\n" (length (yas--snippets-at-point))))
(dolist (snippet (yas/snippets-at-point)) (dolist (snippet (yas--snippets-at-point))
(princ (format "\tsid: %d control overlay from %d to %d\n" (princ (format "\tsid: %d control overlay from %d to %d\n"
(yas/snippet-id snippet) (yas--snippet-id snippet)
(overlay-start (yas/snippet-control-overlay snippet)) (overlay-start (yas--snippet-control-overlay snippet))
(overlay-end (yas/snippet-control-overlay snippet)))) (overlay-end (yas--snippet-control-overlay snippet))))
(princ (format "\tactive field: %d from %s to %s covering \"%s\"\n" (princ (format "\tactive field: %d from %s to %s covering \"%s\"\n"
(yas/field-number (yas/snippet-active-field snippet)) (yas--field-number (yas--snippet-active-field snippet))
(marker-position (yas/field-start (yas/snippet-active-field snippet))) (marker-position (yas--field-start (yas--snippet-active-field snippet)))
(marker-position (yas/field-end (yas/snippet-active-field snippet))) (marker-position (yas--field-end (yas--snippet-active-field snippet)))
(buffer-substring-no-properties (yas/field-start (yas/snippet-active-field snippet)) (yas/field-end (yas/snippet-active-field snippet))))) (buffer-substring-no-properties (yas--field-start (yas--snippet-active-field snippet)) (yas--field-end (yas--snippet-active-field snippet)))))
(when (yas/snippet-exit snippet) (when (yas--snippet-exit snippet)
(princ (format "\tsnippet-exit: at %s next: %s\n" (princ (format "\tsnippet-exit: at %s next: %s\n"
(yas/exit-marker (yas/snippet-exit snippet)) (yas--exit-marker (yas--snippet-exit snippet))
(yas/exit-next (yas/snippet-exit snippet))))) (yas--exit-next (yas--snippet-exit snippet)))))
(dolist (field (yas/snippet-fields snippet)) (dolist (field (yas--snippet-fields snippet))
(princ (format "\tfield: %d from %s to %s covering \"%s\" next: %s%s\n" (princ (format "\tfield: %d from %s to %s covering \"%s\" next: %s%s\n"
(yas/field-number field) (yas--field-number field)
(marker-position (yas/field-start field)) (marker-position (yas--field-start field))
(marker-position (yas/field-end field)) (marker-position (yas--field-end field))
(buffer-substring-no-properties (yas/field-start field) (yas/field-end field)) (buffer-substring-no-properties (yas--field-start field) (yas--field-end field))
(yas/debug-format-fom-concise (yas/field-next field)) (yas--debug-format-fom-concise (yas--field-next field))
(if (yas/field-parent-field field) "(has a parent)" ""))) (if (yas--field-parent-field field) "(has a parent)" "")))
(dolist (mirror (yas/field-mirrors field)) (dolist (mirror (yas--field-mirrors field))
(princ (format "\t\tmirror: from %s to %s covering \"%s\" next: %s\n" (princ (format "\t\tmirror: from %s to %s covering \"%s\" next: %s\n"
(marker-position (yas/mirror-start mirror)) (marker-position (yas--mirror-start mirror))
(marker-position (yas/mirror-end mirror)) (marker-position (yas--mirror-end mirror))
(buffer-substring-no-properties (yas/mirror-start mirror) (yas/mirror-end mirror)) (buffer-substring-no-properties (yas--mirror-start mirror) (yas--mirror-end mirror))
(yas/debug-format-fom-concise (yas/mirror-next mirror))))))) (yas--debug-format-fom-concise (yas--mirror-next mirror)))))))
(princ (format "\nUndo is %s and point-max is %s.\n" (princ (format "\nUndo is %s and point-max is %s.\n"
(if (eq buffer-undo-list t) (if (eq buffer-undo-list t)
@ -80,49 +80,48 @@
(dolist (undo-elem first-ten) (dolist (undo-elem first-ten)
(princ (format "%2s: %s\n" (position undo-elem first-ten) (truncate-string-to-width (format "%s" undo-elem) 70)))))))) (princ (format "%2s: %s\n" (position undo-elem first-ten) (truncate-string-to-width (format "%s" undo-elem) 70))))))))
(defun yas/debug-format-fom-concise (fom) (defun yas--debug-format-fom-concise (fom)
(when fom (when fom
(cond ((yas/field-p fom) (cond ((yas--field-p fom)
(format "field %d from %d to %d" (format "field %d from %d to %d"
(yas/field-number fom) (yas--field-number fom)
(marker-position (yas/field-start fom)) (marker-position (yas--field-start fom))
(marker-position (yas/field-end fom)))) (marker-position (yas--field-end fom))))
((yas/mirror-p fom) ((yas--mirror-p fom)
(format "mirror from %d to %d" (format "mirror from %d to %d"
(marker-position (yas/mirror-start fom)) (marker-position (yas--mirror-start fom))
(marker-position (yas/mirror-end fom)))) (marker-position (yas--mirror-end fom))))
(t (t
(format "snippet exit at %d" (format "snippet exit at %d"
(marker-position (yas/fom-start fom))))))) (marker-position (yas--fom-start fom)))))))
(defun yas/exterminate-package () (defun yas-exterminate-package ()
(interactive) (interactive)
(yas/global-mode -1) (yas-global-mode -1)
(yas/minor-mode -1) (yas-minor-mode -1)
(mapatoms #'(lambda (atom) (mapatoms #'(lambda (atom)
(when (string-match "yas/" (symbol-name atom)) (when (string-match "yas[-/]" (symbol-name atom))
(unintern atom))))) (unintern atom obarray)))))
(defun yas/debug-test (&optional quiet) (defun yas-debug-test (&optional quiet)
(interactive "P") (interactive "P")
(yas/load-directory (or (and (listp yas/snippet-dirs) (yas-load-directory (or (and (listp yas-snippet-dirs)
(first yas/snippet-dirs)) (first yas-snippet-dirs))
yas/snippet-dirs yas-snippet-dirs
"~/Source/yasnippet/snippets/")) "~/Source/yasnippet/snippets/"))
(set-buffer (switch-to-buffer "*YAS TEST*")) (set-buffer (switch-to-buffer "*YAS TEST*"))
(mapc #'yas/commit-snippet (yas/snippets-at-point 'all-snippets)) (mapc #'yas--commit-snippet (yas--snippets-at-point 'all-snippets))
(erase-buffer) (erase-buffer)
(setq buffer-undo-list nil) (setq buffer-undo-list nil)
(setq undo-in-progress nil) (setq undo-in-progress nil)
(snippet-mode) (snippet-mode)
(yas/minor-mode 1) (yas-minor-mode 1)
(let ((abbrev)) (let ((abbrev))
(setq abbrev "$f") (setq abbrev "$f")
(insert abbrev)) (insert abbrev))
(unless quiet (unless quiet
(add-hook 'post-command-hook 'yas/debug-snippet-vars 't 'local))) (add-hook 'post-command-hook 'yas-debug-snippet-vars 't 'local)))
(provide 'yasnippet-debug) (provide 'yasnippet-debug)
;;; yasnippet-debug.el ends here ;;; yasnippet-debug.el ends here

540
yasnippet-tests.el
View File

File diff suppressed because one or more lines are too long

3163
yasnippet.el
View File

File diff suppressed because it is too large Load Diff