Update FAQ

* doc/faq.org: Add two questions about yas-key-syntaxes.  Remove
reference to obsolete Google Groups.  Remove question about turning
off minor mode in some buffers, it was out of date, and not frequently
asked.
* yasnippet.el (yas-key-syntaxes): Fix docstring.
This commit is contained in:
Noam Postavsky 2018-09-16 18:01:33 -04:00
parent eeb05f0910
commit 3c0be40e21
2 changed files with 14 additions and 20 deletions

View File

@ -7,6 +7,16 @@
the Github issue tracker. It might be more up-to-date than this the Github issue tracker. It might be more up-to-date than this
list. 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? * Why is there an extra newline?
If there is a newline at the end of a snippet definition file, If there is a newline at the end of a snippet definition file,
@ -33,9 +43,9 @@ active:
This is apparently related to overlay priorities. For some reason, the This is apparently related to overlay priorities. For some reason, the
=keymap= property of flyspell's overlays always takes priority over the =keymap= property of flyspell's overlays always takes priority over the
same property in YASnippet's overlays, even if one sets the latter's same property in YASnippet's overlays, even if one sets the latter's
=priority= property to something big. If you know emacs-lisp and can =priority= property to something big. If you know emacs-lisp
solve this problem, drop a line in the and can solve this problem, send a message to bug-gnu-emacs@gnus.org
[[http://groups.google.com/group/smart-snippet][discussion group]]. or the [[Github issue tracker][https://github.com/joaotavora/yasnippet/issues/]].
* How do I use alternative keys, i.e. not TAB? * How do I use alternative keys, i.e. not TAB?
@ -56,22 +66,6 @@ Edit the keymaps [[sym:yas-minor-mode-map][=yas-minor-mode-map=]] and
(define-key yas-keymap (kbd "<new-prev-field-key>") 'yas-prev) (define-key yas-keymap (kbd "<new-prev-field-key>") 'yas-prev)
#+end_src #+end_src
* How do I turn off the minor mode where in some buffers?
The best way, since version 0.6.1c, is to set the default value of the
variable [[sym:yas-dont-activate][=yas-dont-activate=]] to a lambda function like so:
#+BEGIN_SRC emacs-lisp
(set-default 'yas-dont-activate
#'(lambda ()
(and yas-root-directory
(null (yas-get-snippet-tables)))))
#+END_SRC
This is also the default value starting for that version. It skips the
minor mode in buffers where it is not applicable (no snippet tables),
but only once you have setup your yas-root-directory.
* How do I define an abbrev key containing characters not supported by the filesystem? * How do I define an abbrev key containing characters not supported by the filesystem?
- *Note*: This question applies if you're still defining snippets - *Note*: This question applies if you're still defining snippets

View File

@ -442,7 +442,7 @@ are looked for first. Failing that, longer keys composed of
\"word\" or \"symbol\" syntax are looked for. Therefore, \"word\" or \"symbol\" syntax are looked for. Therefore,
triggering after triggering after
foo-bar foo-barbaz
will, according to the \"w\" element first try \"barbaz\". If will, according to the \"w\" element first try \"barbaz\". If
that isn't a trigger key, \"foo-barbaz\" is tried, respecting the that isn't a trigger key, \"foo-barbaz\" is tried, respecting the