Update help about Location menu

3 files changed, 55 insertions, 92 deletions

diff --git a/far2l/bootstrap/scripts/FarEng.hlf.m4 b/far2l/bootstrap/scripts/FarEng.hlf.m4
index e6f80eaf..4de61a4c 100644
--- a/far2l/bootstrap/scripts/FarEng.hlf.m4
+++ b/far2l/bootstrap/scripts/FarEng.hlf.m4
@@ -55,6 +55,7 @@ $^#File and archive manager#
    ~Dialog settings~@DialogSettings@
    ~Menu settings~@VMenuSettings@
    ~Command line settings~@CmdlineSettings@
+   ~Locations menu settings~@ChangeLocationConfig@
 
    ~Files highlighting and sort groups~@Highlight@
    ~File descriptions~@FileDiz@
@@ -2910,13 +2911,11 @@ $ #Location#
     This menu allows to change the current location of a panel, unmount mountpoint 
 or open a new ~plugin~@Plugins@ panel.
 
-    Select the item with the corresponding drive letter to change the drive or
-the item with the plugin name to create a new plugin panel. If the panel type
-is not a ~file panel~@FilePanel@, it will be changed to the file panel.
+    Select the item and press Enter to change the location to specified filesystem path
+or plugin. If the panel type is not a ~file panel~@FilePanel@, it will be changed to the
+file panel if you chosen filesystem location, or selected Plugin panel will be opened.
 
-    #Ctrl-A#, #F4# hotkeys invoke the ~file attributes~@FileAttrDlg@.
-
-    #F4# key can be used to assign a hotkey to plugin item.
+    #F4# key can be used to assign a hotkey to item.
 
     #Del# key can be used:
 
@@ -2928,41 +2927,20 @@ is not a ~file panel~@FilePanel@, it will be changed to the file panel.
 
     #Ctrl-1# - #Ctrl-9# switch the display of different information:
 
-    Ctrl-1 - disk type;
-    Ctrl-2 - network name/path associated with a SUBST disk/path to virtual disk container;
-    Ctrl-3 - disk label;
-    Ctrl-4 - file system;
-    Ctrl-5 - total and free disk size
-             (this option has two display modes, press twice to see);
-    Ctrl-6 - display of removable disk parameters;
-    Ctrl-7 - display of plugin items;
-    Ctrl-8 - display of CD parameters;
-    Ctrl-9 - display of network parameters.
+    #F9# shows a ~dialog for configuring Location menu~@ChangeLocationConfig@.
 
     #Location# menu settings are saved in the FAR2L configuration.
 
-    #F9# shows a dialog for configuring the display of that
-information.
-
     If the option "~Use Ctrl-PgUp to change drive~@InterfSettings@" is enabled,
 pressing #Ctrl-PgUp# works the same as pressing #Esc# - cancels drive selection
 and closes the menu.
 
-    Pressing #Shift-Enter# invokes the Windows Explorer showing the root
+    Pressing #Shift-Enter# invokes the GUI file manager showing the root
 directory of the selected drives (works only for disk drives and not for
 plugins).
 
     #Ctrl-R# allows to refresh the disk selection menu.
 
