[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] master 9e6561b 13/20: Run checkdoc
From: |
Oleh Krehel |
Subject: |
[elpa] master 9e6561b 13/20: Run checkdoc |
Date: |
Sat, 09 May 2015 11:57:53 +0000 |
branch: master
commit 9e6561b64620afe116a7e402faf3ee3108234b3c
Author: Oleh Krehel <address@hidden>
Commit: Oleh Krehel <address@hidden>
Run checkdoc
* avy-jump.el (cl-lib): Is already required in avy.
(avy-keys-alist): Fix doc.
(avy--with-avy-keys): Add doc.
(avy-word-punc-regexp): Fix doc.
(avy--process): Fix doc.
(avy--overlay-at): Fix doc.
(avy--overlay-post): Fix doc.
(avy--line): Fix doc.
(avy-goto-line): Fix doc.
Fixes #25
---
avy-jump.el | 29 ++++++++++++++++-------------
1 files changed, 16 insertions(+), 13 deletions(-)
diff --git a/avy-jump.el b/avy-jump.el
index 5618cfe..6efb158 100644
--- a/avy-jump.el
+++ b/avy-jump.el
@@ -26,7 +26,6 @@
;;; Code:
;;* Requires
-(require 'cl-lib)
(require 'avy)
;;* Customization
@@ -40,7 +39,7 @@
:type '(repeat :tag "Keys" character))
(defcustom avy-keys-alist nil
- "Alist of avy-jump commands to avy-keys overriding the default avy-keys."
+ "Alist of avy-jump commands to `avy-keys' overriding the default `avy-keys'."
:type '(alist :key-type (choice :tag "Command"
(const avy-goto-char)
(const avy-goto-char-2)
@@ -56,6 +55,7 @@
:value-type (repeat :tag "Keys" character)))
(defmacro avy--with-avy-keys (command &rest body)
+ "Set `avy-keys' according to COMMAND and execute BODY."
(declare (indent 1))
`(let ((avy-keys (or (cdr (assq ',command avy-keys-alist))
avy-keys)))
@@ -66,8 +66,8 @@
:type 'boolean)
(defcustom avy-word-punc-regexp "[!-/:address@hidden"
- "Regexp of punctuation characters that should be matched when calling
-`avy-goto-word-1' command. When nil, punctuation chars will not be matched.
+ "Regexp of punctuation chars that count as word starts for `avy-goto-word-1.
+When nil, punctuation chars will not be matched.
\"[!-/:address@hidden" will match all printable punctuation chars."
:type 'regexp)
@@ -113,7 +113,8 @@ POS is either a position or (BEG . END)."
(goto-char pt))))
(defun avy--process (candidates overlay-fn)
- "Select one of CANDIDATES using `avy-read'."
+ "Select one of CANDIDATES using `avy-read'.
+Use OVERLAY-FN to visualize the decision overlay."
(unwind-protect
(cl-case (length candidates)
(0
@@ -193,9 +194,9 @@ When PRED is non-nil, it's a filter for matching point
positions."
(push ol avy--overlays-lead))))
(defun avy--overlay-pre (path leaf)
- "Create an overlay with STR at LEAF.
+ "Create an overlay with PATH at LEAF.
PATH is a list of keys from tree root to LEAF.
-LEAF is ((BEG . END) . WND)."
+LEAF is normally ((BEG . END) . WND)."
(avy--overlay
(propertize (apply #'string (reverse path))
'face 'avy-lead-face)
@@ -210,9 +211,9 @@ LEAF is ((BEG . END) . WND)."
(selected-window))))
(defun avy--overlay-at (path leaf)
- "Create an overlay with STR at LEAF.
+ "Create an overlay with PATH at LEAF.
PATH is a list of keys from tree root to LEAF.
-LEAF is ((BEG . END) . WND)."
+LEAF is normally ((BEG . END) . WND)."
(let ((str (propertize
(string (car (last path)))
'face 'avy-lead-face))
@@ -234,9 +235,9 @@ LEAF is ((BEG . END) . WND)."
(push ol avy--overlays-lead))))
(defun avy--overlay-post (path leaf)
- "Create an overlay with STR at LEAF.
+ "Create an overlay with PATH at LEAF.
PATH is a list of keys from tree root to LEAF.
-LEAF is ((BEG . END) . WND)."
+LEAF is normally ((BEG . END) . WND)."
(avy--overlay
(propertize (apply #'string (reverse path))
'face 'avy-lead-face)
@@ -392,7 +393,8 @@ The case is ignored."
arg (lambda () (eq (downcase (char-after)) char))))))
(defun avy--line (&optional arg)
- "Select line in current window."
+ "Select a line.
+The window scope is determined by `avy-all-windows' (ARG negates it)."
(let ((avy-background nil)
candidates)
(avy-dowindows arg
@@ -410,7 +412,8 @@ The case is ignored."
;;;###autoload
(defun avy-goto-line (&optional arg)
- "Jump to a line start in current buffer."
+ "Jump to a line start in current buffer.
+The window scope is determined by `avy-all-windows' (ARG negates it)."
(interactive "P")
(avy--with-avy-keys avy-goto-line
(avy--goto (avy--line arg))))
- [elpa] master e931071 04/20: When selecting from many windows, prioritize the current, (continued)
- [elpa] master e931071 04/20: When selecting from many windows, prioritize the current, Oleh Krehel, 2015/05/09
- [elpa] master 6acbeb6 05/20: Use `avy-keys' for `avy-goto-subword-1', Oleh Krehel, 2015/05/09
- [elpa] master 35e1309 06/20: Add customization type to `avy-keys', Oleh Krehel, 2015/05/09
- [elpa] master c32b91f 07/20: Add more customization types, Oleh Krehel, 2015/05/09
- [elpa] master 6ff26f5 08/20: Use cl-lib instead of cl-macs, Oleh Krehel, 2015/05/09
- [elpa] master cc822c1 12/20: Fix eval-after-load isearch, Oleh Krehel, 2015/05/09
- [elpa] master a558585 09/20: Move the package metadata to avy.el, Oleh Krehel, 2015/05/09
- [elpa] master 0634762 11/20: Add a dependency to cl-lib for Emacs < 24.3, Oleh Krehel, 2015/05/09
- [elpa] master 0e049bb 10/20: Always default to avy-keys but allow for per-command overrides, Oleh Krehel, 2015/05/09
- [elpa] master 4007986 14/20: Fix avy-background for multiple windows, Oleh Krehel, 2015/05/09
- [elpa] master 9e6561b 13/20: Run checkdoc,
Oleh Krehel <=
- [elpa] master dbaa1a8 15/20: Fix avy-background some more, Oleh Krehel, 2015/05/09
- [elpa] master db4214f 16/20: Allow to display the full path using `at-full' style, Oleh Krehel, 2015/05/09
- [elpa] master 7e618a5 19/20: Merge commit 'b114cf8a93224c85c51e95db52bf359131130476' from ace-window, Oleh Krehel, 2015/05/09
- [elpa] master e242f04 18/20: Bump version, Oleh Krehel, 2015/05/09
- [elpa] master 4029969 17/20: Update and document the style customization, Oleh Krehel, 2015/05/09
- [elpa] master e1f9513 20/20: Merge commit 'e242f04e32c7d874c779fb83c86aa5bdbc508f18' from avy, Oleh Krehel, 2015/05/09