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

Хотите говорить о Far и не знаете, куда обратиться?
Shmuel
Posts: 6167
Joined: Thu 23 Mar, 2006 21:36
Location: Israel
Has thanked: 31 times
Been thanked: 330 times

Используемая терминология

Post by Shmuel »

Latest post of the previous page:

Воспользуюсь затронутой тематикой, чтобы поднять вопрос, который меня гораздо больше интересует: мануалы на английском (luafar_manual.chm и macroapi_manual.en.chm). Там должен быть непочатый край для замечаний и правок.

Если уважаемый NightRoman и другие форумчане, хорошо знающие английский, поучаствуют в улучшении этих мануалов, буду очень признателен.
Last edited by Shmuel on Thu 01 Jan, 1970 01:00, edited 0 times in total.
Reason: Добавлена ссылка на исходную тему
User avatar
John Doe
Бюрократ
Posts: 12897
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 38 times
Been thanked: 296 times

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

Post by John Doe »

  • @PanelSettings
    Не описана опция [x] Правый клик помечает файлы
  • @SelectFiles
    Описывается пометка мышью, но не указано, что эта функция сейчас по умолчанию отключена, и зависит от настройки панели: [x] Правый клик помечает файлы.
  • И есть ещё одна недокументированная фича: левая кнопка мыши, нажатая (или отпущенная) после нажатия правой — инвертирует действие.
    (Не знаю насколько эта фича востребована, но в документации о ней ни слова)
User avatar
John Doe
Бюрократ
Posts: 12897
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 38 times
Been thanked: 296 times

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

Post by John Doe »

@FastFind
В английской справке (hlf:FarEng.hlf @FastFind) отсталось упоминание о TechInfo #10
Необходимо заменить TechInfo##10 на ~XLat.Flags~@XLat.Flags@.

Update
Однако в этом месте есть проблема и в русской справке!
Сказано: Подробнее о назначении клавиш для транслитерации см. XLat.Flags.
Но по ссылке ведь ни слова о клавишах!

Предлагаю вообще убрать из этого раздела упоминание об XLat
В других местах, где функция XLat намного более полезна - упоминаний нет.

Вероятно нужно выделить какой-то раздел в справке, но уж точно не в @FastFind.
User avatar
John Doe
Бюрократ
Posts: 12897
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 38 times
Been thanked: 296 times

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

Post by John Doe »

В WhatsNew.Rus.txt их Far 1.7 оказывается можно найти множество ньюансов, не отражённых в справке. Исправлено
Например:

Code: Select all

[+] В команде "Копирование текста с экрана (Alt-Ins)" добавлено управление:
    Ctrl-Shift-Left/Ctrl-Shift-Right - перемещение с выделением на 10 позиций
    по горизонтали,
    Ctrl-Shift-Up/Ctrl-Shift-Down - перемещение с выделением на 5 позиций
    по вертикали.
P.S.
И кстати, неплохо бы из граббера по F1 вызывать справку (если возможно)
Обсуждение
User avatar
John Doe
Бюрократ
Posts: 12897
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 38 times
Been thanked: 296 times

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

Post by John Doe »

@MsWheel

Code: Select all

Меню            Прокрутка колеса аналогична действию клавиш
                Up/Down.[...]
Это неверно.

Code: Select all

                [...]Можно выбирать пункты, не двигая
курсор.
Это непонятно что значит.

Code: Select all

Панели          Прокрутка списка при неизменной позиции курсора
                на экране.
...
Редактор        Прокрутка текста с постоянным позиционированием
                курсора.
Это не работает для горизонтальной прокрутки.
User avatar
John Doe
Бюрократ
Posts: 12897
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 38 times
Been thanked: 296 times

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

Post by John Doe »

P.S.
И да, в последних двух случаях почему-то употребляются 2 разных оборота "неизменная позиция курсора" и "постоянное позиционирование курсора".
Это абсолютно не добавляет ясности.
Особенно учитывая тот, что позиция постоянна не сама по себе (как можно было предположить), а относительно границ окна, что вообще-то требует уточнения.
(Есть тикет об изменении этого поведения, но это долгая история, и для начала неплохо бы документировать уже имеющееся)
User avatar
John Doe
Бюрократ
Posts: 12897
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 38 times
Been thanked: 296 times

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

Post by John Doe »

В справке не описана функция выделения текста с помощью двух кликов мыши (экспериментально, с билда 4260).
Last edited by John Doe on Thu 01 Nov, 2018 13:53, edited 1 time in total.
User avatar
Skirda
Posts: 3475
Joined: Wed 16 Mar, 2005 11:01
Been thanked: 4 times

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

Post by Skirda »