-    If "#CD drive type#" mode is enabled (#Ctrl-8#), FAR2L will attempt to
-determine the type of each of the CD drives available in the system. Known
-types are as follows: CD-ROM, CD-RW, CD-RW/DVD, DVD-ROM, DVD-RW and DVD-RAM.
-This function is available only for users either with administrative privileges
-or all local users, when it's stated explicitly in the Local Policy Editor
-(to do this, run a #secpol.msc# from the command prompt, and set the '#Local#
-#Policies/Security Options/Devices: Restrict CD-ROM access to locally logged-on#
-#user only#' setting to '#Enabled#').
-
     #Alt-Shift-F9# allows you to ~configure plugins~@PluginsConfig@ (it works only if
 display of plugin items is enabled).
 
@@ -2972,9 +2950,18 @@ currently selected plugin.
     #Shift-F1# in the plugins list displays the context-sensitive help of the
 currently selected plugin, if the plugin has a help file.
 
-    The #A# symbol in leftmost menu column means that the corresponding plugin is
-written for Far 1.7x and it does not support all possibilities available in
-Far 2 (these are, in particular, Unicode characters in filenames and in editor).
+    You can specify manual/scripted source of additional items in Location menu that
+will be appended to mountpoints entries. For that you need to create text file under
+path #~~/.config/far2l/favorites# and that file must contain lines, each line can have
+one or two or three parts separated by <TAB> character. First part represent path,
+second and third parts are optional and represent information rendered in additional
+columns. Its possible to insert separator with optional title by specifing line
+with first part having only '-' character and another part (if present) defining
+title text.
+Note that favorites file can contain shell environment variables denoted with $
+character like $HOME, and shell commands substitution, i.e. $(/path/to/some/script.sh)
+will invoke that script.sh and its output will be embedded into content of this file
+during processing. This allows to implement custom dynamic locations list composing.
 
    See also the list of ~macro keys~@KeyMacroDisksList@, available in the disk menu.
 
@@ -4248,7 +4235,8 @@ list.
 
 @ChangeLocationConfig
 $ #Change location configuration#
-    Here you can choose specific kind of items to be included in change location
+    This dialog can be opened by pressing F9 key in Location menu opened by Alt+F1/F2.
+    Here you can choose specific kind of items to be included in change Location
 menu: #mountpoints#, #bookmarks# and #plugins#.
     Also you can customize mountpoints items by specifing wildcards exceptions
 and changing templates of what should be included into additional columns.
diff --git a/far2l/bootstrap/scripts/FarRus.hlf.m4 b/far2l/bootstrap/scripts/FarRus.hlf.m4
index 8b519880..20024f2b 100644
--- a/far2l/bootstrap/scripts/FarRus.hlf.m4
+++ b/far2l/bootstrap/scripts/FarRus.hlf.m4
@@ -55,6 +55,7 @@ $^#Программа управления файлами и архивами#
    ~Настройки диалогов~@DialogSettings@
    ~Настройки меню~@VMenuSettings@
    ~Настройки командной строки~@CmdlineSettings@
+   ~Настройки меню перехода~@ChangeLocationConfig@
 
    ~Раскраска файлов и группы сортировки~@Highlight@
    ~Описания файлов~@FileDiz@
@@ -2955,12 +2956,10 @@ $ #Меню перехода#
     Это меню позволяет быстро перейти в другое место ФС, отмонтировать путь или 
 открыть новую панель ~подключаемого модуля~@Plugins@.
 
-    Выберите пункт меню с соответствующей буквой диска для смены текущего диска
+    Выберите пункт меню с путем директории для смены текущей директории
 или пункт с названием модуля, чтобы создать новую панель модуля. Если панель не
 является ~панелью файлов~@FilePanel@, её тип будет изменён на панель файлов.
 
-    Клавиши #Ctrl-A#, #F4# вызывают диалог ~файловых атрибутов~@FileAttrDlg@.
-
     Клавиша #F4# позволяет назначить горячую клавишу для подключаемого модуля.
 
     Клавиша #Del# может использоваться для:
@@ -2972,23 +2971,10 @@ $ #Меню перехода#
     Комбинация #Shift-Del# используется для безусловного отмонтирования и 
 запрашивает привилегии суперпользователя.
 
-    #Ctrl-1# - #Ctrl-9# переключают отображение различной информации:
-
-    Ctrl-1 - тип диска;
-    Ctrl-2 - сетевое имя/путь, ассоциированный с SUBST-диском/имя файла, содержащего виртуальный диск;
-    Ctrl-3 - метка диска;
-    Ctrl-4 - файловая система;
-    Ctrl-5 - общее и свободное место на диске
-             (эта опция имеет два режима, нажмите два раза чтоб увидеть);
-    Ctrl-6 - показ параметров сменных дисков;
-    Ctrl-7 - показ имён подключаемых модулей;
-    Ctrl-8 - показ параметров компакт-дисков;
-    Ctrl-9 - показ параметров сетевых дисков.
+    #F9# показывает ~диалог для настройки отображения этой информации~@ChangeLocationConfig@.
 
     Настройки меню перехода сохраняются в конфигурации FAR2L.
 
-    #F9# показывает диалог для настройки отображения этой информации.
-
     При включённой опции "~Использовать Ctrl-PgUp для выбора диска~@InterfSettings@",
 комбинация клавиш #Ctrl-PgUp# аналогична клавише #Esc# - отказаться от
 выбора диска и закрыть меню.
@@ -2998,15 +2984,6 @@ $ #Меню перехода#
 
     #Ctrl-R# позволяет обновить меню перехода.
 
-    Если включён показ параметров компакт-дисков (#Ctrl-8#), то FAR2L будет
-пытаться определить тип CD-привода. Различаются следующие приводы: CD-ROM,
-CD-RW, CD-RW/DVD, DVD-ROM, DVD-RW и DVD-RAM. Функция определения типа привода
-требует или административных прав, или разрешения доступа к локальным СD-приводам
-с помощью политик (для этого надо запустить из командной строки утилиту #secpol.msc#
-и установить настройку '#Локальные политики/Параметры безопасности/Устройства:#
-#Разрешить доступ к дисководам компакт-дисков только локальным пользователям#'
-в значение '#Разрешить#').
-
     #Alt-Shift-F9# позволяет ~настроить параметры~@PluginsConfig@ подключаемых внешних
 модулей (работает, если включён показ имён подключаемых модулей).
 
@@ -3016,9 +2993,19 @@ CD-RW, CD-RW/DVD, DVD-ROM, DVD-RW и DVD-RAM. Функция определен�
     #Shift-F1# в области подключаемых внешних модулей показывает соответствующую
 модулю контекстно-зависимую подсказку (если у плагина есть файл помощи).
 
-    Символ #A# в крайней левой колонке меню означает, что соответствующий плагин
-разработан для Far 1.7x и не поддерживает всех возможностей Far 2 (в частности,
-символов Unicode в именах файлов и в редакторе).
+    Вы можете добавить дополнительные фиксированные или динамически определяемые
+пункты в меню перехода путем создания текстового файла по данному
+пути: #~~/.config/far2l/favorites# этот файл должен содержаь строки, каждая из которых
+может состоять из одной, двух или трех частей, разделенных символом <TAB>.
+Первая часть представляет собой путь для перехода, вторая и третья являются
+опциональными и представляют информацию, отображаемую в дополнительных столбцах меню.
+Если первая часть будет представлять собой строку с одним лишь символом '-', то
+в меню будет добавлен разделитель с опциональным заголовком от последней части.
+Заметьте что файл favorites может содержать переменные среды окружения, обозначенные
+символом $, например $HOME. Кроме того поддерживается так же стандартная подстановка
+команд окружения, например $(/path/to/some/script.sh) запустит скрипт script.sh и его
+вывод будет вставлен в содержимое favories файла при построении меню. Это позволяет
+реализовать дополнительную логику динамического построения списка переходов.
 
    См. так же список ~макроклавиш~@KeyMacroDisksList@, доступных в меню перехода.
 
@@ -4397,6 +4384,7 @@ $ #Макросы: кнопки назначения#
 
 @ChangeLocationConfig
 $ #Настройки меню перехода#
+    Этот диалог можно вызвать нажав кнопку F9 в меню перехода, открытом по Alt+F1/F2.
     Здесь вы можете выбрать какие виды объектов должны быть добавлены в меню
 перехода: #точки монтирования#, #закладки# и #плагины#.
     Так же можно настроить список точек монтирования указанием шаблонов исключений
diff --git a/far2l/bootstrap/scripts/FarUkr.hlf.m4 b/far2l/bootstrap/scripts/FarUkr.hlf.m4
index c4fc093b..dfb871fe 100644
--- a/far2l/bootstrap/scripts/FarUkr.hlf.m4
+++ b/far2l/bootstrap/scripts/FarUkr.hlf.m4
@@ -55,6 +55,7 @@ $^#Програма управління файлами та архівами#
 ~Налаштування діалогів~@DialogSettings@
 ~Установки меню~@VMenuSettings@
 ~Налаштування командного рядка~@CmdlineSettings@
+~Locations menu settings~@ChangeLocationConfig@
 
 ~Розмальовка файлів та групи сортування~@Highlight@
 ~Опис файлів~@FileDiz@
@@ -2961,8 +2962,6 @@ $ #Меню переходу#
 або пункт назви модуля, щоб створити нову панель модуля. Якщо панель не
 є ~панеллю файлів~@FilePanel@, її тип буде змінено на панель файлів.
 
-Клавіші #Ctrl-A#, #F4# викликають діалог ~файлових атрибутів~ @FileAttrDlg@.
-
  Клавіша #F4# дозволяє призначити гарячу клавішу для модуля, що підключається.
 
  Клавіша #Del# може використовуватись для:
@@ -2974,23 +2973,10 @@ $ #Меню переходу#
  Комбінація #Shift-Del# використовується для безумовного відмонтування та 
 запитує привілеї суперкористувача.
 
- #Ctrl-1# - #Ctrl-9# переключають відображення різної інформації:
-
- Ctrl-1 – тип диска;
- Ctrl-2 - мережеве ім'я/шлях, асоційований з SUBST-диском/ім'я файлу, що містить віртуальний диск;
- Ctrl-3 – мітка диска;
- Ctrl-4 – файлова система;
- Ctrl-5 - загальне та вільне місце на диску
- (Ця опція має два режими, натисніть двічі щоб побачити);
- Ctrl-6 – показ параметрів змінних дисків;
- Ctrl-7 - показ імен модулів, що підключаються;
- Ctrl-8 – показ параметрів компакт-дисків;
- Ctrl-9 – показ параметрів мережних дисків.
+ #F9# показує ~діалог для налаштування відображення цієї інформації~@ChangeLocationConfig@.
 
  Налаштування меню переходу зберігаються у конфігурації FAR2L.
 
- #F9# показує діалог для налаштування відображення цієї інформації.
-
 При включеній опції "~Використовувати Ctrl-PgUp для вибору диска~@InterfSettings@",
 комбінація клавіш #Ctrl-PgUp# аналогічна клавіші #Esc# - відмовитись від
 вибору диска та закрити меню.
@@ -3000,16 +2986,7 @@ $ #Меню переходу#
 
  #Ctrl-R# дозволяє оновити меню переходу.
 
- Якщо увімкнено показ параметрів компакт-дисків (#Ctrl-8#), то FAR2L буде
-намагатись визначити тип CD-приводу. Розрізняються такі приводи: CD-ROM,
-CD-RW, CD-RW/DVD, DVD-ROM, DVD-RW та DVD-RAM. Функція визначення типу приводу
-вимагає або адміністративних прав, або дозволу доступу до локальних CD-приводів
-за допомогою політик (для цього треба запустити з командного рядка утиліту #secpol.msc#
-та встановити налаштування '#Локальні політики/Параметри безпеки/Пристрої:#
-#Дозволити доступ до дисків компакт-дисків тільки локальним користувачам#'
-у значення '#Дозволити#').
-
-#Alt-Shift-F9# дозволяє ~налаштувати параметри~@PluginsConfig@ зовнішніх, що підключаються
+ #Alt-Shift-F9# дозволяє ~налаштувати параметри~@PluginsConfig@ зовнішніх, що підключаються
 модулів (працює, якщо увімкнено показ імен модулів, що підключаються).
 
  #Shift-F9# в області зовнішніх модулів, що підключаються, викликає діалог налаштування
@@ -3018,9 +2995,18 @@ CD-RW, CD-RW/DVD, DVD-ROM, DVD-RW та DVD-RAM. Функція визначен�
  #Shift-F1# в області зовнішніх модулів, що підключаються, показує відповідну
 модулю контекстно-залежну підказку (якщо плагін має файл допомоги).
 
- Символ #A# у крайній лівій колонці меню означає, що відповідний плагін
-розроблений для Far 1.7x і не підтримує всіх можливостей Far 2 (зокрема,
-символів Unicode в іменах файлів та у редакторі).
+    You can specify manual/scripted source of additional items in Location menu that
+will be appended to mountpoints entries. For that you need to create text file under
+path #~~/.config/far2l/favorites# and that file must contain lines, each line can have
+one or two or three parts separated by <TAB> character. First part represent path,
+second and third parts are optional and represent information rendered in additional
+columns. Its possible to insert separator with optional title by specifing line
+with first part having only '-' character and another part (if present) defining
+title text.
+Note that favorites file can contain shell environment variables denoted with $
+character like $HOME, and shell commands substitution, i.e. $(/path/to/some/script.sh)
+will invoke that script.sh and its output will be embedded into content of this file
+during processing. This allows to implement custom dynamic locations list composing.
 
 також список ~макроклавіш~@KeyMacroDisksList@, доступних у меню переходу.
 
@@ -4399,11 +4385,12 @@ $ #Макроси: кнопки призначення#
 
 @ChangeLocationConfig
 $ #Change location configuration#
+    This dialog can be opened by pressing F9 key in Location menu opened by Alt+F1/F2.
     Here you can choose specific kind of items to be included in change location
 menu: #mountpoints#, #bookmarks# and #plugins#.
     Also you can customize mountpoints items by specifing wildcards exceptions
 and changing templates of what should be included into additional columns.
-    Following abbreviations can be used there:
+   Following abbreviations can be used there:
     #$T# - total disk space
     #$U# - used disk space
     #$F# - free disk space