bbdb-user
[Top][All Lists]
Advanced

[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))



reply via email to

[Prev in Thread] Current Thread [Next in Thread]