clarify gsdoc explaining why Apple docs not followed

git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/libs/gui/trunk@20808 72102866-910b-0410-8b05-ffd578937521
This commit is contained in:
Adrian Robert 2005-02-28 04:18:06 +00:00
parent e15644db69
commit 51e0bb96e8
2 changed files with 13 additions and 2 deletions

View file

@ -1,3 +1,10 @@
2005-02-27 Adrian Robert <arobert@cogsci.ucsd.edu>
* Source/NSApplication.m (-runModalForWindow:) Clarify gsdoc
explaining why we don't follow Apple docs here. (Corrects gsdoc
from change on 2005-01-26, which itself documented a code change on
2005-01-18.)
2005-02-26 18:04 Alexander Malmberg <alexander@malmberg.org>
* Headers/Additions/GNUstepGUI/GSServicesManager.h: Include the

View file

@ -1369,8 +1369,12 @@ immediately.
<p>
Although Apple's docs state that, before processing the events, it makes the
session window key and orders the window front, this method does not attempt
to do this (due to excessive overhead). Therefore you should do it yourself
beforehand, if needed.
to do this, because: 1) we don't want to interfere with use of other apps
during modal session for this app; 2) occasionally other windows are active
and should be usable during modal sessions (e.g., a popup dialog from a modal
window); 3) most of the time -beginModalSessionForWindow: will have been
called in advance. If the latter is not the case, you may need to order the
window front yourself in advance.
</p>
<p>
See Also: -runModalForWindow: