Install header ... document it.

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

Author: rfm

Diff for: ChangeLog

@@ -3,6 +3,7 @@ Fri May 07 09:15:00 2004  Richard Frith-Macdonald  <[email protected]>
 	Add methods to log duration of any statements over a certain
 	limit.
 	Tidy instance variables ... prefix mprivate ones with underscore.
+	Install header!
 
 Thu Apr 29 15:20:00 2004  Richard Frith-Macdonald  <[email protected]>
 

Diff for: GNUmakefile

@@ -2,6 +2,8 @@ include $(GNUSTEP_MAKEFILES)/common.make
 
 -include config.make
 
+PACKAGE_NAME = SQLClient
+
 TEST_TOOL_NAME = testPostgres testMySQL testECPG
 testPostgres_OBJC_FILES = testPostgres.m
 testPostgres_LIB_DIRS += -L./obj
@@ -17,8 +19,14 @@ testECPG_LIB_DIRS += -L./obj
 
 
 LIBRARY_NAME=SQLClient
+
 SQLClient_OBJC_FILES = SQLClient.m
 
+SQLClient_HEADER_FILES = SQLClient.h 
+
+
+SQLClient_HEADER_FILES_INSTALL_DIR = SQLClient
+
 
 DOCUMENT_NAME=SQLClient
 SQLClient_AGSDOC_FILES = SQLClient.h

Diff for: SQLClient.h

@@ -130,6 +130,11 @@
 	to modify <code>configure.ac</code> so that it will detect the
 	required headers and libraries on your system, and supply na patch.
       </item>
