diff --git a/collects/scribblings/gui/snip-class.scrbl b/collects/scribblings/gui/snip-class.scrbl index 56e07c02bb..dd590f4a03 100644 --- a/collects/scribblings/gui/snip-class.scrbl +++ b/collects/scribblings/gui/snip-class.scrbl @@ -338,9 +338,10 @@ following symbols: @item{@indexed-scheme['handles-events] --- this snip can handle keyboard and mouse events when it has the keyboard focus} - @item{@indexed-scheme['handles-all-mouse-events] --- this snip can handle - mouse events that touch the snip, even if the snip does not - have the keyboard focus} + @item{@indexed-scheme['handles-all-mouse-events] --- this snip can + handle mouse events that touch the snip or that immediately + follow an event that touches the snip, even if the snip does + not have the keyboard focus} @item{@indexed-scheme['width-depends-on-x] --- this snip's display width depends on the snip's x-@techlink{location} within the diff --git a/collects/scribblings/inside/custodians.scrbl b/collects/scribblings/inside/custodians.scrbl index c87a2f07e0..3aad44c400 100644 --- a/collects/scribblings/inside/custodians.scrbl +++ b/collects/scribblings/inside/custodians.scrbl @@ -103,5 +103,15 @@ Installs a function to be called on each custodian-registered item and void *d); } -where @var{d} is the second argument for @var{f}.} +where @var{d} is the second argument for @var{f}. +At-exit functions are run in reverse of the order that they are +added. An at-exit function is initially registered (and therefore runs +last) that flushes each file-stream output port. + +An at-exit function should not necessarily apply the closer function +for every object that it is given. In particular, shutting down a +file-stream output port would disable the flushing action of the final +at-exit function. Typically, an at-exit function ignores most objects +while handling a specific type of object that requires a specific +clean-up action before the OS-level process terminates.}