Улучшение файла помощи Фара

Хотите говорить о Far и не знаете, куда обратиться?
User avatar
John Doe
Бюрократ
Posts: 13807
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 426 times
Contact:

Re: Улучшение файла помощи фара

Post by John Doe »

Latest post of the previous page:

svs 18.08.2010 22:31:22 +0300 - build 1644 wrote:1. Mantins#0001305: wish: Show some cols of Find window
Настройка колонок находится в диалоге "Find file advanced options" (в поисковике кнопка "Advanced")
Синтаксис типов колонок - как у панелей.
Отличия и ограничения - описаны в хелпе к диалогу "Find file advanced options".
В результате в хелпе получилось 2 практически одинаковых куска.
Может лучше в помощи к опциям поиска (@FindFileAdvanced) ограничиться ссылкой на @PanelViewModes + описание отличий?
User avatar
Skirda
Posts: 3475
Joined: Wed 16 Mar, 2005 11:01
Been thanked: 8 times

Re: Улучшение файла помощи фара

Post by Skirda »

Я думал об этом, но...
Возможно ты прав, но обязательно 51.7% юзеров (даже из-за вредности) начнут трещать о том, что N (и пр.отсутствующие колонки) не работают.
Так что пусть это останется как есть - в виде почти двух одинаковых частей...
Просто ссылку дать все равно не получится, ибо там "панели", а здесь "результаты поиска" - это еще больше запутает те самые 51.7% контингента.
We are the Borg. You will be assimilated.
So Say We All!
User avatar
John Doe
Бюрократ
Posts: 13807
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 426 times
Contact:

Re: Улучшение файла помощи фара

Post by John Doe »

Skirda wrote:Просто ссылку дать все равно не получится, ибо там "панели", а здесь "результаты поиска"
А что помешает?

Code: Select all

Можно использовать почти все #типы колонок# что и в ~Панелях~@PanelViewModes@, за исключением N и т. п...
Skirda wrote:...это еще больше запутает те самые 51.7% контингента.
А как же оставшиеся 48,3%? Я вот чуть глаза не поломал открывая попеременно оба раздела ;)
User avatar
Skirda
Posts: 3475
Joined: Wed 16 Mar, 2005 11:01
Been thanked: 8 times

Re: Улучшение файла помощи фара

Post by Skirda »

John Doe wrote:
Skirda wrote:...это еще больше запутает те самые 51.7% контингента.
А как же оставшиеся 48,3%? Я вот чуть глаза не поломал открывая попеременно оба раздела ;)
А ты так не делай, а то процент первых увеличится :twisted:
We are the Borg. You will be assimilated.
So Say We All!
User avatar
Skirda
Posts: 3475
Joined: Wed 16 Mar, 2005 11:01
Been thanked: 8 times

Re: Документация: Ctrl-Alt-F (фильтр меню)

Post by Skirda »

DV wrote:Перерыл всю справку по FAR - ну нету там упоминания о Ctrl-Alt-F для фильтрации меню, нету! Почему??
Сделай патч для FarEng.hlf.m4 и FarRus.hlf.m4, опубликуй на мантисе... тогда будет :)
DV wrote:Я вот подумал, а есть ли другие недокументированные сочетания клавиш или возможности FAR?
Вполне возможно...
DV wrote:В частности, нашёл ещё вот что: Энциклопедия FAR в разделе Макроязык, Функции вообще не упоминает CallPlugin. Откуда же можно узнать, что такая функция вообще существует?
Это эксперементальная функция...
We are the Borg. You will be assimilated.
So Say We All!
DV
Posts: 455
Joined: Mon 07 Aug, 2006 08:23
Has thanked: 31 times
Been thanked: 15 times

Re: Документация: Ctrl-Alt-F (фильтр меню)

Post by DV »

Skirda wrote:Сделай патч для FarEng.hlf.m4 и FarRus.hlf.m4
Не знаю, что такое .m4 ...
А текст добавить примерно такой (в самом конце перечисления клавиатурных комбинаций, перед фразой "See also"):

Code: Select all

Ctrl-Alt-F  -  фильтрация элементов меню (работает во всех меню, комбах и листбоксах).
Ctrl-Alt-F  -  menu items filtering (works inside all menu, combo- and list-boxes).
Что касается CallPlugin... В любом случае описание нужно - иначе такой функции как будто просто нет. И добавить: "экспериментальная функция".
User avatar
John Doe
Бюрократ
Posts: 13807
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 426 times
Contact:

Re: Улучшение файла помощи фара

Post by John Doe »

Странная позиция: что такое .m4 знать вы не хотите, но считаете что все должны мигом выполнять ваши пожелания?
Поглядите в шапку, там много чего в хелпе не хватает.
Хотите помочь - помогайте.
А ваши отрывочные реплики - это не помощь

P.S.
На форуме есть тема Энциклопедия: улучшение раздела о макросах.
Добавление callplugin() лучше обсуждать там.
Кстати ещё одно экспериментальное свойство неописанное в Энциклопедии: Dlg.Info.Id
DV
Posts: 455
Joined: Mon 07 Aug, 2006 08:23
Has thanked: 31 times
Been thanked: 15 times

Re: Улучшение файла помощи фара

Post by DV »

John Doe wrote:что такое .m4 знать вы не хотите
А с помощью чего делать .diff файл? С этим справится WinMerge или нужно что-то специфическое?
User avatar
John Doe
Бюрократ
Posts: 13807
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 426 times
Contact:

Re: Улучшение файла помощи фара

Post by John Doe »

