mirror of
https://github.com/wez/wezterm.git
synced 2024-12-25 22:33:52 +03:00
7a5440694d
The intent is that when set, it changes defaults to something more suitable for distributions. I've also added a readme for distro maintainers. refs: https://github.com/wez/wezterm/issues/1795
71 lines
2.7 KiB
Markdown
71 lines
2.7 KiB
Markdown
# Notes for distro maintainers
|
|
|
|
`ci/deploy.sh` is a script that is used to build packages in wezterm's CI.
|
|
It is likely a bit more coarse than most distros would want in their
|
|
official packages, but it should give a sense of what is intended to go where.
|
|
|
|
## Versioning
|
|
|
|
WezTerms version number is derived from the date of the commit from which it
|
|
was released:
|
|
|
|
```
|
|
git -c "core.abbrev=8" show -s "--format=%cd-%h" "--date=format:%Y%m%d-%H%M%S"
|
|
```
|
|
|
|
If you are not building wezterm from its git repo, wezterm will read a file named
|
|
`.tag` in the root of its source tree to determine the version.
|
|
|
|
Please package using the `wezterm-YYYYMMDD-HHMMSS-HASH-src.tar.gz` release
|
|
asset from the release, rather than the automatic GitHub source tarball.
|
|
Not only is it a smaller download, but it already contains an appropriate
|
|
`.tag` file with the release version baked into it.
|
|
|
|
If you must decorate wezterm's version, then it is recommend that you append
|
|
your supplemental extra version information on the end of the wezterm's
|
|
version.
|
|
|
|
For example: `YYYYMMDD-HHMMSS-HASH-EXTRA`.
|
|
|
|
If `-` is illegal in your package management system, then it is recommended
|
|
that you substitute either `.` or `_` to separate the portions of the version
|
|
string.
|
|
|
|
## Binaries
|
|
|
|
* `wezterm-mux-server` - multiplexer server. No gui required. Likely want this
|
|
in a separate package from `wezterm-gui` so it can run on a headless system.
|
|
* `wezterm-gui` - the GUI portion of the terminal
|
|
* `wezterm` - the CLI and frontend that knows how to launch the GUI. It is
|
|
desirable to have this available to both the multiplexer server and the gui.
|
|
* `strip-ansi-escapes` - a utility that can filter escapes out of stdin; useful
|
|
for de-fanging text when composing eg: OSC 0/1 title text.
|
|
|
|
## Additional Resources
|
|
|
|
* `assets/shell-integration`, `assets/shell-completion`: should be deployed along with the `wezterm` executable
|
|
* `assets/wezterm.desktop`, `assets/wezterm.appdata.xml`, `assets/wezterm-nautilus.py`: should be deployed along with `wezterm-gui`
|
|
|
|
## Building wezterm
|
|
|
|
It is recommended that you enable the `distro-defaults` rust feature
|
|
when building for a distro (`cargo build --release -p wezterm-gui --features distro-defaults`).
|
|
|
|
It has the following effects:
|
|
|
|
* `check_for_updates` will default to `false`
|
|
|
|
If there are other behaviors that you'd like to change from the default, please
|
|
raise issue(s) for them so that we can figure out how to make it easier for you
|
|
to maintain your wezterm package.
|
|
|
|
### Building without wayland support
|
|
|
|
If your distro doesn't include any support for Wayland, you will need to
|
|
disable that feature when you build wezterm:
|
|
|
|
```
|
|
cargo build --release -p wezterm-gui --no-default-features --features distro-defaults
|
|
```
|
|
|