Quitting Vifm - Revision history

Xaizek: /* Preserving runtime state across sessions */ Correction about how vifminfo is restored

2022-06-11T08:15:20Z

Preserving runtime state across sessions: Correction about how vifminfo is restored

Ohea: /* fix error */

2022-03-27T08:12:32Z

fix error

Ohea: /* make save/load description more clear. remove extraneous info regarding load order */

2022-03-27T08:10:50Z

make save/load description more clear. remove extraneous info regarding load order

Xaizek: Add Manual category

2014-09-27T16:18:55Z

Add Manual category

Xaizek: /* Preserving runtime state across sessions */ Describe data merging

2014-09-19T20:18:05Z

Preserving runtime state across sessions: Describe data merging

Xaizek: /* Remembering last visited directories of panes */ Write text

2014-09-18T20:52:13Z

Remembering last visited directories of panes: Write text

Xaizek: /* Quitting Vifm started in file picker mode (e.g. from Vim plugin) */ Write all TODOs

2014-09-17T20:39:24Z

Quitting Vifm started in file picker mode (e.g. from Vim plugin): Write all TODOs

Xaizek: /* Quitting Vifm started in file picker mode (e.g. from Vim plugin) */ Describe -f and file location and format

2014-09-16T20:54:30Z

Quitting Vifm started in file picker mode (e.g. from Vim plugin): Describe -f and file location and format

Xaizek: /* Preserving runtime state across sessions */ Fill in table of vifminfo values

2014-09-13T20:55:17Z

Preserving runtime state across sessions: Fill in table of vifminfo values

Xaizek: /* Preserving runtime state across sessions */ Write introduction

2014-09-11T20:58:22Z

Preserving runtime state across sessions: Write introduction

@@ Line 7: / Line 7: @@
 # On exit Vifm saves the items set in the <code>'vifminfo'</code> option to the vifminfo file.
-# On startup Vifm loads the items set in <code>'vifminfo'</code> option from the vifminfo file.
+# On startup Vifm loads whatever was previously stored in vifminfo file (thus <code>'vifminfo'</code> controls what's restored indirectly).
 By default only bookmarks are stored.

@@ Line 13: / Line 13: @@
 Below is the table of all possible values.  Note those marked as ''obsolete'', they might be removed
 in future versions (for a good reason: they don't fit into usual way configuration files are used; it's better
-to put commands that correspond to this items into <code>vifmrc</code>).
+to put commands that correspond to these items into <code>vifmrc</code>).
 {| class="wikitable"

@@ Line 6: / Line 6: @@
 state that can be saved on exit and restored on startup. It works this way:
-# On exit Vifm stores all th is listed in <code>vifminfo</code>.
+# On exit Vifm saves the items set in the <code>'vifminfo'</code> option to the vifminfo file.
-# On startup Vifm loads reads <code>vifmrc</code>, which normally contains <code>set vifminfo=...</code> and restores from <code>vifminfo</code> only items that correspond to that values.
+# On startup Vifm loads the items set in <code>'vifminfo'</code> option from the vifminfo file.
 By default only bookmarks are stored.

← Older revision		Revision as of 16:18, 27 September 2014
Line 145:		Line 145:

	See [[How to set shell working directory after leaving Vifm]].		See [[How to set shell working directory after leaving Vifm]].
		+
		+	[[Category:Manual]]

@@ Line 12: / Line 12: @@
 Below is the table of all possible values.  Note those marked as ''obsolete'', they might be removed
-in future versions (for a good reason: they don't fit into usual way configuration fails are used; it's better
+in future versions (for a good reason: they don't fit into usual way configuration files are used; it's better
 to put commands that correspond to this items into <code>vifmrc</code>).
 {| class="wikitable"
-|+Available elements of <code>vifminfo</code> value
+|+Available elements of <code>'vifminfo'</code> value
 ! width="70px" | Value
 ! width="65px" | Default
@@ Line 24: / Line 24: @@
 |-
 | tui       ||! align="center" | No  || State of the user interface (sorting, number of windows, quick view state, active view).
 |-
 | state     ||! align="center" | No  || File name and dot filters and terminal multiplexers integration state.
@@ Line 32: / Line 30: @@
 |-
 | savedirs  ||! align="center" | No  || Save last visited directory (requires <code>dhistory</code>).
 |-
 | chistory  ||! align="center" | No  || Command line history.
@@ Line 41: / Line 41: @@
 | fhistory  ||! align="center" | No  || Local filter history.
 |-
-| dirstack  ||! align="center" | No  || Directory stack overwrites previous stack, unless stack of current session is empty.
+| dirstack  ||! align="center" | No  || Directory stack (see <code>:dirs</code>, <code>:pushd</code>, <code>:popd</code>).
 |-
 | registers ||! align="center" | No  || Registers content.
@@ Line 54: / Line 54: @@
 |}
-'''TODO:''' merging of state.
+These are not always trivial to combine, the next table describes how Vifm does it.
 === Remembering last visited directories of panes ===

@@ Line 58: / Line 58: @@
 === Remembering last visited directories of panes ===
-'''TODO:''' how it affects starting Vifm without arguments.
+Without previous state (e.g. by default or on first start up) and with no
 == Quitting Vifm started in file picker mode (e.g. from Vim plugin) ==

@@ Line 64: / Line 64: @@
 When <code>-f</code> command-line argument is given to Vifm, it starts acting
 like file picker.  Most of commands work as usual, but instead of opening files
-it:
+Vifm:
 # Stores selected files (or current file when selection is empty) in place accessible by invoker (see below).
-# Quits Vifm.
+# Quits.
-'''TODO:''' running commands store selection and quit.
+And quiting Vifm by user causes empty list of files to be written, so that
 Selected files are stored in main configuration directory (<code>~/.vifm/</code>
@@ Line 76: / Line 78: @@
 properly).
-'''TODO:''' example for shell.
+==== Usage example ====
 === Updating shell directory after leaving Vifm ===
 See [[How to set shell working directory after leaving Vifm]].

@@ Line 9: / Line 9: @@
 # On startup Vifm loads reads <code>vifmrc</code>, which normally contains <code>set vifminfo=...</code> and restores from <code>vifminfo</code> only items that correspond to that values.
-''By default'' only bookmarks are stored.
+By default only bookmarks are stored.
 Below is the table of all possible values.  Note those marked as ''obsolete'', they might be removed
@@ Line 15: / Line 15: @@
 to put commands that correspond to this items into <code>vifmrc</code>).
 {| class="wikitable"
-|+Possible members of <code>vifminfo</code> value
+|+Available elements of <code>vifminfo</code> value
-! width="200px" | Value
+! width="70px" | Value
-! width="200px" | Default
+! width="65px" | Default
-! width="200px" | Obsolete
+! width="600px" | Description
 |-
-|  ||  ||  ||
+| bookmarks ||! align="center" | Yes || Bookmarks, except special ones like <code>'&lt;</code> and <code>'&gt;</code>.
 |}

@@ Line 1: / Line 1: @@
 == Preserving runtime state across sessions ==
-'''TODO:''' <code>'vifminfo'</code> option.
+As described in [[Configuration model]], Vifm can store some information between
 '''TODO:''' table of things that can be stored (mark old-style things like commands and options as '''obsolete''').
 '''TODO:''' merging of state.