Drop use of `yas--version' in doc/yas-doc-helper.el

- No longer available since 0.14.3

.gitignore

@@ -1,6 +1,7 @@
 authors.txt
 doc/gh-pages
 doc/*.html
+doc/html-revision
 pkg/
 extras/imported/**
 !extras/imported/*/.yas-setup.el
@@ -8,3 +9,7 @@ extras/imported/**
 *.elc
 ert-x.*
 ert.*
+
+# ELPA-generated files
+/yasnippet-autoloads.el
+/yasnippet-pkg.el

.gitmodules

@@ -1,9 +0,0 @@
-[submodule "extras/bundles/ruby-tmbundle"]
-	path = extras/bundles/ruby-tmbundle
-	url = http://github.com/drnic/ruby-tmbundle.git
-[submodule "extras/bundles/html-tmbundle"]
-	path = extras/bundles/html-tmbundle
-	url = http://github.com/drnic/html-tmbundle.git
-[submodule "extras/bundles/rails-tmbundle"]
-	path = extras/bundles/rails-tmbundle
-	url = http://github.com/drnic/ruby-on-rails-tmbundle.git

.travis.yml

@@ -0,0 +1,49 @@
+language: generic
+os: linux
+dist: xenial
+
+git:
+  submodules: false
+
+env:
+  global:
+    - Wlexical=t
+    - Werror=t
+    - tests_Werror=t # For yasnippet-tests.el
+  jobs:
+    - EMACS_VERSION=23.4
+    # 24.3 gives a bunch of 'value returned from (car value-N) is
+    # unused' warnings.
+    - EMACS_VERSION=24.3 tests_Werror=nil
+    - EMACS_VERSION=24.5
+    - EMACS_VERSION=25.3
+    - EMACS_VERSION=26.3
+    - EMACS_VERSION=27-prerelease
+
+
+install:
+  - curl -LO https://github.com/npostavs/emacs-travis/releases/download/bins/emacs-bin-${EMACS_VERSION}.tar.gz
+  - tar -xaf emacs-bin-${EMACS_VERSION}.tar.gz -C /
+  # Configure $PATH: Emacs installed to /tmp/emacs
+  - export PATH=/tmp/emacs/bin:${PATH}
+  - if ! emacs -Q --batch --eval "(require 'cl-lib)" ; then
+        curl -Lo cl-lib.el http://elpa.gnu.org/packages/cl-lib-0.6.1.el ;
+        export warnings="'(not cl-functions)" ;
+    fi
+  - if ! emacs -Q --batch --eval "(require 'ert)" ; then
+        curl -LO https://raw.githubusercontent.com/ohler/ert/c619b56c5bc6a866e33787489545b87d79973205/lisp/emacs-lisp/ert.el &&
+        curl -LO https://raw.githubusercontent.com/ohler/ert/c619b56c5bc6a866e33787489545b87d79973205/lisp/emacs-lisp/ert-x.el ;
+    fi
+  - emacs --version
+
+script:
+  - rake yasnippet.elc
+  - rake yasnippet-debug.elc
+  - rake yasnippet-tests.elc Werror=$tests_Werror
+  - rake tests
+
+notifications:
+  email:
+    # Default is change, but that includes a new branch's 1st success.
+    on_success: never
+    on_failure: always # The default.

CONTRIBUTING.md

@@ -0,0 +1,37 @@
+# Submitting Bug Reports or Patches
+
+As a GNU ELPA package, bugs or patches may be submitted to the main
+Emacs bug list, bug-gnu-emacs@gnu.org.  Alternatively, you may use the
+[Github issue tracker][issues].
+
+Please read [Important note regarding bug reporting][bugnote].
+
+# Contributing to Yasnippet
+
+## Copyright Assignment
+
+Yasnippet is part of GNU ELPA, so it falls under the same copyright
+assignment policy as the rest of Emacs (see "Copyright Assignment" in
+https://www.gnu.org/software/emacs/CONTRIBUTE).  A copyright assignment
+for Emacs also covers Yasnippet.
+
+## Commit message format
+
+The commit message format roughly follows Emacs conventions.  There is
+no separate Changelog file.
+
+    Capitalize the first sentence, no period at the end
+
+    Please make sure the summary line can be understood without having
+    to lookup bug numbers.  It may be followed by a paragraph with a
+    longer explanation.  The changelog style entry goes at the end of
+    the message.
+    * foo.el (a-function): Terse summary of per-function changes.  Use
+    double spacing between sentences (set `sentence-end-double-space'
+    to t).
+
+For trivial changes, a message consisting of just the changelog entry
+(e.g., `* foo.el (a-function): Fix docstring typo.`) is fine.
+
+[bugnote]: https://github.com/joaotavora/yasnippet#important-note-regarding-bug-reporting
+[issues]: https://github.com/joaotavora/yasnippet/issues

Makefile

@@ -0,0 +1,46 @@
+### Makefile for Yasnippet (stolen from Eglot)
+# Variables
+#
+EMACS?=emacs
+SELECTOR?=t
+ERROR_ON_WARN=nil
+
+LOAD_PATH=-L .
+
+ELFILES := yasnippet.el yasnippet-tests.el
+ELCFILES := $(ELFILES:.el=.elc)
+
+BYTECOMP_ERROR_ON_WARN := \
+	--eval '(setq byte-compile-error-on-warn $(ERROR_ON_WARN))'
+
+all: compile
+
+%.elc: %.el
+	$(EMACS) -Q $(BYTECOMP_ERROR_ON_WARN) $(LOAD_PATH) \
+		--batch -f batch-byte-compile $<
+
+compile: $(ELCFILES)
+
+# Automated tests
+#
+yasnippet-check: compile
+	$(EMACS) -Q --batch						\
+		$(LOAD_PATH)						\
+		-l yasnippet						\
+		-l yasnippet-tests						\
+		--eval '(setq ert-batch-backtrace-right-margin 200)'	\
+		--eval '(ert-run-tests-batch-and-exit (quote $(SELECTOR)))'
+
+interactive: compile
+	$(EMACS) -Q							\
+		$(LOAD_PATH)						\
+		-l yasnippet						\
+		-l yasnippet-tests						\
+
+check: yasnippet-check
+
+# Cleanup
+#
+clean:
+	find . -iname '*.elc' -exec rm {} \;
+.PHONY: all compile clean check

NEWS

