BUILDING

   1 MuPDF[1] rendering library is used to do the actual work, so it needs
   2 to be built and installed to use llpp, MuPDF's README[2] describes how
   3 to build it and lists its dependencies. Snapshots of MuPDF itself can
   4 be found here[3], dependencies here[4]
   5
   6 Note that MuPDF is a moving target therefore bellow is the commit id
   7 of the git version of MuPDF that this version of llpp is known to work
   8 with:
   9 50dbc1a356577f3df15a876f6adb716dea29bdc5
  10
  11 llpp also depends on OCaml[5], lablGL[6] and GLUT[7], having a C
  12 compiler wouldn't hurt either.
  13
  14 To build llpp "the easy way" one can invoke `sh buildall.sh' which
  15 will first attempt to automatically fetch lablGL, mupdf, mupdf's
  16 prerequisites and build them, then, if everything goes fine, it will
  17 proceed building llpp itself. Note that OCaml and GLUT still need to
  18 be installed separately.
  19
  20 Otherwise, provided that all prereqs are already built, one should
  21 invoke `sh build.sh' from the top of llpp's directory, prior to that
  22 it's advisable to review build.sh so that it matches local mupdf
  23 installation (or lack thereof)
  24
  25 If everything goes fine llpp binary will appear, it can be used like so:
  26
  27 $ ./llpp /path/to/some.pdf
  28 or
  29 $ ./llpp -p password /path/to/some.password.protected.pdf
  30
  31 [1] http://www.mupdf.com
  32 [2] http://mupdf.com/repos/mupdf/README
  33 [3] http://mupdf.com/download/snapshots/
  34 [4] http://mupdf.com/download/source/mupdf-thirdparty.zip
  35 [5] http://caml.inria.fr/
  36 [6] http://wwwfun.kurims.kyoto-u.ac.jp/soft/lsl/lablgl.html
  37 [7] http://www.opengl.org/resources/libraries/glut/
  38     http://freeglut.sourceforge.net/
  39
  40 Building on windows is for masochists and left as an exercise to
  41 the reader