INSTALL

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