From d508520646c84fe2facbfd27a564a17965ccd879 Mon Sep 17 00:00:00 2001
From: Slava Zanko <slavazanko@gmail.com>
Date: Fri, 11 Jan 2013 14:13:23 +0300
Subject: [PATCH] Add description of feature to man/help

Signed-off-by: Slava Zanko <slavazanko@gmail.com>
---
 doc/man/mc.1.in    | 40 ++++++++++++++++++++++++++++++++++++++++
 doc/man/ru/mc.1.in | 39 ++++++++++++++++++++++++++++++++++++++-
 2 files changed, 78 insertions(+), 1 deletion(-)

diff --git a/doc/man/mc.1.in b/doc/man/mc.1.in
index d8822d4ab..7e990f8a5 100644
--- a/doc/man/mc.1.in
+++ b/doc/man/mc.1.in
@@ -1038,6 +1038,13 @@ environment variable is tried.  If
 is also undefined, the "view" command is invoked.  If you use F13
 instead, the viewer will be invoked without doing any formatting or
 preprocessing to the file.
+.P
+See
+.\"LINK2"
+parameters for external viewer
+.\"Parameters for external editor or viewer"
+for explain how you may specify an extended command line options
+for external viewers.
 .PP
 .B Filtered View (Alt\-!)
 .PP
@@ -1059,6 +1066,13 @@ environment variable, or the
 Internal File Editor
 .\"Internal File Editor"
 if the use_internal_edit option is on.
+.P
+See
+.\"LINK2"
+parameters for external editor
+.\"Parameters for external editor or viewer"
+for explain how you may specify an extended command line options
+for external editors.
 .PP
 .B Copy (F5, F15)
 .PP
@@ -4094,6 +4108,32 @@ For example:
 .nf
 autodetect_codeset=russian
 .fi
+.\"NODE "Parameters for external editor or viewer"
+.SH "Parameters for external editor or viewer"
+The Midnight Commander provides a way for specify an options for external editors
+and viewers. The Midnight Commander tries to search the
+"[External editor or viewer parameters]" section in the system initialization file
+(the mc.lib file located in the Midnight Commander library directory)
+and then in the ~/.config/mc/ini file. The option name should be equal to the name
+(full pathname) of external editor or viewer. The option value can contain following
+variables:
+.PP
+.I %filename
+.IP
+The filename to edit/view.
+.PP
+.I %lineno
+.IP
+The start line in the opening file.
+.PP
+For example:
+.PP
+.nf
+[External editor or viewer parameters]
+    vi=%filename +%lineno
+    joe=%filename +%lineno
+    more=%filename +%lineno
+.fi
 .\"NODE "Terminal databases"
 .SH "Terminal databases"
 The Midnight Commander provides a way to fix your system terminal
diff --git a/doc/man/ru/mc.1.in b/doc/man/ru/mc.1.in
index 8d960ca78..607e9402f 100644
--- a/doc/man/ru/mc.1.in
+++ b/doc/man/ru/mc.1.in
@@ -1036,6 +1036,13 @@ Escape\-последовательности, генерируемые клав
 не определена, вызывается встроенная программа. Если вместо F3 нажать
 F13, встроенная программа просмотра не выполняет предварительного
 форматирования или обработки файла.
+.P
+В разделе
+.\"LINK2"
+Параметры для внешних редакторов и программ просмотра
+.\"Parameters for external editor or viewer"
+описано, как можно задать параметры командной строки для внешних программ
+просмотра файлов.
 .PP
 .B Просмотр вывода команды
 .PP
@@ -1057,7 +1064,13 @@ F13, встроенная программа просмотра не выпол
 .\"Internal File Editor"
 (если включена опция "Встроенный редактор"
 .I (use_internal_edit)
-в меню "Настройки / Конфигурация").
+в меню "Настройки / Конфигурация"). 
+.P
+В разделе
+.\"LINK2"
+Параметры для внешних редакторов и программ просмотра
+.\"Parameters for external editor or viewer"
+описано, как можно задать параметры командной строки для внешних редакторов.
 .PP
 .B Копирование
 .PP
@@ -4486,6 +4499,30 @@ clipboard_paste=xclip \-o
 .nf
 autodetect_codeset=russian
 .fi
+.\"NODE "Parameters for external editor or viewer"
+.SH "Параметры для внешних редакторов и программ просмотра"
+Midnight Commander позволяет задать некоторые параметрыы для внешних редакторов
+и программ просмотра. Они задаются в секции "[External editor or viewer parameters]",
+которая сначала ищется в системном (mc.lib), а затем в пользовательском (~/.config/mc/ini)
+файле инициализации. Имя параметра должно совпадать с именем внешнего редактора или
+программы просмотра. Значение параметра может содержать следующие переменные:
+.PP
+.I %filename
+.IP
+Имя файла для редактирования или просмотра.
+.PP
+.I %lineno
+.IP
+Номер начальной строки в открываемом файле.
+.PP
+Пример:
+.PP
+.nf
+[External editor or viewer parameters]
+    vi=%filename +%lineno
+    joe=%filename +%lineno
+    more=%filename +%lineno
+.fi
 .\"NODE "Terminal databases"
 .SH "Базы терминалов"
 Midnight Commander обеспечивает возможность внесения исправлений в