detached 763bb99

objc: clarify SendSuper method lookup (#514)

Document that SendSuper uses objc_msgSendSuper2, which takes the
current class and starts method lookup at its superclass. Explain
why objc_super.superClass contains the receiver's own class.

Closes #509
commit
763bb996ee5bc7661be7c7d59fb8f5bf53bc10c5
author
Hiroki KUMAZAKI · · 2026-09-05 12:39 UTC
committer
GitHub · · 2026-09-05 12:39 UTC
parent
7e3b362
signature
GPG UnverifiedB5690EEEBB952194 The key is unknown
1 file · +5 -2
M objc/objc_runtime_darwin.go +5 -2
@@ -172,8 +172,11 @@ func Send[T any](id ID, sel SEL, args ...any) T {
172172 }
173173
174174 // objc_super data structure is generated by the Objective-C compiler when it encounters the super keyword
175-// as the receiver of a message. It specifies the class definition of the particular superclass that should
176-// be messaged.
175+// as the receiver of a message.
176+//
177+// [SendSuper] calls objc_msgSendSuper2 instead of objc_msgSendSuper. Unlike objc_msgSendSuper, which expects
178+// the superclass to message, objc_msgSendSuper2 expects the current class and begins looking the method up
179+// in its superclass by itself, so the receiver's own class is what belongs in superClass.
177180 type objc_super struct {
178181 _ structs.HostLayout
179182 receiver ID
@@ -172,8 +172,11 @@ func Send[T any](id ID, sel SEL, args ...any) T {
172 }172 }
173 173
174 // objc_super data structure is generated by the Objective-C compiler when it encounters the super keyword174 // objc_super data structure is generated by the Objective-C compiler when it encounters the super keyword
175-// as the receiver of a message. It specifies the class definition of the particular superclass that should175+// as the receiver of a message.
176-// be messaged.176+//
177+// [SendSuper] calls objc_msgSendSuper2 instead of objc_msgSendSuper. Unlike objc_msgSendSuper, which expects
178+// the superclass to message, objc_msgSendSuper2 expects the current class and begins looking the method up
179+// in its superclass by itself, so the receiver's own class is what belongs in superClass.
177 type objc_super struct {180 type objc_super struct {
178 _ structs.HostLayout181 _ structs.HostLayout
179 receiver ID182 receiver ID

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 1

Tags 102

↑↓ moveenter openesc close