summaryrefslogtreecommitdiff
path: root/lisp/progmodes/flymake.el
diff options
context:
space:
mode:
authorJoão Távora <joaotavora@gmail.com>2017-09-30 18:04:45 +0100
committerJoão Távora <joaotavora@gmail.com>2017-10-03 14:18:55 +0100
commit5d3f8a8b804d76d6a7cb97738ca79db4b1df06f2 (patch)
treeb336649e0a448f9ec1ac88918072e0c8570848b7 /lisp/progmodes/flymake.el
parentf6e909b41e927a6715bad5fc5386257f29e7c0bb (diff)
downloademacs-5d3f8a8b804d76d6a7cb97738ca79db4b1df06f2.tar.gz
Capitalize "Flymake" in docstrings and comments
* lisp/progmodes/flymake-elisp.el (flymake-elisp-checkdoc) (flymake-elisp-setup-backends): Capitalize "Flymake" * lisp/progmodes/flymake-proc.el: (flymake-proc-reformat-err-line-patterns-from-compile-el) (flymake-proc--panic, flymake-proc-legacy-flymake) (flymake-start-syntax-check, flymake-proc-compile) (define-obsolete-variable-alias): Capitalize "Flymake" * lisp/progmodes/flymake.el (flymake-fringe-indicator-position) (flymake-make-diagnostic, flymake-delete-own-overlays) (flymake-diagnostic-functions) (flymake-diagnostic-types-alist, flymake-is-running) (flymake-make-report-fn, flymake-mode-on, flymake-mode-off) (flymake-goto-next-error, flymake-goto-prev-error): Capitalize "Flymake"
Diffstat (limited to 'lisp/progmodes/flymake.el')
-rw-r--r--lisp/progmodes/flymake.el43
1 files changed, 22 insertions, 21 deletions
diff --git a/lisp/progmodes/flymake.el b/lisp/progmodes/flymake.el
index d1673977762..060f164b794 100644
--- a/lisp/progmodes/flymake.el
+++ b/lisp/progmodes/flymake.el
@@ -88,7 +88,7 @@ this is used."
(face :tag "Face"))))
(defcustom flymake-fringe-indicator-position 'left-fringe
- "The position to put flymake fringe indicator.
+ "The position to put Flymake fringe indicator.
The value can be nil (do not use indicators), `left-fringe' or `right-fringe'.
See `flymake-error-bitmap' and `flymake-warning-bitmap'."
:version "24.3"
@@ -200,7 +200,7 @@ generated it."
end
type
text)
- "Make a flymake diagnostic for BUFFER's region from BEG to END.
+ "Make a Flymake diagnostic for BUFFER's region from BEG to END.
TYPE is a key to `flymake-diagnostic-types-alist' and TEXT is a
description of the problem detected in this region."
(flymake--diag-make :buffer buffer :beg beg :end end :type type :text text))
@@ -239,7 +239,7 @@ verify FILTER, a function, and sort them by COMPARE (using KEY)."
ovs))))
(defun flymake-delete-own-overlays (&optional filter)
- "Delete all flymake overlays in BUFFER."
+ "Delete all Flymake overlays in BUFFER."
(mapc #'delete-overlay (flymake--overlays :filter filter)))
(defface flymake-error
@@ -315,12 +315,12 @@ about where and how to annotate problems diagnosed in a buffer.
Whenever Flymake or the user decides to re-check the buffer, each
function is called with a common calling convention, a single
-REPORT-FN argument, detailed below. Backend functions are
-expected to initiate the buffer check, but aren't required to
-complete it check before exiting: if the computation involved is
-expensive, especially for large buffers, that task can be
-scheduled for the future using asynchronous processes or other
-asynchronous mechanisms.
+REPORT-FN argument and a list of keword value pairs, detailed
+below. Backend functions are expected to initiate the buffer
+check, but aren't required to complete it check before exiting:
+if the computation involved is expensive, especially for large
+buffers, that task can be scheduled for the future using
+asynchronous processes or other asynchronous mechanisms.
In any case, backend functions are expected to return quickly or
signal an error, in which case the backend is disabled. Flymake
@@ -331,7 +331,7 @@ and on again, reset the list of disabled backends.
If the function returns, Flymake considers the backend to be
\"running\". If it has not done so already, the backend is
expected to call the function REPORT-FN with a single argument
-ACTION followed by an optional list of keyword arguments and
+ACTION followed by an optional list of keyword-value pairs
their values (:KEY1 VALUE1 :KEY2 VALUE2...).
The possible values for ACTION are.
@@ -367,7 +367,7 @@ The recognized optional keyword arguments are:
. ((flymake-category . flymake-warning)))
(:note
. ((flymake-category . flymake-note))))
- "Alist ((KEY . PROPS)*) of properties of flymake error types.
+ "Alist ((KEY . PROPS)*) of properties of Flymake error types.
KEY can be anything passed as `:type' to `flymake-diag-make'.
PROPS is an alist of properties that are applied, in order, to
@@ -486,7 +486,7 @@ associated `flymake-category' return DEFAULT."
(overlay-put ov 'flymake t)
(overlay-put ov 'flymake--diagnostic diagnostic)))
-;; Nothing in flymake uses this at all any more, so this is just for
+;; Nothing in Flymake uses this at all any more, so this is just for
;; third-party compatibility.
(define-obsolete-function-alias 'flymake-display-warning 'message-box "26.1")
@@ -528,10 +528,11 @@ present the backend is disabled.")
,@body)))
(defun flymake-is-running ()
- "Tell if flymake has running backends in this buffer"
+ "Tell if Flymake has running backends in this buffer"
(flymake-running-backends))
-(cl-defun flymake--handle-report (backend token action &key explanation force)
+(cl-defun flymake--handle-report (backend token action
+ &key explanation force)
"Handle reports from BACKEND identified by TOKEN.
BACKEND, ACTION and EXPLANATION, and FORCE conform to the calling
@@ -590,8 +591,8 @@ not expected."
(defun flymake-make-report-fn (backend &optional token)
"Make a suitable anonymous report function for BACKEND.
-BACKEND is used to help flymake distinguish different diagnostic
-sources. If provided, TOKEN helps flymake distinguish between
+BACKEND is used to help Flymake distinguish different diagnostic
+sources. If provided, TOKEN helps Flymake distinguish between
different runs of the same backend."
(let ((buffer (current-buffer)))
(lambda (&rest args)
@@ -740,12 +741,12 @@ Do it only if `flymake-no-changes-timeout' is non-nil."
;;;###autoload
(defun flymake-mode-on ()
- "Turn flymake mode on."
+ "Turn Flymake mode on."
(flymake-mode 1))
;;;###autoload
(defun flymake-mode-off ()
- "Turn flymake mode off."
+ "Turn Flymake mode off."
(flymake-mode 0))
(make-obsolete 'flymake-mode-on 'flymake-mode "26.1")
@@ -777,7 +778,7 @@ Do it only if `flymake-no-changes-timeout' is non-nil."
(flymake-log :warning "Turned on in `flymake-find-file-hook'")))
(defun flymake-goto-next-error (&optional n filter interactive)
- "Go to Nth next flymake error in buffer matching FILTER.
+ "Go to Nth next Flymake error in buffer matching FILTER.
Interactively, always move to the next error. Interactively, and
with a prefix arg, skip any diagnostics with a severity less than
@@ -827,13 +828,13 @@ applied."
(funcall (overlay-get target 'help-echo)
nil nil (point)))))
(interactive
- (user-error "No more flymake errors%s"
+ (user-error "No more Flymake errors%s"
(if filter
(format " of types %s" filter)
""))))))
(defun flymake-goto-prev-error (&optional n filter interactive)
- "Go to Nth previous flymake error in buffer matching FILTER.
+ "Go to Nth previous Flymake error in buffer matching FILTER.
Interactively, always move to the previous error. Interactively,
and with a prefix arg, skip any diagnostics with a severity less