@CmdLine
...
Пример: far arc:c:\\Far20.7z "macro:post msgbox('Far Manager','Successfully started')"
We are the Borg. You will be assimilated.
So Say We All!
User avatar
John Doe
Бюрократ
Posts: 12897
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 38 times
Been thanked: 296 times

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

Post by John Doe »

В редакторе конфигурации многие параметры отображаются с логическим значением (true/false), но в справка к некоторым из них всё ещё оперирует числовыми (0,1).

Editor.BSLikeDel
Editor.AllowEmptySpaceAfterEof
Confirmations.EscTwiceToInterrupt
Interface.AltF9
Interface.ShiftsKeyRules
Panel.Layout.ScrollbarMenu
Panel.CtrlFRule
Panel.ShellRightLeftArrowsRule
System.Executor.RestoreCP
System.Executor.UseAppPath
System.CmdHistoryRule
System.Executor.FullTitle
User avatar
John Doe
Бюрократ
Posts: 12897
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 38 times
Been thanked: 296 times

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

Post by John Doe »

@Interface.DelHighlightSelected
Справка нуждается в переработке (Interface.DelHighlightSelected и Interface.DelShowSelected)
User avatar
John Doe
Бюрократ
Posts: 12897
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 38 times
Been thanked: 296 times

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

Post by John Doe »

  • Список автодополнения сейчас не имеет собственной справки, и его клавиатурные команды нигде не описаны (кроме как исходниках)
  • @AutoCompleteSettings
    - Опечатка: "принимаеть"
    - не указан Interface.Completion.UseEnvironment
    - все 4 параметра (Interface.Completion.Use*) по хорошему нуждаются хотя бы в кратком описании.
    - [x] Модальный режим нуждается в понятном описании (хотя необходимость такого для меня вообще под вопросом, может быть стоит заменить опцию на макрос)
    - Собственно включение автодополнения осуществляется в 2х других местах, поэтому тут стоит сослаться на @DialogSettings и @CmdlineSettings
  • @DialogSettings
    Сказано: При отключённой опции для автозавершения строк можно воспользоваться комбинацией клавиш Ctrl-End.
    Должно быть: Ctrl-Space
    (Ctrl-End тоже стоит упомянуть)
  • @CmdlineSettings
    Ctrl-End тоже стоит упомянуть
DV
Posts: 437
Joined: Mon 07 Aug, 2006 08:23
Has thanked: 23 times
Been thanked: 15 times

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

Post by DV »

Из FAR3 выпилили всю панель дерева, а в справке она (Tree panel/Дерево папок) осталась.
Или есть ещё надежда на реинкарнацию панели дерева в виде _динамического_ дерева папок (как в Windows Explorer)?
2useven10
Posts: 4114
Joined: Mon 07 Sep, 2009 10:40
Has thanked: 5 times
Been thanked: 194 times

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

Post by 2useven10 »

Пока только отключили по умолчанию, через far:config можно включить.
User avatar
HaRT
Moderator
Posts: 9601
Joined: Tue 30 Aug, 2005 17:21
Location: Санкт-Петербург
Has thanked: 114 times
Been thanked: 233 times

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

Post by HaRT »

DV wrote: Или есть ещё надежда на реинкарнацию
Обсуждение по существу перенесено: http://forum.farmanager.com/viewtopic.p ... 69#p132769
См. тж. http://bugs.farmanager.com/view.php?id=27
Фар есть инструмент, а не нянька. © 2009 DrKnS
buniak_a_h
Posts: 2130
Joined: Sat 20 Apr, 2013 00:17
Location: Питер
Has thanked: 131 times
Been thanked: 211 times
Contact:

Параметры командной строки

Post by buniak_a_h »

  1. Имеется несоответствие хелпа и поведения ФАР при указании файла в качестве параметра командной строки.
    FarRus.hlf wrote:для файлов - произойдёт переход в каталог с файлом и позиционирование на указанный файл, если он существует;
    На самом деле если в ассоциации файла указано действие по PgDn, то выполняется указанное действие. Надо либо исправить поведение ФАРа, либо скорректировать хелп
  2. В FarRus.hlf необходимо отметить тот факт, что каталоги надо указывать без заключительного слэша (возможно, только в том случае, если имя каталога заьрано в кавычки). В противном случае поведение менеджера логикой не объяснить: с одной стороны, как будто заключительный слэш "экранирует" закрывающую кавычку, с другой - дублирование слэшей в командной строке не требуется.
Сказанное относится к ФАР версии 3.0.4732, ОС Windows XP SP2
Программировать просто. Знай, жми себе на кнопочки... © Владелец IT-компании
Post Reply

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