Document last tranch of changes

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

Documentation/gsdoc/Base.gsdoc

@@ -72,11 +72,53 @@
 	  <deflist>
 	    <term>GSMacOSXCompatibleGeometry</term>
 	    <desc>
-	      Specifies whether the functions for producing strings describing
+	      <p>
-	      geometrical structures (NSStringFromPoint(), NSStringFromSize(),
+		Specifies whether the functions for producing strings
-	      and NSStringFromRect()) should produce strings conforming to the
+		describing geometric structures (NSStringFromPoint(),
-	      OpenStep specification or to MacOS-X behavior.  The functions
+		NSStringFromSize(), and NSStringFromRect()) should produce
-	      for parsing those strings should cope with both cases anyway.
+		strings conforming to the OpenStep specification or to
+		MacOS-X behavior.  The functions for parsing those strings
+		should cope with both cases anyway.
+	      </p>
+	    </desc>
+	    <term>GSMacOSXCompatiblePropertyLists</term>
+	    <desc>
+	      <p>
+		Specifies whether text property-list output should be in
+		the default MacOS-X format (XML), or in the more human
+		readable (but less powerful) original OpenStep format.
+	      </p>
+	      <p>
+		Reading of property lists is supported in either format,
+		but <em>only</em> if GNUstep is built with the libxml
+		library (which is needed to handle XML parsing).
+	      </p>
+	      <p>
+		NB. MacOS-X generates illegal XML for some strings - those
+		which contain characters not legal in XML.  GNUstep always
+		generates legal XML, at the cost of a certain degree of
+		compatibility.  GNUstep XML property lists use a backslash
+		to escape illegal chatracters, and consequently any string
+		containing either a backslash or an illegal character will
+		be written differently to the same string on MacOS-X.
+	      </p>
+	    </desc>
+	    <term>NSWriteOldStylePropertyLists</term>
+	    <desc>
+	      <p>
+		Specifies whether text property-list output should be in
+		the default MacOS-X format (XML), or in the more human
+		readable (but less powerful) original OpenStep format.
+	      </p>
+	      <p>
+		If, GSMacOSXCompatible is YES, this default is treated
+		as being NO if it is not set, otherwise, this default
+		is treated as YES.
+	      </p>
+	      <p>
+		This default is <em>NOT</em> used if
+		GSMacOSXCompatiblePropertyLists is specified.
+	      </p>
 	    </desc>
 	  </deflist>
 	</subsect>

Documentation/gsdoc/NSArray.gsdoc

@@ -346,6 +346,15 @@
 	    TODO
           </desc>
         </method>
+        <method type="BOOL">
+          <sel>writeToURL:</sel>
+          <arg type="NSURL*">url</arg>
+          <sel>atomically:</sel>
+          <arg type="BOOL">flag</arg>
+          <desc>
+	    TODO
+          </desc>
+        </method>
       </class>
     </chapter>
   </body>

Documentation/gsdoc/NSDictionary.gsdoc

@@ -275,6 +275,15 @@
           <arg type="BOOL">flag</arg>
           <desc>
             
+          </desc>
+        </method>
+        <method type="BOOL">
+          <sel>writeToURL:</sel>
+          <arg type="NSURL*">url</arg>
+          <sel>atomically:</sel>
+          <arg type="BOOL">flag</arg>
+          <desc>
+            
           </desc>
         </method>
       </class>

Documentation/gsdoc/NSProcessInfo.gsdoc

@@ -53,6 +53,14 @@
           <desc>
           </desc>
         </method>
+        <method type="int">
+          <sel>processIdentifier</sel>
+          <desc>
+	    <p>
+	      Returns the number identifying this process on this system.
+	    </p>
+          </desc>
+        </method>
         <method type="NSString*">
           <sel>processName</sel>
           <desc>

Documentation/gsdoc/NSTask.gsdoc

@@ -90,6 +90,13 @@
           </desc>
         </method>
 
+        <method type="int">
+          <sel>processIdentifer</sel>
+          <desc>
+	    Returns the number identifying the child process on this system.
+          </desc>
+        </method>
+
         <method type="void">
           <sel>setArguments:</sel>
           <arg type="NSArray*">arguments</arg>
@@ -203,6 +210,24 @@
           </desc>
         </method>
 
+        <method type="BOOL">
+          <sel>resume</sel>
+          <desc>
+	    Sends a cont signal to the receiver and any subtasks.<br />
+	    If the task has not been launched, raises an
+	    NSInvalidArgumentException.<br /> 
+          </desc>
+        </method>
+
+        <method type="BOOL">
+          <sel>suspend</sel>
+          <desc>
+	    Sends a stop signal to the receiver and any subtasks.<br />
+	    If the task has not been launched, raises an
+	    NSInvalidArgumentException.<br /> 
+          </desc>
+        </method>
+
         <method type="void">
           <sel>terminate</sel>
           <desc>