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

Хотите говорить о Far и не знаете, куда обратиться?
User avatar
HaRT
Moderator
Posts: 11458
Joined: Tue 30 Aug, 2005 17:21
Has thanked: 270 times
Been thanked: 417 times

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

Post by HaRT »

Latest post of the previous page:

John Doe wrote:чем отличается Ins и Shift+Ins я не смог определить
Это больше похоже на баг. Удобно было бы, чтобы ShiftIns вставлял из буфера обмена.
Фар есть инструмент, а не нянька. © 2009 DrKnS
User avatar
HaRT
Moderator
Posts: 11458
Joined: Tue 30 Aug, 2005 17:21
Has thanked: 270 times
Been thanked: 417 times

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

Post by HaRT »

Несколько пожеланий по Справке меню Историй:
1. На странице «История смены папок» не хватает заключительной фразы «См. также: клавиатурные команды, общие для всех меню.» (у двух других историй она есть).
2. Со всех трёх страниц про Истории пора убрать предложение про „использовать подсвеченные буквы“, т.к. никакие буквы уже не подсвечиваются.
3. На всех трёх страницах про Истории хорошо бы исправить пару мелочей:
 3.а. опечатку (пропущена ‘а’): „Установить/снять пометку блокировки пункт[а] истории“;
 3.б. ошибку (пропущена запятая): „Копировать содержимое текущей позиции истории | в Буфер Обмена[,] не закрывая списка“.
Фар есть инструмент, а не нянька. © 2009 DrKnS
User avatar
John Doe
Бюрократ
Posts: 14582
Joined: Wed 27 Apr, 2005 20:42
Location: github.com/FarManagerLegacy
Has thanked: 92 times
Been thanked: 514 times
Contact:

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

Post by John Doe »

[x] Поддержка OEM-плагинов
Надо бы указать, что действует не сразу, а после перезагрузки
User avatar
John Doe
Бюрократ
Posts: 14582
Joined: Wed 27 Apr, 2005 20:42
Location: github.com/FarManagerLegacy
Has thanked: 92 times
Been thanked: 514 times
Contact:

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

Post by John Doe »

@PanelSettings
[x] Показывать строку статуса
В справке не объясняется что собой представляет строка статуса.
Отдельно стоит упомянуть, что статусная строка отделяется одинарной рамкой.
При наличии выделения на этой рамке отображается суммарная информация о выделении, а при отключённой строке статуса эта информация отображается на нижней двойной рамке, перекрывая информацию, двух пунктов, о которых речь ниже:

[x] Показывать суммарную информацию
В справке лучше конкретезировать, что речь идёт о количестве файлов и их суммарном объёме.

[x] Показывать свободное место
В справке не указано, что свободное место отображается на нижней рамке.
Shmuel
Posts: 7244
Joined: Thu 23 Mar, 2006 21:36
Location: Israel
Has thanked: 48 times
Been thanked: 636 times

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

Post by Shmuel »

Воспользуюсь затронутой тематикой, чтобы поднять вопрос, который меня гораздо больше интересует: мануалы на английском (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: 14582
Joined: Wed 27 Apr, 2005 20:42
Location: github.com/FarManagerLegacy
Has thanked: 92 times
Been thanked: 514 times
Contact:

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

Post by John Doe »

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

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

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: 14582
Joined: Wed 27 Apr, 2005 20:42
Location: github.com/FarManagerLegacy
Has thanked: 92 times
Been thanked: 514 times
Contact:

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

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: 14582
Joined: Wed 27 Apr, 2005 20:42
Location: github.com/FarManagerLegacy
Has thanked: 92 times
Been thanked: 514 times
Contact:

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

Post by John Doe »

@MsWheel

Code: Select all

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

Code: Select all

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

Code: Select all

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

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

Post by John Doe »

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

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

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: 3474
Joined: Wed 16 Mar, 2005 11:01
Been thanked: 8 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: 14582
Joined: Wed 27 Apr, 2005 20:42
Location: github.com/FarManagerLegacy
Has thanked: 92 times
Been thanked: 514 times
Contact:

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

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: 14582
Joined: Wed 27 Apr, 2005 20:42
Location: github.com/FarManagerLegacy
Has thanked: 92 times
Been thanked: 514 times
Contact:

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

Post by John Doe »

@Interface.DelHighlightSelected
Справка нуждается в переработке (Interface.DelHighlightSelected и Interface.DelShowSelected)
User avatar
John Doe
Бюрократ
Posts: 14582
Joined: Wed 27 Apr, 2005 20:42
Location: github.com/FarManagerLegacy
Has thanked: 92 times
Been thanked: 514 times
Contact:

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

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 тоже стоит упомянуть
Post Reply

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