From 94c6a1b250c812bd3f6d74332bd2f10b41623285 Mon Sep 17 00:00:00 2001 From: fiddlosopher Date: Mon, 16 Jul 2007 16:30:04 +0000 Subject: Updated INSTALL instructions with some extra clarifications and links. git-svn-id: https://pandoc.googlecode.com/svn/trunk@737 788f1e2b-df1e-0410-8736-df70ead52e1b --- INSTALL | 35 ++++++++++++++++++----------------- 1 file changed, 18 insertions(+), 17 deletions(-) (limited to 'INSTALL') diff --git a/INSTALL b/INSTALL index 6e0e3d1e2..73ea90c15 100644 --- a/INSTALL +++ b/INSTALL @@ -1,13 +1,22 @@ -% Installing Pandoc +% Installing pandoc + +The following instructions are for installing pandoc from source. Binary +packages are also available for Windows, MacOS X, Linux (Debian and +derivatives), and FreeBSD. See the [pandoc home page] for more details. + +[pandoc home page]: http://sophos.berkeley.edu/macfarlane/pandoc/ # Installing GHC To compile Pandoc, you'll need [GHC] version 6.6 or greater. If you don't have GHC already, you can get it from the [GHC Download] -page. +page. If you're running MacOS X, you can also install GHC using +[MacPorts] or [Fink]. [GHC]: http://www.haskell.org/ghc/ [GHC Download]: http://www.haskell.org/ghc/download.html +[MacPorts]: http://macports.org +[Fink]: http://finkproject.org You'll also need standard build tools: [GNU `make`], `sed`, `bash`, and `perl`. These are standard on unix systems (including MacOS @@ -31,18 +40,6 @@ X). If you're using Windows, you can install [Cygwin]. make test - If you want to try `pandoc` before installing it (the next step), - run it with a `./` prefix, as follows: - - ./pandoc README - - If you want to try the shell scripts (`hsmarkdown`, `html2markdown`, - and `markdown2pdf`) before installing `pandoc`, you will need to set - your path to include the build directory, so that the scripts will - find the version of `pandoc` you have just built. So, for example: - - PATH=.:$PATH html2markdown http://haskell.org - 4. Install: sudo make install @@ -66,6 +63,10 @@ X). If you're using Windows, you can install [Cygwin]. make build-all sudo make install-all + Note that building the library documentation requires [haddock]. + +[haddock]: http://www.haskell.org/haddock/ + # Removing Pandoc Each of the installation steps described above can be reversed: @@ -107,7 +108,7 @@ but are documented here for packagers and developers: * `test`: Runs Pandoc's test suite. (All tests should pass.) * `test-markdown`: Runs the Markdown regression test suite, using - `pandoc --strict`. (One of the list tests will fail.) + `pandoc --strict`. (Three of the tests will fail.) ## Cleaning @@ -116,6 +117,8 @@ but are documented here for packagers and developers: ## Packaging +* `tarball`: Creates a source tarball for distribution. +* `deb`: Creates debian packages in `..` directory. * `osx-pkg-prep`: Prepares for building a MacOS X package. * `osx-pkg`: Builds a MacOS X package (must be run as root, and on OS X). You should make `osx-pkg-prep` first (not as root). @@ -123,7 +126,5 @@ but are documented here for packagers and developers: (must be run on OS X). You should make `osx-pkg` first. * `win-pkg`: Creates a Windows binary package (presupposes `pandoc.exe`, which must be created by building Pandoc on a Windows machine). -* `tarball`: Creates a source tarball for distribution. -* `deb`: Creates debian packages in `..` directory. * `website`: Creates Pandoc's website in `web/pandoc` directory. -- cgit v1.2.3