Merge branch '1.7.x' of github.com:AMDComputeLibraries/MLOpen into 1.7.x

README.md

@@ -101,14 +101,18 @@ cmake -DMIOPEN_BACKEND=OpenCL -DBUILD_DEV=On ..
 
 Database paths can be explicitly customized by means of `MIOPEN_DB_PATH` (System PerfDb) and `MIOPEN_USER_DB_PATH` (User PerfDb) cmake variables.
 
+If the user installs a new version of MIOpen, it is recommended that the user move, or delete their old user database file. The user can find the file with the suffix `*.updb.txt` in the user perf db path. 
+
+More information about the performance database can be found [here](https://github.com/ROCmSoftwarePlatform/MIOpen/blob/master/doc/src/perfdatabase.md).
+
+
 ##### Persistent Program Cache
 
 MIOpen by default caches the device programs in the location `~/.cache/miopen/`. In the cache directory there exists a directory for each version of MIOpen. Users change the location of the cache directory during configuration using the flag `-DMIOPEN_CACHE_DIR=<cache-directory-path>`. 
 
 Users can also disable the cache during runtime using the environmental variable set as `MIOPEN_DISABLE_CACHE=1`. 
 
-If the compiler changes, or the user modifies the kernels then the cache must be deleted for the MIOpen version in use; e.g., `rm -rf ~/.cache/miopen/<miopen-version-number>`.
-
+If the compiler changes, or the user modifies the kernels then the cache must be deleted for the MIOpen version in use; e.g., `rm -rf ~/.cache/miopen/<miopen-version-number>`. More information about the cache can be found [here](https://github.com/ROCmSoftwarePlatform/MIOpen/blob/master/doc/src/cache.md).
 
 
 #### Changing the cmake configuration

doc/src/cache.md

@@ -13,3 +13,7 @@ Disabling the cache
 
 The are several ways to disable the cache. This is generally useful for development purposes. The cache can be disabled during build by either setting `MIOPEN_CACHE_DIR` to an empty string, or setting `BUILD_DEV=ON` when configuring cmake. The cache can also be disabled at runtime by setting the `MIOPEN_DISABLE_CACHE` environment variable to true.
 
+Updating MIOpen and removing the cache
+--------------------------------------
+If the compiler changes, or the user modifies the kernels then the cache must be deleted for the MIOpen version in use; e.g., `rm -rf ~/.cache/miopen/<miopen-version-number>`.
+

doc/src/perfdatabase.md

@@ -74,3 +74,8 @@ This variable allows for limiting the scope of `MIOPEN_FIND_ENFORCE`, so that on
 **CONV_BWD (3)** `MIOPEN_FIND_ENFORCE` affects only Backward Data convolutions.
 
 **CONV_WRW (4)** `MIOPEN_FIND_ENFORCE` affects only Backward With Regard to Weights (a.k.a. WRW) convolutions.
+
+
+### Updating MIOpen and the User Db
+
+It is important to note that if the user installs a new version of MIOpen, it is recommended that the user move, or delete their old user performance database file. This will prevent older database entries from polution the configurations shipped with the newer system database. The user can find the file with the suffix `*.updb.txt` in the user perf db path.

doc/src/releasenotes.md

@@ -1,17 +1,19 @@
 
 ## MIOpen Release notes
 
-### 12/14/2018 [ 1.7.0 ]
+### 12/19/2018 [ 1.7.0 ]
 
 - This release contains general bug fixes and an updated performance database
 - Group convolutions backwards weights performance has been improved
 - Logging across the library has been improved
+- Performance database has been updated
 
 
 Changes:
 
 - Fixed logging issues with group convolution and pooling
 - Fixed sphinx version issue in document generation
+- Fixed issues with corrupt entries in performance database
 - Removed external dependency on libSSL and libCrypto
 - Added support for large image backwards weights in direct convolution
 - Added fp16 support for RNNs on the HIP backend