README
author ali <ali@juiblex.co.uk>
Fri Jan 27 10:30:16 2012 +0000 (2012-01-27)
changeset 5 f600b0d1fc5d
parent 0 c2f4c0285180
child 6 faab25d520dd
permissions -rw-r--r--
Rename to bookloupe
     1                                    bookloupe
     2                                    =========
     3 
     4 General installation instructions can be found in INSTALL. The following
     5 aim to give a quick overview and some help for specific systems. Documentation
     6 for bookloupe itself can be found in doc/bookloupe.txt and for the test
     7 framework in doc/loupe-test.txt.
     8 
     9 Linux
    10 -----
    11 
    12 You should be able to use the standard:
    13 
    14 % ./configure
    15 % make
    16 % sudo make install
    17 
    18 If you get an error about no package 'glib-2.0' found, then you need to
    19 install the development package for glib2. Under Fedora, RHEL and friends
    20 that would be:
    21 
    22 % sudo yum install gcc pkgconfig glib2-devel
    23 
    24 Under Debian, Ubuntu and friends that would be:
    25 
    26 % sudo apt-get install gcc pkgconfig glib2-devel
    27 
    28 If you get really stuck, you can use the --without-glib option to configure,
    29 but this may well not be supported in a future version so this is probably
    30 best avoided.
    31 
    32 Microsoft Windows
    33 -----------------
    34 
    35 It should be possible to use MSYS (http://www.mingw.org/wiki/MSYS) to build
    36 on a Windows machine. You'll need a copy of the development package for
    37 glib and its dependencies from http://www.gtk.org/download/win32.php.
    38 
    39 It's much easier to build using a cross-compiler from Linux, if you have
    40 access to such a system. Under Fedora, RHEL and friends you can do this
    41 with:
    42 
    43 % sudo yum install mingw32-gcc pkgconfig mingw32-glib2-static \
    44   mingw32-gettext-static mingw32-iconv-static
    45 % ./configure --host=i686-w64-mingw32 --disable-shared \
    46   --bindir=/bookloupe --datadir=/
    47 % make
    48 % mkdir build
    49 % make install DESTDIR=`pwd`/build
    50 
    51 The contents of the build/bookloupe directory can then be copied to a
    52 Microsoft Windows machine.
    53 
    54 Depending on the version of mingw32-gcc you use, you may need to specify a
    55 different host type. If you're not sure look and see what the cross-compiler
    56 is called (eg., i686-pc-mingw32-gcc) and use the prefix as the host type.
    57 
    58 Mac
    59 ---
    60 
    61 I think this should be quite similar to Linux, doing something like this:
    62 
    63 % sudo port install gcc pkgconfig glib2-devel
    64 % ./configure
    65 % make
    66 % sudo make install
    67 
    68 It may also be possible to use fink instead of macports.