summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorIhor Radchenko <yantar92@posteo.net>2023-12-06 14:19:57 +0100
committerIhor Radchenko <yantar92@posteo.net>2023-12-06 14:21:01 +0100
commit7926045ff5e56abf34b5d442a817a847db7b9933 (patch)
tree0f30166d8ec2c70dfc4420d4e06ea9ee7c3f0ae8
parente3dec7fe6af3eb08d8600d583d63083b99c09f62 (diff)
downloadorg-mode-7926045ff.tar.gz
Obsolete `org-src-associate-babel-session' and related functionality
* etc/ORG-NEWS (~org-src-associate-babel-session~ and ~org-babel-<lang>-associate-session~ are now obsolete): Announce the change. * lisp/org-compat.el (org-src-associate-babel-session): (org-src-babel-configure-edit-buffer): Mark obsolete. * lisp/org-src.el: Add comment to remove "Babel related functions" block in the next release. Link: https://orgmode.org/list/CAOQTW-OMeyWYcLq8hDJ4MB10_4dOkvoNjKnFedLYP2z+-M6BAg@mail.gmail.com
-rw-r--r--etc/ORG-NEWS6
-rw-r--r--lisp/org-compat.el10
-rw-r--r--lisp/org-src.el3
3 files changed, 19 insertions, 0 deletions
diff --git a/etc/ORG-NEWS b/etc/ORG-NEWS
index 353b777..59c45b2 100644
--- a/etc/ORG-NEWS
+++ b/etc/ORG-NEWS
@@ -13,6 +13,12 @@ Please send Org bug reports to mailto:emacs-orgmode@gnu.org.
* Version 9.7 (not released yet)
** Important announcements and breaking changes
+*** ~org-src-associate-babel-session~ and ~org-babel-<lang>-associate-session~ are now obsolete
+
+This functionality is not documented, rarely used and can be achieved
+via ~org-babel-edit-prep-<lang>~ function. The latter is the
+new recommended way to setup session in Org src buffers.
+
*** ~org-print-speed-command~ is now an internal function
The old name is marked obsolete and the new name is
diff --git a/lisp/org-compat.el b/lisp/org-compat.el
index dbba50d..8b1f163 100644
--- a/lisp/org-compat.el
+++ b/lisp/org-compat.el
@@ -444,6 +444,16 @@ Counting starts at 1."
(define-obsolete-function-alias 'org-string-match-p 'string-match-p "9.0")
;;;; Functions and variables from previous releases now obsolete.
+
+(make-obsolete
+ 'org-src-associate-babel-session
+ "To be removed in the next release. Use `org-babel-edit-prep:<lang>' instead."
+ "9.7")
+(make-obsolete
+ 'org-src-babel-configure-edit-buffer
+ "To be removed in the next release. Use a custom `org-src-mode-hook' instead."
+ "9.7")
+
(define-obsolete-variable-alias 'org-export-ignored-local-variables
'org-element-ignored-local-variables "Org 9.7")
(define-obsolete-function-alias 'org-habit-get-priority
diff --git a/lisp/org-src.el b/lisp/org-src.el
index 866ff2d..344324a 100644
--- a/lisp/org-src.el
+++ b/lisp/org-src.el
@@ -918,6 +918,9 @@ See also `org-src-mode-hook'."
;;; Babel related functions
+;; FIXME: This block is to be removed in the following release.
+;; `org-babel-edit-pre:<lang>' can be used in place.
+
(defun org-src-associate-babel-session (info)
"Associate edit buffer with comint session.
INFO should be a list similar in format to the return value of