The cpphs package

This is a package candidate release! Here you can preview how this package release will appear once published to the main package index (which can be accomplished via the 'maintain' link below). Please note that once a package has been published to the main package index it cannot be undone! Please consult the package uploading documentation for more information.


Cpphs is a re-implementation of the C pre-processor that is both more compatible with Haskell, and itself written in Haskell so that it can be distributed with compilers.

This version of the C pre-processor is pretty-much feature-complete and compatible with traditional (K&R) pre-processors. Additional features include: a plain-text mode; an option to unlit literate code files; and an option to turn off macro-expansion.

[Skip to ReadMe]


Versions1.3, 1.5, 1.6, 1.7, 1.8, 1.9, 1.10, 1.11, 1.12, 1.13, 1.13.1, 1.13.2, 1.13.3, 1.14, 1.15, 1.16, 1.17, 1.17.1, 1.18, 1.18, 1.18.1, 1.18.2, 1.18.3, 1.18.4, 1.18.5, 1.18.6, 1.18.7, 1.18.8, 1.18.9, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.20.7, 1.20.8
Dependenciesbase (>3 && <6), directory, old-locale, old-time [details]
Copyright2004-2013, Malcolm Wallace
AuthorMalcolm Wallace <>
MaintainerMalcolm Wallace <>
Home page
Source repositoryhead: darcs clone
UploadedWed Feb 5 15:47:28 UTC 2014 by MalcolmWallace




Maintainers' corner

For package maintainers and hackage trustees

Readme for cpphs-1.18

[back to package description]
This directory contains 'cpphs', a simplified but robust
re-implementation of cpp, the C pre-processor, in Haskell.

Just use
    hmake cpphs [-package base]
    ghc --make cpphs [-o cpphs]		#  -o needed for ghc <= 6.4.1 ]
    runhugs cpphs	# or rename the script cpphs.hugs to cpphs

	cpphs  [filename | -Dsym | -Dsym=val | -Ipath]+  [-Ofile]
               [ --include=file ]*
               [ --nomacro | --noline | --nowarn | --strip | --strip-eol |
                 --pragma | --text | --hashes | --layout | --unlit |
                 --linepragma ]*
               [ --cpp compatopts ]

For fuller details, see docs/index.html

If you want to use cpphs as a completely drop-in replacement for the
real cpp, that is, to accept the same arguments, and have broadly
the same behaviour in response to them, then use the --cpp compatibility

Copyright (c) 2004-2013 Malcolm Wallace (
except for Text.ParserCombinators.HuttonMeijer (Copyright (c) 1995
Graham Hutton and Erik Meijer).

These library modules are distributed under the terms of the LGPL.
The application module 'cpphs.hs' is GPL.

This software comes with no warranty.  Use at your own risk.

If you have a commercial use for cpphs, and feel the terms of the (L)GPL
are too onerous, you have the option of distributing unmodified binaries
(only, not sources) under the terms of a different licence (see

darcs get