diff --git a/ChangeLog b/ChangeLog index 17388d4..53e3569 100644 --- a/ChangeLog +++ b/ChangeLog @@ -3,6 +3,7 @@ Fri May 07 09:15:00 2004 Richard Frith-Macdonald 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 diff --git a/GNUmakefile b/GNUmakefile index 4b7b6a7..290fa8c 100644 --- a/GNUmakefile +++ b/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 --git a/SQLClient.h b/SQLClient.h index 9300c5f..eee74f1 100644 --- a/SQLClient.h +++ b/SQLClient.h @@ -130,6 +130,11 @@ to modify configure.ac so that it will detect the required headers and libraries on your system, and supply na patch. + + Once the library is installed, you can include the header file + <SQLClient/SQLClient.h%gt; and link your programs + with the SQLClient library to use it. +

Bug reports, patches, and contributions (eg a backend bundle for a diff --git a/SQLClient.html b/SQLClient.html index c37f09e..3808cea 100644 --- a/SQLClient.html +++ b/SQLClient.html @@ -12,8 +12,8 @@

-

Version: 1.2

-

Date: 2004/04/27 08:23:15

+

Version: 1.4

+

Date: 2004/05/07 08:16:16

Copyright: (C) 2004 Free Software Foundation, Inc.

@@ -217,6 +217,15 @@ Current backend bundles are -

supply na patch. +
  • + + Once the library is installed, you can include the + header file + <SQLClient/SQLClient.h%gt; and link + your programs with the SQLClient library + to use it. + +

    • @@ -268,12 +277,100 @@ Current backend bundles are -


    Instance Variables for SQLClient Class

    -

    client

    - @private NSString* client;
    +

    _client

    + @private NSString* _client;

    Identifier within backend +

    +
    +

    _database

    + @private NSString* _database;
    +

    + + The configured database name/host + +

    +
    +

    _debugging

    + @private unsigned int _debugging;
    +

    + + The current debugging level + +

    +
    +

    _duration

    + @private NSTimeInterval _duration;
    +

    + + Description forthcoming. + +

    +
    +

    _inTransaction

    + @private BOOL _inTransaction;
    +

    + + A flag indicating whether this instance is currently + within a transaction. This variable must + only be set by the + + -begin + + + , -commit + or + + -rollback + + + methods.
    Are we inside a transaction? + +

    +
    +

    _lastOperation

    + @private NSDate* _lastOperation;
    +

    + + Timestamp of last operation.
    Maintained by + the + + -simpleExecute: + + + and + + -simpleQuery: + + + methods. + +

    +
    +

    _name

    + @private NSString* _name;
    +

    + + Unique identifier for instance + +

    +
    +

    _password

    + @private NSString* _password;
    +

    + + The configured password + +

    +
    +

    _user

    + @private NSString* _user;
    +

    + + The configured user +

    connected

    @@ -294,22 +391,6 @@ Current backend bundles are -

    methods. -

    -
    -

    database

    - @private NSString* database;
    -

    - - The configured database name/host - -

    -
    -

    debugging

    - @private unsigned int debugging;
    -

    - - The current debugging level -

    extra

    @@ -318,46 +399,6 @@ Current backend bundles are -

    For subclass specific data -

    -
    -

    inTransaction

    - @private BOOL inTransaction;
    -

    - - A flag indicating whether this instance is currently - within a transaction. This variable must - only be set by the - - -begin - - - , -commit - or - - -rollback - - - methods.
    Are we inside a transaction? - -

    -
    -

    lastOperation

    - @private NSDate* lastOperation;
    -

    - - Timestamp of last operation.
    Maintained by - the - - -simpleExecute: - - - and - - -simpleQuery: - - - methods. -

    lock

    @@ -366,30 +407,6 @@ Current backend bundles are -

    Maintain thread-safety -

    -
    -

    name

    - @private NSString* name;
    -

    - - Unique identifier for instance - -

    -
    -

    password

    - @private NSString* password;
    -

    - - The configured password - -

    -
    -

    user

    - @private NSString* user;
    -

    - - The configured user -



    @@ -399,10 +416,14 @@ Current backend bundles are -

  • -queryString:,...
  • -singletons:
  • +debugging
    • +
  • +durationLogging
  • +setDebugging:
    • +
  • +setDurationLogging:
  • -debug:,...
  • -debugging
    • +
  • -durationLogging
  • -setDebugging:
    • +
  • -setDurationLogging:
  • -backendConnect
  • -backendDisconnect
  • -backendExecute:
    • @@ -1371,10 +1392,14 @@ NULL field items are returned as NSNull objects.

    Method summary

    debugging 

    @@ -1382,7 +1407,16 @@ NULL field items are returned as NSNull objects.

    Return the class-wide debugging level, which is - inherited by all newly created minstances. + inherited by all newly created instances. + +

    +
    +

    durationLogging 

    + + (NSTimeInterval) durationLogging;
    +

    + + Return the class-wide duration logging threshold, + which is inherited by all newly created instances.

    @@ -1393,6 +1427,15 @@ NULL field items are returned as NSNull objects.

    Set the debugging level to be inherited by all new instances. +

    +
    +

    setDurationLogging: 

    + + (void) setDurationLogging: (NSTimeInterval)threshold;
    +

    + + Set the duration logging threshold to be + inherited by all new instances. +

    debug: ,...

    @@ -1411,6 +1454,18 @@ NULL field items are returned as NSNull objects.

    Return the current debugging level. +

    +
    +

    durationLogging 

    + - (NSTimeInterval) durationLogging;
    +

    + + 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. +

    setDebugging: 

    @@ -1421,6 +1476,17 @@ NULL field items are returned as NSNull objects.

    overrides the default level inherited from the class. +

    +
    +

    setDurationLogging: 

    + - (void) setDurationLogging: (NSTimeInterval)threshold;
    +

    + + Set a threshold 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. +