detached 50a2e95

docs(xwm): state that Boot takes a component-scoped logger

commit
50a2e955498c9462f8ba6a4fc79ac5c291a60f2f
author
brice · · 2026-10-22 12:13 UTC
committer
brice · · 2026-10-22 17:54 UTC
parent
01f9a3d
signature
GPG VerifiedCD88F9E564E0102646FB6077A1A07C7C7C3E349D · arch-gpg Verified for the committer email
1 file · +2 -1
M internal/adapters/wayland/xwm/xwm.go +2 -1
@@ -81,7 +81,7 @@ type XWM struct {
8181 }
8282
8383 func newXWM(conn *xturbo.Conn, log zerowrap.Logger) *XWM {
84- x := &XWM{conn: conn, log: log.WithField("component", "xwm"), root: conn.Root(), tab: newTable(initialSlots)}
84+ x := &XWM{conn: conn, log: log, root: conn.Root(), tab: newTable(initialSlots)}
8585 x.h = xturbo.Handler{OnEvent: x.onEvent, OnReply: x.onReply, OnError: x.onError}
8686 x.fit()
8787 return x
@@ -145,6 +145,7 @@ func (x *XWM) setProp32(win uint32, prop int, typ xproto.Atom, vals []uint32) {
145145 // blocks (about 25 s at worst) and must not run on the display goroutine: the
146146 // handshake needs Xwayland, which needs the display goroutine to serve its
147147 // Wayland requests. It takes ownership of wmFD and closes it on failure.
148+// log is scoped by the caller with logging.For(ctx, "xwm").
148149 func Boot(wmFD int, log zerowrap.Logger) (*XWM, error) {
149150 conn, err := xturbo.NewConn(wmFD)
150151 if err != nil {
@@ -81,7 +81,7 @@ type XWM struct {
81 }81 }
82 82
83 func newXWM(conn *xturbo.Conn, log zerowrap.Logger) *XWM {83 func newXWM(conn *xturbo.Conn, log zerowrap.Logger) *XWM {
84- x := &XWM{conn: conn, log: log.WithField("component", "xwm"), root: conn.Root(), tab: newTable(initialSlots)}84+ x := &XWM{conn: conn, log: log, root: conn.Root(), tab: newTable(initialSlots)}
85 x.h = xturbo.Handler{OnEvent: x.onEvent, OnReply: x.onReply, OnError: x.onError}85 x.h = xturbo.Handler{OnEvent: x.onEvent, OnReply: x.onReply, OnError: x.onError}
86 x.fit()86 x.fit()
87 return x87 return x
@@ -145,6 +145,7 @@ func (x *XWM) setProp32(win uint32, prop int, typ xproto.Atom, vals []uint32) {
145 // blocks (about 25 s at worst) and must not run on the display goroutine: the145 // blocks (about 25 s at worst) and must not run on the display goroutine: the
146 // handshake needs Xwayland, which needs the display goroutine to serve its146 // handshake needs Xwayland, which needs the display goroutine to serve its
147 // Wayland requests. It takes ownership of wmFD and closes it on failure.147 // Wayland requests. It takes ownership of wmFD and closes it on failure.
148+// log is scoped by the caller with logging.For(ctx, "xwm").
148 func Boot(wmFD int, log zerowrap.Logger) (*XWM, error) {149 func Boot(wmFD int, log zerowrap.Logger) (*XWM, error) {
149 conn, err := xturbo.NewConn(wmFD)150 conn, err := xturbo.NewConn(wmFD)
150 if err != nil {151 if err != nil {

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