From: Martin Rudalics <rudalics@gmx.at>
Date: Thu, 2 Nov 2017 08:28:25 +0000 (+0100)
Subject: In frame parameters documentation mention desktop saving/restoring
X-Git-Tag: emacs-26.0.91~413
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=27964af438c9a25dedd2e7bccb1a11ddfe679858;p=emacs.git

In frame parameters documentation mention desktop saving/restoring

* doc/lispref/frames.texi (Frame Parameters): Mention that
applications have to care about which parameters they want to
get saved and restored by the desktop library.
---

diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi
index 5ea7125882f..a146061c771 100644
--- a/doc/lispref/frames.texi
+++ b/doc/lispref/frames.texi
@@ -1210,6 +1210,13 @@ terminal supports colors, the parameters @code{foreground-color},
 @code{display-type} are also meaningful.  If the terminal supports
 frame transparency, the parameter @code{alpha} is also meaningful.
 
+  By default, frame parameters are saved and restored by the desktop
+library functions (@pxref{Desktop Save Mode}) when the variable
+@code{desktop-restore-frames} is non-@code{nil}.  It's the
+responsibility of applications that their parameters are included in
+@code{frameset-persistent-filter-alist} to avoid that they get
+meaningless or even harmful values in restored sessions.
+
 @menu
 * Parameter Access::       How to change a frame's parameters.
 * Initial Parameters::     Specifying frame parameters when you make a frame.