.gitignore

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

.gitmodules

@@ -0,0 +1,9 @@
+[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

@@ -1,49 +0,0 @@
-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

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

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

@@ -1,574 +0,0 @@
-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,26 +1,29 @@
-[![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
+**YASnippet** is a template system for Emacs. It allows you to type an
-type an abbreviation and automatically expand it into function
+abbreviation and automatically expand it into function
-templates. Bundled language templates include: C, C++, C#, Perl,
+templates. Bundled language templates includes: C, C++, C#, Perl,
-Python, Ruby, SQL, LaTeX, HTML, CSS and more. The snippet syntax
+Python, Ruby,
-is inspired from [TextMate's][textmate-snippets] syntax, you can
+
-even [import](#import) most TextMate templates to
+SQL, LaTeX, HTML, CSS and more. The snippet syntax is inspired from
-YASnippet. Watch [a demo on YouTube][youtube-demo].
+[TextMate's][textmate-snippets] syntax, you can even
+[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
 
-## Manual install from Git
+## Install the most recent version
 
 Clone this repository somewhere
 
     $ cd ~/.emacs.d/plugins
-    $ git clone --recursive https://github.com/joaotavora/yasnippet
+    $ git clone https://github.com/capitaomorte/yasnippet
 
 Add the following in your `.emacs` file:
 
@@ -33,136 +36,108 @@ 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
+In a recent emacs `M-x list-packages` is the recommended way to list and install packages.
-and install packages.
+[MELPA][melpa] keeps a very recent snapshot of YASnippet, see http://melpa.milkbox.net/#installing.
-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 another nice way to get the most recent version, too. See
+El-get is a nice way to get the most recent version, too. See
-https://github.com/dimitri/el-get for instructions.
+https://github.com/dimitri/el-get for instructions. Be sure to install the
+"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, don't call
+To use YASnippet as a non-global minor mode, replace `(yas-global-mode 1)` with
-`yas-global-mode`; instead call `yas-reload-all` to load the snippet
+`(yas-reload-all)` to load the snippet tables. Then add a call to
-tables and then call `yas-minor-mode` from the hooks of major-modes
+`(yas-minor-mode)` to the major-modes where you to enable YASnippet.
-where you want YASnippet enabled.
 
-    (yas-reload-all)
+    (add-hook 'prog-mode-hook
-    (add-hook 'prog-mode-hook #'yas-minor-mode)
+              '(lambda ()
+                 (yas-minor-mode)))
 
-# Where are the snippets?
+# (NOT) Contributing snippets
 
-<a name="import"></a>
+Please **do not** open pull requests or ask me to add snippets to
+YASnippet.
 
-YASnippet no longer bundles snippets directly, but it's very easy to
+The bundled collection under `/snippets` is considered frozen: **I
-get some!
+will not add more snippets to it**.
 
-1. [yasnippet-snippets] - a snippet collection package maintained by
+You can point `yas-snippet-dirs` to good snippet collections out
-    [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
+          '("~/.emacs.d/snippets"            ;; personal snippets
-            "/path/to/some/collection/"           ;; foo-mode and bar-mode snippet collection
+            "/path/to/some/collection/"      ;; just some foo-mode snippets
-            "/path/to/yasnippet/yasmate/snippets" ;; the yasmate collection
+            "/path/to/some/othercollection/" ;; some more foo-mode and a complete baz-mode
+            "/path/to/yasnippet/snippets"    ;; the default collection
             ))
 
     (yas-global-mode 1) ;; or M-x yas-reload-all if you've started YASnippet already.
 
-# Manual, issues etc
+# Importing TextMate snippets
 
-There's comprehensive [documentation][docs] on using and customising
+There is a tool `extras/textmate-import.rb` than can import many
-YASnippet.
+actual TextMate snippets. These can be quite complex so the
+`extras/imported/*-mode/.yas-setup.el` files help it with the more
+difficult importation.
 
-There's a [list of support issues][support-issues], with solutions to
+I'm focusing on developing `textmate-import.rb` tool and some
-common problems and practical snippet examples.
+`yas-setup.el` files. In the future `/snippets` snippets will be
+deprecated and might be replaced with `extras/imported`.
 
-The [Github issue tracker][issues] is where most YASnippet-related
+## Example importation of rails snippets
-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.
 
-## Important note regarding bug reporting
+To start using [drnic's](https://github.com/drnic) snippets for rails
+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.
 
-Your bug reports are very valuable.
+After cloning this repository to `~/.emacs.d/plugins/yasnippet`
 
-The most important thing when reporting bugs is making sure that we have
+    cd ~/.emacs.d/plugins/yasnippet
-a way to reproduce the problem exactly like it happened to you.
+    git submodule init
+    git submodule update
+    gem install plist trollop
+    rake convert_bundles             # will convert ruby, rails and html bundles
 
-To do this, we need to rule out interference from external factors
+Then, in your `.emacs` file
-like other Emacs extensions or your own customisations.
 
-Here's an example report that "sandboxes" an Emacs session just for
+    (add-to-list 'load-path
-reproducing a bug.
+                  "~/.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
-$ emacs --version
+snippets.  Note that in the example above we have abandoned the
-Emacs 24.3
+default snippet collection on `~/.emacs.d/plugins/yasnippet/snippets`
-$ 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
 
-(require 'yasnippet)
+# Documentation, issues, etc
-(yas-global-mode 1)
 
-When I open a foo-mode file I don't see foo-mode under the "YASnippet" menu!
+Please refer to the comprehensive (albeit slightly outdated)
-OR
+[documentation][docs] for full customization
-When loading yasnippet I see "Error: failed to frobnicate"!
+and support.  If you find a bug, please report it on
-```
+[the GitHub issue tracker][issues].  (please **do not** submit new issues to the old
+[googlecode tracker][googlecode tracker])
 
-Using `emacs -Q` or temporarily moving your `.emacs` init file to the side
+If you run into problems using YASnippet, or have snippets to contribute, post
-is another way to achieve good reproducibility.
+to the [YASnippet google group][forum]. Thank you very much for using YASnippet!
 
-Here's a
+[docs]: http://capitaomorte.github.com/yasnippet/
-[another example](https://github.com/joaotavora/yasnippet/issues/318)
+[issues]: https://github.com/capitaomorte/yasnippet/issues
-of a bug report. It has everything needed for a successful analysis
-and speedy resolution.
-
-Also, don't forget to state the Emacs version (use `M-x emacs-version`) and
-the yasnippet version you are using (if using the latest from github,
-do `git log -1` in the dir).
-
-Any more info is welcome, but don't just paste a backtrace or an error
-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

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

Rakefile

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

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

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

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

doc/nav-menu.html.inc

@@ -1,16 +0,0 @@
-<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

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

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

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

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

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

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

@@ -1,70 +0,0 @@
-.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

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

doc/yas-doc-helper.el

@@ -1,6 +1,6 @@
-;;; yas-doc-helper.el --- Help generate documentation for YASnippet  -*- lexical-binding: t; -*-
+;;; yas-doc-helper.el --- Help generate documentation for YASnippet
 
-;; Copyright (C) 2012-2023  Free Software Foundation, Inc.
+;; Copyright (C) 2012  João Távora
 
 ;; Author: João Távora <joaotavora@gmail.com>
 ;; Keywords: convenience
@@ -24,205 +24,79 @@
 
 ;;; 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)
-  (let* ((stars (make-string level ?*))
+  (flet ((concat-lines (&rest lines)
-         (args (and (fboundp symbol)
+                       (mapconcat #'identity lines "\n")))
-                    (mapcar #'symbol-name (help-function-arglist symbol t))))
+    (let* ((stars (make-string level ?*))
-         (heading (cond ((fboundp symbol)
+           (heading (cond ((fboundp symbol)
-                         (format
+                           (format "%s =%s= (%s)"
-                          "%s %s (%s)\n" stars (yas--org-raw-html "code" symbol "class='function'")
+                                   stars
-                          (mapconcat (lambda (a)
+                                   symbol
-                                       (format (if (string-prefix-p "&" a)
+                                   (mapconcat #'symbol-name
-                                                   "/%s/" "=%s=")
+                                              (help-function-arglist symbol t) " ")))
-                                               a))
+                          (t
-                                     args " ")))
+                           (format "%s =%s=\n" stars symbol))))
-                        (t
+           (after-heading
-                         (format "%s %s\n" stars
+            (concat-lines ":PROPERTIES:"
-                                 (yas--org-raw-html "code" symbol "class='variable'")))))
+                          (format ":CUSTOM_ID: %s" symbol)
-         (after-heading (format ":PROPERTIES:\n:CUSTOM_ID: %s\n:END:" symbol))
+                          ":END:"))
-         (text-quoting-style 'grave)
+           (body (or (cond ((boundp symbol)
-         (body (or (cond ((fboundp symbol)
+                            (documentation-property symbol 'variable-documentation t))
-                          (let ((doc-synth (car-safe (get symbol 'function-documentation))))
+                           ((fboundp symbol)
-                            (if (functionp doc-synth)
+                            (documentation-property symbol 'function-documentation t))
-                                (funcall doc-synth nil)
+                           (t
-                              (documentation symbol t))))
+                            (format "*WARNING*: no symbol named =%s=" symbol)))
-                         ((boundp symbol)
+                     (format "*WARNING*: no doc for symbol =%s=" symbol)))
-                          (documentation-property symbol 'variable-documentation t))
+           (case-fold-search nil))
-                         (t
+      ;; do some transformations on the body: FOO becomes /foo/ and
-                          (format "*WARNING*: no symbol named =%s=" symbol)))
+      ;; `bar' becomes [[#bar][=bar=]]
-                   (format "*WARNING*: no doc for symbol =%s=" symbol)))
+      (setq body (replace-regexp-in-string
-         (case-fold-search nil))
+                  "[A-Z][A-Z-]+" #'(lambda (match)
-    ;; Do some transformations on the body:
+                                     (format "/%s/" (downcase match)))
-    ;; ARGxxx becomes @<code>arg@</code>xxx
+                  body)
-    ;; FOO becomes /foo/
+            body (replace-regexp-in-string "`\\([a-z-]+\\)'" #'(lambda (match)
-    ;; `bar' becomes [[#bar][=bar=]]
+                                                                 (let* ((name (downcase (match-string 1 match)))
-    ;;    (...) becomes #+BEGIN_SRC elisp (...) #+END_SRC
+                                                                        (sym (intern name)))
-    ;; Info node `(some-manual) Node Name' becomes
+                                                                   (if (and (or (boundp sym)
-    ;; [[https://www.gnu.org/software/emacs/manual/html_node/some-manual/Node-Name.html]
+                                                                                (fboundp sym))
-    ;;  [(some-manual) Node Name]]
+                                                                            (save-match-data
-    ;;
+                                                                              (string-match "^yas-" name)))
-    ;; This is fairly fragile, though it seems to be working for
+                                                                       (format "[[#%s][=%s=]]"
-    ;; now...
+                                                                               name name)
-    (setq body (replace-regexp-in-string
+                                                                     (format "=%s=" name))))
-                "\\<\\([A-Z][-A-Z0-9]+\\)\\(\\sw+\\)?\\>"
+                                           body))
-                #'(lambda (match)
+      ;; output the paragraph
-                    (let* ((match1 (match-string 1 match))
+      ;;
-                           (prefix (downcase match1))
+      (concat-lines heading
-                           (suffix (match-string 2 match))
+                    after-heading
-                           (fmt (cond
+                    body))))
-                                 ((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) nil))
+  (let ((sym-lists (make-vector (length names-and-predicates) (list)))
-        (stars (make-string level ?*)))
+        (retval ""))
-    (cl-loop for sym in yas--exported-syms
+    (loop for sym in yas--exported-syms
-             do (cl-loop for test in (mapcar #'cdr names-and-predicates)
+          do (loop for test in (mapcar #'cdr names-and-predicates)
-                         for i from 0
+                   for i from 0
-                         do (when (funcall test sym)
+                   do (when (funcall test sym)
-                              (push sym (aref sym-lists i))
+                        (push sym (aref sym-lists i))
-                              (cl-return))))
+                        (return))))
-    (cl-loop for slist across sym-lists
+    (loop for slist across sym-lists
-             for name in (mapcar #'car names-and-predicates)
+          for name in (mapcar #'car names-and-predicates)
-             concat (format "\n%s %s\n" stars name)
+          do (progn
-             concat (mapconcat (lambda (sym)
+               (setq retval
-                                 (yas--document-symbol sym (1+ level)))
+                     (concat retval
-                               slist "\n\n"))))
+                             (format "\n** %s\n" name)
+                             (mapconcat #'yas--document-symbol slist "\n\n")))))
+    retval))
 
 (defun yas--internal-link-snippet ()
   (interactive)
   (yas-expand-snippet "[[#$1][=${1:`yas/selected-text`}=]]"))
 
-(define-key org-mode-map [M-f8] #'yas--internal-link-snippet)
+(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

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

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

extras/bundles/rails-tmbundle

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

extras/bundles/ruby-tmbundle

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

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

@@ -0,0 +1,690 @@
+;; .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

@@ -0,0 +1,88 @@
+(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

@@ -0,0 +1,468 @@
+#!/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

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

snippets/c++-mode/beginend

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

snippets/c++-mode/class

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

snippets/c++-mode/ns

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

snippets/c++-mode/template

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

snippets/c++-mode/using

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

snippets/c-mode/.yas-parents

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

snippets/c-mode/fopen

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

snippets/c-mode/printf

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

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

snippets/cc-mode/do

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

snippets/cc-mode/for

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

snippets/cc-mode/if

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

snippets/cc-mode/inc

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

snippets/cc-mode/inc.1

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

snippets/cc-mode/main

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

snippets/cc-mode/once

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

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

snippets/cperl-mode/.yas-parents

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

snippets/csharp-mode/.yas-parents

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

snippets/csharp-mode/attrib

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

snippets/csharp-mode/attrib.1

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

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

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

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

snippets/csharp-mode/comment.1

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

snippets/csharp-mode/comment.2

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

snippets/csharp-mode/comment.3

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

snippets/csharp-mode/method

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

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

snippets/csharp-mode/prop

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

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

snippets/csharp-mode/using

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

snippets/csharp-mode/using.1

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

snippets/csharp-mode/using.2

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

snippets/css-mode/.yas-parents

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

snippets/css-mode/bg

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

snippets/css-mode/bg.1

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

snippets/css-mode/bor

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

snippets/css-mode/cl

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

snippets/css-mode/disp.block

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

snippets/css-mode/disp.inline

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

snippets/css-mode/disp.none

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

snippets/css-mode/ff

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

snippets/css-mode/fs

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

snippets/css-mode/mar.bottom

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

snippets/css-mode/mar.left

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

snippets/css-mode/mar.mar

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

snippets/css-mode/mar.margin

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

snippets/css-mode/mar.right

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

snippets/css-mode/mar.top

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

snippets/css-mode/pad.bottom

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

snippets/css-mode/pad.left

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

snippets/css-mode/pad.pad

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

snippets/css-mode/pad.padding

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

snippets/css-mode/pad.right

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

snippets/css-mode/pad.top

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

snippets/emacs-lisp-mode/.read_me

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

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

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

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

snippets/emacs-lisp-mode/and.yasnippet

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

snippets/emacs-lisp-mode/append.yasnippet

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

snippets/emacs-lisp-mode/apply.yasnippet

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

snippets/emacs-lisp-mode/aref.yasnippet

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

snippets/emacs-lisp-mode/aset.yasnippet

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

snippets/emacs-lisp-mode/assq.yasnippet

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

snippets/emacs-lisp-mode/autoload.yasnippet

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