aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDaniel Eklöf <daniel@ekloef.se>2026-06-20 16:13:13 +0000
committerDaniel Eklöf <daniel@ekloef.se>2026-06-20 16:13:13 +0000
commit73e6d21000460cba7b511d984d34112f512a7f29 (patch)
treec783f5d5f4e7c1823387f7ded9a06077a1a2627e
parentwayland: win_destroy(): unmap overlay surface before destroy (diff)
main/client: add --class, an alias for --app-id
This is to help e.g. scripts that wants to launch terminal instances in a terminal agnostic way. Many terminals were originally for X11, where the '--class' choice was obvious. When they were ported to Wayland, it made sense for them to keep the '--class' command line option, but have it set the application ID instead (since "class" is not a thing on Wayland). Let's add the alias, but minimally documented. We don't want to _encourage_ its use after all. Closes #2368
-rw-r--r--CHANGELOG.md8
-rw-r--r--client.c1
-rw-r--r--doc/foot.1.scd3
-rw-r--r--doc/footclient.1.scd3
-rw-r--r--main.c1
5 files changed, 16 insertions, 0 deletions
diff --git a/CHANGELOG.md b/CHANGELOG.md
index f1820317..64b1ac07 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -72,6 +72,14 @@
## Unreleased
### Added
+
+* Command line option `--class`, an alias for `--app-id`. Intended to
+ be used by scripts and similar that wants to launch terminal
+ instances in a terminal agnostic way ([#2368][2368]).
+
+[2368]: https://codeberg.org/dnkl/foot/issues/2368
+
+
### Changed
* Do not allow codepoints to be merged into grapheme clusters directly
diff --git a/client.c b/client.c
index befd3ab0..f35453b9 100644
--- a/client.c
+++ b/client.c
@@ -157,6 +157,7 @@ main(int argc, char *const *argv)
{"term", required_argument, NULL, 't'},
{"title", required_argument, NULL, 'T'},
{"app-id", required_argument, NULL, 'a'},
+ {"class", required_argument, NULL, 'a'},
{"toplevel-tag", required_argument, NULL, TOPLEVEL_TAG_OPTION},
{"window-size-pixels", required_argument, NULL, 'w'},
{"window-size-chars", required_argument, NULL, 'W'},
diff --git a/doc/foot.1.scd b/doc/foot.1.scd
index a190db9b..24d81b5f 100644
--- a/doc/foot.1.scd
+++ b/doc/foot.1.scd
@@ -70,6 +70,9 @@ the foot command line
Value to set the *app-id* property on the Wayland window
to. Default: _foot_ (normal mode), or _footclient_ (server mode).
+*--class*=_ID_
+ Alias for *--app-id*.
+
*toplevel-tag*=_TAG_
Value to set the *toplevel-tag* property on the Wayland window
to. The compositor can use this value for session management,
diff --git a/doc/footclient.1.scd b/doc/footclient.1.scd
index ad865913..92d84c34 100644
--- a/doc/footclient.1.scd
+++ b/doc/footclient.1.scd
@@ -33,6 +33,9 @@ terminal has terminated.
Value to set the *app-id* property on the Wayland window
to. Default: _foot_ (normal mode), or _footclient_ (server mode).
+*--class*=_ID_
+ Alias for *--app-id*.
+
*toplevel-tag*=_TAG_
Value to set the *toplevel-tag* property on the Wayland window
to. The compositor can use this value for session management,
diff --git a/main.c b/main.c
index 9db77d0c..d9c5dc3c 100644
--- a/main.c
+++ b/main.c
@@ -216,6 +216,7 @@ main(int argc, char *const *argv)
{"term", required_argument, NULL, 't'},
{"title", required_argument, NULL, 'T'},
{"app-id", required_argument, NULL, 'a'},
+ {"class", required_argument, NULL, 'a'},
{"toplevel-tag", required_argument, NULL, TOPLEVEL_TAG_OPTION},
{"login-shell", no_argument, NULL, 'L'},
{"working-directory", required_argument, NULL, 'D'},