Updated README for version 5.0.0 release.

1 files changed, 42 insertions, 86 deletions

diff --git a/README b/README
index aafd2dce..e2a9c713 100644
--- a/README
+++ b/README
@@ -1,61 +1,70 @@
-   -------------------- P R O J . 4 --------------------
+   --------------------  P R O J  --------------------
 
-PROJ.4 is a cartographic projection software.
+PROJ is a generic coordinate transformation software, that transforms
+coordinates from one coordinate reference system (CRS) to another. This
+includes cartographic projections as well as geodetic transformations.
 
-PLEASE read the following information as well as READMEs in the src
-and nad directories.
+For more information on the PROJ.4 project please see the web page at:
 
-For more information on PROJ.4 maintenance please see the web page at:
+    http://proj4.org/
 
-  http://proj4.org/
+The PROJ.4 mailing list can be found at:
 
-PROJ.4 mailing list can be found at:
+    http://lists.maptools.org/mailman/listinfo/proj
 
-  http://lists.maptools.org/mailman/listinfo/proj
+See the NEWS file for changes between versions.
 
-   ---------------------------------------------------
+The following command line utilities are included in the PROJ package:
 
-Installation:
--------------
+    - proj, for cartographic projection of geodetic coordinates
+    - cs2cs, for transformation from one CRS to another CRS.
+    - geod, for geodesic (great circle) computations.
+    - cct, for generic Coordinate Conversions and Transformations.
+    - gie, the Geospatial Integrity Investigation Environment.
+
+
+
+UNIX/Linux build and installation:
+---------------------------------
 
 FSF's configuration procedure is used to ease installation of the
-PROJ.4 system.
+PROJ system.
 
 The default destination path prefix for installed files is /usr/local.
 Results from the installation script will be placed into subdirectories
 bin, include, lib, man/man1 and man/man3.  If this default path prefix
 is proper, then execute:
 
-	./configure
+    ./configure
 
 If another path prefix is required, then execute:
 
-	./configure --prefix=/my/path
+    ./configure --prefix=/my/path
 
 In either case, the directory of the prefix path must exist and be
 writable by the installer.
 
 After executing configure, execute:
 
-	make
-        make install
+    make
+    make install
 
 The install target will create, if necessary, all required sub-directories.
 
-Windows Build
--------------
 
-PROJ.4 can be built with Microsoft Visual C/C++ using the makefile.vc
+Windows build and installation:
+-------------------------------
+
+PROJ can be built with Microsoft Visual C/C++ using the makefile.vc
 in the PROJ directory.  First edit the PROJ\nmake.opt and modify
 the INSTDIR value at the top to point to the directory where
 the PROJ tree shall be installed. If you want to install into
 C:\PROJ, it can remain unchanged.
-Then use the makefile.vc to build the software:
+Then use the makefile.vc to build the software e.g.:
 
-eg.
-C:\> cd proj
-C:\PROJ> nmake /f makefile.vc
-C:\PROJ> nmake /f makefile.vc install-all
+    C:\> cd proj
+    C:\PROJ> nmake /f makefile.vc
+    C:\PROJ> nmake /f makefile.vc install-all
 
 Note that you have to have the VC++ environment variables, and path
 setup properly.  This may involve running the VCVARS32.BAT script out
@@ -63,70 +72,17 @@ of the Visual C++ tree.
 
 The makefile.vc builds proj.exe, proj.dll and proj.lib.
 
-It should also be possible to build using the Unix instructions
-and Cygwin32, but this hasn't been tested recently.
-
-
-   ---------------------------------------------------
 
 Distribution files and format.
 ------------------------------
 
 Sources are distributed in one or more files.  The principle elements
-of the system are in a compress tar file named `PROJ.4.x.tar.gz' where
-"x" will indicate level.sub-level of the release.  For U.S. users
-interested in NADCON datum shifting procedures, additional files
-containing conversion matricies are distributed with the name
-`PROJ.4.x.y.tar' where y is an uppercase letter starting with "A."
-These supplementary files will contain compressed files and thus
-the tar file is not compressed.
-
-Interim reports on Rel. 4 proj are available in PostScript form as
-*.ps.gz .  New and old users are strongly recommended to carefully read
-these manuals.  They are supplements and NOT a replacement for the full
-manual OF 90-284 (which new users should also obtain).
-
-   ---------------------------------------------------
-
-Principle new aspects of system:
---------------------------------
-
-ANSI X3.159-1989 C code.  Site must have ANSI C compiler and header files.
-
-Several method of determining radius from specified ellipsoid.
-
-Use of initialization files through +init=file:key.  Default projection
-specifications also may be defined in an ASCII file.
-
-+inv option REMOVED and -I may be used in its place.  Use of invproj
-alias of proj still functions as per Rel.3.
-
-+ellps=list and +proj=list REMOVED.  Use respective -le and -lp.
-
-+units= to specify cartesian coordinate system units.  To get list
-use -lu.
-
--v added to dump final cartographic parameters employed.
-
-Addition of computing scale factors and angular distortion added through
--S option.  Valuable for designing new projection parameter details.
-
--V option which verbosely lists projected point characteristics.
-
-Programmers may use projection library with calls to pj_init,
-pj_fwd, pj_inv and pj_transform.
-
-Program nad2nad for conversion of data to and from NAD27 and NAD83
-datums.
-
-Program cs2cs for converting between coordinate systems, with optional
-datum translation.
-
--------------------------------------------------------------
-
-Things currently left undone:
-----------------------------
-
-proj_def.dat NOT fully in place.  Needs additional settings for
-many of the projections.  Probably will not be completed until main
-manual rewritten.
+of the system are in a compress tar file named `PROJ-x.y.z.tar.gz' where
+"x" will indicate major release number, "y" indicates minor release
+number and "z" indicates the patch number of the release.
+
+In addition to the PROJ software package, a distribution of datum
+conversion grid files is also available. The grid package is
+distributed under the name `PROJ-datumgrid-x.y.zip', where "x" is the
+major release version and "y" the minor release version numbers. The
+grid package can be downloaded from the PROJ.4 website.