mirror of
git://git.sv.gnu.org/emacs.git
synced 2025-12-06 06:20:55 -08:00
ecf08f0621
dc4e6b1329; Update copyright years in more files64b3777631; Run set-copyright from admin.el8e1c56ae46; Add 2024 to copyright years # Conflicts: # doc/misc/modus-themes.org # doc/misc/texinfo.tex # etc/NEWS # etc/refcards/ru-refcard.tex # etc/themes/modus-operandi-theme.el # etc/themes/modus-themes.el # etc/themes/modus-vivendi-theme.el # lib/alloca.in.h # lib/binary-io.h # lib/c-ctype.h # lib/c-strcasecmp.c # lib/c-strncasecmp.c # lib/careadlinkat.c # lib/cloexec.c # lib/close-stream.c # lib/diffseq.h # lib/dup2.c # lib/filemode.h # lib/fpending.c # lib/fpending.h # lib/fsusage.c # lib/getgroups.c # lib/getloadavg.c # lib/gettext.h # lib/gettime.c # lib/gettimeofday.c # lib/group-member.c # lib/malloc.c # lib/md5-stream.c # lib/md5.c # lib/md5.h # lib/memmem.c # lib/memrchr.c # lib/nanosleep.c # lib/save-cwd.h # lib/sha1.c # lib/sig2str.c # lib/stdlib.in.h # lib/strtoimax.c # lib/strtol.c # lib/strtoll.c # lib/time_r.c # lib/xalloc-oversized.h # lisp/auth-source-pass.el # lisp/emacs-lisp/lisp-mnt.el # lisp/emacs-lisp/timer.el # lisp/info-look.el # lisp/jit-lock.el # lisp/loadhist.el # lisp/mail/rmail.el # lisp/net/ntlm.el # lisp/net/webjump.el # lisp/progmodes/asm-mode.el # lisp/progmodes/project.el # lisp/progmodes/sh-script.el # lisp/textmodes/flyspell.el # lisp/textmodes/reftex-toc.el # lisp/textmodes/reftex.el # lisp/textmodes/tex-mode.el # lisp/url/url-gw.el # m4/alloca.m4 # m4/clock_time.m4 # m4/d-type.m4 # m4/dirent_h.m4 # m4/dup2.m4 # m4/euidaccess.m4 # m4/fchmodat.m4 # m4/filemode.m4 # m4/fsusage.m4 # m4/getgroups.m4 # m4/getloadavg.m4 # m4/getrandom.m4 # m4/gettime.m4 # m4/gettimeofday.m4 # m4/gnulib-common.m4 # m4/group-member.m4 # m4/inttypes.m4 # m4/malloc.m4 # m4/manywarnings.m4 # m4/mempcpy.m4 # m4/memrchr.m4 # m4/mkostemp.m4 # m4/mktime.m4 # m4/nproc.m4 # m4/nstrftime.m4 # m4/pathmax.m4 # m4/pipe2.m4 # m4/pselect.m4 # m4/pthread_sigmask.m4 # m4/readlink.m4 # m4/realloc.m4 # m4/sig2str.m4 # m4/ssize_t.m4 # m4/stat-time.m4 # m4/stddef_h.m4 # m4/stdint.m4 # m4/stdio_h.m4 # m4/stdlib_h.m4 # m4/stpcpy.m4 # m4/strnlen.m4 # m4/strtoimax.m4 # m4/strtoll.m4 # m4/time_h.m4 # m4/timegm.m4 # m4/timer_time.m4 # m4/timespec.m4 # m4/unistd_h.m4 # m4/warnings.m4 # nt/configure.bat # nt/preprep.c # test/lisp/register-tests.el
197 lines
7.1 KiB
EmacsLisp
197 lines
7.1 KiB
EmacsLisp
;;; help-fns-tests.el --- tests for help-fns.el -*- lexical-binding: t -*-
|
||
|
||
;; Copyright (C) 2014-2024 Free Software Foundation, Inc.
|
||
|
||
;; Maintainer: emacs-devel@gnu.org
|
||
|
||
;; This file is part of GNU Emacs.
|
||
|
||
;; GNU Emacs is free software: you can redistribute it and/or modify
|
||
;; it under the terms of the GNU General Public License as published by
|
||
;; the Free Software Foundation, either version 3 of the License, or
|
||
;; (at your option) any later version.
|
||
|
||
;; GNU Emacs is distributed in the hope that it will be useful,
|
||
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||
;; GNU General Public License for more details.
|
||
|
||
;; You should have received a copy of the GNU General Public License
|
||
;; along with GNU Emacs. If not, see <https://www.gnu.org/licenses/>.
|
||
|
||
;;; Commentary:
|
||
|
||
;;; Code:
|
||
|
||
(require 'ert)
|
||
(require 'help-fns)
|
||
(require 'subr-x)
|
||
|
||
(autoload 'help-fns-test--macro "foo" nil nil t)
|
||
|
||
|
||
;;; Several tests for describe-function
|
||
|
||
(defun help-fns-tests--describe-function (func)
|
||
"Helper function for `describe-function' tests.
|
||
FUNC is the function to describe, a symbol.
|
||
Return first line of the output of (describe-function-1 FUNC)."
|
||
(let ((string (with-output-to-string
|
||
(describe-function-1 func))))
|
||
(string-match "\\(.+\\)\n" string)
|
||
(match-string-no-properties 1 string)))
|
||
|
||
(ert-deftest help-fns-test-bug17410 ()
|
||
"Test for https://debbugs.gnu.org/17410 ."
|
||
(let ((regexp "autoloaded Lisp macro")
|
||
(result (help-fns-tests--describe-function 'help-fns-test--macro)))
|
||
(should (string-match regexp result))))
|
||
|
||
(ert-deftest help-fns-test-built-in ()
|
||
(let ((regexp "a built-in function in .C source code")
|
||
(result (help-fns-tests--describe-function 'mapcar)))
|
||
(should (string-match regexp result))))
|
||
|
||
(ert-deftest help-fns-test-interactive-built-in ()
|
||
(let ((regexp "an interactive built-in function in .C source code")
|
||
(result (help-fns-tests--describe-function 're-search-forward)))
|
||
(should (string-match regexp result))))
|
||
|
||
(ert-deftest help-fns-test-lisp-macro ()
|
||
(let ((regexp "a Lisp macro in .+subr\\.el")
|
||
(result (help-fns-tests--describe-function 'when)))
|
||
(should (string-match regexp result))))
|
||
|
||
(ert-deftest help-fns-test-lisp-defun ()
|
||
(let ((regexp (if (featurep 'native-compile)
|
||
"a native-compiled Lisp function in .+subr\\.el"
|
||
"a byte-compiled Lisp function in .+subr\\.el"))
|
||
(result (help-fns-tests--describe-function 'last)))
|
||
(should (string-match regexp result))))
|
||
|
||
(ert-deftest help-fns-test-lisp-defsubst ()
|
||
(let ((regexp "a byte-compiled Lisp function in .+subr\\.el")
|
||
(result (help-fns-tests--describe-function 'posn-window)))
|
||
(should (string-match regexp result))))
|
||
|
||
(ert-deftest help-fns-test-alias-to-defun ()
|
||
(let ((regexp "an alias for .set-file-modes. in .+subr\\.el")
|
||
(result (help-fns-tests--describe-function 'chmod)))
|
||
(should (string-match regexp result))))
|
||
|
||
(ert-deftest help-fns-test-bug23887 ()
|
||
"Test for https://debbugs.gnu.org/23887 ."
|
||
(let ((regexp "an alias for .re-search-forward. in .+subr\\.el")
|
||
(result (help-fns-tests--describe-function 'search-forward-regexp)))
|
||
(should (string-match regexp result))))
|
||
|
||
(ert-deftest help-fns-test-dangling-alias ()
|
||
"Make sure we don't burp on bogus aliases."
|
||
(let ((f (make-symbol "bogus-alias")))
|
||
(define-obsolete-function-alias f 'help-fns-test--undefined-function "past")
|
||
(describe-symbol f)))
|
||
|
||
;;; Test describe-function over functions with funny names
|
||
(defun abc\\\[universal-argument\]b\`c\'d\\e\"f (x)
|
||
"A function with a funny name.
|
||
|
||
\(fn XYZZY)"
|
||
x)
|
||
|
||
(defun defgh\\\[universal-argument\]b\`c\'d\\e\"f (x)
|
||
"Another function with a funny name."
|
||
x)
|
||
|
||
(ert-deftest help-fns-test-funny-names ()
|
||
"Test for help with functions with funny names."
|
||
(describe-function 'abc\\\[universal-argument\]b\`c\'d\\e\"f)
|
||
(with-current-buffer "*Help*"
|
||
(goto-char (point-min))
|
||
(should (search-forward
|
||
"(abc\\\\\\[universal-argument\\]b\\`c\\'d\\\\e\\\"f XYZZY)")))
|
||
(describe-function 'defgh\\\[universal-argument\]b\`c\'d\\e\"f)
|
||
(with-current-buffer "*Help*"
|
||
(goto-char (point-min))
|
||
(should (search-forward
|
||
"(defgh\\\\\\[universal-argument\\]b\\`c\\'d\\\\e\\\"f X)"))))
|
||
|
||
|
||
;;; Test for describe-symbol
|
||
(ert-deftest help-fns-test-describe-symbol ()
|
||
"Test the `describe-symbol' function."
|
||
;; 'describe-symbol' would originally signal an error for
|
||
;; 'font-lock-comment-face'.
|
||
(describe-symbol 'font-lock-comment-face)
|
||
(with-current-buffer "*Help*"
|
||
(should (> (point-max) 1))
|
||
(goto-char (point-min))
|
||
(should (looking-at "^font-lock-comment-face is "))))
|
||
|
||
(defvar foo-test-map)
|
||
(defvar help-fns-test--describe-keymap-foo)
|
||
|
||
|
||
;;; Tests for describe-keymap
|
||
|
||
(defvar-keymap help-fns-test-map
|
||
"a" 'test-cmd-a
|
||
"b" 'test-cmd-b
|
||
"c" 'test-cmd-c)
|
||
|
||
(ert-deftest help-fns-test-find-keymap-name ()
|
||
(should (equal (help-fns-find-keymap-name lisp-mode-map) 'lisp-mode-map))
|
||
;; Follow aliasing.
|
||
(unwind-protect
|
||
(progn
|
||
(defvaralias 'foo-test-map 'lisp-mode-map)
|
||
(should (equal (help-fns-find-keymap-name foo-test-map) 'lisp-mode-map)))
|
||
(makunbound 'foo-test-map)))
|
||
|
||
(ert-deftest help-fns-test-describe-keymap/symbol ()
|
||
(describe-keymap 'help-fns-test-map)
|
||
(with-current-buffer "*Help*"
|
||
(should (looking-at "^help-fns-test-map is"))
|
||
(should (re-search-forward (rx word-start "a" word-end
|
||
(+ blank)
|
||
word-start "test-cmd-a" word-end)
|
||
nil t))))
|
||
|
||
(ert-deftest help-fns-test-describe-keymap/value ()
|
||
(describe-keymap help-fns-test-map)
|
||
(with-current-buffer "*Help*"
|
||
(should (looking-at "\nKey"))))
|
||
|
||
(ert-deftest help-fns-test-describe-keymap/not-keymap ()
|
||
(should-error (describe-keymap nil))
|
||
(should-error (describe-keymap emacs-version))
|
||
(should-error (describe-keymap 'some-undefined-variable-foobar)))
|
||
|
||
(ert-deftest help-fns-test-describe-keymap/let-bound ()
|
||
(let ((foobar help-fns-test-map))
|
||
(describe-keymap foobar)
|
||
(with-current-buffer "*Help*"
|
||
(should (looking-at "\nKey")))))
|
||
|
||
(ert-deftest help-fns-test-describe-keymap/dynamically-bound-no-file ()
|
||
(setq help-fns-test--describe-keymap-foo help-fns-test-map)
|
||
(describe-keymap 'help-fns-test--describe-keymap-foo)
|
||
(with-current-buffer "*Help*"
|
||
(should (looking-at "^help-fns-test--describe-keymap-foo is"))))
|
||
|
||
;;; Tests for find-lisp-object-file-name
|
||
(ert-deftest help-fns-test-bug24697-function-search ()
|
||
(should-not (find-lisp-object-file-name 'tab-width 1)))
|
||
|
||
(ert-deftest help-fns-test-bug24697-non-internal-variable ()
|
||
(let ((help-fns--test-var (make-symbol "help-fns--test-var")))
|
||
;; simulate an internal variable
|
||
(put help-fns--test-var 'variable-documentation 1)
|
||
(should-not (find-lisp-object-file-name help-fns--test-var 'defface))
|
||
(should-not (find-lisp-object-file-name help-fns--test-var 1))))
|
||
|
||
(ert-deftest help-fns--analyze-function-recursive ()
|
||
(defalias 'help-fns--a 'help-fns--b)
|
||
(should (equal (help-fns--analyze-function 'help-fns--a)
|
||
'(help-fns--a help-fns--b t help-fns--b))))
|
||
|
||
;;; help-fns-tests.el ends here
|