From 020e3b86a17a39689d65489fa1e93f0483182b56 Mon Sep 17 00:00:00 2001
From: CaS <CaS@72102866-910b-0410-8b05-ffd578937521>
Date: Mon, 16 Jul 2001 19:39:21 +0000
Subject: [PATCH] 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          | 52 ++++++++++++++++++++++---
 Documentation/gsdoc/NSArray.gsdoc       |  9 +++++
 Documentation/gsdoc/NSDictionary.gsdoc  |  9 +++++
 Documentation/gsdoc/NSProcessInfo.gsdoc |  8 ++++
 Documentation/gsdoc/NSTask.gsdoc        | 25 ++++++++++++
 5 files changed, 98 insertions(+), 5 deletions(-)

diff --git a/Documentation/gsdoc/Base.gsdoc b/Documentation/gsdoc/Base.gsdoc
index 42da8482e..8256255f1 100644
--- a/Documentation/gsdoc/Base.gsdoc
+++ b/Documentation/gsdoc/Base.gsdoc
@@ -72,11 +72,53 @@
 	  <deflist>
 	    <term>GSMacOSXCompatibleGeometry</term>
 	    <desc>
-	      Specifies whether the functions for producing strings describing
-	      geometrical structures (NSStringFromPoint(), NSStringFromSize(),
-	      and NSStringFromRect()) should produce strings conforming to the
-	      OpenStep specification or to MacOS-X behavior.  The functions
-	      for parsing those strings should cope with both cases anyway.
+	      <p>
+		Specifies whether the functions for producing strings
+		describing geometric structures (NSStringFromPoint(),
+		NSStringFromSize(), and NSStringFromRect()) should produce
+		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>
diff --git a/Documentation/gsdoc/NSArray.gsdoc b/Documentation/gsdoc/NSArray.gsdoc
index 4fb6f65f8..9f0da0203 100644
--- a/Documentation/gsdoc/NSArray.gsdoc
+++ b/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>
diff --git a/Documentation/gsdoc/NSDictionary.gsdoc b/Documentation/gsdoc/NSDictionary.gsdoc
index cf1281f40..600b29ac8 100644
--- a/Documentation/gsdoc/NSDictionary.gsdoc
+++ b/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>
diff --git a/Documentation/gsdoc/NSProcessInfo.gsdoc b/Documentation/gsdoc/NSProcessInfo.gsdoc
index cd5c4c73d..77ef80b4e 100644
--- a/Documentation/gsdoc/NSProcessInfo.gsdoc
+++ b/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>
diff --git a/Documentation/gsdoc/NSTask.gsdoc b/Documentation/gsdoc/NSTask.gsdoc
index 0e7452fcd..b09f362d6 100644
--- a/Documentation/gsdoc/NSTask.gsdoc
+++ b/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>