Fix clang-format and apply comments

Author: AlexeySachkov

sycl/include/CL/sycl/detail/pi.hpp

@@ -371,17 +371,17 @@ class DeviceBinaryImage {
   /// range, the name of the property is the specialization constant symbolic ID
   /// and the value is a list of tuples of 32-bit unsigned integer values, which
   /// encode scalar specialization constants, that form the composite one.
-  /// Each tuple consist of ID of scalar specialization constant, its location
+  /// Each tuple consists of ID of scalar specialization constant, its location
   /// within a composite (offset in bytes from the beginning) and its size.
   /// For example, for the following structure:
   /// struct A { int a; float b; };
   /// struct POD { A a[2]; int b; };
   /// List of tuples will look like:
   /// { ID0, 0, 4 },  // .a[0].a
-  //  { ID1, 4, 4 },  // .a[0].b
-  //  { ID2, 8, 4 },  // .a[1].a
-  //  { ID3, 12, 4 }, // .a[1].b
-  //  { ID4, 16, 4 }, // .b
+  /// { ID1, 4, 4 },  // .a[0].b
+  /// { ID2, 8, 4 },  // .a[1].a
+  /// { ID3, 12, 4 }, // .a[1].b
+  /// { ID4, 16, 4 }, // .b
   const PropertyRange &getCompositeSpecConstants() const {
     return CompositeSpecConstIDMap;
   }

sycl/source/detail/program_impl.cpp

@@ -561,7 +561,7 @@ void program_impl::flush_spec_constants(const RTDeviceBinaryImage &Img,
     // location of scalar member within the composite; size of a scalar member
     // of the composite.
     assert(((Descriptors.size() - 8) / sizeof(std::uint32_t)) % 3 == 0 &&
-        "unexpected layout of composite spec const descriptors");
+           "unexpected layout of composite spec const descriptors");
     auto *It = reinterpret_cast<const std::uint32_t *>(&Descriptors[8]);
     auto *End = reinterpret_cast<const std::uint32_t *>(&Descriptors[0] +
                                                         Descriptors.size());

sycl/source/detail/spec_constant_impl.hpp

@@ -13,8 +13,8 @@
 #include <CL/sycl/stl.hpp>
 
 #include <iostream>
-#include <vector>
 #include <map>
+#include <vector>
 
 __SYCL_INLINE_NAMESPACE(cl) {
 namespace sycl {