]> code.delx.au - gnu-emacs/commitdiff
Document the eww Desktop stuff
authorIvan Shmakov <ivan@siamics.net>
Sun, 23 Nov 2014 15:44:22 +0000 (16:44 +0100)
committerLars Magne Ingebrigtsen <larsi@gnus.org>
Sun, 23 Nov 2014 15:44:22 +0000 (16:44 +0100)
Fixes: debbugs:18010
* eww.texi (Advanced): Mention the Desktop stuff (bug#18010).

doc/misc/ChangeLog
doc/misc/eww.texi
etc/NEWS

index e9029d59c206101d3fb4b761d1bb8c2bb8863e96..76545b260bd668688c4f55414c65f3670df22de0 100644 (file)
@@ -1,3 +1,7 @@
+2014-11-23  Ivan Shmakov  <ivan@siamics.net>
+
+       * eww.texi (Advanced): Mention the Desktop stuff (bug#18010).
+
 2014-11-23  Michael Albinus  <michael.albinus@gmx.de>
 
        * tramp.texi (Remote processes): Let-bind environment variables to
index 35298833c3ace6575a8b3180a303896d954206cb..8261b27354deced50ba370400aed2acb4da68c35 100644 (file)
@@ -219,6 +219,40 @@ contrast.  If that is still too low for you, you can customize the
 variables @code{shr-color-visible-distance-min} and
 @code{shr-color-visible-luminance-min} to get a better contrast.
 
+@cindex Desktop Support
+@cindex Saving Sessions
+  In addition to maintaining the history at run-time, EWW will also
+save the partial state of its buffers (the URIs and the titles of the
+pages visited) in the desktop file if one is used.  @xref{Saving Emacs
+Sessions, , emacs, The GNU Emacs Manual}
+
+@vindex eww-desktop-remove-duplicates
+  EWW history may sensibly contain multiple entries for the same page
+URI.  At run-time, these entries may still have different associated
+point positions or the actual Web page contents.
+The latter, however, tend to be overly large to preserve in the
+desktop file, so they get omitted, thus rendering the respective
+entries entirely equivalent.  By default, such duplicate entries are
+not saved.  Setting @code{eww-desktop-remove-duplicates} to nil will
+force EWW to save them anyway.
+
+@vindex eww-restore-desktop
+  Restoring EWW buffers' contents may prove to take too long to
+finish.  When the @code{eww-restore-desktop} variable is set to
+@code{nil} (the default), EWW will not try to reload the last visited
+Web page when the buffer is restored from the desktop file, thus
+allowing for faster Emacs start-up times.  When set to @code{t},
+restoring the buffers will also initiate the reloading of such pages.
+
+@vindex eww-restore-reload-prompt
+  The EWW buffer restored from the desktop file but not yet reloaded
+will contain a prompt, as specified by the
+@code{eww-restore-reload-prompt} variable.  The value of this variable
+will be passed through @code{substitute-command-keys} upon each use,
+thus allowing for the use of the usual substitutions, such as
+@code{\[eww-reload]} for the current key binding of the
+@code{eww-reload} command.
+
 @node History and Acknowledgments
 @appendix History and Acknowledgments
 
index a88902a675e7f5fd2d6d20e3ccdb83254f65dfcf..da2edb66e425dd1c6522b34c8dfe116039acde4b 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -177,6 +177,9 @@ the like off the page.
 *** You can now use several eww buffers in parallel by renaming eww
 buffers you want to keep separate.
 
+*** Partial state of the eww buffers (the URIs and the titles of the
+pages visited) is now preserved in the desktop file.
+
 *** `eww-after-render-hook' is now called after eww has rendered
 the data in the buffer.