/ Check-in [973c5c86]
Login
SQLite training in Houston TX on 2019-11-05 (details)
Part of the 2019 Tcl Conference

Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.

Overview
Comment:Begin updating API documentation to use the new MD5-hash based automatic requirements numbering. Comment changes only. Many similar changes will follow.
Downloads: Tarball | ZIP archive | SQL archive
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA1: 973c5c86eed31dcce54d14e71938f2e255f5f1c7
User & Date: drh 2009-12-08 15:16:54
Context
2009-12-08
15:35
Avoid pointer aliasing in the allocSpace() routine in vdbeaux.c. check-in: d6ae2751 user: drh tags: trunk
15:16
Begin updating API documentation to use the new MD5-hash based automatic requirements numbering. Comment changes only. Many similar changes will follow. check-in: 973c5c86 user: drh tags: trunk
14:34
Allow zero-length names for tables, columns, and indices. Fix for ticket [78e04e52eaf]. check-in: 7b1cfd65 user: drh tags: trunk
Changes
Hide Diffs Side-by-Side Diffs Ignore Whitespace Patch

Changes to src/sqlite.h.in.

    72     72   # undef SQLITE_VERSION
    73     73   #endif
    74     74   #ifdef SQLITE_VERSION_NUMBER
    75     75   # undef SQLITE_VERSION_NUMBER
    76     76   #endif
    77     77   
    78     78   /*
    79         -** CAPI3REF: Compile-Time Library Version Numbers {H10010} <S60100>
           79  +** CAPI3REF: Compile-Time Library Version Numbers
    80     80   **
    81         -** The SQLITE_VERSION and SQLITE_VERSION_NUMBER #defines in
    82         -** the sqlite3.h file specify the version of SQLite with which
    83         -** that header file is associated.
    84         -**
    85         -** The "version" of SQLite is a string of the form "W.X.Y" or "W.X.Y.Z".
    86         -** The W value is major version number and is always 3 in SQLite3.
    87         -** The W value only changes when backwards compatibility is
    88         -** broken and we intend to never break backwards compatibility.
    89         -** The X value is the minor version number and only changes when
    90         -** there are major feature enhancements that are forwards compatible
    91         -** but not backwards compatible.
    92         -** The Y value is the release number and is incremented with
    93         -** each release but resets back to 0 whenever X is incremented.
    94         -** The Z value only appears on branch releases.
    95         -**
    96         -** The SQLITE_VERSION_NUMBER is an integer that is computed as
    97         -** follows:
    98         -**
    99         -** <blockquote><pre>
   100         -** SQLITE_VERSION_NUMBER = W*1000000 + X*1000 + Y
   101         -** </pre></blockquote>
           81  +** ^(The [SQLITE_VERSION] C preprocessor macro in the sqlite3.h header
           82  +** evaluates to a string literal that is the SQLite version in the
           83  +** format "X.Y.Z" where X is the major version number (always 3 for
           84  +** SQLite3) and Y is the minor version number and Z is the release number.)^
           85  +** ^(The [SQLITE_VERSION_NUMBER] C preprocessor macro resolves to an integer
           86  +** with the value (X*1000000 + Y*1000 + Z) where X, Y, and Z are the same
           87  +** numbers used in [SQLITE_VERSION].)^
           88  +** The SQLITE_VERSION_NUMBER for any given release of SQLite will also
           89  +** be larger than the release from which it is derived.  Either Y will
           90  +** be held constant and Z will be incremented or else Y will be incremented
           91  +** and Z will be reset to zero.
   102     92   **
   103     93   ** Since version 3.6.18, SQLite source code has been stored in the
   104         -** <a href="http://www.fossil-scm.org/">fossil configuration management
   105         -** system</a>.  The SQLITE_SOURCE_ID
   106         -** macro is a string which identifies a particular check-in of SQLite
   107         -** within its configuration management system.  The string contains the
   108         -** date and time of the check-in (UTC) and an SHA1 hash of the entire
   109         -** source tree.
           94  +** <a href="http://www.fossil-scm.org/">Fossil configuration management
           95  +** system</a>.  ^The SQLITE_SOURCE_ID macro evalutes to
           96  +** a string which identifies a particular check-in of SQLite
           97  +** within its configuration management system.  ^The SQLITE_SOURCE_ID
           98  +** string contains the date and time of the check-in (UTC) and an SHA1
           99  +** hash of the entire source tree.
   110    100   **
   111    101   ** See also: [sqlite3_libversion()],
   112    102   ** [sqlite3_libversion_number()], [sqlite3_sourceid()],
   113    103   ** [sqlite_version()] and [sqlite_source_id()].
   114         -**
   115         -** Requirements: [H10011] [H10014]
   116    104   */
   117    105   #define SQLITE_VERSION        "--VERS--"
   118    106   #define SQLITE_VERSION_NUMBER --VERSION-NUMBER--
   119    107   #define SQLITE_SOURCE_ID      "--SOURCE-ID--"
   120    108   
   121    109   /*
   122         -** CAPI3REF: Run-Time Library Version Numbers {H10020} <S60100>
          110  +** CAPI3REF: Run-Time Library Version Numbers
   123    111   ** KEYWORDS: sqlite3_version
   124    112   **
   125    113   ** These interfaces provide the same information as the [SQLITE_VERSION],
   126         -** [SQLITE_VERSION_NUMBER], and [SQLITE_SOURCE_ID] #defines in the header,
          114  +** [SQLITE_VERSION_NUMBER], and [SQLITE_SOURCE_ID] C preprocessor macros
   127    115   ** but are associated with the library instead of the header file.  Cautious
   128    116   ** programmers might include assert() statements in their application to
   129    117   ** verify that values returned by these interfaces match the macros in
   130    118   ** the header, and thus insure that the application is
   131    119   ** compiled with matching library and header files.
   132    120   **
   133    121   ** <blockquote><pre>
   134    122   ** assert( sqlite3_libversion_number()==SQLITE_VERSION_NUMBER );
   135    123   ** assert( strcmp(sqlite3_sourceid(),SQLITE_SOURCE_ID)==0 );
   136         -** assert( strcmp(sqlite3_libversion,SQLITE_VERSION)==0 );
          124  +** assert( strcmp(sqlite3_libversion(),SQLITE_VERSION)==0 );
   137    125   ** </pre></blockquote>
   138    126   **
   139         -** The sqlite3_libversion() function returns the same information as is
   140         -** in the sqlite3_version[] string constant.  The function is provided
   141         -** for use in DLLs since DLL users usually do not have direct access to string
   142         -** constants within the DLL.  Similarly, the sqlite3_sourceid() function
   143         -** returns the same information as is in the [SQLITE_SOURCE_ID] #define of
   144         -** the header file.
          127  +** ^The sqlite3_version[] string constant contains the text of [SQLITE_VERSION]
          128  +** macro.  ^The sqlite3_libversion() function returns a pointer to the
          129  +** to the sqlite3_version[] string constant.  The sqlite3_libversion()
          130  +** function is provided for use in DLLs since DLL users usually do not have
          131  +** direct access to string constants within the DLL.  ^The
          132  +** sqlite3_libversion_number() function returns an integer equal to
          133  +** [SQLITE_VERSION_NUMBER].  ^The sqlite3_sourceid() function a pointer
          134  +** to a string constant whose value is the same as the [SQLITE_SOURCE_ID]
          135  +** C preprocessor macro.
   145    136   **
   146    137   ** See also: [sqlite_version()] and [sqlite_source_id()].
   147         -**
   148         -** Requirements: [H10021] [H10022] [H10023]
   149    138   */
   150    139   SQLITE_EXTERN const char sqlite3_version[];
   151    140   const char *sqlite3_libversion(void);
   152    141   const char *sqlite3_sourceid(void);
   153    142   int sqlite3_libversion_number(void);
   154    143   
   155    144   /*