FAQ - Revision history

Xaizek: /* Configuration */ Add question about editor support

2023-08-01T12:52:05Z

Configuration: Add question about editor support

Xaizek: /* Configuration */ Merge to questions

2023-08-01T12:35:01Z

Configuration: Merge to questions

Xaizek: /* How to set view-local option for both views from vifmrc? */ Update for 0.8.1+

2023-08-01T12:28:55Z

How to set view-local option for both views from vifmrc?: Update for 0.8.1+

Xaizek: /* How to get total size of selected files? */ Mention ga/gA keys

2021-11-02T11:17:56Z

How to get total size of selected files?: Mention ga/gA keys

Xaizek: /* Which code repository is the primary one? */ Wording fixes

2020-06-15T17:13:48Z

Which code repository is the primary one?: Wording fixes

Xaizek: /* Prior to 0.8 */ Fix 0.8 -> 0.9

2017-06-19T08:58:56Z

Prior to 0.8: Fix 0.8 -> 0.9

Xaizek: /* How to show hidden files by default on startup? */ Mention `set dotfiles` since 0.9

2017-06-19T08:58:34Z

How to show hidden files by default on startup?: Mention `set dotfiles` since 0.9

93.80.20.38: /* How to set view-local option for both views from vifmrc? */ typo fix

2016-11-25T07:01:53Z

How to set view-local option for both views from vifmrc?: typo fix

Xaizek: Note that :windo is optional since 0.8.1

2015-08-09T07:31:32Z

Note that :windo is optional since 0.8.1

Xaizek: Remove duplicate question about hidden files.

2015-06-20T20:52:14Z

Remove duplicate question about hidden files.