Справится.
А если у вас есть svn-клиент, то можно (и рекомендуется) с его помощью.
Можно и консольным diff'ом (обсуждалось).
DV
Posts: 455
Joined: Mon 07 Aug, 2006 08:23
Has thanked: 31 times
Been thanked: 15 times

Re: Улучшение файла помощи фара

Post by DV »

Касательно кусочка документации по Ctrl-Alt-F (фильтрация элементов меню) получается что-то такое (см. вложенный файл).
Далее порядок сходный с этим? - http://bugs.farmanager.com/view.php?id=1367
Attachments
FarHlf.zip
FarHlf.diff for FarEng.hlf.m4 & FarRus.hlf.m4
(1.01 KiB) Downloaded 179 times
User avatar
John Doe
Бюрократ
Posts: 13807
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 426 times
Contact:

Re: Улучшение файла помощи фара

Post by John Doe »

+ #Ctrl-Alt-F# - фильтрация элементов меню (работает во всех меню,
+ комбах и листбоксах).
Кто такие комбы наука не знает.
А листбоксы и комбобоксы нежелательны, т.к. неразработчику эти термины непонятны.

Собственно и "фильтрация элементов меню" сама по себе требует объяснения, думаю надо создать отдельный раздел, а во всех (в вашем варианте двух) местах достаточно будет просто сослаться.
DV
Posts: 455
Joined: Mon 07 Aug, 2006 08:23
Has thanked: 31 times
Been thanked: 15 times

Re: Улучшение файла помощи фара

Post by DV »

John Doe wrote:Кто такие комбы наука не знает.
Есть такое :) Исправил на "выпадающие списки" - вроде, общепринятый термин.
John Doe wrote:Собственно и "фильтрация элементов меню" сама по себе требует объяснения
Увольте - это, право же, не ко мне... Сочинения на тему "И вот сейчас в меню появятся квадратные скобки, в которых будут показаны введенные вами буквы, отфильтровывающие пункты меню..." - не мой конёк.
Attachments
FarHlf.7z
FarHlf.diff - обновлённый вариант
(1015 Bytes) Downloaded 189 times
User avatar
John Doe
Бюрократ
Posts: 13807
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 426 times
Contact:

Re: Улучшение файла помощи фара

Post by John Doe »

"Выпадающий список" это правильно, в других местах хелпа он именно так именуется.

Правда для того, кто только знакомиться с фаром будет совершенно неясно откуда эти списки вообще могут "выпадать"...
Да и сами эти списки тоже нуждаются в собственном хелпе.
Увольте - это, право же, не ко мне... Сочинения на тему "И вот сейчас в меню появятся квадратные скобки, в которых будут показаны введенные вами буквы, отфильтровывающие пункты меню..." - не мой конёк.
Вот все так говорят, и никто не улучшает хелп.
User avatar
zg
zero-gravity
Posts: 6016
Joined: Tue 15 Mar, 2005 17:36
Location: riga
Been thanked: 185 times
Contact:

Re: Улучшение файла помощи фара

Post by zg »

John Doe wrote:Вот все так говорят, и никто не улучшает хелп.
а смысл? всё равно никто не читает.
User avatar
John Doe
Бюрократ
Posts: 13807
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 426 times
Contact:

Re: Улучшение файла помощи фара

Post by John Doe »

Добавление Ctrl-Alt-F в описание меню плагинов (F11 - Команды внешних модулей), и меню конфигурации плагинов (Alt-Shift-F9 - Параметры внешних модулей) это конечно хорошо...

Но ведь фильтрация работает в любом меню, в том числе в следующих:
  • Меню пользователя (F2) @UserMenu
  • Главное меню (F9) @Menus и подменю @LeftRightMenu @FilesMenu @CmdMenu @OptMenu
  • Меню режимов сортировки (Ctrl-F12) @PanelCmdSort
  • Меню выбора диска (Alt-F1/F2) @DriveDlg
  • Всевозможные Истории:
    • История команд (Alt-F8) @History
    • История просмотра и редактирования (Alt-F11) @HistoryViews
    • История смены папок (Alt-F8) @HistoryFolders
  • Ассоциации файлов, и меню "конфликта" ассоциаций @FileAssoc
  • Ссылки на папки @FolderShortcuts
  • Меню фильтров (Ctrl-I) @FiltersMenu
  • Список Экранов (F12) @ScrSwitch
  • Список задач (Ctrl-W) @TaskList
  • Список hotplug-устройств @HotPlugList
  • Меню Языки (нет топика)
  • Список Режимы панели файлов @PanelViewModes
  • Меню выбора кодовой страницы (Shift-F8 в редакторе) @CodePagesMenu
  • Меню Раскраска файлов и группы сортировки @HighlightList
  • Меню выбора плагина (при "конфликте" плагинов) @ChoosePluginMenu
  • Всевозможные плагиновые меню
  • может ещё что пропустил...
А?
DV
Posts: 455
Joined: Mon 07 Aug, 2006 08:23
Has thanked: 31 times
Been thanked: 15 times

Re: Улучшение файла помощи фара

Post by DV »

Упоминание о Ctrl-Alt-F (фильтрация элементов меню) добавлено в следующие разделы справки: @DriveDlg, @UserMenu, @PluginCommands и @PluginsConfig.
http://bugs.farmanager.com/view.php?id=1535
На мой вгляд, этого достаточно. Если же человек ни разу не нажал F1 ни в меню пользователя, ни в меню плагинов, ни в меню настроек плагинов, ни в меню выбора диска, тогда он вряд ли сделает это в каком-то другом меню.
Post Reply

Return to “Обсуждение Far Manager”