debian/INSTALL.debian

   1 If you have a Debian system
   2 ===========================
   3
   4 Debian is a group of volunteers who make free operating systems (by
   5 integrating free kernels with lots of free programs). Currently there is one
   6 such system, Debian GNU/Linux (running on many hardware platforms), but
   7 others may exist on the future. You can find more information about Debian
   8 at http://www.debian.org/
   9
  10 There are versions of Freeciv in Debian GNU/Linux since version 2.0 (which
  11 shipped with Freeciv 1.5.4). Version 2.2 ships with version 1.9.0 and the
  12 latest stable freeciv version can usually be found in the testing or
  13 unstable distributions.
  14
  15 Of course, maybe the source tree where you're reading this file is newer
  16 than any version available on your Debian CD or in the ftp mirrors -
  17 probably a svn grab - or you want to build it yourself for some other
  18 reason (like applying unofficial patches). Ok, you can have your cake and
  19 eat it too; we made a script to easily build a .deb package directly out of
  20 the source tree - and get a nice version number if it's a svn snapshot, too.
  21
  22 First you will need to check if you have the following packages installed:
  23
  24 Common requirements:
  25 gcc (duh, you didn't expect to compile anything without gcc did you?)
  26 libc6-dev
  27 libreadline4-dev
  28 zlib1g-dev
  29 xlib6g-dev
  30 dpkg-dev
  31 dh-make
  32
  33 For the gtk client:
  34 gdk-imlib-dev
  35 libglib1.2-dev
  36 libgtk1.2-dev
  37 imlib-progs
  38
  39 For the xaw client:
  40 xaw3dg-dev
  41 libxpm4-dev
  42 xaw-wrappers
  43
  44 Now, make any changes you want to make to the tree - like applying patches.
  45 Then, just cd to the top directory of the source tree (the directory where
  46 this file is located) and run the script "./build.debian". The script have
  47 to either be run as root, or with Debian's nice "fakeroot" utility. It would
  48 also be better if you first set your email address in the environment, so
  49 that it doesn't have to ask. It is a good idea to run "make distclean"
  50 before building to make sure any previously generated files do not interfere.
  51 Typically:
  52
  53 $ cd /somewhere/freeciv
  54 $ export EMAIL="Your Name <address@host.com>"
  55 $ make distclean
  56 $ fakeroot build.debian
  57 $ su
  58 # dpkg -i ../freeciv_1.11.5+svn20010419_i386.deb
  59 # exit
  60 $
  61
  62 (Of course, the name of the actual .deb file will be different, as will the
  63 setting of the EMAIL variable. The build.debian script will inform you of
  64 the name of the .deb file if it runs successfully.)