wesnoth/INSTALL

97 lines
2.7 KiB
Plaintext
Raw Normal View History

2003-11-21 00:52:27 +00:00
Prerequisites:
Initial code import. [[The Wesnoth repository started off as CVS in September 2003 on SourceForge. In September 2005 it was converted to Subversion using cvs2svn and hosted at Gna!; the last CVS commit corresponded to Subversion r8374. In March 2013 it was converted to git by ESR using reposurgeon 2.30; the last Subversion commit was r56594. In the process, several small, abandoned experimental branches were removed. For all branches known to have been merged to trunk merge points were found and patched in. Comments have been massaged into git summary + body form; revision references have been lifted to action stamps. Conversion comments are, like this one, enclosed in double square brackets. Typos in change comments have often been quietly fixed. Some abbreviations (notably for mainline campaign names) have been made more uniform than they were in the Subversion comments. Infix "::" to mark a campaign-scenario pair (as in "HttT::12" has sometimes been inserted for clarity and to shorten summary lines. Two branches, website/ and resources/, have been merged to trunk, where their history now appears as that of those two top-level directories rather than as separate branches. Subversion property settings, and the commits in the Subversion history that manipulated them, are almost all gone. A few have been translated to .gitignore files and setting of executable bits. There are a few committers that we have been unable to identify. These are: uso zas uid65860 uid66289 uid67456 uid68698 uid68803 uid68842 uid68850 uid68852 uid69097 uid69206 The uid names seem to have been mechanically generated from Wesnoth forum postings. Committer lines for all of these have been left without a domain name in the email address.]]
2003-09-15 11:52:41 +00:00
2006-06-06 00:05:03 +00:00
You'll need to have these libraries (with equivalent devel versions) to build Wesnoth:
libsdl1.2.7
libsdl-image1.2 (with png support)
libsdl-mixer1.2 (with Vorbis support)
2006-06-05 14:00:19 +00:00
libsdl-net
libsdl-ttf2.0.8
libz
boost_iostreams >= 1.33.0
boost_regex >= 1.33.0
You will need the following tools:
python2.4
scons
Initial code import. [[The Wesnoth repository started off as CVS in September 2003 on SourceForge. In September 2005 it was converted to Subversion using cvs2svn and hosted at Gna!; the last CVS commit corresponded to Subversion r8374. In March 2013 it was converted to git by ESR using reposurgeon 2.30; the last Subversion commit was r56594. In the process, several small, abandoned experimental branches were removed. For all branches known to have been merged to trunk merge points were found and patched in. Comments have been massaged into git summary + body form; revision references have been lifted to action stamps. Conversion comments are, like this one, enclosed in double square brackets. Typos in change comments have often been quietly fixed. Some abbreviations (notably for mainline campaign names) have been made more uniform than they were in the Subversion comments. Infix "::" to mark a campaign-scenario pair (as in "HttT::12" has sometimes been inserted for clarity and to shorten summary lines. Two branches, website/ and resources/, have been merged to trunk, where their history now appears as that of those two top-level directories rather than as separate branches. Subversion property settings, and the commits in the Subversion history that manipulated them, are almost all gone. A few have been translated to .gitignore files and setting of executable bits. There are a few committers that we have been unable to identify. These are: uso zas uid65860 uid66289 uid67456 uid68698 uid68803 uid68842 uid68850 uid68852 uid69097 uid69206 The uid names seem to have been mechanically generated from Wesnoth forum postings. Committer lines for all of these have been left without a domain name in the email address.]]
2003-09-15 11:52:41 +00:00
SDL* libraries can be found at http://www.libsdl.org . libfreetype can be found
at http://www.freetype.org/ . python can be found at http://www.python.org .
The boost libraries can be found at http://www.boost.org .
Initial code import. [[The Wesnoth repository started off as CVS in September 2003 on SourceForge. In September 2005 it was converted to Subversion using cvs2svn and hosted at Gna!; the last CVS commit corresponded to Subversion r8374. In March 2013 it was converted to git by ESR using reposurgeon 2.30; the last Subversion commit was r56594. In the process, several small, abandoned experimental branches were removed. For all branches known to have been merged to trunk merge points were found and patched in. Comments have been massaged into git summary + body form; revision references have been lifted to action stamps. Conversion comments are, like this one, enclosed in double square brackets. Typos in change comments have often been quietly fixed. Some abbreviations (notably for mainline campaign names) have been made more uniform than they were in the Subversion comments. Infix "::" to mark a campaign-scenario pair (as in "HttT::12" has sometimes been inserted for clarity and to shorten summary lines. Two branches, website/ and resources/, have been merged to trunk, where their history now appears as that of those two top-level directories rather than as separate branches. Subversion property settings, and the commits in the Subversion history that manipulated them, are almost all gone. A few have been translated to .gitignore files and setting of executable bits. There are a few committers that we have been unable to identify. These are: uso zas uid65860 uid66289 uid67456 uid68698 uid68803 uid68842 uid68850 uid68852 uid69097 uid69206 The uid names seem to have been mechanically generated from Wesnoth forum postings. Committer lines for all of these have been left without a domain name in the email address.]]
2003-09-15 11:52:41 +00:00
You will also need to have a working installation of GNU gettext to build the
translations.
Note: It has been reported (see https://gna.org/bugs/index.php?10326)
that under gcc 3.3.6 you need to turn off optimizations or you will
get a build that doesn't work for multiplayer. We recommend building
with gcc 4.
If you see lots of messages like "Type 'svnversion --help' for usage.",
you have a Subversion client installed but it is not implementing the
-n option of svnversion. Time to update it.
2003-11-21 00:52:27 +00:00
Sourcecode:
2003-11-21 00:52:27 +00:00
You can get it here:
2003-11-21 00:52:27 +00:00
http://www.wesnoth.org/downloads
2003-11-21 00:52:27 +00:00
Compiling:
2003-11-21 00:52:27 +00:00
First untar the package:
2006-06-06 00:05:03 +00:00
$ tar xfjv wesnoth-x.y.z.tar.bz2
2003-11-21 00:52:27 +00:00
then
2006-06-06 00:05:03 +00:00
$ cd wesnoth-x.y.z
Simply type 'scons' in the top-level directory to build game, editor,
and tools. It is possible to select individual targets by naming them
as scons arguments, including wesnothd (the Wesnoth multiplayer server)
and campaignd (the campaign server).
2006-06-06 00:05:03 +00:00
scons takes a prefix= argument that says where to install the game
and its data. The prefix defaults to /usr/local; for production builds
you may want to set prefix=/usr.
2003-12-23 20:16:21 +00:00
To build wesnothd:
scons server_uid=<user> server_group=<group> wesnothd
2005-03-21 12:54:06 +00:00
where <user> and <group> are valid on your system. A wesnothd
subdirectory will be created under /var/run owned by
<user>:<group>. This is relevant if you want to be able to communicate
with wesnothd through a FIFO or named socket. You have to run
wesnothd with the user specified while configuring in order for it to
work. You can also specify the FIFO directory directly by using
fifodir=<directory>.
If you want to install several versions of wesnoth you should use the
prefsdir= parameter to get distinct preferences directories. The
default is '.wesnoth'.
Notes on the deprecated autotools build:
The autotools build machinery is deprecated, unsupported, and will be
removed in a future release. You will need autoconf (>= 2.60) and
automake (>= 1.9). Run './autogen.sh' to generate the configure
files. Then
$ ./configure
$ make
$ make install
as usual. See './configure --help' for all available options.
2005-03-21 20:35:20 +00:00
You should clean your existing wesnoth release build first with:
$ make distclean
If you want to clean your wesnoth SVN build do:
2005-03-21 20:35:20 +00:00
$ make maintainer-clean