Drop explicit unlock-buffer

This API is unused as of now. Most of the file locking API additions
in Emacs 28 are missing, lock-file, unlock-file, etc. Those have
higher priority.

3 files changed, 1 insertions, 30 deletions

diff --git a/NEWS.org b/NEWS.org
index 1587864..3adda8a 100644
--- a/NEWS.org
+++ b/NEWS.org
@@ -6,6 +6,7 @@
 - Add links from compatibility definitions to tests.
 - BREAKING: Drop JSON parsing support (libjansson API).
 - BREAKING: Drop ~null-device~.
+- BREAKING: Drop ~unlock-buffer~.
 - compat-26: Add ~buffer-hash~.
 - compat-27: Add ~fixnump~ and ~bignump~.
 - compat-27: Add ~with-minibuffer-selected-window~.
diff --git a/compat-28.el b/compat-28.el
index 64cfcd7..dec2d8c 100644
--- a/compat-28.el
+++ b/compat-28.el
@@ -109,21 +109,6 @@ inserted before contatenating."
 
 (compat-defalias garbage-collect-maybe ignore) ;; <compat-tests:garbage-collect-maybe>
 
-;;;; Defined in filelock.c
-
-(compat-defun unlock-buffer () ;; <UNTESTED>
-  "Handle `file-error' conditions.
-Handles file system errors by calling ‘display-warning’ and
-continuing as if the error did not occur."
-  :explicit t
-  (condition-case error
-      (unlock-buffer)
-    (file-error
-     (display-warning
-      '(unlock-file)
-      (message "%s, ignored" (error-message-string error))
-      :warning))))
-
 ;;;; Defined in characters.c
 
 (compat-defun string-width (string &optional from to) ;; <compat-tests:string-width>
diff --git a/compat.texi b/compat.texi
index 433bb72..be893ce 100644
--- a/compat.texi
+++ b/compat.texi
@@ -1860,21 +1860,6 @@ assume that there is a user named @samp{rms} but no user named
 These functions must be called explicitly via @code{compat-call},
 since their calling convention or behavior changed:
 
-@c copied from lispref/files.texi
-@defun compat-call@ unlock-buffer
-This function unlocks the file being visited in the current buffer,
-if the buffer is modified.  If the buffer is not modified, then
-the file should not be locked, so this function does nothing.  It also
-does nothing if the current buffer is not visiting a file, or is not locked.
-This function handles file system errors by calling @code{display-warning}
-and otherwise ignores the error.
-
-@xref{File Locks,,,elisp}.
-
-This compatibility versions catches the @code{file-error} condition,
-issuing a warning instead of propagating on the error.
-@end defun
-
 @defun compat-call@ string-width string &optional from to
 This function returns the width in columns of the string @var{string},
 if it were displayed in the current buffer and the selected window.