+      <item>
+        Once the library is installed, you can include the header file
+	<code>&lt;SQLClient/SQLClient.h%gt;</code> and link your programs
+       	with the <code>SQLClient</code> library to use it.
+      </item>
     </list>
     <p>
       Bug reports, patches, and contributions (eg a backend bundle for a

Diff for: SQLClient.html

@@ -12,8 +12,8 @@ <h3>Authors</h3>
       <dd>
       </dd>
     </dl>
-    <p><b>Version:</b> 1.2</p>
-    <p><b>Date:</b> 2004/04/27 08:23:15</p>
+    <p><b>Version:</b> 1.4</p>
+    <p><b>Date:</b> 2004/05/07 08:16:16</p>
     <p><b>Copyright:</b> (C) 2004 Free Software Foundation, Inc.</p>
 
         <div>
@@ -217,6 +217,15 @@ <h2><a name="001003000000">
             supply na patch.
 
       </li>
+      <li>
+        
+            Once the library is installed, you can include the
+            header file
+            <code>&lt;SQLClient/SQLClient.h%gt;</code> and link
+            your programs with the <code>SQLClient</code> library
+            to use it.
+          
+      </li>
     </ul>
     <p>
 
@@ -268,60 +277,40 @@ <h2><a name="class$SQLClient">SQLClient</a> : <a rel="gsdoc" href="/usr/home/bra
     </p>
     <br/><hr width="50%" align="left" />
     <h2>Instance Variables for SQLClient Class</h2>
-    <h3><a name="ivariable$SQLClient*client">client</a></h3>
-    @private NSString* <b>client</b>;<br />
+    <h3><a name="ivariable$SQLClient*_client">_client</a></h3>
+    @private NSString* <b>_client</b>;<br />
     <p>
 
             Identifier within backend
 
     </p>
     <hr width="25%" align="left" />
-    <h3><a name="ivariable$SQLClient*connected">connected</a></h3>
-    @private BOOL <b>connected</b>;<br />
-    <p>
-      
-            A flag indicating whether this instance is currently
-            connected to the backend database server. This
-            variable must <em>only</em> be set by the
-            <a rel="gsdoc" href="#method$SQLClient-backendConnect">
-              -backendConnect
-            </a>
-
-            or
-            <a rel="gsdoc" href="#method$SQLClient-backendDisconnect">
-              -backendDisconnect
-            </a>
-
-            methods.
-          
-    </p>
-    <hr width="25%" align="left" />
-    <h3><a name="ivariable$SQLClient*database">database</a></h3>
-    @private NSString* <b>database</b>;<br />
+    <h3><a name="ivariable$SQLClient*_database">_database</a></h3>
+    @private NSString* <b>_database</b>;<br />
     <p>
 
             The configured database name/host
 
     </p>
     <hr width="25%" align="left" />
-    <h3><a name="ivariable$SQLClient*debugging">debugging</a></h3>
-    @private unsigned int <b>debugging</b>;<br />
+    <h3><a name="ivariable$SQLClient*_debugging">_debugging</a></h3>
+    @private unsigned int <b>_debugging</b>;<br />
     <p>
 
             The current debugging level
 
     </p>
     <hr width="25%" align="left" />
-    <h3><a name="ivariable$SQLClient*extra">extra</a></h3>
-    @private void* <b>extra</b>;<br />
+    <h3><a name="ivariable$SQLClient*_duration">_duration</a></h3>
+    @private NSTimeInterval <b>_duration</b>;<br />
     <p>
 
-            For subclass specific data
+            <em>Description forthcoming.</em>
 
     </p>
     <hr width="25%" align="left" />
-    <h3><a name="ivariable$SQLClient*inTransaction">inTransaction</a></h3>
-    @private BOOL <b>inTransaction</b>;<br />
+    <h3><a name="ivariable$SQLClient*_inTransaction">_inTransaction</a></h3>
+    @private BOOL <b>_inTransaction</b>;<br />
     <p>
 
             A flag indicating whether this instance is currently
@@ -341,8 +330,8 @@ <h3><a name="ivariable$SQLClient*inTransaction">inTransaction</a></h3>
 
     </p>
     <hr width="25%" align="left" />
-    <h3><a name="ivariable$SQLClient*lastOperation">lastOperation</a></h3>
-    @private NSDate* <b>lastOperation</b>;<br />
+    <h3><a name="ivariable$SQLClient*_lastOperation">_lastOperation</a></h3>
+    @private NSDate* <b>_lastOperation</b>;<br />
     <p>
 
             Timestamp of last operation. <br /> Maintained by
@@ -360,35 +349,63 @@ <h3><a name="ivariable$SQLClient*lastOperation">lastOperation</a></h3>
 
     </p>
     <hr width="25%" align="left" />
-    <h3><a name="ivariable$SQLClient*lock">lock</a></h3>
-    @private NSRecursiveLock* <b>lock</b>;<br />
+    <h3><a name="ivariable$SQLClient*_name">_name</a></h3>
+    @private NSString* <b>_name</b>;<br />
     <p>
 
-            Maintain thread-safety
+            Unique identifier for instance
 
     </p>
     <hr width="25%" align="left" />
-    <h3><a name="ivariable$SQLClient*name">name</a></h3>
-    @private NSString* <b>name</b>;<br />
+    <h3><a name="ivariable$SQLClient*_password">_password</a></h3>
+    @private NSString* <b>_password</b>;<br />
     <p>
 
-            Unique identifier for instance
+            The configured password
 
     </p>
     <hr width="25%" align="left" />
-    <h3><a name="ivariable$SQLClient*password">password</a></h3>
-    @private NSString* <b>password</b>;<br />
+    <h3><a name="ivariable$SQLClient*_user">_user</a></h3>
+    @private NSString* <b>_user</b>;<br />
     <p>
 
-            The configured password
+            The configured user
 
     </p>
     <hr width="25%" align="left" />
-    <h3><a name="ivariable$SQLClient*user">user</a></h3>
-    @private NSString* <b>user</b>;<br />
+    <h3><a name="ivariable$SQLClient*connected">connected</a></h3>
+    @private BOOL <b>connected</b>;<br />
     <p>
 
-            The configured user
+            A flag indicating whether this instance is currently
+            connected to the backend database server. This
+            variable must <em>only</em> be set by the
+            <a rel="gsdoc" href="#method$SQLClient-backendConnect">
+              -backendConnect
+            </a>
+
+            or
+            <a rel="gsdoc" href="#method$SQLClient-backendDisconnect">
+              -backendDisconnect
+            </a>
+
+            methods.
+          
+    </p>
+    <hr width="25%" align="left" />
+    <h3><a name="ivariable$SQLClient*extra">extra</a></h3>
+    @private void* <b>extra</b>;<br />
+    <p>
+      
+            For subclass specific data
+          
+    </p>
+    <hr width="25%" align="left" />
+    <h3><a name="ivariable$SQLClient*lock">lock</a></h3>
+    @private NSRecursiveLock* <b>lock</b>;<br />
+    <p>
+      
+            Maintain thread-safety
 
     </p>
     <hr width="25%" align="left" />
@@ -399,10 +416,14 @@ <h3><a name="ivariable$SQLClient*user">user</a></h3>
       <li><a rel="gsdoc" href="SQLClient.html#method$SQLClient(Convenience)-queryString:,...">-queryString:,...</a></li>
       <li><a rel="gsdoc" href="SQLClient.html#method$SQLClient(Convenience)-singletons:">-singletons:</a></li>
       <li><a rel="gsdoc" href="SQLClient.html#method$SQLClient(Logging)+debugging">+debugging</a></li>
+      <li><a rel="gsdoc" href="SQLClient.html#method$SQLClient(Logging)+durationLogging">+durationLogging</a></li>
       <li><a rel="gsdoc" href="SQLClient.html#method$SQLClient(Logging)+setDebugging:">+setDebugging:</a></li>
+      <li><a rel="gsdoc" href="SQLClient.html#method$SQLClient(Logging)+setDurationLogging:">+setDurationLogging:</a></li>
       <li><a rel="gsdoc" href="SQLClient.html#method$SQLClient(Logging)-debug:,...">-debug:,...</a></li>
       <li><a rel="gsdoc" href="SQLClient.html#method$SQLClient(Logging)-debugging">-debugging</a></li>
+      <li><a rel="gsdoc" href="SQLClient.html#method$SQLClient(Logging)-durationLogging">-durationLogging</a></li>
       <li><a rel="gsdoc" href="SQLClient.html#method$SQLClient(Logging)-setDebugging:">-setDebugging:</a></li>
+      <li><a rel="gsdoc" href="SQLClient.html#method$SQLClient(Logging)-setDurationLogging:">-setDurationLogging:</a></li>
       <li><a rel="gsdoc" href="SQLClient.html#method$SQLClient(Subclass)-backendConnect">-backendConnect</a></li>
       <li><a rel="gsdoc" href="SQLClient.html#method$SQLClient(Subclass)-backendDisconnect">-backendDisconnect</a></li>
       <li><a rel="gsdoc" href="SQLClient.html#method$SQLClient(Subclass)-backendExecute:">-backendExecute:</a></li>
@@ -1371,18 +1392,31 @@ <h2><a rel="gsdoc" href="#class$SQLClient">SQLClient</a>(<a name="category$SQLCl
     <b>Method summary</b>
     <ul>
       <li><a rel="gsdoc" href="SQLClient.html#method$SQLClient+debugging">+debugging</a></li>
+      <li><a rel="gsdoc" href="SQLClient.html#method$SQLClient+durationLogging">+durationLogging</a></li>
       <li><a rel="gsdoc" href="SQLClient.html#method$SQLClient+setDebugging:">+setDebugging:</a></li>
+      <li><a rel="gsdoc" href="SQLClient.html#method$SQLClient+setDurationLogging:">+setDurationLogging:</a></li>
       <li><a rel="gsdoc" href="SQLClient.html#method$SQLClient-debug:,...">-debug:,...</a></li>
       <li><a rel="gsdoc" href="SQLClient.html#method$SQLClient-debugging">-debugging</a></li>
+      <li><a rel="gsdoc" href="SQLClient.html#method$SQLClient-durationLogging">-durationLogging</a></li>
       <li><a rel="gsdoc" href="SQLClient.html#method$SQLClient-setDebugging:">-setDebugging:</a></li>
+      <li><a rel="gsdoc" href="SQLClient.html#method$SQLClient-setDurationLogging:">-setDurationLogging:</a></li>
     </ul>
     <hr width="50%" align="left" />
     <h3><a name="method$SQLClient(Logging)+debugging">debugging&nbsp;</a></h3>
     + (unsigned int) <b>debugging</b>;<br />
     <p>
 
             Return the class-wide debugging level, which is
-            inherited by all newly created minstances.
+            inherited by all newly created instances.
+          
+    </p>
+    <hr width="25%" align="left" />
+    <h3><a name="method$SQLClient(Logging)+durationLogging">durationLogging&nbsp;</a></h3>
+    + (<a rel="gsdoc" href="/usr/home/brains99/GNUstep/System/Library/Documentation/Developer/Base/Reference/TypesAndConstants.html#type$NSTimeInterval">NSTimeInterval</a>) <b>durationLogging</b>;<br />
+    <p>
+      
+            Return the class-wide duration logging threshold,
+            which is inherited by all newly created instances.
 
     </p>
     <hr width="25%" align="left" />
@@ -1393,6 +1427,15 @@ <h3><a name="method$SQLClient(Logging)+setDebugging:">setDebugging:&nbsp;</a></h
             Set the debugging <var>level</var> to be inherited by
             all new instances.
 
+    </p>
+    <hr width="25%" align="left" />
+    <h3><a name="method$SQLClient(Logging)+setDurationLogging:">setDurationLogging:&nbsp;</a></h3>
+    + (void) <b>setDurationLogging:</b> (<a rel="gsdoc" href="/usr/home/brains99/GNUstep/System/Library/Documentation/Developer/Base/Reference/TypesAndConstants.html#type$NSTimeInterval">NSTimeInterval</a>)threshold;<br />
+    <p>
+      
+            Set the duration logging <var>threshold</var> to be
+            inherited by all new instances.
+          
     </p>
     <hr width="25%" align="left" />
     <h3><a name="method$SQLClient(Logging)-debug:,...">debug:&nbsp;,...</a></h3>
@@ -1411,6 +1454,18 @@ <h3><a name="method$SQLClient(Logging)-debugging">debugging&nbsp;</a></h3>
 
             Return the current debugging level.
 
+    </p>
+    <hr width="25%" align="left" />
+    <h3><a name="method$SQLClient(Logging)-durationLogging">durationLogging&nbsp;</a></h3>
+    - (<a rel="gsdoc" href="/usr/home/brains99/GNUstep/System/Library/Documentation/Developer/Base/Reference/TypesAndConstants.html#type$NSTimeInterval">NSTimeInterval</a>) <b>durationLogging</b>;<br />
+    <p>
+      
+            Returns the threshold above which queries and
+            statements taking a long time to execute are
+            logged. A negative value (default) indicates that
+            this logging is disabled. A value of zero means that
+            all statements are logged.
+          
     </p>
     <hr width="25%" align="left" />
     <h3><a name="method$SQLClient(Logging)-setDebugging:">setDebugging:&nbsp;</a></h3>
@@ -1421,6 +1476,17 @@ <h3><a name="method$SQLClient(Logging)-setDebugging:">setDebugging:&nbsp;</a></h
             overrides the default <var>level</var> inherited
             from the class.
 
+    </p>
+    <hr width="25%" align="left" />
+    <h3><a name="method$SQLClient(Logging)-setDurationLogging:">setDurationLogging:&nbsp;</a></h3>
+    - (void) <b>setDurationLogging:</b> (<a rel="gsdoc" href="/usr/home/brains99/GNUstep/System/Library/Documentation/Developer/Base/Reference/TypesAndConstants.html#type$NSTimeInterval">NSTimeInterval</a>)threshold;<br />
+    <p>
+      
+            Set a <var>threshold</var> above which queries and
+            statements taking a long time to execute are
+            logged. A negative value (default) disables this
+            logging. A value of zero logs all statements.
+          
     </p>
     <hr width="25%" align="left" />