@@ -0,0 +1,574 @@
+Yasnippet NEWS -- history of user-visible changes.
+
+Copyright (C) 2017-2025 Free Software Foundation, Inc.
+See the end of the file for license conditions.
+
+Changes since 0.14.0:
+
+- Silence warning about missing lexical-binding cookie.
+- Bug fixes and code cleanups.
+- Accept ${N} as another syntax for $N (issue #1012).
+- Understand the new AUCTeX modes hierarchy (issue #1193).
+- Try and use `major-mode-remap-alist` to find the right snippets for
+  Tree Sitter modes (issue #1169).
+
+* 0.14.0 (Dec 22, 2019)
+
+** Changes
+
+*** New 'yas-auto-next' macro, automatically moves to next field.
+See Github #937.
+
+*** Yasnippet now officially requires Emacs 23 or greater.
+See Github #940.
+
+*** Snippets for 'fundamental-mode' are available in all modes.
+See Github #949, and #936.
+
+*** New function for snippets, 'yas-completing-read'.
+See Github #934.
+
+*** New function 'yas-maybe-expand-abbrev-key-filter'.
+This can be used for making conditional keybindings for snippets.
+Promoted from 'yas--maybe-expand-key-filter'.  See Github #943.
+
+*** DEL can now be used to clear fields, similar <delete>.
+It is bound to the new conditional command 'yas-maybe-clear-field', which may
+be bound to other keys as well.  See Github #960 and #957.
+
+*** Snippet field movement commands may now trigger eldoc.
+See Github #952.
+
+*** New variable 'yas-keymap-disable-hook'.
+Can be used (e.g., for company-mode) to temporarily disable
+'yas-keymap' bindings, or any binding made by the new function
+'yas-filtered-definition'.  See Github #987.
+
+*** New variable 'yas-inhibit-overlay-modification-protection'.
+This allows a snippet to remain active, even if some commands make
+modifications outside the expected area (i.e., the active snippet
+field).
+
+*** 'yas-minor-mode' is no longer enabled in temp buffers.
+That is, buffers whose name starts with a space.  This setting may be
+undone by removing 'yas-temp-buffer-p' from
+'yas-dont-activate-functions'.  See Github #985.
+
+*** Accept unescaped '{', for LSP compatibility.
+See Github #979.
+
+** Fixed bugs
+
+*** 'yas-not-string-or-comment-condition' no longer relies on 'this-command'.
+This lets it work correctly with conditional key-bindings.  See Github
+#973, #991.
+
+*** Fix snippet expansion in org src buffers.
+Note that this still doesn't work in text-mode blocks.
+See Github #976, #989.
+
+*** Fix snippet insertion for keyless snippets.
+See Github #1014.
+
+*** Fix errors with company-mode completion within snippet fields.
+See Github #995.
+
+*** Fix errors with cc-mode.
+See Github #962.
+
+*** Fix problems with lsp-mode.
+**** Improve performance in overlay heavy buffers (Github #926).
+**** Fix double call of 'before/after-change-functions' (Github #966).
+
+*** Fix errors with nested snippet expansion.
+See Github #961, #1002.
+
+*** Stop yas-field-highlight-face inheriting from bogus 'quote' face.
+
+
+* 0.13.0 (May 13, 2018)
+
+** Changes
+
+*** Snippets for Yasnippet must now be installed separately.  The
+submodule linking to yasnippet-snippets was removed, as were the
+"classic" snippets that came with the GNU ELPA package.  The latter
+can now be installed via the 'yasnippet-classic-snippets' package from
+GNU ELPA.
+See Github #848, #858, #834, #775.
+
+*** 'snippet-mode' no longer derives from 'text-mode'.
+It will derive from 'prog-mode' where available (Emacs 24.1 and newer)
+or 'fundamental-mode' otherwise.  See Github #826.
+
+*** The default value of 'yas-key-syntaxes' is changed
+Longer snippet abbrev keys are now preferred over shorter ones.
+See Github #805.
+
+*** New snippets are now created for the current major mode by default
+Previously, extra activated modes could be guessed first.
+See Github #875.
+
+*** Yasnippet supports 'unload-feature' via 'yasnippet-unload-function'
+See Github #753, #891.
+
+*** New command 'yas-skip-and-clear-field' conditionally bound to 'C-d'
+replaces obsoleted 'yas-skip-and-clear-or-delete-char'.  The new
+function may be bound to any key via the conditional binding value
+'yas-maybe-skip-and-clear-field', instead of hardcoding the
+'delete-char' fallback action.  See Github #408, #892.
+
+*** 'yas-lookup-snippet' now returns a struct
+This allows 'yas-expand-snippet' to take looked up snippet's
+environment into account.  'yas-expand-snippet' handles both
+structured snippets, and plain text snippet bodies.
+See Github #897.
+
+** Fixed bugs
+
+*** Avoid crashing due to Emacs Bug#30931
+This prevents yasnippet's routines from triggering the bug, although
+it is still possible to trigger it independently.
+
+*** Don't enable undo when it's disabled
+
+*** yas-also-auto-indent-first-line is once again respected
+Yasnippet was behaving as if it was always t for single line snippets.
+See Github #912.
+
+*** Fixed handling of fixed indent with fields at beginning of line
+See Github #906, #908.
+
+*** Fixed incorrect snippets leaving "bad memory"
+and possibly corrupting future expansions.
+See Github #800.
+
+*** 'global-whitespace-mode' now functions in new snippet buffers.
+To fix this, the buffer name for new snippet buffers is now '+new
+snippet+' instead of '*new snippet*'.  See Github #842.
+
+*** Nest snippet expansion may clear default field text
+See Github #844.
+
+*** Fixed undo list corruption snippet expand+indent.
+See Github #869.
+
+*** The '# --' marker in snippets now allows trailing whitespace.
+See Github #862.
+
+*** Fixed handling of nested simple $n fields
+See Github #824, #894.
+
+
+* 0.12.2 (Aug 28, 2017)
+
+** The new option 'yas-also-auto-indent-empty-lines' allows restoring
+the old indent behavior.  See Github #850, #710, #685, #679.
+
+** Keybinding triggered snippets once again deactivate the mark.
+See Github #840.
+
+
+* 0.12.1 (Jul 23, 2017)
+
+This is a quick bugfix release.
+
+** Compilation errors in yasnippet-tests.el and yasnippet-debug.el are fixed.
+
+** A snippet-local setting of 'yas-indent-line' is now respected
+during indentation triggered by auto-fill as well.  See Github #838.
+
+
+* 0.12.0 (Jul 17, 2017)
+
+** Changes and New Features
+
+*** Snippets can now expand in strings & comments by default again.
+'yas-buffer-local-condition' is now a defcustom See Github #774.
+
+*** 'yas-after-exit-snippet-hook' can now be bound in 'expand-env' of
+snippets.  See Github #28, #702, #779, #786.
+
+*** Snippets under directories in 'yas-snippet-dirs' are now in
+snippet-mode automatically.
+
+*** Snippets can now be expanded in org source blocks, if
+'org-src-tab-acts-natively' and 'org-src-fontify-natively' are set.
+See Github #761.
+
+*** 'yas-fallback-behavior' is now obsolete, 'yas-expand' is now bound
+conditionally with an extended menu item, 'yas-maybe-expand'.
+Therefore users wanting to bind 'yas-expand' to a different key, SPC
+for example, should do
+
+    (define-key yas-minor-mode-map (kbd "SPC") yas-maybe-expand)
+
+See Github #760, #808.
+
+*** The documentation build output is now reproducible.  The timestamp
+now depends on the commit date, or the environment variable
+SOURCE_DATE_EPOCH is that is set.
+
+*** 'yas-indent-line' and 'expand-env' are now respected during mirror
+updates.  See Github #743.
+
+*** New function 'yas-active-snippets'.  Renamed from
+'yas--snippets-at-point', which remains as an obsolete alias.  See
+Github #727.
+
+*** New custom option 'yas-overlay-priority'.  This is can be used to
+give the snippet navigation keymaps higher priority than keymaps from
+overlays created by other packages, like 'auto-complete'.  See Github
+#828.
+
+** Fixed bugs
+
+*** Snippets having ${0:soon-to-be-deleted} with no other fields now
+correctly put the field 0 text in the active region after exiting.
+See Github #653.
+
+*** Fix undo of snippet insertion which also triggers indentation.
+See Github #821.
+
+*** Fixed a bug causing whitespace loss between mirrors.
+
+*** Fixed several bugs causing problems when combining Yasnippet with
+other modes and packages, like 'auto-fill-mode', 'c++-mode',
+'rust-mode', and 'lentic'.
+
+**** Fix another bug with auto-fill-mode.
+See Github #784, #794.
+
+**** Fix a bug in parsing of snippet fields for modes that use the
+'syntax-table' text property, 'c++-mode' is one example of this.  See
+Github #815.
+
+**** 'syntax-propertize-function' is now restored before indenting the
+snippet.  This improves compatibility with modes which rely on it for
+indentation, like 'rust-mode'.  See Github #782, #818.
+
+**** Avoid trying to delete a snippet which is already deleted.  This
+prevents an error when using 'rust-mode's 'rust-format-buffer'
+command.
+
+**** Ensure inhibit-modification-hooks is nil while modifying buffer.
+This fixes problems for packages relying on modification hooks, like
+'lentic'.  See Github #756, #712.
+
+
+* 0.11.0 (Oct 26, 2016)
+** Changes and New Features
+
+*** Modifying buffer in backquoted expressions is deprecated!
+Backquoted expressions should only return a string that will be
+inserted.  Snippets which modify the buffer as a side-effect will now
+trigger a warning.
+
+*** The verbosity levels for messages have been adjusted.
+While the default verbosity level was increased by 1 (it was only
+lower before due to a bug), several messages now only print at the
+level 4, so the overall effect should be less messages by default.
+
+*** Saving and loading snippets has been streamlined.  Saving the
+snippet to a file will now automatically load it.  Additionally, the
+buffer will be renamed from "*new snippet*" to whatever the snippet is
+named.  See also Github #718, #733, and #734.
+
+*** `yas-escape-text' no longer signals an error when given nil.
+
+*** `yas-describe-tables' is split into simpler commands.
+**** `yas-describe-tables' takes a prefix arg to show non-active tables.
+**** New command `yas-describe-tables-by-namehash' shows table by namehash.
+
+*** Use the region contents as the snippet body of new snippets.
+
+*** The dependency on `cl' is removed.
+Yasnippet now only requires `cl-lib'.
+
+** Fixed Bugs
+
+*** Fix field navigation (tabbing) in the backwards direction.
+See Github #722
+
+*** Add support for deprecated yas/ symbols in `yas-define-menu'.
+It was left out by accident.  This support is conditional on
+`yas-alias-to-yas/prefix-p', just like other obsolete yas/ bindings.
+
+*** Fix overriding of snippet by a new snippet with same uuid.
+See Github #714.
+
+*** Fix handling of snippets with 2 mirros on the same line.
+See Github #712.
+
+
+* 0.10.0 (June 11th, 2016)
+
+** Changes and New Features
+
+*** Yasnippet now prints far fewer message by default.
+See Github #682, #683.
+
+*** `yas-wrap-around-region' can be set to a register.
+The register's content will be used.  This is like the old `cua'
+option, but can be used with any register and doesn't require enabling
+cua-mode.
+
+*** Clearing of snippet fields is now decided by the command's effect.
+The `delete-selection' property is no longer consulted.  See Github #662.
+
+*** Empty lines in snippet expansion are no longer indented.
+See Github #679.
+
+*** All lines from mirror output are now indented.
+See Github #665.
+
+*** New variable yas-alias-to-yas/prefix-p
+See Github #696, #699.
+
+*** New function yas-next-field-will-exit-p
+See Github #561.
+
+*** `snippet-mode' is now autoloaded.
+
+** Fixed Bugs
+
+*** Fix incompatibility with Emacs 25 and haskell-mode.
+This should also help other modes with a non-nil syntax-propertize
+function.  See Github #687.
+
+*** Text property changes no longer disable snippets.
+This prevents cc-mode based modes from causing premature exit of
+snippets.  See Github #677.
+
+*** Fields are now transformed correctly after `yas-next-field'.
+See Github #381.
+
+*** The $> construct is now escaped correctly, and documented.
+See Github #640.
+
+*** Avoid corruption of snippet content when loading from files.
+See Github #707 and Emacs bug #23659.
+
+*** `yas-wrap-around-region' now works for snippets with fields
+farther down the buffer than $0.  See Github #636.
+
+*** The active region is deleted when using `yas-expand'.
+This makes it consistent with `yas-insert-snippet'.  See Github #523.
+
+*** Fix mirror+autofill interaction.
+See Github #643 and http://emacs.stackexchange.com/q/19206/5296.
+
+*** Snippet insertion no longer adds irrelevant strings to kill ring.
+See Github #675.
+
+
+* 0.9.1 (April 3rd, 2016)
+
+** Changes and New Features
+
+*** Noam Postavsky is now the official yasnippet maintainer.
+
+*** `yas-visit-snippet-file' now works for compiled snippets (see Github #597).
+
+*** New function `yas-lookup-snippet' (see Github #595, #596).
+
+*** .emacs.d/snippets directory is now created automatically.
+If that value is present in `yas-snippet-dirs' (see Github #648).
+
+*** Default value for `yas-snippet-dirs' now uses `user-emacs-directory'
+instead of hardcoding "~/emacs.d" (see Github #632).
+
+*** `yas-visit-snippet-file' no longer overrides `yas-prompt-functions',
+see Github #576.
+
+*** The defaults for prompting have changed.
+`yas-x-prompt' is no longer present in the default value of
+`yas-prompt-functions'.
+
+The new function `yas-maybe-ido-prompt' (which performs ido prompting
+if `ido-mode' is enabled) replaces `yas-ido-prompt' (which always
+performs ido prompting).  Previously the behaviour was dependent on
+the Emacs version being used.
+
+*** The default value of `yas-buffer-local-condition' now works for `yas-insert-snippet' too.
+See Github #305.
+
+*** The default value of `yas-new-snippet-default' no longer inserts `require-final-newline: nil'.
+It was redundant, since `mode: snippet' already accomplishes the same.
+`binding: ${4:direct-keybinding}}' is also removed, as it is hardly
+ever wanted.
+
+*** Snippet fields are only cleared by commands with `delete-selection' property,
+See Github #515, #644.
+
+*** `yas-initialize' (and backward compat alias `yas/initialize') are restored,
+but marked obsolete, use (yas-global-mode +1) instead.  See Github
+#546, #569.
+
+*** `yas-key-syntaxes' is much more powerful and accepts functions.
+Enables use cases when discovering keys based on buffer syntax is not
+good enough.  See issue #497.
+
+*** Documentation rewritten in org-mode and updated.
+A tremendous effort by Noam Postavsky.  Hopefully easier to maintain
+and navigate.  Available at <http://joaotavora.github.io/yasnippet>.
+
+*** Snippets are now maintained in their own repo.
+Snippets live in Andrea Crotti's
+<https://github.com/andreacrotti/yasnippet-snippets>.  See README.md
+for more details.
+
+*** Textmate snippet importer moved to separate `yasmate' repo.
+URL is <https://github.com/joaotavora/yasmate>.  See README.md for
+more details.
+
+*** `yas-snippet-dirs' now allows symbols as aliases to directories.
+The added level of indirection should allow more esoteric
+configurations (see Github #495).
+
+*** `yas-reload-all' can now jit-load when called interactively.
+
+*** New `yas-after-reload-hook' run after `yas-reload-all'.
+See <https://github.com/pezra/rspec-mode/pull/75> for the discussion
+leading up to this change.
+
+*** New functions `yas-activate-extra-mode' and `yas-deactivate-extra-mode'.
+These are preferable to setting `yas-extra-modes' directly in the mode
+hook (see issue #420 for more information).
+
+*** New variable `yas-new-snippet-default'.
+The default snippet suggested on `yas-new-snippet' can now be
+customized.
+
+** Fixed bugs
+
+*** `yas-expand' now sets `this-command' when falling back to another command.
+Previously it was setting `this-original-command', which does not
+match the documented semantics.  See Github #587.
+
+*** Github #537: Be lenient to extensions operating on snippet fields.
+
+*** Github #619: Parents of extra modes are now activated too.
+
+*** Github #549: `yas-verbosity' is now applied to `load' calls too.
+
+*** Github #607; avoid obscure Emacs bug triggered by overlays in *Messages* buffer.
+It was triggered by yasnippet+flycheck+highlight-parentheses.  See
+also <http://debbugs.gnu.org/cgi/bugreport.cgi?bug=21824>
+
+*** Github #617; fix x prompt when snippet inserts many lines.
+
+*** Github #618; avoid breakage if `scan-sexp' modifies match data.
+Which it does in Emacs 25.
+
+*** Github #562: Deleting inner numberless snippet caused an error.
+
+*** Github #418, #536: Fix navigation to zero-length fields at snippet end.
+
+*** Github #527, #525 and #526: Attempt to prevent "fallback loops"
+when interactiing with other extensions that use similar fallback
+mechanisms.
+
+
+* 0.8.0 (August 2012)
+
+** Changes and New Features
+
+*** All YASnippet symbols now prefixed with `yas-'.  Keep old `yas/' versions as aliases.
+
+*** Yasnippet is now Free Software Foundation's copyright.
+
+*** `yas-dont-activate' can be a list of functions.
+
+*** Snippets are loaded just-in-time .
+Thanks to Matthew Fidler for a lot of input with the implementation.
+
+*** yasnippet-bundle.el is no longer available.
+Use `yas-compile-directory' instead if you need the speed advantage.
+
+*** New functions `yas-compile-directory' and `yas-recompile-all'.
+This feature is still undocumented.  Generate a
+.yas-compiled-snippets.el file in the directory passed where snippets
+are compiled into emacs-lisp code.
+
+*** New `yas-verbosity' variable.
+
+*** Interactively calling `yas-exit-snippet' exits most recently inserted snippet.
+
+*** Using filenames as snippet triggers is deprecated.
+
+*** Default value of `yas-show-menu-p' is `abbreviate'.
+
+*** `yas-visit-snippet' ignores `yas-prompt-functions'.
+
+*** `yas-buffer-local-condition' restricted to trigger-key expansions by default.
+
+*** `yas-load-snippet-buffer' (`C-c C-c') in `snippet-mode' has been much improved.
+
+*** New variable `yas-expand-only-for-last-commands', thanks Erik Postma.
+
+*** New variable `yas-extra-modes' aliases old `yas/mode-symbol'.
+
+*** New `yas-describe-tables' command.
+
+*** New `yas-define-condition-cache' macro.
+This defines an optimised function for placing in a `# condition:'
+directive that will run at most once per snippet-expansion attempt.
+
+*** Mirrors can occur inside fields.
+
+*** New `# type: command' directive.
+This feature is still largely undocumented.
+
+*** A hidden .yas-setup.el is loaded if found in a snippet directory.
+
+*** `yas-wrap-around-region' can now also be `cua' (undocumented feature).
+
+*** Make menu groups automatically using new .yas-make-groups file.
+
+*** Per-snippet keybindings using `# keybinding:' directive.
+
+*** More friendly `yas-expand-snippet' calling convention.
+This breaks backward compatibility.
+
+*** The `# env:' directive is now `# expand-env:'.
+
+*** Setup multiple parent modes using new .yas-parents file.
+
+** Fixed bugs
+
+*** Github #281: jit-load snippets in the correct order.
+
+*** Github #245: primary field transformations work inside nested fields.
+
+*** Github #242: stop using the deprecated `assoc' library.
+
+*** Github #233: show direct snippet keybindings in the menu.
+
+*** Github #194, Googlecode 192: Compatibility with `fci-mode'.
+
+*** Github #147, Googlecode 145: Snippets comments were getting inserted.
+
+*** Github #141, Googlecode 139: searching buffer in embedded elisp works slightly better.
+Issue is still open for analysis, though
+
+*** Github #95, Googlecode 193: no more stack overflow in org-mode.
+
+
+----------------------------------------------------------------------
+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.
+
+
+Local variables:
+coding: utf-8
+mode: outline
+paragraph-separate: "[ 	]*$"
+end:

README.mdown

@@ -1,29 +1,26 @@
+[![Build Status](https://travis-ci.org/joaotavora/yasnippet.png)](https://travis-ci.org/joaotavora/yasnippet)
+
 # 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
-abbreviation and automatically expand it into function
+type an abbreviation and automatically expand it into function
-templates. Bundled language templates includes: C, C++, C#, Perl,
+templates. Bundled language templates include: C, C++, C#, Perl,
-Python, Ruby,
+Python, Ruby, SQL, LaTeX, HTML, CSS and more. The snippet syntax
-
+is inspired from [TextMate's][textmate-snippets] syntax, you can
-SQL, LaTeX, HTML, CSS and more. The snippet syntax is inspired from
+even [import](#import) most TextMate templates to
-[TextMate's][textmate-snippets] syntax, you can even
+YASnippet. Watch [a demo on YouTube][youtube-demo].
-[import][import-docs] most TextMate templates to YASnippet. Watch
-[a demo on YouTube][youtube-demo] or download a
-[higher resolution version][high-res-demo]
 
 [textmate-snippets]: http://manual.macromates.com/en/snippets
-[import-docs]: http://yasnippet.googlecode.com/svn/trunk/doc/snippet-development.html#importing-textmate-snippets
 [youtube-demo]: http://www.youtube.com/watch?v=ZCGmZK4V7Sg
-[high-res-demo]: http://yasnippet.googlecode.com/files/yas_demo.avi
 
 # Installation
 
-## Install the most recent version
+## Manual install from Git
 
 Clone this repository somewhere
 
     $ cd ~/.emacs.d/plugins
-    $ git clone https://github.com/capitaomorte/yasnippet
+    $ git clone --recursive https://github.com/joaotavora/yasnippet
 
 Add the following in your `.emacs` file:
 
@@ -36,108 +33,136 @@ Add your own snippets to `~/.emacs.d/snippets` by placing files there or invokin
 
 ## 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
-[MELPA][melpa] keeps a very recent snapshot of YASnippet, see http://melpa.milkbox.net/#installing.
+and install packages.
+It's available from [GNU ELPA][gnuelpa].
+If you need a very recent snapshot, you can get it from
+[GNU-devel ELPA][gnudevel] as well as [MELPA][melpa]
+(see http://melpa.org/#installing).
 
 ## Install with el-get
 
-El-get is a nice way to get the most recent version, too. See
+El-get is another nice way to get the most recent version, too. See
-https://github.com/dimitri/el-get for instructions. Be sure to install the
+https://github.com/dimitri/el-get for instructions.
-"master" branch since the 3.x series still use the old googlecode code, base.
-Consider using this "local" recipe.
-
-    (push '(:name yasnippet
-                  :website "https://github.com/capitaomorte/yasnippet.git"
-                  :description "YASnippet is a template system for Emacs."
-                  :type github
-                  :pkgname "capitaomorte/yasnippet"
-                  :features "yasnippet"
-                  :compile "yasnippet.el")
-          el-get-sources)
 
 ## 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, don't call
-`(yas-reload-all)` to load the snippet tables. Then add a call to
+`yas-global-mode`; instead call `yas-reload-all` to load the snippet
-`(yas-minor-mode)` to the major-modes where you to enable YASnippet.
+tables and then call `yas-minor-mode` from the hooks of major-modes
+where you want YASnippet enabled.
 
-    (add-hook 'prog-mode-hook
+    (yas-reload-all)
-              '(lambda ()
+    (add-hook 'prog-mode-hook #'yas-minor-mode)
-                 (yas-minor-mode)))
 
-# (NOT) Contributing snippets
+# Where are the snippets?
 
-Please **do not** open pull requests or ask me to add snippets to
+<a name="import"></a>
-YASnippet.
 
-The bundled collection under `/snippets` is considered frozen: **I
+YASnippet no longer bundles snippets directly, but it's very easy to
-will not add more snippets to it**.
+get some!
 
-You can point `yas-snippet-dirs` to good snippet collections out
+1. [yasnippet-snippets] - a snippet collection package maintained by
+    [AndreaCrotti](https://github.com/AndreaCrotti).
+
+    It can be installed with `M-x package-install RET
+    yasnippet-snippets` if you have added MELPA to your package
+    sources.
+
+2. [yasmate] a tool which is dedicated to converting textmate bundles
+    into yasnippet snippets.
+
+    To use these snippets you have to run the tool first, so
+    [see its doc][yasmate]), and then point the `yas-snippet-dirs`
+    variable to the `.../yasmate/snippets` subdir.
+3.  [textmate-to-yas.el]
+
+    This is another textmate bundle converting tool using Elisp
+    instead of Ruby.
+
+Naturally, you can point `yas-snippet-dirs` to good snippet collections out
 there. If you have created snippets for a mode, or multiple modes,
 consider creating a repository to host them, then tell users that it
 should be added like this to `yas-snippet-dirs`:
 
     (setq yas-snippet-dirs
           '("~/.emacs.d/snippets"                 ;; personal snippets
-            "/path/to/some/collection/"      ;; just some foo-mode snippets
+            "/path/to/some/collection/"           ;; foo-mode and bar-mode snippet collection
-            "/path/to/some/othercollection/" ;; some more foo-mode and a complete baz-mode
+            "/path/to/yasnippet/yasmate/snippets" ;; the yasmate collection
-            "/path/to/yasnippet/snippets"    ;; the default collection
             ))
 
     (yas-global-mode 1) ;; or M-x yas-reload-all if you've started YASnippet already.
 
-# Importing TextMate snippets
+# Manual, issues etc
 
-There is a tool `extras/textmate-import.rb` than can import many
+There's comprehensive [documentation][docs] on using and customising
-actual TextMate snippets. These can be quite complex so the
+YASnippet.
-`extras/imported/*-mode/.yas-setup.el` files help it with the more
-difficult importation.
 
-I'm focusing on developing `textmate-import.rb` tool and some
+There's a [list of support issues][support-issues], with solutions to
-`yas-setup.el` files. In the future `/snippets` snippets will be
+common problems and practical snippet examples.
-deprecated and might be replaced with `extras/imported`.
 
-## Example importation of rails snippets
+The [Github issue tracker][issues] is where most YASnippet-related
+discussion happens.  Nevertheless, since YASnippet is a part of Emacs,
+you may alternatively report bugs to Emacs via `M-x report-emacs-bug` or
+sending an email to `bug-gnu-emacs@gnu.org`, putting "yasnippet"
+somewhere in the subject.
 
-To start using [drnic's](https://github.com/drnic) snippets for rails
+## Important note regarding bug reporting
-development, follow this example. It will convert `ruby`, `rails` and
-`html` bundles from github repositories. The importation will be
-guided by the `.yas-setup.el` files.
 
-After cloning this repository to `~/.emacs.d/plugins/yasnippet`
+Your bug reports are very valuable.
 
-    cd ~/.emacs.d/plugins/yasnippet
+The most important thing when reporting bugs is making sure that we have
-    git submodule init
+a way to reproduce the problem exactly like it happened to you.
-    git submodule update
-    gem install plist trollop
-    rake convert_bundles             # will convert ruby, rails and html bundles
 
-Then, in your `.emacs` file
+To do this, we need to rule out interference from external factors
+like other Emacs extensions or your own customisations.
+
+Here's an example report that "sandboxes" an Emacs session just for
+reproducing a bug.
+
+```
+$ emacs --version
+Emacs 24.3
+$ cd /tmp/
+$ git clone https://github.com/joaotavora/yasnippet.git yasnippet-bug
+$ cd yasnippet-bug
+$ git log -1 --oneline
+6053db0 Closes #527: Unbreak case where yas-fallback-behaviour is a list
+$ HOME=$PWD emacs -L . # This "sandboxes" your emacs, melpa configuration, etc
 
-    (add-to-list 'load-path
-                  "~/.emacs.d/plugins/yasnippet")
 (require 'yasnippet)
-    (setq yas-snippet-dirs '("~/.emacs.d/snippets" "~/.emacs.d/plugins/yasnippet/extras/imported"))
 (yas-global-mode 1)
 
-Open some rails file (model, app, etc) and start using the textmate
+When I open a foo-mode file I don't see foo-mode under the "YASnippet" menu!
-snippets.  Note that in the example above we have abandoned the
+OR
-default snippet collection on `~/.emacs.d/plugins/yasnippet/snippets`
+When loading yasnippet I see "Error: failed to frobnicate"!
+```
 
-# Documentation, issues, etc
+Using `emacs -Q` or temporarily moving your `.emacs` init file to the side
+is another way to achieve good reproducibility.
 
-Please refer to the comprehensive (albeit slightly outdated)
+Here's a
-[documentation][docs] for full customization
+[another example](https://github.com/joaotavora/yasnippet/issues/318)
-and support.  If you find a bug, please report it on
+of a bug report. It has everything needed for a successful analysis
-[the GitHub issue tracker][issues].  (please **do not** submit new issues to the old
+and speedy resolution.
-[googlecode tracker][googlecode tracker])
 
-If you run into problems using YASnippet, or have snippets to contribute, post
+Also, don't forget to state the Emacs version (use `M-x emacs-version`) and
-to the [YASnippet google group][forum]. Thank you very much for using YASnippet!
+the yasnippet version you are using (if using the latest from github,
+do `git log -1` in the dir).
 
-[docs]: http://capitaomorte.github.com/yasnippet/
+Any more info is welcome, but don't just paste a backtrace or an error
-[issues]: https://github.com/capitaomorte/yasnippet/issues
+message string you got, unless we ask for it.
+
+Finally, thank you very much for using YASnippet!
+
+[docs]: http://joaotavora.github.io/yasnippet/
+[issues]: https://github.com/joaotavora/yasnippet/issues
+[support-issues]: https://github.com/joaotavora/yasnippet/issues?q=label%3Asupport
 [googlecode tracker]: http://code.google.com/p/yasnippet/issues/list
 [forum]: http://groups.google.com/group/smart-snippet
 [melpa]: http://melpa.milkbox.net/
+[gnuelpa]: http://elpa.gnu.org/packages/yasnippet.html
+[gnudevel]: http://elpa.gnu.org/devel/yasnippet.html
+[yasmate]: http://github.com/joaotavora/yasmate
+[textmate-to-yas.el]: https://github.com/mattfidler/textmate-to-yas.el
+[yasnippet-snippets]: http://github.com/AndreaCrotti/yasnippet-snippets

README.org

@@ -1,102 +0,0 @@
-# -*- 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!

Rakefile

@@ -1,89 +0,0 @@
-# -*- Ruby -*-
-
-require 'fileutils'
-
-def find_version
-  File.read("yasnippet.el", :encoding => "UTF-8") =~ /;; Package-version: *([0-9.]+?) *$/
-  $version = $1
-end
-find_version
-FileUtils.mkdir_p('pkg')
-
-
-desc "convert some textmate bundles to yasnippets"
-task :convert_bundles do
-  Dir.glob "extras/bundles/*-tmbundle" do |bundle_dir|
-    puts "Converting from #{bundle_dir}"
-    mode_prefix = File.basename(bundle_dir).match(/[^-]*/)[0]
-    raise "Couldn't guess mode name for #{bundle_dir}" unless mode_prefix
-    output = "./extras/imported/#{mode_prefix}-mode"
-    FileUtils.mkdir_p output
-    sh "./extras/textmate_import.rb -d #{bundle_dir} -o #{output} -q"
-  end
-end
-
-desc "create a release package"
-task :package do
-  release_dir = "pkg/yasnippet-#{$version}"
-  FileUtils.mkdir_p(release_dir)
-  files = ['snippets', 'yasnippet.el', 'dropdown-list.el']
-  FileUtils.cp_r files, release_dir
-  File.open(File.join(release_dir,'yasnippet-pkg.el'), 'w') do |file|
-    file.puts <<END
-(define-package "yasnippet"
-                "#{$version}"
-                "A template system for Emacs")
-END
-  end
-  sh "git clean -f snippets"
-  FileUtils.cd 'pkg' do
-    sh "tar cf yasnippet-#{$version}.tar yasnippet-#{$version}"
-  end
-end
-
-desc "create a release package and upload it to google code"
-task :release => [:package, 'doc:archive'] do
-  raise "Not implemented for github yet!"
-end
-
-rule '.html' => '.rst' do |t|
-  sh "doc/compile-doc.py #{t.source} > #{t.name}"
-end
-desc "Generate document"
-task :doc => FileList['doc/*.rst'].ext('html')
-
-namespace :doc do
-  task :archive do
-    release_dir = "pkg/yasnippet-#{$version}"
-    FileUtils.mkdir_p(release_dir)
-    sh "tar cjf pkg/yasnippet-doc-#{$version}.tar.bz2 " +
-      "--exclude=doc/.svn --exclude=doc/images/.svn doc/*.html doc/images"
-  end
-
-  task :upload do
-    if File.exists? 'doc/gh-pages'
-      Dir.chdir 'doc/gh-pages' do
-        sh "git checkout gh-pages"
-      end
-      Dir.glob("doc/*.{html,css}").each do |file|
-        FileUtils.cp file, 'doc/gh-pages'
-      end
-      Dir.glob("doc/images/*").each do |file|
-        FileUtils.cp file, 'doc/gh-pages/images'
-      end
-      Dir.chdir 'doc/gh-pages' do
-        sh "git commit -a -m 'Automatic documentation update.'"
-        sh "git push"
-      end
-    end
-  end
-end
-
-desc "Compile yasnippet.el into yasnippet.elc"
-
-rule '.elc' => '.el' do |t|
-  sh "emacs --batch -L . --eval \"(byte-compile-file \\\"#{t.source}\\\")\""
-end
-task :compile => FileList["yasnippet.el", "dropdown-list.el"].ext('elc')
-
-task :default => :doc

doc/faq.org

@@ -0,0 +1,87 @@
+#+SETUPFILE: org-setup.inc
+
+#+TITLE: Frequently Asked Questions
+
+-  *Note*: In addition to the questions and answers presented here,
+  you might also with to visit the list of [[https://github.com/joaotavora/yasnippet/issues?q=label%3Asupport][solved support issues]] in
+  the Github issue tracker.  It might be more up-to-date than this
+  list.
+
+* Why are my snippet abbrev keys triggering when I don't want them too?
+Expansion of abbrev keys is controlled by [[sym:yas-key-syntaxes][=yas-key-syntaxes=]].  Try
+removing entries which correspond to the abbrev key character syntax.
+For example, if you have a snippet with abbrev key "bar", that you
+don't want to trigger when point follows the text =foo_bar=, remove
+the ="w"= entry (since "bar" has only word syntax characters).
+
+* Why aren't my snippet abbrev keys triggering when I want them too?
+See previous question, but in reverse.
+
+* Why is there an extra newline?
+
+If there is a newline at the end of a snippet definition file,
+YASnippet will add a newline when expanding that snippet. When editing
+or saving a snippet file, please be careful not to accidentally add a
+terminal newline.
+
+Note that 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 automatically.
+
+* Why doesn't TAB navigation work with flyspell
+
+This is [[https://debbugs.gnu.org/26672][Emacs Bug#26672]], so you should upgrade to version 25.3 or
+better.  Otherwise, a workaround is to inhibit flyspell overlays while
+the snippet is active:
+
+#+BEGIN_SRC emacs-lisp
+  (add-hook 'flyspell-incorrect-hook
+            #'(lambda (&rest _)
+                (and yas-active-field-overlay
+                     (overlay-buffer yas-active-field-overlay))))
+#+END_SRC
+
+* How do I use alternative keys, i.e. not TAB?
+
+Edit the keymaps [[sym:yas-minor-mode-map][=yas-minor-mode-map=]] and [[sym:yas-keymap][=yas-keymap=]] as you would
+any other keymap, but use [[sym:yas-filtered-definition][=yas-filtered-definition=]] on the definition
+if you want to respect [[sym:yas-keymap-disable-hook][=yas-keymap-disable-hook=]]:
+
+#+begin_src emacs-lisp :exports code
+  (define-key yas-minor-mode-map (kbd "<tab>") nil)
+  (define-key yas-minor-mode-map (kbd "TAB") nil)
+  (define-key yas-minor-mode-map (kbd "<the new key>") yas-maybe-expand)
+
+  ;;keys for navigation
+  (define-key yas-keymap [(tab)]       nil)
+  (define-key yas-keymap (kbd "TAB")   nil)
+  (define-key yas-keymap [(shift tab)] nil)
+  (define-key yas-keymap [backtab]     nil)
+  (define-key yas-keymap (kbd "<new-next-field-key>")
+    (yas-filtered-definition 'yas-next-field-or-maybe-expand))
+  (define-key yas-keymap (kbd "<new-prev-field-key>")
+    (yas-filtered-definition 'yas-prev-field))
+#+end_src
+
+* 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 still 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:
+
+#+BEGIN_SRC snippet
+  # key: <
+  # name: <...></...>
+  # --
+  <${1:div}>$0</$1>
+#+END_SRC

doc/index.org

@@ -0,0 +1,47 @@
+#+SETUPFILE: org-setup.inc
+#+TITLE: Yet another snippet extension
+
+The YASnippet documentation has been split into separate parts:
+
+0. [[https://github.com/joaotavora/yasnippet/blob/master/README.mdown][README]]
+
+   Contains an introduction, installation instructions and other important
+   notes.
+
+1. [[file:snippet-organization.org][Organizing Snippets]]
+
+   Describes ways to organize your snippets in the hard disk.
+
+2. [[file:snippet-expansion.org][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. [[file:snippet-development.org][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. [[file:snippet-menu.org][The YASnippet menu]]
+
+   Explains how to use the YASnippet menu to explore, learn and modify
+   snippets.
+
+5. [[file:faq.org][Frequently asked questions]]
+
+   Answers to frequently asked questions.
+
+6. [[file:snippet-reference.org][YASnippet Symbol Reference]]
+
+   An automatically generated listing of all YASnippet commands,
+   (customization) variables, and functions.
+
+
+# Local Variables:
+# mode: org
+# fill-column: 80
+# coding: utf-8
+# End:

doc/manual.org

@@ -1,266 +0,0 @@
-#+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:

doc/nav-menu.html.inc

@@ -0,0 +1,16 @@
+<nav>
+  <ul class="center">
+    <li> <a href="index.html">Overview</a>
+    <li> <a href="https://github.com/joaotavora/yasnippet/blob/master/README.mdown">
+        Intro and Tutorial</a>
+    <li class="center border">Snippet
+      <ul class="nopad">
+        <li> <a href="snippet-organization.html">Organization</a>
+        <li> <a href="snippet-expansion.html">Expansion</a>
+        <li> <a href="snippet-development.html">Development</a>
+        <li> <a href="snippet-menu.html">Menu</a>
+      </ul>
+    <li> <a href="faq.html">FAQ</a>
+    <li> <a href="snippet-reference.html">Reference</a>
+  </ul>
+</nav>

doc/org-setup.inc

@@ -0,0 +1,11 @@
+# -*- mode: org -*-
+
+#+STARTUP: showall
+
+#+LINK: sym file:snippet-reference.org::#%s
+
+#+OPTIONS: author:nil num:nil timestamp:nil
+#+AUTHOR:
+# org < 8.0 use +STYLE, after use +HTML_HEAD
+#+STYLE: <link rel="stylesheet" type="text/css" href="stylesheets/manual.css" />
+#+HTML_HEAD: <link rel="stylesheet" type="text/css" href="stylesheets/manual.css" />

doc/snippet-development.org

@@ -0,0 +1,474 @@
+#+SETUPFILE: org-setup.inc
+
+#+TITLE: Writing snippets
+
+* Snippet development
+
+** Quickly finding snippets
+
+There are some ways you can quickly find a snippet file or create a new one:
+
+-  =M-x yas-new-snippet=, key binding: =C-c & C-n=
+
+   Creates a new buffer with a template for making a new snippet.  The
+   buffer is in =snippet-mode= (see [[snippet-mode][below]]).  When you are done editing
+   the new snippet, use [[yas-load-snippet-buffer-and-close][=C-c C-c=]] to save it.
+
+-  =M-x yas-visit-snippet-file=, key binding: =C-c & C-v=
+
+   Prompts you for possible snippet expansions like
+   [[sym:yas-insert-snippet][=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 [[snippet-mode][ahead]])
+and you can start editing your snippet.
+
+** Using the =snippet-mode= major mode <<snippet-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.
+
+Three commands are defined in this mode:
+
+-  =M-x yas-load-snippet-buffer=, key binding: =C-c C-l=
+
+   Prompts for a snippet table (with a default based on snippet's
+   major mode) and loads the snippet currently being edited.
+
+-  =M-x yas-load-snippet-buffer-and-close=, key binding: =C-c C-c=
+   <<yas-load-snippet-buffer-and-close>>
+
+   Like =yas-load-snippet-buffer=, but also saves the snippet and
+   calls =quit-window=.  The destination is decided based on the
+   chosen snippet table and snippet collection directly (defaulting to
+   the first directory in =yas-snippet-dirs= (see [[file:snippet-organization.org][Organizing Snippets]]
+   for more detail on how snippets are organized).
+
+-  =M-x yas-tryout-snippet=, key binding: =C-c C-t=
+
+   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.
+
+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
+snippet properties described below. If no =# --= is found, the whole
+file is considered the snippet template.
+
+Here's a typical example:
+
+#+BEGIN_SRC snippet
+  # contributor: pluskid <pluskid@gmail.com>
+  # name: __...__
+  # --
+  __${init}__
+#+END_SRC
+
+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 the key
+that runs [[sym:yas-expand][=yas-expand=]]. If you don't specify this,
+the snippet will not be expandable through the trigger 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 [[sym:yas-buffer-local-condition][=yas-buffer-local-condition=]] in
+[[./snippet-expansion.org][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
+[[./snippet-menu.org][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
+[[./snippet-organization.org][Organizing Snippets]]
+
+Refer to the bundled snippets for =ruby-mode= for examples of the
+=# group:= directive. Group can also be nested, e.g.
+=control structure.loops= indicates 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 [[sym:yas-wrap-around-region][=yas-wrap-around-region=]] and
+[[sym:yas-indent-line][=yas-indent-line=]] (see [[./snippet-expansion.org][Expanding Snippets]]).
+
+As an example, you might normally have [[sym:yas-indent-line][=yas-indent-line=]] set to '=auto=
+and [[sym:yas-wrap-around-region][=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:
+
+#+BEGIN_SRC snippet
+  # name: ASCII home
+  # expand-env: ((yas-indent-line 'fixed) (yas-wrap-around-region 'nil))
+  # --
+                  welcome to my
+              X      humble
+             / \      home,
+            /   \      $0
+           /     \
+          /-------\
+          |       |
+          |  +-+  |
+          |  | |  |
+          +--+-+--+
+#+END_SRC
+
+** =# 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 [[sym:yas-prefix][=yas-prefix=]] is set 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.
+
+#+BEGIN_SRC snippet
+  # name: <p>...</p>
+  # binding: C-c C-c C-m
+  # --
+  <p>`(when yas-prefix "\n")`$0`(when yas-prefix "\n")`</p>
+#+END_SRC
+
+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.
+
+** =# type:= =snippet= or =command=
+
+If the =type= directive is set to =command=, the body of the snippet
+is interpreted as Lisp code to be evaluated when the snippet is
+triggered.
+
+If it's =snippet= (the default when there is no =type= directive), the
+snippet body will be parsed according to the [[Template Syntax]],
+described below.
+
+** =# uuid:= unique identifier
+
+This provides to a way to identify a snippet, independent of its name.
+Loading a second snippet file with the same uuid would replace the
+previous snippet.
+
+** =# 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:
+
+#+BEGIN_SRC snippet
+  #ifndef ${1:_`(upcase (file-name-nondirectory (file-name-sans-extension (buffer-file-name))))`_H_}
+  #define $1
+
+  $0
+
+  #endif /* $1 */
+#+END_SRC
+
+From version 0.6, snippet expansions are run with some special
+Emacs Lisp variables bound. One of these is [[sym:yas-selected-text][=yas-selected-text=]]. You can
+therefore define a snippet like:
+
+#+BEGIN_SRC snippet
+  for ($1;$2;$3) {
+    `yas-selected-text`$0
+  }
+#+END_SRC
+
+to "wrap" the selected region inside your recently inserted snippet.
+Alternatively, you can also customize the variable
+[[sym:yas-wrap-around-region][=yas-wrap-around-region=]] to =t= which will do this automatically.
+
+*** Note: backquote expressions should not modify the buffer
+
+Please note that the Lisp forms in backquotes should *not* modify the
+buffer, doing so will trigger a warning.  For example, instead of
+doing
+
+#+BEGIN_SRC snippet
+  Timestamp: `(insert (current-time-string))`
+#+END_SRC
+
+do this:
+#+BEGIN_SRC snippet
+  Timestamp: `(current-time-string)`
+#+END_SRC
+
+The warning may be suppressed with the following code in your init file:
+#+BEGIN_SRC emacs-lisp
+  (add-to-list 'warning-suppress-types '(yasnippet backquote-change))
+#+END_SRC
+
+
+** 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:
+
+#+BEGIN_SRC snippet
+  <div$1>
+      $0
+  </div>
+#+END_SRC
+** Placeholder fields
+
+Tab stops can have default values -- a.k.a placeholders. The syntax is
+like this:
+
+#+BEGIN_SRC snippet
+  ${N:default value}
+#+END_SRC
+
+They act as the default value for a tab stop. But when you first
+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-fields][mirrors]] or
+[[mirror-transformations][transformations]] for this field.
+
+** Mirrors <<mirrors-fields>>
+
+We refer to tab stops with placeholders as a /field/.  A field can
+have mirrors.  *All* mirrors get updated whenever you update any field
+text.  Here's an example:
+
+#+BEGIN_SRC snippet
+  \begin{${1:enumerate}}
+      $0
+  \end{$1}
+#+END_SRC
+
+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([[http://www.youtube.com/watch?v=vOj7btx3ATg][YouTube]] or [[http://yasnippet.googlecode.com/files/yasnippet.avi][avi video]]).
+
+The tab stops with the same number to the field act as its mirrors. If
+none of the tab stops have an initial value, the first one is selected as
+the field and the others are its mirrors.
+
+** Mirrors with transformations <<mirror-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 [[sym:yas-text][=yas-text=]] is bound to the text
+content (string) contained in the field =n=. Here's an example for
+Objective-C:
+
+#+BEGIN_SRC snippet
+  - (${1:id})${2:foo}
+  {
+      return $2;
+  }
+
+  - (void)set${2:$(capitalize yas-text)}:($1)aValue
+  {
+      [$2 autorelease];
+      $2 = [aValue retain];
+  }
+  $0
+#+END_SRC
+
+Look at =${2:$(capitalize yas-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
+
+#+BEGIN_SRC rst
+  =====
+  Title
+  =====
+#+END_SRC
+
+is a valid title but
+
+#+BEGIN_SRC rst
+  ===
+  Title
+  ===
+#+END_SRC
+
+is not. Here's an snippet for rst title:
+
+#+BEGIN_SRC snippet
+  ${1:$(make-string (string-width yas-text) ?\=)}
+  ${1:Title}
+  ${1:$(make-string (string-width yas-text) ?\=)}
+
+  $0
+#+END_SRC
+
+Note that a mirror with a transform is not restricted to the text of
+the field it is mirroring.  By making use of [[sym:yas-field-value][=yas-field-value=]], a
+mirror can look at any of the snippet's field (as mentioned above, all
+mirrors are updated when any field is updated).  Here is an example
+which shows a "live" result of calling format:
+
+#+BEGIN_SRC snippet
+(format "${1:formatted %s}" "${2:value}")
+=> "${1:$(ignore-errors (format (yas-field-value 1) (yas-field-value 2)))}"
+#+END_SRC
+
+To keep the example simple, it uses =ignore-errors= to suppress errors
+due to incomplete format codes.
+
+** Fields with transformations
+
+From version 0.6 on, you can also have Lisp transformation inside
+fields. These work mostly like mirror transformations. However, they
+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
+
+:  #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.
+
+:  #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
+[[sym:yas-modified-p][=yas-modified-p=]] and [[sym:yas-moving-away-p][=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.
+
+For example, the [[sym:yas-choose-value][=yas-completing-read=]] function is version of
+=completing-read= which checks these variables.  For example, asking
+the user for the initial value of a field:
+
+#+BEGIN_SRC snippet
+  <div align="${2:$$(yas-completing-read "Alignment? " '("right" "center" "left"))}">
+    $0
+  </div>
+#+END_SRC
+
+See the definition of [[sym:yas-choose-value][=yas-completing-read=]] to see how it was written
+using the two variables. If you're really lazy :) and can't spare a
+tab keypress, you can automatically move to the next field (or exit)
+after choosing the value with [[sym:yas-auto-next][=yas-auto-next=]]. The snippet above
+becomes:
+
+#+BEGIN_SRC snippet
+  <div align="${2:$$(yas-auto-next
+                      (yas-completing-read
+                        "Alignment? "
+                        '("right" "center" "left")))}">
+    $0
+  </div>
+#+END_SRC
+
+Here's another use, for =LaTeX-mode=, which calls reftex-label just as you
+enter snippet field 2. This one makes use of [[sym:yas-modified-p][=yas-modified-p=]] directly.
+
+#+BEGIN_SRC snippet
+  \section{${1:"Titel der Tour"}}%
+  \index{$1}%
+  \label{{2:"waiting for reftex-label call..."$(unless yas-modified-p (reftex-label nil 'dont-insert))}}%
+#+END_SRC
+
+The function [[sym:yas-verify-value][=yas-verify-value=]] has another neat trick, and makes use
+of [[sym:yas-moving-away-p][=yas-moving-away-p=]]. Try it and see! Also, check out this [[http://groups.google.com/group/smart-snippet/browse_thread/thread/282a90a118e1b662][thread]]
+
+** Nested placeholder fields
+
+From version 0.6 on, you can also have nested placeholders of the type:
+
+#+BEGIN_SRC snippet
+  <div${1: id="${2:some_id}"}>$0</div>
+#+END_SRC
+
+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 [[sym:yas-skip-and-clear-or-delete-char][=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.
+
+** Indentation markers
+
+If [[sym:yas-indent-line][=yas-indent-line=]] is *not* set to '=auto=, it's still possible to
+indent specific lines by adding an indentation marker, =$>=, somewhere
+on the line.

doc/snippet-expansion.org

@@ -0,0 +1,284 @@
+#+SETUPFILE: org-setup.inc
+
+#+TITLE: Expanding snippets
+
+  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
+
+   You can use YASnippet to expand snippets in different ways:
+
+   - When [[sym:yas-minor-mode][=yas-minor-mode=]] is active:
+     - Type the snippet's *trigger key* then calling [[sym:yas-expand][=yas-expand=]]
+       (bound to =TAB= by default).
+
+     - Use the snippet's *keybinding*.
+
+     - By expanding directly from the "YASnippet" menu in the menu-bar
+
+     - Using hippie-expand
+
+   - Call [[sym:yas-insert-snippet][=yas-insert-snippet=]] (use =M-x yas-insert-snippet= or its
+     keybinding =C-c & C-s=).
+
+   - Use m2m's excellent auto-complete
+     TODO: example for this
+
+   - Expanding from emacs-lisp code
+
+** Trigger key
+
+[[sym:yas-expand][=yas-expand=]] tries to expand a /snippet abbrev/ (also known as
+/snippet key/) before point.  YASnippet also provides a /conditional
+binding/ for this command: the variable [[sym:yas-expand][=yas-maybe-expand=]] contains a
+special value which, when bound in a keymap, tells Emacs to call
+[[sym:yas-expand][=yas-expand=]] if and only if there is a snippet abbrev before point.
+If there is no snippet to expand, Emacs will behave as if [[sym:yas-expand][=yas-expand=]]
+is unbound and so will run whatever command is bound to that key
+normally.
+
+When [[sym:yas-minor-mode][=yas-minor-mode=]] is enabled, it binds [[sym:yas-maybe-expand][=yas-maybe-expand=]] to =TAB=
+and =<tab>= by default, however, you can freely remove those bindings:
+
+#+begin_src emacs-lisp :exports code
+   (define-key yas-minor-mode-map (kbd "<tab>") nil)
+   (define-key yas-minor-mode-map (kbd "TAB") nil)
+#+end_src
+
+And set your own:
+
+#+begin_src emacs-lisp :exports code
+  ;; Bind `SPC' to `yas-expand' when snippet expansion available (it
+  ;; will still call `self-insert-command' otherwise).
+  (define-key yas-minor-mode-map (kbd "SPC") yas-maybe-expand)
+  ;; Bind `C-c y' to `yas-expand' ONLY.
+  (define-key yas-minor-mode-map (kbd "C-c y") #'yas-expand)
+#+end_src
+
+
+To enable the YASnippet minor mode in all buffers globally use the
+command [[sym:yas-global-mode][=yas-global-mode=]]. This will enable a modeline indicator,
+=yas=:
+
+[[./images/minor-mode-indicator.png]]
+
+When you use [[sym:yas-global-mode][=yas-global-mode=]] you can also selectively disable
+YASnippet in some buffers by calling [[sym:yas-minor-mode][=yas-minor-mode=]] with a negative
+argument in the buffer's mode hook.
+
+*** Fallback behaviour
+
+YASnippet used to support a more complicated way of sharing
+keybindings before [[sym:yas-expand][=yas-maybe-expand=]] was added.  This is now
+obsolete.
+
+** Insert at point
+
+The command [[sym:yas-insert-snippet][=yas-insert-snippet=]] lets you insert snippets at point
+/for your 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
+[[sym:yas-prompt-functions][=yas-prompt-functions=]].
+
+*** Inserting region or register contents into snippet
+
+It's often useful to inject already written text in the middle of a
+snippet.  The variable [[sym:yas-wrap-around-region][=yas-wrap-around-region=]] when to t substitute
+the region contents into the =$0= placeholder of a snippet expanded by
+[[sym:yas-insert-snippet][=yas-insert-snippet=]].  Setting it to a character value (e.g. =?0=)
+will insert the contents of corresponding register.
+
+Older (versions 0.9.1 and below) of Yasnippet, supported a setting of
+=cua= that is equivalent to =?0= but only worked with =cua-mode=
+turned on.  This setting is still supported for backwards
+compatibility, but is now entirely equivalent to =?0=.
+
+** Snippet keybinding
+
+See the section of the =# binding:= directive in
+[[./snippet-development.org][Writing Snippets]].
+
+** Expanding from the menu
+
+See [[./snippet-menu.org][the YASnippet Menu]].
+
+** Expanding with =hippie-expand=
+
+To integrate with =hippie-expand=, just put
+[[sym:yas-hippie-try-expand][=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 your own
+elisp code. You should call [[sym:yas-expand-snippet][=yas-expand-snippet=]] instead of
+[[sym:yas-expand][=yas-expand=]] in this case. [[sym:yas-expand-snippet][=yas-expand-snippet=]] takes a string in
+snippet template syntax, if you want to expand an existing snippet you
+can use [[sym:yas-lookup-snippet][=yas-lookup-snippet=]] to find its contents by name.
+
+As with expanding from the menubar, the condition system and multiple
+candidates doesn't affect expansion (the condition system does affect
+[[sym:yas-lookup-snippet][=yas-lookup-snippet=]] though). In fact, expanding from the YASnippet
+menu has the same effect of evaluating the follow code:
+
+#+BEGIN_SRC emacs-lisp
+  (yas-expand-snippet template)
+#+END_SRC
+
+See the internal documentation on [[sym:yas-expand-snippet][=yas-expand-snippet=]] and
+[[sym:yas-lookup-snippet][=yas-lookup-snippet=]] for more information.
+
+* Controlling expansion
+
+** Eligible snippets<<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
+   [[./snippet-organization.org][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.  As a special case,
+  if a mode doesn't have a parent, then =fundamental-mode= is
+  considered to be its parent.
+
+-  Buffer-local list of extra modes
+
+   Use [[sym:yas-activate-extra-mode][=yas-activate-extra-mode=]] to
+   consider snippet tables whose name does not correspond to a major
+   mode. Typically, you call this from a minor mode hook, for example:
+
+#+BEGIN_SRC emacs-lisp
+  ;; When entering rinari-minor-mode, consider also the snippets in the
+  ;; snippet table "rails-mode"
+  (add-hook 'rinari-minor-mode-hook
+            #'(lambda ()
+                (yas-activate-extra-mode 'rails-mode)))
+#+END_SRC
+
+-  Buffer-local [[sym:yas-buffer-local-condition][=yas-buffer-local-condition=]] variable
+
+   This variable provides finer grained control over what snippets can
+   be expanded in the current buffer.  For example, the constant
+   [[sym:yas-not-string-or-comment-condition][=yas-not-string-or-comment-condition=]] has a value that disables
+   snippet expansion inside comments or string literals.  See [[condition-system][the
+   condition system]] for more info.
+
+** The condition system <<condition-system>>
+
+Consider this scenario: you are an old Emacs hacker. You like the
+abbrev-way and bind [[sym:yas-expand][=yas-expand=]] 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 [[./snippet-development.org][Writing Snippets]]) you
+could just specify the condition for =if= to be =(not
+(python-syntax-comment-or-string-p))=.  But how about =while=, =for=,
+etc?  Writing the same condition for all the snippets is just boring.
+So you can instead set [[sym:yas-buffer-local-condition][=yas-buffer-local-condition=]] to =(not
+(python-syntax-comment-or-string-p))= in =python-mode-hook=.
+
+Then, what if you really want some particular snippet to expand even
+inside a comment?  Set [[sym:yas-buffer-local-condition][=yas-buffer-local-condition=]] like this
+
+#+BEGIN_SRC emacs-lisp
+  (add-hook 'python-mode-hook
+	    (lambda ()
+	      (setq yas-buffer-local-condition
+	            (lambda ()
+		      (if (python-syntax-comment-or-string-p)
+			  '(require-snippet-condition . force-in-comment)
+		        t)))))
+#+END_SRC
+
+... and for a snippet that you want to expand in comments, specify a
+condition which evaluates to the symbol =force-in-comment=.  Then it
+can be expanded as you expected, while other snippets like =if= still
+can't expanded in comments.
+
+For the full set of possible conditions, see the documentation for
+[[sym:yas-buffer-local-condition][=yas-buffer-local-condition=]].
+
+** Multiples snippet with the same key
+
+The rules outlined [[eligible-snippets][above]] 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
+[[sym:yas-prompt-functions][=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:
+
+#+BEGIN_SRC emacs-lisp
+  (setq yas-prompt-functions '(yas-x-prompt yas-dropdown-prompt))
+#+END_SRC
+
+Currently there are some alternatives solution with YASnippet.
+
+*** Use the X window system
+
+[[./images/x-menu.png]]
+
+The function [[sym:yas-x-prompt][=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.
+
+*** Minibuffer prompting
+
+[[./images/ido-menu.png]]
+
+You can use functions [[sym:yas-completing-prompt][=yas-completing-prompt=]] for the classic emacs
+completion method or [[sym:yas-ido-prompt][=yas-ido-prompt=]] for a much nicer looking method.
+The best way is to try it. This works in a terminal.
+
+*** Use =dropdown-menu.el=
+
+[[./images/dropdown-menu.png]]
+
+The function [[sym:yas-dropdown-prompt][=yas-dropdown-prompt=]] can also be placed in the
+[[sym:yas-prompt-functions][=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 the documentation on variable [[sym:yas-prompt-functions][=yas-prompt-functions=]]

doc/snippet-menu.org

@@ -0,0 +1,68 @@
+#+SETUPFILE: org-setup.inc
+
+#+TITLE: YASnippet menu
+
+When [[sym:yas-minor-mode][=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.
+
+[[./images/menu-1.png]]
+
+* Loading snippets from menu
+
+Invoking "Load snippets..." from the menu invokes [[sym:yas-load-directory][=yas-load-directory=]]
+and prompts you for a snippet directory hierarchy to load.
+
+Also useful is the "Reload everything" item to invoke [[sym:yas-reload-all][=yas-reload-all=]]
+which uncondionally reloads all the snippets directories defined in
+[[sym:yas-snippet-dirs][=yas-snippet-dirs=]] 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 [[sym:yas-visit-from-menu][=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 [[sym:yas-use-menu][=yas-use-menu=]] to
+'=real-modes=.
+
+Finally, to have the menu show only the tables for the currently active
+mode, set [[sym:yas-use-menu][=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
+[[sym:yas-indent-line][=yas-indent-line=]] and [[sym:yas-also-auto-indent-first-line][=yas-also-auto-indent-first-line=]]. See
+[[./snippet-development.org][Writing snippets]].
+
+* Prompting method
+
+The "Prompting method" submenu contains options to control the value of
+[[sym:yas-prompt-functions][=yas-prompt-functions=]]. See [[./snippet-expansion.org][Expanding snippets]].
+
+* Misc
+
+The "Misc" submenu contains options to control the values of more
+variables.

doc/snippet-organization.org

@@ -0,0 +1,132 @@
+#+SETUPFILE: org-setup.inc
+
+#+TITLE: 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 mode 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 [[file:snippet-expansion.org][Expanding Snippets]]) looks up and
+   (hopefully) causes the right snippet to be expanded for you.
+
+* Setting up =yas-snippet-dirs=
+
+   The emacs variable [[sym:yas-snippet-dirs][=yas-snippet-dirs=]] tells YASnippet
+   which collections to consider. It's used when you activate
+   [[sym:yas-global-mode][=yas-global-mode=]] or call
+   [[sym: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= location
+
+   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 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 override snippets with same names
+   appearing in collections later in the list. [[sym: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 [[file:snippet-menu.org][the menu]] is organized much more
+   cleanly:
+
+   [[./images/menu-groups.png]]
+
+   Another way to achieve this is to place a =# group:= directive
+   inside the snippet definition. See [[./snippet-development.org][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
+
+* The =.yas-setup.el= file
+
+  If there is file named =.yas-setup.el= in a mode's snippet
+  subdirectory, it is loaded along with the snippets.  Utility
+  functions used by the snippets can be put here.
+
+* The =.yas-compiled-snippet.el= file
+
+   You may compile a top-level snippet directory with the
+   =yas-compile-directory= function, which will create a
+   =.yas-compiled-snippets.el= file under each mode subdirectory,
+   which contains definitions for all snippets in the subdirectory.
+   Compilation helps improve loading time.
+
+   Alternatively, you may compile all directories in the list
+   =yas-snippet-dirs= with the =yas-recompile-all= function.
+
+* The =.yas-skip= file
+
+  A =.yas-skip= file in a mode's snippet subdirectory tells YASnippet
+  not to load snippets from there.

doc/snippet-reference.org

@@ -0,0 +1,12 @@
+#+SETUPFILE: org-setup.inc
+
+#+TITLE: Reference
+
+#+BEGIN_SRC emacs-lisp :exports results :results value raw
+(yas--document-symbols 1 `("Interactive functions" . ,#'interactive-form)
+                         `("Customization variables" . ,#'(lambda (sym)
+                                                            (and (boundp sym)
+                                                                 (get sym 'standard-value))))
+                         `("Useful functions" . ,#'fboundp)
+                         `("Useful variables" . ,#'boundp))
+#+END_SRC

doc/stylesheets/manual.css

@@ -0,0 +1,70 @@
+.center { margin-left: auto; margin-right: auto; text-align: center; }
+.current {
+    font-weight: bold;
+    background-color: #E0E8F0;
+}
+
+body { background-color:  #E4F0F4 }
+div#content {
+    max-width: 20cm;
+    margin-left: auto;
+    margin-right: auto;
+}
+
+nav li {
+    vertical-align: top;
+
+    display: inline;
+    list-style-type: none;
+    padding: 0.5em;
+}
+nav > ul > li {
+    display: inline-block;
+}
+.nopad {
+    padding: 0;
+}
+li.border {
+    border: solid;
+    border-width: 1px;
+}
+
+pre, code{ background-color: #F3F5F7; }
+code {
+    /* http://neugierig.org/software/chromium/notes/2009/09/monospace-fonts-workaround.html */
+    font-family: WorkAroundWebKitAndMozilla, monospace;
+    white-space: nowrap;
+}
+
+/* Styles for htmlize.el fontification.  */
+
+.org-comment        { color: #005000; }    /* font-lock-comment-face */
+.org-keyword        { font-weight: bold; } /* font-lock-keyword-face */
+.org-string         { color: #8b0000; }    /* font-lock-string-face */
+.org-warning        { color: #ff8c00;
+                      font-weight: bold; } /* warning */
+.org-warning-1      { color: #ff0000;
+                      font-weight: bold; } /* font-lock-warning-face */
+.org-preprocessor   { color: #483d8b; }    /* font-lock-preprocessor-face */
+.org-constant       { color: #008b8b; }    /* font-lock-constant-face */
+.org-function-name  { color: #0000ff; }    /* font-lock-function-name-face */
+.org-type           { color: #228b22; }    /* font-lock-type-face */
+.org-variable-name  { color: #a0522d; }    /* font-lock-variable-name-face */
+
+.org-rst-adornment  { color: #a020f0; }            /* rst-adornment */
+.org-rst-block      { color: #a020f0; }            /* rst-block */
+.org-rst-comment    { color: #b22222; }            /* rst-comment */
+.org-rst-definition { color: #0000ff; }            /* rst-definition */
+.org-rst-directive  { color: #483d8b; }            /* rst-directive */
+.org-rst-emphasis1  { font-style: italic; }        /* rst-emphasis1 */
+.org-rst-emphasis2  { font-weight: bold; }         /* rst-emphasis2 */
+.org-rst-external   { color: #228b22; }            /* rst-external */
+.org-rst-level-1    { background-color: #d9d9d9; } /* rst-level-1 */
+.org-rst-level-2    { background-color: #c7c7c7; } /* rst-level-2 */
+.org-rst-level-3    { background-color: #b5b5b5; } /* rst-level-3 */
+.org-rst-level-4    { background-color: #a3a3a3; } /* rst-level-4 */
+.org-rst-level-5    { background-color: #919191; } /* rst-level-5 */
+.org-rst-level-6    { background-color: #7f7f7f; } /* rst-level-6 */
+.org-rst-literal    { color: #8b2252; }            /* rst-literal */
+.org-rst-reference  { color: #a0522d; }            /* rst-reference */
+.org-rst-transition { color: #a020f0; }            /* rst-transition */

doc/stylesheets/styles.css

@@ -1,93 +0,0 @@
-@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;
-    }
-
-
-
-
-}

doc/yas-doc-helper.el

@@ -1,6 +1,6 @@
-;;; yas-doc-helper.el --- Help generate documentation for YASnippet
+;;; yas-doc-helper.el --- Help generate documentation for YASnippet  -*- lexical-binding: t; -*-
 
-;; Copyright (C) 2012  João Távora
+;; Copyright (C) 2012-2023  Free Software Foundation, Inc.
 
 ;; Author: João Távora <joaotavora@gmail.com>
 ;; Keywords: convenience
@@ -24,79 +24,205 @@
 
 ;;; Code:
 
+(eval-when-compile
+  (require 'cl-lib))
+(require 'org)
+(require 'ox-publish)
+(require 'yasnippet) ; docstrings must be loaded
+
+;; Presumably one of org/ox-publish provided the following vars:
+(defvar org-publish-project-alist)
+(defvar org-publish-use-timestamps-flag)
+(defvar org-export-copy-to-kill-ring)
+(defvar org-html-htmlize-output-type)
+
+(defun yas--org-raw-html (tag content &optional attrs)
+  ;; in version 8.0 org-mode changed the export syntax, see
+  ;; http://orgmode.org/worg/org-8.0.html#sec-8-1
+  (format (if (version< org-version "8.0.0")
+              "@<%s>%s@</%s>"                ; old: @<tag>
+            "@@html:<%s>@@%s@@html:</%s>@@") ; new: @@html:<tag>@@
+          (concat tag (if attrs " ") attrs)
+          content tag))
+
 (defun yas--document-symbol (symbol level)
-  (flet ((concat-lines (&rest lines)
-                       (mapconcat #'identity lines "\n")))
   (let* ((stars (make-string level ?*))
+         (args (and (fboundp symbol)
+                    (mapcar #'symbol-name (help-function-arglist symbol t))))
          (heading (cond ((fboundp symbol)
-                           (format "%s =%s= (%s)"
+                         (format
-                                   stars
+                          "%s %s (%s)\n" stars (yas--org-raw-html "code" symbol "class='function'")
-                                   symbol
+                          (mapconcat (lambda (a)
-                                   (mapconcat #'symbol-name
+                                       (format (if (string-prefix-p "&" a)
-                                              (help-function-arglist symbol t) " ")))
+                                                   "/%s/" "=%s=")
+                                               a))
+                                     args " ")))
                         (t
-                           (format "%s =%s=\n" stars symbol))))
+                         (format "%s %s\n" stars
-           (after-heading
+                                 (yas--org-raw-html "code" symbol "class='variable'")))))
-            (concat-lines ":PROPERTIES:"
+         (after-heading (format ":PROPERTIES:\n:CUSTOM_ID: %s\n:END:" symbol))
-                          (format ":CUSTOM_ID: %s" symbol)
+         (text-quoting-style 'grave)
-                          ":END:"))
+         (body (or (cond ((fboundp symbol)
-           (body (or (cond ((boundp symbol)
+                          (let ((doc-synth (car-safe (get symbol 'function-documentation))))
+                            (if (functionp doc-synth)
+                                (funcall doc-synth nil)
+                              (documentation symbol t))))
+                         ((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
+    ;; Do some transformations on the body:
+    ;; ARGxxx becomes @<code>arg@</code>xxx
+    ;; FOO becomes /foo/
     ;; `bar' becomes [[#bar][=bar=]]
-      (setq body (replace-regexp-in-string
+    ;;    (...) becomes #+BEGIN_SRC elisp (...) #+END_SRC
-                  "[A-Z][A-Z-]+" #'(lambda (match)
+    ;; Info node `(some-manual) Node Name' becomes
-                                     (format "/%s/" (downcase match)))
+    ;; [[https://www.gnu.org/software/emacs/manual/html_node/some-manual/Node-Name.html]
-                  body)
+    ;;  [(some-manual) Node Name]]
-            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
+    ;; This is fairly fragile, though it seems to be working for
-                    after-heading
+    ;; now...
-                    body))))
+    (setq body (replace-regexp-in-string
+                "\\<\\([A-Z][-A-Z0-9]+\\)\\(\\sw+\\)?\\>"
+                #'(lambda (match)
+                    (let* ((match1 (match-string 1 match))
+                           (prefix (downcase match1))
+                           (suffix (match-string 2 match))
+                           (fmt (cond
+                                 ((member prefix args)
+                                  (yas--org-raw-html "code" "%s"))
+                                 ((null suffix) "/%s/"))))
+                      (if fmt (format fmt prefix)
+                        match1)))
+                body t t 1)
+          body (replace-regexp-in-string
+                "\\\\{[^}]+}"
+                (lambda (match)
+                  (concat "#+BEGIN_EXAMPLE\n"
+                          (substitute-command-keys match)
+                          "#+END_EXAMPLE\n"))
+                body t t)
+          body (substitute-command-keys body)
+          body (replace-regexp-in-string
+                "Info node `(\\([-a-z]+\\)) \\([A-Za-z0-9 ]+\\)'"
+                (lambda (match)
+                  (let* ((manual (match-string 1 match))
+                         (node (match-string 2 match))
+                         (html-node (replace-regexp-in-string " " "-" node t t)))
+                    (format "Info node\
+ [[https://www.gnu.org/software/emacs/manual/html_node/%s/%s.html][(%s) %s]]"
+                            manual html-node manual node)))
+                body t t)
+          body (replace-regexp-in-string
+                "`\\([-a-z]+\\)'"
+                #'(lambda (match)
+                    (let* ((name (downcase (match-string 1 match)))
+                           (sym (intern-soft name)))
+                      (if (memq sym yas--exported-syms)
+                          (format "[[#%s][=%s=]]" name name)
+                        (format "=%s=" name))))
+                body t t)
+          body (replace-regexp-in-string
+                "\n\n    +(.+\\(?:\n    +.+\\)*"
+                (lambda (match)
+                  (concat "\n#+BEGIN_SRC elisp\n"
+                          match
+                          "\n#+END_SRC\n"))
+                body t t))
+    ;; output the paragraph
+    (concat heading after-heading "\n" body)))
 
 (defun yas--document-symbols (level &rest names-and-predicates)
-  (let ((sym-lists (make-vector (length names-and-predicates) (list)))
+  (let ((sym-lists (make-vector (length names-and-predicates) nil))
-        (retval ""))
+        (stars (make-string level ?*)))
-    (loop for sym in yas--exported-syms
+    (cl-loop for sym in yas--exported-syms
-          do (loop for test in (mapcar #'cdr names-and-predicates)
+             do (cl-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))))
+                              (cl-return))))
-    (loop for slist across sym-lists
+    (cl-loop for slist across sym-lists
              for name in (mapcar #'car names-and-predicates)
-          do (progn
+             concat (format "\n%s %s\n" stars name)
-               (setq retval
+             concat (mapconcat (lambda (sym)
-                     (concat retval
+                                 (yas--document-symbol sym (1+ level)))
-                             (format "\n** %s\n" name)
+                               slist "\n\n"))))
-                             (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)
+(define-key org-mode-map [M-f8] #'yas--internal-link-snippet)
+
+;; This lets all the org files be exported to HTML with
+;; `org-publish-current-project' (C-c C-e P).
+
+(defun yas--make-preamble (props)
+  "Return contents of nav-menu-html.inc.
+But replace link to \"current\" page with a span element."
+  (with-temp-buffer
+    (let ((dir (file-name-directory (plist-get props :input-file))))
+      (insert-file-contents (expand-file-name "nav-menu.html.inc" dir))
+      (goto-char (point-min))
+      (search-forward (concat "<a href=\""
+                              (file-name-nondirectory
+                               (plist-get props :output-file))
+                              "\">"))
+      (replace-match "<span class='current'>")
+      (search-forward "</a>")
+      (replace-match "</span>")
+      (buffer-string))))
+
+(let* ((dir (if load-file-name (file-name-directory load-file-name)
+              default-directory))
+       (src-epoch (getenv "SOURCE_DATE_EPOCH"))
+       ;; Presence of SOURCE_DATE_EPOCH indicates a reproducible
+       ;; build, don't depend on git.
+       (rev (unless src-epoch
+              (ignore-errors
+                (car (process-lines "git" "describe" "--dirty")))))
+       (date (format-time-string
+              "(%Y-%m-%d %H:%M:%S)"
+              (seconds-to-time
+               (string-to-number
+                (or (if rev (car (process-lines "git" "show" "--format=%ct"))
+                      src-epoch)
+                    "0")))
+              t))
+       (proj-plist
+        `(,@(when (fboundp 'org-html-publish-to-html)
+              '(:publishing-function org-html-publish-to-html))
+          :base-directory ,dir :publishing-directory ,dir
+          :html-preamble yas--make-preamble
+          ;;:with-broken-links mark
+          :html-postamble
+          ,(concat "<hr><p class='creator'>Generated by %c from "
+                   rev " " date "</p>\n"
+                   "<p class='xhtml-validation'>%v</p>\n")))
+       (project (assoc "yasnippet" org-publish-project-alist)))
+  (when rev ;; Rakefile :doc:upload uses "html-revision".
+    (with-temp-file (expand-file-name "html-revision" dir)
+      (princ rev (current-buffer))))
+  (if project
+      (setcdr project proj-plist)
+    (push `("yasnippet" . ,proj-plist)
+          org-publish-project-alist)))
+
+(defun yas--generate-html-batch ()
+  (let ((org-publish-use-timestamps-flag nil)
+        (org-export-copy-to-kill-ring nil)
+        (org-confirm-babel-evaluate nil)
+        (make-backup-files nil)
+        (org-html-htmlize-output-type 'css))
+    (org-publish "yasnippet" 'force)))
+
+
 
 (provide 'yas-doc-helper)
-;;; yas-doc-helper.el ends here
 ;; Local Variables:
+;; indent-tabs-mode: nil
 ;; coding: utf-8
 ;; End:
+;;; yas-doc-helper.el ends here

dropdown-list.el

@@ -1,253 +0,0 @@
-;;; dropdown-list.el --- Drop-down menu interface
-;;
-;; Filename: dropdown-list.el
-;; Description: Drop-down menu interface
-;; Copyright (C) 2008-2012 Free Software Foundation, Inc.
-;; Author: Jaeyoun Chung [jay.chung@gmail.com]
-;; Maintainer:
-;; Authors: pluskid <pluskid@gmail.com>,  João Távora <joaotavora@gmail.com>
-;; Created: Sun Mar 16 11:20:45 2008 (Pacific Daylight Time)
-;; Version:
-;; Last-Updated: Sun Mar 16 12:19:49 2008 (Pacific Daylight Time)
-;;           By: dradams
-;;     Update #: 43
-;; URL: http://www.emacswiki.org/cgi-bin/wiki/dropdown-list.el
-;; Keywords: convenience menu
-;; Compatibility: GNU Emacs 21.x, GNU Emacs 22.x
-;;
-;; Features that might be required by this library:
-;;
-;;   `cl'.
-;;
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-;;
-;;; Commentary:
-;;
-;;  According to Jaeyoun Chung, "overlay code stolen from company-mode.el."
-;;
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-;;
-;;; Change log:
-;;
-;; 2008/03/16 dadams
-;;     Clean-up - e.g. use char-to-string for control chars removed by email posting.
-;;     Moved example usage code (define-key*, command-selector) inside the library.
-;;     Require cl.el at byte-compile time.
-;;     Added GPL statement.
-;; 2008/01/06 Jaeyoun Chung
-;;     Posted to gnu-emacs-sources@gnu.org at 9:10 p.m.
-;;
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-;;
-;; 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/>.
-;;
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-;;
-;;; Code:
-
-(eval-when-compile (require 'cl)) ;; decf, fourth, incf, loop, mapcar*
-
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-
-(defface dropdown-list-face
-  '((t :inherit default :background "lightyellow" :foreground "black"))
-  "*Bla." :group 'dropdown-list)
-
-(defface dropdown-list-selection-face
-  '((t :inherit dropdown-list-face :background "purple"))
-  "*Bla." :group 'dropdown-list)
-
-(defvar dropdown-list-overlays nil)
-
-(defun dropdown-list-hide ()
-  (while dropdown-list-overlays
-    (delete-overlay (pop dropdown-list-overlays))))
-
-(defun dropdown-list-put-overlay (beg end &optional prop value prop2 value2)
-  (let ((ov (make-overlay beg end)))
-    (overlay-put ov 'window t)
-    (when prop
-      (overlay-put ov prop value)
-      (when prop2 (overlay-put ov prop2 value2)))
-    ov))
-
-(defun dropdown-list-line (start replacement &optional no-insert)
-  ;; start might be in the middle of a tab, which means we need to hide the
-  ;; tab and add spaces
-  (let ((end (+ start (length replacement)))
-        beg-point end-point
-        before-string after-string)
-    (goto-char (point-at-eol))
-    (if (< (current-column) start)
-        (progn (setq before-string (make-string (- start (current-column)) ? ))
-               (setq beg-point (point)))
-      (goto-char (point-at-bol)) ;; Emacs bug, move-to-column is wrong otherwise
-      (move-to-column start)
-      (setq beg-point (point))
-      (when (> (current-column) start)
-        (goto-char (1- (point)))
-        (setq beg-point (point))
-        (setq before-string (make-string (- start (current-column)) ? ))))
-    (move-to-column end)
-    (setq end-point (point))
-    (let ((end-offset (- (current-column) end)))
-      (when (> end-offset 0) (setq after-string (make-string end-offset ?b))))
-    (when no-insert
-      ;; prevent inheriting of faces
-      (setq before-string (when before-string (propertize before-string 'face 'default)))
-      (setq after-string (when after-string (propertize after-string 'face 'default))))
-    (let ((string (concat before-string replacement after-string)))
-      (if no-insert
-          string
-        (push (dropdown-list-put-overlay beg-point end-point 'invisible t
-                                         'after-string string)
-              dropdown-list-overlays)))))
-
-(defun dropdown-list-start-column (display-width)
-  (let ((column (mod (current-column) (window-width)))
-        (width (window-width)))
-    (cond ((<= (+ column display-width) width) column)
-          ((> column display-width) (- column display-width))
-          ((>= width display-width) (- width display-width))
-          (t nil))))
-
-(defun dropdown-list-move-to-start-line (candidate-count)
-  (decf candidate-count)
-  (let ((above-line-count (save-excursion (- (vertical-motion (- candidate-count)))))
-        (below-line-count (save-excursion (vertical-motion candidate-count))))
-    (cond ((= below-line-count candidate-count)
-           t)
-          ((= above-line-count candidate-count)
-           (vertical-motion (- candidate-count))
-           t)
-          ((>= (+ below-line-count above-line-count) candidate-count)
-           (vertical-motion (- (- candidate-count below-line-count)))
-           t)
-          (t nil))))
-
-(defun dropdown-list-at-point (candidates &optional selidx)
-  (dropdown-list-hide)
-  (let* ((lengths (mapcar #'length candidates))
-         (max-length (apply #'max lengths))
-         (start (dropdown-list-start-column (+ max-length 3)))
-         (i -1)
-         (candidates (mapcar* (lambda (candidate length)
-                                (let ((diff (- max-length length)))
-                                  (propertize
-                                   (concat (if (> diff 0)
-                                               (concat candidate (make-string diff ? ))
-                                             (substring candidate 0 max-length))
-                                           (format "%3d" (+ 2 i)))
-                                   'face (if (eql (incf i) selidx)
-                                             'dropdown-list-selection-face
-                                           'dropdown-list-face))))
-                              candidates
-                              lengths)))
-    (save-excursion
-      (and start
-           (dropdown-list-move-to-start-line (length candidates))
-           (loop initially (vertical-motion 0)
-                 for candidate in candidates
-                 do (dropdown-list-line (+ (current-column) start) candidate)
-                 while (/= (vertical-motion 1) 0)
-                 finally return t)))))
-
-(defun dropdown-list (candidates)
-  (let ((selection)
-        (temp-buffer))
-    (save-window-excursion
-      (unwind-protect
-          (let ((candidate-count (length candidates))
-                done key (selidx 0))
-            (while (not done)
-              (unless (dropdown-list-at-point candidates selidx)
-                (switch-to-buffer (setq temp-buffer (get-buffer-create "*selection*"))
-                                  'norecord)
-                (delete-other-windows)
-                (delete-region (point-min) (point-max))
-                (insert (make-string (length candidates) ?\n))
-                (goto-char (point-min))
-                (dropdown-list-at-point candidates selidx))
-              (setq key (read-key-sequence ""))
-              (cond ((and (stringp key)
-                          (>= (aref key 0) ?1)
-                          (<= (aref key 0) (+ ?0 (min 9 candidate-count))))
-                     (setq selection (- (aref key 0) ?1)
-                           done      t))
-                    ((member key `(,(char-to-string ?\C-p) [up] "p"))
-                     (setq selidx (mod (+ candidate-count (1- (or selidx 0)))
-                                       candidate-count)))
-                    ((member key `(,(char-to-string ?\C-n) [down] "n"))
-                     (setq selidx (mod (1+ (or selidx -1)) candidate-count)))
-                    ((member key `(,(char-to-string ?\f))))
-                    ((member key `(,(char-to-string ?\r) [return]))
-                     (setq selection selidx
-                           done      t))
-                    (t (setq done t)))))
-        (dropdown-list-hide)
-        (and temp-buffer (kill-buffer temp-buffer)))
-      ;;     (when selection
-      ;;       (message "your selection => %d: %s" selection (nth selection candidates))
-      ;;       (sit-for 1))
-      selection)))
-
-(defun define-key* (keymap key command)
-  "Add COMMAND to the multiple-command binding of KEY in KEYMAP.
-Use multiple times to bind different COMMANDs to the same KEY."
-  (define-key keymap key (combine-command command (lookup-key keymap key))))
-
-(defun combine-command (command defs)
-  "$$$$$ FIXME - no doc string"
-  (cond ((null defs) command)
-        ((and (listp defs)
-              (eq 'lambda (car defs))
-              (= (length defs) 4)
-              (listp (fourth defs))
-              (eq 'command-selector (car (fourth defs))))
-         (unless (member `',command (cdr (fourth defs)))
-           (setcdr (fourth defs) (nconc (cdr (fourth defs)) `(',command))))
-         defs)
-        (t
-         `(lambda () (interactive) (command-selector ',defs ',command)))))
-
-(defvar command-selector-last-command nil "$$$$$ FIXME - no doc string")
-
-(defun command-selector (&rest candidates)
-  "$$$$$ FIXME - no doc string"
-  (if (and (eq last-command this-command) command-selector-last-command)
-      (call-interactively command-selector-last-command)
-    (let* ((candidate-strings
-            (mapcar (lambda (candidate)
-                      (format "%s" (if (symbolp candidate)
-                                       candidate
-                                     (let ((s (format "%s" candidate)))
-                                       (if (>= (length s) 7)
-                                           (concat (substring s 0 7) "...")
-                                         s)))))
-                    candidates))
-           (selection (dropdown-list candidate-strings)))
-      (when selection
-        (let ((cmd (nth selection candidates)))
-          (call-interactively cmd)
-          (setq command-selector-last-command cmd))))))
-
-;;;;;;;;;;;;;;;;;;;;
-
-(provide 'dropdown-list)
-
-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-;;; dropdown-list.el ends here
-;; Local Variables:
-;; coding: utf-8
-;; End:

extras/bundles/html-tmbundle

@@ -1 +0,0 @@
-Subproject commit 0bab270103ce27ebd896f80ba303859c549ad3c5

extras/bundles/rails-tmbundle

@@ -1 +0,0 @@
-Subproject commit 683f6e652cc467e0007f80aa11f174a4d9189f3c

extras/bundles/ruby-tmbundle

@@ -1 +0,0 @@
-Subproject commit 74683ecbb353bd39bb942a6f9c82026f82696cd6

extras/imported/html-mode/.yas-setup.el

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

extras/imported/objc-mode/.yas-setup.el

@@ -1,88 +0,0 @@
-(defun yas-objc-docset-query (query)
-  
-  )
-(defvar yas-objc-method-names (make-vector 1023 0))
-(defvar yas-objc-class-names (make-vector 1023 0))
-
-(defvar yas-objc-languages (list))
-(defvar yas-objc-defkinds (list))
-
-
-(defun yas-objc-extract-super-list ()
-  (interactive)
-  (setq yas-objc-method-names (make-vector 1023 0)
-        yas-objc-class-names (make-vector 1023 0)
-        yas-objc-languages (list)
-        yas-objc-defkinds (list))
-  (with-temp-buffer
-    (shell-command
-     "/Developer/usr/bin/docsetutil dump -skip-text /Developer/Documentation/DocSets/com.apple.adc.documentation.AppleSnowLeopard.CoreReference.docset/"
-     (current-buffer))
-    (goto-char (point-min))
-    (search-forward-regexp "API index contains .* tokens")
-    (while (search-forward-regexp "^\\([^/]*\\)/\\([^/]*\\)/\\([^/]*\\)/\\([^/]*\\)$" nil 'noerror)
-      (intern (match-string 3) yas-objc-class-names)
-      (intern (match-string 4) yas-objc-method-names)
-      (add-to-list 'yas-objc-languages (match-string 1))
-      (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)
-;;      'someshit
-;;      'someday)
-
-;; (completing-read "Class: " yas-objc-class-names)
-
-;; (get (intern-soft (setq chosen (completing-read "hey: " yas-objc-method-names)) yas-objc-method-names)
-;;      'someshit)
-
-(defun yas-objc-current-method-signature ()
-  (let ((orig-point (point))
-        (start-point nil)
-        sig
-        orig-ppss
-        ppss)
-    (save-excursion
-      (condition-case nil
-          (while (not (eq (point) (point-min))) (backward-sexp))
-        (error nil))
-      (when (eq (preceding-char) ?\[)
-        (setq orig-ppss (syntax-ppss))
-        (forward-sexp)
-        (skip-chars-forward " \t\n")
-        (setq ppss (syntax-ppss))
-        (while (and (>= (car ppss) (car orig-ppss))
-                    (search-forward-regexp "[[:alpha:]]+:" nil 'noerror))
-          (setq ppss (syntax-ppss))
-          (when (eq (car ppss) (car orig-ppss))
-            (setq sig
-                  (concat (or sig "") (match-string-no-properties 0)))))
-          sig))))
-
-(defun yas-objc-current-method-signature ()
-  (let ((orig-point (point))
-        (start-point nil)
-        sig
-        orig-ppss
-        ppss)
-    (save-excursion
-      (condition-case nil
-          (while (not (eq (point) (point-max))) (backward-sexp))
-        (error ))
-      (when (eq (preceding-char) ?\[)
-        (setq orig-ppss (syntax-ppss))
-        (forward-sexp)
-        (skip-chars-forward " \t\n")
-        (setq ppss (syntax-ppss))
-        (condition-case nil
-            (while (and (>= (car ppss) (car orig-ppss))
-                        (search-forward-regexp "[[:alpha:]]+:" orig-point 'noerror))
-              (setq ppss (syntax-ppss))
-              (when (eq (car ppss) (car orig-ppss))
-                (setq sig
-                      (concat (or sig "") (match-string-no-properties 0))))
-              (forward-sexp))
-          (error nil))
-        (save-excursion
-          (backward-word)
-          (concat sig (buffer-substring-no-properties (point) orig-point)))
-        sig))))

extras/textmate_import.rb

@@ -1,468 +0,0 @@
-#!/usr/bin/env ruby
-# -*- coding: utf-8 -*-
-# textmate_import.rb --- import textmate snippets
-#
-# Copyright (C) 2009 Rob Christie, 2010 João Távora
-#
-# This is a quick script to generate YASnippets from TextMate Snippets.
-#
-# I based the script off of a python script of a similar nature by
-# Jeff Wheeler: http://nokrev.com
-# http://code.nokrev.com/?p=snippet-copier.git;a=blob_plain;f=snippet_copier.py
-#
-# Use textmate_import.rb --help to get usage information.
-
-require 'rubygems'
-require 'plist'
-require 'trollop'
-require 'fileutils'
-require 'shellwords' # String#shellescape
-require 'ruby-debug' if $DEBUG
-
-Encoding.default_external = Encoding::UTF_8 if RUBY_VERSION > '1.8.7'
-
-opts = Trollop::options do
-  opt :bundle_dir, "TextMate bundle directory", :short => '-d', :type => :string
-  opt :output_dir, "Output directory", :short => '-o', :type => :string
-  opt :glob, "Specific snippet file (or glob) inside <bundle_dir>", :short => '-g', :default => '*.{tmSnippet,tmCommand,plist,tmMacro}'
-  opt :pretty, 'Pretty prints multiple snippets when printing to standard out', :short => '-p'
-  opt :quiet, "Be quiet", :short => '-q'
-  opt :plist_file, "Use a specific plist file to derive menu information from", :type => :string
-end
-Trollop::die :bundle_dir, "must be provided" unless opts.bundle_dir
-Trollop::die :bundle_dir, "must exist" unless File.directory? opts.bundle_dir
-
-Trollop::die :output_dir, "must be provided" unless opts.output_dir
-Trollop::die :output_dir, "must exist" unless File.directory? opts.output_dir
-
-Trollop::die :plist_file, "must exist" if opts.plist_file && File.directory?(opts.plist_file)
-
-
-# Represents and is capable of outputting the representation of a
-# TextMate menu in terms of `yas-define-menu'
-#
-class TmSubmenu
-
-  @@excluded_items = [];
-  def self.excluded_items; @@excluded_items; end
-
-  attr_reader :items, :name
-  def initialize(name, hash)
-    @items = hash["items"]
-    @name = name
-  end
-
-  def to_lisp(allsubmenus,
-              deleteditems,
-              indent = 0,
-              thingy = ["(", ")"])
-
-    first = true;
-
-   string = ""
-   separator_useless = true;
-   items.each do |uuid|
-      if deleteditems && deleteditems.index(uuid)
-       $stderr.puts "#{uuid} has been deleted!"
-       next
-     end
-      string += "\n"
-      string += " " * indent
-      string += (first ? thingy[0] : (" " * thingy[0].length))
-
-      submenu = allsubmenus[uuid]
-      snippet = TmSnippet::snippets_by_uid[uuid]
-      unimplemented = TmSnippet::unknown_substitutions["content"][uuid]
-      if submenu
-        str = "(yas-submenu "
-        string += str + "\"" + submenu.name + "\""
-        string += submenu.to_lisp(allsubmenus, deleteditems,
-                                  indent + str.length + thingy[0].length)
-      elsif snippet and not unimplemented
-        string += ";; " + snippet.name + "\n"
-        string += " " * (indent + thingy[0].length)
-        string += "(yas-item \"" + uuid + "\")"
-        separator_useless = false;
-      elsif snippet and unimplemented
-        string += ";; Ignoring " + snippet.name + "\n"
-        string += " " * (indent + thingy[0].length)
-        string += "(yas-ignore-item \"" + uuid + "\")"
-        separator_useless = true;
-      elsif (uuid =~ /---------------------/)
-        string += "(yas-separator)" unless separator_useless
-      end
-      first = false;
-    end
-    string += ")"
-    string += thingy[1]
-
-    return string
-  end
-
-  def self.main_menu_to_lisp (parsed_plist, modename)
-    mainmenu = parsed_plist["mainMenu"]
-    deleted  = parsed_plist["deleted"]
-
-    root = TmSubmenu.new("__main_menu__", mainmenu)
-    all = {}
-
-    mainmenu["submenus"].each_pair do |k,v|
-      all[k] = TmSubmenu.new(v["name"], v)
-    end
-
-    excluded = (mainmenu["excludedItems"] || []) + TmSubmenu::excluded_items
-    closing = "\n                    '("
-    closing+= excluded.collect do |uuid|
-      "\"" + uuid + "\""
-    end.join(  "\n                       ") + "))"
-
-    str = "(yas-define-menu "
-    return str + "'#{modename}" + root.to_lisp(all,
-                                               deleted,
-                                               str.length,
-                                               ["'(" , closing])
-  end
-end
-
-
-# Represents a textmate snippet
-#
-# - @file is the .tmsnippet/.plist file path relative to cwd
-#
-# - optional @info is a Plist.parsed info.plist found in the bundle dir
-#
-# - @@snippets_by_uid is where one can find all the snippets parsed so
-#   far.
-#
-#
-class SkipSnippet < RuntimeError; end
-class TmSnippet
-  @@known_substitutions = {
-    "content"   => {
-      "${TM_RAILS_TEMPLATE_START_RUBY_EXPR}"   => "<%= ",
-      "${TM_RAILS_TEMPLATE_END_RUBY_EXPR}"     => " %>",
-      "${TM_RAILS_TEMPLATE_START_RUBY_INLINE}" => "<% ",
-      "${TM_RAILS_TEMPLATE_END_RUBY_INLINE}"   => " -%>",
-      "${TM_RAILS_TEMPLATE_END_RUBY_BLOCK}"    => "end" ,
-      "${0:$TM_SELECTED_TEXT}"                 => "${0:`yas-selected-text`}",
-      /\$\{(\d+)\}/                            => "$\\1",
-      "${1:$TM_SELECTED_TEXT}"                 => "${1:`yas-selected-text`}",
-      "${2:$TM_SELECTED_TEXT}"                 => "${2:`yas-selected-text`}",
-      '$TM_SELECTED_TEXT'                     => "`yas-selected-text`",
-      %r'\$\{TM_SELECTED_TEXT:([^\}]*)\}'       => "`(or (yas-selected-text) \"\\1\")`",
-      %r'`[^`]+\n[^`]`'                        => Proc.new {|uuid, match| "(yas-multi-line-unknown " + uuid + ")"}},
-    "condition" => {
-      /^source\..*$/ => "" },
-    "binding"   => {},
-    "type"      => {}
-  }
-
-  def self.extra_substitutions; @@extra_substitutions; end
-  @@extra_substitutions = {
-    "content"   => {},
-    "condition" => {},
-    "binding"   => {},
-    "type"      => {}
-  }
-
-  def self.unknown_substitutions; @@unknown_substitutions; end
-  @@unknown_substitutions = {
-    "content"   => {},
-    "condition" => {},
-    "binding"   => {},
-    "type"      => {}
-  }
-
-  @@snippets_by_uid={}
-  def self.snippets_by_uid; @@snippets_by_uid; end
-
-  def initialize(file,info=nil)
-    @file    = file
-    @info    = info
-    @snippet = TmSnippet::read_plist(file)
-    @@snippets_by_uid[self.uuid] = self;
-    raise SkipSnippet.new "not a snippet/command/macro." unless (@snippet["scope"] || @snippet["command"])
-    raise SkipSnippet.new "looks like preferences."if @file =~ /Preferences\//
-    raise RuntimeError.new("Cannot convert this snippet #{file}!") unless @snippet;
-  end
-
-  def name
-    @snippet["name"]
-  end
-
-  def uuid
-    @snippet["uuid"]
-  end
-
-  def key
-    @snippet["tabTrigger"]
-  end
-
-  def condition
-    yas_directive "condition"
-  end
-
-  def type
-    override = yas_directive "type"
-    if override
-      return override
-    else
-      return "# type: command\n" if @file =~ /(Commands\/|Macros\/)/
-    end
-  end
-
-  def binding
-    yas_directive "binding"
-  end
-
-  def content
-    known = @@known_substitutions["content"]
-    extra = @@extra_substitutions["content"]
-    if direct = extra[uuid]
-      return direct
-    else
-      ct = @snippet["content"]
-      if ct
-        known.each_pair do |k,v|
-          if v.respond_to? :call
-            ct.gsub!(k) {|match| v.call(uuid, match)}
-          else
-            ct.gsub!(k,v)
-          end
-        end
-        extra.each_pair do |k,v|
-          ct.gsub!(k,v)
-        end
-        # the remaining stuff is an unknown substitution
-        #
-        [ %r'\$\{ [^/\}\{:]* / [^/]* / [^/]* / [^\}]*\}'x ,
-          %r'\$\{[^\d][^}]+\}',
-          %r'`[^`]+`',
-          %r'\$TM_[\w_]+',
-          %r'\(yas-multi-line-unknown [^\)]*\)'
-        ].each do |reg|
-          ct.scan(reg) do |match|
-            @@unknown_substitutions["content"][match] = self
-          end
-        end
-        return ct
-      else
-        @@unknown_substitutions["content"][uuid] = self
-        TmSubmenu::excluded_items.push(uuid)
-        return "(yas-unimplemented)"
-      end
-    end
-  end
-
-  def to_yas
-    doc = "# -*- mode: snippet -*-\n"
-    doc << (self.type || "")
-    doc << "# uuid: #{self.uuid}\n"
-    doc << "# key: #{self.key}\n" if self.key
-    doc << "# contributor: Translated from textmate snippet by PROGRAM_NAME\n"
-    doc << "# name: #{self.name}\n"
-    doc << (self.binding || "")
-    doc << (self.condition || "")
-    doc << "# --\n"
-    doc << (self.content || "(yas-unimplemented)")
-    doc
-  end
-
-  def self.canonicalize(filename)
-    invalid_char = /[^ a-z_0-9.+=~(){}\/'`&#,-]/i
-
-    filename.
-      gsub(invalid_char, '').  # remove invalid characters
-      gsub(/ {2,}/,' ').       # squeeze repeated spaces into a single one
-      rstrip                   # remove trailing whitespaces
-  end
-
-  def yas_file()
-      File.join(TmSnippet::canonicalize(@file[0, @file.length-File.extname(@file).length]) + ".yasnippet")
-  end
-
-  def self.read_plist(xml_or_binary)
-    begin
-      parsed = Plist::parse_xml(xml_or_binary)
-      return parsed if parsed
-      raise ArgumentError.new "Probably in binary format and parse_xml is very quiet..."
-    rescue StandardError => e
-      if (system "plutil -convert xml1 #{xml_or_binary.shellescape} -o /tmp/textmate_import.tmpxml")
-        return Plist::parse_xml("/tmp/textmate_import.tmpxml")
-      else
-        raise RuntimeError.new "plutil failed miserably, check if you have it..."
-      end
-    end
-  end
-
-  private
-
-  @@yas_to_tm_directives = {"condition" => "scope", "binding" => "keyEquivalent", "key" => "tabTrigger"}
-  def yas_directive(yas_directive)
-    #
-    # Merge "known" hardcoded substitution with "extra" substitutions
-    # provided in the .yas-setup.el file.
-    #
-    merged = @@known_substitutions[yas_directive].
-      merge(@@extra_substitutions[yas_directive])
-    #
-    # First look for an uuid-based direct substitution for this
-    # directive.
-    #
-    if direct = merged[uuid]
-      return "# #{yas_directive}: "+ direct + "\n" unless direct.empty?
-    else
-      tm_directive = @@yas_to_tm_directives[yas_directive]
-      val = tm_directive && @snippet[tm_directive]
-      if val and !val.delete(" ").empty? then
-        #
-        # Sort merged substitutions by length (bigger ones first,
-        # regexps last), and apply them to the value gotten for plist.
-        #
-        allsubs = merged.sort_by do |what, with|
-          if what.respond_to? :length then -what.length else 0 end
-        end
-        allsubs.each do |sub|
-          if val.gsub!(sub[0],sub[1])
-            # puts "SUBBED #{sub[0]} for #{sub[1]}"
-            return "# #{yas_directive}: "+ val + "\n" unless val.empty?
-          end
-        end
-        #
-        # If we get here, no substitution matched, so mark this an
-        # unknown substitution.
-        #
-        @@unknown_substitutions[yas_directive][val] = self
-        return "## #{yas_directive}: \""+ val + "\n"
-      end
-    end
-  end
-
-end
-
-
-if __FILE__ == $PROGRAM_NAME
-  # Read the the bundle's info.plist if can find it/guess it
-  #
-  info_plist_file = opts.plist_file || File.join(opts.bundle_dir,"info.plist")
-  info_plist = TmSnippet::read_plist(info_plist_file) if info_plist_file and File.readable? info_plist_file;
-
-  # Calculate the mode name
-  #
-  modename = File.basename opts.output_dir || "major-mode-name"
-
-  # Read in .yas-setup.el looking for the separator between auto-generated
-  #
-  original_dir = Dir.pwd
-  yas_setup_el_file = File.join(original_dir, opts.output_dir, ".yas-setup.el")
-  separator = ";; --**--"
-  whole, head , tail = "", "", ""
-  if File::exists? yas_setup_el_file
-    File.open yas_setup_el_file, 'r' do |file|
-      whole = file.read
-      head , tail = whole.split(separator)
-    end
-  else
-    head = ";; .yas-setup.el for #{modename}\n" + ";; \n"
-  end
-
-  # Now iterate the tail part to find extra substitutions
-  #
-  tail    ||= ""
-  head    ||= ""
-  directive = nil
-  # puts "get this head #{head}"
-  head.each_line do |line|
-    case line
-    when /^;; Substitutions for:(.*)$/
-      directive = $~[1].strip
-      # puts "found the directove #{directive}"
-    when /^;;(.*)[ ]+=yyas>(.*)$/
-      replacewith = $~[2].strip
-      lookfor = $~[1]
-      lookfor.gsub!(/^[ ]*/, "")
-      lookfor.gsub!(/[ ]*$/, "")
-      # puts "found this wonderful substitution for #{directive} which is #{lookfor} => #{replacewith}"
-      unless !directive or replacewith =~ /yas-unknown/ then
-        TmSnippet.extra_substitutions[directive][lookfor] = replacewith
-      end
-    end
-  end
-
-  # Glob snippets into snippet_files, going into subdirs
-  #
-  Dir.chdir opts.bundle_dir
-  snippet_files_glob = File.join("**", opts.glob)
-  snippet_files = Dir.glob(snippet_files_glob)
-
-  # Attempt to convert each snippet files in snippet_files
-  #
-  puts "Will try to convert #{snippet_files.length} snippets...\n" unless opts.quiet
-
-
-  # Iterate the globbed files
-  #
-  snippet_files.each do |file|
-    begin
-      $stdout.print "Processing \"#{File.join(opts.bundle_dir,file)}\"..." unless opts.quiet
-      snippet = TmSnippet.new(file,info_plist)
-
-      file_to_create = File.join(original_dir, opts.output_dir, snippet.yas_file)
-      FileUtils.mkdir_p(File.dirname(file_to_create))
-      File.open(file_to_create, 'w') do |f|
-        f.write(snippet.to_yas)
-      end
-      $stdout.print "done\n" unless opts.quiet
-    rescue SkipSnippet => e
-      $stdout.print "skipped! #{e.message}\n" unless opts.quiet
-    rescue RuntimeError => e
-      $stderr.print "failed! #{e.message}\n"
-      $strerr.print "#{e.backtrace.join("\n")}" unless opts.quiet
-    end
-  end
-
-  # Attempt to decypher the menu
-  #
-  menustr = TmSubmenu::main_menu_to_lisp(info_plist, modename) if info_plist
-  puts menustr if $DEBUG
-
-  # Write some basic .yas-* files
-  #
-  if opts.output_dir
-    FileUtils.mkdir_p opts.output_dir
-    FileUtils.touch File.join(original_dir, opts.output_dir, ".yas-make-groups") unless menustr
-
-    # Now, output head + a new tail in (possibly new) .yas-setup.el
-    # file
-    #
-    File.open yas_setup_el_file, 'w' do |file|
-      file.puts head
-      file.puts separator
-      file.puts ";; Automatically generated code, do not edit this part"
-      file.puts ";; "
-      file.puts ";; Translated menu"
-      file.puts ";; "
-      file.puts menustr
-      file.puts
-      file.puts ";; Unknown substitutions"
-      file.puts ";; "
-      ["content", "condition", "binding"].each do |type|
-        file.puts ";; Substitutions for: #{type}"
-        file.puts ";; "
-        # TmSnippet::extra_substitutions[type].
-        #   each_pair do |k,v|
-        #   file.puts ";; " + k + "" + (" " * [1, 90-k.length].max) + " =yyas> " + v
-        # end
-        unknown = TmSnippet::unknown_substitutions[type];
-        unknown.keys.uniq.each do |k|
-          file.puts ";; # as in " +  unknown[k].yas_file
-          file.puts ";; " + k + "" + (" " * [1, 90-k.length].max) + " =yyas> (yas-unknown)"
-          file.puts ";; "
-        end
-        file.puts ";; "
-        file.puts
-      end
-      file.puts ";; .yas-setup.el for #{modename} ends here"
-    end
-  end
-end

snippets/c++-mode/.yas-parents

@@ -1 +0,0 @@
-cc-mode

snippets/c++-mode/beginend

@@ -1,4 +0,0 @@
-# name: v.begin(), v.end()
-# key: beginend
-# --
-${1:v}.begin(), $1.end

snippets/c++-mode/class

@@ -1,9 +0,0 @@
-# name: class ... { ... }
-# key: class
-# --
-class ${1:Name}
-{
-public:
-    ${1:$(yas-substr text "[^: ]*")}($2);
-    virtual ~${1:$(yas-substr text "[^: ]*")}();
-};

snippets/c++-mode/ns

@@ -1,4 +0,0 @@
-# name: namespace ...
-# key: ns
-# --
-namespace 

snippets/c++-mode/template

@@ -1,4 +0,0 @@
-# name: template <typename ...>
-# key: template
-# --
-template <typename ${T}>

snippets/c++-mode/using

@@ -1,5 +0,0 @@
-# name: using namespace ... 
-# key: using
-# --
-using namespace ${std};
-$0

snippets/c-mode/.yas-parents

@@ -1 +0,0 @@
-cc-mode

snippets/c-mode/fopen

@@ -1,4 +0,0 @@
-# name: FILE *fp = fopen(..., ...);
-# key: fopen
-# --
-FILE *${fp} = fopen(${"file"}, "${r}");

snippets/c-mode/printf

@@ -1,7 +0,0 @@
-# -*- mode: snippet -*-
-# name: printf 
-# contributor: joaotavora
-# key: printf
-# --
-printf ("${1:%s}\\n"${1:$(if (string-match "%" text) "," "\);")
-}$2${1:$(if (string-match "%" text) "\);" "")}

snippets/cc-mode/.yas-parents

@@ -1 +0,0 @@
-text-mode

snippets/cc-mode/do

@@ -1,7 +0,0 @@
-# name: do { ... } while (...)
-# key: do
-# --
-do
-{
-    $0
-} while (${1:condition});

snippets/cc-mode/for

@@ -1,7 +0,0 @@
-# name: for (...; ...; ...) { ... }
-# key: for
-# --
-for (${1:int i = 0}; ${2:i < N}; ${3:++i})
-{
-    $0
-}

snippets/cc-mode/if

@@ -1,7 +0,0 @@
-# name: if (...) { ... }
-# key: if
-# --
-if (${1:condition})
-{
-    $0
-}

snippets/cc-mode/inc

@@ -1,4 +0,0 @@
-# name: #include "..."
-# key: inc
-# --
-#include "$1"

snippets/cc-mode/inc.1

@@ -1,4 +0,0 @@
-# name: #include <...>
-# key: inc
-# --
-#include <$1>

snippets/cc-mode/main

@@ -1,8 +0,0 @@
-# name: int main(argc, argv) { ... }
-# key: main
-# --
-int main(int argc, char *argv[])
-{
-    $0
-    return 0;
-}

snippets/cc-mode/once

@@ -1,9 +0,0 @@
-# name: #ifndef XXX; #define XXX; #endif
-# key: once
-# --
-#ifndef ${1:_`(upcase (file-name-nondirectory (file-name-sans-extension (buffer-file-name))))`_H_}
-#define $1
-
-$0
-
-#endif /* $1 */

snippets/cc-mode/struct

@@ -1,7 +0,0 @@
-# name: struct ... { ... }
-# key: struct
-# --
-struct ${1:name}
-{
-    $0
-};

snippets/cperl-mode/.yas-parents

@@ -1 +0,0 @@
-perl-mode

snippets/csharp-mode/.yas-parents

@@ -1 +0,0 @@
-cc-mode

snippets/csharp-mode/attrib

@@ -1,8 +0,0 @@
-# contributor: Alejandro Espinoza Esparza <aespinoza@structum.com.mx>
-# name: private attribute ....;
-# key: attrib
-# --
-/// <summary>
-/// $3
-/// </summary>
-private $1 $2;

snippets/csharp-mode/attrib.1

@@ -1,22 +0,0 @@
-# contributor: Alejandro Espinoza Esparza <aespinoza@structum.com.mx>
-# name: private attribute ....; public property ... ... { ... }
-# key: attrib
-# --
-/// <summary>
-/// $3
-/// </summary>
-private $1 $2;
-
-/// <summary>
-/// $4
-/// </summary>
-/// <value>$5</value>
-public $1 $2
-{
-    get {
-        return this.$2;
-    }
-    set {
-        this.$2 = value;
-    }
-}

snippets/csharp-mode/attrib.2

@@ -1,22 +0,0 @@
-# contributor: Alejandro Espinoza Esparza <aespinoza@structum.com.mx>
-# name: private _attribute ....; public Property ... ... { ... }
-# key: attrib
-# --
-/// <summary>
-/// $3
-/// </summary>
-private $1 ${2:$(if (> (length text) 0) (format "_%s%s" (downcase (substring text 0 1)) (substring text 1 (length text))) "")};
-
-/// <summary>
-/// ${3:Description}
-/// </summary>
-/// <value><c>$1</c></value>
-public ${1:Type} ${2:Name}
-{
-    get {
-        return this.${2:$(if (> (length text) 0) (format "_%s%s" (downcase (substring text 0 1)) (substring text 1 (length text))) "")};
-    }
-    set {
-        this.${2:$(if (> (length text) 0) (format "_%s%s" (downcase (substring text 0 1)) (substring text 1 (length text))) "")} = value;
-    }
-}

snippets/csharp-mode/class

@@ -1,22 +0,0 @@
-# contributor: Alejandro Espinoza Esparza <aespinoza@structum.com.mx>
-# name: class ... { ... }
-# key: class
-# --
-${5:public} class ${1:Name}
-{
-    #region Ctor & Destructor
-    /// <summary>
-    /// ${3:Standard Constructor}
-    /// </summary>
-    public $1($2)
-    {
-    }
-
-    /// <summary>
-    /// ${4:Default Destructor}
-    /// </summary>    
-    public ~$1()
-    {
-    }
-    #endregion
-}

snippets/csharp-mode/comment

@@ -1,7 +0,0 @@
-# contributor: Alejandro Espinoza Esparza <aespinoza@structum.com.mx>
-# name: /// <summary> ... </summary>
-# key: comment
-# --
-/// <summary>
-/// $1
-/// </summary>

snippets/csharp-mode/comment.1

@@ -1,5 +0,0 @@
-# contributor: Alejandro Espinoza Esparza <aespinoza@structum.com.mx>
-# name: /// <param name="..."> ... </param>
-# key: comment
-# --
-/// <param name="$1">$2</param>

snippets/csharp-mode/comment.2

@@ -1,5 +0,0 @@
-# contributor: Alejandro Espinoza Esparza <aespinoza@structum.com.mx>
-# name: /// <param name="..."> ... </param>
-# key: comment
-# --
-/// <returns>$1</returns>

snippets/csharp-mode/comment.3

@@ -1,5 +0,0 @@
-# contributor: Alejandro Espinoza Esparza <aespinoza@structum.com.mx>
-# name: /// <exception cref="..."> ... </exception>
-# key: comment
-# --
-/// <exception cref="$1">$2</exception>

snippets/csharp-mode/method

@@ -1,11 +0,0 @@
-# contributor: Alejandro Espinoza Esparza <aespinoza@structum.com.mx>
-# name: public void Method { ... }
-# key: method
-# --
-/// <summary>
-/// ${5:Description}
-/// </summary>${2:$(if (string= (upcase text) "VOID") "" (format "%s%s%s" "\n/// <returns><c>" text "</c></returns>"))}
-${1:public} ${2:void} ${3:MethodName}($4)
-{
-$0
-}

snippets/csharp-mode/namespace

@@ -1,8 +0,0 @@
-# contributor: Alejandro Espinoza Esparza <aespinoza@structum.com.mx>
-# name: namespace .. { ... }
-# key: namespace
-# --
-namespace $1
-{
-$0
-}

snippets/csharp-mode/prop

@@ -1,17 +0,0 @@
-# contributor: Alejandro Espinoza Esparza <aespinoza@structum.com.mx>
-# name: property ... ... { ... }
-# key: prop
-# --
-/// <summary>
-/// $5
-/// </summary>
-/// <value>$6</value>
-$1 $2 $3
-{
-    get {
-        return this.$4;
-    }
-    set {
-        this.$4 = value;
-    }
-}

snippets/csharp-mode/region

@@ -1,7 +0,0 @@
-# contributor: Alejandro Espinoza Esparza <aespinoza@structum.com.mx>
-# name: #region ... #endregion
-# key: region
-# --
-#region $1
-$0
-#endregion

snippets/csharp-mode/using

@@ -1,5 +0,0 @@
-# contributor: Alejandro Espinoza Esparza <aespinoza@structum.com.mx>
-# name: using ...;
-# key: using
-# --
-using $1;

snippets/csharp-mode/using.1

@@ -1,5 +0,0 @@
-# contributor: Alejandro Espinoza Esparza <aespinoza@structum.com.mx>
-# name: using System;
-# key: using
-# --
-using System;

snippets/csharp-mode/using.2

@@ -1,5 +0,0 @@
-# contributor: Alejandro Espinoza Esparza <aespinoza@structum.com.mx>
-# name: using System....;
-# key: using
-# --
-using System.$1;

snippets/css-mode/.yas-parents

@@ -1 +0,0 @@
-text-mode

snippets/css-mode/bg

@@ -1,4 +0,0 @@
-# name: background-color: ...
-# key: bg
-# --
-background-color: #${1:DDD};

snippets/css-mode/bg.1

@@ -1,4 +0,0 @@
-# name: background-image: ...
-# key: bg
-# --
-background-image: url($1);

snippets/css-mode/bor

@@ -1,4 +0,0 @@
-# name: border size style color
-# key: bor
-# --
-border: ${1:1px} ${2:solid} #${3:999};

snippets/css-mode/cl

@@ -1,5 +0,0 @@
-# contributor: rejeep <johan.rejeep@gmail.com>
-# name: clear: ...
-# key: cl
-# --
-clear: $1;

snippets/css-mode/disp.block

@@ -1,5 +0,0 @@
-# contributor: rejeep <johan.rejeep@gmail.com>
-# name: display: block
-# key: disp
-# --
-display: block;

snippets/css-mode/disp.inline

@@ -1,5 +0,0 @@
-# contributor: rejeep <johan.rejeep@gmail.com>
-# name: display: inline
-# key: disp
-# --
-display: inline;

snippets/css-mode/disp.none

@@ -1,5 +0,0 @@
-# contributor: rejeep <johan.rejeep@gmail.com>
-# name: display: none
-# key: disp
-# --
-display: none;

snippets/css-mode/ff

@@ -1,5 +0,0 @@
-# contributor: rejeep <johan.rejeep@gmail.com>
-# name: font-family: ...
-# key: ff
-# --
-font-family: $1;

snippets/css-mode/fs

@@ -1,5 +0,0 @@
-# contributor: rejeep <johan.rejeep@gmail.com>
-# name: font-size: ...
-# key: fs
-# --
-font-size: ${12px};

snippets/css-mode/mar.bottom

@@ -1,5 +0,0 @@
-# contributor: rejeep <johan.rejeep@gmail.com>
-# name: margin-bottom: ...
-# key: mar
-# --
-margin-bottom: $1;

snippets/css-mode/mar.left

@@ -1,5 +0,0 @@
-# contributor: rejeep <johan.rejeep@gmail.com>
-# name: margin-left: ...
-# key: mar
-# --
-margin-left: $1;

snippets/css-mode/mar.mar

@@ -1,5 +0,0 @@
-# contributor: rejeep <johan.rejeep@gmail.com>
-# name: margin: ...
-# key: mar
-# --
-margin: $1;

snippets/css-mode/mar.margin

@@ -1,5 +0,0 @@
-# contributor: rejeep <johan.rejeep@gmail.com>
-# name: margin top right bottom left
-# key: mar
-# --
-margin: ${top} ${right} ${bottom} ${left};

snippets/css-mode/mar.right

@@ -1,5 +0,0 @@
-# contributor: rejeep <johan.rejeep@gmail.com>
-# name: margin-right: ...
-# key: mar
-# --
-margin-right: $1;

snippets/css-mode/mar.top

@@ -1,5 +0,0 @@
-# contributor: rejeep <johan.rejeep@gmail.com>
-# name: margin-top: ...
-# key: mar
-# --
-margin-top: $1;

snippets/css-mode/pad.bottom

@@ -1,5 +0,0 @@
-# contributor: rejeep <johan.rejeep@gmail.com>
-# name: padding-bottom: ...
-# key: pad
-# --
-padding-bottom: $1;

snippets/css-mode/pad.left

@@ -1,5 +0,0 @@
-# contributor: rejeep <johan.rejeep@gmail.com>
-# name: padding-left: ...
-# key: pad
-# --
-padding-left: $1;

snippets/css-mode/pad.pad

@@ -1,5 +0,0 @@
-# contributor: rejeep <johan.rejeep@gmail.com>
-# name: padding: ...
-# key: pad
-# --
-padding: $1;

snippets/css-mode/pad.padding

@@ -1,5 +0,0 @@
-# contributor: rejeep <johan.rejeep@gmail.com>
-# name: padding: top right bottom left
-# key: pad
-# --
-padding: ${top} ${right} ${bottom} ${left};

snippets/css-mode/pad.right

@@ -1,5 +0,0 @@
-# contributor: rejeep <johan.rejeep@gmail.com>
-# name: padding-right: ...
-# key: pad
-# --
-padding-right: $1;

snippets/css-mode/pad.top

@@ -1,5 +0,0 @@
-# contributor: rejeep <johan.rejeep@gmail.com>
-# name: padding-top: ...
-# key: pad
-# --
-padding-top: $1;

snippets/emacs-lisp-mode/.read_me

@@ -1,7 +0,0 @@
--*- coding: utf-8 -*-
-Originally started by Xah Lee (xahlee.org) on 2009-02-22
-Released under GPL 3.
-
-Feel free to add missing ones or modify existing ones to improve.
-
-Those starting with “x-” are supposed to be idiom templates. Not sure it's very useful. They might start with “i-” or "id-" in the future.

snippets/emacs-lisp-mode/.yas-parents

@@ -1 +0,0 @@
-text-mode

snippets/emacs-lisp-mode/add-hook.yasnippet

@@ -1,6 +0,0 @@
-# contributor: Xah Lee (XahLee.org)
-# name: add-hook
-# key: add-hook
-# key: ah
-# --
-(add-hook HOOK$0 FUNCTION)

snippets/emacs-lisp-mode/and.yasnippet

@@ -1,6 +0,0 @@
-# contributor: Xah Lee (XahLee.org)
-# name: and
-# key: and
-# key: a
-# --
-(and $0)

snippets/emacs-lisp-mode/append.yasnippet

@@ -1,5 +0,0 @@
-# contributor: Xah Lee (XahLee.org)
-# name: append
-# key: append
-# --
-(append $0 )

snippets/emacs-lisp-mode/apply.yasnippet

@@ -1,5 +0,0 @@
-# contributor: Xah Lee (XahLee.org)
-# name: apply
-# key: apply
-# --
-(apply $0 )

snippets/emacs-lisp-mode/aref.yasnippet

@@ -1,5 +0,0 @@
-# contributor: Xah Lee (XahLee.org)
-# name: aref
-# key: aref
-# --
-(aref ARRAY$0 INDEX)

snippets/emacs-lisp-mode/aset.yasnippet

@@ -1,5 +0,0 @@
-# contributor: Xah Lee (XahLee.org)
-# name: aset
-# key: aset
-# --
-(aset ARRAY$0 IDX NEWELT)

snippets/emacs-lisp-mode/assq.yasnippet

@@ -1,5 +0,0 @@
-# contributor: Xah Lee (XahLee.org)
-# name: assq
-# key: assq
-# --
-(assq KEY$0 LIST)

snippets/emacs-lisp-mode/autoload.yasnippet

@@ -1,5 +0,0 @@
-# contributor: Xah Lee (XahLee.org)
-# name: autoload
-# key: autoload
-# --
-(autoload 'FUNCNAME$0 "FILENAME" &optional "DOCSTRING" INTERACTIVE TYPE)