From ec48b814af7a2b8ce3f7f6ffb66d9032ba5494d9 Mon Sep 17 00:00:00 2001 From: Soren Hein Date: Fri, 1 Jan 2016 23:26:59 +0100 Subject: [PATCH] Updates of release files --- ChangeLog | 27 +++++++++++++++++++++++++++ INSTALL | 5 ++++- README.md | 13 ++++++++----- 3 files changed, 39 insertions(+), 6 deletions(-) diff --git a/ChangeLog b/ChangeLog index 36bf6ed4..012c5d13 100644 --- a/ChangeLog +++ b/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 diff --git a/INSTALL b/INSTALL index fc02e1b4..0f7d066f 100644 --- a/INSTALL +++ b/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 diff --git a/README.md b/README.md index 6d61bdd9..028b921c 100644 --- a/README.md +++ b/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,9 +61,9 @@ 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: @@ -69,6 +71,7 @@ Note that Apple stopped using g++ in Xcode a while back, DDS does compile using 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 bo.haglund@bahnhof.se and soren.hein@gmail.com.