[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] master c90784d 087/272: doc/ivy.org: Update
From: |
Oleh Krehel |
Subject: |
[elpa] master c90784d 087/272: doc/ivy.org: Update |
Date: |
Mon, 25 Apr 2016 10:13:18 +0000 |
branch: master
commit c90784d13cdc68025bc878c4c328aea3d9f69970
Author: Oleh Krehel <address@hidden>
Commit: Oleh Krehel <address@hidden>
doc/ivy.org: Update
(Example - =counsel-describe-function=): Add a paragraph on :preselect.
---
doc/ivy.org | 7 ++++++-
doc/ivy.texi | 18 ++++++++++++------
2 files changed, 18 insertions(+), 7 deletions(-)
diff --git a/doc/ivy.org b/doc/ivy.org
index e1f5956..4d20cce 100644
--- a/doc/ivy.org
+++ b/doc/ivy.org
@@ -1137,7 +1137,7 @@ Note that only the first two arguments (and the =action=)
are really
important - the rest is just fine-tuning and could be omitted.
The =action= argument could also be omitted - but then =ivy-read=
-would no nothing except returning the string result, which you could
+would do nothing except returning the string result, which you could
later use yourself. However, it's recommended that you use the
=action= argument.
@@ -1168,6 +1168,11 @@ Here are the interesting features of the above function,
in the order that they
- The =prompt= argument is a simple string ending in ": ".
- The =collection= argument evaluates to a (large) list of strings.
- The =keymap= argument allows for a custom keymap to supplement
=ivy-minibuffer-map=.
+- The =preselect= is provided via =counsel-symbol-at-point=. This way,
+ if the point lies on a symbol or a word, ivy will try to pre-select
+ the first candidate that matches this symbol. If it happens to be
+ the candidate that the user wanted, it can be selected with ~RET~
+ and no need for further input.
- The =history= argument ensures that the command has its own history,
and doesn't need to share the common history =ivy-history= that all
commands without their own history share.
diff --git a/doc/ivy.texi b/doc/ivy.texi
index 3301b22..dc7c156 100644
--- a/doc/ivy.texi
+++ b/doc/ivy.texi
@@ -88,8 +88,8 @@ Key bindings
Minibuffer key bindings
* Key bindings for navigation::
-* Key bindings for single selection, action, then exit minibuffer: Key
bindings for single selection action then exit minibuffer.
-* Key bindings for multiple selections and actions, keep minibuffer open: Key
bindings for multiple selections and actions keep minibuffer open.
+* Key bindings for single selection, action, then exit minibuffer: Key
bindings for single selection action then exit minibuffer.
+* Key bindings for multiple selections and actions, keep minibuffer open: Key
bindings for multiple selections and actions keep minibuffer open.
* Key bindings that alter the minibuffer input::
* Other key bindings::
* Hydra in the minibuffer::
@@ -362,8 +362,8 @@ fully capable editing area: bindings like @kbd{C-a},
@kbd{C-f}, @kbd{M-d},
@code{fundamental-mode} buffer.
@menu
* Key bindings for navigation::
-* Key bindings for single selection, action, then exit minibuffer: Key
bindings for single selection action then exit minibuffer.
-* Key bindings for multiple selections and actions, keep minibuffer open: Key
bindings for multiple selections and actions keep minibuffer open.
+* Key bindings for single selection, action, then exit minibuffer: Key
bindings for single selection action then exit minibuffer.
+* Key bindings for multiple selections and actions, keep minibuffer open: Key
bindings for multiple selections and actions keep minibuffer open.
* Key bindings that alter the minibuffer input::
* Other key bindings::
* Hydra in the minibuffer::
@@ -1420,7 +1420,7 @@ Note that only the first two arguments (and the
@code{action}) are really
important - the rest is just fine-tuning and could be omitted.
The @code{action} argument could also be omitted - but then @code{ivy-read}
-would no nothing except returning the string result, which you could
+would do nothing except returning the string result, which you could
later use yourself. However, it's recommended that you use the
@code{action} argument.
@@ -1456,6 +1456,12 @@ The @code{collection} argument evaluates to a (large)
list of strings.
@item
The @code{keymap} argument allows for a custom keymap to supplement
@code{ivy-minibuffer-map}.
@item
+The @code{preselect} is provided via @code{counsel-symbol-at-point}. This way,
+if the point lies on a symbol or a word, ivy will try to pre-select
+the first candidate that matches this symbol. If it happens to be
+the candidate that the user wanted, it can be selected with @kbd{RET}
+and no need for further input.
address@hidden
The @code{history} argument ensures that the command has its own history,
and doesn't need to share the common history @code{ivy-history} that all
commands without their own history share.
@@ -1569,4 +1575,4 @@ we want to kill the running process created by
@printindex vr
address@hidden
\ No newline at end of file
address@hidden
- [elpa] master 0fd6a75 142/272: Move switch-to-buffer to :display-transformer-fn, (continued)
- [elpa] master 0fd6a75 142/272: Move switch-to-buffer to :display-transformer-fn, Oleh Krehel, 2016/04/25
- [elpa] master f5a21db 157/272: ivy.el: define setq-local and defvar-local unless defined, Oleh Krehel, 2016/04/25
- [elpa] master 71644d9 190/272: ivy.el (ivy-read): Remove code that sets action index to 1, Oleh Krehel, 2016/04/25
- [elpa] master 220fd38 079/272: doc/ivy.org: Improve the markup, Oleh Krehel, 2016/04/25
- [elpa] master 50f3092 169/272: counsel.el (counsel--async-sentinel): Start refactor, Oleh Krehel, 2016/04/25
- [elpa] master 41b8b0d 113/272: ivy.el (ivy-occur): Add a warning, Oleh Krehel, 2016/04/25
- [elpa] master b39e449 228/272: counsel.el (counsel-ag-map): Add, Oleh Krehel, 2016/04/25
- [elpa] master 79f9cda 165/272: counsel-ag: Fix escaping problem, Oleh Krehel, 2016/04/25
- [elpa] master f1c7233 164/272: swiper.el (swiper-occur): Bind ivy--regex-function, Oleh Krehel, 2016/04/25
- [elpa] master 1de78f3 160/272: Improve window handling for ivy-occur, Oleh Krehel, 2016/04/25
- [elpa] master c90784d 087/272: doc/ivy.org: Update,
Oleh Krehel <=
- [elpa] master d085765 146/272: ivy.el (ivy-switch-buffer): Don't fall back to switch-to-buffer, Oleh Krehel, 2016/04/25
- [elpa] master be06ae0 163/272: swiper.el: Add docstring, Oleh Krehel, 2016/04/25
- [elpa] master 587526e 138/272: counsel.el (counsel-git-grep-transformer): New defun, Oleh Krehel, 2016/04/25
- [elpa] master d40bdab 134/272: doc/ivy.org: Fix typo, Oleh Krehel, 2016/04/25
- [elpa] master 1c45b29 150/272: ivy-occur-mode: new commands on "j", "k", "c", Oleh Krehel, 2016/04/25
- [elpa] master c68d2cc 189/272: ivy.el (ivy-thing-at-point): Try ffap-file-at-point, Oleh Krehel, 2016/04/25
- [elpa] master d6b18f0 151/272: ivy.el (ivy-occur-press): Pulse no longer, Oleh Krehel, 2016/04/25
- [elpa] master b3ca886 133/272: counsel.el (counsel--generic): Improve, Oleh Krehel, 2016/04/25
- [elpa] master c8013c7 053/272: counsel.el (ivy-ffap-url-functions): Add Emacs git repo, Oleh Krehel, 2016/04/25
- [elpa] master 1d3f080 263/272: ivy.el (ivy--magic-file-slash): Allow "non-existing-dir//", Oleh Krehel, 2016/04/25