Tidy up type usage

[andy/viking.git] / README

diff --git a/README b/README
index 5011982159f0e292ebb781e112ffcd493fc8b1fa..b195a2ad51ba1f576386c760f46c6faf2e9c4cdb 100644 (file)
--- a/README
+++ b/README
@@ -1,26 +1,54 @@
-To compile:
+Viking is a free/open source program to manage GPS data. You can
+import, plot and create tracks, routes and waypoints, show OSM
+and other maps, generate maps (using Mapnik),
+see real-time GPS position, Geotag Images,
+control items, upload/download OSM Traces and more.
+It is written mainly in C with some C++ and uses the GTK+2 toolkit.
 
-If you downloaded viking from CVS, you have to:
-$ autogen.sh
+Website: http://viking.sf.net/
 
-Next, or if you downloaded a tarball, you have to:
-$ ./configure
-$ make
 
-Check output of "./configure --help" for configuration options.
-In particular, it is possible to disable some features, like --disable-google in order to disable any Google stuff.
+Obtaining Viking
+================
+
+You can download tarball of latest released version at
+http://sourceforge.net/projects/viking/files
+
+You can also retrieve the latest development version on the official
+Git repository:
+  $ git clone git://git.code.sf.net/p/viking/code viking
+
+Installing Viking
+=================
+
+On debian Sid, following packages must be installed before building:
+  # sudo apt install gtk-doc-tools  gnome-doc-utils libpng-dev libgtk-3-dev libgexiv2-dev libgps-dev libbz2-dev libmagic-dev
+nettle-dev libzip-dev libicu-dev
+
+If you downloaded Viking from Git, you have to:
+  $ ./autogen.sh
+
+Next, or if you downloaded a tarball, you have to:
+  $ ./configure
+  $ make
 
-If you whish to install viking, you have to (as root):
-# make install
+Check output of "./configure --help" for configuration options.  In
+particular, it is possible to disable some features, like
+--disable-google in order to disable any Google stuff.
 
+If you wish to install Viking, you have to (as root):
+  # make install
 
-Viking needs documentation! Any volunteers?
-After I get some core features down I'll start on documentation. I promise.
+For detailed explanation on the install on Unix like systems,
+see the INSTALL file.
 
-To export as GPSMapper, the track/waypoint name should be in the format of:
+Examples
+========
 
-Name RGN## 0x####
+See test/ subdirectory for examples.
 
-or
+Documentation
+=============
 
-Name RGN## 0x##
+See doc/ and help/ subdirectories for documentation.
+You can also access user manual via Help menu entry.