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

Хотите говорить о Far и не знаете, куда обратиться?
User avatar
SlashNet
Posts: 578
Joined: Fri 20 Mar, 2009 09:43
Location: Львов
Has thanked: 3 times

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

Post by SlashNet » Wed 06 Oct, 2010 13:24

Latest post of the previous page:

Вставлю и свои 5 копеек.
В справке о меню пользователя нет упоминания о CtrlUp/CtrlDown.

UPD: Долго сообщение набирал - за меня уже написали
ədиw wo⊥є ʚ o⊥ʎнdəʚədəu əɔʚ

User avatar
John Doe
Бюрократ
Posts: 11421
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 17 times
Been thanked: 101 times

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

Post by John Doe » Wed 06 Oct, 2010 13:27

SlashNet wrote:UPD: Долго сообщение набирал - за меня уже написали
Очень долго, см. дату.
Hint: первый пост на странице это шапка :)

User avatar
SlashNet
Posts: 578
Joined: Fri 20 Mar, 2009 09:43
Location: Львов
Has thanked: 3 times

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

Post by SlashNet » Wed 06 Oct, 2010 13:53

Я туплю...
ədиw wo⊥є ʚ o⊥ʎнdəʚədəu əɔʚ

DV
Posts: 308
Joined: Mon 07 Aug, 2006 08:23
Has thanked: 2 times
Been thanked: 2 times

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

Post by DV » Wed 06 Oct, 2010 18:00

John Doe wrote:Я так думаю правильнее создать специальный раздел для меню, где среди прочего упомянуть и Ctrl-Alt-F.
Если двигаться этим путём, возникает два вопроса, плюс бонусный:
1. Как назвать этот раздел? Нужно какое-то более-менее общее название, в то же время отражающее специфику использования.
2. Как назвать ссылку на этот раздел и в какой форме её упоминать? Вариант "См. также/See also" не подходит, так как многие затрагиваемые разделы справки уже содержат "См. также/See also" со ссылкой на клавиатурные макросы, например.
3. Наконец, для полной определённости нужен полный и окончательный список тех разделов справки, в которые следует добавить ссылку на наш раздел меню.

User avatar
John Doe
Бюрократ
Posts: 11421
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 17 times
Been thanked: 101 times

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

Post by John Doe » Wed 06 Oct, 2010 18:23

DV wrote:1. Как назвать этот раздел? Нужно какое-то более-менее общее название, в то же время отражающее специфику использования.
@MenuCmd
DV wrote:2. Как назвать ссылку на этот раздел и в какой форме её упоминать? Вариант "См. также/See also" не подходит, так как многие затрагиваемые разделы справки уже содержат "См. также/See also" со ссылкой на клавиатурные макросы, например.
Имхо, вполне подходит, только "См. также" надо будет вынести за скобки:

Code: Select all

    См. также:
    - Клавиатурные команды общие ~для всех меню~@MenuCmd@.
    - Cписок ~макроклавиш~@KeyMacroUserMenuList@, доступных в меню пользователя.
DV wrote:3. Наконец, для полной определённости нужен полный и окончательный список тех разделов справки, в которые следует добавить ссылку на наш раздел меню.
Я составил этот список ещё вчера, сегодня дополнил.
Возможность что я что-то пропустил конечно остаётся...

Дополнительно ссылка нужна в @KeyRef и @Index.

P.S.
Сам раздел должен в свою очередь содержать ссылку на @KeyMacroMenuList.

DV
Posts: 308
Joined: Mon 07 Aug, 2006 08:23
Has thanked: 2 times
Been thanked: 2 times

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

Post by DV » Fri 08 Oct, 2010 12:05

FarHlf.12.1.diff - добавлен раздел @MenuCmd и ссылки на него:
http://bugs.farmanager.com/view.php?id=1535

User avatar
John Doe
Бюрократ
Posts: 11421
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 17 times
Been thanked: 101 times

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

Post by John Doe » Fri 08 Oct, 2010 12:14

Косметика:
  1. Неоправданный верхний регистр после двоеточия. Если бы "Клавиатурные команды" начинались с другой строки, то другое дело.

    Code: Select all

    +    См. также: Клавиатурные команды, общие ~для всех меню~@MenuCmd@.
    Мне кажется стоит указывать с новой строки даже если всего один пункт.
  2. А тут наоборот, "список" почему-то с маленькой буквы.

    Code: Select all

    +    См. также:
     
    +    список ~макроклавиш~@KeyMacroUserMenuList@, доступных в меню пользователя.
    +    Клавиатурные команды, общие ~для всех меню~@MenuCmd@.
Кстати, почему вы решили не выделять пункты минусом?

User avatar
Centaur
Posts: 1083
Joined: Tue 05 Apr, 2005 20:09
Location: Novosibirsk, Russia

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

Post by Centaur » Fri 08 Oct, 2010 13:05

John Doe wrote:Кстати, почему вы решили не выделять пункты минусом?
Потому что это неправильно?

Пункты маркированного списка выделяются либо каким-нибудь буллитом (• и подобными), либо, в российской типографской традиции, каким-нибудь тире.

DV
Posts: 308
Joined: Mon 07 Aug, 2006 08:23
Has thanked: 2 times
Been thanked: 2 times

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

