1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2025-12-06 06:20:55 -08:00

lisp/*.el, src/*.c: Fix typos in docstrings

* lisp/apropos.el (apropos-do-all):
* lisp/auth-source-pass.el (auth-source-pass--select-from-entries):
* lisp/auth-source.el (auth-source-user-or-password):
* lisp/calc/calc-forms.el (math-tzone-names):
* lisp/calendar/diary-lib.el (diary-face-attrs)
(diary-mark-entries-1):
* lisp/cedet/cedet-files.el (cedet-files-list-recursively):
* lisp/cedet/ede.el (ede-constructing, ede-deep-rescan):
* lisp/cedet/ede/cpp-root.el (ede-cpp-root-header-file-p):
* lisp/cedet/ede/proj.el (ede-proj-target-makefile):
* lisp/cedet/inversion.el (inversion-check-version)
(inversion-test):
* lisp/cedet/mode-local.el (mode-local-map-file-buffers):
* lisp/cedet/semantic/complete.el (semantic-displayer-ghost):
* lisp/cedet/semantic/db-find.el (semanticdb-find-translate-path-default):
* lisp/cedet/semantic/db.el (semanticdb-table)
(semanticdb-search-system-databases):
* lisp/cedet/semantic/imenu.el (semantic-imenu-index-directory):
* lisp/cedet/semantic/java.el (semantic-java-doc-keywords-map):
* lisp/cedet/semantic/lex-spp.el (semantic-lex-spp-use-headers-flag):
* lisp/cedet/semantic/lex.el (semantic-lex-make-keyword-table)
(semantic-lex-make-type-table, semantic-lex-debug-analyzers):
* lisp/cedet/semantic/tag-ls.el (semantic-tag-abstract-p)
(semantic-tag-leaf-p, semantic-tag-static-p)
(semantic-tag-prototype-p):
* lisp/dnd.el (dnd-open-remote-file-function, dnd-open-local-file):
* lisp/emacs-lisp/eieio-opt.el (eieio-build-class-alist)
(eieio-read-class, eieio-read-subclass):
* lisp/emacs-lisp/generator.el (cps--replace-variable-references)
(cps--handle-loop-for):
* lisp/erc/erc-dcc.el (erc-dcc-list, erc-dcc-member, erc-dcc-server)
(erc-dcc-auto-mask-p, erc-dcc-get-file, erc-dcc-chat-accept):
* lisp/eshell/em-pred.el (eshell-pred-file-type):
* lisp/faces.el (defined-colors-with-face-attributes):
* lisp/font-core.el (font-lock-mode):
* lisp/frame.el (frame-restack):
* lisp/net/shr.el (shr-image-animate):
* lisp/org/org-agenda.el (org-agenda-change-all-lines)
(org-agenda-today-p):
* lisp/org/org-id.el (org-id-get):
* lisp/org/org.el (org-highlight-latex-and-related)
(org--valid-property-p):
* lisp/org/ox-beamer.el (org-beamer--get-label):
* lisp/org/ox-latex.el (org-latex--caption-above-p):
* lisp/org/ox-odt.el (org-odt--copy-image-file)
(org-odt--copy-formula-file):
* lisp/org/ox.el (org-export-with-timestamps):
* lisp/progmodes/verilog-mode.el (verilog-indent-declaration-macros):
* lisp/ses.el (ses-file-format-extend-parameter-list):
* lisp/term.el (ansi-term):
* lisp/textmodes/bibtex.el (bibtex-no-opt-remove-re)
(bibtex-beginning-of-first-entry, bibtex-autokey-get-title)
(bibtex-read-key, bibtex-initialize):
* lisp/textmodes/flyspell.el (flyspell-word):
* lisp/view.el (view-mode-exit):
* src/composite.c:
* src/floatfns.c (Fisnan): Fix typos in docstrings.
This commit is contained in:
Juanma Barranquero 2019-09-19 04:32:25 +02:00
parent 34f1035e87
commit 79a01866a0
47 changed files with 82 additions and 82 deletions

View file

@ -66,7 +66,7 @@
;; I see a degradation of maybe 10-20% only. ;; I see a degradation of maybe 10-20% only.
(defcustom apropos-do-all nil (defcustom apropos-do-all nil
"Non nil means apropos commands will search more extensively. "Non-nil means apropos commands will search more extensively.
This may be slower. This option affects the following commands: This may be slower. This option affects the following commands:
`apropos-user-option' will search all variables, not just user options. `apropos-user-option' will search all variables, not just user options.

View file

@ -243,7 +243,7 @@ HOSTNAME should not contain any username or port number."
(defun auth-source-pass--select-from-entries (entries user) (defun auth-source-pass--select-from-entries (entries user)
"Return best matching password-store entry data from ENTRIES. "Return best matching password-store entry data from ENTRIES.
If USER is non nil, give precedence to entries containing a user field If USER is non-nil, give precedence to entries containing a user field
matching USER." matching USER."
(let (fallback) (let (fallback)
(catch 'auth-source-pass-break (catch 'auth-source-pass-break

View file

@ -2259,12 +2259,12 @@ items don't have a username. This means that if you search for
username \"joe\" and it matches an item but the item doesn't have username \"joe\" and it matches an item but the item doesn't have
a :user attribute, the username \"joe\" will be returned. a :user attribute, the username \"joe\" will be returned.
A non nil DELETE-EXISTING means deleting any matching password A non-nil DELETE-EXISTING means deleting any matching password
entry in the respective sources. This is useful only when entry in the respective sources. This is useful only when
CREATE-MISSING is non nil as well; the intended use case is to CREATE-MISSING is non-nil as well; the intended use case is to
remove wrong password entries. remove wrong password entries.
If no matching entry is found, and CREATE-MISSING is non nil, If no matching entry is found, and CREATE-MISSING is non-nil,
the password will be retrieved interactively, and it will be the password will be retrieved interactively, and it will be
stored in the password database which matches best (see stored in the password database which matches best (see
`auth-sources'). `auth-sources').

View file

@ -1462,7 +1462,7 @@ as measured in the integer number of days before December 31, 1 BC (Gregorian)."
( "PGT" 8 "PST" "PDT" ) ( "PST" 8 0 ) ( "PDT" 8 -1 ) ; Pacific ( "PGT" 8 "PST" "PDT" ) ( "PST" 8 0 ) ( "PDT" 8 -1 ) ; Pacific
( "YGT" 9 "YST" "YDT" ) ( "YST" 9 0 ) ( "YDT" 9 -1 ) ; Yukon ( "YGT" 9 "YST" "YDT" ) ( "YST" 9 0 ) ( "YDT" 9 -1 ) ; Yukon
) )
"No doc yet. See calc manual for now. ") "No doc yet. See calc manual for now.")
(defvar var-TimeZone nil) (defvar var-TimeZone nil)

View file

@ -97,7 +97,7 @@ is pre-pended to REGEXP for file-wide specifiers. ATTRIBUTE
specifies which face attribute (e.g. `:foreground') to modify, or specifies which face attribute (e.g. `:foreground') to modify, or
that this is a face (`:face') to apply. TYPE is the type of that this is a face (`:face') to apply. TYPE is the type of
attribute being applied. Available TYPES (see `diary-attrtype-convert') attribute being applied. Available TYPES (see `diary-attrtype-convert')
are: `string', `symbol', `int', `tnil', `stringtnil.'" are: `string', `symbol', `int', `tnil', `stringtnil'."
:type '(repeat (list (string :tag "Regular expression") :type '(repeat (list (string :tag "Regular expression")
(integer :tag "Sub-expression") (integer :tag "Sub-expression")
(symbol :tag "Attribute (e.g. :foreground)") (symbol :tag "Attribute (e.g. :foreground)")
@ -1257,7 +1257,7 @@ the regexp with parentheses."
MARKFUNC is a function that marks entries of the appropriate type MARKFUNC is a function that marks entries of the appropriate type
matching a given date pattern. MONTHS is an array of month names. matching a given date pattern. MONTHS is an array of month names.
SYMBOL marks diary entries of the type in question. ABSFUNC is a SYMBOL marks diary entries of the type in question. ABSFUNC is a
function that converts absolute dates to dates of the appropriate type. " function that converts absolute dates to dates of the appropriate type."
(calendar-dlet* (calendar-dlet*
((dayname (diary-name-pattern calendar-day-name-array ((dayname (diary-name-pattern calendar-day-name-array
calendar-day-abbrev-array)) calendar-day-abbrev-array))

View file

@ -89,7 +89,7 @@ specific conversions during tests."
file)) file))
(defun cedet-files-list-recursively (dir re) (defun cedet-files-list-recursively (dir re)
"Returns list of files in directory matching to given regex" "Return list of files in directory matching to given regex."
(when (file-accessible-directory-p dir) (when (file-accessible-directory-p dir)
(let ((files (directory-files dir t)) (let ((files (directory-files dir t))
matched) matched)

View file

@ -162,12 +162,12 @@ This object's class determines how to compile and debug from a buffer.")
If `ede-object' is nil, then commands will operate on this object.") If `ede-object' is nil, then commands will operate on this object.")
(defvar ede-constructing nil (defvar ede-constructing nil
"Non nil when constructing a project hierarchy. "Non-nil when constructing a project hierarchy.
If the project is being constructed from an autoload, then the If the project is being constructed from an autoload, then the
value is the autoload object being used.") value is the autoload object being used.")
(defvar ede-deep-rescan nil (defvar ede-deep-rescan nil
"Non nil means scan down a tree, otherwise rescans are top level only. "Non-nil means scan down a tree, otherwise rescans are top level only.
Do not set this to non-nil globally. It is used internally.") Do not set this to non-nil globally. It is used internally.")

View file

@ -389,7 +389,7 @@ This knows details about or source tree."
;; include lists, and Preprocessor symbol tables. ;; include lists, and Preprocessor symbol tables.
(cl-defmethod ede-cpp-root-header-file-p ((proj ede-cpp-root-project) name) (cl-defmethod ede-cpp-root-header-file-p ((proj ede-cpp-root-project) name)
"Non nil if in PROJ the filename NAME is a header." "Non-nil if in PROJ the filename NAME is a header."
(save-match-data (save-match-data
(string-match (oref proj header-match-regexp) name))) (string-match (oref proj header-match-regexp) name)))

View file

@ -165,7 +165,7 @@ These are the linkers the user can choose from when setting the
:label "Part of all: target" :label "Part of all: target"
:group make :group make
:documentation :documentation
"Non nil means the rule created is part of the all: target. "Non-nil means the rule created is part of the all: target.
Setting this to nil creates the rule to build this item, but does not Setting this to nil creates the rule to build this item, but does not
include it in the all: rule.") include it in the all: rule.")
(configuration-variables (configuration-variables

View file

@ -58,7 +58,7 @@
"Run FUNCTION on every file buffer found. "Run FUNCTION on every file buffer found.
FUNCTION does not have arguments; when it is entered `current-buffer' FUNCTION does not have arguments; when it is entered `current-buffer'
is the currently selected file buffer. is the currently selected file buffer.
If optional argument PREDICATE is non nil, only select file buffers If optional argument PREDICATE is non-nil, only select file buffers
for which the function PREDICATE returns non-nil. for which the function PREDICATE returns non-nil.
If optional argument BUFFERS is non-nil, it is a list of buffers to If optional argument BUFFERS is non-nil, it is a list of buffers to
walk through. It defaults to `buffer-list'." walk through. It defaults to `buffer-list'."

View file

@ -1800,7 +1800,7 @@ Return a cons cell (X . Y)"
"The overlay the ghost text is displayed in.") "The overlay the ghost text is displayed in.")
(first-show :initform t (first-show :initform t
:documentation :documentation
"Non nil if we have not seen our first show request.") "Non-nil if we have not seen our first show request.")
) )
"Cycle completions inline with ghost text. "Cycle completions inline with ghost text.
Completion displayer using ghost chars after point for focus options. Completion displayer using ghost chars after point for focus options.

View file

@ -304,7 +304,7 @@ so that it can be called from the idle work handler."
(defun semanticdb-find-translate-path-default (path brutish) (defun semanticdb-find-translate-path-default (path brutish)
"Translate PATH into a list of semantic tables. "Translate PATH into a list of semantic tables.
If BRUTISH is non nil, return all tables associated with PATH. If BRUTISH is non-nil, return all tables associated with PATH.
Default action as described in `semanticdb-find-translate-path'." Default action as described in `semanticdb-find-translate-path'."
(if (semanticdb-find-results-p path) (if (semanticdb-find-results-p path)
;; nil means perform the search over these results. ;; nil means perform the search over these results.

View file

@ -238,7 +238,7 @@ If nil, the table's buffer is no in Emacs. If it has a value, then
it is in Emacs.") it is in Emacs.")
(dirty :initform nil (dirty :initform nil
:documentation :documentation
"Non nil if this table needs to be `Saved'.") "Non-nil if this table needs to be `Saved'.")
(db-refs :initform nil (db-refs :initform nil
:documentation :documentation
"List of `semanticdb-table' objects referring to this one. "List of `semanticdb-table' objects referring to this one.
@ -833,7 +833,7 @@ value.")
(make-variable-buffer-local 'semanticdb-project-system-databases) (make-variable-buffer-local 'semanticdb-project-system-databases)
(defvar semanticdb-search-system-databases t (defvar semanticdb-search-system-databases t
"Non nil if search routines are to include a system database.") "Non-nil if search routines are to include a system database.")
(defun semanticdb-current-database-list (&optional dir) (defun semanticdb-current-database-list (&optional dir)
"Return a list of databases associated with the current buffer. "Return a list of databases associated with the current buffer.

View file

@ -119,7 +119,7 @@ See `semantic-bucketize' and the FILTER argument for more details on this functi
(make-variable-buffer-local 'semantic-imenu-sort-bucket-function) (make-variable-buffer-local 'semantic-imenu-sort-bucket-function)
(defcustom semantic-imenu-index-directory nil (defcustom semantic-imenu-index-directory nil
"Non nil to index the entire directory for tags. "Non-nil to index the entire directory for tags.
Doesn't actually parse the entire directory, but displays tags for all files Doesn't actually parse the entire directory, but displays tags for all files
currently listed in the current Semantic database. currently listed in the current Semantic database.
This variable has no meaning if semanticdb is not active." This variable has no meaning if semanticdb is not active."

View file

@ -391,7 +391,7 @@ That is TAG `symbol-name' without the leading `@'."
(defun semantic-java-doc-keywords-map (fun &optional property) (defun semantic-java-doc-keywords-map (fun &optional property)
"Run function FUN for each javadoc keyword. "Run function FUN for each javadoc keyword.
Return the list of FUN results. If optional PROPERTY is non nil only Return the list of FUN results. If optional PROPERTY is non-nil only
call FUN for javadoc keywords which have a value for PROPERTY. FUN call FUN for javadoc keywords which have a value for PROPERTY. FUN
receives two arguments: the javadoc keyword and its associated receives two arguments: the javadoc keyword and its associated
'javadoc property list. It can return any value. All nil values are 'javadoc property list. It can return any value. All nil values are

View file

@ -1244,7 +1244,7 @@ For languages that use the Semantic pre-processor, this can
improve the accuracy of parsed files where include files improve the accuracy of parsed files where include files
can change the state of what's parsed in the current file. can change the state of what's parsed in the current file.
Note: Note implemented yet" Note: Not implemented yet."
:group 'semantic :group 'semantic
:type 'boolean) :type 'boolean)

View file

@ -256,7 +256,7 @@ SPECS must be a list of (NAME . TOKSYM) elements, where:
NAME is the name of the keyword symbol to define. NAME is the name of the keyword symbol to define.
TOKSYM is the lexical token symbol of that keyword. TOKSYM is the lexical token symbol of that keyword.
If optional argument PROPSPECS is non nil, then interpret it, and If optional argument PROPSPECS is non-nil, then interpret it, and
apply those properties. apply those properties.
PROPSPECS must be a list of (NAME PROPERTY VALUE) elements." PROPSPECS must be a list of (NAME PROPERTY VALUE) elements."
;; Create the symbol hash table ;; Create the symbol hash table
@ -414,7 +414,7 @@ SPECS must be a list of (TYPE . TOKENS) elements, where:
MATCHER is a string or regexp a text must match to be a such MATCHER is a string or regexp a text must match to be a such
lexical token. lexical token.
If optional argument PROPSPECS is non nil, then interpret it, and If optional argument PROPSPECS is non-nil, then interpret it, and
apply those properties. apply those properties.
PROPSPECS must be a list of (TYPE PROPERTY VALUE)." PROPSPECS must be a list of (TYPE PROPERTY VALUE)."
;; Create the symbol hash table ;; Create the symbol hash table
@ -1060,7 +1060,7 @@ The collapsed tokens are saved in `semantic-lex-block-streams'."
;; to create new lexical analyzers. ;; to create new lexical analyzers.
(defcustom semantic-lex-debug-analyzers nil (defcustom semantic-lex-debug-analyzers nil
"Non nil means to debug analyzers with syntax protection. "Non-nil means to debug analyzers with syntax protection.
Only in effect if `debug-on-error' is also non-nil." Only in effect if `debug-on-error' is also non-nil."
:group 'semantic :group 'semantic
:type 'boolean) :type 'boolean)

View file

@ -369,7 +369,7 @@ For these PROTECTIONs, true is returned if TAG is:
)) ))
(define-overloadable-function semantic-tag-abstract-p (tag &optional parent) (define-overloadable-function semantic-tag-abstract-p (tag &optional parent)
"Return non nil if TAG is abstract. "Return non-nil if TAG is abstract.
Optional PARENT is the parent tag of TAG. Optional PARENT is the parent tag of TAG.
In UML, abstract methods and classes have special meaning and behavior In UML, abstract methods and classes have special meaning and behavior
in how methods are overridden. In UML, abstract methods are italicized. in how methods are overridden. In UML, abstract methods are italicized.
@ -393,7 +393,7 @@ See `semantic-tag-abstract-p'."
abs)) abs))
(define-overloadable-function semantic-tag-leaf-p (tag &optional parent) (define-overloadable-function semantic-tag-leaf-p (tag &optional parent)
"Return non nil if TAG is leaf. "Return non-nil if TAG is leaf.
Optional PARENT is the parent tag of TAG. Optional PARENT is the parent tag of TAG.
In UML, leaf methods and classes have special meaning and behavior. In UML, leaf methods and classes have special meaning and behavior.
@ -417,7 +417,7 @@ See `semantic-tag-leaf-p'."
leaf)) leaf))
(define-overloadable-function semantic-tag-static-p (tag &optional parent) (define-overloadable-function semantic-tag-static-p (tag &optional parent)
"Return non nil if TAG is static. "Return non-nil if TAG is static.
Optional PARENT is the parent tag of TAG. Optional PARENT is the parent tag of TAG.
In UML, static methods and attributes mean that they are allocated In UML, static methods and attributes mean that they are allocated
in the parent class, and are not instance specific. in the parent class, and are not instance specific.
@ -436,7 +436,7 @@ See `semantic-tag-static-p'."
;;;###autoload ;;;###autoload
(define-overloadable-function semantic-tag-prototype-p (tag) (define-overloadable-function semantic-tag-prototype-p (tag)
"Return non nil if TAG is a prototype. "Return non-nil if TAG is a prototype.
For some languages, such as C, a prototype is a declaration of For some languages, such as C, a prototype is a declaration of
something without an implementation." something without an implementation."
) )

View file

@ -184,7 +184,7 @@ the standard function `semantic-parse-stream'."
;; lookahead tokens and tokens in STREAM can be different the ;; lookahead tokens and tokens in STREAM can be different the
;; lookahead token is put in the variable `wisent-lex-lookahead' ;; lookahead token is put in the variable `wisent-lex-lookahead'
;; before calling `wisent-parse'. Wisent's lexers always pop the ;; before calling `wisent-parse'. Wisent's lexers always pop the
;; next lexical token from that variable when non nil, then from ;; next lexical token from that variable when non-nil, then from
;; the lexical input stream. ;; the lexical input stream.
;; ;;
;; The first element of STREAM is used to keep lookahead tokens ;; The first element of STREAM is used to keep lookahead tokens

View file

@ -63,8 +63,8 @@ if some action was made, or nil if the URL is ignored."
'dnd-open-local-file 'dnd-open-local-file
'dnd-open-remote-url) 'dnd-open-remote-url)
"The function to call when opening a file on a remote machine. "The function to call when opening a file on a remote machine.
The function will be called with two arguments; URI and ACTION. See The function will be called with two arguments, URI and ACTION.
`dnd-open-file' for details. See `dnd-open-file' for details.
If nil, then dragging remote files into Emacs will result in an error. If nil, then dragging remote files into Emacs will result in an error.
Predefined functions are `dnd-open-local-file' and `dnd-open-remote-url'. Predefined functions are `dnd-open-local-file' and `dnd-open-remote-url'.
`dnd-open-local-file' attempts to open a remote file using its UNC name and `dnd-open-local-file' attempts to open a remote file using its UNC name and

View file

@ -86,7 +86,7 @@ Argument CH-PREFIX is another character prefix to display."
(defun eieio-build-class-alist (&optional class instantiable-only buildlist) (defun eieio-build-class-alist (&optional class instantiable-only buildlist)
"Return an alist of all currently active classes for completion purposes. "Return an alist of all currently active classes for completion purposes.
Optional argument CLASS is the class to start with. Optional argument CLASS is the class to start with.
If INSTANTIABLE-ONLY is non nil, only allow names of classes which If INSTANTIABLE-ONLY is non-nil, only allow names of classes which
are not abstract, otherwise allow all classes. are not abstract, otherwise allow all classes.
Optional argument BUILDLIST is more list to attach and is used internally." Optional argument BUILDLIST is more list to attach and is used internally."
(let* ((cc (or class 'eieio-default-superclass)) (let* ((cc (or class 'eieio-default-superclass))
@ -107,7 +107,7 @@ Optional argument BUILDLIST is more list to attach and is used internally."
(defun eieio-read-class (prompt &optional histvar instantiable-only) (defun eieio-read-class (prompt &optional histvar instantiable-only)
"Return a class chosen by the user using PROMPT. "Return a class chosen by the user using PROMPT.
Optional argument HISTVAR is a variable to use as history. Optional argument HISTVAR is a variable to use as history.
If INSTANTIABLE-ONLY is non nil, only allow names of classes which If INSTANTIABLE-ONLY is non-nil, only allow names of classes which
are not abstract." are not abstract."
(intern (completing-read prompt (eieio-build-class-alist nil instantiable-only) (intern (completing-read prompt (eieio-build-class-alist nil instantiable-only)
nil t nil nil t nil
@ -117,7 +117,7 @@ are not abstract."
"Return a class chosen by the user using PROMPT. "Return a class chosen by the user using PROMPT.
CLASS is the base class, and completion occurs across all subclasses. CLASS is the base class, and completion occurs across all subclasses.
Optional argument HISTVAR is a variable to use as history. Optional argument HISTVAR is a variable to use as history.
If INSTANTIABLE-ONLY is non nil, only allow names of classes which If INSTANTIABLE-ONLY is non-nil, only allow names of classes which
are not abstract." are not abstract."
(intern (completing-read prompt (intern (completing-read prompt
(eieio-build-class-alist class instantiable-only) (eieio-build-class-alist class instantiable-only)

View file

@ -760,7 +760,7 @@ Return the value with which ITERATOR finished iteration."
(cps--advance-for ,cs)))) (cps--advance-for ,cs))))
(defun cps--handle-loop-for (var) (defun cps--handle-loop-for (var)
"Support `iter-by' in `loop'. " "Support `iter-by' in `loop'."
;; N.B. While the cl-loop-for-handler is a documented interface, ;; N.B. While the cl-loop-for-handler is a documented interface,
;; there's no documented way for cl-loop-for-handler callbacks to do ;; there's no documented way for cl-loop-for-handler callbacks to do
;; anything useful! Additionally, cl-loop currently lexbinds useful ;; anything useful! Additionally, cl-loop currently lexbinds useful

View file

@ -88,7 +88,7 @@ All values of the list must be uppercase strings.")
(:nick \"nick\" :type SEND :peer server-proc :parent parent-proc :file (:nick \"nick\" :type SEND :peer server-proc :parent parent-proc :file
file :sent <marker> :confirmed <marker>)) file :sent <marker> :confirmed <marker>))
:nick - a user or userhost for the peer. combine with :parent to reach them :nick - a user or userhost for the peer. Combine with :parent to reach them
:type - the type of DCC connection - SEND for outgoing files, GET for :type - the type of DCC connection - SEND for outgoing files, GET for
incoming, and CHAT for both directions. To tell which end started incoming, and CHAT for both directions. To tell which end started
@ -102,7 +102,7 @@ All values of the list must be uppercase strings.")
connection is in general independent from a particular server connection is in general independent from a particular server
connection after it was established. connection after it was established.
:file - for outgoing sends, the full path to the file. for incoming sends, :file - for outgoing sends, the full path to the file. For incoming sends,
the suggested filename or vetted filename the suggested filename or vetted filename
:size - size of the file, may be nil on incoming DCCs") :size - size of the file, may be nil on incoming DCCs")
@ -338,8 +338,8 @@ string \".*!.*@.*\" to this list."
:type '(repeat regexp)) :type '(repeat regexp))
(defun erc-dcc-server (name filter sentinel) (defun erc-dcc-server (name filter sentinel)
"Start listening on a port for an incoming DCC connection. Returns the newly "Start listening on a port for an incoming DCC connection.
created subprocess, or nil." Returns the newly created subprocess, or nil."
(let ((port (or (and erc-dcc-port-range (car erc-dcc-port-range)) t)) (let ((port (or (and erc-dcc-port-range (car erc-dcc-port-range)) t))
(upper (and erc-dcc-port-range (cdr erc-dcc-port-range))) (upper (and erc-dcc-port-range (cdr erc-dcc-port-range)))
process) process)
@ -1156,7 +1156,7 @@ other client."
buffer)) buffer))
(defun erc-dcc-chat-accept (entry parent-proc) (defun erc-dcc-chat-accept (entry parent-proc)
"Accept an incoming DCC connection and open a DCC window" "Accept an incoming DCC connection and open a DCC window."
(let* ((nick (erc-extract-nick (plist-get entry :nick))) (let* ((nick (erc-extract-nick (plist-get entry :nick)))
buffer proc) buffer proc)
(setq proc (setq proc

View file

@ -461,7 +461,7 @@ resultant list of strings."
(defun eshell-pred-file-type (type) (defun eshell-pred-file-type (type)
"Return a test which tests that the file is of a certain TYPE. "Return a test which tests that the file is of a certain TYPE.
TYPE must be a character, and should be one of the possible options TYPE must be a character, and should be one of the possible options
that `ls -l' will show in the first column of its display. " that `ls -l' will show in the first column of its display."
(when (eq type ?%) (when (eq type ?%)
(setq type (char-after)) (setq type (char-after))
(if (memq type '(?b ?c)) (if (memq type '(?b ?c))

View file

@ -1850,7 +1850,7 @@ If FRAME is nil, that stands for the selected frame."
(defun defined-colors-with-face-attributes (&optional frame) (defun defined-colors-with-face-attributes (&optional frame)
"Return a list of colors supported for a particular frame. "Return a list of colors supported for a particular frame.
See `defined-colors' for arguments and return value. In contrast See `defined-colors' for arguments and return value. In contrast
to `define-colors' the elements of the returned list are color to `define-colorss' the elements of the returned list are color
strings with text properties, that make the color names render strings with text properties, that make the color names render
with the color they represent as background color." with the color they represent as background color."
(mapcar (mapcar

View file

@ -126,7 +126,7 @@ buffer local value for `font-lock-defaults', via its mode hook.
The above is the default behavior of `font-lock-mode'; you may The above is the default behavior of `font-lock-mode'; you may
specify your own function which is called when `font-lock-mode' specify your own function which is called when `font-lock-mode'
is toggled via `font-lock-function'. " is toggled via `font-lock-function'."
nil nil nil nil nil nil
:after-hook (font-lock-initial-fontify) :after-hook (font-lock-initial-fontify)
;; Don't turn on Font Lock mode if we don't have a display (we're running a ;; Don't turn on Font Lock mode if we don't have a display (we're running a

View file

@ -1817,7 +1817,7 @@ below (above if ABOVE is true) that of FRAME2. Hence the
position of FRAME2 in its display's Z (stacking) order relative position of FRAME2 in its display's Z (stacking) order relative
to all other frames excluding FRAME1 remains unaltered. to all other frames excluding FRAME1 remains unaltered.
Some window managers may refuse to restack windows. " Some window managers may refuse to restack windows."
(if (and (frame-live-p frame1) (if (and (frame-live-p frame1)
(frame-live-p frame2) (frame-live-p frame2)
(equal (frame-parameter frame1 'display) (equal (frame-parameter frame1 'display)

View file

@ -613,7 +613,7 @@ and change the current conversion to the last one in the group."
(message "%s" msg)))) (message "%s" msg))))
;; Update the conversion area with the latest conversion selected. ;; Update the conversion area with the latest conversion selected.
;; ALL if non nil means to update the whole area, else update only ;; ALL if non-nil means to update the whole area, else update only
;; inside quail-overlay-head. ;; inside quail-overlay-head.
(defun kkc-update-conversion (&optional all) (defun kkc-update-conversion (&optional all)

View file

@ -115,7 +115,7 @@ Alternative suggestions are:
'browse-url-secondary-browser-function "27.1") 'browse-url-secondary-browser-function "27.1")
(defcustom shr-image-animate t (defcustom shr-image-animate t
"Non nil means that images that can be animated will be." "Non-nil means that images that can be animated will be."
:version "24.4" :version "24.4"
:type 'boolean) :type 'boolean)

View file

@ -8908,7 +8908,7 @@ The new content of the line will be NEWHEAD (as modified by
If FIXFACE is non-nil, the face of each item is modified according to If FIXFACE is non-nil, the face of each item is modified according to
the new TODO state. the new TODO state.
If JUST-THIS is non-nil, change just the current line, not all. If JUST-THIS is non-nil, change just the current line, not all.
If FORCE-TAGS is non nil, the car of it returns the new tags." If FORCE-TAGS is non-nil, the car of it returns the new tags."
(let* ((inhibit-read-only t) (let* ((inhibit-read-only t)
(line (org-current-line)) (line (org-current-line))
(org-agenda-buffer (current-buffer)) (org-agenda-buffer (current-buffer))
@ -10205,7 +10205,7 @@ to override `appt-message-warning-time'."
(message "Added %d event%s for today" cnt (if (> cnt 1) "s" ""))))) (message "Added %d event%s for today" cnt (if (> cnt 1) "s" "")))))
(defun org-agenda-today-p (date) (defun org-agenda-today-p (date)
"Non nil when DATE means today. "Non-nil when DATE means today.
DATE is either a list of the form (month day year) or a number of DATE is either a list of the form (month day year) or a number of
days as returned by `calendar-absolute-from-gregorian' or days as returned by `calendar-absolute-from-gregorian' or
`org-today'. This function considers `org-extend-today-until' `org-today'. This function considers `org-extend-today-until'

View file

@ -241,7 +241,7 @@ Create an ID if necessary."
"Get the ID property of the entry at point-or-marker POM. "Get the ID property of the entry at point-or-marker POM.
If POM is nil, refer to the entry at point. If POM is nil, refer to the entry at point.
If the entry does not have an ID, the function returns nil. If the entry does not have an ID, the function returns nil.
However, when CREATE is non nil, create an ID if none is present already. However, when CREATE is non-nil, create an ID if none is present already.
PREFIX will be passed through to `org-id-new'. PREFIX will be passed through to `org-id-new'.
In any case, the ID of the entry is returned." In any case, the ID of the entry is returned."
(org-with-point-at pom (org-with-point-at pom

View file

@ -4280,7 +4280,7 @@ org-level-* faces."
(defcustom org-highlight-latex-and-related nil (defcustom org-highlight-latex-and-related nil
"Non-nil means highlight LaTeX related syntax in the buffer. "Non-nil means highlight LaTeX related syntax in the buffer.
When non nil, the value should be a list containing any of the When non-nil, the value should be a list containing any of the
following symbols: following symbols:
`latex' Highlight LaTeX snippets and environments. `latex' Highlight LaTeX snippets and environments.
`script' Highlight subscript and superscript. `script' Highlight subscript and superscript.
@ -15434,7 +15434,7 @@ but in some other way.")
Being in this list makes sure that they are offered for completion.") Being in this list makes sure that they are offered for completion.")
(defun org--valid-property-p (property) (defun org--valid-property-p (property)
"Non nil when string PROPERTY is a valid property name." "Non-nil when string PROPERTY is a valid property name."
(not (not
(or (equal property "") (or (equal property "")
(string-match-p "\\s-" property)))) (string-match-p "\\s-" property))))

View file

@ -326,7 +326,7 @@ INFO is a plist used as a communication channel.
The value is either the label specified in \"BEAMER_opt\" The value is either the label specified in \"BEAMER_opt\"
property, the custom ID, if there is one and property, the custom ID, if there is one and
`:latex-prefer-user-labels' property has a non nil value, or `:latex-prefer-user-labels' property has a non-nil value, or
a unique internal label. This function assumes HEADLINE will be a unique internal label. This function assumes HEADLINE will be
treated as a frame." treated as a frame."
(cond (cond

View file

@ -1236,7 +1236,7 @@ calling `org-latex-compile'."
;;; Internal Functions ;;; Internal Functions
(defun org-latex--caption-above-p (element info) (defun org-latex--caption-above-p (element info)
"Non nil when caption is expected to be located above ELEMENT. "Non-nil when caption is expected to be located above ELEMENT.
INFO is a plist holding contextual information." INFO is a plist holding contextual information."
(let ((above (plist-get info :latex-caption-above))) (let ((above (plist-get info :latex-caption-above)))
(if (symbolp above) above (if (symbolp above) above

View file

@ -2174,7 +2174,7 @@ SHORT-CAPTION are strings."
;;;; Links :: Inline Images ;;;; Links :: Inline Images
(defun org-odt--copy-image-file (path) (defun org-odt--copy-image-file (path)
"Returns the internal name of the file" "Return the internal name of the file"
(let* ((image-type (file-name-extension path)) (let* ((image-type (file-name-extension path))
(media-type (format "image/%s" image-type)) (media-type (format "image/%s" image-type))
(target-dir "Images/") (target-dir "Images/")
@ -2379,7 +2379,7 @@ used as a communication channel."
(concat equation "<text:tab/>" label)))))) (concat equation "<text:tab/>" label))))))
(defun org-odt--copy-formula-file (src-file) (defun org-odt--copy-formula-file (src-file)
"Returns the internal name of the file" "Return the internal name of the file"
(let* ((target-dir (format "Formula-%04d/" (let* ((target-dir (format "Formula-%04d/"
(cl-incf org-odt-embedded-formulas-count))) (cl-incf org-odt-embedded-formulas-count)))
(target-file (concat target-dir "content.xml"))) (target-file (concat target-dir "content.xml")))

View file

@ -804,7 +804,7 @@ also be set with the OPTIONS keyword, e.g. \"timestamp:nil\"."
:safe #'booleanp) :safe #'booleanp)
(defcustom org-export-with-timestamps t (defcustom org-export-with-timestamps t
"Non nil means allow timestamps in export. "Non-nil means allow timestamps in export.
It can be set to any of the following values: It can be set to any of the following values:
t export all timestamps. t export all timestamps.

View file

@ -1966,7 +1966,7 @@ Note that this is a strict tail, so won't match, e.g. \"0x....\".")
;; these caches from inside them, and we must thus be sure that this ;; these caches from inside them, and we must thus be sure that this
;; has already been executed. ;; has already been executed.
;; ;;
;; This calls the language variable c-before-font-lock-functions, if non nil. ;; This calls the language variable c-before-font-lock-functions, if non-nil.
;; This typically sets `syntax-table' properties. ;; This typically sets `syntax-table' properties.
;; We can sometimes get two consecutive calls to `after-change-functions' ;; We can sometimes get two consecutive calls to `after-change-functions'

View file

@ -1313,7 +1313,7 @@ buffer-local values of tags table format variables."
;; Find the end of the tag and record the whole tag text. ;; Find the end of the tag and record the whole tag text.
(search-forward "\177") (search-forward "\177")
(setq tag-text (buffer-substring (1- (point)) (point-at-bol))) (setq tag-text (buffer-substring (1- (point)) (point-at-bol)))
;; If use-explicit is non nil and explicit tag is present, use it as part of ;; If use-explicit is non-nil and explicit tag is present, use it as part of
;; return value. Else just skip it. ;; return value. Else just skip it.
(setq explicit-start (point)) (setq explicit-start (point))
(when (and (search-forward "\001" (point-at-bol 2) t) (when (and (search-forward "\001" (point-at-bol 2) t)

View file

@ -626,7 +626,7 @@ If nil, indent as:
input [31:0] a; input [31:0] a;
input \\=`CP; input \\=`CP;
output c; output c;
If non nil, treat as: If non-nil, treat as:
input [31:0] a; input [31:0] a;
input \\=`CP ; input \\=`CP ;
output c;" output c;"

View file

@ -1435,7 +1435,7 @@ ses--default-printer, ses--numrows, or ses--numcols."
"Extend the global parameters list when file format is updated "Extend the global parameters list when file format is updated
from 2 to 3. This happens when local printer function are added from 2 to 3. This happens when local printer function are added
to a sheet that was created with SES version 2. This is not to a sheet that was created with SES version 2. This is not
undoable. Return nil when there was no change, and non nil otherwise." undoable. Return nil when there was no change, and non-nil otherwise."
(save-excursion (save-excursion
(cond (cond
((and (= ses--file-format 2) (= 3 new-file-format)) ((and (= ses--file-format 2) (= 3 new-file-format))

View file

@ -4209,7 +4209,7 @@ the process. Any more args are arguments to PROGRAM."
(defun ansi-term (program &optional new-buffer-name) (defun ansi-term (program &optional new-buffer-name)
"Start a terminal-emulator in a new buffer. "Start a terminal-emulator in a new buffer.
This is almost the same as `term' apart from always creating a new buffer, This is almost the same as `term' apart from always creating a new buffer,
and `C-x' being marked as a `term-escape-char'. " and `C-x' being marked as a `term-escape-char'."
(interactive (list (read-from-minibuffer "Run program: " (interactive (list (read-from-minibuffer "Run program: "
(or explicit-shell-file-name (or explicit-shell-file-name
(getenv "ESHELL") (getenv "ESHELL")

View file

@ -862,7 +862,7 @@ To interactively change the dialect use the command `bibtex-set-dialect'."
(defcustom bibtex-no-opt-remove-re "\\`option" (defcustom bibtex-no-opt-remove-re "\\`option"
"If a field name matches this regexp, the prefix OPT is not removed. "If a field name matches this regexp, the prefix OPT is not removed.
If nil prefix OPT is always removed" If nil prefix OPT is always removed."
:group 'bibtex :group 'bibtex
:version "24.1" :version "24.1"
:type '(choice (regexp) (const nil))) :type '(choice (regexp) (const nil)))
@ -2188,7 +2188,7 @@ If FLAG is nil, a message is echoed if point was incremented at least
(defun bibtex-beginning-of-first-entry () (defun bibtex-beginning-of-first-entry ()
"Go to beginning of line of first BibTeX entry in buffer. "Go to beginning of line of first BibTeX entry in buffer.
If `bibtex-sort-ignore-string-entries' is non-nil, @String entries If `bibtex-sort-ignore-string-entries' is non-nil, @String entries
are ignored. Return point" are ignored. Return point."
(goto-char (point-min)) (goto-char (point-min))
(bibtex-skip-to-valid-entry) (bibtex-skip-to-valid-entry)
(point)) (point))
@ -2714,7 +2714,7 @@ and `bibtex-autokey-names-stretch'."
(defun bibtex-autokey-get-title () (defun bibtex-autokey-get-title ()
"Get title field contents up to a terminator. "Get title field contents up to a terminator.
Return the result as a string" Return the result as a string."
(let ((case-fold-search t) (let ((case-fold-search t)
(titlestring (titlestring
(bibtex-autokey-get-field "title" (bibtex-autokey-get-field "title"
@ -2866,7 +2866,7 @@ Concatenate the key:
(defun bibtex-read-key (prompt &optional key global) (defun bibtex-read-key (prompt &optional key global)
"Read BibTeX key from minibuffer using PROMPT and default KEY. "Read BibTeX key from minibuffer using PROMPT and default KEY.
If optional arg GLOBAL is non-nil, completion is based on the keys in If optional arg GLOBAL is non-nil, completion is based on the keys in
`bibtex-reference-keys' of `bibtex-files'," `bibtex-reference-keys' of `bibtex-files'."
(let (completion-ignore-case) (let (completion-ignore-case)
(completing-read prompt (if global (bibtex-global-key-alist) (completing-read prompt (if global (bibtex-global-key-alist)
bibtex-reference-keys) bibtex-reference-keys)
@ -3054,7 +3054,7 @@ already set. If SELECT is non-nil interactively select a BibTeX buffer.
When called interactively, FORCE is t, CURRENT is t if current buffer When called interactively, FORCE is t, CURRENT is t if current buffer
visits a file using `bibtex-mode', and SELECT is t if current buffer visits a file using `bibtex-mode', and SELECT is t if current buffer
does not use `bibtex-mode'," does not use `bibtex-mode'."
(interactive (list (eq major-mode 'bibtex-mode) t (interactive (list (eq major-mode 'bibtex-mode) t
(not (eq major-mode 'bibtex-mode)))) (not (eq major-mode 'bibtex-mode))))
(let ((file-path (split-string (or bibtex-file-path default-directory) ":+")) (let ((file-path (split-string (or bibtex-file-path default-directory) ":+"))

View file

@ -1116,7 +1116,7 @@ Mostly we check word delimiters."
If the optional argument FOLLOWING, or, when called interactively If the optional argument FOLLOWING, or, when called interactively
`ispell-following-word', is non-nil, checks the following (rather `ispell-following-word', is non-nil, checks the following (rather
than preceding) word when the cursor is not over a word. If than preceding) word when the cursor is not over a word. If
optional argument KNOWN-MISSPELLING is non nil considers word a optional argument KNOWN-MISSPELLING is non-nil considers word a
misspelling and skips redundant spell-checking step. misspelling and skips redundant spell-checking step.
See `flyspell-get-word' for details of how this finds the word to See `flyspell-get-word' for details of how this finds the word to

View file

@ -581,7 +581,7 @@ the associations of any windows with the current buffer.
EXIT-ACTION, if non-nil, must specify a function that is called EXIT-ACTION, if non-nil, must specify a function that is called
with the current buffer as argument and is called after disabling with the current buffer as argument and is called after disabling
`view-mode' and removing any associations of windows with the `view-mode' and removing any associations of windows with the
current buffer. " current buffer."
(when view-mode (when view-mode
(let ((buffer (window-buffer))) (let ((buffer (window-buffer)))
(unless view-no-disable-on-exit (unless view-no-disable-on-exit

View file

@ -77,7 +77,7 @@ along with GNU Emacs. If not, see <https://www.gnu.org/licenses/>. */
composition, the elements are characters or encoded composition, the elements are characters or encoded
composition rules. composition rules.
MODIFICATION-FUNC -- If non nil, it is a function to call when the MODIFICATION-FUNC -- If non-nil, it is a function to call when the
composition gets invalid after a modification in a buffer. If composition gets invalid after a modification in a buffer. If
it is nil, a function in `composition-function-table' of the it is nil, a function in `composition-function-table' of the
first character in the sequence is called. first character in the sequence is called.

View file

@ -141,7 +141,7 @@ DEFUN ("tan", Ftan, Stan, 1, 1, 0,
} }
DEFUN ("isnan", Fisnan, Sisnan, 1, 1, 0, DEFUN ("isnan", Fisnan, Sisnan, 1, 1, 0,
doc: /* Return non nil if argument X is a NaN. */) doc: /* Return non-nil if argument X is a NaN. */)
(Lisp_Object x) (Lisp_Object x)
{ {
CHECK_FLOAT (x); CHECK_FLOAT (x);