← Older revision		Revision as of 12:52, 1 August 2023
Line 20:		Line 20:

	== Configuration ==		== Configuration ==
		+
		+	=== How to use non-Vim-like editor as the default? ===
		+
		+	Vifm makes assumptions about what <code>'vicmd'</code> command can handle by requiring
		+	certain level of Vim-like compatibility which many editors don't provide.
		+
		+	Prior to Vifm 0.12.1, the only way around this was writing a wrapper script that will throw
		+	away <code>-f</code> or other Vim-specific parameters.
		+
		+	Vifm 0.12.1 or newer allows handling this better via Lua API which was introduced in part
		+	to enable such integrations.
		+
		+	==== Installing sample ''editor'' plugin ====
		+
		+	If you see your fauvorite editor listed [https://github.com/vifm/vifm/tree/master/data/plugins/editor here], then
		+	all you have to do is set:
		+
		+	<source lang="vim">
		+	set vicmd='#editor#run emacs'
		+	</source>
		+
		+	It won't necessarily support all the features, but it will at least behave reasonably when you're trying
		+	to do something the editor can't handle.
		+
		+	==== Extending ''editor'' plugin ====
		+
		+	If your editor isn't present, you might consider adding it and sending plugin changes for others to use (read [[Providing a patch]] or [https://github.com/vifm/vifm/pulls send a PR]).
		+
		+	* Clone/download [https://github.com/vifm/vifm/tree/master/data/plugins/editor that directory] and set it up locally ([[Using Lua plugins]]).
		+	* Copy one of the <code>editor-name.lua</code> files (pick the one similar to the editor you're interested in adding).
		+	* Modify <code>init.vim</code> to register your file (where other editors are listed near <code>impls</code>).
		+	* Add <code>set vicmd='#editor#run emacs'</code> to your `vifmrc`.
		+	* Modify the file to make your editor work, see [https://github.com/vifm/vifm/blob/master/data/vim/doc/app/vifm-lua.txt Lua API].

	=== How to set view-local option (sorting/columns) for ''both'' views from <code>vifmrc</code>? ===		=== How to set view-local option (sorting/columns) for ''both'' views from <code>vifmrc</code>? ===

@@ Line 21: / Line 21: @@
 == Configuration ==
-'''NOTE''': in vifm 0.8.1 and above there is no need for <code>windo</code>
+=== How to set view-local option (sorting/columns) for ''both'' views from <code>vifmrc</code>? ===
 command in <code>vifmrc</code>, it's implicitly added to cover the cases
 below.
-=== How to set sorting/columns in both panes from <code>vifmrc</code>? ===
+<source lang="vim">
 Add <code>windo</code> prefix to command you want to be executed for both panes.
@@ Line 64: / Line 80: @@
 * <kbd>zo</kbd> is ''Normal mode'' command to show hidden files.
 <source lang="vim">
 set viewcolumns=-{name}..,6{}.
 </source>
 == Design/Features ==

← Older revision		Revision as of 12:28, 1 August 2023
Line 65:		Line 65:

	=== How to set view-local option for ''both'' views from <code>vifmrc</code>? ===		=== How to set view-local option for ''both'' views from <code>vifmrc</code>? ===
		+
		+	==== Since 0.8.1 ====
		+
		+	<source lang="vim">
		+	set viewcolumns=-{name}..,6{}.
		+	</source>
		+
		+	Set in <code>vifmrc</code> applies settings to all panes now, but see below if you need to do this inside a mapping or a :command.
		+
		+	==== Prior to 0.8.1 ====

	Use <code>:windo</code> prefix-command to do this. An example:		Use <code>:windo</code> prefix-command to do this. An example:

@@ Line 114: / Line 114: @@
 <code>%s</code>.  Example:
-<source lang="vim">
+<syntaxhighlight lang="vim">
 set statusline='  %t%= %A %10u:%-7g %15E %20d  '
-</source>
+</syntaxhighlight>

@@ Line 17: / Line 17: @@
 and
   [http://sourceforge.net/p/vifm/code/ http://git.code.sf.net/p/vifm/code]
-are updated at the same time for all repositories (although they might be out of sync for a short period of time occasionally), so one should get same results no matter which code repository is used. Different repositories might have different feature/bug-fix branches, but they are temporary ones and just to communicate new code for testing.
+are updated at the same time for all repositories (although they might be out of sync for a short period of time occasionally), so one should get the same result no matter which code repository is used. Different repositories might have different feature/bug-fix branches, but they are temporary ones and exist just to communicate new code for testing.
 == Configuration ==

@@ Line 50: / Line 50: @@
 </source>
-==== Prior to 0.8 ====
+==== Prior to 0.9 ====
 Add this command to your <code>~/.vifm/vifmrc</code>:

← Older revision		Revision as of 08:58, 19 June 2017
Line 41:		Line 41:

	=== How to show hidden files by default on startup? ===		=== How to show hidden files by default on startup? ===
		+
		+	==== Since 0.9 ====
		+
		+	Add this command to your <code>~/.vifm/vifmrc</code>:
		+
		+	<source lang="vim">
		+	set dotfiles
		+	</source>
		+
		+	==== Prior to 0.8 ====

	Add this command to your <code>~/.vifm/vifmrc</code>:		Add this command to your <code>~/.vifm/vifmrc</code>:

@@ Line 62: / Line 62: @@
 </source>
-<code>:windo</code> can be used with any command, it just executes the reset of
+<code>:windo</code> can be used with any command, it just executes the rest of
 command-line in both panes.

@@ Line 20: / Line 20: @@
 == Configuration ==
 === How to set sorting/columns in both panes from <code>vifmrc</code>? ===
@@ Line 49: / Line 53: @@
 * <code>normal!</code> is ''Command-line mode'' command that executes its argument list as ''Normal mode'' commands (<code>!</code> ensures that none of user-defined mappings will affect execution of ''Normal mode'' commands);
 * <kbd>zo</kbd> is ''Normal mode'' command to show hidden files.
 == Design/Features ==
@@ Line 80: / Line 95: @@
 Add that <code>:nnoremap</code> command to your <code>~/.vifm/vifmrc</code> to
 make the shortcut persistent.
 === How to get total size of selected files? ===

@@ Line 37: / Line 37: @@
 === How to show hidden files by default on startup? ===
-Put this into <code>vifmrc</code> file:
 <source lang="vim">
-windo normal zo
+windo normal! zo
 </source>
-Explanation:
+Where:
-* <code>windo</code> — execute prefixed command for each pane.
-* <code>normal</code> — execute normal mode command.
+* <code>windo</code> applies command to both panes (as described in [[#How_to_set_view-local_option_for_both_views_from_vifmrc.3F|in another question]]);
-* <code>zo</code> — normal mode command to how hidden files.
+* <code>normal!</code> is ''Command-line mode'' command that executes its argument list as ''Normal mode'' commands (<code>!</code> ensures that none of user-defined mappings will affect execution of ''Normal mode'' commands);
 == Design/Features ==
@@ Line 89: / Line 91: @@
 <code>:windo</code> can be used with any command, it just executes the reset of
 command-line in both panes.
 === How to get total size of selected files? ===