Post by DV » Fri 08 Oct, 2010 13:47

John Doe wrote:Неоправданный верхний регистр после двоеточия
Исправил в FarHlf.12.2.diff.
Кстати, я могу удалять предыдущие прикрепленные файлы? Что-то не нашёл, как.
John Doe wrote:Кстати, почему вы решили не выделять пункты минусом?
В разделе @KeyMacro было без минусов.

User avatar
John Doe
Бюрократ
Posts: 11421
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 17 times
Been thanked: 101 times

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

Post by John Doe » Fri 08 Oct, 2010 15:12

Centaur wrote:в российской типографской традиции, каким-нибудь тире.
Я полностью согласен, только вот смысла нет наводить типографику в одном отдельно взятом разделе. Если кто возьмётся поправить во всей документации - тогда да, будет смысл поддерживать.
DV wrote:В разделе @KeyMacro было без минусов.
Да, но там немного другая ситуация: пункты списка выделены за счёт того что каждый от начала и до конца является ссылкой.
А с минусами (которые на самом деле должны быть тире) примеров тоже достаточно, вот первый попавшийся: @CmdLine

Собственно на минусах я не настаиваю, но тогда надо сделать хотя бы отступ.
И я предлагаю все обороты "См. также:" оформить одинаково. С новой строки, даже если в перечислении всего однин пункт.

А "как было" эталоном служить может не всегда, например было "См. так_же".

User avatar
John Doe
Бюрократ
Posts: 11421
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 17 times
Been thanked: 101 times

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

Post by John Doe » Fri 08 Oct, 2010 16:05

1. Патч почему-то не затрагивает раздел @Menus
2. В каждый из разделов @LeftRightMenu @FilesMenu @CmdMenu @OptMenu по-видимому стоит добавить и См. также список ~макроклавиш~@KeyMacroMenuList@, доступных в меню.

DV
Posts: 308
Joined: Mon 07 Aug, 2006 08:23
Has thanked: 2 times
Been thanked: 2 times

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

Post by DV » Fri 08 Oct, 2010 16:34

John Doe wrote:1. Патч почему-то не затрагивает раздел @Menus
Потому что @Menus не является "обычным" меню. Я даже не могу сказать, работают ли в нём хоть какие-то клавиатурный комбинации, кроме "горячих" (подсвеченных) букв.
John Doe wrote:2. В каждый из разделов @LeftRightMenu ...
Так они же все ссылаются на @MenuCmd, который, в свою очередь, ссылается на @KeyMacroMenuList.

И вообще, я устал. Патч для справки предложен, и если я что-то упустил, то, как бы, "исходники открыты".

User avatar
John Doe
Бюрократ
Posts: 11421
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 17 times
Been thanked: 101 times

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

Post by John Doe » Fri 08 Oct, 2010 17:06

DV wrote:Потому что @Menus не является "обычным" меню.
Резон в этом есть, и кстати именно поэтому ссылку на @KeyMacroMenuList тоже надо оттуда переместить в подразделы.
DV wrote:И вообще, я устал.
Теперь вы понимаете почему хелп никто не хочет обновлять :-)
В любом случае, спасибо за то что сделали!

Кто бы теперь аналогичную процедуру проделал для диалогов...

DV
Posts: 308
Joined: Mon 07 Aug, 2006 08:23
Has thanked: 2 times
Been thanked: 2 times

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

Post by DV » Wed 29 Dec, 2010 19:41

John Doe wrote:Кто бы теперь аналогичную процедуру проделал для диалогов...
Я вот смотрю, что результат моих стараний насчёт Ctrl-Alt-F тихо себе пылится на Мантисе... Не очень воодушевляет это на обновление файла помощи, isn't it? ;)

User avatar
John Doe
Бюрократ
Posts: 11421
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 17 times
Been thanked: 101 times

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

Post by John Doe » Wed 29 Dec, 2010 19:53

Ну так вы же не захотели его доделывать.
Не вопрос, доделаю я, только торопить не надо.

Maximus5
Posts: 3292
Joined: Sun 11 Nov, 2007 02:03
Been thanked: 4 times
Contact:

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

Post by Maximus5 » Mon 08 Aug, 2011 21:37

Есть предложение доработать раздел пометки файлов.

Немного форматирования, раздел про мышку.
А еще, я что-то не понял, к чему было вот это
Если ни один файл не выбран, то будет обработан только файл под курсором.
Attachments
FarRus.hlf.110808.diff.7z
(1.35 KiB) Downloaded 122 times

User avatar
Skirda
Posts: 3474
Joined: Wed 16 Mar, 2005 11:01
Been thanked: 1 time

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

Post by Skirda » Tue 09 Aug, 2011 05:08

Maximus5 wrote:Есть предложение доработать раздел пометки файлов.
Wелкам (на мантис)
Maximus5 wrote:А еще, я что-то не понял, к чему было вот это
Если ни один файл не выбран, то будет обработан только файл под курсором.
игра слов "выбран", "выделен", "отмечен", "на нем нажали Ins и он поменял свой цвет", пр...
выделено несколько - они и обработаются
выделил один, курсор сдвинул куда то - обработается выделенный файл
ничего не выделено - файл под курсором
We are the Borg. You will be assimilated.
So Say We All!

Post Reply

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