@@ -184,6 +184,32 @@ If you have already built pandoc, you may need to do a `make clean` or
184184
185185[`highlighting-kate` library]: http://johnmacfarlane.net/highlighting-kate
186186
187+Optional citeproc support
188+-------------------------
189+
190+Pandoc can optionally be compiled with support for bibliographic citations
191+using Andrea Rossato's [`citeproc-hs` library]. This allows you
192+to specify citations in markdown using an intuitive syntax (for example,
193+`[jones2005@p. 3; smith2006]`). These are automatically changed into
194+appropriately styled citations in the output, and a bibliography is
195+added. The bibliography data and style information are taken from XML
196+files that must be specified on the command line. (Note: `citeproc-hs`
197+support is experimental, and the interface may change in the future.)
198+
199+If you are using Cabal to compile pandoc, specify the `citeproc` flag in
200+the configure step:
201+
202+ runhaskell Setup configure -fciteproc
203+
204+If you are using the Makefile:
205+
206+ CABALOPTS=-fciteproc make
207+
208+If you have already built pandoc, you may need to do a `make clean` or
209+`runhaskell Setup clean` first.
210+
211+[`citeproc-hs` library]: http://code.haskell.org/citeproc-hs/
212+
187213Other targets
188214-------------
189215