Desktop.el - Revision history

Elvince: /* Psession: desktop improved */

2018-05-10T17:05:38Z

Psession: desktop improved

Elvince: /* See also */ psession

2018-05-10T17:05:09Z

Elvince: desktop tips

2014-08-30T13:02:36Z

desktop tips

Elvince: desktop.el

2014-08-30T12:49:52Z

desktop.el

New page

{{Package
|name=Desktop
|description=save and restore the state of Emacs accross sessions
|in_emacs=yes
}}

Use the [[desktop]] library to save the state of Emacs from one session to another. Once you save the Emacs desktop (the buffers, their file names, major modes, buffer positions, and so on) then subsequent Emacs sessions reload the saved desktop.

= Save and restore sessions manually =

You can save the desktop manually with the command {{Command | desktop-save}}, and you can load a saved one with {{Command| desktop-read}}.

= Save and restore sessions automatically =

You can also enable automatic saving of the desktop when you exit Emacs, and automatic restoration of the last saved desktop when Emacs starts: add this line in your init file:

(desktop-save-mode 1)

If you turn on desktop-save-mode in your init file, then when Emacs starts, it looks for a saved desktop in the current directory. (More precisely, it looks in the directories specified by desktop-path, and uses the first desktop it finds.) Thus, you can have separate saved desktops in different directories, and the starting directory determines which one Emacs reloads. You can save the current desktop and reload one saved in another directory by typing {{Command|desktop-change-dir}}. Typing {{Command|desktop-revert}} reverts to the desktop previously reloaded.

== Restore big sessions smoothly ==

By default, all the buffers in the desktop are restored at one go. However, this may be slow if there are a lot of buffers in the desktop. You can specify the maximum number of buffers to restore immediately with the variable <code>desktop-restore-eager</code>; the remaining buffers are restored “lazily”, when Emacs is idle.

= Tips =

== Clear the desktop ==

Type {{Command|desktop-clear}} to empty the Emacs desktop. This kills all buffers except for internal ones, and clears the global variables listed in <code>desktop-globals-to-clear</code>. If you want this to preserve certain buffers, customize the variable <code>desktop-clear-preserve-buffers-regexp</code>, whose value is a regular expression matching the names of buffers not to kill.

= See also =

== Savehist: save minibuffer history ==

[[savehist]], to save minibuffer history from one session to another.

[[Category:Desktop Management]]

@@ Line 59: / Line 59: @@
 == Psession: desktop improved ==
-[[psession https://github.com/thierryvolpiatto/psession]], by Helm's author, also restores your last window configuration, the value of any var, history variables (as a replacement for the above mentioned savehist mode), optionally autosaves the session, etc.
+[https://github.com/thierryvolpiatto/psession psession], by Helm's author, also restores your last window configuration, the value of any var, history variables (as a replacement for the above mentioned savehist mode), optionally autosaves the session, etc.
 == Savehist: save minibuffer history ==

← Older revision		Revision as of 17:05, 10 May 2018
Line 56:		Line 56:

	See the page [[Session_management]]		See the page [[Session_management]]
		+
		+	== Psession: desktop improved ==
		+
		+	[[psession https://github.com/thierryvolpiatto/psession]], by Helm's author, also restores your last window configuration, the value of any var, history variables (as a replacement for the above mentioned savehist mode), optionally autosaves the session, etc.

	== Savehist: save minibuffer history ==		== Savehist: save minibuffer history ==

@@ Line 7: / Line 7: @@
 Use the [[desktop]] library to save the state of Emacs from one session to another. Once you save the Emacs desktop (the buffers, their file names, major modes, buffer positions, and so on) then subsequent Emacs sessions reload the saved desktop.
-= Save and restore sessions manually =
+= Usage =
 You can save the desktop manually with the command {{Command | desktop-save}}, and you can load a saved one with {{Command| desktop-read}}.
-= Save and restore sessions automatically =
+== Save and restore sessions automatically ==
 You can also enable automatic saving of the desktop when you exit Emacs, and automatic restoration of the last saved desktop when Emacs starts: add this line in your init file:
@@ Line 19: / Line 21: @@
 If you turn on desktop-save-mode in your init file, then when Emacs starts, it looks for a saved desktop in the current directory. (More precisely, it looks in the directories specified by desktop-path, and uses the first desktop it finds.) Thus, you can have separate saved desktops in different directories, and the starting directory determines which one Emacs reloads. You can save the current desktop and reload one saved in another directory by typing {{Command|desktop-change-dir}}. Typing {{Command|desktop-revert}} reverts to the desktop previously reloaded.
 = Tips =
@@ Line 28: / Line 28: @@
 Type {{Command|desktop-clear}} to empty the Emacs desktop. This kills all buffers except for internal ones, and clears the global variables listed in <code>desktop-globals-to-clear</code>. If you want this to preserve certain buffers, customize the variable <code>desktop-clear-preserve-buffers-regexp</code>, whose value is a regular expression matching the names of buffers not to kill.
 = See also =
 == Savehist: save minibuffer history ==