Merge branch 'next' into attenuation

[flightgear.git] / README.plib

diff --git a/README.plib b/README.plib
index ab2216274b5c38ab96686d92aa9ba9b1b8c6ddad..6743ce9808b7d2f83ebcc5ddf7d1b11579ecf0f9 100644 (file)
--- a/README.plib
+++ b/README.plib
@@ -1,20 +1,48 @@
-You *must* have the plib library installed on your system to build
-the FGFS simulator!"
+[This file is mirrored in both the FlightGear and SimGear packages.]
 
-You can get the original library from:
+You *must* have plib version 1.8.4 or later installed on your system
+to build FlightGear!"  Flight Gear is no longer compatible with the
+earlier versions of the library.
 
-    http://www.woodsoup.org/projs/plib/
+You can get the latest version of plib from:
+
+    http://plib.sourceforge.net
 
 Build notes:
 
-When you run "./configure" to configure the package, plib's defaults
-to installing the headers in /usr/local/plib/include and the libraries
-in /usr/local/plib/lib.
+You should be able to just run "./configure" to configure the package
+and use all of plib's defaults.  Then run "make" followed by "make
+install".  By default, plib installs itself into /usr so if you don't
+like this, be sure to specify an alternate prefix such as --prefix=/usr/local
+
+As of this writing (2007-11-18), many linux distributions are shipped with a 
+working version of plib, so chances are that this library is already 
+installed. It should be noted, that currently plib version no longer compiles
+using recent versions of gcc (confirmed on version gcc 4.1.2, as shipped with 
+SuSe 10.2). As a workaround, it is possible to either use plib SVN. Run the 
+following commands: 
+
+
+svn co https://plib.svn.sourceforge.net/svnroot/plib/trunk plib
+cd plib
+./autogen.sh
+./configure
+make
+make install
+
+Alternatively, it is relatively straightforward to fix the compilation 
+problems in plib
+
+The two errors reported are the following:
+ssgaSky.h:107: error: extra qualification ‘ssgaCelestialBodyList::’ on member ‘ssgaCelestialBodyList’
+ssgaSky.h:195: error: extra qualification ‘ssgaCloudLayerList::’ on member ‘ssgaCloudLayerList’
 
-If you would prefer to install these in /usr/local/include/plib/ and
-/usr/local/lib, then run configure with the following options:
+To fix, open the file plib-1.8.4/src/ssgAux/ssgaSky.h
 
-    ./configure --prefix=/usr/local --includedir=/usr/local/include/plib
+and change line 107 to read:
+  ~ssgaCelestialBodyList () { removeAll(); }
+and change line 195 to read:
+  ~ssgaCloudLayerList () { removeAll(); }
 
-Installing like this makes it much easier for the fgfs configure script
-to locate the plib includes and libs.
+In other words, remove the "extra qualification" parts from both lines. 
+After these changes, plib-1.8.4. should build and install correctly.