Вставлю и свои 5 копеек.
В справке о меню пользователя нет упоминания о CtrlUp/CtrlDown.
UPD: Долго сообщение набирал - за меня уже написали
Re: Улучшение файла помощи фара
Posted: Wed 06 Oct, 2010 13:27
by John Doe
SlashNet wrote:UPD: Долго сообщение набирал - за меня уже написали
Очень долго, см. дату. Hint: первый пост на странице это шапка :)
Re: Улучшение файла помощи фара
Posted: Wed 06 Oct, 2010 13:53
by SlashNet
Я туплю...
+1 за раскраску шапок другим цветом (или хотя бы цвет текста менять)
Re: Улучшение файла помощи фара
Posted: Wed 06 Oct, 2010 18:00
by DV
John Doe wrote:Я так думаю правильнее создать специальный раздел для меню, где среди прочего упомянуть и Ctrl-Alt-F.
Если двигаться этим путём, возникает два вопроса, плюс бонусный:
1. Как назвать этот раздел? Нужно какое-то более-менее общее название, в то же время отражающее специфику использования.
2. Как назвать ссылку на этот раздел и в какой форме её упоминать? Вариант "См. также/See also" не подходит, так как многие затрагиваемые разделы справки уже содержат "См. также/See also" со ссылкой на клавиатурные макросы, например.
3. Наконец, для полной определённости нужен полный и окончательный список тех разделов справки, в которые следует добавить ссылку на наш раздел меню.
Re: Улучшение файла помощи фара
Posted: Wed 06 Oct, 2010 18:23
by John Doe
DV wrote:1. Как назвать этот раздел? Нужно какое-то более-менее общее название, в то же время отражающее специфику использования.
@MenuCmd
DV wrote:2. Как назвать ссылку на этот раздел и в какой форме её упоминать? Вариант "См. также/See also" не подходит, так как многие затрагиваемые разделы справки уже содержат "См. также/See also" со ссылкой на клавиатурные макросы, например.
Имхо, вполне подходит, только "См. также" надо будет вынести за скобки:
См. также:
- Клавиатурные команды общие ~для всех меню~@MenuCmd@.
- Cписок ~макроклавиш~@KeyMacroUserMenuList@, доступных в меню пользователя.
DV wrote:3. Наконец, для полной определённости нужен полный и окончательный список тех разделов справки, в которые следует добавить ссылку на наш раздел меню.
Я составил этот список ещё вчера, сегодня дополнил.
Возможность что я что-то пропустил конечно остаётся...
Дополнительно ссылка нужна в @KeyRef и @Index.
P.S.
Сам раздел должен в свою очередь содержать ссылку на @KeyMacroMenuList.
+ См. также:
+ список ~макроклавиш~@KeyMacroUserMenuList@, доступных в меню пользователя.
+ Клавиатурные команды, общие ~для всех меню~@MenuCmd@.
Кстати, почему вы решили не выделять пункты минусом?
Re: Улучшение файла помощи фара
Posted: Fri 08 Oct, 2010 13:05
by Centaur
John Doe wrote:Кстати, почему вы решили не выделять пункты минусом?
Потому что это неправильно?
Пункты маркированного списка выделяются либо каким-нибудь буллитом (• и подобными), либо, в российской типографской традиции, каким-нибудь тире.
Re: Улучшение файла помощи фара
Posted: Fri 08 Oct, 2010 13:47
by DV
John Doe wrote:Неоправданный верхний регистр после двоеточия
Исправил в FarHlf.12.2.diff.
Кстати, я могу удалять предыдущие прикрепленные файлы? Что-то не нашёл, как.
John Doe wrote:Кстати, почему вы решили не выделять пункты минусом?
В разделе @KeyMacro было без минусов.
Re: Улучшение файла помощи фара
Posted: Fri 08 Oct, 2010 15:12
by John Doe
Centaur wrote:в российской типографской традиции, каким-нибудь тире.
Я полностью согласен, только вот смысла нет наводить типографику в одном отдельно взятом разделе. Если кто возьмётся поправить во всей документации - тогда да, будет смысл поддерживать.
DV wrote:В разделе @KeyMacro было без минусов.
Да, но там немного другая ситуация: пункты списка выделены за счёт того что каждый от начала и до конца является ссылкой.
А с минусами (которые на самом деле должны быть тире) примеров тоже достаточно, вот первый попавшийся: @CmdLine
Собственно на минусах я не настаиваю, но тогда надо сделать хотя бы отступ.
И я предлагаю все обороты "См. также:" оформить одинаково. С новой строки, даже если в перечислении всего однин пункт.
А "как было" эталоном служить может не всегда, например было "См. так_же".
Re: Улучшение файла помощи фара
Posted: Fri 08 Oct, 2010 16:05
by John Doe
1. Патч почему-то не затрагивает раздел @Menus
2. В каждый из разделов @LeftRightMenu @FilesMenu @CmdMenu @OptMenu по-видимому стоит добавить и См. также список ~макроклавиш~@KeyMacroMenuList@, доступных в меню.
Re: Улучшение файла помощи фара
Posted: Fri 08 Oct, 2010 16:34
by DV
John Doe wrote:1. Патч почему-то не затрагивает раздел @Menus
Потому что @Menus не является "обычным" меню. Я даже не могу сказать, работают ли в нём хоть какие-то клавиатурный комбинации, кроме "горячих" (подсвеченных) букв.
John Doe wrote:2. В каждый из разделов @LeftRightMenu ...
Так они же все ссылаются на @MenuCmd, который, в свою очередь, ссылается на @KeyMacroMenuList.
И вообще, я устал. Патч для справки предложен, и если я что-то упустил, то, как бы, "исходники открыты".
Re: Улучшение файла помощи фара
Posted: Fri 08 Oct, 2010 17:06
by John Doe
DV wrote:Потому что @Menus не является "обычным" меню.
Резон в этом есть, и кстати именно поэтому ссылку на @KeyMacroMenuList тоже надо оттуда переместить в подразделы.
DV wrote:И вообще, я устал.
Теперь вы понимаете почему хелп никто не хочет обновлять :-)
В любом случае, спасибо за то что сделали!
Кто бы теперь аналогичную процедуру проделал для диалогов...
Re: Улучшение файла помощи фара
Posted: Wed 29 Dec, 2010 19:41
by DV
John Doe wrote:Кто бы теперь аналогичную процедуру проделал для диалогов...
Я вот смотрю, что результат моих стараний насчёт Ctrl-Alt-F тихо себе пылится на Мантисе... Не очень воодушевляет это на обновление файла помощи, isn't it?
Re: Улучшение файла помощи фара
Posted: Wed 29 Dec, 2010 19:53
by John Doe
Ну так вы же не захотели его доделывать.
Не вопрос, доделаю я, только торопить не надо.
Re: Улучшение файла помощи фара
Posted: Mon 08 Aug, 2011 21:37
by Maximus5
Есть предложение доработать раздел пометки файлов.
@SelectFiles
$ #Пометка файлов#
Для обработки файлов и папок ~панели файлов~@FilePanel@ они могут быть
выбраны несколькими различными способами.
#Пометка с клавиатуры#
#Ins# помечает или снимает пометку с файла под курсором и перемещает курсор вниз,
#Shift-Клавиши курсора# позволяют перемещать курсор в различных направлениях.
#Gray +# и #Gray -# выбирают и снимают пометку с группы с использованием
одной или нескольких разделённых запятыми ~масок файлов~@FileMasks@. #Gray *#
инвертирует текущую пометку.
#Ctrl-<Gray +># и #Ctrl-<Gray -># выбирают и снимают пометку со всех
файлов с тем же расширением, что и у файла под курсором.
#Alt-<Gray +># и #Alt-<Gray -># выбирают и снимают пометку со всех файлов
с тем же именем, что и у файла под курсором.
#Ctrl-<Gray *># инвертирует текущую пометку, включая папки. Если параметр
#Пометка папок# в диалоге ~Настроек панели~@PanelSettings@ включена, это
работает аналогично #Gray *#.
#Shift-<Gray +># и #Shift-<Gray -># выбирают и снимают пометку со всех
файлов.
#Ctrl-M# (#Восстановить пометку#) восстанавливает предыдущую
выделенную группу.
#Пометка мышью#
#Щелчек правой кнопки мыши# помечает или снимает пометку с файла под
курсором мыши.
Если щелкнуть правой кнопкой мыши над списком файлов (строка
с заголовками колонок) или под списком файлов (статусная область) то при
удерживании правой кнопкой мыши список файлов будет прокручиваться вверх
или вниз помечая или снимая пометку с файлов, по которым пробегает курсор.
Действие (пометка или снятие пометки) соответствует состоянию файла под
курсором до начала прокрутки.
Немного форматирования, раздел про мышку.
А еще, я что-то не понял, к чему было вот это
Если ни один файл не выбран, то будет обработан только файл под курсором.