diff --git a/docs/sources/reference/commandline/cli.md b/docs/sources/reference/commandline/cli.md
index d75f2b1443..dac7c1610b 100644
--- a/docs/sources/reference/commandline/cli.md
+++ b/docs/sources/reference/commandline/cli.md
@@ -764,14 +764,17 @@ log entry.
 
     Usage: docker pause CONTAINER
 
-    Pause uses the cgroups freezer to suspend all processes in a container.
-    Traditionally when suspending a process the SIGSTOP signal is used,
-    which is observable by the process being suspended. With the cgroups freezer
-    the process is unaware, and unable to capture, that it is being suspended,
-    and subsequently resumed.
+    Pause all processes within a container
 
-    For for information on the cgroups freezer see:
-    https://www.kernel.org/doc/Documentation/cgroups/freezer-subsystem.txt
+The `docker pause` command uses the cgroups freezer to suspend all processes in
+a container.  Traditionally when suspending a process the `SIGSTOP` signal is
+used, which is observable by the process being suspended. With the cgroups freezer
+the process is unaware, and unable to capture, that it is being suspended,
+and subsequently resumed.
+
+See the [cgroups freezer documentation]
+(https://www.kernel.org/doc/Documentation/cgroups/freezer-subsystem.txt) for
+further details.
 
 ## ps
 
@@ -1282,6 +1285,13 @@ them to [*Share Images via Repositories*](
 
     Resumes a paused container.
 
+The `docker unpause` command uses the cgroups freezer to un-suspend all
+processes in a container.
+
+See the [cgroups freezer documentation]
+(https://www.kernel.org/doc/Documentation/cgroups/freezer-subsystem.txt) for
+further details.
+
 ## version
 
     Usage: docker version