From dde3d57b1f26646fd3789f8b065a3c53cdcd3de3 Mon Sep 17 00:00:00 2001
From: Frank LENORMAND <lenormf@gmail.com>
Date: Sun, 3 Nov 2019 08:53:11 +0100
Subject: [PATCH] doc commands: Document auto-generated scratch buffer names

---
 doc/pages/commands.asciidoc | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/doc/pages/commands.asciidoc b/doc/pages/commands.asciidoc
index 2ef0f3a98..d85d336ab 100644
--- a/doc/pages/commands.asciidoc
+++ b/doc/pages/commands.asciidoc
@@ -41,7 +41,9 @@ of the file onto the filesystem
 
     *-scratch*:::
         Creates a new buffer named <filename>, which doesn't correspond to any
-        file on disk.
+        file on disk. If no filename is given, the buffer name will be
+        generated based on format `\*scratch-$ID\*`, where `$ID` is an
+        integer automatically incremented for new buffers.
         (See <<buffers#scratch-buffers,`:doc buffers scratch-buffers`>>)
 
     *-scroll*:::