[clang] [HLSL] Implement the dst HLSL Function (PR #133828)

[Ashley Coleman via cfe-commits]

================
@@ -174,6 +174,31 @@ const inline float distance(__detail::HLSL_FIXED_VECTOR<float, N> X,
                             __detail::HLSL_FIXED_VECTOR<float, N> Y) {
   return __detail::distance_vec_impl(X, Y);
 }
+//===----------------------------------------------------------------------===//
+// dst builtins
+//===----------------------------------------------------------------------===//
+
+/// \fn fvector dst( fvector, fvector)
+/// \brief Returns the length of a vector
+/// \param Src0 [in] The first vector contain {_, d*d, d*d, _}
+/// \param Src1 [in] The second vector contain {_, 1/d, _, 1/d}
+///
+/// Return the computed distance vector contain {1, d, d*d, 1/d}
----------------
V-FEXrt wrote:

Yep, that was the point I was making as well. Think about the comment header from the perspective of a random user who is being shown the comment as an editor  popup. It needs to be useful in that context

https://github.com/llvm/llvm-project/pull/133828