detached e0d1cba

docs(core): keyboardFocus comment covers on-demand layers

commit
e0d1cba67b9b1c21b727ecdf3363752edec63f22
author
brice · · 2026-09-26 06:05 UTC
committer
brice · · 2026-09-26 06:05 UTC
parent
ee631b3
signature
GPG VerifiedCD88F9E564E0102646FB6077A1A07C7C7C3E349D · arch-gpg Verified for the committer email
1 file · +4 -4
M internal/core/core.go +4 -4
@@ -304,10 +304,6 @@ func (c *Core) visible(id WindowID) bool {
304304 return ok
305305 }
306306
307-// keyboardFocus is the mapped top/overlay layer with exclusive keyboard
308-// interactivity and the highest ID on any output, else the focused window of
309-// the focused output. An on-demand layer takes focus only when clicked, until
310-// a window is clicked. When the layer unmaps, focus returns to the window.
311307 // windowFocus is the focused window of each output.
312308 func (c *Core) windowFocus() map[*screen]WindowID {
313309 m := make(map[*screen]WindowID, len(c.screens))
@@ -317,6 +313,10 @@ func (c *Core) windowFocus() map[*screen]WindowID {
317313 return m
318314 }
319315
316+// keyboardFocus is the mapped top/overlay layer with exclusive keyboard
317+// interactivity and the highest ID on any output, else a grabbing popup,
318+// else a clicked on-demand layer (see layerFocus), else the focused window
319+// of the focused output.
320320 func (c *Core) keyboardFocus() WindowID {
321321 var layer WindowID
322322 for _, sc := range c.screens {
@@ -304,10 +304,6 @@ func (c *Core) visible(id WindowID) bool {
304 return ok304 return ok
305 }305 }
306 306
307-// keyboardFocus is the mapped top/overlay layer with exclusive keyboard
308-// interactivity and the highest ID on any output, else the focused window of
309-// the focused output. An on-demand layer takes focus only when clicked, until
310-// a window is clicked. When the layer unmaps, focus returns to the window.
311 // windowFocus is the focused window of each output.307 // windowFocus is the focused window of each output.
312 func (c *Core) windowFocus() map[*screen]WindowID {308 func (c *Core) windowFocus() map[*screen]WindowID {
313 m := make(map[*screen]WindowID, len(c.screens))309 m := make(map[*screen]WindowID, len(c.screens))
@@ -317,6 +313,10 @@ func (c *Core) windowFocus() map[*screen]WindowID {
317 return m313 return m
318 }314 }
319 315
316+// keyboardFocus is the mapped top/overlay layer with exclusive keyboard
317+// interactivity and the highest ID on any output, else a grabbing popup,
318+// else a clicked on-demand layer (see layerFocus), else the focused window
319+// of the focused output.
320 func (c *Core) keyboardFocus() WindowID {320 func (c *Core) keyboardFocus() WindowID {
321 var layer WindowID321 var layer WindowID
322 for _, sc := range c.screens {322 for _, sc := range c.screens {

Keyboard shortcuts

Single-key shortcuts are on. ctrl k and esc work whatever this says.

ctrl k :
go to a section, branch, tag, file or repository
?
this list
j k
move the row cursor down / up
enter
open the row under the cursor; on Files, a directory opens or closes in place
↑ ↓ ← → home end
in the file tree (focus on a row): previous / next row, close / open a directory or go to its parent / first entry, first / last row. They never open a file
l h
on Files: open a directory or a file / close a directory or go up to its parent, then to the parent page. Elsewhere: into the side panel (on a merge request, its files) / back to the content; there j k move between its controls
g g G
first / last row
/
filter the list; on Files, find a file anywhere in the repository (esc clears, enter opens the best match)
b
switch branch or tag
g s g f g c g b g m g i g r g a
tabs: summary, files, commits, branches & tags, merge requests, issues, releases, actions (when available)
g h
home
w
wide mode: use the whole width of the screen, or not (remembered)
y
copy a permalink pinned to the commit
d u x
diff: split / unified / collapse or expand all
e E
diff: the whole file in view / every file, with the lines the hunks hide
n
merge request: next note in the diff
esc
close a dialog, leave a field

Branches 25

Tags 10

↑↓ moveenter openesc close