[RFC]: menuForEvent note

[Adam Fedor]

I doubt this will end the discussion :-) but I though this note would 
not be that bad...

2003-06-21  Adam Fedor  <fedor@gnu.org>

        * Source/NSView.m (-menuForEvent:): Add note about this
        method beign discouraged.

Index: Source/NSView.m
===================================================================
RCS file: /cvsroot/gnustep/gnustep/core/gui/Source/NSView.m,v
retrieving revision 1.209
diff -u -r1.209 NSView.m
--- Source/NSView.m     13 Jun 2003 15:01:12 -0000      1.209
+++ Source/NSView.m     21 Jun 2003 12:31:23 -0000
@@ -3818,6 +3818,13 @@
  *    (although it seems it can be used for any kind of event)</p>
  * <p>This method is used by NSView's rightMouseDown: method, 
  *    and the returned NSMenu is displayed as a context menu</p> 
+ * <p>Use of this method is discouraged in GNUstep as it breaks many
+ *    user interface guidelines. At the very least, menu items that appear
+ *    in a context sensitive menu should also always appear in a normal
+ *    menu. Otherwise, user are faced with an inconsistant interface where
+ *    the menu items they want are only available in certain (possibly
+ *    unknown) cases, making it difficult for the user to understand how
+ *    the application operates</p>
  * <p> see [NSResponder -menu], [NSResponder -setMenu:],
  *     [NSView +defaultMenu] and [NSView -menu].
  * </p>