Language.Preprocessor.Cpphs

Run a first pass of cpp, evaluating #ifdef's and processing #include's, whilst taking account of #define's and #undef's as we encounter them.

tokenise is, broadly-speaking, Prelude.words, except that: * the input is already divided into lines * each word-like "token" is categorised as one of {Ident,Other,Cmd} * #define's are parsed and returned out-of-band using the Cmd variant * All whitespace is preserved intact as tokens. * C-comments are converted to white-space (depending on first param) * Parens and commas are tokens in their own right. * Any cpp line continuations are respected. No errors can be raised. The inverse of tokenise is (concatMap deWordStyle).

Each token is classified as one of Ident, Other, or Cmd: * Ident is a word that could potentially match a macro name. * Cmd is a complete cpp directive (#define etc). * Other is anything else.

Walk through the document, replacing calls of macros with the expanded RHS.

Walk through the document, replacing calls of macros with the expanded RHS. Additionally returns the active symbol table after processing.

Cpphs options structure.

Options representable as Booleans.

Parse all command-line options.

Default options.

Default settings of boolean options.

Increment column number by given quantity.

Sigh. Mixing Windows filepaths with unix is bad. Make sure there is a canonical path separator.

Conversion from a cpp-style "#line" to haskell-style pragma.

cpp-style printing of file position

Project the directory of the filename.

Project the filename.

haskell-style printing of file position

Project the line number.

Constructor. Argument is filename.

Increment row number, reset column to 1.

Increment row number by given quantity.

Update position with a new row, and possible filename.

Increment column number, tab stops are every 8 chars.

Source positions contain a filename, line, column, and an inclusion point, which is itself another source position, recursively.