Page 1 of 8

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

Posted: Fri 30 Apr, 2010 17:05
by John Doe

Предлагаю в этой теме всем желающим участвовать в улучшении файла помощи фара и стандартных плагинов.

Неполный список мест вообще неосвещённых в справке:
Места, требующие доработки:

Re: Nightly Builds — еженощные сборки

Posted: Sat 08 May, 2010 13:59
by John Doe

Re: Nightly Builds — еженощные сборки

Posted: Sat 08 May, 2010 19:26
by John Doe
В хелпе нет порядка с буквой Ё: где-то употребляется, где-то нет.
Ёфицировал всё.
Попутно исправил пару опечаток.
Дифф прилагается.

Re: Nightly Builds — еженощные сборки

Posted: Sat 08 May, 2010 19:46
by DrKnS
Ёкифицировал всё.
Это замечательно, но дифф надо делать к *.hlf.m4.

Re: Nightly Builds — еженощные сборки

Posted: Sat 08 May, 2010 20:46
by John Doe
Значит после выходных переделаю и положу на мантис.

Re: Nightly Builds — еженощные сборки

Posted: Wed 12 May, 2010 09:05
by ccaid
в b1541 в русский хелп вместе с обилием ё были внесены две опечатки:
плагина --> платина
плагинов --> плагиаторов

Re: Nightly Builds — еженощные сборки

Posted: Wed 12 May, 2010 09:54
by John Doe
ccaid wrote:в b1541 в русский хелп вместе с обилием ё были внесены две опечатки:
плагина --> платина
плагинов --> плагиаторов
На редкость неудобная вещь - FarSpell :oops:

Улучшение справки плагина FarCmds

Posted: Tue 18 May, 2010 11:36
by John Doe


Доделал хелп FarCmds.
Перед отправкой на мантис выкладываю здесь, на случай если найдутся какие неточности.

Изменения по сравнению с предыдущей версией:
  1. В паре мест убрал дублирование информации.
    Главная страница теперь практически полностью помещается на одном экране.
    Вот если бы ещё в хелпе самого фара был раздел о префиксах...
  2. Откорректировал раздел link:.
    Терминология приведена в соответствие с принятой в фаре.
  3. Перекроил раздел "Перехват вывода".
    Теперь он почти в 2 раза короче, без потери информации.
    Можно сократить ещё сильнее, т.к. присутствует дублирование.
  4. Поправлены/добавлены линки.
  5. Все изменения перенёс в FARCmdsEng.hlf.
    Заодно убрал русские букоффки (за перевод не ручаюсь, кто может проверьте)

Re: FarCmds (FAR Commands)

Posted: Tue 18 May, 2010 11:43
by Andrey Budko
Команда #load# позволяет загрузить плагин #имя_DLL_модуля#.

Команда #unload# позволяет загрузить плагин #имя_DLL_модуля#.

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

Posted: Wed 16 Jun, 2010 13:25
by John Doe
Добавил в хелп FarCmds информацию о

В процессе внесены следующие изменения:
  • Разделы goto и whereis объединены, во избежание копипасты.
  • В результате обобщения кое-что пришлось переформулировать, возможно не самым удачным образом (жду предложений по улучшению).
  • Термин Каталог заменён на папку (как в хелпе самого фара).
    Заменён не везде, осталась ещё сама команда "Такой же каталог", и соответствующий ей раздел помощи.
    Как быть с ней? Переименовать и в хелпе, и в lng?
  • Раздел macro "уплотнён", чтобы помещаться на 1 экран.

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

Posted: Wed 16 Jun, 2010 20:34
by Imp_GL
"Выбор плагина" и "Настройка автозавершения" вообще отсутствуют в справке. Где бы про них почитать? Чтобы хоть понять что это за пункты (особенно первый, со вторым более понятно) и что делает каждая настройка в этих пунктах.

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

Posted: Wed 16 Jun, 2010 21:24
by John Doe
В шапке темы под спойлером есть ссылка.
А вообще хелп по "выбору плагина" можно сказать существует: надо взять его из The Underscore, и немного адаптировать.

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

Posted: Tue 27 Jul, 2010 08:38
by John Doe
John Doe wrote:Добавил в хелп FarCmds информацию о нововведениях
...
changelog wrote:

Code: Select all

svs 26.07.2010 10:41:25 +0300 - build 71
...
2. Добавка в хелп (в английском есть русские буковки)
      macro:post < имяфайла
      macro:check < имяфайла
      goto: <имяфайла
2 Skirda
Может всё же как-то объединим усилия?

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

Posted: Tue 27 Jul, 2010 11:22
by Skirda
Я не против.
Я даже за то, чтобы в farcmds унифицировать перенаправлялки. :-)

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

Posted: Thu 19 Aug, 2010 09:25
by John Doe
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 + описание отличий?

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

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