1173513 - Point to SavedFrame.md docs from JSAPI comments

Status: RESOLVED FIXED

(Core :: JavaScript Engine, defect)

Comment 1

[Nick Fitzgerald [:fitzgen] [⏰PST; UTC-8]]

Attachment: Point to SavedFrame.md docs from JSAPI comments; DONTBUILD

Comment 2

[Boris Zbarsky [:bzbarsky]]

The pointer should be from the jsapi bits for async stacks/causes (also?), no?

Comment 3

[Nick Fitzgerald [:fitzgen] [⏰PST; UTC-8]]

(In reply to Not doing reviews right now from comment #2)
> The pointer should be from the jsapi bits for async stacks/causes (also?),
> no?

Do you want to repeat the "See also ..." for each method? I personally think that's a bit much, but you are an API customer and I am not, so I defer to you.

Comment 4

[Boris Zbarsky [:bzbarsky]]

Well.  So I was reading the docs for AutoSetAsyncStackForNewCalls when I couldn't make sense of asyncCause.  That's about 1000 lines above the line you're adding.  What are my chances of starting at AutoSetAsyncStackForNewCalls and discovering that I should read SavedFrame.md for documentation on asyncCause?

Comment 5

[Nick Fitzgerald [:fitzgen] [⏰PST; UTC-8]]

Attachment: Point to SavedFrame.md docs from JSAPI comments; DONTBUILD

Comment 6

[Pulsebot]

https://hg.mozilla.org/integration/mozilla-inbound/rev/680292fc9f89

Comment 7

[Wes Kocher (:KWierso) (Not reading bugmail; email directly if needed)]

https://hg.mozilla.org/mozilla-central/rev/680292fc9f89