Page 2 of 9

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

Posted: Thu 19 Aug, 2010 09:41
by Skirda

Latest post of the previous page:

Я думал об этом, но...
Возможно ты прав, но обязательно 51.7% юзеров (даже из-за вредности) начнут трещать о том, что N (и пр.отсутствующие колонки) не работают.
Так что пусть это останется как есть - в виде почти двух одинаковых частей...
Просто ссылку дать все равно не получится, ибо там "панели", а здесь "результаты поиска" - это еще больше запутает те самые 51.7% контингента.

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

Posted: Thu 19 Aug, 2010 09:56
by John Doe
Skirda wrote:Просто ссылку дать все равно не получится, ибо там "панели", а здесь "результаты поиска"
А что помешает?

Code: Select all

Можно использовать почти все #типы колонок# что и в ~Панелях~@PanelViewModes@, за исключением N и т. п...
Skirda wrote:...это еще больше запутает те самые 51.7% контингента.
А как же оставшиеся 48,3%? Я вот чуть глаза не поломал открывая попеременно оба раздела ;)

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

Posted: Thu 19 Aug, 2010 10:22
by Skirda
John Doe wrote:
Skirda wrote:...это еще больше запутает те самые 51.7% контингента.
А как же оставшиеся 48,3%? Я вот чуть глаза не поломал открывая попеременно оба раздела ;)
А ты так не делай, а то процент первых увеличится :twisted:

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

Posted: Fri 24 Sep, 2010 08:49
by Skirda
DV wrote:Перерыл всю справку по FAR - ну нету там упоминания о Ctrl-Alt-F для фильтрации меню, нету! Почему??
Сделай патч для FarEng.hlf.m4 и FarRus.hlf.m4, опубликуй на мантисе... тогда будет :)
DV wrote:Я вот подумал, а есть ли другие недокументированные сочетания клавиш или возможности FAR?
Вполне возможно...
DV wrote:В частности, нашёл ещё вот что: Энциклопедия FAR в разделе Макроязык, Функции вообще не упоминает CallPlugin. Откуда же можно узнать, что такая функция вообще существует?
Это эксперементальная функция...

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

Posted: Fri 24 Sep, 2010 09:00
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... В любом случае описание нужно - иначе такой функции как будто просто нет. И добавить: "экспериментальная функция".

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

Posted: Fri 24 Sep, 2010 10:45
by John Doe
Странная позиция: что такое .m4 знать вы не хотите, но считаете что все должны мигом выполнять ваши пожелания?
Поглядите в шапку, там много чего в хелпе не хватает.
Хотите помочь - помогайте.
А ваши отрывочные реплики - это не помощь

P.S.
На форуме есть тема Энциклопедия: улучшение раздела о макросах.
Добавление callplugin() лучше обсуждать там.
Кстати ещё одно экспериментальное свойство неописанное в Энциклопедии: Dlg.Info.Id

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

Posted: Tue 05 Oct, 2010 11:03
by DV
John Doe wrote:что такое .m4 знать вы не хотите
А с помощью чего делать .diff файл? С этим справится WinMerge или нужно что-то специфическое?

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

Posted: Tue 05 Oct, 2010 11:20
by John Doe
Справится.
А если у вас есть svn-клиент, то можно (и рекомендуется) с его помощью.
Можно и консольным diff'ом (обсуждалось).

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

Posted: Tue 05 Oct, 2010 12:13
by DV
Касательно кусочка документации по Ctrl-Alt-F (фильтрация элементов меню) получается что-то такое (см. вложенный файл).
Далее порядок сходный с этим? - http://bugs.farmanager.com/view.php?id=1367

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

Posted: Tue 05 Oct, 2010 12:29
by John Doe
+ #Ctrl-Alt-F# - фильтрация элементов меню (работает во всех меню,
+ комбах и листбоксах).
Кто такие комбы наука не знает.
А листбоксы и комбобоксы нежелательны, т.к. неразработчику эти термины непонятны.

Собственно и "фильтрация элементов меню" сама по себе требует объяснения, думаю надо создать отдельный раздел, а во всех (в вашем варианте двух) местах достаточно будет просто сослаться.

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

Posted: Tue 05 Oct, 2010 14:59
by DV
John Doe wrote:Кто такие комбы наука не знает.
Есть такое :) Исправил на "выпадающие списки" - вроде, общепринятый термин.
John Doe wrote:Собственно и "фильтрация элементов меню" сама по себе требует объяснения
Увольте - это, право же, не ко мне... Сочинения на тему "И вот сейчас в меню появятся квадратные скобки, в которых будут показаны введенные вами буквы, отфильтровывающие пункты меню..." - не мой конёк.

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

Posted: Tue 05 Oct, 2010 15:19
by John Doe
"Выпадающий список" это правильно, в других местах хелпа он именно так именуется.

Правда для того, кто только знакомиться с фаром будет совершенно неясно откуда эти списки вообще могут "выпадать"...
Да и сами эти списки тоже нуждаются в собственном хелпе.
Увольте - это, право же, не ко мне... Сочинения на тему "И вот сейчас в меню появятся квадратные скобки, в которых будут показаны введенные вами буквы, отфильтровывающие пункты меню..." - не мой конёк.
Вот все так говорят, и никто не улучшает хелп.

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

Posted: Tue 05 Oct, 2010 15:55
by zg
John Doe wrote:Вот все так говорят, и никто не улучшает хелп.
а смысл? всё равно никто не читает.

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

Posted: Tue 05 Oct, 2010 16:42
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
  • Всевозможные плагиновые меню
  • может ещё что пропустил...
А?

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

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

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

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

Если поглядеть на раздел @KeyRef, то обнаруживается, что вообще отсутствует отдельный раздел с перечнем Клавиатурных команд общих для всех меню (кстати диалоги тоже не представлены отдельным разделом, хотя некоторые команды и перечислены в @MiscCmd).

Я так думаю правильнее создать специальный раздел для меню, где среди прочего упомянуть и Ctrl-Alt-F.
А во всех вышеперечисленных разделах добавить ссылку "См. также клавиатурные команды общие для всех меню".

P.S.
Есть раздел @KeyMacroMenuList, но ссылка на него дана только в индексе, что в корне неправильно.