[Plplot-cvs] SF.net SVN: plplot:[12030] trunk/README.release

[<arj...@us...>]

Revision: 12030
          http://plplot.svn.sourceforge.net/plplot/?rev=12030&view=rev
Author:   arjenmarkus
Date:     2011-11-17 08:27:31 +0000 (Thu, 17 Nov 2011)
Log Message:
-----------
Add note on the use of the gfortran option -Wl,--allow-multiple-define to solve
link problems with some distributions of that compiler.

Modified Paths:
--------------
    trunk/README.release

Modified: trunk/README.release
===================================================================
--- trunk/README.release	2011-11-15 17:31:39 UTC (rev 12029)
+++ trunk/README.release	2011-11-17 08:27:31 UTC (rev 12030)
@@ -89,8 +89,8 @@
 
 OFFICIAL NOTICES FOR USERS
 
-(5.9.10) Significant efforts have been made to ensure the PLplot code 
-is standards compliant and free from warnings. Compilance has been 
+(5.9.10) Significant efforts have been made to ensure the PLplot code
+is standards compliant and free from warnings. Compilance has been
 tested using the gcc compiler suite -std, -pedantic and -W  flags. The
 language standards adopted are
 C: ISO C99 with POSIX.1-2001 base specification (required for a number
@@ -98,19 +98,19 @@
 C++: ISO C++ 1998 standard plus amendments
 F95: Fortran 95 standard
 
-Specifically, the following gcc / g++ / gfortran flags were used 
+Specifically, the following gcc / g++ / gfortran flags were used
 
 CFLAGS='-O3 -std=c99 -pedantic -D_POSIX_C_SOURCE=200112L -Wall  \
--Wextra -Wmissing-prototypes -Wstrict-prototypes -Wnested-externs \ 
--Wconversion -Wshadow -Wcast-qual -Wcast-align -Wwrite-strings' 
+-Wextra -Wmissing-prototypes -Wstrict-prototypes -Wnested-externs \
+-Wconversion -Wshadow -Wcast-qual -Wcast-align -Wwrite-strings'
 
 CCFLAGS='-O3 -fvisibility=hidden -std=c++98 -pedantic -Wall -Wextra '
 
 FFLAGS='-std=f95 -O3 -fall-intrinsics -fvisibility=hidden -pedantic \
 -Wall -Wextra '
 
-Note that the code is not yet quite standards compliant or warning free, 
-but this is our aim. We know that a number of common compilers do not 
+Note that the code is not yet quite standards compliant or warning free,
+but this is our aim. We know that a number of common compilers do not
 support these standards "out of the box", so we will continue to develop
 and support work arounds to ensure that PLplot remains easily built on
 a variety of platforms and compilers. Standards compliance should make
@@ -118,14 +118,14 @@
 warnings flags will help to detect and eliminate errors or problems in
 the libraries.
 
-The gfortran -fall-intrinsics flag is required for a couple of 
+The gfortran -fall-intrinsics flag is required for a couple of
 non-standard intrinsics which are used in the code. In the future
 adopting the fortran 2003 or 2008 standard should allow this to be
-removed. 
+removed.
 
-Note: currently this code cleanup does not apply to code generated by 
-swig (octave, python, java, lua bindings) which gives a large number of 
-code warnings. 
+Note: currently this code cleanup does not apply to code generated by
+swig (octave, python, java, lua bindings) which gives a large number of
+code warnings.
 
 (5.9.10) For some years now we have had both FORTRAN 77 and Fortran 95
 bindings, but to the best of our knowledge, there are no longer
@@ -147,6 +147,16 @@
 In some future release we will deprecate these bindings. When this
 will happen has not been decided yet.
 
+(5.9.10) We have found that some distributions of the gfortran compiler
+on Windows (MinGW) may cause a link error due to duplicate symbols
+like __gfortran_setarg_. These errors can be suppressed by adding
+the flag -Wl,--allow-multiple-define. It is very likely that this
+is a bug in these distributions.
+
+As building the libraries and the examples succeeds without any problem
+if you use most other distributions, we have decided not to include this
+flag in our build system.
+
 (5.9.9) This is a quick release to deal with two broken build issues
 that were recently discovered for our Windows platform.  Windows users should
 avoid 5.9.8 because of these problems for that release, and instead use

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.