@@ -234,3 +234,19 @@ This means that when you upload your site, it will usually transfer all files --
234234this can generate more traffic than necessary, since it is possible that some
235235files were not actually modified. If you use `rsync`, you can counter this using
236236the `--checksum` option.
237+
238+Problems
239+--------
240+
241+### regex-pcre dependency on Mac OS X
242+
243+Hakyll requires [regex-pcre], which might fail to build on Mac OS X. To solve
244+this problem:
245+
246+- make sure the [pcre] C library is installed (via homebrew or macports);
247+- install [regex-pcre] using
248+ `cabal install --extra-include-dirs=/usr/local/include regex-pcre`;
249+- proceed to install Hakyll the regular way.
250+
251+[regex-pcre]: http://hackage.haskell.org/package/regex-pcre
252+[pcre]: http://www.pcre.org/