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-tests commit: 14ad755612]

projects/hip-tests/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);

projects/hip-tests/samples/1_Utils/hipBusBandwidth/hipBusBandwidth.cpp

@@ -49,8 +49,8 @@ std::string sizeToString(int size)
     using namespace std;
     stringstream ss;
     if (size < 0) {
-        // char (09, horiz tab) lexically sorts before " " so will cause Byte values to be displayed before kB.
-        ss << char(0x09)/*tab*/ << setfill('0') << setw(3) << -size <<  "B";
+        // char (-) lexically sorts before " " so will cause Byte values to be displayed before kB.
+        ss << "+" << setfill('0') << setw(3) << -size <<  "By";
     } else {
         ss << size << "kB";
     }