Merge pull request #53 from sorenhein/master

Cumulative update from v2.8.2 to v2.8.3

Author: sorenhein

.gitignore

@@ -3,10 +3,13 @@
 *.a
 *.dll
 *.obj
-*.exe
 *.def
 src/[Mm]akefile
 test/[Mm]akefile
 examples/[Mm]akefile
 test/dtest
 test/itest
+
+*.exe
+*.swp
+*.bak

ChangeLog

@@ -1,3 +1,30 @@
+Release Notes DDS 2.8.3
+-----------------------
+Fixed bug in Scheduler that caused a crash in case 200 very similar
+hands were solved in one invocation.  If you didn't experience
+crashes, you don't have to upgrade for this bug fix.
+
+Generalized the AnalysePlay functions.  Previously they required
+a complete 13-trick hand with no cards played in a partial trick.
+Now they work for any number of remaining tricks and for partial
+tricks as well.
+
+Included Pierre Cossard's code for using GDC multi-threading with
+Apple's LLVM compiler on the Mac.
+
+Added a Makefile for compiling a shared library on the Mac.
+
+Added a GetDDSInfo interface function that can be used to ask the
+DLL how it was compiled and how many threads it is using.
+
+Modified the documentation names not to include the version number
+in the file names (easier to maintain).
+
+Updated the documentation to fix an error (the playTracePBN
+structure uses an array of chars, not an array of ints; this was
+correct in dll.h).  Also described pass as a valid par score.
+
+
 Release Notes DDS 2.8.2
 -----------------------
 Fixed bug in the calculation of par score contracts (par score

INSTALL

@@ -105,8 +105,11 @@ Compiler: g++
 Apple
 =====
 Makefile: Makefile_Mac_clang (for clang compiler, single-threaded)
-Makefile: Makefile_Mac_clang (for GNU g++ compiler, multi-threaded)
 Compiler: g++
+Supports both OpenMP and GDD multi-threading.
+
+Makefile: Makefile_Mac_gcc (for GNU g++ compiler, multi-threaded)
+Makefile: Makefile_Mac_shared (for GNU g++ compiler, multi-threaded)
 
 
 Testing

README.md

@@ -6,11 +6,11 @@ DDS offers a wide range of functions, including par-score calculations.
 
 Please refer to the [home page](http://privat.bahnhof.se/wb758135) for details.
 
-The current version is DDS 2.8.2 released in June 2015 and licensed under the Apache 2.0 license in the LICENSE FILE.
+The current version is DDS 2.8.3 released in January 2016 and licensed under the Apache 2.0 license in the LICENSE FILE.
 
 Release notes are in the ChangeLog file.
 
-(c) Bo Haglund 2006-2014, (c) Bo Haglund / Soren Hein 2014-2015.
+(c) Bo Haglund 2006-2014, (c) Bo Haglund / Soren Hein 2014-2016.
 
 
 Credits
@@ -25,6 +25,8 @@ Brian Dickens found bugs in v2.7 and encouraged us to look at GitHub.  He also s
 
 Foppe Hemminga maintains DDS on ArchLinux.  He also contributed a version of the documentation file completely in .md mark-up language.
 
+Pierre Cossard contributed the code for multi-threading on the Mac using GDS.
+
 Soren Hein made a number of contributions before becoming a co-author starting in v2.8 in 2014.
 
 
@@ -59,16 +61,17 @@ The Windows versions use the Windows multi-threading.  The code compiles on wind
 We have also compiled the code and/or had help from other contributors on the following systems.
 
 * Linux Ubuntu with g++ and with OpenMP multi-threading.
-* Mac OS 10.9 with g++ and with OpenMP multi-threading.  Also with clang without multi-threading.
+* Mac OS 10.9 with g++ and with OpenMP multi-threading.  Also with clang without multi-threading.  Also with GCD multi-threading compiling with LLVM.
 
-Here the libraries are `.a` files, not DLLs.  We might also make `.so` libraries in the future.
+Here the libraries are `.a` files, not DLLs.  There are also Makefiles for shared libraries available.
 
 Note that Apple stopped using g++ in Xcode a while back, DDS does compile using the clang compiler, but since DDS does not support pthreads multi-threading, DDS becomes single-threaded.  To get OpenMP multi-threading you need to use the Homebrew installer and do:
 
     brew reinstall gcc --without-multilib
 
 The `without-multilib` is important because you won't get OpenMP otherwise, and that's the whole point.  *(Thanks to Matthew Kidd for these instructions.)*
 
+Thanks for Pierre Cossard's contribution, the Mac port now also supports GCD multi-threading with LLVM.
 
 Usage
 =====
@@ -83,7 +86,7 @@ The DDS library interface is very well documented. You find the docs, including
 
 Bugs
 ====
-Version 2.8.2 has no known bugs.
+Version 2.8.3 has no known bugs.
 
 Please report bugs to [email protected] and [email protected].