1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
|
The staging area is broot's solution to let you execute commands on several files in one go.
When the staging area is focused, commands apply to all the files it contains.
# Stage and unstage files
You can change the bindings to the `:stage`, `:unstage` and `:toggle_stage` verbs.
The standard bindings are below
verb | default binding | comment
-|-|-
`:toggle_stage` | <kbd>ctrl</kbd><kbd>g</kbd> | the easiest solution when not using broot in [modal](../modal)
`:stage` | <kbd>+</kbd> | only in [command mode](../modal#usage)
`:unstage` | <kbd>-</kbd> | only in [command mode](../modal#usage)
`:clear_stage` | | shortcut: `:cls`
When staging a file, the staging area opens (but doesn't get focused) if it wasn't and there's not aleady the max number of panels open.
# Execute a command
Focus the staging area (usually with <kbd>ctrl</kbd><kbd>→</kbd>) then type the verb in the input.
The verb will be executed, in order, to all files of the staging area.
![staging mv](img/20210424-staging-mv.png)
Computed groups which would have the same value for all files are shown in the status bar. For example here, when you type ` mv ../app-panels`, broot can tell you that it will run `mv {file} /home/dys/dev/broot/src/app-panels/` for each file of the staging area.
Some verbs aren't compatible with execution on the staging area:
* Verbs which don't come back to broot after execution (for example `:cd` or any verb quitting broot)
* [Sequences](../conf_verbs#cmd-execution)
# Read the staging area
The staging area can be opened or closed with the `:open_staging_area`, `:close_staging_area`, and `:toggle_staging_area` verbs, which have shortcuts `:osa`, `:csa`, and `:tsa`.
But you rarely need those verbs as the staging area opens when you add to it and closes when it goes empty.
You can filter, select, scroll, as in other panels. This may be convenient either to unstage a precise file from the staging area, or to check some files are present (or not) when there are many of them.
![staging filter](img/20210425-staging-filter.png)
# Evolutions
The staging area is a new feature of broot. Some features (staging with globs for example) may be added, some may be changed, depending on your feedback.
|