Checklist For SQLite

  1. Compiler warning checks.
    1. Linux GCC -Wall -Wextra (the tool/warnings.sh script)
    2. Mac GCC -Wall -Wextra (the tool/warnings.sh script)
    3. OpenBSD GCC using options -Wall
    4. Windows MSVC Win64 /W3

  2. Documentation checks:
    1. Latest release on the index.html page
    2. Release announcement in changes.in
    3. Release accouncement in news.html
    4. No unresolved hyperlinks in the documentation build
    5. Requirements marks are up-to-date in both documentation and source code
    6. The compile-time options are all up-to-date (compile.html)
    7. Check new/changed documentation for spelling and gramatical mistakes

  3. Source code change review. "fossil diff --from version- --to branch-3.8.7"
    1. No stray changes
    2. All significant changes are mentioned in the "changes" log of the documentation
    3. New code complies with style guidelines
    4. New code complies with design rules
    5. Comments have been updated to reflect code changes
    6. Variables and functions have been renamed to reflect changes in their use
    7. Check all calls to sqlite3OsRead() and sqlite3OsWrite() to ensure that offset computations are 64-bit clean.
    8. Check all calls to memory allocation routines to ensure that size computations are 64-bit clean. Suggested regular expression for search: /(Re|M)alloc[FORZa-z]*(/
    9. Verify that source code contains no tabs and that surplus whitespace has been removed.
    10. Verify that the list of APIs exposed via the extension header is up-to-date (sqlite3ext.h)

  4. Tests for platform Linux x86_64:
    1. tclsh th3make cov.rc (verify 100% branch test coverage)
    2. tclsh th3make cov.rc -DSQLITE_ENABLE_STAT4 (verify 100% branch test coverage)
    3. tclsh releasetest.tcl
    4. tclsh fulltest.tcl fast.rc test.rc
    5. tclsh th3make memdebug.rc
    6. tclsh th3make test.rc CC=clang
    7. tclsh th3make fast.rc CC=clang

  5. Tests for 32-bit x86 Linux
    1. tclsh th3make quick.rc -m32

  6. Tests for platform Linux ARM (BeagleBoard)
    1. tclsh th3make min.rc

  7. Tests for platform Mac OS-X x86:
    1. make fulltestonly
    2. tclsh th3make fast.rc CC=clang

  8. Tests for platform Win32/64:
    1. make test

  9. Tests for platform OpenBSD x86:
    1. make test

  10. Tests for platform Solaris Sparc:
    1. th3make fast.rc

  11. Other test performed on any available platform:
    1. th3make test.rc -ftrapv
    2. th3make test.rc CC=clang -fsanitize=undefined
    3. th3make quick.rc -valgrind
    4. valgrind testfixture permutations.test valgrind
    5. ./configure; make fulltest

  12. Exported symbol checks: tool/symbols.sh
    1. No private symbols exported. (This is also checked by releasetest.tcl)
    2. No undesirable library dependencies

  13. Run performance tests comparing the new SQLite release against the previous release.
    1. The speedtest1 program

  14. Run "make wordcount; bash run-wordcount.bash $OPTIONS" with options:
    1. bash run-wordcount.sh sqlite3.c
    2. bash run-wordcount.sh sqlite3.c --cachesize 5 --nosync