[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
typos in comments and doc strings
From: |
Sam Steingold |
Subject: |
typos in comments and doc strings |
Date: |
Wed, 06 Jul 2022 17:05:03 -0400 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (darwin) |
There are quite a few typos in comments and doc strings in bbdb code.
Most can be found by `ispell-comments-and-strings'.
It would be nice if someone with git write access could fix those.
E.g., see appended.
While we are at it, M-x checkdoc is also useful.
--
Sam Steingold (http://sds.podval.org/) on darwin Ns 10.3.2113
http://childpsy.net http://calmchildstories.com http://steingoldpsychology.com
http://think-israel.org https://www.dhimmitude.org https://honestreporting.com
(let((a'(list'let(list(list'a(list'quote a)))a)))`(let((a(quote ,a))),a))
diff --git a/lisp/bbdb-com.el b/lisp/bbdb-com.el
index f11c2b2..6adec98 100644
--- a/lisp/bbdb-com.el
+++ b/lisp/bbdb-com.el
@@ -547,9 +547,9 @@ Interactively, use BBDB prefix \
If QUERY is non-nil (as in interactive calls, unless we use a prefix arg)
query before deleting the redundant mail addresses.
If UPDATE is non-nil (as in interactive calls) update the database.
-Otherwise, this is the caller's responsiblity.
+Otherwise, this is the caller's responsibility.
-Noninteractively, this may be used as an element of `bbdb-notice-record-hook'
+Non-interactively, this may be used as an element of `bbdb-notice-record-hook'
or `bbdb-change-hook'. However, see also `bbdb-ignore-redundant-mails',
which is probably more suited for your needs."
(interactive (list (bbdb-do-records) (not current-prefix-arg) t))
@@ -724,7 +724,7 @@ DATE must be in yyyy-mm-dd format."
;; XXX this needs expansion to handle international prefixes properly
;; i.e. +353-number without discarding the +353 part. Problem being
;; that this will necessitate yet another change in the database
-;; format for people who are using north american numbers.
+;; format for people who are using north American numbers.
(defsubst bbdb-subint (string num)
"Used for parsing phone numbers."
@@ -736,9 +736,9 @@ DATE must be in yyyy-mm-dd format."
This is both lenient and strict in what it will parse - whitespace may
appear (or not) between any of the groups of digits, parentheses around the
area code are optional, as is a dash between the exchange and number, and
-a '1' preceeding the area code; but there must be three digits in the area
+a '1' preceding the area code; but there must be three digits in the area
code and exchange, and four in the number (if they are present).
-All of these are unambigously parsable:
+All of these are unambiguously parsable:
( 415 ) 555 - 1212 x123 -> (415 555 1212 123)
(415)555-1212 123 -> (415 555 1212 123)
@@ -1289,7 +1289,7 @@ field.
Interactively, if called without a prefix, the value of FIELD is the car
of the variable `bbdb-edit-foo'. When called with a prefix, the value
-of FIELD is the cdr of this variable. Then use minibuffer completion
+of FIELD is the `cdr' of this variable. Then use minibuffer completion
to select the field."
(interactive
(let* ((_ (bbdb-editable))
@@ -1634,7 +1634,7 @@ irrespective of the value of ARG."
;;;###autoload
(defun bbdb-delete-field-or-record (records field &optional noprompt)
"For RECORDS delete FIELD.
-If FIELD is the `name' field, delete RECORDS from datanbase.
+If FIELD is the `name' field, delete RECORDS from database.
Interactively, use BBDB prefix \
\\<bbdb-mode-map>\\[bbdb-do-all-records], see `bbdb-do-all-records',
and FIELD is the field point is on.
@@ -1898,7 +1898,7 @@ With prefix, RECORD2 defaults to the first record with
the same name."
Interactively, use BBDB prefix \
\\<bbdb-mode-map>\\[bbdb-do-all-records], see `bbdb-do-all-records'.
If UPDATE is non-nil (as in interactive calls) update the database.
-Otherwise, this is the caller's responsiblity (for example, when used
+Otherwise, this is the caller's responsibility (for example, when used
in `bbdb-change-hook')."
(interactive (list (bbdb-do-records) t))
(bbdb-editable)
@@ -1917,7 +1917,7 @@ in `bbdb-change-hook')."
Interactively, use BBDB prefix \
\\<bbdb-mode-map>\\[bbdb-do-all-records], see `bbdb-do-all-records'.
If UPDATE is non-nil (as in interactive calls) update the database.
-Otherwise, this is the caller's responsiblity (for example, when used
+Otherwise, this is the caller's responsibility (for example, when used
in `bbdb-change-hook')."
(interactive (list (bbdb-do-records) t))
(bbdb-editable)
@@ -1936,7 +1936,7 @@ in `bbdb-change-hook')."
Interactively, use BBDB prefix \
\\<bbdb-mode-map>\\[bbdb-do-all-records], see `bbdb-do-all-records'.
If UPDATE is non-nil (as in interactive calls) update the database.
-Otherwise, this is the caller's responsiblity (for example, when used
+Otherwise, this is the caller's responsibility (for example, when used
in `bbdb-change-hook')."
(interactive (list (bbdb-do-records) t))
(bbdb-editable)
@@ -2038,7 +2038,7 @@ Interactively, use BBDB prefix \
\\<bbdb-mode-map>\\[bbdb-do-all-records], see `bbdb-do-all-records'.
By default, the first mail addresses of RECORDS are used.
If prefix N is a number, use Nth mail address of RECORDS (starting from 1).
-If prefix N is C-u (t noninteractively) use all mail addresses of RECORDS.
+If prefix N is C-u (t non-interactively) use all mail addresses of RECORDS.
If VERBOSE is non-nil (as in interactive calls) be verbose."
(interactive (list (bbdb-do-records) nil
(or (consp current-prefix-arg)
@@ -2057,7 +2057,7 @@ Interactively, use BBDB prefix \
\\<bbdb-mode-map>\\[bbdb-do-all-records], see `bbdb-do-all-records'.
By default, the first mail addresses of RECORDS are used.
If prefix N is a number, use Nth mail address of RECORDS (starting from 1).
-If prefix N is C-u (t noninteractively) use all mail addresses of RECORDS.
+If prefix N is C-u (t non-interactively) use all mail addresses of RECORDS.
If KILL-RING-SAVE is non-nil (as in interactive calls), copy mail addresses
to kill ring. If VERBOSE is non-nil (as in interactive calls) be verbose."
(interactive (list (bbdb-do-records)
@@ -2200,10 +2200,10 @@ completion with."
;;;###autoload
(defun bbdb-complete-mail (&optional beg cycle-completion-buffer)
"In a mail buffer, complete the user name or mail before point.
-Completion happens up to the preceeding colon, comma, or BEG.
+Completion happens up to the preceding colon, comma, or BEG.
Return non-nil if there is a valid completion, else return nil.
-Completion behaviour obeys `bbdb-completion-list' (see there).
+Completion behavior obeys `bbdb-completion-list' (see there).
If what has been typed matches a unique BBDB record, insert an address
formatted by `bbdb-dwim-mail' (see there). Also, display this record
if `bbdb-completion-display-record' is non-nil,
@@ -2424,7 +2424,7 @@ as part of the MUA insinuation."
(setq done 'unique))
(t (setq done 'choose)))))))
- ;; By now, we have considered all possiblities to perform a completion.
+ ;; By now, we have considered all possibilities to perform a completion.
;; If nonetheless we haven't done anything so far, consider cycling.
;;
;; Completion and cycling are really two very separate things.
@@ -2655,7 +2655,7 @@ Rebuilding the aliases is enforced if prefix
FORCE-REBUILT is t."
;; from each of these records.
;; Then `bbdb-message-search' will find the correct records
;; (assuming that each mail address appears only once in the
- ;; database). Nonethless, arg MAILS for `bbdb-mail-abbrev-hook'
+ ;; database). Nonetheless, arg MAILS for `bbdb-mail-abbrev-hook'
;; does not, in general, contain the actual mail addresses
;; of EXPANSION. So what we would need is to go back from
;; EXPANSION to the mail addresses it contains (which is tricky
@@ -2806,7 +2806,7 @@ is non-nil. Do not dial the extension."
;;;###autoload
(defun bbdb-browse-url (records &optional which)
- "Brwose URLs stored in the `url' field of RECORDS.
+ "Browse URLs stored in the `url' field of RECORDS.
Interactively, use BBDB prefix \
\\<bbdb-mode-map>\\[bbdb-do-all-records], see `bbdb-do-all-records'.
Prefix WHICH specifies which URL in field `url' is used (starting from 0).
diff --git a/lisp/bbdb-snarf.el b/lisp/bbdb-snarf.el
index f67cd31..e41f448 100644
--- a/lisp/bbdb-snarf.el
+++ b/lisp/bbdb-snarf.el
@@ -97,7 +97,7 @@ on those parts that were not yet snarfed. The order of the
FUNCTION calls
in a rule is then crucial.
Unlike other parts of BBDB, FUNCTIONs need not update the cache and
hash table for RECORD which is done at the end by `bbdb-snarf'.
-Rules may include a santity check for RECORD like `bbdb-snarf-santity-check'.
+Rules may include a sanity check for RECORD like `bbdb-snarf-sanity-check'.
Usually, this should be the last FUNCTION in a rule. This may turn RECORD
into an empty record that will be discarded."
:group 'bbdb-utilities-snarf
@@ -112,7 +112,7 @@ into an empty record that will be discarded."
(defcustom bbdb-snarf-name-regexp
"^[ \t'\"]*\\([- .,[:word:]]*[[:word:]]\\)"
"Regexp matching a name. Case is ignored.
-The first subexpression becomes the name."
+The first sub-expression becomes the name."
:group 'bbdb-utilities-snarf
:type 'regexp)
@@ -120,7 +120,7 @@ The first subexpression becomes the name."
(concat "\\(?:\\(?:mailto:\\|e?mail:?\\)[ \t]*\\)?"
"<?\\([^ \t\n<]+@[^ \t\n>]+\\)>?")
"Regexp matching a mail address. Case is ignored.
-The first subexpression becomes the mail address."
+The first sub-expression becomes the mail address."
:group 'bbdb-utilities-snarf
:type 'regexp)
@@ -131,7 +131,7 @@ The first subexpression becomes the mail address."
"\\(?: *\\(?:x\\|ext\\.?\\) *[0-9]+\\)?\\)")
"Regexp matching a NANP phone number. Case is ignored.
NANP is the North American Numbering Plan used in North and Central America.
-The first subexpression becomes the phone number."
+The first sub-expression becomes the phone number."
:group 'bbdb-utilities-snarf
:type 'regexp)
@@ -139,7 +139,7 @@ The first subexpression becomes the phone number."
(concat "\\(?:phone?:?[ \t]*\\)?"
"\\(\\(?:\\+[1-9]\\|(\\)[-0-9()\s]+\\)")
"Regexp matching a European phone number.
-The first subexpression becomes the phone number."
+The first sub-expression becomes the phone number."
:group 'bbdb-utilities-snarf
:type 'regexp)
@@ -149,7 +149,7 @@ The first subexpression becomes the phone number."
"\\(-[0-9][0-9][0-9][0-9]\\)?"
"\\>\\)$")
"Regexp matching US postcodes.
-The first subexpression becomes the postcode."
+The first sub-expression becomes the postcode."
:group 'bbdb-utilities-snarf
:type 'regexp)
@@ -190,7 +190,7 @@ The string LABEL denotes the default label for FIELD."
(defcustom bbdb-snarf-url-regexp "\\(\\(?:http://\\|www\\.\\)[^ \t\n]+\\)"
"Regexp matching a URL. Case is ignored.
-The first subexpression becomes the URL."
+The first sub-expression becomes the URL."
:group 'bbdb-utilities-snarf
:type 'regexp)
@@ -276,7 +276,7 @@ Usually, this should be the last element of any snarfing
rule."
(defun bbdb-snarf-mail (record)
"Snarf mail addresses for RECORD.
-This uses the first subexpresion of `bbdb-snarf-mail-regexp'."
+This uses the first sub-expression of `bbdb-snarf-mail-regexp'."
(let ((case-fold-search t) mails)
(while (re-search-forward bbdb-snarf-mail-regexp nil t)
(push (match-string 1) mails)
@@ -295,7 +295,7 @@ This uses the first subexpresion of
`bbdb-snarf-mail-regexp'."
(defun bbdb-snarf-phone-nanp (record)
"Snarf NANP phone numbers for RECORD.
NANP is the North American Numbering Plan used in North and Central America.
-This uses the first subexpresion of `bbdb-snarf-phone-nanp-regexp'."
+This uses the first sub-expression of `bbdb-snarf-phone-nanp-regexp'."
(let ((case-fold-search t) phones)
(while (re-search-forward bbdb-snarf-phone-nanp-regexp nil t)
(goto-char (match-beginning 0))
@@ -414,7 +414,7 @@ COUNTRY is the country to use. It defaults to
`bbdb-snarf-address-eu-country'."
(defun bbdb-snarf-url (record)
"Snarf URL for RECORD.
-This uses the first subexpresion of `bbdb-snarf-url-regexp'."
+This uses the first sub-expression of `bbdb-snarf-url-regexp'."
(when (and bbdb-snarf-url
(let ((case-fold-search t))
(re-search-forward bbdb-snarf-url-regexp nil t)))
@@ -434,7 +434,7 @@ This uses the first subexpresion of
`bbdb-snarf-url-regexp'."
;; vCard format (version 4.0)
;; https://datatracker.ietf.org/doc/html/rfc6350
-;; The following parsing code partly duplicates vcard-parse from GNU Elpa.
+;; The following parsing code partly duplicates vcard-parse from GNU ELPA.
;; But we try to avoid that BBDB depends on packages outside Emacs core.
(defun bbdb-snarf-vcard-property (property &optional sep)
"Return vCard property PROPERTY.
@@ -469,7 +469,7 @@ Delete all instances of PROPERTY from the snarfing buffer."
(with-temp-buffer
(insert str)
(goto-char (point-min))
- ;; This ignores the possiblity that `;' and `:' may appear
+ ;; This ignores the possibility that `;' and `:' may appear
;; in parameter values that are quoted strings. Bother?
(while (looking-at ";\\([^;:]+\\)")
(goto-char (match-end 0))
@@ -485,7 +485,7 @@ Delete all instances of PROPERTY from the snarfing buffer."
(push (cons nil par) par-list))))
(let ((value (buffer-substring-no-properties
(1+ (point)) (point-max))))
- ;; Again, this ignores the possiblity that `;' and `:'
+ ;; Again, this ignores the possibility that `;' and `:'
;; may appear in property values inside quoted strings.
(push (cons (if sep (split-string value sep) value)
(nreverse par-list))
@@ -765,7 +765,7 @@ Return record. Also, display the record unless NO-DISPLAY
is non-nil."
Interactively, STRING is the current region.
RULE defaults to `bbdb-snarf-rule-default'.
See `bbdb-snarf-rule-alist' for details.
-Return the record. Also, displau the record unless NO-DISPLAY is non-nil.
+Return the record. Also, display the record unless NO-DISPLAY is non-nil.
Discard the record and return nil if the record does not have a name or mail."
(interactive
(list (buffer-substring-no-properties (region-beginning) (region-end))
- typos in comments and doc strings,
Sam Steingold <=