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

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

[Tor Kringeland]

[-- Attachment #1: Type: text/plain, Size: 108 bytes --]

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


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: 0001-Add-a-docstring-to-iso-transl-set-language.patch --]
[-- Type: text/x-patch, Size: 1240 bytes --]

From ec1e489fc2cf2b49e91316307aaa550bf2d8b3d1 Mon Sep 17 00:00:00 2001
From: Tor Kringeland <tor.a.s.kringeland@ntnu.no>
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

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

[Lars Ingebrigtsen]

Tor Kringeland <tor.a.s.kringeland@ntnu.no> writes:

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

Thanks; applied to Emacs 29 (with some changes -- the first line of a
doc string should be less than 80 characters long).

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no