File	Date	Author	Commit
.settings	2011-07-01	Tobias Bieniek	[ecf9c3] Updated eclipse auto formatting settings
Data	2012-07-17	Max Kellermann	[0240f2] dlgConfiguration: fix the overlapping "Waypoint...
android	2012-08-06	Peter F Bradshaw	[38630f] Reset some sort of corruption.
build	2012-08-06	Peter F Bradshaw	[38630f] Reset some sort of corruption.
debian	2012-07-31	Max Kellermann	[a5b389] release v6.4
doc	2012-08-06	Peter F Bradshaw	[38630f] Reset some sort of corruption.
ide	2012-02-06	Max Kellermann	[61c8df] debian, eclipse: remove obsolet option GREEN_MENU
po	2012-08-06	Helmut J. Rohs	[1eef45] po: update German translation
rasp	2010-12-03	John Wharington	[605a03] rasp: Added RASP file generation scripts
results	2010-01-03	John Wharington	[1c3f9a] cygwin compilation
src	2012-08-06	Peter F Bradshaw	[38630f] Reset some sort of corruption.
test	2012-07-30	Max Kellermann	[210963] test/LoadTopography: triangulate all polygons
tools	2012-07-24	Max Kellermann	[7d8d58] Compiler.h: remove "gcc_explicit" and "constexp...
.gitignore	2012-05-04	Peter F Bradshaw	[514645] Bulk of Design chapter.
AUTHORS	2012-07-21	Piero Missa	[08cacb] po: update Italian translation
COPYING	2011-07-03	Tobias Bieniek	[9e122c] gpl.txt: Renamed to COPYING
Makefile	2012-07-23	Max Kellermann	[6fce29] Makefile: add TextFile.cpp to libio
NEWS.txt	2012-08-02	Andreas Pfaller	[4367fb] MapSettings: Allow configuration of "No wind ar...
README	2012-07-19	Max Kellermann	[c8140c] Makefile: use the Android NDK r8b
VERSION.txt	2012-07-31	Max Kellermann	[a5b389] release v6.4
configure	2012-06-21	Max Kellermann	[06bb8d] configure, README: emphasise that the configure...
valgrind.suppressions	2011-07-21	Max Kellermann	[5f6da8] valgrind.suppressions: remove obsolete GLib sup...

Read Me

XCSoar README
=============

XCSoar is a tactical glide computer for the Pocket PC operating
system.

This file is aimed at developers.  Users should read the manual which
can be found on the XCSoar home page (http://www.xcsoar.org/).


Getting the source
------------------

The XCSoar source code is managed with git (http://git-scm.com/).  It
can be downloaded with the following command:

 git clone git://git.xcsoar.org/xcsoar/master/xcsoar.git

To update your repository, type:

 git pull

For more information, please refer to the git documentation.


Compiling from source
---------------------

To compile from source, you need:

- GNU make
- GNU compiler collection (gcc), version 4.6.2 or later
  or clang/LLVM 3.1 (with "make CLANG=y")
- rsvg (http://librsvg.sourceforge.net/)
- ImageMagick 6.4 (http://www.imagemagick.org/)
- xsltproc (http://xmlsoft.org/XSLT/xsltproc2.html)
- Perl and XML::Parser

To cross-compile to (desktop) Windows, you need the mingw-w64 version of gcc:

 http://mingw-w64.sourceforge.net/

For Pocket PC / Windows CE / Windows Mobile, you need mingw32ce:

 http://max.kellermann.name/download/xcsoar/devel/cegcc/

For Linux/Unix, you need:

- Boost (http://www.boost.org/)
- zlib (http://www.zlib.net/)
- CURL (http://curl.haxx.se/)
- SDL (http://www.libsdl.org/)
- SDL_ttf (http://www.libsdl.org/projects/SDL_ttf/)
- SDL_image (http://www.libsdl.org/projects/SDL_image/)
- OpenGL
- to run XCSoar, you need one of the following fonts (Debian package):
  DejaVu (ttf-dejavu), Droid (ttf-droid), Freefont (ttf-freefont)

For Android, you need:

- Android SDK (http://developer.android.com/sdk/)
- Android NDK r8b (http://developer.android.com/sdk/ndk/)
- Ogg Vorbis (http://www.vorbis.com/)

For Mac OS X, you need:
- GCC 4.6.2 or newer (http://hpc.sourceforge.net/, or homebrew, or Macports)
- Boost (http://www.boost.org/)
- zlib (http://www.zlib.net/)
- CURL (http://curl.haxx.se/)
- SDL (http://www.libsdl.org/)
- SDL_ttf (http://www.libsdl.org/projects/SDL_ttf/)
- SDL_image (http://www.libsdl.org/projects/SDL_image/)
- libicns (http://icns.sourceforge.net/)

To compile, run:

 make TARGET=<target>

To compile on a Unix-like system (Linux, Mac), you may run the
configure script to detect the build toolchain (optional):

 ./configure
 make

Supported targets:

 PC: desktop Windows

 PPC2000, PPC2003: Pocket PC (for PPC2002 devices, use PPC2000 target)

 WM5: Windows Mobile 5.0 and later

 PPC2003X: Pocket PC 2003 with XScale CPU

 ALTAIR: Triadis Altair

 WINE: WineLib (experimental)

 UNIX: Linux and others (work in progress)

 ANDROID: Android OS

 ANDROID7: Android with ARMv7 CPU

 ANDROID86: Android with x86 CPU


Submitting patches
------------------

Submit patches to the XCSoar developer mailing list
(xcsoar-devel@lists.sourceforge.net).

- patches should be self-contained
- patches should be self-documenting (add a good description on what
  is changed, and why you are changing it)
- write one patch for one change