Skip to content

Commit 7478242

Browse files
committed
v2.0.0-rc.4
1 parent e3795bb commit 7478242

4 files changed

Lines changed: 14 additions & 14 deletions

File tree

README.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ A lightweight tmux command & layout composer - one shell script + tmux + zero ot
1616

1717
**Contents** - [Usage](https://github.com/evnp/tmex#usage) | [Layout](https://github.com/evnp/tmex#layout) | [npm](https://github.com/evnp/tmex#npm) | [Install](https://github.com/evnp/tmex#install) | [Tests](https://github.com/evnp/tmex#tests) | [License](https://github.com/evnp/tmex#license)
1818

19-
**New in [v2.0.0-rc.3](https://github.com/evnp/tmex/releases/tag/v2.0.0-rc.3)** 🐣 <br> [Multi-window management](https://github.com/evnp/tmex#multi-window-management-new-in-v200-rc3-) | [Focused-pane control](https://github.com/evnp/tmex#focused-pane-control-new-in-v200-rc3-) | [Multi-digit pane counts](https://github.com/evnp/tmex#multi-digit-pane-counts-new-in-v200-rc3-) | [Top-level sizing](https://github.com/evnp/tmex#top-level-layout-sizing-new-in-v200-rc3-) | [Grid sub-layouts](https://github.com/evnp/tmex#grid-sub-layouts-new-in-v200-rc3-)
19+
**New in [v2.0.0-rc.4](https://github.com/evnp/tmex/releases/tag/v2.0.0-rc.4)** 🐣 <br> [Multi-window management](https://github.com/evnp/tmex#multi-window-management-new-in-v200-rc3-) | [Focused-pane control](https://github.com/evnp/tmex#focused-pane-control-new-in-v200-rc3-) | [Multi-digit pane counts](https://github.com/evnp/tmex#multi-digit-pane-counts-new-in-v200-rc3-) | [Top-level sizing](https://github.com/evnp/tmex#top-level-layout-sizing-new-in-v200-rc3-) | [Grid sub-layouts](https://github.com/evnp/tmex#grid-sub-layouts-new-in-v200-rc3-)
2020

2121
If you'd like to jump straight to installing tmex, please go to the [Install](https://github.com/evnp/tmex#install) section or try one of these:
2222
```sh
@@ -179,14 +179,14 @@ tmex your-session-name --layout={152}1[2{13}1]4{4112}
179179
```
180180
Note that the sublayout `[2{13}1]` is treated as a single column when sizing is applied, so that set of panes as a whole receives `5` as its width relative to the other columns.
181181

182-
Top-level layout sizing (new in [v2.0.0-rc.3](https://github.com/evnp/tmex/releases/tag/v2.0.0-rc.3) 🐣)
182+
Top-level layout sizing (new in [v2.0.0-rc.4](https://github.com/evnp/tmex/releases/tag/v2.0.0-rc.4) 🐣)
183183
----------------------------------------------------------------------------------------------------
184184
Since a sizing clause like `{123}` always _follows_ a pane count number within a layout, you may be wondering how sizing could be applied to the "top level" columns (or rows) of a layout. For example, given the layout `234`, how could you:
185185
- make the first column `2` fill half the screen
186186
- make the second column `3` fill a third of the screen
187187
- make the third column `4` fill the remainder (one sixth) of the screen
188188

189-
This special case is accomplished by placing the sizing clause at the _start_ of the layout (prior to [v2.0.0-rc.3](https://github.com/evnp/tmex/releases/tag/v2.0.0-rc.3), this would result in an invalid layout error):
189+
This special case is accomplished by placing the sizing clause at the _start_ of the layout (prior to [v2.0.0-rc.4](https://github.com/evnp/tmex/releases/tag/v2.0.0-rc.4), this would result in an invalid layout error):
190190
```sh
191191
tmex your-session-name --layout={321}234
192192
>>>
@@ -211,7 +211,7 @@ tmex your-session-name --layout=[[234]{321}] # also equivalent
211211
```
212212
These may be functionally equivalent, but they're a far cry from intuitive! Feel free to use whichever of the three forms makes the most logical sense to you though.
213213

214-
Grid sub-layouts (new in [v2.0.0-rc.3](https://github.com/evnp/tmex/releases/tag/v2.0.0-rc.3) 🐣)
214+
Grid sub-layouts (new in [v2.0.0-rc.4](https://github.com/evnp/tmex/releases/tag/v2.0.0-rc.4) 🐣)
215215
---------------------------------------------------------------------------------------------
216216

217217
Sometimes you might want a row/column of your layout to contain a grid of N panes, laid out using the default algorithm. This is done by placing `{+}` _after_ a number of panes in the layout. This can be thought of as "requesting a grid layout" for the preceeding number of panes – `+` is a visual mnemonic in that it separates the space within `{ }` in a grid-like formation.
@@ -238,7 +238,7 @@ tmex your-session-name --layout=31224
238238
```
239239
because `5{+}` is expanded to `122`, which is the default grid layout when 5 panes are required. You can experiment with commands such as `tmex your-session-name --layout=7{+}` to see what default grid layout is produced for each number of panes. In general, each default grid layout attempts to equalize pane sizes, widths, and heights as much as possible, keeping the largest pane on the left with odd numbers of panes.
240240

241-
Multi-digit pane counts (new in [v2.0.0-rc.3](https://github.com/evnp/tmex/releases/tag/v2.0.0-rc.3) 🐣)
241+
Multi-digit pane counts (new in [v2.0.0-rc.4](https://github.com/evnp/tmex/releases/tag/v2.0.0-rc.4) 🐣)
242242
----------------------------------------------------------------------------------------------------
243243
For any of the layouts above, pane counts 10 and greater can be achieved by separating digits with `.` characters. For example:
244244
```sh
@@ -262,7 +262,7 @@ tmex your-session-name --layout=11.[23]45[6.7]8.
262262
```
263263
`11.` is treated as multi-digit, and produces a column 11 panes. `23` are treated as a sublayout of single-digit pane counts, producing 5 panes total. `45` have no adjacent `.` characters so they produce columns of 4 and 5 panes. `6.7` are treated as multi-digit, but still produce separate rows (in their sublayout) of 6 and 7 panes respectively – the `.` has no effect. Finally, `8.` is treated as multi-digit due to the adjacent `.` but still produces a column of 8 panes – the `.` has no effect).
264264

265-
Focused Pane Control (new in [v2.0.0-rc.3](https://github.com/evnp/tmex/releases/tag/v2.0.0-rc.3) 🐣)
265+
Focused Pane Control (new in [v2.0.0-rc.4](https://github.com/evnp/tmex/releases/tag/v2.0.0-rc.4) 🐣)
266266
-------------------------------------------------------------------------------------------------
267267

268268
There are a few different ways to select a specific pane to be "focused" – with cursor active inside it – when your layout is initialized.
@@ -292,7 +292,7 @@ tmex your-session-name -f=-10 1357 # shorthand argument + shorthand
292292
# this happens to be equivalent to --layout=135---7 from above
293293
```
294294

295-
Multi-window management (new in [v2.0.0-rc.3](https://github.com/evnp/tmex/releases/tag/v2.0.0-rc.3) 🐣)
295+
Multi-window management (new in [v2.0.0-rc.4](https://github.com/evnp/tmex/releases/tag/v2.0.0-rc.4) 🐣)
296296
----------------------------------------------------------------------------------------------------
297297

298298
You may want to create multiple tmux windows within your tmux session, and navigate between them using **CTRL+B→N** (next), **CTRL+B→P** (previous), **CTRL+B→[0-9]** (select by index).
@@ -319,7 +319,7 @@ tmex your-session-name --window '' 123 --window '' 44 # equivalent
319319
```
320320
**NOTE** that `-w''` (no space between arg and value) does _not_ work, since shell string concatenation causes this to be treated as simply `-w` and the _next_ arg will be inadvertently used as the window name.
321321

322-
Kill command (new in [v2.0.0-rc.3](https://github.com/evnp/tmex/releases/tag/v2.0.0-rc.3) 🐣)
322+
Kill command (new in [v2.0.0-rc.4](https://github.com/evnp/tmex/releases/tag/v2.0.0-rc.4) 🐣)
323323
---------------------------------------------------------------------------------------------
324324

325325
You can kill a tmux session from anywhere using
@@ -382,11 +382,11 @@ read -rp $'\n'"Current \$MANPATH:"$'\n'"${MANPATH//:/ : }"$'\n\n'"Enter a direct
382382
Verify installation:
383383
```sh
384384
tmex -v
385-
==> tmex 2.0.0-rc.3
385+
==> tmex 2.0.0-rc.4
386386

387387
brew test tmex
388388
==> Testing tmex
389-
==> /opt/homebrew/Cellar/tmex/2.0.0-rc.3/bin/tmex test --print 1234 hello world
389+
==> /opt/homebrew/Cellar/tmex/2.0.0-rc.4/bin/tmex test --print 1234 hello world
390390
```
391391

392392
If you see the output `Warning: tmux is not yet installed, tmex will not work without tmux.` you'll need to install tmux as well.

package-lock.json

Lines changed: 2 additions & 2 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "tmex",
3-
"version": "2.0.0-rc.3",
3+
"version": "2.0.0-rc.4",
44
"description": "tmux-execute – a lightweight tmux command & layout composer",
55
"main": "tmex",
66
"files": [

tmex

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
#!/usr/bin/env bash
22

3-
# tmex 2.0.0-rc.3
3+
# tmex 2.0.0-rc.4
44

55
set -euo pipefail
66

0 commit comments

Comments
 (0)