Checkdoc fixes: Some Error messages fixed.
They should not end with period and start with capital leter.
This commit is contained in:
parent
ffef7f4ea0
commit
656513e0a9
34
jabber.el
34
jabber.el
|
@ -1188,7 +1188,7 @@ With prefix argument, remove it."
|
|||
load-path)))
|
||||
(require 'srv)))
|
||||
(error
|
||||
"srv not found in `load-path' or jabber-fallback-lib/ directory.")))
|
||||
"The srv library was not found in `load-path' or jabber-fallback-lib/ directory")))
|
||||
|
||||
(defgroup jabber-conn nil "Jabber Connection Settings"
|
||||
:group 'jabber)
|
||||
|
@ -1462,7 +1462,7 @@ connection fails."
|
|||
(targets (jabber-srv-targets server network-server port))
|
||||
errors)
|
||||
(unless (fboundp 'starttls-open-stream)
|
||||
(error "starttls.el not available"))
|
||||
(error "The starttls.el library is not available"))
|
||||
(catch 'connected
|
||||
(dolist (target targets)
|
||||
(condition-case e
|
||||
|
@ -1838,19 +1838,19 @@ what kind of chat buffer is being created.")
|
|||
load-path)))
|
||||
(require 'fsm)))
|
||||
(error
|
||||
"fsm not found in `load-path' or jabber-fallback-lib/ directory.")))
|
||||
"The fsm library was not found in `load-path' or jabber-fallback-lib/ directory")))
|
||||
|
||||
(defvar jabber-connections nil
|
||||
"List of jabber-connection FSMs.")
|
||||
|
||||
(defvar *jabber-roster* nil
|
||||
"the roster list")
|
||||
"The roster list")
|
||||
|
||||
(defvar jabber-jid-obarray (make-vector 127 0)
|
||||
"obarray for keeping JIDs")
|
||||
"Obarray for keeping JIDs")
|
||||
|
||||
(defvar *jabber-disconnecting* nil
|
||||
"boolean - are we in the process of disconnecting by free will")
|
||||
"Boolean - are we in the process of disconnecting by free will")
|
||||
|
||||
(defvar jabber-message-chain nil
|
||||
"Incoming messages are sent to these functions, in order.")
|
||||
|
@ -2642,7 +2642,7 @@ DATA is any sexp."
|
|||
(jabber-filter process fsm)))))
|
||||
|
||||
(defun jabber-filter (process fsm)
|
||||
"the filter function for the jabber process"
|
||||
"The filter function for the jabber process"
|
||||
(with-current-buffer (process-buffer process)
|
||||
;; Start from the beginning
|
||||
(goto-char (point-min))
|
||||
|
@ -2717,7 +2717,7 @@ DATA is any sexp."
|
|||
))))
|
||||
|
||||
(defun jabber-process-input (jc xml-data)
|
||||
"process an incoming parsed tag"
|
||||
"Process an incoming parsed tag"
|
||||
(let* ((tag (jabber-xml-node-name xml-data))
|
||||
(functions (eval (cdr (assq tag '((iq . jabber-iq-chain)
|
||||
(presence . jabber-presence-chain)
|
||||
|
@ -2838,7 +2838,7 @@ Return an fsm result list if it is."
|
|||
#'jabber-process-logon nil))))
|
||||
|
||||
(defun jabber-process-logon (jc xml-data closure-data)
|
||||
"receive login success or failure, and request roster.
|
||||
"Receive login success or failure, and request roster.
|
||||
CLOSURE-DATA should be the password on success and nil on failure."
|
||||
(if closure-data
|
||||
;; Logon success
|
||||
|
@ -3036,7 +3036,7 @@ Trailing newlines are always removed, regardless of this variable."
|
|||
:group 'jabber-roster)
|
||||
|
||||
(defvar jabber-roster-debug nil
|
||||
"debug roster draw")
|
||||
"Debug roster draw")
|
||||
|
||||
(defvar jabber-roster-mode-map
|
||||
(let ((map (make-sparse-keymap)))
|
||||
|
@ -3203,7 +3203,7 @@ be used in `jabber-post-connection-hooks'."
|
|||
(switch-to-buffer jabber-roster-buffer)))
|
||||
|
||||
(defun jabber-sort-roster (jc)
|
||||
"sort roster according to online status"
|
||||
"Sort roster according to online status"
|
||||
(let ((state-data (fsm-get-state-data jc)))
|
||||
(dolist (group (plist-get state-data :roster-groups))
|
||||
(let ((group-name (car group)))
|
||||
|
@ -3215,7 +3215,7 @@ be used in `jabber-post-connection-hooks'."
|
|||
(plist-get state-data :roster-hash))))))
|
||||
|
||||
(defun jabber-roster-prepare-roster (jc)
|
||||
"make a hash based roster"
|
||||
"Make a hash based roster"
|
||||
(let* ((state-data (fsm-get-state-data jc))
|
||||
(hash (make-hash-table :test 'equal))
|
||||
(buddies (plist-get state-data :roster))
|
||||
|
@ -3335,7 +3335,7 @@ To change this permanently, customize the `jabber-show-offline-contacts'."
|
|||
(jabber-display-roster))
|
||||
|
||||
(defun jabber-display-roster ()
|
||||
"switch to the main jabber buffer and refresh the roster display to reflect the current information"
|
||||
"Switch to the main jabber buffer and refresh the roster display to reflect the current information"
|
||||
(interactive)
|
||||
(with-current-buffer (get-buffer-create jabber-roster-buffer)
|
||||
(if (not (eq major-mode 'jabber-roster-mode))
|
||||
|
@ -3938,7 +3938,7 @@ See `jabber-roster-to-sexp' for description of output format."
|
|||
:value roster)))
|
||||
|
||||
(defvar *jabber-open-info-queries* nil
|
||||
"an alist of open query id and their callback functions")
|
||||
"An alist of open query id and their callback functions")
|
||||
|
||||
(defvar jabber-iq-get-xmlns-alist nil
|
||||
"Mapping from XML namespace to handler for IQ GET requests.")
|
||||
|
@ -3984,7 +3984,7 @@ These fields are available at this moment:
|
|||
|
||||
(add-to-list 'jabber-iq-chain 'jabber-process-iq)
|
||||
(defun jabber-process-iq (jc xml-data)
|
||||
"process an incoming iq stanza"
|
||||
"Process an incoming iq stanza"
|
||||
(let* ((id (jabber-xml-get-attribute xml-data 'id))
|
||||
(type (jabber-xml-get-attribute xml-data 'type))
|
||||
(from (jabber-xml-get-attribute xml-data 'from))
|
||||
|
@ -7766,7 +7766,7 @@ ERROR-CLOSURE-DATA are used as in `jabber-send-iq'."
|
|||
load-path)))
|
||||
(require 'hexrgb)))
|
||||
(error
|
||||
"hexrgb not found in `load-path' or jabber-fallback-lib/ directory.")))
|
||||
"The hexrgb library was not found in `load-path' or jabber-fallback-lib/ directory")))
|
||||
|
||||
(defcustom jabber-muc-participant-colors nil
|
||||
"Alist of used colors. Format is (nick . color). Color may be
|
||||
|
@ -9821,7 +9821,7 @@ sends a message if that happens. The buddies are stored in
|
|||
(interactive (list (jabber-read-jid-completing "Add buddy to watch list: ")
|
||||
(read-string "Comment: ")))
|
||||
(unless (memq 'jabber-presence-watch jabber-presence-hooks)
|
||||
(error "jabber-presence-watch is not in jabber-presence-hooks"))
|
||||
(error "The jabber-presence-watch function is not in jabber-presence-hooks"))
|
||||
(add-to-list 'jabber-watch-alist (cons
|
||||
(jabber-jid-symbol buddy)
|
||||
(and (not (zerop (length comment)))
|
||||
|
|
34
jabber.org
34
jabber.org
|
@ -1664,7 +1664,7 @@ A collection of functions, that hide the details of transmitting to and fro a Ja
|
|||
load-path)))
|
||||
(require 'srv)))
|
||||
(error
|
||||
"srv not found in `load-path' or jabber-fallback-lib/ directory.")))
|
||||
"The srv library was not found in `load-path' or jabber-fallback-lib/ directory")))
|
||||
|
||||
#+END_SRC
|
||||
**** jabber-conn :custom:group:
|
||||
|
@ -1986,7 +1986,7 @@ connection fails."
|
|||
(targets (jabber-srv-targets server network-server port))
|
||||
errors)
|
||||
(unless (fboundp 'starttls-open-stream)
|
||||
(error "starttls.el not available"))
|
||||
(error "The starttls.el library is not available"))
|
||||
(catch 'connected
|
||||
(dolist (target targets)
|
||||
(condition-case e
|
||||
|
@ -2473,7 +2473,7 @@ Standards (probably) involved -
|
|||
load-path)))
|
||||
(require 'fsm)))
|
||||
(error
|
||||
"fsm not found in `load-path' or jabber-fallback-lib/ directory.")))
|
||||
"The fsm library was not found in `load-path' or jabber-fallback-lib/ directory")))
|
||||
|
||||
#+END_SRC
|
||||
**** jabber-connections :variable:
|
||||
|
@ -2485,19 +2485,19 @@ Standards (probably) involved -
|
|||
**** *jabber-roster* :variable:
|
||||
#+BEGIN_SRC emacs-lisp
|
||||
(defvar *jabber-roster* nil
|
||||
"the roster list")
|
||||
"The roster list")
|
||||
|
||||
#+END_SRC
|
||||
**** jabber-jid-obarray :variable:
|
||||
#+BEGIN_SRC emacs-lisp
|
||||
(defvar jabber-jid-obarray (make-vector 127 0)
|
||||
"obarray for keeping JIDs")
|
||||
"Obarray for keeping JIDs")
|
||||
|
||||
#+END_SRC
|
||||
**** *jabber-disconnecting* :variable:
|
||||
#+BEGIN_SRC emacs-lisp
|
||||
(defvar *jabber-disconnecting* nil
|
||||
"boolean - are we in the process of disconnecting by free will")
|
||||
"Boolean - are we in the process of disconnecting by free will")
|
||||
|
||||
#+END_SRC
|
||||
**** jabber-message-chain :variable:
|
||||
|
@ -3427,7 +3427,7 @@ DATA is any sexp."
|
|||
**** jabber-filter :function:
|
||||
#+BEGIN_SRC emacs-lisp
|
||||
(defun jabber-filter (process fsm)
|
||||
"the filter function for the jabber process"
|
||||
"The filter function for the jabber process"
|
||||
(with-current-buffer (process-buffer process)
|
||||
;; Start from the beginning
|
||||
(goto-char (point-min))
|
||||
|
@ -3505,7 +3505,7 @@ DATA is any sexp."
|
|||
**** jabber-process-input :function:
|
||||
#+BEGIN_SRC emacs-lisp
|
||||
(defun jabber-process-input (jc xml-data)
|
||||
"process an incoming parsed tag"
|
||||
"Process an incoming parsed tag"
|
||||
(let* ((tag (jabber-xml-node-name xml-data))
|
||||
(functions (eval (cdr (assq tag '((iq . jabber-iq-chain)
|
||||
(presence . jabber-presence-chain)
|
||||
|
@ -3661,7 +3661,7 @@ In Emacs 24, sha1 is built in, so this =require= is only needed for earlier vers
|
|||
**** jabber-process-logon :function:
|
||||
#+BEGIN_SRC emacs-lisp
|
||||
(defun jabber-process-logon (jc xml-data closure-data)
|
||||
"receive login success or failure, and request roster.
|
||||
"Receive login success or failure, and request roster.
|
||||
CLOSURE-DATA should be the password on success and nil on failure."
|
||||
(if closure-data
|
||||
;; Logon success
|
||||
|
@ -3935,7 +3935,7 @@ Trailing newlines are always removed, regardless of this variable."
|
|||
**** jabber-roster-debug :variable:
|
||||
#+BEGIN_SRC emacs-lisp
|
||||
(defvar jabber-roster-debug nil
|
||||
"debug roster draw")
|
||||
"Debug roster draw")
|
||||
|
||||
#+END_SRC
|
||||
**** jabber-roster-mode-map :variable:
|
||||
|
@ -4135,7 +4135,7 @@ be used in `jabber-post-connection-hooks'."
|
|||
**** jabber-sort-roster :function:
|
||||
#+BEGIN_SRC emacs-lisp
|
||||
(defun jabber-sort-roster (jc)
|
||||
"sort roster according to online status"
|
||||
"Sort roster according to online status"
|
||||
(let ((state-data (fsm-get-state-data jc)))
|
||||
(dolist (group (plist-get state-data :roster-groups))
|
||||
(let ((group-name (car group)))
|
||||
|
@ -4150,7 +4150,7 @@ be used in `jabber-post-connection-hooks'."
|
|||
**** jabber-roster-prepare-roster :function:
|
||||
#+BEGIN_SRC emacs-lisp
|
||||
(defun jabber-roster-prepare-roster (jc)
|
||||
"make a hash based roster"
|
||||
"Make a hash based roster"
|
||||
(let* ((state-data (fsm-get-state-data jc))
|
||||
(hash (make-hash-table :test 'equal))
|
||||
(buddies (plist-get state-data :roster))
|
||||
|
@ -4300,7 +4300,7 @@ To change this permanently, customize the `jabber-show-offline-contacts'."
|
|||
**** jabber-display-roster :command:
|
||||
#+BEGIN_SRC emacs-lisp
|
||||
(defun jabber-display-roster ()
|
||||
"switch to the main jabber buffer and refresh the roster display to reflect the current information"
|
||||
"Switch to the main jabber buffer and refresh the roster display to reflect the current information"
|
||||
(interactive)
|
||||
(with-current-buffer (get-buffer-create jabber-roster-buffer)
|
||||
(if (not (eq major-mode 'jabber-roster-mode))
|
||||
|
@ -4982,7 +4982,7 @@ See `jabber-roster-to-sexp' for description of output format."
|
|||
**** *jabber-open-info-queries* :variable:
|
||||
#+BEGIN_SRC emacs-lisp
|
||||
(defvar *jabber-open-info-queries* nil
|
||||
"an alist of open query id and their callback functions")
|
||||
"An alist of open query id and their callback functions")
|
||||
|
||||
#+END_SRC
|
||||
**** jabber-iq-get-xmlns-alist :variable:
|
||||
|
@ -5055,7 +5055,7 @@ These fields are available at this moment:
|
|||
#+BEGIN_SRC emacs-lisp
|
||||
(add-to-list 'jabber-iq-chain 'jabber-process-iq)
|
||||
(defun jabber-process-iq (jc xml-data)
|
||||
"process an incoming iq stanza"
|
||||
"Process an incoming iq stanza"
|
||||
(let* ((id (jabber-xml-get-attribute xml-data 'id))
|
||||
(type (jabber-xml-get-attribute xml-data 'type))
|
||||
(from (jabber-xml-get-attribute xml-data 'from))
|
||||
|
@ -9717,7 +9717,7 @@ ERROR-CLOSURE-DATA are used as in `jabber-send-iq'."
|
|||
load-path)))
|
||||
(require 'hexrgb)))
|
||||
(error
|
||||
"hexrgb not found in `load-path' or jabber-fallback-lib/ directory.")))
|
||||
"The hexrgb library was not found in `load-path' or jabber-fallback-lib/ directory")))
|
||||
|
||||
#+END_SRC
|
||||
**** jabber-muc-participant-colors :custom:variable:
|
||||
|
@ -12296,7 +12296,7 @@ sends a message if that happens. The buddies are stored in
|
|||
(interactive (list (jabber-read-jid-completing "Add buddy to watch list: ")
|
||||
(read-string "Comment: ")))
|
||||
(unless (memq 'jabber-presence-watch jabber-presence-hooks)
|
||||
(error "jabber-presence-watch is not in jabber-presence-hooks"))
|
||||
(error "The jabber-presence-watch function is not in jabber-presence-hooks"))
|
||||
(add-to-list 'jabber-watch-alist (cons
|
||||
(jabber-jid-symbol buddy)
|
||||
(and (not (zerop (length comment)))
|
||||
|
|
Loading…
Reference in New Issue