documentation fixups

Headers/Foundation/NSArray.h

@@ -172,10 +172,8 @@ typedef NSUInteger NSBinarySearchingOptions;
 
 #if OS_API_VERSION(MAC_OS_X_VERSION_10_6, GS_API_LATEST)
 
-DEFINE_BLOCK_TYPE(GSEnumeratorBlock, void, GS_GENERIC_TYPE(ElementT),
-  NSUInteger, BOOL*);
-DEFINE_BLOCK_TYPE(GSPredicateBlock, BOOL, GS_GENERIC_TYPE(ElementT),
-  NSUInteger, BOOL*);
+DEFINE_BLOCK_TYPE(GSEnumeratorBlock, void, GS_GENERIC_TYPE(ElementT), NSUInteger, BOOL*);
+DEFINE_BLOCK_TYPE(GSPredicateBlock, BOOL, GS_GENERIC_TYPE(ElementT), NSUInteger, BOOL*);
 /**
  * Enumerate over the collection using the given block.  The first argument is
  * the object and the second is the index in the array.  The final argument is

Headers/Foundation/NSDictionary.h

@@ -67,8 +67,7 @@ extern "C" {
 			     indent: (NSUInteger)level;
 
 #if OS_API_VERSION(MAC_OS_X_VERSION_10_6, GS_API_LATEST)
-DEFINE_BLOCK_TYPE(GSKeysAndObjectsEnumeratorBlock, void,
-  GS_GENERIC_TYPE_F(KeyT,id<NSCopying>), GS_GENERIC_TYPE(ValT), BOOL*);
+DEFINE_BLOCK_TYPE(GSKeysAndObjectsEnumeratorBlock, void, GS_GENERIC_TYPE_F(KeyT,id<NSCopying>), GS_GENERIC_TYPE(ValT), BOOL*);
 - (void) enumerateKeysAndObjectsUsingBlock:
   (GSKeysAndObjectsEnumeratorBlock)aBlock;
 - (void) enumerateKeysAndObjectsWithOptions: (NSEnumerationOptions)opts
@@ -99,8 +98,7 @@ DEFINE_BLOCK_TYPE(GSKeysAndObjectsEnumeratorBlock, void,
 - (GS_GENERIC_CLASS(NSEnumerator,KeyT)*) keyEnumerator;	// Primitive
 
 #if OS_API_VERSION(MAC_OS_X_VERSION_10_6, GS_API_LATEST)
-DEFINE_BLOCK_TYPE(GSKeysAndObjectsPredicateBlock, BOOL,
-	GS_GENERIC_TYPE_F(KeyT,id<NSCopying>), GS_GENERIC_TYPE(ValT), BOOL*);
+DEFINE_BLOCK_TYPE(GSKeysAndObjectsPredicateBlock, BOOL, GS_GENERIC_TYPE_F(KeyT,id<NSCopying>), GS_GENERIC_TYPE(ValT), BOOL*);
 - (GS_GENERIC_CLASS(NSSet,KeyT)*) keysOfEntriesPassingTest:
     (GSKeysAndObjectsPredicateBlock)aPredicate;
 - (GS_GENERIC_CLASS(NSSet,KeyT)*) keysOfEntriesWithOptions:

Headers/Foundation/NSFileManager.h

@@ -329,12 +329,12 @@ typedef NSUInteger NSDirectoryEnumerationOptions;
 
 #if OS_API_VERSION(MAC_OS_X_VERSION_10_6, GS_API_LATEST)
 /**
- * Returns an array of NSURL of the contents of the specified directory. <br>
+ * Returns an array of NSURL of the contents of the specified directory. <br />
  * The listing is shallow and does not recurse into subdirectories.
  * The special files '.' and '..' are excluded but it can return
- * hidden files.<br>
+ * hidden files.<br />
  * The only mask option supported is
- * NSDirectoryEnumerationSkipsHiddenFiles.<br>
+ * NSDirectoryEnumerationSkipsHiddenFiles.<br />
  * The current implementation handles only files and property keys are ignored.
  */
 - (NSArray*) contentsOfDirectoryAtURL: (NSURL*)url
@@ -391,6 +391,11 @@ typedef NSUInteger NSDirectoryEnumerationOptions;
  * </p>
  */
 - (NSDirectoryEnumerator*) enumeratorAtPath: (NSString*)path;
+
+/** Returns the attributes dictionary for the file at the specified path.
+ * If that file is a symbolic link, the flag determines whether the attributes
+ * returned are those of the link or those of the destination file.
+ */
 - (NSDictionary*) fileAttributesAtPath: (NSString*)path
 			  traverseLink: (BOOL)flag;
 

Source/DocMakefile

@@ -188,6 +188,8 @@ Base_AGSDOC_FLAGS = \
 	-VariablesTemplate TypesAndConstants \
 	-WordMap '{\
 	GS_PRIVATE_INTERNAL="//";\
+	DEFINE_BLOCK_TYPE="//";\
+	WEAK_ATTRIBUTE="";\
 	WINAPI="";\
 	}' -Up Base