Some cleanup for make-2.0 changes

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

Headers/Foundation/NSBundle.h

@@ -386,11 +386,28 @@ GS_EXPORT NSString* const NSLoadedClasses;
  */
 @interface NSBundle (GNUstep)
 
-/** This method is an experimental GNUstep extension, and
- *  might change.  At the moment, search on the standard GNUstep
- *  directories (starting from GNUSTEP_USER_ROOT, and going on to
- *  GNUSTEP_SYSTEM_ROOT) for a directory
- *  Libraries/Resources/'libraryName'/.
+/** This method is an experimental GNUstep extension, and might change.
+ * <p>Return a bundle which accesses the first existing directory from
+ * the standard libraries directories whose Resources subdirectory
+ * contains libraryName.
+ * Where libraryName is the name of a library without the <em>lib</em>
+ * prefix or any extensions.
+ * </p>
+ * <p>This method exists to provide resource bundles for libraries and has no
+ * particular relationship to the library code itsself.  The named library
+ * could be a dynamic library linked in to the running program, a static
+ * library (whose code may not even exist on the host machine except where
+ * it is linked in to the program), or even a library which is not linked
+ * into the program at all (eg. where you want to share resources provided
+ * for a library you do not actually use).
+ * </p>
+ * <p>The bundle for the library <em>gnustep-base</em> is a special case ...
+ * for this bundle the -principalClass method returns [NSObject] and the
+ * -executablePath method returns the path to the gnustep-base dynamic
+ *  library (if it can be found).  As a general rule, library bundles are
+ *  not guaranteed to return values for these methods as the library may
+ *  not exist on disk.
+ * </p>
  */
 + (NSBundle *) bundleForLibrary: (NSString *)libraryName;