Enter histmode when no file is specified
[llpp.git] / BUILDING
blob9b15b54c3732f9d5ceac04fe48bbb9e807f9ee53
1 MuPDF[1] rendering library is used to do the actual work, so it needs
2 to be built and installed to use llpp.
4 Note that MuPDF is a moving target therefore below is the commit id
5 of the git version of MuPDF that this version of llpp is known to work
6 with:
7 eebc3385ebfa60574d78cf41badd6622987c1121
9 llpp also depends on OCaml[2], lablGL[3] having a C compiler wouldn't
10 hurt either. (mupdf depends on libcrypto[4] part of openssl)
12 To build llpp one can invoke `sh buildall.sh' which will first attempt
13 to automatically fetch lablGL, mupdf, mupdf's prerequisites and build
14 them, then, if everything goes fine, it will proceed building llpp
15 itself. Note that OCaml and libcrypto still needs to be installed
16 separately, also, in addition to the usual suspects (i.e.  GCC, make,
17 binutils, OCaml), you will need `wget' (or `curl'), `GNU tar' and
18 `unzip' for this script to work.
20 If everything goes fine llpp binary will appear, it can be used like so:
22 $ ./llpp /path/to/some.pdf
24 $ ./llpp -p password /path/to/some.password.protected.pdf
26 [1] http://www.mupdf.com
27 [2] http://caml.inria.fr/
28 [3] http://wwwfun.kurims.kyoto-u.ac.jp/soft/lsl/lablgl.html
29 [4] http://www.openssl.org/docs/crypto/crypto.html