INSTALL

   1 REQUIREMENTS:
   2 =============
   3
   4 See machine-specific requirements further down.
   5
   6 Dia needs Gtk+ at least version 2.0.0 installed.
   7 It can be found at:
   8
   9 ftp://ftp.gtk.org/pub/gtk/v2.0/
  10
  11 Binaries available at:
  12   ftp://ftp.gtk.org/pub/gtk/binary/devel/RPMS/
  13 or
  14   ftp://ftp.gtk.org/pub/gtk/binary/devel/DEBIAN/
  15
  16 Note that Gtk 2.0 has a number of requirements of its own whose exact
  17 versions depend on the version of Gtk.
  18
  19 Pango (required by Gtk) needs to be at least version 1.1.5.  It can be
  20 found here:
  21   ftp://ftp.gtk.org/pub/gtk/v2.2/
  22
  23 As of version 0.91, Dia also needs libxml2, version 2.3.9 or higher.
  24 It can be found here:
  25   ftp://ftp.gnome.org/pub/gnome/sources/libxml/
  26
  27 As of version 0.91, Dia under Unix also needs freetype2, version 2.0.9 or
  28 higher.  It can be found here:
  29   http://www.freetype.org
  30
  31 As of version 0.91, Dia requires intltool version 0.21 or higher.  It is
  32 also required for Gtk.  It can be found here:
  33   ftp://ftp.gnome.org/pub/gnome/sources/intltool/
  34
  35 A full list of packages required for building Dia in the order in which
  36 they should be installed.  Note that if the versions here are just the
  37 minimum required by Dia, if you plan to use a newer GTK+, you'll need a
  38 newer GLib and ATK at the least.  When possible, use the newest stable
  39 release.
  40
  41 pkg-config
  42 intltool 0.21
  43 font-config 1.0.1
  44 GLib 2.1.3
  45 ATK 2.0.0
  46 FreeType 2.0.9
  47 Pango 1.1.5
  48 GTK+ 2.0.0
  49 libxml 2.3.9
  50
  51 A number of other libraries are recommends for extra features:
  52
  53 Libart allows anti-aliased rendering and anti-aliased export to PNG:
  54   http://www.artofcode.com/libart.html
  55 Libpng is required for anti-aliased PNG export:
  56   http://download.sourceforge.net/libpng/
  57 Libxslt allows export through XSLT translation schemas:
  58   ftp://ftp.gnome.org/pub/GNOME/sources/libxslt/
  59 Extra Gnome support (limited) is available with installation of the gnome
  60   libs:
  61   ftp://ftp.gnome.org/pub/GNOME/sources/gnome-libs/
  62   Note that ./configure must be run with --enable-gnome to use Gnome.
  63 Python scripting is possible by adding --with-python and having the
  64   following installed:
  65   Python: http://www.python.org
  66   PyGtk: ftp://ftp.gtk.org/pub/gtk/python/v2.0
  67
  68 BUILDING:
  69 =========
  70
  71 To build, run:
  72
  73  ./configure
  74  make
  75
  76 PLATFORM NOTES:
  77 ===============
  78
  79 AFS
  80         The fact that you on AFS can make hard links within, but not
  81         between directories might cause problems due to a bug in
  82         libtool (at least som versions).
  83         What happens is that messages like
  84                 Waiting for arc.o.lock to be removed
  85         repeats themselves during compliation.
  86
  87         A couple of work arounds are
  88         available: Run configure with the flag
  89         --disable-libtool-lock. This might break parallel builds
  90         though. Another (uglier) fix is to hack the libtool script
  91         generated by configure. Change the line:
  92
  93           until ln "$0" "$lockfile" 2>/dev/null; do
  94
  95         to
  96
  97           until ln "$srcfile" "$lockfile" 2>/dev/null; do
  98
  99 Solaris
 100         The gettext that comes with Solaris doesn't define
 101         bind_textdomain_codeset.  Use the gettext and libiconv from
 102         ftp.gnu.org instead.
 103
 104 COMPILING FROM CVS:
 105 ===================
 106
 107 If you are using the cvs version of Dia you need to have the following programs:
 108 automake 1.4, autoconf 2.50, libtool 1.3, GNU gettext 0.10.38, intltool 0.21
 109
 110 Then run ./autogen.sh instead of configure to create all needed files.
 111
 112 WARNING: if you run ./autogen.sh, you will need to have gettext
 113 0.10.38 installed, or to extract a few M4 files from that package and
 114 include them manually into aclocal.m4.
 115
 116 TRYING IT OUT:
 117 ==============
 118
 119 You can try out dia in the compilation directory by running
 120  ./app/run_dia.sh
 121
 122 INSTALL:
 123 ========
 124 install it by doing:
 125
 126  make install
 127
 128 By default Dia is installed in /usr/local.
 129 You can change that by passing --prefix=/some/dir to configure.
 130
 131
 132 FONTS:
 133 ======
 134 I recommend that you install the URW fonts if you haven't already.
 135 They are free scalable version of the standard postscript fonts.
 136
 137 Information and files can be found at:
 138
 139  http://www.gimp.org/fonts.html
 140
 141