diff --git a/Docs/src/script.but b/Docs/src/script.but
index 91c78e61..bcf80eed 100644
--- a/Docs/src/script.but
+++ b/Docs/src/script.but
@@ -17,6 +17,9 @@ Lines beginning with ; or # are comments. You can put comments after commands. Y
 \c ; Comment
 \c # Comment
 \c
+\c # Comment \
+\c     Another comment line (see `Long commands` section below)
+\c
 \c /*
 \c Comment
 \c Comment
@@ -84,6 +87,11 @@ To extend a command over multiple lines, use a backslash (\\) at the end of the
 \c      to keep, click No)" \
 \c     IDNO NoRemoveLabel
 
+Line extension for long commands works for comments as well. It can be a bit confusing, so it should be avoided.
+
+\c # A comment \
+\c     still a comment here...
+
 \\<b\\>Configuration file\\</b\\>
 
 If a file named "nsisconf.nsh" in the config directory exists, it will be included by default before any scripts (unless the /NOCONFIG command line parameter is used). The config directory on Windows is the same directory as makensis.exe is in. On other platforms this is set at install time and defaults to $PREFIX/etc/. You can alter this at runtime, see \k{usageenvironment} for more information.