extract C reference manpages from SQLite header file
C Roff Makefile
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
afl
samples
LICENSE.md
Makefile
README.md
compats.c
configure
main.c
sqlite2mdoc.1
tests.c

README.md

Synopsis

This utility accepts an SQLitee header file sqlite3.h and produces a set of decently well-formed mdoc(7) files documenting the C API. These will be roughly equivalent to the C-language Interface Specification for SQLite.

You can also use it for any file(s) using the documentation standards of SQLite. See the sqlite2mdoc.1 manpage for syntax details.

This GitHub repository is a read-only mirror of the project's CVS repository.

Note: this only works with sqlite3, not the original sqlite.h format.

Installation

Run ./configure then make.

This utility isn't meant for installation, but for integration into your SQLite deployment phase. You can run make install, however, if you plan on using it for other documentation.

There are no compile-time or run-time dependencies.

This software has been used on OpenBSD, Mac OS X, and Linux machines.

Examples

I've used mandoc to generate some Markdown from the mdoc(7) output.

License

All sources use the ISC (like OpenBSD) license. See the LICENSE.md file for details.