diff --git a/runtime/doc/insert.txt b/runtime/doc/insert.txt
index 01065a2356..079e834734 100644
--- a/runtime/doc/insert.txt
+++ b/runtime/doc/insert.txt
@@ -2017,13 +2017,13 @@ NOTE: These commands cannot be used with |:global| or |:vglobal|.
 			save the output of the command, which can be set to
 			include stderr or not.  {cmd} is executed like with
 			":!{cmd}", any '!' is replaced with the previous
-			command |:!|. See |++opt| for the possible values of
-			[++opt].
+			command |:!|.
+			See |++opt| for the possible values of [++opt].
 
 							*:r:* *:read:*
 :[range]r[ead] :{cmd}
 			Execute Ex command {cmd} and insert its output below
-			the cursor or the specified line
+			the cursor or the specified line.
 
 These commands insert the contents of a file, or the output of a command,
 into the buffer.  They can be undone.  They cannot be repeated with the "."
diff --git a/runtime/doc/news.txt b/runtime/doc/news.txt
index 2a5a007491..0c626e0a2e 100644
--- a/runtime/doc/news.txt
+++ b/runtime/doc/news.txt
@@ -212,8 +212,8 @@ EDITOR
   "~/" are now expanded to the user's profile directory, not a relative path
   to a literal "~" directory.
 • |hl-PmenuMatch| and |hl-PmenuMatchSel| show matched text in completion popup.
-• |:read:| reads the output of an Ex command into the buffer. Example:> :read
-  :ls
+• |:read:| reads the output of an Ex command into the buffer. Example:>
+    :read :ls
 
 EVENTS