mirrors/emacs
1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2025-12-15 10:30:25 -08:00
Code Issues Projects Releases Wiki Activity

Document decoded-time-string issue on 6-elt args

Browse source 
* lisp/simple.el: Document problematic use of decoded-time-dst on
6-element args.
This commit is contained in:
Paul Eggert 2022-05-29 14:57:48 -07:00
parent b40009e2f9
commit 7f7acf3956
1 changed files with 8 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

8
lisp/simple.el
View file

@ -10519,6 +10519,14 @@ This is an integer indicating the UTC offset in seconds, i.e.,
the number of seconds east of Greenwich.")
)
;; Document that decoded-time-dst is problematic on 6-element lists.
;; It should return -1 indicating unknown DST, but currently returns
;; nil indicating standard time.
(put 'decoded-time-dst 'function-documentation
(append (get 'decoded-time-dst 'function-documentation)
"As a special case, `decoded-time-dst' returns an unspecified
value when given a list too short to have a dst element."))
(defun get-scratch-buffer-create ()
"Return the *scratch* buffer, creating a new one if needed."
(or (get-buffer "*scratch*")