From: Lars Ingebrigtsen <larsi@gnus.org>
Date: Fri, 11 Oct 2019 07:05:20 +0000 (+0200)
Subject: Expand the documentation of --no-build-details
X-Git-Tag: archive/raspbian/1%29.2+1-2+rpi1^2~5^2~19^2~1546
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=17fea5ba38c58324ac4029a348456484d3ea0c35;p=emacs.git

Expand the documentation of --no-build-details

* doc/emacs/cmdargs.texi (Initial Options): Mention that
--no-build-details shouldn't be used in regular usage (bug#34448).
---

diff --git a/doc/emacs/cmdargs.texi b/doc/emacs/cmdargs.texi
index 34a5ff5f2c1..3f008ecc8e7 100644
--- a/doc/emacs/cmdargs.texi
+++ b/doc/emacs/cmdargs.texi
@@ -288,8 +288,10 @@ on this first line as a comment delimiter.
 @opindex --no-build-details
 @cindex build details
 @cindex deterministic build
-Omit details like system name and build time from the Emacs executable,
-so that builds are more deterministic.
+Omit details like system name and build time from the Emacs
+executable, so that builds are more deterministic.  This switch is not
+meant for regular (or interactive) use, since it makes commands like
+@code{system-name} return @code{nil}.
 
 @item -q
 @opindex -q