Correction for #16688 as well as some other minor changes.

git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/libs/gui/trunk@22994 72102866-910b-0410-8b05-ffd578937521

Source/NSDocument.m

@@ -207,7 +207,11 @@
   _window = aWindow;
 }
 
-//FIXME: In the later specification this method has a different return type!! 
+/**
+ * Creates the window controllers for the current document.  Calls
+ * addWindowController: on the receiver to add them to the controller 
+ * array.
+ */
 - (void) makeWindowControllers
 {
   NSString *name = [self windowNibName];