Merge pull request #1052 from dbabokin/v182

V182

docs/ReleaseNotes.txt

@@ -1,3 +1,59 @@
+=== v1.8.2 === (29 May 2015)
+
+An ISPC update with several important stability fixes and an experimental
+AVX512 support.
+
+Current level of AVX512 support is targeting the new generation of Xeon Phi
+codename Knights Landing. It's implemented in two different ways: as generic and
+native target. Generic target is similar to KNC support and requires Intel C/C++
+Compiler (15.0 and newer) and is availiable in regular ISPC build, which is
+based on LLVM 3.6.1. For the native AVX512 target, we have a separate ISPC
+build, which is based on LLVM trunk (3.7). This build is less stable and has
+several known issues. Nevertheless, if you are interested in AVX512 support for
+your code, we encourage you to try it and report the bugs. We actively working
+with LLVM maintainers to fix all AVX512 bugs, so your feedback is important for
+us and will ensure that bugs affecting your code are fixed by LLVM 3.7 release.
+
+Other notable changes and fixes include:
+
+* Broadwell support via --cpu=broadwell.
+
+* Changed cpu naming to accept cpu codenames. Check help for more details.
+
+* --cpu switch disallowed in multi-target mode.
+
+* Alignment of structure fields (in generated header files) is changed to be
+  more consistent regardless used C/C++ compiler.
+
+* --dllexport switch is added on Windows to make non-static functions DLL
+  export.
+
+* --print-target switch is added to dump details of LLVM target machine.
+  This may help you to debug issues with code generation for incorrect target
+  (or more likely to ensure that code generation is done right).
+
+* A bug was fixed, which triggered uniform statements to be executed with
+  all-off mask under some circumstances.
+
+* The restriction for using some uniform types as return type in multi-target
+  mode with targets of different width was relaxed.
+
+Also, if you are using ISPC for code generation for current generation of
+Xeon Phi (Knights Corner), the following changes are for you:
+
+* A bunch of stability fixes for KNC.
+
+* A bug, which affects projects with multiple ISPC source files compiled with generic
+  target is fixed. As side effect, you may see multiple warnings about unused static
+  functions - you need to add "-wd177" switch to ICC compiling generic output files.
+
+The release includes LLVM 3.6.1 binaries for Linux, MacOS, Windows and Windows based
+cross-compiler for Sony PlayStation4. LLVM 3.5 based experimental Linux binary with
+NVPTX support (now supporting also K80).
+
+Native AVX512 support is available in the set of less stable LLVM 3.7 based binaries
+for Linux, MacOS and Windows.
+
 === v1.8.1 === (31 December 2014)
 
 A minor update of ``ispc`` with several important stability fixes, namely:

docs/ispc.rst

@@ -51,6 +51,7 @@ Contents:
   + `Updating ISPC Programs For Changes In ISPC 1.5.0`_
   + `Updating ISPC Programs For Changes In ISPC 1.6.0`_
   + `Updating ISPC Programs For Changes In ISPC 1.7.0`_
+  + `Updating ISPC Programs For Changes In ISPC 1.8.2`_
 
 * `Getting Started with ISPC`_
 
@@ -326,6 +327,16 @@ older versions:
 * get_ProgramCount() was moved from stdlib to examples/util/util.isph file. You
   need to include this file to be able to use this function.
 
+Updating ISPC Programs For Changes In ISPC 1.8.2
+------------------------------------------------
+
+The release doesn't contain language changes, which may affect compatibility with
+older versions. Though you may want be aware of the following:
+
+* Mangling of uniform types was changed to not include varying width, so now you
+  may use uniform structures and pointers to uniform types as return types in
+  export functions in multi-target compilation.
+
 
 Getting Started with ISPC
 =========================
@@ -5120,7 +5131,7 @@ countries.
 
 * Other names and brands may be claimed as the property of others.
 
-Copyright(C) 2011-2014, Intel Corporation. All rights reserved.
+Copyright(C) 2011-2015, Intel Corporation. All rights reserved.
 
 
 Optimization Notice

docs/news.rst

@@ -2,6 +2,17 @@
 ispc News
 =========
 
+ispc 1.8.2 is Released
+----------------------
+
+An update of ``ispc`` with several important stability fixes and an experimental
+AVX512 support has been released. Binaries are based on LLVM 3.6.1. Binaries with
+native AVX512 support are based on LLVM 3.7 (r238198).
+
+For more details, please check `Release Notes`_.
+
+.. _Release Notes: https://github.com/ispc/ispc/blob/master/docs/ReleaseNotes.txt
+
 ispc 1.8.1 is Released
 ----------------------
 

doxygen.cfg

@@ -31,7 +31,7 @@ PROJECT_NAME           = "Intel SPMD Program Compiler"
 # This could be handy for archiving the generated documentation or
 # if some version control system is used.
 
-PROJECT_NUMBER         = 1.8.2dev
+PROJECT_NUMBER         = 1.8.2
 
 # The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute)
 # base path where the generated documentation will be put.

ispc.h

@@ -38,7 +38,7 @@
 #ifndef ISPC_H
 #define ISPC_H
 
-#define ISPC_VERSION "1.8.2dev"
+#define ISPC_VERSION "1.8.2"
 
 #if !defined(LLVM_3_2) && !defined(LLVM_3_3) && !defined(LLVM_3_4) && !defined(LLVM_3_5) && !defined(LLVM_3_6) && !defined(LLVM_3_7)
 #error "Only LLVM 3.2, 3.3, 3.4, 3.5, 3.6 and 3.7 development branch are supported"