Small tool, doc, sample enhancements.

- Expand message when HIP version mismatch detected.
- Doc touchup.
- change sorting of hipBusBandwidth so byte results shown at top.
-

Change-Id: Ifb4e44a5fdfb65d59c4994b11e5f13385705f7e0


[ROCm/hip commit: 7bc1af2776]

projects/hip/samples/1_Utils/hipBusBandwidth/ResultDatabase.cpp

@@ -7,16 +7,22 @@
 
 using namespace std;
 
+#define SORT_RETAIN_ATTS_ORDER 1
+
+
 bool ResultDatabase::Result::operator<(const Result &rhs) const
 {
     if (test < rhs.test)
         return true;
     if (test > rhs.test)
         return false;
+#if (SORT_RETAIN_ATTS_ORDER == 0) 
+    // For ties, sort by the value of the attribute:
     if (atts < rhs.atts)
         return true;
     if (atts > rhs.atts)
         return false;
+#endif
     return false; // less-operator returns false on equal
 }
 
@@ -189,7 +195,8 @@ void ResultDatabase::AddResult(const string &test_orig,
 void ResultDatabase::DumpDetailed(ostream &out)
 {
     vector<Result> sorted(results);
-    sort(sorted.begin(), sorted.end());
+
+    stable_sort(sorted.begin(), sorted.end());
 
     const int testNameW = 24 ;
     const int attW = 12;
@@ -281,7 +288,8 @@ void ResultDatabase::DumpDetailed(ostream &out)
 void ResultDatabase::DumpSummary(ostream &out)
 {
     vector<Result> sorted(results);
-    sort(sorted.begin(), sorted.end());
+
+    stable_sort(sorted.begin(), sorted.end());
 
     const int testNameW = 24 ;
     const int attW = 12;
@@ -377,7 +385,7 @@ void ResultDatabase::DumpCsv(string fileName)
     bool emptyFile;
     vector<Result> sorted(results);
 
-    sort(sorted.begin(), sorted.end());
+    stable_sort(sorted.begin(), sorted.end());
 
     //Check to see if the file is empty - if so, add the headers
     emptyFile = this->IsFileEmpty(fileName);