[elpa] externals/org 7926045ff5 1/3: Obsolete `org-src-associate-babel-session' and related functionality

[ELPA Syncer]

branch: externals/org
commit 7926045ff5e56abf34b5d442a817a847db7b9933
Author: Ihor Radchenko <yantar92@posteo.net>
Commit: Ihor Radchenko <yantar92@posteo.net>

    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
---
 etc/ORG-NEWS       |  6 ++++++
 lisp/org-compat.el | 10 ++++++++++
 lisp/org-src.el    |  3 +++
 3 files changed, 19 insertions(+)

diff --git a/etc/ORG-NEWS b/etc/ORG-NEWS
index 353b777efe..59c45b2aa4 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 dbba50d2d9..8b1f16355f 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 866ff2dbff..344324aaf0 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