doc/INSTALL.Cygwin

   1
   2 Cygwin installation notes
   3 =========================
   4
   5 This is doc/INSTALL-Cygwin, which contains specific Freeciv installation
   6 information for the Cygwin platform.
   7
   8 A translated version of this file may be in language specific
   9 subdirectories of doc/.
  10
  11 See also the generic installation notes in INSTALL.
  12
  13 Cygwin is a free Unix variant for MS Windows operating systems.
  14 Recent versions come with an X server, Xorg.
  15
  16 To install Freeciv for Cygwin:
  17
  18 a) Install or update your Cygwin using the "Install Cygwin Now!" link
  19    on http://www.cygwin.com/;
  20
  21    In addition to default install, install at least following packages
  22    to build freeciv
  23    (packages to be installed as dependency of another one in the list
  24      are not listed):
  25    - gcc-g++ (section Development)
  26    - pkg-config (Development)
  27    - make (Development)
  28    - libiconv-devel (Libs)
  29    - libcurl-devel (Libs)
  30    - zlib-devel (Libs)
  31
  32   Install development package for the gui you want to compile, one of
  33   - libgtk2.0-devel (Libs)
  34   - libgtk3-devel (Libs)
  35
  36   For additional functionality install also:
  37    - libreadline-devel (Libs)
  38    - gettext-devel (Development)
  39
  40   To get and build freeciv development version directly from version control,
  41   you need also
  42    - subversion (Development)
  43    - automake1.14 (Development)
  44    - libtool (Development)
  45
  46   To run freeciv client, you need to install also
  47   - xlaunch (X11)
  48   - fontconfig (X11)
  49
  50 b) Get a Freeciv source tree (the doc/ subdirectory this file is in, is in source
  51    tree's top directory).
  52    Put it in a temporary place like /tmp.
  53
  54       ./configure --enable-client=<gui> [any other options e.g. --prefix=...]
  55    where <gui> is either "gtk2", "gtk3" or both as "gtk2,gtk3". If you
  56    didn't install gettext-devel, you have to give also configure option
  57    --disable-nls to disable Native Language Support.
  58
  59    If you are building directly from version control, and not from
  60    tarball that has some files, including ./configure, pregenerated,
  61    you need to run ./autogen.sh instead of ./configure. Use same options
  62    as you would for directly running ./configure.
  63
  64    If you get messages of missing or outdated components, install them.
  65
  66 c) Compile and install Freeciv:
  67
  68       make
  69       make install
  70
  71 You should now have bin/freeciv-server.exe and bin/freeciv-<gui>.exe in the
  72 directory you installed Freeciv into (/usr/local by default).
  73 If 'make install' succeeds, the source code tree can be removed.
  74
  75 d) Test the results:
  76
  77     /path/to/freeciv-server.exe  [any additional options]
  78
  79   will start the server, but you only need it for private games.
  80   To start the client, you need to run the X server (this can be
  81   done by typing 'xlaunch'), then into a terminal type
  82
  83     /path/to/freeciv-<gui>.exe  [any additional options]
  84
  85 More details on using server and client are in doc/README.