[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/ivy-posframe 9e0c6da 118/195: generate readme
From: |
Feng Shu |
Subject: |
[elpa] externals/ivy-posframe 9e0c6da 118/195: generate readme |
Date: |
Sat, 3 Oct 2020 07:11:57 -0400 (EDT) |
branch: externals/ivy-posframe
commit 9e0c6da51d806c5d5c8f6e166c0fa8c568a7bdc5
Author: conao3 <conao3@gmail.com>
Commit: conao3 <conao3@gmail.com>
generate readme
---
README.md | 96 +++++++++++++++++++++++++++++++++++----------------------------
1 file changed, 54 insertions(+), 42 deletions(-)
diff --git a/README.md b/README.md
index f14f57c..c80ae17 100644
--- a/README.md
+++ b/README.md
@@ -1,26 +1,25 @@
Note: this file is auto converted from ivy-posframe.el by
[el2org](https://github.com/tumashu/el2org), please do not edit it by hand!!!
-# 目录
+# Table of Contents
-1. [ivy-posframe README](#orgf13cc66)
- 1. [What is ivy-posframe](#orgbd4ba62)
- 2. [Display functions](#orge8456a3)
- 3. [How to enable ivy-posframe](#orge72596b)
- 1. [Global mode](#org359004f)
- 2. [Per-command mode.](#orgdfd4dbf)
- 3. [Fallback mode](#org589575f)
- 4. [Tips](#orgd8d788b)
- 1. [How to show fringe to ivy-posframe](#org44b1a57)
- 2. [How to custom your ivy-posframe style](#org2e4b09d)
+1. [ivy-posframe README](#orgd3c904b)
+ 1. [What is ivy-posframe](#org0585c98)
+ 2. [Display functions](#org33d88e8)
+ 3. [How to enable ivy-posframe](#org1951a71)
+ 1. [Global mode](#orga4b2102)
+ 2. [Per-command mode.](#org5502e77)
+ 4. [Tips](#orgaaa4442)
+ 1. [How to show fringe to ivy-posframe](#org84cabb8)
+ 2. [How to custom your ivy-posframe style](#orgc5ae827)
-<a id="orgf13cc66"></a>
+<a id="orgd3c904b"></a>
# ivy-posframe README
-<a id="orgbd4ba62"></a>
+<a id="org0585c98"></a>
## What is ivy-posframe
@@ -31,7 +30,7 @@ NOTE: ivy-posframe requires Emacs 26 and do not support mouse
click.
-<a id="orge8456a3"></a>
+<a id="org33d88e8"></a>
## Display functions
@@ -47,35 +46,56 @@ click.
![img](./snapshots/ivy-posframe-display-at-point.png)
-<a id="orge72596b"></a>
+<a id="org1951a71"></a>
## How to enable ivy-posframe
-<a id="org359004f"></a>
+<a id="orga4b2102"></a>
### Global mode
(require 'ivy-posframe)
- (setq ivy-display-function #'ivy-posframe-display)
- ;; (setq ivy-display-function #'ivy-posframe-display-at-frame-center)
- ;; (setq ivy-display-function #'ivy-posframe-display-at-window-center)
- ;; (setq ivy-display-function #'ivy-posframe-display-at-frame-bottom-left)
- ;; (setq ivy-display-function #'ivy-posframe-display-at-window-bottom-left)
- ;; (setq ivy-display-function #'ivy-posframe-display-at-point)
- (ivy-posframe-enable)
+ (setq ivy-posframe-configure-alist
+ '((ivy-display-functions-alist . ((t . ivy-posframe-display)))))
+ ;; (setq ivy-posframe-configure-alist
+ ;; '((ivy-display-functions-alist . ((t .
ivy-posframe-display-at-frame-center)))))
+ ;; (setq ivy-posframe-configure-alist
+ ;; '((ivy-display-functions-alist . ((t .
ivy-posframe-display-at-window-center)))))
+ ;; (setq ivy-posframe-configure-alist
+ ;; '((ivy-display-functions-alist . ((t .
ivy-posframe-display-at-frame-bottom-left)))))
+ ;; (setq ivy-posframe-configure-alist
+ ;; '((ivy-display-functions-alist . ((t .
ivy-posframe-display-at-window-bottom-left)))))
+ ;; (setq ivy-posframe-configure-alist
+ ;; '((ivy-display-functions-alist . ((t .
ivy-posframe-display-at-point)))))
+ (ivy-posframe-mode t)
+
+
+<a id="org5502e77"></a>
+### Per-command mode.
-<a id="orgdfd4dbf"></a>
+ (require 'ivy-posframe)
+ ;; Different command can use different display function.
+ (setq ivy-posframe-configure-alist
+ '((ivy-display-functions-alist . ((swiper .
ivy-posframe-display-at-point)
+ (complete-symbol .
ivy-posframe-display-at-point)
+ (counsel-M-x .
ivy-posframe-display-at-window-bottom-left)
+ (t .
ivy-posframe-display)))))
+ (ivy-posframe-mode t)
-### Per-command mode.
+You can use ivy original display function on specify function.
+You may want to use the original display function because display
+of Swiper at point hides the contents of the buffer.
(require 'ivy-posframe)
;; Different command can use different display function.
- (push '(counsel-M-x . ivy-posframe-display-at-window-bottom-left)
ivy-display-functions-alist)
- (push '(complete-symbol . ivy-posframe-display-at-point)
ivy-display-functions-alist)
- (push '(swiper . ivy-posframe-display-at-point)
ivy-display-functions-alist)
- (ivy-posframe-enable)
+ (setq ivy-posframe-configure-alist
+ '((ivy-display-functions-alist . ((swiper . nil)
+ (complete-symbol .
ivy-posframe-display-at-point)
+ (counsel-M-x .
ivy-posframe-display-at-window-bottom-left)
+ (t .
ivy-posframe-display)))))
+ (ivy-posframe-mode t)
NOTE: Using swiper as example: swiper's display function **only**
take effect when you call swiper command with global keybinding, if
@@ -88,21 +108,12 @@ by ivy to find display function in
\`ivy-display-functions-alist',
"C-h v this-command" is a good idea.
-<a id="org589575f"></a>
-
-### Fallback mode
-
- (require 'ivy-posframe)
- (push '(t . ivy-posframe-display) ivy-display-functions-alist)
- (ivy-posframe-enable)
-
-
-<a id="orgd8d788b"></a>
+<a id="orgaaa4442"></a>
## Tips
-<a id="org44b1a57"></a>
+<a id="org84cabb8"></a>
### How to show fringe to ivy-posframe
@@ -114,7 +125,7 @@ By the way, User can set **any** parameters of ivy-posframe
with
the help of \`ivy-posframe-parameters'.
-<a id="org2e4b09d"></a>
+<a id="orgc5ae827"></a>
### How to custom your ivy-posframe style
@@ -122,5 +133,6 @@ The simplest way is:
(defun ivy-posframe-display-at-XXX (str)
(ivy-posframe--display str #'your-own-poshandler-function))
- (ivy-posframe-enable) ; This line is needed.
+ (push 'ivy-posframe-display-at-XXX ivy-posframe-display-function-list) ;
This line is needed.
+ (ivy-posframe-mode t) ; This line is needed.
- [elpa] externals/ivy-posframe d57087e 116/195: add additional-display-functions custom variable, (continued)
- [elpa] externals/ivy-posframe d57087e 116/195: add additional-display-functions custom variable, Feng Shu, 2020/10/03
- [elpa] externals/ivy-posframe 1a7f2f0 107/195: move ivy-posframe-display-functions to variables section, Feng Shu, 2020/10/03
- [elpa] externals/ivy-posframe 95c1028 177/195: ivy-display-function -> ivy--display-function, Feng Shu, 2020/10/03
- [elpa] externals/ivy-posframe aae7322 119/195: use ivy-posframe-mode-map instead of define-key, Feng Shu, 2020/10/03
- [elpa] externals/ivy-posframe 35d47bd 117/195: refine document, Feng Shu, 2020/10/03
- [elpa] externals/ivy-posframe 7dc84ee 152/195: Fix2 First line disappears with the specific condition. #47, Feng Shu, 2020/10/03
- [elpa] externals/ivy-posframe d35af4f 144/195: handle ivy-display-function again, Feng Shu, 2020/10/03
- [elpa] externals/ivy-posframe 8902638 100/195: define ivy-posframe-adbice-alist, Feng Shu, 2020/10/03
- [elpa] externals/ivy-posframe 212eaa1 138/195: indent ivy-posframe-mode, Feng Shu, 2020/10/03
- [elpa] externals/ivy-posframe b934152 125/195: move variables section above advice section, Feng Shu, 2020/10/03
- [elpa] externals/ivy-posframe 9e0c6da 118/195: generate readme,
Feng Shu <=
- [elpa] externals/ivy-posframe 02a357d 104/195: define ivy-posframe-mode instead of ivy-posframe-enable, Feng Shu, 2020/10/03
- [elpa] externals/ivy-posframe aea9074 122/195: add ivy-posframe--read advice, Feng Shu, 2020/10/03
- [elpa] externals/ivy-posframe 76350e7 146/195: Update README, Feng Shu, 2020/10/03
- [elpa] externals/ivy-posframe c4091c3 120/195: remove unnesessary code, Feng Shu, 2020/10/03
- [elpa] externals/ivy-posframe e76a15d 162/195: Merge pull request #53 from gagbo/patch-1, Feng Shu, 2020/10/03
- [elpa] externals/ivy-posframe 83657be 114/195: add display-functions-alist to restore ivy variable, Feng Shu, 2020/10/03
- [elpa] externals/ivy-posframe 27e3cec 176/195: Try to fix Minibuffer is hiding always #66, Feng Shu, 2020/10/03
- [elpa] externals/ivy-posframe c43acf3 132/195: alias ivy-posframe-enable as ivy-posframe-mode, Feng Shu, 2020/10/03
- [elpa] externals/ivy-posframe 3c3740e 142/195: Add ivy-posframe-lighter, Feng Shu, 2020/10/03
- [elpa] externals/ivy-posframe 6d697ff 190/195: Try to fix: Posframe max-width? #82, Feng Shu, 2020/10/03