The cpphs package

[Tags:lgpl, library, program]

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]


Versions 1.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, 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 (info)
Change log CHANGELOG
Dependencies base (>3 && <4.8), directory, old-locale, old-time [details]
License LGPL
Copyright 2004-2012, Malcolm Wallace
Author Malcolm Wallace <>
Maintainer Malcolm Wallace <>
Category Development
Home page
Source repository head: darcs get
Uploaded Tue Jan 22 17:15:12 UTC 2013 by MalcolmWallace
Updated Wed Dec 24 20:35:55 UTC 2014 by HerbertValerioRiedel to revision 1
Distributions Arch:1.20.5, Debian:1.19.3, Fedora:1.20.3, FreeBSD:1.19, LTSHaskell:1.20.5, NixOS:1.20.5, Stackage:1.20.5, Tumbleweed:1.20.5
Downloads 143224 total (4823 in the last 30 days)
0 []
Status Docs uploaded by user
Build status unknown [no reports yet]




Maintainer's Corner

For package maintainers and hackage trustees

Readme for cpphs

Readme for cpphs-1.16

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