mirror of https://gitee.com/openkylin/vte2.91.git
62 lines
2.1 KiB
Markdown
62 lines
2.1 KiB
Markdown
Virtual TErminal
|
|
================
|
|
|
|
VTE provides a virtual terminal widget for GTK applications.
|
|
|
|
Installation
|
|
------------
|
|
|
|
```
|
|
$ git clone https://gitlab.gnome.org/GNOME/vte # Get the source code of VTE
|
|
$ cd vte # Change to the toplevel directory
|
|
$ meson _build # Run the configure script
|
|
$ ninja -C _build # Build VTE
|
|
[ Optional ]
|
|
$ ninja -C _build install # Install VTE to default `/usr/local`
|
|
```
|
|
|
|
* By default, VTE will install under `/usr/local`. You can customize the
|
|
prefix directory by `--prefix` option, e.g. If you want to install VTE under
|
|
`~/foobar`, you should run `meson _build --prefix=~/foobar`. If you already
|
|
run the configure script before, you should also pass `--reconfigure` option to it.
|
|
|
|
* You may need to execute `ninja -C _build install` as root
|
|
(i.e. `sudo ninja -C _build install`) if installing to system directories.
|
|
|
|
* If you wish to test VTE before installing it, you may execute it directly from
|
|
its build directory. As `_build` directory, it should be `_build/src/app/vte-[version]`.
|
|
|
|
* You can pass `-Ddebugg=true` option to meson if you wish to enable debug function.
|
|
|
|
|
|
Debugging
|
|
---------
|
|
|
|
After installing VTE with `-Ddebugg=true` flag, you can use `VTE_DEBUG` variable to control
|
|
VTE to print out the debug information
|
|
|
|
```
|
|
# You should change vte-[2.91] to the version you build
|
|
$ VTE_DEBUG=selection ./_build/src/app/vte-2.91
|
|
|
|
# Or, you can mixup with multiple logging level
|
|
$ VTE_DEBUG=selection,draw,cell ./_build/src/app/vte-2.91
|
|
|
|
$ Or, you can use `all` to print out all logging message
|
|
$ VTE_DEBUG=all ./_build/src/app/vte-2.91
|
|
```
|
|
|
|
For logging level information, please refer to enum [VteDebugFlags](src/debug.h).
|
|
|
|
|
|
Contributing
|
|
------------
|
|
|
|
Bugs should be filed here: https://gitlab.gnome.org/GNOME/vte/issues/
|
|
Please note that this is *not a support forum*; if you are a end user,
|
|
always file bugs in your distribution's bug tracker, or use their
|
|
support forums.
|
|
|
|
If you want to provide a patch, please attach them to an issue in GNOME
|
|
GitLab, in the format output by the git format-patch command.
|