diff --git a/CMakeLists.txt b/CMakeLists.txt
index 26e891a17..9673ad5d8 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -145,8 +145,8 @@ endif()
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wall -fPIC -Wno-unused-function -D_FILE_OFFSET_BITS=64") # -fsanitize=address
set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wall -std=c99 -fPIC -Wno-unused-function -D_FILE_OFFSET_BITS=64") # -fsanitize=address
-set(CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS} -O2")
-set(CMAKE_C_FLAGS_RELEASE "${CMAKE_C_FLAGS} -O2")
+set(CMAKE_CXX_FLAGS_RELEASE "-O2")
+set(CMAKE_C_FLAGS_RELEASE "-O2")
if(${CMAKE_SYSTEM_NAME} MATCHES "Darwin")
set(APP_DIR ${CMAKE_BINARY_DIR}/install)
diff --git a/HACKING.md b/HACKING.md
index 6e8a1613f..2e4987755 100644
--- a/HACKING.md
+++ b/HACKING.md
@@ -83,10 +83,10 @@ far2l uses this to resolve symlink destination when user selects plugin's item t
### Added following dialog messages:
* `DM_SETREADONLY` - changes readonly-ness of selected dialog edit control item
-* `DM_GETCOLOR` - retrieves current color attributes of selected dialog item
-* `DM_SETCOLOR` - changes current color attributes of selected dialog item
-* `DM_SETTRUECOLOR` - sets 24-bit RGB colors to selected dialog item, can be used within DN_CTLCOLORDLGITEM handler to provide extra coloring.
-* `DM_GETTRUECOLOR` - retrieves 24-bit RGB colors of selected dialog item, if they were set before by DM_SETTRUECOLOR.
+* `DM_GETDEFAULTCOLOR`
+* `DM_GETCOLOR = DM_SETTRUECOLOR` - sets 24-bit RGB colors to selected dialog item (see DN_CTLCOLORDLGITEM).
+* `DM_SETCOLOR = DM_GETTRUECOLOR` - retrieves 24-bit RGB colors of selected dialog item.
+* `DM_SETTEXTPTRSILENT`
* `ECTL_ADDTRUECOLOR` - applies coloring to editor like ECTL_ADDCOLOR does but allows to specify 24 RGB color using EditorTrueColor structure.
* `ECTL_GETTRUECOLOR` - retrieves coloring of editor like ECTL_GETCOLOR does but gets 24 RGB color using EditorTrueColor structure.
diff --git a/README.md b/README.md
index 0c17fc6ab..5bec59e92 100644
--- a/README.md
+++ b/README.md
@@ -22,6 +22,15 @@ FreeBSD/MacOS (Cirrus CI): [
+usually exclusively used in desktop environment GNOME, KDE, Xfce, macOS etc. and in terminal emulators.
+To work with these keys in far2l you need to _release keyboard shortcuts globally_
+in the environment settings (see [#2326](https://github.com/elfmz/far2l/issues/2326))
+or use far2l lifehacks:
+_Sticky controls via **Ctrl**-**Space** or **Alt**-**Space**_ or _Exclusively handle hotkeys option in the Input settings_
+(see details in buil-in far2l help).
+
### UI Backends
FAR2L has base UI Backends (see details in build-in help section **UI backends**):
@@ -42,11 +51,11 @@ FreeBSD/MacOS (Cirrus CI): [
via wxWidgets |
| **Binaries:** | far2l | far2l
far2l_ttyx.broker | far2l
far2l_ttyx.broker | far2l
far2l_gui.so |
| **[Dependencies](#required-dependencies):** | minimal | + libx11 | + libx11, libxi | + wxWidgets, GTK |
-| **Keyboard:** | _Typical terminals_:
**only essential
key combinations**
_KiTTY_ (putty fork),
_kitty_ (*nix one),
_iTerm2_,
_Windows Terminal_,
far2l’s VT: **full support** | _Typical terminals_:
**only essential
key combinations**
_KiTTY_ (putty fork),
_kitty_ (*nix one),
_iTerm2_,
_Windows Terminal_,
far2l’s VT: **full support** | _Typical terminals_:
**most of key
combinations under x11**;
**only essential key
combinations
under Wayland**
_KiTTY_ (putty fork),
_kitty_ (*nix one),
_iTerm2_,
_Windows Terminal_,
far2l’s VT: **full support** | **All key
combinations** |
-| **Clipboard
access:** | _Typical terminals_:
via command line
tools like xclip
_kitty_ (*nix one),
_iTerm2_:
via **OSC52**
_Windows Terminal_:
via **OSC52**
or via **command line
tools under WSL**
_KiTTY_ (putty fork),
far2l’s VT:
via **far2l extensions** | _Typical terminals_,
_kitty_ (*nix one):
via **x11 interaction**
_iTerm2_:
via **OSC52**
_Windows Terminal_:
via **OSC52**
or via **command line
tools under WSL**
_KiTTY_ (putty fork),
far2l’s VT:
via **far2l extensions** | _Typical terminals_,
_kitty_ (*nix one):
via **x11 interaction**
_iTerm2_:
via **OSC52**
_Windows Terminal_:
via **OSC52**
or via **command line
tools under WSL**
_KiTTY_ (putty fork),
far2l’s VT:
via **far2l extensions** | via
**wxWidgets API**
via command line
tools under WSL |
-| **Typical
use case:** | **Servers**,
embedded
(*wrt, etc) | Run far2l in
favorite terminal
but with
**better UX** | Run far2l in
favorite terminal
but with
**best UX** | **Desktop** |
-| [Debian](https://packages.debian.org/search?keywords=far2l) packages: | _none_
(use `far2l` due to
[auto downgrade](#downgrade)) | `far2l` | `far2l` | `far2l-wx`
(since _2.6.4_) |
-| [Ubuntu](https://packages.ubuntu.com/search?keywords=far2l) packages: | _none_
(use `far2l` due to
[auto downgrade](#downgrade)) | `far2l` | `far2l` | _none_ |
+| **Keyboard:** | _Typical terminals_:
**only essential
key combinations**
_KiTTY_ (putty fork),
_kitty_ (\*nix one),
_iTerm2_,
_Windows Terminal_,
far2l’s VT: **full support** | _Typical terminals_:
**only essential
key combinations**
_KiTTY_ (putty fork),
_kitty_ (\*nix one),
_iTerm2_,
_Windows Terminal_,
far2l’s VT: **full support** | _Typical terminals_:
**most of key
combinations under x11**;
**only essential key
combinations
under Wayland**
_KiTTY_ (putty fork),
_kitty_ (\*nix one),
_iTerm2_,
_Windows Terminal_,
far2l’s VT: **full support** | **All key
combinations** |
+| **Clipboard
access:** | _Typical terminals_:
via command line
tools like xclip
_kitty_ (\*nix one),
_iTerm2_:
via **OSC52**
_Windows Terminal_:
via **OSC52**
or via **command line
tools under WSL**
_KiTTY_ (putty fork),
far2l’s VT:
via **far2l extensions** | _Typical terminals_,
_kitty_ (\*nix one):
via **x11 interaction**
_iTerm2_:
via **OSC52**
_Windows Terminal_:
via **OSC52**
or via **command line
tools under WSL**
_KiTTY_ (putty fork),
far2l’s VT:
via **far2l extensions** | _Typical terminals_,
_kitty_ (\*nix one):
via **x11 interaction**
_iTerm2_:
via **OSC52**
_Windows Terminal_:
via **OSC52**
or via **command line
tools under WSL**
_KiTTY_ (putty fork),
far2l’s VT:
via **far2l extensions** | via
**wxWidgets API**
via command line
tools under WSL |
+| **Typical
use case:** | **Servers**,
embedded
(\*wrt, etc) | Run far2l in
favorite terminal
but with
**better UX** | Run far2l in
favorite terminal
but with
**best UX** | **Desktop** |
+| [Debian](#debian) packages: | _none_
(use `far2l` due to
[auto downgrade](#downgrade)) | `far2l` | `far2l` | `far2l-wx`
(since _2.6.4_) |
+| [Ubuntu](#debian) packages: | _none_
(use `far2l` due to
[auto downgrade](#downgrade)) | `far2l` | `far2l` | _none_ |
| Community [PPA](#community_bins): | `far2l` | `far2l-ttyx` | `far2l-ttyx` | `far2l-gui` |
_Note_: When running far2l automatically downgrade
@@ -61,7 +70,7 @@ for plain **TTY**: `far2l --tty --nodetect=x`
_Note about use OSC 52 in TTY/TTY|X_:
to interact with the system clipboard you must **not forget to enable OSC 52**
-in both the **FAR2L settings** (`Options`->`Interface settings`->`Use OSC52 to set clipboard data`,
+in both the **FAR2L settings** (`Options`⇒`Interface settings`⇒`Use OSC52 to set clipboard data`,
which shown in the dialog only if far2l run in TTY/TTY|X mode and all other options for clipboard access are unavailable;
you can run `far2l --tty --nodetect` to force not use others clipboard options),
and in **terminal settings** option OSC 52 must be allowed (by default, OSC 52 is disabled in some terminals for security reasons;
@@ -69,6 +78,7 @@ OSC 52 in many terminals is implemented only for the copy mode, and paste from t
## Installing, Running
+
#### Debian/Ubuntu binaries from the official repositories
* **TTY X/Xi** backends only (Debian / Ubuntu 23.10+)
@@ -88,6 +98,23 @@ https://packages.debian.org/search?keywords=far2l or https://packages.ubuntu.com
_Note_: binaries in official repositories may be very outdated,
actual binaries or portable see in [Community packages & binaries](#community_bins).
+Backport official packages for old Debian/Ubuntu system
+
+A simple sid back port should be as easy as (build your own binary deb from the official source deb package,
+required install [dependencies](#required-dependencies)):
+
+```sh
+# you will find the latest dsc link at http://packages.debian.org/sid/far2l
+dget http://deb.debian.org/debian/pool/main/f/far2l/2.6.3~beta+ds-1.dsc
+dpkg-source -x *.dsc
+cd far2l-*/
+debuild
+# cd .. and install your self built far2l*.deb
+```
+
+