diff --git a/etc/ORG-NEWS b/etc/ORG-NEWS index bde25abc4..353b777ef 100644 --- a/etc/ORG-NEWS +++ b/etc/ORG-NEWS @@ -13,6 +13,14 @@ Please send Org bug reports to mailto:emacs-orgmode@gnu.org. * Version 9.7 (not released yet) ** Important announcements and breaking changes +*** ~org-print-speed-command~ is now an internal function + +The old name is marked obsolete and the new name is +~org--print-speed-command~. + +This function was always aimed for internal use when building speed +command help buffer. Now, it is stated explicitly. + *** Babel references =FILE:REFERENCE= now search current buffer when =FILE= does not exist When =FILE= does not exist, the reference is searched in the current diff --git a/lisp/org-compat.el b/lisp/org-compat.el index d02e520f6..d4c3d535a 100644 --- a/lisp/org-compat.el +++ b/lisp/org-compat.el @@ -1197,6 +1197,10 @@ context. See the individual commands for more information." (define-obsolete-function-alias 'org-export-get-parent-element 'org-element-parent-element "9.7") +(define-obsolete-function-alias 'org-print-speed-command + 'org--print-speed-command "9.7" + "Internal function. Subject of unannounced changes.") + ;;;; Obsolete link types (eval-after-load 'ol diff --git a/lisp/org-keys.el b/lisp/org-keys.el index 40db6b5b3..974754e8e 100644 --- a/lisp/org-keys.el +++ b/lisp/org-keys.el @@ -789,19 +789,22 @@ command." (function) (sexp)))))) -(defun org-print-speed-command (e) - (if (> (length (car e)) 1) +(defun org--print-speed-command (speed-command) + "Print information about SPEED-COMMAND in help buffer. +SPEED-COMMAND is an element of `org-speed-commands' or +`org-speed-commands-user'." + (if (> (length (car speed-command)) 1) (progn (princ "\n") - (princ (car e)) + (princ (car speed-command)) (princ "\n") - (princ (make-string (length (car e)) ?-)) + (princ (make-string (length (car speed-command)) ?-)) (princ "\n")) - (princ (car e)) + (princ (car speed-command)) (princ " ") - (if (symbolp (cdr e)) - (princ (symbol-name (cdr e))) - (prin1 (cdr e))) + (if (symbolp (cdr speed-command)) + (princ (symbol-name (cdr speed-command))) + (prin1 (cdr speed-command))) (princ "\n"))) (defun org-speed-command-help () @@ -811,7 +814,7 @@ command." (user-error "Speed commands are not activated, customize `org-use-speed-commands'")) (with-output-to-temp-buffer "*Help*" (princ "Speed commands\n==============\n") - (mapc #'org-print-speed-command + (mapc #'org--print-speed-command ;; FIXME: don't check `org-speed-commands-user' past 9.6 (if (boundp 'org-speed-commands-user) (append org-speed-commands