mirror of
https://github.com/alacritty/alacritty.git
synced 2024-11-03 04:34:21 -05:00
1df7dc5171
Previously Alacritty would always initialize only a single terminal emulator window feeding into the winit event loop, however some platforms like macOS expect all windows to be spawned by the same process and this "daemon-mode" can also come with the advantage of increased memory efficiency. The event loop has been restructured to handle all window-specific events only by the event processing context with the associated window id. This makes it possible to add new terminal windows at any time using the WindowContext::new function call. Some preliminary tests have shown that for empty terminals, this reduces the cost of additional terminal emulators from ~100M to ~6M. However at this point the robustness of the daemon against issues with individual terminals has not been refined, making the reliability of this system questionable. New windows can be created either by using the new `CreateNewWindow` action, or with the `alacritty msg create-window` subcommand. The subcommand sends a message to an IPC socket which Alacritty listens on, its location can be found in the `ALACRITTY_SOCKET` environment variable. Fixes #607.
91 lines
2.5 KiB
Groff
91 lines
2.5 KiB
Groff
.TH ALACRITTY "1" "August 2018" "alacritty 0.10.0-dev" "User Commands"
|
|
.SH NAME
|
|
Alacritty \- A fast, cross-platform, OpenGL terminal emulator
|
|
.SH "SYNOPSIS"
|
|
alacritty [SUBCOMMANDS] [FLAGS] [OPTIONS]
|
|
.SH DESCRIPTION
|
|
Alacritty is a modern terminal emulator that comes with sensible defaults, but
|
|
allows for extensive configuration. By integrating with other applications,
|
|
rather than reimplementing their functionality, it manages to provide a flexible
|
|
set of features with high performance.
|
|
.SH "FLAGS"
|
|
.TP
|
|
\fB\-h\fR, \fB\-\-help\fR
|
|
Prints help information
|
|
.TP
|
|
\fB\-\-hold\fR
|
|
Remain open after child process exits
|
|
.TP
|
|
\fB\-\-print\-events\fR
|
|
Print all events to stdout
|
|
.TP
|
|
\fB\-q\fR
|
|
Reduces the level of verbosity (the min level is \fB\-qq\fR)
|
|
.TP
|
|
\fB\-\-ref\-test\fR
|
|
Generates ref test
|
|
.TP
|
|
\fB\-v\fR
|
|
Increases the level of verbosity (the max level is \fB\-vvv\fR)
|
|
.TP
|
|
\fB\-V\fR, \fB\-\-version\fR
|
|
Prints version information
|
|
.SH "OPTIONS"
|
|
.TP
|
|
\fB\-\-class\fR <instance> | <instance>,<general>
|
|
Defines the window class hint on Linux [default: Alacritty,Alacritty]
|
|
|
|
On Wayland the instance class sets the `app_id`, while the general class is ignored.
|
|
.TP
|
|
\fB\-e\fR, \fB\-\-command\fR <command>...
|
|
Command and args to execute (must be last argument)
|
|
.TP
|
|
\fB\-\-config\-file\fR <config\-file>
|
|
Specify alternative configuration file
|
|
|
|
Alacritty looks for the configuration file at the following paths:
|
|
1. $XDG_CONFIG_HOME/alacritty/alacritty.yml
|
|
2. $XDG_CONFIG_HOME/alacritty.yml
|
|
3. $HOME/.config/alacritty/alacritty.yml
|
|
4. $HOME/.alacritty.yml
|
|
|
|
On Windows, the configuration file is located at %APPDATA%\\alacritty\\alacritty.yml.
|
|
.TP
|
|
\fB\-\-embed\fR <parent>
|
|
Defines the X11 window ID (as a decimal integer) to embed Alacritty within
|
|
.TP
|
|
\fB\-o\fR, \fB\-\-option\fR <option>...
|
|
Override configuration file options [example: cursor.style=Beam]
|
|
.TP
|
|
\fB\-\-socket\fR <socket>
|
|
Path for IPC socket creation
|
|
.TP
|
|
\fB\-t\fR, \fB\-\-title\fR <title>
|
|
Defines the window title [default: Alacritty]
|
|
.TP
|
|
\fB\-\-working\-directory\fR <working\-directory>
|
|
Start the shell in the specified working directory
|
|
.SH "SUBCOMMANDS"
|
|
.TP
|
|
\fBmsg\fR
|
|
Available socket messages
|
|
.SH "SEE ALSO"
|
|
See the alacritty github repository at https://github.com/alacritty/alacritty for the full documentation.
|
|
.SH "BUGS"
|
|
Found a bug? Please report it at https://github.com/alacritty/alacritty/issues.
|
|
.SH "MAINTAINERS"
|
|
.sp
|
|
.RS 4
|
|
.ie n \{\
|
|
\h'-04'\(bu\h'+03'\c
|
|
.\}
|
|
.el \{\
|
|
.sp -1
|
|
.IP \(bu 2.3
|
|
.\}
|
|
Christian Duerr <contact@christianduerr.com>
|
|
.sp
|
|
.ie n \{\
|
|
\h'-04'\(bu\h'+03'\c
|
|
.\}
|
|
Joe Wilm <joe@jwilm.com>
|