From 0bbda2d756316b985c0af7c1259ca0205f9179ee Mon Sep 17 00:00:00 2001 From: akruphi <92621645+akruphi@users.noreply.github.com> Date: Fri, 5 Apr 2024 23:55:26 +0300 Subject: [PATCH] Help: Far2lGettingStarted - actualization & remove obsolete after recently accepted PRs --- far2l/bootstrap/scripts/FarEng.hlf.m4 | 24 ++++++++++-------------- far2l/bootstrap/scripts/FarRus.hlf.m4 | 26 +++++++++++--------------- 2 files changed, 21 insertions(+), 29 deletions(-) diff --git a/far2l/bootstrap/scripts/FarEng.hlf.m4 b/far2l/bootstrap/scripts/FarEng.hlf.m4 index a8ff605e..d022483f 100644 --- a/far2l/bootstrap/scripts/FarEng.hlf.m4 +++ b/far2l/bootstrap/scripts/FarEng.hlf.m4 @@ -131,15 +131,20 @@ $ # FAR2L features - Getting Started# #UI Backends# FAR2L has 3 base UI Backends (see details in ~UI backends~@UIBackends@): - #GUI#: uses wxWidgets, works in graphics mode, ideal UX, requires a lot of X11 dependencies; - - #TTY|Xi#: works in terminal mode, requires a dependency on pair X11 libraries (to access clipboard and to get state of keyboard modifiers), almost perfect UX; - - #TTY#: plain terminal mode, no X11 dependencies, UX with some restrictions (works fully when running in the relevant terminal emulators, using their advanced keyboard-protocols, see list below). + - #TTY|Xi#: works in terminal mode, requires a dependency on pair X11 libraries +(to access clipboard and to get state of all keyboard modifiers), almost perfect UX; + - #TTY|X#: works in terminal mode, uses X11 to access clipboard, all keyboard works via terminal; + - #TTY#: plain terminal mode, no X11 dependencies, UX with some restrictions +(works fully when running in the terminal emulators, +which provide clipboard access and has their advanced keyboard-protocols, see list below). You can see FAR2L version and currently used backend in window title or by ~pseudo-command~@SpecCmd@ #far:about#. - Wayland has security restriction for data access via X11; for full functionality run FAR2L-GUI in #xWayland# mode (see below). + #TTY|Xi# does not work under Wayland due to Wayland's security restriction, +when it starts, far2l switches to #TTY|X# without i. Far2l running and selecting backend: - if you have FAR2L-GUI installed, then when you run FAR2L it will try to use GUI mode; - to force run in terminal mode TTY|Xi use in command line: #far2l --tty#; - - to force run in terminal mode TTY|X use in command line: #far2l --tty --nodetect=xi#; - - to force run in plain mode TTY use in command line: #far2l --tty --nodetect --ee#; + - to force run in terminal mode TTY|X use in command line: #far2l --tty --nodetect=xi --ee#; + - to force run in plain mode TTY use in command line: #far2l --tty --nodetect=x --ee#; - run FAR2L-GUI from command line in background without blocking terminal: #far2l --notty &# (see details in ~Command line switches~@CmdLine@ or #far2l --help#). @@ -149,15 +154,6 @@ $ # FAR2L features - Getting Started# Terminal emulators also do not often pass some of the key combinations to applications, or do not distinguish pressing various combinations of modifiers (#Ctrl#, #Alt# etc.). - #FAR2L within Wayland or within WSL+WSLg (fix clipboard and/or some keys processing in FAR2L-GUI/TTY|X)# - FAR2L (GUI and TTY|X modes) uses X11 features to work with the clipboard and get extended keyboard shortcuts that due to security restrictions, do not work properly in plain Wayland. - For adequate work FAR2L GUI in Wayland it helps to start FAR2L in mode #xWayland# by setting the environment variable #GDK_BACKEND=x11#: - - running from console: #GDK_BACKEND=x11 far2l#; - - inside desktop entry #/usr/share/applications/far2l.desktop# replace #Exec=far2l# with #Exec=env GDK_BACKEND=x11 far2l# - For applications running in a terminal emulator, xWayland mode does not provide full access, and the advice is to run the TTY or only TTY|X backend: - - forced non-use of X11 extended keys features when running in the console: #far2l --tty --nodetect=xi# - - #macOS workaround# if far2l in macOS regularly asks permission to folders After command #sudo codesign --force --deep --sign - /Applications/far2l.app# it is enough to confirm permission only once. diff --git a/far2l/bootstrap/scripts/FarRus.hlf.m4 b/far2l/bootstrap/scripts/FarRus.hlf.m4 index cb54489f..014735a9 100644 --- a/far2l/bootstrap/scripts/FarRus.hlf.m4 +++ b/far2l/bootstrap/scripts/FarRus.hlf.m4 @@ -135,15 +135,20 @@ $ # Особенности FAR2L - начало работы# #Режимы интерфейса# У FAR2L три основных бекенда отрисовки (подробности в ~Режимы интерфейса~@UIBackends@): - #GUI# - на базе wxWidgets, работает в графическом режиме, идеальный UX, куча X11 зависимостей; - - #TTY|Xi# - работает в терминальном режиме, зависимости буквально от пары иксовых либ (для поддержки всех-всех сочетаний клавиш и буфера обмена), почти идеальный UX; - - #TTY# - чистый терминальный режим, никаких иксовых зависимостей, UX с некоторыми ограничениями (полноценно работает при запуске в соответствующих эмуляторах терминалов, используя их расширенные возможности передачи клавиш, см. список ниже). + - #TTY|Xi# - работает в терминальном режиме, зависимости буквально от пары иксовых либ +(для поддержки буфера обмена и всех-всех сочетаний клавиш в окружениях X11), почти идеальный UX; + - #TTY|X# - работает в терминальном режиме, через X11 поддержка буфера обмена, клавиатура через возможности терминала; + - #TTY# - чистый терминальный режим, никаких иксовых зависимостей, UX с некоторыми ограничениями +(полноценно работает при запуске в эмуляторах терминалов, +предоставляющих возможность доступа к буферу обмена и расширенную информацию о клавиатурных событиях, см. список ниже). Версию FAR2L и используемый бекенд можно увидеть в заголовке окна или через ~псевдо-команду~@SpecCmd@ #far:about#. + #TTY|Xi# не работает под Wayland из-за модели безопасности Wayland, при его запуске far2l переключается на #TTY|X# без i. В Wayland получение данных через X11 ограничено; для полноценной работы запускайте FAR2L-GUI в режиме #xWayland# (см. ниже). Запуск far2l и выбор бекенда: - - если у Вас установлена версия GUI, то при запуске будет пытаться использоваться она; + - если у Вас установлена версия с собранным GUI бекендом, будет использоваться он; - для принудительного запуска терминального варианта TTY|Xi используйте в командной строке: #far2l --tty#; - - для принудительного запуска терминального варианта TTY|X используйте в командной строке: #far2l --tty --nodetect=xi#; - - для принудительного запуска минимального варианта TTY используйте в командной строке: #far2l --tty --nodetect --ee#; + - для принудительного запуска терминального варианта TTY|X используйте в командной строке: #far2l --tty --nodetect=xi --ee#; + - для принудительного запуска минимального варианта TTY используйте в командной строке: #far2l --tty --nodetect=x --ee#; - фоновый запуск FAR2L-GUI из командной строки без блокировки терминала: #far2l --notty &# (подробнее про ключи запуска в ~Параметры командной строки~@CmdLine@ или #far2l --help#). @@ -153,16 +158,7 @@ $ # Особенности FAR2L - начало работы# Эмуляторы терминалов также часто не передают запущенным в них консольным приложениям часть комбинаций клавиш, или не различают нажатие различных комбинаций модификаторов (#Ctrl#, #Alt# и т.п.). - #Особенности под Wayland или под WSL+WSLg (при проблемах с буфером обмена и/или комбинациями клавиш в FAR2L-GUI/TTY|X)# - FAR2L (режимы GUI и TTY|X) для работы с буфером обмена и получения расширенных сочетаний клавиш использует возможности X11, которые из соображений безопасности ограничены в чистом Wayland'е. - Для адекватной работы FAR GUI в Wayland помогает запустить в режиме #xWayland#, указав переменную среды #GDK_BACKEND=x11#: - - запуск из консоли: #GDK_BACKEND=x11 far2l#; - - внутри ярлыка #/usr/share/applications/far2l.desktop# заменить #Exec=far2l# на #Exec=env GDK_BACKEND=x11 far2l# - При запуске в эмуляторе терминала режим xWayland не даёт полноценного доступа и тут совет запускать бекенд TTY или только TTY|X: - - принудительное неиспользование расширенных клавиатурных возможностей X11 при запуске в консоли: #far2l --tty --nodetect=xi# - - - #Костыль для macOS#, если far2l в macOS рагулярно запрашивает доступ к папкам + #Решение для macOS#, если far2l регулярно запрашивает доступ к папкам После команды #sudo codesign --force --deep --sign - /Applications/far2l.app# достаточно один раз предоставить разрешение. -- 2.11.4.GIT