From 75d0cef20dbc522e6217a5765f21bfa841aff89b Mon Sep 17 00:00:00 2001 From: Juanma Barranquero Date: Tue, 24 Dec 2019 02:37:08 +0100 Subject: Trivial docstring fixes * ChangeLog.3: * lisp/emacs-lisp/cl-macs.el (cl-flet): * lisp/filesets.el (filesets-menu-ensure-use-cached): * lisp/progmodes/compile.el (compilation-context-lines): * lisp/progmodes/prolog.el (prolog-paren-indent): * lisp/progmodes/sql.el (sql-password-search-wallet-function): Fix typos in docstrings. * lisp/cedet/semantic/analyze.el (semantic-analyze-push-error): Doc fix. * lisp/emacs-lisp/map.el (map-put, map-info): Refill docstring. (map-contains-key): Fix typo. (map-every-p): Doc fix. --- lisp/emacs-lisp/map.el | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) (limited to 'lisp/emacs-lisp/map.el') diff --git a/lisp/emacs-lisp/map.el b/lisp/emacs-lisp/map.el index 74927b6224f..c1db79809d1 100644 --- a/lisp/emacs-lisp/map.el +++ b/lisp/emacs-lisp/map.el @@ -141,7 +141,8 @@ In the base definition, MAP can be an alist, hash-table, or array." "Associate KEY with VALUE in MAP and return VALUE. If KEY is already present in MAP, replace the associated value with VALUE. -When MAP is a list, test equality with TESTFN if non-nil, otherwise use `eql'. +When MAP is a list, test equality with TESTFN if non-nil, +otherwise use `eql'. MAP can be a list, hash-table or array." (declare (obsolete "use map-put! or (setf (map-elt ...) ...) instead" "27.1")) @@ -287,7 +288,7 @@ The default implementation delegates to `map-length'." ;; so specifying `testfn' here is problematic: e.g. for hash-tables ;; we shouldn't use `gethash' unless `testfn' is the same as the map's own ;; test function! - "Return non-nil If and only if MAP contains KEY. + "Return non-nil if and only if MAP contains KEY. TESTFN is deprecated. Its default depends on MAP. The default implementation delegates to `map-do'." (unless testfn (setq testfn #'equal)) @@ -325,7 +326,7 @@ The default implementation delegates to `map-apply'." nil)) (cl-defgeneric map-every-p (pred map) - "Return non-nil if (PRED key val) is non-nil for all elements of the map MAP. + "Return non-nil if (PRED key val) is non-nil for all elements of MAP. The default implementation delegates to `map-apply'." ;; FIXME: Not sure if there's much benefit to defining it as defgeneric, ;; since as defined, I can't think of a map-type where we could provide an @@ -475,8 +476,8 @@ KEYWORD-ARGS are forwarded to `make-hash-table'." (cl-defmethod map-into (map (type (head hash-table))) "Convert MAP into a hash-table. -TYPE is a list where the car is `hash-table' and the cdr are the keyword-args -forwarded to `make-hash-table'. +TYPE is a list where the car is `hash-table' and the cdr are the +keyword-args forwarded to `make-hash-table'. Example: (map-into '((1 . 3)) '(hash-table :test eql))" -- cgit v1.2.3