Documentation tweaks

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

Source/Additions/GSMime.m

@@ -599,7 +599,8 @@ wordData(NSString *word)
  * </p>
  * <p>
  *   On completion of parsing a valid document, the
- *   -document method returns the resulting parsed document.
+ *   [GSMimeDocument-mimeDocument] method returns the
+ *   resulting parsed document.
  * </p>
  */
 @implementation	GSMimeParser

Source/Additions/GSXML.m

@@ -1769,7 +1769,7 @@ static NSString	*endMarker = @"At end of incremental parse";
 
 /**
  * Set and return the previous value for blank text nodes support.
- * ignorableWhitespace() are only generated when running
+ * ignorableWhitespace nodes are only generated when running
  * the parser in validating mode and when the current element
  * doesn't allow CDATA or mixed content.
  */

Source/NSConnection.m

@@ -1225,8 +1225,8 @@ static BOOL	multi_threaded = NO;
 }
 
 /**
- * Simply invokes -registerName:usingNameServer: passing it the default
- * system nameserver.
+ * Simply invokes -registerName:withNameServer:
+ * passing it the default system nameserver.
  */
 - (BOOL) registerName: (NSString*)name
 {

Source/NSScanner.m

@@ -625,7 +625,7 @@ typedef struct {
  * placing it in <em>doubleValue</em> if that is not null.
  * Returns YES if anything is scanned, NO otherwise.
  * <br/>
- * On overflow, HUGE_VAL or -HUGE_VAL is put into <em>doubleValue</em>
+ * On overflow, HUGE_VAL or - HUGE_VAL is put into <em>doubleValue</em>
  * <br/>
  * On underflow, 0.0 is put into <em>doubleValue</em>
  * <br/>
@@ -750,7 +750,7 @@ typedef struct {
  * placing it in <em>floatValue</em> if that is not null.
  * Returns YES if anything is scanned, NO otherwise.
  * <br/>
- * On overflow, HUGE_VAL or -HUGE_VAL is put into <em>floatValue</em>
+ * On overflow, HUGE_VAL or - HUGE_VAL is put into <em>floatValue</em>
  * <br/>
  * On underflow, 0.0 is put into <em>floatValue</em>
  * <br/>

Source/NSURLHandle.m

@@ -191,7 +191,7 @@ static Class		NSURLHandleClass = 0;
 
 /**
  * Returns the most recently registered NSURLHandle subclass that
- * responds to -canInitWithURL: with YES.
+ * responds to +canInitWithURL: with YES.
  * If there is no such subclass, returns nil.
  */
 + (Class) URLHandleClassForURL: (NSURL*)url

Source/NSUnarchiver.m

@@ -296,7 +296,7 @@ mapClassName(NSUnarchiverObjectInfo *info)
  * This class reconstructs objects from an archive.<br />
  * <strong>Re-using the archiver</strong><br />
  * <p>
- *   The -resetUnarchiverWithdata:atIndex: method lets you re-use
+ *   The -resetUnarchiverWithData:atIndex: method lets you re-use
  *   the archive to decode a new data object or, in conjunction
  *   with the 'cursor' method (which reports the current decoding
  *   position in the archive), decode a second archive that exists
@@ -306,22 +306,19 @@ mapClassName(NSUnarchiverObjectInfo *info)
  * NSUnarchiver normally reads directly from an NSData object using
  * the methods -
  * <deflist>
- *   <term>[-deserializeTypeTagAtCursor:]</term>
+ *   <term>-deserializeTypeTag:andCrossRef:atCursor:</term>
  *   <desc>
  *     to decode type tags for data items, the tag is the
  *     first byte of the character encoding string for the
  *     data type (as provided by '@encode(xxx)'), possibly
  *     with the top bit set to indicate that what follows is
- *     a crossreference to an item already encoded.
- *   </desc>
- *   <term>[-deserializeCrossRefAtCursor:]</term>
- *   <desc>
- *     to decode a crossreference number either to identify the
+ *     a crossreference to an item already encoded.<br />
+ *     Also decode a crossreference number either to identify the
  *     following item, or to refer to a previously encoded item.
  *     Objects, Classes, Selectors, CStrings and Pointer items
  *     have crossreference encoding, other types do not.
  *   </desc>
- *   <term>[-deserializeData:ofObjCType:atCursor:context:]</term>
+ *   <term>[NSData-deserializeDataAt:ofObjCType:atCursor:context:]</term>
  *   <desc>
  *     to decode all other information.
  *   </desc>