1 files changed, 12 insertions, 9 deletions

diff --git a/src/buffer.c b/src/buffer.c
index 9f954e1aba9..291c7d3f911 100644
--- a/src/buffer.c
+++ b/src/buffer.c
@@ -5901,24 +5901,27 @@ Use Custom to set this variable and update the display.  */);
                      Qnil,
     doc: /* How the on screen keyboard's input method should insert in this buffer.
 
-When nil, the input method will be disabled and an ordinary keyboard
+If nil, the input method will be disabled and an ordinary keyboard
 will be displayed in its place.
 
-When the symbol `action', the input method will insert text directly, but
-will send `return' key events instead of inserting new line characters.
-Any other value means that the input method will insert text directly.
+If the value is the symbol `action', the input method will insert text
+directly, but will send `return' key events instead of inserting new
+line characters.
+
+If the value is the symbol `password', an input method capable of ASCII
+input will be enabled, and will not save the entered text where it will
+be retrieved for text suggestions or other features not suitable for
+handling sensitive information, in addition to reporting `return' as
+when `action'.
 
-When the symbol `password', an input method capable of ASCII input will
-be enabled, and will not save entered text where it will be retrieved
-for text suggestions or other features not suited to handling sensitive
-information, in addition to reporting `return' as when `action'.
+Any other value means that the input method will insert text directly.
 
 If you need to make non-buffer local changes to this variable, use
 `overriding-text-conversion-style', which see.
 
 This variable does not take immediate effect when set; rather, it
 takes effect upon the next redisplay after the selected window or
-buffer changes.  */);
+its buffer changes.  */);
 
   DEFVAR_LISP ("kill-buffer-query-functions", Vkill_buffer_query_functions,
                doc: /* List of functions called with no args to query before killing a buffer.