Tspec - An API Specification Tool

Katherine Flavel, The TenDRA Project (copyeditor)
Jeroen Ruigrok van der Werven, The TenDRA Project (copyeditor)
DERA

First published 1998.

Revision History

2015-02-27	kate	Moved out usage to the tspec manpage.
2007-09-14	kate	Added example of nested subsets.
2006-09-23	eirik	Add `+DEFMIN` to allow us to correctly check for macro that only has a minimum value set in the standard. This is basically a `+DEFINE` and a few checks to see what value the macro has before defining it.
2004-06-17	asmodai	Document the -V flag, which shows tspec's and TenDRA's version. Fix the -s description to correctly note it is opposed to -a and not -c.
1998-07-30	DERA	Tspec 2.8; TenDRA 4.1.2 release.
–	DERA	Tspec 2.0; This document describes tspec version 2. tspec 2 contains significant changes from previous releases. For convenience the main changes which are visible to the tspec user are listed here. The added specification level of named subsets of headers has been introduced (see §1.1). This has been done by introducing the `+SUBSET` construct and extending the `+IMPLEMENT` and `+USE` constructs, as well as the command-line options. The previous method of dealing with such subsets - namely shared headers - is now obsolete and its use is discouraged. A number of new command-line options have been added, and some of the existing options have been modified slightly. The suffix `.api` has been added to the output directories (see §1.3) to avoid possible confusion with other include file directories. The use of identifiers beginning with `~` as local variables is new (see §3.2). The `+STATEMENT` and `+DEFINE` constructs (see §3.6 and §3.7) are new. The `(extern)`, `(weak)` and `(const)` qualifiers for `+FUNC` and `+EXP` (see §3.3 and §3.4) are new. The `(signed)` and `(unsigned)` qualifiers for `+TYPE` (see §3.8) are new. The `~special` type constructor (see §3.9) is new. The `~abstract` type constructor has been abandoned. The `+BASE_API` command described in §5.1 is new. The indexing routines (see §5.3) have been greatly improved.