Skip to content

Commit

Permalink
update changelog for latest release
Browse files Browse the repository at this point in the history
  • Loading branch information
wez committed Jan 14, 2020
1 parent ced85ac commit 724ad3a
Show file tree
Hide file tree
Showing 2 changed files with 93 additions and 13 deletions.
28 changes: 25 additions & 3 deletions docs/changelog.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -10,14 +10,36 @@ daily) from the master branch. It may not be usable and
the feature set may change. As features stabilize some
brief notes about them may accumulate here.

* No new changes yet!

### 20200113-214446-bb6251f

* Added `color_scheme` configuration option and more than 200 color schemes
* Improved resize behavior; lines that were split due to
the width of the terminal are now rewrapped on resize.
[Issue 14](https://github.com/wez/wezterm/issues/14)
* Double-click and triple-click and hold followed by a drag now extends
the selection by word and line respectively.
* The OSC 7 (CurrentWorkingDirectory) escape sequence is now supported; wezterm records the cwd in a tab and that will be used to set the working directory when spawning new tabs in the same domain. You will need to configure your shell to emit OSC 7 when appropriate.
* [Changed Backspace/Delete handling](https://github.com/wez/wezterm/commit/f0e94084d1df36009b879b06e9cfd2be946168e8)
* Added `MoveTabRelative` for changing the ordering of tabs within a window
using key assignments `CTRL+SHIFT+PageUp` and `CTRL+SHIFT+PageDown`
* [The multiplexer protocol is undergoing major changes](https://github.com/wez/wezterm/issues/106).
If you are using it with the nightly build you will need to ensure that you
are running the same version of the nightly build on both the client and the
server.
The multiplexer will now raise an error if the client and server are incompatible.
* Fixed an issue where wezterm would linger for a few seconds after the last tab was closed
* Fixed an issue where wezterm wouldn't repaint the screen after a tab was closed
* Clicking the OS window close button in the titlebar now closes the window rather than the active tab
* Added `use_ime` option to optionally disable the use of the IME on macOS. You might consider enabling this if you don't like the way that the IME swallows key repeats for some keys.
* Fix an [issue](https://github.com/knsd/daemonize/pull/39) where the pidfile would leak into child processes and block restarting the mux server
* Fix an issue where the title bars of remote tabs were not picked up at domain attach time
* Fixed selection and scrollbar position for multiplexer tabs
* Added `ScrollByPage` key assignment and moved the `SHIFT+PageUp` handling up to the
gui layer so that it can be rebound.
* X11: a single mouse wheel tick now scrolls by 5 rows rather than 1
* Wayland: normalize line endings to unix line endings when pasting
* Windows: fixed handling of focus related messages, which impacted both the appearance of
the text cursor and copy and paste handling.
* When hovering over implicitly hyperlinked items, we no longer show the underline for every other URL with the same destination

### 20191229-193639-e7aa2f3

Expand Down
78 changes: 68 additions & 10 deletions docs/config/appearance.markdown
Original file line number Diff line number Diff line change
@@ -1,4 +1,23 @@
### Colors
### Color Scheme

Wezterm ships with the full set of over 200 color schemes available from
[iterm2colorschemes.com](https://iterm2colorschemes.com/). You can select a
color scheme with a line like this:

```toml
color_scheme = "Batman"
```

There are literally too many schemes to reasonably list here; check out the
screenshots on [iterm2colorschemes.com](https://iterm2colorschemes.com/)!

The `color_scheme` option takes precedence over the `colors` section below.

### Defining your own colors

Rather than using a color scheme, you can specify the color palette using the
`[colors]` configuration section. Note that `color_scheme` takes precedence
over this section.

You can configure colors with a section like this. In addition to specifying
[SVG/CSS3 color names](https://docs.rs/palette/0.4.1/palette/named/index.html#constants),
Expand Down Expand Up @@ -29,16 +48,55 @@ ansi = ["black", "maroon", "green", "olive", "navy", "purple", "teal", "silver"]
brights = ["grey", "red", "lime", "yellow", "blue", "fuchsia", "aqua", "white"]
```

You can find a variety of color schemes [here](https://github.com/mbadolato/iTerm2-Color-Schemes).
There are two ways to use them with wezterm:
### Defining a Color Scheme in your `wezterm.toml`

If you'd like to keep a couple of color schemes handy in your configuration
file, rather than filling out the `[colors]` section, place it in a
`color_schemes` section as shown below; you can then reference it using the
`color_scheme` setting.

Color schemes names that you define in your `wezterm.toml` take precedence
over all other color schemes.

All of the settings available from the `[colors]` section are available
to use in the `color_schemes` sections.

```toml
color_scheme = "Red Scheme"

[color_schemes."Red Scheme"]
background = "red"

[color_schemes."Blue Scheme"]
background = "blue"
```

### Defining a Color Scheme in a separate file

If you'd like to factor your color schemes out into separate files, you
can create a file with a `[colors]` section; take a look at [one of
the available color schemes for an example](https://github.com/wez/wezterm/blob/master/assets/colors/Builtin%20Dark.toml).

You then need to instruct wezterm where to look for your scheme files;
the `color_scheme_dirs` setting specifies a list of directories to
be searched:

```
color_scheme_dirs = ["/some/path/to/my/color/schemes"]
```

Color scheme names that are defined in files in your `color_scheme_dirs` list
take precedence over the built-in color schemes.


### Dynamic Color Escape Sequences

Wezterm supports dynamically changing its color palette via escape sequences.

* [The wezterm directory](https://github.com/mbadolato/iTerm2-Color-Schemes/tree/master/wezterm) contains
configuration snippets that you can copy and paste into your `wezterm.toml` file
to set the default configuration.
* [The dynamic-colors directory](https://github.com/mbadolato/iTerm2-Color-Schemes/tree/master/dynamic-colors)
contains shell scripts that can change the color scheme immediately on the fly.
This is super convenient for trying out color schemes, and can be used in
your own scripts to alter the terminal appearance programmatically:
[The dynamic-colors directory](https://github.com/mbadolato/iTerm2-Color-Schemes/tree/master/dynamic-colors)
of the color scheme repo contains shell scripts that can change the color
scheme immediately on the fly. This can be used in your own scripts to alter
the terminal appearance programmatically:

```bash
$ git clone https://github.com/mbadolato/iTerm2-Color-Schemes.git
Expand Down

0 comments on commit 724ad3a

Please sign in to comment.