Subject: bug#52261: [PATCH] Document `iso-transl-set-language'

From: Tor Kringeland <[email-masked]>
Date: Fri, 03 Dec 2021 16:52:12 +0100

As discussed devel.  Feedback appreciated as I'm not accustomed to
writing docstrings for Emacs functions.

>From ec1e489fc2cf2b49e91316307aaa550bf2d8b3d1 Mon Sep 17 00:00:00 2001
From: Tor Kringeland <[email-masked]>
Date: Fri, 3 Dec 2021 16:45:16 +0100
Subject: [PATCH] Add a docstring to `iso-transl-set-language'

* lisp/international/iso-transl.el: Document `iso-transl-set-language'
---
 lisp/international/iso-transl.el | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/lisp/international/iso-transl.el b/lisp/international/iso-transl.el
index 2c7da2b7cd..bd2a33b538 100644
--- a/lisp/international/iso-transl.el
+++ b/lisp/international/iso-transl.el
@@ -294,6 +294,13 @@ sequence VECTOR.  (VECTOR is normally one character long.)")
     (setq alist (cdr alist))))
 
 (defun iso-transl-set-language (lang)
+  "Set shorter key-bindings with the `C-x 8' prefix for some characters relevant for `lang'.
+
+Note that only a few languages are supported, and for more
+rigorous support it is recommended to use an input method
+instead.  Also note that many of these characters can be input
+with the regular `C-x 8' map without having to specify a language
+here."
   (interactive (list (let ((completion-ignore-case t))
 		       (completing-read "Set which language? "
 					iso-transl-language-alist nil t))))
-- 
2.34.1