numba-cuda 0.8.1__py3-none-any.whl → 0.10.0__py3-none-any.whl

numba_cuda/numba/cuda/{cuda_fp16.h → include/11/cuda_fp16.h}

@@ -99,6 +99,9 @@
 #ifndef __CUDA_FP16_H__
 #define __CUDA_FP16_H__
 
+#define ___CUDA_FP16_STRINGIFY_INNERMOST(x) #x
+#define __CUDA_FP16_STRINGIFY(x) ___CUDA_FP16_STRINGIFY_INNERMOST(x)
+
 #if defined(__cplusplus)
 #if defined(__CUDACC__)
 #define __CUDA_FP16_DECL__ static __device__ __inline__
@@ -112,33 +115,33 @@
 /* Forward-declaration of structures defined in "cuda_fp16.hpp" */
 
 /**
- * \brief half datatype 
- * 
- * \details This structure implements the datatype for storing 
- * half-precision floating-point numbers. The structure implements 
- * assignment operators and type conversions. 
- * 16 bits are being used in total: 1 sign bit, 5 bits for the exponent, 
- * and the significand is being stored in 10 bits. 
- * The total precision is 11 bits. There are 15361 representable 
- * numbers within the interval [0.0, 1.0], endpoints included. 
- * On average we have log10(2**11) ~ 3.311 decimal digits. 
- * 
+ * \brief half datatype
+ *
+ * \details This structure implements the datatype for storing
+ * half-precision floating-point numbers. The structure implements
+ * assignment operators and type conversions.
+ * 16 bits are being used in total: 1 sign bit, 5 bits for the exponent,
+ * and the significand is being stored in 10 bits.
+ * The total precision is 11 bits. There are 15361 representable
+ * numbers within the interval [0.0, 1.0], endpoints included.
+ * On average we have log10(2**11) ~ 3.311 decimal digits.
+ *
  * \internal
- * \req IEEE 754-2008 compliant implementation of half-precision 
- * floating-point numbers. 
+ * \req IEEE 754-2008 compliant implementation of half-precision
+ * floating-point numbers.
  * \endinternal
  */
 struct __half;
 
 /**
  * \brief half2 datatype
- * 
- * \details This structure implements the datatype for storing two 
- * half-precision floating-point numbers. 
- * The structure implements assignment operators and type conversions. 
- * 
+ *
+ * \details This structure implements the datatype for storing two
+ * half-precision floating-point numbers.
+ * The structure implements assignment operators and type conversions.
+ *
  * \internal
- * \req Vectorified version of half. 
+ * \req Vectorified version of half.
  * \endinternal
  */
 struct __half2;
@@ -151,7 +154,7 @@ struct __half2;
 * \details Converts double number \p a to half precision in round-to-nearest-even mode.
 * \param[in] a - double. Is only being read.
 * \returns half
-* \retval a converted to half.
+* - \p a converted to half.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -161,12 +164,12 @@ __CUDA_HOSTDEVICE_FP16_DECL__ __half __double2half(const double a);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Converts float number to half precision in round-to-nearest-even mode
-* and returns \p half with converted value. 
-* 
-* \details Converts float number \p a to half precision in round-to-nearest-even mode. 
-* \param[in] a - float. Is only being read. 
+* and returns \p half with converted value.
+*
+* \details Converts float number \p a to half precision in round-to-nearest-even mode.
+* \param[in] a - float. Is only being read.
 * \returns half
-* \retval a converted to half. 
+* - \p a converted to half.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -179,9 +182,9 @@ __CUDA_HOSTDEVICE_FP16_DECL__ __half __float2half(const float a);
 * and returns \p half with converted value.
 *
 * \details Converts float number \p a to half precision in round-to-nearest-even mode.
-* \param[in] a - float. Is only being read. 
+* \param[in] a - float. Is only being read.
 * \returns half
-* \retval a converted to half. 
+* - \p a converted to half.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -192,11 +195,11 @@ __CUDA_HOSTDEVICE_FP16_DECL__ __half __float2half_rn(const float a);
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Converts float number to half precision in round-towards-zero mode
 * and returns \p half with converted value.
-* 
+*
 * \details Converts float number \p a to half precision in round-towards-zero mode.
-* \param[in] a - float. Is only being read. 
+* \param[in] a - float. Is only being read.
 * \returns half
-* \retval a converted to half. 
+* - \p a converted to half.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -207,12 +210,12 @@ __CUDA_HOSTDEVICE_FP16_DECL__ __half __float2half_rz(const float a);
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Converts float number to half precision in round-down mode
 * and returns \p half with converted value.
-* 
+*
 * \details Converts float number \p a to half precision in round-down mode.
-* \param[in] a - float. Is only being read. 
-* 
+* \param[in] a - float. Is only being read.
+*
 * \returns half
-* \retval a converted to half. 
+* - \p a converted to half.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -223,12 +226,12 @@ __CUDA_HOSTDEVICE_FP16_DECL__ __half __float2half_rd(const float a);
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Converts float number to half precision in round-up mode
 * and returns \p half with converted value.
-* 
+*
 * \details Converts float number \p a to half precision in round-up mode.
-* \param[in] a - float. Is only being read. 
-* 
+* \param[in] a - float. Is only being read.
+*
 * \returns half
-* \retval a converted to half. 
+* - \p a converted to half.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -238,12 +241,12 @@ __CUDA_HOSTDEVICE_FP16_DECL__ __half __float2half_ru(const float a);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Converts \p half number to float.
-* 
+*
 * \details Converts half number \p a to float.
-* \param[in] a - float. Is only being read. 
-* 
+* \param[in] a - float. Is only being read.
+*
 * \returns float
-* \retval a converted to float. 
+* - \p a converted to float.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -257,10 +260,10 @@ __CUDA_HOSTDEVICE_FP16_DECL__ float __half2float(const __half a);
 *
 * \details Converts input \p a to half precision in round-to-nearest-even mode and
 * populates both halves of \p half2 with converted value.
-* \param[in] a - float. Is only being read. 
+* \param[in] a - float. Is only being read.
 *
 * \returns half2
-* \retval The \p half2 value with both halves equal to the converted half
+* - The \p half2 value with both halves equal to the converted half
 * precision number.
 * \internal
 * \exception-guarantee no-throw guarantee
@@ -277,11 +280,11 @@ __CUDA_HOSTDEVICE_FP16_DECL__ __half2 __float2half2_rn(const float a);
 * and combines the results into one \p half2 number. Low 16 bits of the return
 * value correspond to the input \p a, high 16 bits correspond to the input \p
 * b.
-* \param[in] a - float. Is only being read. 
-* \param[in] b - float. Is only being read. 
-* 
+* \param[in] a - float. Is only being read.
+* \param[in] b - float. Is only being read.
+*
 * \returns half2
-* \retval The \p half2 value with corresponding halves equal to the
+* - The \p half2 value with corresponding halves equal to the
 * converted input floats.
 * \internal
 * \exception-guarantee no-throw guarantee
@@ -292,13 +295,13 @@ __CUDA_HOSTDEVICE_FP16_DECL__ __half2 __floats2half2_rn(const float a, const flo
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Converts low 16 bits of \p half2 to float and returns the result
-* 
+*
 * \details Converts low 16 bits of \p half2 input \p a to 32-bit floating-point number
 * and returns the result.
-* \param[in] a - half2. Is only being read. 
-* 
+* \param[in] a - half2. Is only being read.
+*
 * \returns float
-* \retval The low 16 bits of \p a converted to float.
+* - The low 16 bits of \p a converted to float.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -308,34 +311,132 @@ __CUDA_HOSTDEVICE_FP16_DECL__ float __low2float(const __half2 a);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Converts high 16 bits of \p half2 to float and returns the result
-* 
+*
 * \details Converts high 16 bits of \p half2 input \p a to 32-bit floating-point number
 * and returns the result.
-* \param[in] a - half2. Is only being read. 
-* 
+* \param[in] a - half2. Is only being read.
+*
 * \returns float
-* \retval The high 16 bits of \p a converted to float.
+* - The high 16 bits of \p a converted to float.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
 * \endinternal
 */
 __CUDA_HOSTDEVICE_FP16_DECL__ float __high2float(const __half2 a);
+/**
+* \ingroup CUDA_MATH__HALF_MISC
+* \brief Convert a half to a signed short integer in round-towards-zero mode.
+*
+* \details Convert the half-precision floating-point value \p h to a signed short
+* integer in round-towards-zero mode. NaN inputs are converted to 0.
+* \param[in] h - half. Is only being read.
+*
+* \returns short int
+* - \p h converted to a signed short integer.
+* \internal
+* \exception-guarantee no-throw guarantee
+* \behavior reentrant, thread safe
+* \endinternal
+*/
+__CUDA_HOSTDEVICE_FP16_DECL__ short int __half2short_rz(const __half h);
+/**
+* \ingroup CUDA_MATH__HALF_MISC
+* \brief Convert a half to an unsigned short integer in round-towards-zero
+* mode.
+*
+* \details Convert the half-precision floating-point value \p h to an unsigned short
+* integer in round-towards-zero mode. NaN inputs are converted to 0.
+* \param[in] h - half. Is only being read.
+*
+* \returns unsigned short int
+* - \p h converted to an unsigned short integer.
+* \internal
+* \exception-guarantee no-throw guarantee
+* \behavior reentrant, thread safe
+* \endinternal
+*/
+__CUDA_HOSTDEVICE_FP16_DECL__ unsigned short int __half2ushort_rz(const __half h);
+/**
+* \ingroup CUDA_MATH__HALF_MISC
+* \brief Convert a half to a signed integer in round-towards-zero mode.
+*
+* \details Convert the half-precision floating-point value \p h to a signed integer in
+* round-towards-zero mode. NaN inputs are converted to 0.
+* \param[in] h - half. Is only being read.
+*
+* \returns int
+* - \p h converted to a signed integer.
+* \internal
+* \exception-guarantee no-throw guarantee
+* \behavior reentrant, thread safe
+* \endinternal
+*/
+__CUDA_HOSTDEVICE_FP16_DECL__ int __half2int_rz(const __half h);
+/**
+* \ingroup CUDA_MATH__HALF_MISC
+* \brief Convert a half to an unsigned integer in round-towards-zero mode.
+*
+* \details Convert the half-precision floating-point value \p h to an unsigned integer
+* in round-towards-zero mode. NaN inputs are converted to 0.
+* \param[in] h - half. Is only being read.
+*
+* \returns unsigned int
+* - \p h converted to an unsigned integer.
+* \internal
+* \exception-guarantee no-throw guarantee
+* \behavior reentrant, thread safe
+* \endinternal
+*/
+__CUDA_HOSTDEVICE_FP16_DECL__ unsigned int __half2uint_rz(const __half h);
+/**
+* \ingroup CUDA_MATH__HALF_MISC
+* \brief Convert a half to a signed 64-bit integer in round-towards-zero mode.
+*
+* \details Convert the half-precision floating-point value \p h to a signed 64-bit
+* integer in round-towards-zero mode. NaN inputs return a long long int with hex value of 0x8000000000000000.
+* \param[in] h - half. Is only being read.
+*
+* \returns long long int
+* - \p h converted to a signed 64-bit integer.
+* \internal
+* \exception-guarantee no-throw guarantee
+* \behavior reentrant, thread safe
+* \endinternal
+*/
+__CUDA_HOSTDEVICE_FP16_DECL__ long long int __half2ll_rz(const __half h);
+/**
+* \ingroup CUDA_MATH__HALF_MISC
+* \brief Convert a half to an unsigned 64-bit integer in round-towards-zero
+* mode.
+*
+* \details Convert the half-precision floating-point value \p h to an unsigned 64-bit
+* integer in round-towards-zero mode. NaN inputs return 0x8000000000000000.
+* \param[in] h - half. Is only being read.
+*
+* \returns unsigned long long int
+* - \p h converted to an unsigned 64-bit integer.
+* \internal
+* \exception-guarantee no-throw guarantee
+* \behavior reentrant, thread safe
+* \endinternal
+*/
+__CUDA_HOSTDEVICE_FP16_DECL__ unsigned long long int __half2ull_rz(const __half h);
 
 #if defined(__CUDACC__)
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Converts both components of float2 number to half precision in
 * round-to-nearest-even mode and returns \p half2 with converted values.
-* 
+*
 * \details Converts both components of float2 to half precision in round-to-nearest
 * mode and combines the results into one \p half2 number. Low 16 bits of the
 * return value correspond to \p a.x and high 16 bits of the return value
 * correspond to \p a.y.
-* \param[in] a - float2. Is only being read. 
-*  
+* \param[in] a - float2. Is only being read.
+*
 * \returns half2
-* \retval The \p half2 which has corresponding halves equal to the
+* - The \p half2 which has corresponding halves equal to the
 * converted float2 components.
 * \internal
 * \exception-guarantee no-throw guarantee
@@ -346,13 +447,13 @@ __CUDA_HOSTDEVICE_FP16_DECL__ __half2 __float22half2_rn(const float2 a);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Converts both halves of \p half2 to float2 and returns the result.
-* 
+*
 * \details Converts both halves of \p half2 input \p a to float2 and returns the
 * result.
-* \param[in] a - half2. Is only being read. 
-* 
+* \param[in] a - half2. Is only being read.
+*
 * \returns float2
-* \retval a converted to float2.
+* - \p a converted to float2.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -362,13 +463,13 @@ __CUDA_HOSTDEVICE_FP16_DECL__ float2 __half22float2(const __half2 a);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert a half to a signed integer in round-to-nearest-even mode.
-* 
+*
 * \details Convert the half-precision floating-point value \p h to a signed integer in
-* round-to-nearest-even mode.
-* \param[in] h - half. Is only being read. 
-* 
+* round-to-nearest-even mode. NaN inputs are converted to 0.
+* \param[in] h - half. Is only being read.
+*
 * \returns int
-* \retval h converted to a signed integer. 
+* - \p h converted to a signed integer.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -377,30 +478,14 @@ __CUDA_HOSTDEVICE_FP16_DECL__ float2 __half22float2(const __half2 a);
 __CUDA_FP16_DECL__ int __half2int_rn(const __half h);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
-* \brief Convert a half to a signed integer in round-towards-zero mode.
-* 
-* \details Convert the half-precision floating-point value \p h to a signed integer in
-* round-towards-zero mode.
-* \param[in] h - half. Is only being read. 
-* 
-* \returns int
-* \retval h converted to a signed integer. 
-* \internal
-* \exception-guarantee no-throw guarantee
-* \behavior reentrant, thread safe
-* \endinternal
-*/
-__CUDA_HOSTDEVICE_FP16_DECL__ int __half2int_rz(const __half h);
-/**
-* \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert a half to a signed integer in round-down mode.
-* 
+*
 * \details Convert the half-precision floating-point value \p h to a signed integer in
-* round-down mode.
-* \param[in] h - half. Is only being read. 
-* 
+* round-down mode. NaN inputs are converted to 0.
+* \param[in] h - half. Is only being read.
+*
 * \returns int
-* \retval h converted to a signed integer. 
+* - \p h converted to a signed integer.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -410,13 +495,13 @@ __CUDA_FP16_DECL__ int __half2int_rd(const __half h);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert a half to a signed integer in round-up mode.
-* 
+*
 * \details Convert the half-precision floating-point value \p h to a signed integer in
-* round-up mode.
-* \param[in] h - half. Is only being read. 
-* 
+* round-up mode. NaN inputs are converted to 0.
+* \param[in] h - half. Is only being read.
+*
 * \returns int
-* \retval h converted to a signed integer. 
+* - \p h converted to a signed integer.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -427,13 +512,13 @@ __CUDA_FP16_DECL__ int __half2int_ru(const __half h);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert a signed integer to a half in round-to-nearest-even mode.
-* 
+*
 * \details Convert the signed integer value \p i to a half-precision floating-point
 * value in round-to-nearest-even mode.
-* \param[in] i - int. Is only being read. 
-* 
+* \param[in] i - int. Is only being read.
+*
 * \returns half
-* \retval i converted to half. 
+* - \p i converted to half.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -443,13 +528,13 @@ __CUDA_HOSTDEVICE_FP16_DECL__ __half __int2half_rn(const int i);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert a signed integer to a half in round-towards-zero mode.
-* 
+*
 * \details Convert the signed integer value \p i to a half-precision floating-point
 * value in round-towards-zero mode.
-* \param[in] i - int. Is only being read. 
-* 
+* \param[in] i - int. Is only being read.
+*
 * \returns half
-* \retval i converted to half. 
+* - \p i converted to half.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -459,13 +544,13 @@ __CUDA_FP16_DECL__ __half __int2half_rz(const int i);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert a signed integer to a half in round-down mode.
-* 
+*
 * \details Convert the signed integer value \p i to a half-precision floating-point
 * value in round-down mode.
-* \param[in] i - int. Is only being read. 
-* 
+* \param[in] i - int. Is only being read.
+*
 * \returns half
-* \retval i converted to half. 
+* - \p i converted to half.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -475,13 +560,13 @@ __CUDA_FP16_DECL__ __half __int2half_rd(const int i);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert a signed integer to a half in round-up mode.
-* 
+*
 * \details Convert the signed integer value \p i to a half-precision floating-point
 * value in round-up mode.
-* \param[in] i - int. Is only being read. 
-* 
+* \param[in] i - int. Is only being read.
+*
 * \returns half
-* \retval i converted to half. 
+* - \p i converted to half.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -493,13 +578,13 @@ __CUDA_FP16_DECL__ __half __int2half_ru(const int i);
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert a half to a signed short integer in round-to-nearest-even
 * mode.
-* 
+*
 * \details Convert the half-precision floating-point value \p h to a signed short
-* integer in round-to-nearest-even mode.
-* \param[in] h - half. Is only being read. 
-* 
+* integer in round-to-nearest-even mode. NaN inputs are converted to 0.
+* \param[in] h - half. Is only being read.
+*
 * \returns short int
-* \retval h converted to a signed short integer. 
+* - \p h converted to a signed short integer.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -508,30 +593,14 @@ __CUDA_FP16_DECL__ __half __int2half_ru(const int i);
 __CUDA_FP16_DECL__ short int __half2short_rn(const __half h);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
-* \brief Convert a half to a signed short integer in round-towards-zero mode.
-* 
-* \details Convert the half-precision floating-point value \p h to a signed short
-* integer in round-towards-zero mode.
-* \param[in] h - half. Is only being read. 
-* 
-* \returns short int
-* \retval h converted to a signed short integer. 
-* \internal
-* \exception-guarantee no-throw guarantee
-* \behavior reentrant, thread safe
-* \endinternal
-*/
-__CUDA_HOSTDEVICE_FP16_DECL__ short int __half2short_rz(const __half h);
-/**
-* \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert a half to a signed short integer in round-down mode.
-* 
+*
 * \details Convert the half-precision floating-point value \p h to a signed short
-* integer in round-down mode.
-* \param[in] h - half. Is only being read. 
-* 
+* integer in round-down mode. NaN inputs are converted to 0.
+* \param[in] h - half. Is only being read.
+*
 * \returns short int
-* \retval h converted to a signed short integer. 
+* - \p h converted to a signed short integer.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -541,13 +610,13 @@ __CUDA_FP16_DECL__ short int __half2short_rd(const __half h);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert a half to a signed short integer in round-up mode.
-* 
+*
 * \details Convert the half-precision floating-point value \p h to a signed short
-* integer in round-up mode.
-* \param[in] h - half. Is only being read. 
-* 
+* integer in round-up mode. NaN inputs are converted to 0.
+* \param[in] h - half. Is only being read.
+*
 * \returns short int
-* \retval h converted to a signed short integer. 
+* - \p h converted to a signed short integer.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -559,13 +628,13 @@ __CUDA_FP16_DECL__ short int __half2short_ru(const __half h);
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert a signed short integer to a half in round-to-nearest-even
 * mode.
-* 
+*
 * \details Convert the signed short integer value \p i to a half-precision floating-point
 * value in round-to-nearest-even mode.
-* \param[in] i - short int. Is only being read. 
-* 
+* \param[in] i - short int. Is only being read.
+*
 * \returns half
-* \retval i converted to half. 
+* - \p i converted to half.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -575,13 +644,13 @@ __CUDA_HOSTDEVICE_FP16_DECL__ __half __short2half_rn(const short int i);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert a signed short integer to a half in round-towards-zero mode.
-* 
+*
 * \details Convert the signed short integer value \p i to a half-precision floating-point
 * value in round-towards-zero mode.
-* \param[in] i - short int. Is only being read. 
-* 
+* \param[in] i - short int. Is only being read.
+*
 * \returns half
-* \retval i converted to half. 
+* - \p i converted to half.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -591,13 +660,13 @@ __CUDA_FP16_DECL__ __half __short2half_rz(const short int i);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert a signed short integer to a half in round-down mode.
-* 
+*
 * \details Convert the signed short integer value \p i to a half-precision floating-point
 * value in round-down mode.
-* \param[in] i - short int. Is only being read. 
-* 
+* \param[in] i - short int. Is only being read.
+*
 * \returns half
-* \retval i converted to half. 
+* - \p i converted to half.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -607,13 +676,13 @@ __CUDA_FP16_DECL__ __half __short2half_rd(const short int i);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert a signed short integer to a half in round-up mode.
-* 
+*
 * \details Convert the signed short integer value \p i to a half-precision floating-point
 * value in round-up mode.
-* \param[in] i - short int. Is only being read. 
-* 
+* \param[in] i - short int. Is only being read.
+*
 * \returns half
-* \retval i converted to half. 
+* - \p i converted to half.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -624,13 +693,13 @@ __CUDA_FP16_DECL__ __half __short2half_ru(const short int i);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert a half to an unsigned integer in round-to-nearest-even mode.
-* 
+*
 * \details Convert the half-precision floating-point value \p h to an unsigned integer
-* in round-to-nearest-even mode.
-* \param[in] h - half. Is only being read. 
-* 
+* in round-to-nearest-even mode. NaN inputs are converted to 0.
+* \param[in] h - half. Is only being read.
+*
 * \returns unsigned int
-* \retval h converted to an unsigned integer. 
+* - \p h converted to an unsigned integer.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -639,30 +708,14 @@ __CUDA_FP16_DECL__ __half __short2half_ru(const short int i);
 __CUDA_FP16_DECL__ unsigned int __half2uint_rn(const __half h);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
-* \brief Convert a half to an unsigned integer in round-towards-zero mode.
-* 
-* \details Convert the half-precision floating-point value \p h to an unsigned integer
-* in round-towards-zero mode.
-* \param[in] h - half. Is only being read. 
-* 
-* \returns unsigned int
-* \retval h converted to an unsigned integer. 
-* \internal
-* \exception-guarantee no-throw guarantee
-* \behavior reentrant, thread safe
-* \endinternal
-*/
-__CUDA_HOSTDEVICE_FP16_DECL__ unsigned int __half2uint_rz(const __half h);
-/**
-* \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert a half to an unsigned integer in round-down mode.
 *
 * \details Convert the half-precision floating-point value \p h to an unsigned integer
-* in round-down mode.
-* \param[in] h - half. Is only being read. 
+* in round-down mode. NaN inputs are converted to 0.
+* \param[in] h - half. Is only being read.
 *
 * \returns unsigned int
-* \retval h converted to an unsigned integer. 
+* - \p h converted to an unsigned integer.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -674,11 +727,11 @@ __CUDA_FP16_DECL__ unsigned int __half2uint_rd(const __half h);
 * \brief Convert a half to an unsigned integer in round-up mode.
 *
 * \details Convert the half-precision floating-point value \p h to an unsigned integer
-* in round-up mode.
-* \param[in] h - half. Is only being read. 
+* in round-up mode. NaN inputs are converted to 0.
+* \param[in] h - half. Is only being read.
 *
 * \returns unsigned int
-* \retval h converted to an unsigned integer. 
+* - \p h converted to an unsigned integer.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -689,13 +742,13 @@ __CUDA_FP16_DECL__ unsigned int __half2uint_ru(const __half h);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert an unsigned integer to a half in round-to-nearest-even mode.
-* 
+*
 * \details Convert the unsigned integer value \p i to a half-precision floating-point
 * value in round-to-nearest-even mode.
-* \param[in] i - unsigned int. Is only being read. 
-* 
+* \param[in] i - unsigned int. Is only being read.
+*
 * \returns half
-* \retval i converted to half. 
+* - \p i converted to half.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -705,13 +758,13 @@ __CUDA_HOSTDEVICE_FP16_DECL__ __half __uint2half_rn(const unsigned int i);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert an unsigned integer to a half in round-towards-zero mode.
-* 
+*
 * \details Convert the unsigned integer value \p i to a half-precision floating-point
 * value in round-towards-zero mode.
-* \param[in] i - unsigned int. Is only being read. 
-* 
+* \param[in] i - unsigned int. Is only being read.
+*
 * \returns half
-* \retval i converted to half.  
+* - \p i converted to half.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -721,13 +774,13 @@ __CUDA_FP16_DECL__ __half __uint2half_rz(const unsigned int i);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert an unsigned integer to a half in round-down mode.
-* 
+*
 * \details Convert the unsigned integer value \p i to a half-precision floating-point
 * value in round-down mode.
-* \param[in] i - unsigned int. Is only being read. 
-* 
+* \param[in] i - unsigned int. Is only being read.
+*
 * \returns half
-* \retval i converted to half. 
+* - \p i converted to half.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -737,13 +790,13 @@ __CUDA_FP16_DECL__ __half __uint2half_rd(const unsigned int i);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert an unsigned integer to a half in round-up mode.
-* 
+*
 * \details Convert the unsigned integer value \p i to a half-precision floating-point
 * value in round-up mode.
-* \param[in] i - unsigned int. Is only being read. 
-* 
+* \param[in] i - unsigned int. Is only being read.
+*
 * \returns half
-* \retval i converted to half. 
+* - \p i converted to half.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -755,13 +808,13 @@ __CUDA_FP16_DECL__ __half __uint2half_ru(const unsigned int i);
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert a half to an unsigned short integer in round-to-nearest-even
 * mode.
-* 
+*
 * \details Convert the half-precision floating-point value \p h to an unsigned short
-* integer in round-to-nearest-even mode.
-* \param[in] h - half. Is only being read. 
-* 
+* integer in round-to-nearest-even mode. NaN inputs are converted to 0.
+* \param[in] h - half. Is only being read.
+*
 * \returns unsigned short int
-* \retval h converted to an unsigned short integer. 
+* - \p h converted to an unsigned short integer.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -770,43 +823,26 @@ __CUDA_FP16_DECL__ __half __uint2half_ru(const unsigned int i);
 __CUDA_FP16_DECL__ unsigned short int __half2ushort_rn(const __half h);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
-* \brief Convert a half to an unsigned short integer in round-towards-zero
-* mode.
-* 
-* \details Convert the half-precision floating-point value \p h to an unsigned short
-* integer in round-towards-zero mode.
-* \param[in] h - half. Is only being read. 
-* 
-* \returns unsigned short int
-* \retval h converted to an unsigned short integer. 
-* \internal
-* \exception-guarantee no-throw guarantee
-* \behavior reentrant, thread safe
-* \endinternal
-*/
-__CUDA_HOSTDEVICE_FP16_DECL__ unsigned short int __half2ushort_rz(const __half h);
-/**
-* \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert a half to an unsigned short integer in round-down mode.
-* 
+*
 * \details Convert the half-precision floating-point value \p h to an unsigned short
-* integer in round-down mode.
-* \param[in] h - half. Is only being read. 
-* 
+* integer in round-down mode. NaN inputs are converted to 0.
+* \param[in] h - half. Is only being read.
+*
 * \returns unsigned short int
-* \retval h converted to an unsigned short integer. 
+* - \p h converted to an unsigned short integer.
 */
 __CUDA_FP16_DECL__ unsigned short int __half2ushort_rd(const __half h);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert a half to an unsigned short integer in round-up mode.
-* 
+*
 * \details Convert the half-precision floating-point value \p h to an unsigned short
-* integer in round-up mode.
-* \param[in] h - half. Is only being read. 
-* 
+* integer in round-up mode. NaN inputs are converted to 0.
+* \param[in] h - half. Is only being read.
+*
 * \returns unsigned short int
-* \retval h converted to an unsigned short integer. 
+* - \p h converted to an unsigned short integer.
 */
 __CUDA_FP16_DECL__ unsigned short int __half2ushort_ru(const __half h);
 
@@ -814,13 +850,13 @@ __CUDA_FP16_DECL__ unsigned short int __half2ushort_ru(const __half h);
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert an unsigned short integer to a half in round-to-nearest-even
 * mode.
-* 
+*
 * \details Convert the unsigned short integer value \p i to a half-precision floating-point
 * value in round-to-nearest-even mode.
-* \param[in] i - unsigned short int. Is only being read. 
-* 
+* \param[in] i - unsigned short int. Is only being read.
+*
 * \returns half
-* \retval i converted to half. 
+* - \p i converted to half.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -831,13 +867,13 @@ __CUDA_HOSTDEVICE_FP16_DECL__ __half __ushort2half_rn(const unsigned short int i
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert an unsigned short integer to a half in round-towards-zero
 * mode.
-* 
+*
 * \details Convert the unsigned short integer value \p i to a half-precision floating-point
 * value in round-towards-zero mode.
-* \param[in] i - unsigned short int. Is only being read. 
-* 
+* \param[in] i - unsigned short int. Is only being read.
+*
 * \returns half
-* \retval i converted to half. 
+* - \p i converted to half.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -847,13 +883,13 @@ __CUDA_FP16_DECL__ __half __ushort2half_rz(const unsigned short int i);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert an unsigned short integer to a half in round-down mode.
-* 
+*
 * \details Convert the unsigned short integer value \p i to a half-precision floating-point
 * value in round-down mode.
-* \param[in] i - unsigned short int. Is only being read. 
-* 
+* \param[in] i - unsigned short int. Is only being read.
+*
 * \returns half
-* \retval i converted to half. 
+* - \p i converted to half.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -863,13 +899,13 @@ __CUDA_FP16_DECL__ __half __ushort2half_rd(const unsigned short int i);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert an unsigned short integer to a half in round-up mode.
-* 
+*
 * \details Convert the unsigned short integer value \p i to a half-precision floating-point
 * value in round-up mode.
-* \param[in] i - unsigned short int. Is only being read. 
-* 
+* \param[in] i - unsigned short int. Is only being read.
+*
 * \returns half
-* \retval i converted to half. 
+* - \p i converted to half.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -881,13 +917,13 @@ __CUDA_FP16_DECL__ __half __ushort2half_ru(const unsigned short int i);
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert a half to an unsigned 64-bit integer in round-to-nearest-even
 * mode.
-* 
+*
 * \details Convert the half-precision floating-point value \p h to an unsigned 64-bit
-* integer in round-to-nearest-even mode.
-* \param[in] h - half. Is only being read. 
-* 
+* integer in round-to-nearest-even mode. NaN inputs return 0x8000000000000000.
+* \param[in] h - half. Is only being read.
+*
 * \returns unsigned long long int
-* \retval h converted to an unsigned 64-bit integer. 
+* - \p h converted to an unsigned 64-bit integer.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -896,31 +932,14 @@ __CUDA_FP16_DECL__ __half __ushort2half_ru(const unsigned short int i);
 __CUDA_FP16_DECL__ unsigned long long int __half2ull_rn(const __half h);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
-* \brief Convert a half to an unsigned 64-bit integer in round-towards-zero
-* mode.
-* 
-* \details Convert the half-precision floating-point value \p h to an unsigned 64-bit
-* integer in round-towards-zero mode.
-* \param[in] h - half. Is only being read. 
-* 
-* \returns unsigned long long int
-* \retval h converted to an unsigned 64-bit integer. 
-* \internal
-* \exception-guarantee no-throw guarantee
-* \behavior reentrant, thread safe
-* \endinternal
-*/
-__CUDA_HOSTDEVICE_FP16_DECL__ unsigned long long int __half2ull_rz(const __half h);
-/**
-* \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert a half to an unsigned 64-bit integer in round-down mode.
-* 
+*
 * \details Convert the half-precision floating-point value \p h to an unsigned 64-bit
-* integer in round-down mode.
-* \param[in] h - half. Is only being read. 
-* 
+* integer in round-down mode. NaN inputs return 0x8000000000000000.
+* \param[in] h - half. Is only being read.
+*
 * \returns unsigned long long int
-* \retval h converted to an unsigned 64-bit integer. 
+* - \p h converted to an unsigned 64-bit integer.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -930,13 +949,13 @@ __CUDA_FP16_DECL__ unsigned long long int __half2ull_rd(const __half h);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert a half to an unsigned 64-bit integer in round-up mode.
-* 
+*
 * \details Convert the half-precision floating-point value \p h to an unsigned 64-bit
-* integer in round-up mode.
-* \param[in] h - half. Is only being read. 
-* 
+* integer in round-up mode. NaN inputs return 0x8000000000000000.
+* \param[in] h - half. Is only being read.
+*
 * \returns unsigned long long int
-* \retval h converted to an unsigned 64-bit integer. 
+* - \p h converted to an unsigned 64-bit integer.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -948,13 +967,13 @@ __CUDA_FP16_DECL__ unsigned long long int __half2ull_ru(const __half h);
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert an unsigned 64-bit integer to a half in round-to-nearest-even
 * mode.
-* 
+*
 * \details Convert the unsigned 64-bit integer value \p i to a half-precision floating-point
 * value in round-to-nearest-even mode.
-* \param[in] i - unsigned long long int. Is only being read. 
-* 
+* \param[in] i - unsigned long long int. Is only being read.
+*
 * \returns half
-* \retval i converted to half. 
+* - \p i converted to half.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -965,13 +984,13 @@ __CUDA_HOSTDEVICE_FP16_DECL__ __half __ull2half_rn(const unsigned long long int
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert an unsigned 64-bit integer to a half in round-towards-zero
 * mode.
-* 
+*
 * \details Convert the unsigned 64-bit integer value \p i to a half-precision floating-point
 * value in round-towards-zero mode.
-* \param[in] i - unsigned long long int. Is only being read. 
-* 
+* \param[in] i - unsigned long long int. Is only being read.
+*
 * \returns half
-* \retval i converted to half. 
+* - \p i converted to half.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -981,13 +1000,13 @@ __CUDA_FP16_DECL__ __half __ull2half_rz(const unsigned long long int i);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert an unsigned 64-bit integer to a half in round-down mode.
-* 
+*
 * \details Convert the unsigned 64-bit integer value \p i to a half-precision floating-point
 * value in round-down mode.
-* \param[in] i - unsigned long long int. Is only being read. 
-* 
+* \param[in] i - unsigned long long int. Is only being read.
+*
 * \returns half
-* \retval i converted to half.  
+* - \p i converted to half.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -997,13 +1016,13 @@ __CUDA_FP16_DECL__ __half __ull2half_rd(const unsigned long long int i);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert an unsigned 64-bit integer to a half in round-up mode.
-* 
+*
 * \details Convert the unsigned 64-bit integer value \p i to a half-precision floating-point
 * value in round-up mode.
-* \param[in] i - unsigned long long int. Is only being read. 
-* 
+* \param[in] i - unsigned long long int. Is only being read.
+*
 * \returns half
-* \retval i converted to half. 
+* - \p i converted to half.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -1015,13 +1034,13 @@ __CUDA_FP16_DECL__ __half __ull2half_ru(const unsigned long long int i);
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert a half to a signed 64-bit integer in round-to-nearest-even
 * mode.
-* 
+*
 * \details Convert the half-precision floating-point value \p h to a signed 64-bit
-* integer in round-to-nearest-even mode.
-* \param[in] h - half. Is only being read. 
-* 
+* integer in round-to-nearest-even mode. NaN inputs return a long long int with hex value of 0x8000000000000000.
+* \param[in] h - half. Is only being read.
+*
 * \returns long long int
-* \retval h converted to a signed 64-bit integer. 
+* - \p h converted to a signed 64-bit integer.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -1030,30 +1049,14 @@ __CUDA_FP16_DECL__ __half __ull2half_ru(const unsigned long long int i);
 __CUDA_FP16_DECL__ long long int __half2ll_rn(const __half h);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
-* \brief Convert a half to a signed 64-bit integer in round-towards-zero mode.
-* 
-* \details Convert the half-precision floating-point value \p h to a signed 64-bit
-* integer in round-towards-zero mode.
-* \param[in] h - half. Is only being read. 
-* 
-* \returns long long int
-* \retval h converted to a signed 64-bit integer. 
-* \internal
-* \exception-guarantee no-throw guarantee
-* \behavior reentrant, thread safe
-* \endinternal
-*/
-__CUDA_HOSTDEVICE_FP16_DECL__ long long int __half2ll_rz(const __half h);
-/**
-* \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert a half to a signed 64-bit integer in round-down mode.
-* 
+*
 * \details Convert the half-precision floating-point value \p h to a signed 64-bit
-* integer in round-down mode.
-* \param[in] h - half. Is only being read. 
-* 
+* integer in round-down mode. NaN inputs return a long long int with hex value of 0x8000000000000000.
+* \param[in] h - half. Is only being read.
+*
 * \returns long long int
-* \retval h converted to a signed 64-bit integer. 
+* - \p h converted to a signed 64-bit integer.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -1063,13 +1066,13 @@ __CUDA_FP16_DECL__ long long int __half2ll_rd(const __half h);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert a half to a signed 64-bit integer in round-up mode.
-* 
+*
 * \details Convert the half-precision floating-point value \p h to a signed 64-bit
-* integer in round-up mode.
-* \param[in] h - half. Is only being read. 
-* 
+* integer in round-up mode. NaN inputs return a long long int with hex value of 0x8000000000000000.
+* \param[in] h - half. Is only being read.
+*
 * \returns long long int
-* \retval h converted to a signed 64-bit integer. 
+* - \p h converted to a signed 64-bit integer.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -1081,13 +1084,13 @@ __CUDA_FP16_DECL__ long long int __half2ll_ru(const __half h);
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert a signed 64-bit integer to a half in round-to-nearest-even
 * mode.
-* 
+*
 * \details Convert the signed 64-bit integer value \p i to a half-precision floating-point
 * value in round-to-nearest-even mode.
-* \param[in] i - long long int. Is only being read. 
-* 
+* \param[in] i - long long int. Is only being read.
+*
 * \returns half
-* \retval i converted to half. 
+* - \p i converted to half.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -1097,25 +1100,25 @@ __CUDA_HOSTDEVICE_FP16_DECL__ __half __ll2half_rn(const long long int i);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert a signed 64-bit integer to a half in round-towards-zero mode.
-* 
+*
 * \details Convert the signed 64-bit integer value \p i to a half-precision floating-point
 * value in round-towards-zero mode.
-* \param[in] i - long long int. Is only being read. 
-* 
+* \param[in] i - long long int. Is only being read.
+*
 * \returns half
-* \retval i converted to half. 
+* - \p i converted to half.
 */
 __CUDA_FP16_DECL__ __half __ll2half_rz(const long long int i);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert a signed 64-bit integer to a half in round-down mode.
-* 
+*
 * \details Convert the signed 64-bit integer value \p i to a half-precision floating-point
 * value in round-down mode.
-* \param[in] i - long long int. Is only being read. 
-* 
+* \param[in] i - long long int. Is only being read.
+*
 * \returns half
-* \retval i converted to half. 
+* - \p i converted to half.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -1125,13 +1128,13 @@ __CUDA_FP16_DECL__ __half __ll2half_rd(const long long int i);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Convert a signed 64-bit integer to a half in round-up mode.
-* 
+*
 * \details Convert the signed 64-bit integer value \p i to a half-precision floating-point
 * value in round-up mode.
-* \param[in] i - long long int. Is only being read. 
-* 
+* \param[in] i - long long int. Is only being read.
+*
 * \returns half
-* \retval i converted to half. 
+* - \p i converted to half.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -1142,13 +1145,13 @@ __CUDA_FP16_DECL__ __half __ll2half_ru(const long long int i);
 /**
 * \ingroup CUDA_MATH__HALF_FUNCTIONS
 * \brief Truncate input argument to the integral part.
-* 
+*
 * \details Round \p h to the nearest integer value that does not exceed \p h in
 * magnitude.
-* \param[in] h - half. Is only being read. 
-* 
+* \param[in] h - half. Is only being read.
+*
 * \returns half
-* \retval The truncated integer value. 
+* - The truncated integer value.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -1158,12 +1161,12 @@ __CUDA_FP16_DECL__ __half htrunc(const __half h);
 /**
 * \ingroup CUDA_MATH__HALF_FUNCTIONS
 * \brief Calculate ceiling of the input argument.
-* 
+*
 * \details Compute the smallest integer value not less than \p h.
-* \param[in] h - half. Is only being read. 
-* 
+* \param[in] h - half. Is only being read.
+*
 * \returns half
-* \retval The smallest integer value not less than \p h. 
+* - The smallest integer value not less than \p h.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -1173,12 +1176,12 @@ __CUDA_FP16_DECL__ __half hceil(const __half h);
 /**
 * \ingroup CUDA_MATH__HALF_FUNCTIONS
 * \brief Calculate the largest integer less than or equal to \p h.
-* 
+*
 * \details Calculate the largest integer value which is less than or equal to \p h.
-* \param[in] h - half. Is only being read. 
-* 
+* \param[in] h - half. Is only being read.
+*
 * \returns half
-* \retval The largest integer value which is less than or equal to \p h. 
+* - The largest integer value which is less than or equal to \p h.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -1189,13 +1192,13 @@ __CUDA_FP16_DECL__ __half hfloor(const __half h);
 * \ingroup CUDA_MATH__HALF_FUNCTIONS
 * \brief Round input to nearest integer value in half-precision floating-point
 * number.
-* 
+*
 * \details Round \p h to the nearest integer value in half-precision floating-point
 * format, with halfway cases rounded to the nearest even integer value.
-* \param[in] h - half. Is only being read. 
-* 
+* \param[in] h - half. Is only being read.
+*
 * \returns half
-* \retval The nearest integer to \p h. 
+* - The nearest integer to \p h.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -1206,13 +1209,13 @@ __CUDA_FP16_DECL__ __half hrint(const __half h);
 /**
 * \ingroup CUDA_MATH__HALF2_FUNCTIONS
 * \brief Truncate \p half2 vector input argument to the integral part.
-* 
+*
 * \details Round each component of vector \p h to the nearest integer value that does
 * not exceed \p h in magnitude.
-* \param[in] h - half2. Is only being read. 
-* 
+* \param[in] h - half2. Is only being read.
+*
 * \returns half2
-* \retval The truncated \p h. 
+* - The truncated \p h.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -1222,13 +1225,13 @@ __CUDA_FP16_DECL__ __half2 h2trunc(const __half2 h);
 /**
 * \ingroup CUDA_MATH__HALF2_FUNCTIONS
 * \brief Calculate \p half2 vector ceiling of the input argument.
-* 
+*
 * \details For each component of vector \p h compute the smallest integer value not less
 * than \p h.
-* \param[in] h - half2. Is only being read. 
-* 
+* \param[in] h - half2. Is only being read.
+*
 * \returns half2
-* \retval The vector of smallest integers not less than \p h. 
+* - The vector of smallest integers not less than \p h.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -1238,13 +1241,13 @@ __CUDA_FP16_DECL__ __half2 h2ceil(const __half2 h);
 /**
 * \ingroup CUDA_MATH__HALF2_FUNCTIONS
 * \brief Calculate the largest integer less than or equal to \p h.
-* 
+*
 * \details For each component of vector \p h calculate the largest integer value which
 * is less than or equal to \p h.
-* \param[in] h - half2. Is only being read. 
-* 
+* \param[in] h - half2. Is only being read.
+*
 * \returns half2
-* \retval The vector of largest integers which is less than or equal to \p h. 
+* - The vector of largest integers which is less than or equal to \p h.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -1255,14 +1258,14 @@ __CUDA_FP16_DECL__ __half2 h2floor(const __half2 h);
 * \ingroup CUDA_MATH__HALF2_FUNCTIONS
 * \brief Round input to nearest integer value in half-precision floating-point
 * number.
-* 
+*
 * \details Round each component of \p half2 vector \p h to the nearest integer value in
 * half-precision floating-point format, with halfway cases rounded to the
 * nearest even integer value.
-* \param[in] h - half2. Is only being read. 
-* 
+* \param[in] h - half2. Is only being read.
+*
 * \returns half2
-* \retval The vector of rounded integer values. 
+* - The vector of rounded integer values.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -1273,13 +1276,13 @@ __CUDA_FP16_DECL__ __half2 h2rint(const __half2 h);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Returns \p half2 with both halves equal to the input value.
-* 
+*
 * \details Returns \p half2 number with both halves equal to the input \p a \p half
 * number.
-* \param[in] a - half. Is only being read. 
-* 
+* \param[in] a - half. Is only being read.
+*
 * \returns half2
-* \retval The vector which has both its halves equal to the input \p a. 
+* - The vector which has both its halves equal to the input \p a.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -1289,13 +1292,13 @@ __CUDA_FP16_DECL__ __half2 __half2half2(const __half a);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Swaps both halves of the \p half2 input.
-* 
+*
 * \details Swaps both halves of the \p half2 input and returns a new \p half2 number
 * with swapped halves.
-* \param[in] a - half2. Is only being read. 
-* 
+* \param[in] a - half2. Is only being read.
+*
 * \returns half2
-* \retval a with its halves being swapped. 
+* - \p a with its halves being swapped.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -1305,17 +1308,17 @@ __CUDA_FP16_DECL__ __half2 __lowhigh2highlow(const __half2 a);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Extracts low 16 bits from each of the two \p half2 inputs and combines
-* into one \p half2 number. 
-* 
+* into one \p half2 number.
+*
 * \details Extracts low 16 bits from each of the two \p half2 inputs and combines into
 * one \p half2 number. Low 16 bits from input \p a is stored in low 16 bits of
 * the return value, low 16 bits from input \p b is stored in high 16 bits of
-* the return value. 
-* \param[in] a - half2. Is only being read. 
-* \param[in] b - half2. Is only being read. 
-* 
+* the return value.
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
+*
 * \returns half2
-* \retval The low 16 bits of \p a and of \p b. 
+* - The low 16 bits of \p a and of \p b.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -1326,16 +1329,16 @@ __CUDA_FP16_DECL__ __half2 __lows2half2(const __half2 a, const __half2 b);
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Extracts high 16 bits from each of the two \p half2 inputs and
 * combines into one \p half2 number.
-* 
+*
 * \details Extracts high 16 bits from each of the two \p half2 inputs and combines into
 * one \p half2 number. High 16 bits from input \p a is stored in low 16 bits of
 * the return value, high 16 bits from input \p b is stored in high 16 bits of
 * the return value.
-* \param[in] a - half2. Is only being read. 
-* \param[in] b - half2. Is only being read. 
-* 
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
+*
 * \returns half2
-* \retval The high 16 bits of \p a and of \p b. 
+* - The high 16 bits of \p a and of \p b.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -1347,10 +1350,10 @@ __CUDA_FP16_DECL__ __half2 __highs2half2(const __half2 a, const __half2 b);
 * \brief Returns high 16 bits of \p half2 input.
 *
 * \details Returns high 16 bits of \p half2 input \p a.
-* \param[in] a - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
 *
 * \returns half
-* \retval The high 16 bits of the input. 
+* - The high 16 bits of the input.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -1362,10 +1365,10 @@ __CUDA_FP16_DECL__ __half __high2half(const __half2 a);
 * \brief Returns low 16 bits of \p half2 input.
 *
 * \details Returns low 16 bits of \p half2 input \p a.
-* \param[in] a - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
 *
 * \returns half
-* \retval Returns \p half which contains low 16 bits of the input \p a. 
+* - Returns \p half which contains low 16 bits of the input \p a.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -1375,14 +1378,14 @@ __CUDA_FP16_DECL__ __half __low2half(const __half2 a);
 /**
 * \ingroup CUDA_MATH__HALF_COMPARISON
 * \brief Checks if the input \p half number is infinite.
-* 
-* \details Checks if the input \p half number \p a is infinite. 
-* \param[in] a - half. Is only being read. 
-* 
-* \returns int 
-* \retval -1 iff \p a is equal to negative infinity, 
-* \retval 1 iff \p a is equal to positive infinity, 
-* \retval 0 otherwise. 
+*
+* \details Checks if the input \p half number \p a is infinite.
+* \param[in] a - half. Is only being read.
+*
+* \returns int
+* - -1 iff \p a is equal to negative infinity,
+* - 1 iff \p a is equal to positive infinity,
+* - 0 otherwise.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -1392,15 +1395,15 @@ __CUDA_FP16_DECL__ int __hisinf(const __half a);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Combines two \p half numbers into one \p half2 number.
-* 
+*
 * \details Combines two input \p half number \p a and \p b into one \p half2 number.
 * Input \p a is stored in low 16 bits of the return value, input \p b is stored
 * in high 16 bits of the return value.
-* \param[in] a - half. Is only being read. 
-* \param[in] b - half. Is only being read. 
-* 
+* \param[in] a - half. Is only being read.
+* \param[in] b - half. Is only being read.
+*
 * \returns half2
-* \retval The half2 with one half equal to \p a and the other to \p b. 
+* - The half2 with one half equal to \p a and the other to \p b.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -1410,13 +1413,13 @@ __CUDA_FP16_DECL__ __half2 __halves2half2(const __half a, const __half b);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Extracts low 16 bits from \p half2 input.
-* 
+*
 * \details Extracts low 16 bits from \p half2 input \p a and returns a new \p half2
 * number which has both halves equal to the extracted bits.
-* \param[in] a - half2. Is only being read. 
-* 
+* \param[in] a - half2. Is only being read.
+*
 * \returns half2
-* \retval The half2 with both halves equal to the low 16 bits of the input. 
+* - The half2 with both halves equal to the low 16 bits of the input.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -1426,13 +1429,13 @@ __CUDA_FP16_DECL__ __half2 __low2half2(const __half2 a);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Extracts high 16 bits from \p half2 input.
-* 
+*
 * \details Extracts high 16 bits from \p half2 input \p a and returns a new \p half2
 * number which has both halves equal to the extracted bits.
-* \param[in] a - half2. Is only being read. 
-* 
+* \param[in] a - half2. Is only being read.
+*
 * \returns half2
-* \retval The half2 with both halves equal to the high 16 bits of the input. 
+* - The half2 with both halves equal to the high 16 bits of the input.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -1443,13 +1446,13 @@ __CUDA_FP16_DECL__ __half2 __high2half2(const __half2 a);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Reinterprets bits in a \p half as a signed short integer.
-* 
+*
 * \details Reinterprets the bits in the half-precision floating-point number \p h
-* as a signed short integer. 
-* \param[in] h - half. Is only being read. 
-* 
+* as a signed short integer.
+* \param[in] h - half. Is only being read.
+*
 * \returns short int
-* \retval The reinterpreted value. 
+* - The reinterpreted value.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -1459,13 +1462,13 @@ __CUDA_FP16_DECL__ short int __half_as_short(const __half h);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Reinterprets bits in a \p half as an unsigned short integer.
-* 
+*
 * \details Reinterprets the bits in the half-precision floating-point \p h
 * as an unsigned short number.
-* \param[in] h - half. Is only being read. 
-* 
+* \param[in] h - half. Is only being read.
+*
 * \returns unsigned short int
-* \retval The reinterpreted value.
+* - The reinterpreted value.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -1475,13 +1478,13 @@ __CUDA_FP16_DECL__ unsigned short int __half_as_ushort(const __half h);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Reinterprets bits in a signed short integer as a \p half.
-* 
+*
 * \details Reinterprets the bits in the signed short integer \p i as a
 * half-precision floating-point number.
-* \param[in] i - short int. Is only being read. 
-* 
+* \param[in] i - short int. Is only being read.
+*
 * \returns half
-* \retval The reinterpreted value.
+* - The reinterpreted value.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -1491,21 +1494,101 @@ __CUDA_FP16_DECL__ __half __short_as_half(const short int i);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Reinterprets bits in an unsigned short integer as a \p half.
-* 
+*
 * \details Reinterprets the bits in the unsigned short integer \p i as a
 * half-precision floating-point number.
-* \param[in] i - unsigned short int. Is only being read. 
-* 
+* \param[in] i - unsigned short int. Is only being read.
+*
 * \returns half
-* \retval The reinterpreted value.
+* - The reinterpreted value.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
 * \endinternal
 */
 __CUDA_FP16_DECL__ __half __ushort_as_half(const unsigned short int i);
+/**
+* \ingroup CUDA_MATH__HALF_COMPARISON
+* \brief Calculates \p half maximum of two input values.
+*
+* \details Calculates \p half max(\p a, \p b)
+* defined as (\p a > \p b) ? \p a : \p b.
+* - If either of inputs is NaN, the other input is returned.
+* - If both inputs are NaNs, then canonical NaN is returned.
+* - If values of both inputs are 0.0, then +0.0 > -0.0
+* \param[in] a - half. Is only being read.
+* \param[in] b - half. Is only being read.
+*
+* \returns half
+* \internal
+* \exception-guarantee no-throw guarantee
+* \behavior reentrant, thread safe
+* \endinternal
+*/
+__CUDA_FP16_DECL__ __half __hmax(const __half a, const __half b);
+/**
+* \ingroup CUDA_MATH__HALF_COMPARISON
+* \brief Calculates \p half minimum of two input values.
+*
+* \details Calculates \p half min(\p a, \p b)
+* defined as (\p a < \p b) ? \p a : \p b.
+* - If either of inputs is NaN, the other input is returned.
+* - If both inputs are NaNs, then canonical NaN is returned.
+* - If values of both inputs are 0.0, then +0.0 > -0.0
+* \param[in] a - half. Is only being read.
+* \param[in] b - half. Is only being read.
+*
+* \returns half
+* \internal
+* \exception-guarantee no-throw guarantee
+* \behavior reentrant, thread safe
+* \endinternal
+*/
+__CUDA_FP16_DECL__ __half __hmin(const __half a, const __half b);
+/**
+* \ingroup CUDA_MATH__HALF2_COMPARISON
+* \brief Calculates \p half2 vector maximum of two inputs.
+*
+* \details Calculates \p half2 vector max(\p a, \p b).
+* Elementwise \p half operation is defined as
+* (\p a > \p b) ? \p a : \p b.
+* - If either of inputs is NaN, the other input is returned.
+* - If both inputs are NaNs, then canonical NaN is returned.
+* - If values of both inputs are 0.0, then +0.0 > -0.0
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
+*
+* \returns half2
+* - The result of elementwise maximum of vectors \p a  and \p b
+* \internal
+* \exception-guarantee no-throw guarantee
+* \behavior reentrant, thread safe
+* \endinternal
+*/
+__CUDA_FP16_DECL__ __half2 __hmax2(const __half2 a, const __half2 b);
+/**
+* \ingroup CUDA_MATH__HALF2_COMPARISON
+* \brief Calculates \p half2 vector minimum of two inputs.
+*
+* \details Calculates \p half2 vector min(\p a, \p b).
+* Elementwise \p half operation is defined as
+* (\p a < \p b) ? \p a : \p b.
+* - If either of inputs is NaN, the other input is returned.
+* - If both inputs are NaNs, then canonical NaN is returned.
+* - If values of both inputs are 0.0, then +0.0 > -0.0
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
+*
+* \returns half2
+* - The result of elementwise minimum of vectors \p a  and \p b
+* \internal
+* \exception-guarantee no-throw guarantee
+* \behavior reentrant, thread safe
+* \endinternal
+*/
+__CUDA_FP16_DECL__ __half2 __hmin2(const __half2 a, const __half2 b);
 
-#if __CUDA_ARCH__ >= 300 || !defined(__CUDA_ARCH__)
+#if !defined(__CUDA_ARCH__) || (__CUDA_ARCH__ >= 300)
 #if !defined warpSize && !defined __local_warpSize
 #define warpSize    32
 #define __local_warpSize
@@ -1520,7 +1603,7 @@ __CUDA_FP16_DECL__ __half __ushort_as_half(const unsigned short int i);
 #endif
 
 #if !defined(__CUDA_ARCH__) || __CUDA_ARCH__ < 700
-#define __WSB_DEPRECATION_MESSAGE(x) #x"() is deprecated in favor of "#x"_sync() and may be removed in a future release (Use -Wno-deprecated-declarations to suppress this warning)."
+#define __WSB_DEPRECATION_MESSAGE(x) __CUDA_FP16_STRINGIFY(x) "() is deprecated in favor of " __CUDA_FP16_STRINGIFY(x) "_sync() and may be removed in a future release (Use -Wno-deprecated-declarations to suppress this warning)."
 
 __CUDA_FP16_DECL__ __DEPRECATED__(__WSB_DEPRECATION_MESSAGE(__shfl)) __half2 __shfl(const __half2 var, const int delta, const int width = warpSize);
 __CUDA_FP16_DECL__ __DEPRECATED__(__WSB_DEPRECATION_MESSAGE(__shfl_up)) __half2 __shfl_up(const __half2 var, const unsigned int delta, const int width = warpSize);
@@ -1534,22 +1617,22 @@ __CUDA_FP16_DECL__ __DEPRECATED__(__WSB_DEPRECATION_MESSAGE(__shfl_xor)) __half
 
 /**
 * \ingroup CUDA_MATH__HALF_MISC
-* \brief Exchange a variable between threads within a warp. Direct copy from indexed thread. 
-* 
-* \details Returns the value of var held by the thread whose ID is given by delta. 
-* If width is less than warpSize then each subsection of the warp behaves as a separate 
-* entity with a starting logical thread ID of 0. If delta is outside the range [0:width-1], 
-* the value returned corresponds to the value of var held by the delta modulo width (i.e. 
-* within the same subsection). width must have a value which is a power of 2; 
-* results are undefined if width is not a power of 2, or is a number greater than 
-* warpSize. 
-* \param[in] mask - unsigned int. Is only being read. 
-* \param[in] var - half2. Is only being read. 
-* \param[in] delta - int. Is only being read. 
-* \param[in] width - int. Is only being read. 
-* 
-* \returns Returns the 4-byte word referenced by var from the source thread ID as half2. 
-* If the source thread ID is out of range or the source thread has exited, the calling thread's own var is returned. 
+* \brief Exchange a variable between threads within a warp. Direct copy from indexed thread.
+*
+* \details Returns the value of var held by the thread whose ID is given by delta.
+* If width is less than warpSize then each subsection of the warp behaves as a separate
+* entity with a starting logical thread ID of 0. If delta is outside the range [0:width-1],
+* the value returned corresponds to the value of var held by the delta modulo width (i.e.
+* within the same subsection). width must have a value which is a power of 2;
+* results are undefined if width is not a power of 2, or is a number greater than
+* warpSize.
+* \param[in] mask - unsigned int. Is only being read.
+* \param[in] var - half2. Is only being read.
+* \param[in] delta - int. Is only being read.
+* \param[in] width - int. Is only being read.
+*
+* \returns Returns the 4-byte word referenced by var from the source thread ID as half2.
+* If the source thread ID is out of range or the source thread has exited, the calling thread's own var is returned.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior not reentrant, not thread safe
@@ -1558,22 +1641,23 @@ __CUDA_FP16_DECL__ __DEPRECATED__(__WSB_DEPRECATION_MESSAGE(__shfl_xor)) __half
 __CUDA_FP16_DECL__ __half2 __shfl_sync(const unsigned mask, const __half2 var, const int delta, const int width = warpSize);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
-* \brief Exchange a variable between threads within a warp. Copy from a thread with lower ID relative to the caller. 
-* 
-* \details Calculates a source thread ID by subtracting delta from the caller's lane ID. 
-* The value of var held by the resulting lane ID is returned: in effect, var is shifted up 
-* the warp by delta threads. If width is less than warpSize then each subsection of the warp 
-* behaves as a separate entity with a starting logical thread ID of 0. The source thread index 
-* will not wrap around the value of width, so effectively the lower delta threads will be unchanged. 
-* width must have a value which is a power of 2; results are undefined if width is not a power of 2, 
-* or is a number greater than warpSize. 
-* \param[in] mask - unsigned int. Is only being read. 
-* \param[in] var - half2. Is only being read. 
-* \param[in] delta - int. Is only being read. 
-* \param[in] width - int. Is only being read. 
-* 
-* \returns Returns the 4-byte word referenced by var from the source thread ID as half2. 
-* If the source thread ID is out of range or the source thread has exited, the calling thread's own var is returned. 
+* \brief Exchange a variable between threads within a warp. Copy from a thread with lower ID relative to the caller.
+*
+* \details Calculates a source thread ID by subtracting delta from the caller's lane ID.
+* The value of var held by the resulting lane ID is returned: in effect, var is shifted up
+* the warp by delta threads. If width is less than warpSize then each subsection of the warp
+* behaves as a separate entity with a starting logical thread ID of 0. The source thread index
+* will not wrap around the value of width, so effectively the lower delta threads will be unchanged.
+* width must have a value which is a power of 2; results are undefined if width is not a power of 2,
+* or is a number greater than warpSize.
+* \param[in] mask - unsigned int. Is only being read.
+* \param[in] var - half2. Is only being read.
+* \param[in] delta - int. Is only being read.
+* \param[in] width - int. Is only being read.
+*
+* \returns Returns the 4-byte word referenced by var from the source thread ID as half2.
+* If the source thread ID is out of range or the source thread has exited, the calling thread's own var is returned.
+* \note_ref_guide_warp_shuffle
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior not reentrant, not thread safe
@@ -1582,22 +1666,23 @@ __CUDA_FP16_DECL__ __half2 __shfl_sync(const unsigned mask, const __half2 var, c
 __CUDA_FP16_DECL__ __half2 __shfl_up_sync(const unsigned mask, const __half2 var, const unsigned int delta, const int width = warpSize);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
-* \brief Exchange a variable between threads within a warp. Copy from a thread with higher ID relative to the caller. 
-* 
-* \details Calculates a source thread ID by adding delta to the caller's thread ID. 
-* The value of var held by the resulting thread ID is returned: this has the effect 
-* of shifting var down the warp by delta threads. If width is less than warpSize then 
-* each subsection of the warp behaves as a separate entity with a starting logical 
-* thread ID of 0. As for __shfl_up_sync(), the ID number of the source thread 
-* will not wrap around the value of width and so the upper delta threads 
-* will remain unchanged. 
-* \param[in] mask - unsigned int. Is only being read. 
-* \param[in] var - half2. Is only being read. 
-* \param[in] delta - int. Is only being read. 
-* \param[in] width - int. Is only being read. 
-* 
-* \returns Returns the 4-byte word referenced by var from the source thread ID as half2. 
-* If the source thread ID is out of range or the source thread has exited, the calling thread's own var is returned. 
+* \brief Exchange a variable between threads within a warp. Copy from a thread with higher ID relative to the caller.
+*
+* \details Calculates a source thread ID by adding delta to the caller's thread ID.
+* The value of var held by the resulting thread ID is returned: this has the effect
+* of shifting var down the warp by delta threads. If width is less than warpSize then
+* each subsection of the warp behaves as a separate entity with a starting logical
+* thread ID of 0. As for __shfl_up_sync(), the ID number of the source thread
+* will not wrap around the value of width and so the upper delta threads
+* will remain unchanged.
+* \param[in] mask - unsigned int. Is only being read.
+* \param[in] var - half2. Is only being read.
+* \param[in] delta - int. Is only being read.
+* \param[in] width - int. Is only being read.
+*
+* \returns Returns the 4-byte word referenced by var from the source thread ID as half2.
+* If the source thread ID is out of range or the source thread has exited, the calling thread's own var is returned.
+* \note_ref_guide_warp_shuffle
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior not reentrant, not thread safe
@@ -1606,21 +1691,22 @@ __CUDA_FP16_DECL__ __half2 __shfl_up_sync(const unsigned mask, const __half2 var
 __CUDA_FP16_DECL__ __half2 __shfl_down_sync(const unsigned mask, const __half2 var, const unsigned int delta, const int width = warpSize);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
-* \brief Exchange a variable between threads within a warp. Copy from a thread based on bitwise XOR of own thread ID. 
-* 
-* \details Calculates a source thread ID by performing a bitwise XOR of the caller's thread ID with mask: 
-* the value of var held by the resulting thread ID is returned. If width is less than warpSize then each 
-* group of width consecutive threads are able to access elements from earlier groups of threads, 
-* however if they attempt to access elements from later groups of threads their own value of var 
-* will be returned. This mode implements a butterfly addressing pattern such as is used in tree 
-* reduction and broadcast. 
-* \param[in] mask - unsigned int. Is only being read. 
-* \param[in] var - half2. Is only being read. 
-* \param[in] delta - int. Is only being read. 
-* \param[in] width - int. Is only being read. 
-* 
-* \returns Returns the 4-byte word referenced by var from the source thread ID as half2. 
-* If the source thread ID is out of range or the source thread has exited, the calling thread's own var is returned. 
+* \brief Exchange a variable between threads within a warp. Copy from a thread based on bitwise XOR of own thread ID.
+*
+* \details Calculates a source thread ID by performing a bitwise XOR of the caller's thread ID with mask:
+* the value of var held by the resulting thread ID is returned. If width is less than warpSize then each
+* group of width consecutive threads are able to access elements from earlier groups of threads,
+* however if they attempt to access elements from later groups of threads their own value of var
+* will be returned. This mode implements a butterfly addressing pattern such as is used in tree
+* reduction and broadcast.
+* \param[in] mask - unsigned int. Is only being read.
+* \param[in] var - half2. Is only being read.
+* \param[in] delta - int. Is only being read.
+* \param[in] width - int. Is only being read.
+*
+* \returns Returns the 4-byte word referenced by var from the source thread ID as half2.
+* If the source thread ID is out of range or the source thread has exited, the calling thread's own var is returned.
+* \note_ref_guide_warp_shuffle
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior not reentrant, not thread safe
@@ -1629,22 +1715,23 @@ __CUDA_FP16_DECL__ __half2 __shfl_down_sync(const unsigned mask, const __half2 v
 __CUDA_FP16_DECL__ __half2 __shfl_xor_sync(const unsigned mask, const __half2 var, const int delta, const int width = warpSize);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
-* \brief Exchange a variable between threads within a warp. Direct copy from indexed thread. 
-* 
-* \details Returns the value of var held by the thread whose ID is given by delta. 
-* If width is less than warpSize then each subsection of the warp behaves as a separate 
-* entity with a starting logical thread ID of 0. If delta is outside the range [0:width-1], 
-* the value returned corresponds to the value of var held by the delta modulo width (i.e. 
-* within the same subsection). width must have a value which is a power of 2; 
-* results are undefined if width is not a power of 2, or is a number greater than 
-* warpSize. 
-* \param[in] mask - unsigned int. Is only being read. 
-* \param[in] var - half. Is only being read. 
-* \param[in] delta - int. Is only being read. 
-* \param[in] width - int. Is only being read. 
-* 
-* \returns Returns the 2-byte word referenced by var from the source thread ID as half. 
-* If the source thread ID is out of range or the source thread has exited, the calling thread's own var is returned. 
+* \brief Exchange a variable between threads within a warp. Direct copy from indexed thread.
+*
+* \details Returns the value of var held by the thread whose ID is given by delta.
+* If width is less than warpSize then each subsection of the warp behaves as a separate
+* entity with a starting logical thread ID of 0. If delta is outside the range [0:width-1],
+* the value returned corresponds to the value of var held by the delta modulo width (i.e.
+* within the same subsection). width must have a value which is a power of 2;
+* results are undefined if width is not a power of 2, or is a number greater than
+* warpSize.
+* \param[in] mask - unsigned int. Is only being read.
+* \param[in] var - half. Is only being read.
+* \param[in] delta - int. Is only being read.
+* \param[in] width - int. Is only being read.
+*
+* \returns Returns the 2-byte word referenced by var from the source thread ID as half.
+* If the source thread ID is out of range or the source thread has exited, the calling thread's own var is returned.
+* \note_ref_guide_warp_shuffle
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior not reentrant, not thread safe
@@ -1653,21 +1740,22 @@ __CUDA_FP16_DECL__ __half2 __shfl_xor_sync(const unsigned mask, const __half2 va
 __CUDA_FP16_DECL__ __half __shfl_sync(const unsigned mask, const __half var, const int delta, const int width = warpSize);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
-* \brief Exchange a variable between threads within a warp. Copy from a thread with lower ID relative to the caller. 
-* \details Calculates a source thread ID by subtracting delta from the caller's lane ID. 
-* The value of var held by the resulting lane ID is returned: in effect, var is shifted up 
-* the warp by delta threads. If width is less than warpSize then each subsection of the warp 
-* behaves as a separate entity with a starting logical thread ID of 0. The source thread index 
-* will not wrap around the value of width, so effectively the lower delta threads will be unchanged. 
-* width must have a value which is a power of 2; results are undefined if width is not a power of 2, 
-* or is a number greater than warpSize. 
-* \param[in] mask - unsigned int. Is only being read. 
-* \param[in] var - half. Is only being read. 
-* \param[in] delta - int. Is only being read. 
-* \param[in] width - int. Is only being read. 
-* 
-* \returns Returns the 2-byte word referenced by var from the source thread ID as half. 
-* If the source thread ID is out of range or the source thread has exited, the calling thread's own var is returned. 
+* \brief Exchange a variable between threads within a warp. Copy from a thread with lower ID relative to the caller.
+* \details Calculates a source thread ID by subtracting delta from the caller's lane ID.
+* The value of var held by the resulting lane ID is returned: in effect, var is shifted up
+* the warp by delta threads. If width is less than warpSize then each subsection of the warp
+* behaves as a separate entity with a starting logical thread ID of 0. The source thread index
+* will not wrap around the value of width, so effectively the lower delta threads will be unchanged.
+* width must have a value which is a power of 2; results are undefined if width is not a power of 2,
+* or is a number greater than warpSize.
+* \param[in] mask - unsigned int. Is only being read.
+* \param[in] var - half. Is only being read.
+* \param[in] delta - int. Is only being read.
+* \param[in] width - int. Is only being read.
+*
+* \returns Returns the 2-byte word referenced by var from the source thread ID as half.
+* If the source thread ID is out of range or the source thread has exited, the calling thread's own var is returned.
+* \note_ref_guide_warp_shuffle
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior not reentrant, not thread safe
@@ -1676,22 +1764,23 @@ __CUDA_FP16_DECL__ __half __shfl_sync(const unsigned mask, const __half var, con
 __CUDA_FP16_DECL__ __half __shfl_up_sync(const unsigned mask, const __half var, const unsigned int delta, const int width = warpSize);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
-* \brief Exchange a variable between threads within a warp. Copy from a thread with higher ID relative to the caller. 
-* 
-* \details Calculates a source thread ID by adding delta to the caller's thread ID. 
-* The value of var held by the resulting thread ID is returned: this has the effect 
-* of shifting var down the warp by delta threads. If width is less than warpSize then 
-* each subsection of the warp behaves as a separate entity with a starting logical 
-* thread ID of 0. As for __shfl_up_sync(), the ID number of the source thread 
-* will not wrap around the value of width and so the upper delta threads 
-* will remain unchanged. 
-* \param[in] mask - unsigned int. Is only being read. 
-* \param[in] var - half. Is only being read. 
-* \param[in] delta - int. Is only being read. 
-* \param[in] width - int. Is only being read. 
-* 
-* \returns Returns the 2-byte word referenced by var from the source thread ID as half. 
-* If the source thread ID is out of range or the source thread has exited, the calling thread's own var is returned. 
+* \brief Exchange a variable between threads within a warp. Copy from a thread with higher ID relative to the caller.
+*
+* \details Calculates a source thread ID by adding delta to the caller's thread ID.
+* The value of var held by the resulting thread ID is returned: this has the effect
+* of shifting var down the warp by delta threads. If width is less than warpSize then
+* each subsection of the warp behaves as a separate entity with a starting logical
+* thread ID of 0. As for __shfl_up_sync(), the ID number of the source thread
+* will not wrap around the value of width and so the upper delta threads
+* will remain unchanged.
+* \param[in] mask - unsigned int. Is only being read.
+* \param[in] var - half. Is only being read.
+* \param[in] delta - int. Is only being read.
+* \param[in] width - int. Is only being read.
+*
+* \returns Returns the 2-byte word referenced by var from the source thread ID as half.
+* If the source thread ID is out of range or the source thread has exited, the calling thread's own var is returned.
+* \note_ref_guide_warp_shuffle
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior not reentrant, not thread safe
@@ -1700,21 +1789,22 @@ __CUDA_FP16_DECL__ __half __shfl_up_sync(const unsigned mask, const __half var,
 __CUDA_FP16_DECL__ __half __shfl_down_sync(const unsigned mask, const __half var, const unsigned int delta, const int width = warpSize);
 /**
 * \ingroup CUDA_MATH__HALF_MISC
-* \brief Exchange a variable between threads within a warp. Copy from a thread based on bitwise XOR of own thread ID. 
-* 
-* \details Calculates a source thread ID by performing a bitwise XOR of the caller's thread ID with mask: 
-* the value of var held by the resulting thread ID is returned. If width is less than warpSize then each 
-* group of width consecutive threads are able to access elements from earlier groups of threads, 
-* however if they attempt to access elements from later groups of threads their own value of var 
-* will be returned. This mode implements a butterfly addressing pattern such as is used in tree 
-* reduction and broadcast. 
-* \param[in] mask - unsigned int. Is only being read. 
-* \param[in] var - half. Is only being read. 
-* \param[in] delta - int. Is only being read. 
-* \param[in] width - int. Is only being read. 
-* 
-* \returns Returns the 2-byte word referenced by var from the source thread ID as half. 
-* If the source thread ID is out of range or the source thread has exited, the calling thread's own var is returned. 
+* \brief Exchange a variable between threads within a warp. Copy from a thread based on bitwise XOR of own thread ID.
+*
+* \details Calculates a source thread ID by performing a bitwise XOR of the caller's thread ID with mask:
+* the value of var held by the resulting thread ID is returned. If width is less than warpSize then each
+* group of width consecutive threads are able to access elements from earlier groups of threads,
+* however if they attempt to access elements from later groups of threads their own value of var
+* will be returned. This mode implements a butterfly addressing pattern such as is used in tree
+* reduction and broadcast.
+* \param[in] mask - unsigned int. Is only being read.
+* \param[in] var - half. Is only being read.
+* \param[in] delta - int. Is only being read.
+* \param[in] width - int. Is only being read.
+*
+* \returns Returns the 2-byte word referenced by var from the source thread ID as half.
+* If the source thread ID is out of range or the source thread has exited, the calling thread's own var is returned.
+* \note_ref_guide_warp_shuffle
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior not reentrant, not thread safe
@@ -1726,9 +1816,9 @@ __CUDA_FP16_DECL__ __half __shfl_xor_sync(const unsigned mask, const __half var,
 #undef warpSize
 #undef __local_warpSize
 #endif
-#endif /*__CUDA_ARCH__ >= 300 || !defined(__CUDA_ARCH__) */
+#endif /*!defined(__CUDA_ARCH__) || (__CUDA_ARCH__ >= 300) */
 
-#if defined(__cplusplus) && ( __CUDA_ARCH__ >=320 || !defined(__CUDA_ARCH__) )
+#if defined(__cplusplus) && ( !defined(__CUDA_ARCH__) || (__CUDA_ARCH__ >= 320) )
 /**
 * \ingroup CUDA_MATH__HALF_MISC
 * \brief Generates a `ld.global.nc` load instruction.
@@ -1869,21 +1959,21 @@ __CUDA_FP16_DECL__ void __stwt(__half2 *const ptr, const __half2 value);
 * \param[in] value - the value to be stored
 */
 __CUDA_FP16_DECL__ void __stwt(__half *const ptr, const __half value);
-#endif /*defined(__cplusplus) && ( __CUDA_ARCH__ >=320 || !defined(__CUDA_ARCH__) )*/
+#endif /*defined(__cplusplus) && ( !defined(__CUDA_ARCH__) || (__CUDA_ARCH__ >= 320) )*/
 
-#if __CUDA_ARCH__ >= 530 || !defined(__CUDA_ARCH__)
+#if !defined(__CUDA_ARCH__) || (__CUDA_ARCH__ >= 530)
 /**
 * \ingroup CUDA_MATH__HALF2_COMPARISON
 * \brief Performs half2 vector if-equal comparison.
-* 
+*
 * \details Performs \p half2 vector if-equal comparison of inputs \p a and \p b.
 * The corresponding \p half results are set to 1.0 for true, or 0.0 for false.
 * NaN inputs generate false results.
-* \param[in] a - half2. Is only being read. 
-* \param[in] b - half2. Is only being read. 
-* 
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
+*
 * \returns half2
-* \retval The vector result of if-equal comparison of vectors \p a and \p b.
+* - The vector result of if-equal comparison of vectors \p a and \p b.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -1893,15 +1983,15 @@ __CUDA_FP16_DECL__ __half2 __heq2(const __half2 a, const __half2 b);
 /**
 * \ingroup CUDA_MATH__HALF2_COMPARISON
 * \brief Performs \p half2 vector not-equal comparison.
-* 
+*
 * \details Performs \p half2 vector not-equal comparison of inputs \p a and \p b.
 * The corresponding \p half results are set to 1.0 for true, or 0.0 for false.
 * NaN inputs generate false results.
-* \param[in] a - half2. Is only being read. 
-* \param[in] b - half2. Is only being read. 
-* 
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
+*
 * \returns half2
-* \retval The vector result of not-equal comparison of vectors \p a and \p b.
+* - The vector result of not-equal comparison of vectors \p a and \p b.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -1915,11 +2005,11 @@ __CUDA_FP16_DECL__ __half2 __hne2(const __half2 a, const __half2 b);
 * \details Performs \p half2 vector less-equal comparison of inputs \p a and \p b.
 * The corresponding \p half results are set to 1.0 for true, or 0.0 for false.
 * NaN inputs generate false results.
-* \param[in] a - half2. Is only being read. 
-* \param[in] b - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
 *
 * \returns half2
-* \retval The \p half2 result of less-equal comparison of vectors \p a and \p b.
+* - The \p half2 result of less-equal comparison of vectors \p a and \p b.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -1933,11 +2023,11 @@ __CUDA_FP16_DECL__ __half2 __hle2(const __half2 a, const __half2 b);
 * \details Performs \p half2 vector greater-equal comparison of inputs \p a and \p b.
 * The corresponding \p half results are set to 1.0 for true, or 0.0 for false.
 * NaN inputs generate false results.
-* \param[in] a - half2. Is only being read. 
-* \param[in] b - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
 *
 * \returns half2
-* \retval The vector result of greater-equal comparison of vectors \p a and \p b.
+* - The vector result of greater-equal comparison of vectors \p a and \p b.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -1951,11 +2041,11 @@ __CUDA_FP16_DECL__ __half2 __hge2(const __half2 a, const __half2 b);
 * \details Performs \p half2 vector less-than comparison of inputs \p a and \p b.
 * The corresponding \p half results are set to 1.0 for true, or 0.0 for false.
 * NaN inputs generate false results.
-* \param[in] a - half2. Is only being read. 
-* \param[in] b - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
 *
 * \returns half2
-* \retval The half2 vector result of less-than comparison of vectors \p a and \p b.
+* - The half2 vector result of less-than comparison of vectors \p a and \p b.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -1965,15 +2055,15 @@ __CUDA_FP16_DECL__ __half2 __hlt2(const __half2 a, const __half2 b);
 /**
 * \ingroup CUDA_MATH__HALF2_COMPARISON
 * \brief Performs \p half2 vector greater-than comparison.
-* 
+*
 * \details Performs \p half2 vector greater-than comparison of inputs \p a and \p b.
 * The corresponding \p half results are set to 1.0 for true, or 0.0 for false.
 * NaN inputs generate false results.
-* \param[in] a - half2. Is only being read. 
-* \param[in] b - half2. Is only being read. 
-* 
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
+*
 * \returns half2
-* \retval The vector result of greater-than comparison of vectors \p a and \p b.
+* - The vector result of greater-than comparison of vectors \p a and \p b.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -1983,15 +2073,15 @@ __CUDA_FP16_DECL__ __half2 __hgt2(const __half2 a, const __half2 b);
 /**
 * \ingroup CUDA_MATH__HALF2_COMPARISON
 * \brief Performs \p half2 vector unordered if-equal comparison.
-* 
+*
 * \details Performs \p half2 vector if-equal comparison of inputs \p a and \p b.
 * The corresponding \p half results are set to 1.0 for true, or 0.0 for false.
 * NaN inputs generate true results.
-* \param[in] a - half2. Is only being read. 
-* \param[in] b - half2. Is only being read. 
-* 
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
+*
 * \returns half2
-* \retval The vector result of unordered if-equal comparison of vectors \p a and \p b.
+* - The vector result of unordered if-equal comparison of vectors \p a and \p b.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2005,11 +2095,11 @@ __CUDA_FP16_DECL__ __half2 __hequ2(const __half2 a, const __half2 b);
 * \details Performs \p half2 vector not-equal comparison of inputs \p a and \p b.
 * The corresponding \p half results are set to 1.0 for true, or 0.0 for false.
 * NaN inputs generate true results.
-* \param[in] a - half2. Is only being read. 
-* \param[in] b - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
 *
 * \returns half2
-* \retval The vector result of unordered not-equal comparison of vectors \p a and \p b.
+* - The vector result of unordered not-equal comparison of vectors \p a and \p b.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2023,11 +2113,11 @@ __CUDA_FP16_DECL__ __half2 __hneu2(const __half2 a, const __half2 b);
 * Performs \p half2 vector less-equal comparison of inputs \p a and \p b.
 * The corresponding \p half results are set to 1.0 for true, or 0.0 for false.
 * NaN inputs generate true results.
-* \param[in] a - half2. Is only being read. 
-* \param[in] b - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
 *
 * \returns half2
-* \retval The vector result of unordered less-equal comparison of vectors \p a and \p b.
+* - The vector result of unordered less-equal comparison of vectors \p a and \p b.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2041,11 +2131,11 @@ __CUDA_FP16_DECL__ __half2 __hleu2(const __half2 a, const __half2 b);
 * \details Performs \p half2 vector greater-equal comparison of inputs \p a and \p b.
 * The corresponding \p half results are set to 1.0 for true, or 0.0 for false.
 * NaN inputs generate true results.
-* \param[in] a - half2. Is only being read. 
-* \param[in] b - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
 *
 * \returns half2
-* \retval The \p half2 vector result of unordered greater-equal comparison of vectors \p a and \p b.
+* - The \p half2 vector result of unordered greater-equal comparison of vectors \p a and \p b.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2059,11 +2149,11 @@ __CUDA_FP16_DECL__ __half2 __hgeu2(const __half2 a, const __half2 b);
 * \details Performs \p half2 vector less-than comparison of inputs \p a and \p b.
 * The corresponding \p half results are set to 1.0 for true, or 0.0 for false.
 * NaN inputs generate true results.
-* \param[in] a - half2. Is only being read. 
-* \param[in] b - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
 *
 * \returns half2
-* \retval The vector result of unordered less-than comparison of vectors \p a and \p b.
+* - The vector result of unordered less-than comparison of vectors \p a and \p b.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2077,11 +2167,11 @@ __CUDA_FP16_DECL__ __half2 __hltu2(const __half2 a, const __half2 b);
 * \details Performs \p half2 vector greater-than comparison of inputs \p a and \p b.
 * The corresponding \p half results are set to 1.0 for true, or 0.0 for false.
 * NaN inputs generate true results.
-* \param[in] a - half2. Is only being read. 
-* \param[in] b - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
 *
 * \returns half2
-* \retval The \p half2 vector result of unordered greater-than comparison of vectors \p a and \p b.
+* - The \p half2 vector result of unordered greater-than comparison of vectors \p a and \p b.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2093,11 +2183,11 @@ __CUDA_FP16_DECL__ __half2 __hgtu2(const __half2 a, const __half2 b);
 * \brief Determine whether \p half2 argument is a NaN.
 *
 * \details Determine whether each half of input \p half2 number \p a is a NaN.
-* \param[in] a - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
 *
 * \returns half2
-* \retval The half2 with the corresponding \p half results set to
-* 1.0 for NaN, 0.0 otherwise. 
+* - The half2 with the corresponding \p half results set to
+* 1.0 for NaN, 0.0 otherwise.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2113,11 +2203,11 @@ __CUDA_FP16_DECL__ __half2 __hisnan2(const __half2 a);
 * \internal
 * \req DEEPLEARN-SRM_REQ-95
 * \endinternal
-* \param[in] a - half2. Is only being read. 
-* \param[in] b - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
 *
 * \returns half2
-* \retval The sum of vectors \p a and \p b. 
+* - The sum of vectors \p a and \p b.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2133,11 +2223,11 @@ __CUDA_FP16_DECL__ __half2 __hadd2(const __half2 a, const __half2 b);
 * \internal
 * \req DEEPLEARN-SRM_REQ-104
 * \endinternal
-* \param[in] a - half2. Is only being read. 
-* \param[in] b - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
 *
 * \returns half2
-* \retval The subtraction of vector \p b from \p a. 
+* - The subtraction of vector \p b from \p a.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2153,11 +2243,11 @@ __CUDA_FP16_DECL__ __half2 __hsub2(const __half2 a, const __half2 b);
 * \internal
 * \req DEEPLEARN-SRM_REQ-102
 * \endinternal
-* \param[in] a - half2. Is only being read. 
-* \param[in] b - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
 *
 * \returns half2
-* \retval The result of elementwise multiplying the vectors \p a and \p b. 
+* - The result of elementwise multiplying the vectors \p a and \p b.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2166,6 +2256,68 @@ __CUDA_FP16_DECL__ __half2 __hsub2(const __half2 a, const __half2 b);
 __CUDA_FP16_DECL__ __half2 __hmul2(const __half2 a, const __half2 b);
 /**
 * \ingroup CUDA_MATH__HALF2_ARITHMETIC
+* \brief Performs \p half2 vector addition in round-to-nearest-even mode.
+*
+* \details Performs \p half2 vector add of inputs \p a and \p b, in round-to-nearest
+* mode. Prevents floating-point contractions of mul+add into fma.
+* \internal
+* \req DEEPLEARN-SRM_REQ-95
+* \endinternal
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
+*
+* \returns half2
+* - The sum of vectors \p a and \p b.
+* \internal
+* \exception-guarantee no-throw guarantee
+* \behavior reentrant, thread safe
+* \endinternal
+*/
+__CUDA_FP16_DECL__ __half2 __hadd2_rn(const __half2 a, const __half2 b);
+/**
+* \ingroup CUDA_MATH__HALF2_ARITHMETIC
+* \brief Performs \p half2 vector subtraction in round-to-nearest-even mode.
+*
+* \details Subtracts \p half2 input vector \p b from input vector \p a in
+* round-to-nearest-even mode. Prevents floating-point contractions of mul+sub
+* into fma.
+* \internal
+* \req DEEPLEARN-SRM_REQ-104
+* \endinternal
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
+*
+* \returns half2
+* - The subtraction of vector \p b from \p a.
+* \internal
+* \exception-guarantee no-throw guarantee
+* \behavior reentrant, thread safe
+* \endinternal
+*/
+__CUDA_FP16_DECL__ __half2 __hsub2_rn(const __half2 a, const __half2 b);
+/**
+* \ingroup CUDA_MATH__HALF2_ARITHMETIC
+* \brief Performs \p half2 vector multiplication in round-to-nearest-even mode.
+*
+* \details Performs \p half2 vector multiplication of inputs \p a and \p b, in
+* round-to-nearest-even mode. Prevents floating-point contractions of
+* mul+add or sub into fma.
+* \internal
+* \req DEEPLEARN-SRM_REQ-102
+* \endinternal
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
+*
+* \returns half2
+* - The result of elementwise multiplying the vectors \p a and \p b.
+* \internal
+* \exception-guarantee no-throw guarantee
+* \behavior reentrant, thread safe
+* \endinternal
+*/
+__CUDA_FP16_DECL__ __half2 __hmul2_rn(const __half2 a, const __half2 b);
+/**
+* \ingroup CUDA_MATH__HALF2_ARITHMETIC
 * \brief Performs \p half2 vector division in round-to-nearest-even mode.
 *
 * \details Divides \p half2 input vector \p a by input vector \p b in round-to-nearest
@@ -2173,11 +2325,11 @@ __CUDA_FP16_DECL__ __half2 __hmul2(const __half2 a, const __half2 b);
 * \internal
 * \req DEEPLEARN-SRM_REQ-103
 * \endinternal
-* \param[in] a - half2. Is only being read. 
-* \param[in] b - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
 *
 * \returns half2
-* \retval The elementwise division of \p a with \p b. 
+* - The elementwise division of \p a with \p b.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2191,10 +2343,10 @@ __CUDA_FP16_DECL__ __half2 __h2div(const __half2 a, const __half2 b);
 *
 * \details Calculates the absolute value of both halves of the input \p half2 number and
 * returns the result.
-* \param[in] a - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
 *
 * \returns half2
-* \retval Returns \p a with the absolute value of both halves. 
+* - Returns \p a with the absolute value of both halves.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2209,11 +2361,11 @@ __CUDA_FP16_DECL__ __half2 __habs2(const __half2 a);
 * \details Performs \p half2 vector add of inputs \p a and \p b, in round-to-nearest
 * mode, and clamps the results to range [0.0, 1.0]. NaN results are flushed to
 * +0.0.
-* \param[in] a - half2. Is only being read. 
-* \param[in] b - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
 *
 * \returns half2
-* \retval The sum of \p a and \p b, with respect to saturation. 
+* - The sum of \p a and \p b, with respect to saturation.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2228,11 +2380,11 @@ __CUDA_FP16_DECL__ __half2 __hadd2_sat(const __half2 a, const __half2 b);
 * \details Subtracts \p half2 input vector \p b from input vector \p a in
 * round-to-nearest-even mode, and clamps the results to range [0.0, 1.0]. NaN
 * results are flushed to +0.0.
-* \param[in] a - half2. Is only being read. 
-* \param[in] b - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
 *
 * \returns half2
-* \retval The subtraction of vector \p b from \p a, with respect to saturation.
+* - The subtraction of vector \p b from \p a, with respect to saturation.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2247,12 +2399,12 @@ __CUDA_FP16_DECL__ __half2 __hsub2_sat(const __half2 a, const __half2 b);
 * \details Performs \p half2 vector multiplication of inputs \p a and \p b, in
 * round-to-nearest-even mode, and clamps the results to range [0.0, 1.0]. NaN
 * results are flushed to +0.0.
-* \param[in] a - half2. Is only being read. 
-* \param[in] b - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
 *
 * \returns half2
-* \retval The result of elementwise multiplication of vectors \p a and \p b, 
-* with respect to saturation. 
+* - The result of elementwise multiplication of vectors \p a and \p b,
+* with respect to saturation.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2270,12 +2422,12 @@ __CUDA_FP16_DECL__ __half2 __hmul2_sat(const __half2 a, const __half2 b);
 * \internal
 * \req DEEPLEARN-SRM_REQ-105
 * \endinternal
-* \param[in] a - half2. Is only being read. 
-* \param[in] b - half2. Is only being read. 
-* \param[in] c - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
+* \param[in] c - half2. Is only being read.
 *
 * \returns half2
-* \retval The result of elementwise fused multiply-add operation on vectors \p a, \p b, and \p c. 
+* - The result of elementwise fused multiply-add operation on vectors \p a, \p b, and \p c.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2291,13 +2443,13 @@ __CUDA_FP16_DECL__ __half2 __hfma2(const __half2 a, const __half2 b, const __hal
 * then performs a \p half2 vector add of the result with \p c,
 * rounding the result once in round-to-nearest-even mode, and clamps the
 * results to range [0.0, 1.0]. NaN results are flushed to +0.0.
-* \param[in] a - half2. Is only being read. 
-* \param[in] b - half2. Is only being read. 
-* \param[in] c - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
+* \param[in] c - half2. Is only being read.
 *
 * \returns half2
-* \retval The result of elementwise fused multiply-add operation on vectors \p a, \p b, and \p c, 
-* with respect to saturation. 
+* - The result of elementwise fused multiply-add operation on vectors \p a, \p b, and \p c,
+* with respect to saturation.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2313,10 +2465,10 @@ __CUDA_FP16_DECL__ __half2 __hfma2_sat(const __half2 a, const __half2 b, const _
 * \internal
 * \req DEEPLEARN-SRM_REQ-101
 * \endinternal
-* \param[in] a - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
 *
 * \returns half2
-* \retval Returns \p a with both halves negated. 
+* - Returns \p a with both halves negated.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2328,10 +2480,10 @@ __CUDA_FP16_DECL__ __half2 __hneg2(const __half2 a);
 * \brief Calculates the absolute value of input \p half number and returns the result.
 *
 * \details Calculates the absolute value of input \p half number and returns the result.
-* \param[in] a - half. Is only being read. 
+* \param[in] a - half. Is only being read.
 *
 * \returns half
-* \retval The absolute value of a.
+* - The absolute value of \p a.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2347,11 +2499,11 @@ __CUDA_FP16_DECL__ __half __habs(const __half a);
 * \internal
 * \req DEEPLEARN-SRM_REQ-94
 * \endinternal
-* \param[in] a - half. Is only being read. 
-* \param[in] b - half. Is only being read. 
+* \param[in] a - half. Is only being read.
+* \param[in] b - half. Is only being read.
 *
 * \returns half
-* \retval The sum of \p a and \p b. 
+* - The sum of \p a and \p b.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2367,11 +2519,11 @@ __CUDA_FP16_DECL__ __half __hadd(const __half a, const __half b);
 * \internal
 * \req DEEPLEARN-SRM_REQ-97
 * \endinternal
-* \param[in] a - half. Is only being read. 
-* \param[in] b - half. Is only being read. 
+* \param[in] a - half. Is only being read.
+* \param[in] b - half. Is only being read.
 *
 * \returns half
-* \retval The result of subtracting \p b from \p a. 
+* - The result of subtracting \p b from \p a.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2387,27 +2539,83 @@ __CUDA_FP16_DECL__ __half __hsub(const __half a, const __half b);
 * \internal
 * \req DEEPLEARN-SRM_REQ-99
 * \endinternal
-* \param[in] a - half. Is only being read. 
-* \param[in] b - half. Is only being read. 
+* \param[in] a - half. Is only being read.
+* \param[in] b - half. Is only being read.
 *
 * \returns half
-* \retval The result of multiplying \p a and \p b. 
+* - The result of multiplying \p a and \p b.
 */
 __CUDA_FP16_DECL__ __half __hmul(const __half a, const __half b);
 /**
 * \ingroup CUDA_MATH__HALF_ARITHMETIC
+* \brief Performs \p half addition in round-to-nearest-even mode.
+*
+* \details Performs \p half addition of inputs \p a and \p b, in round-to-nearest-even
+* mode. Prevents floating-point contractions of mul+add into fma.
+* \internal
+* \req DEEPLEARN-SRM_REQ-94
+* \endinternal
+* \param[in] a - half. Is only being read.
+* \param[in] b - half. Is only being read.
+*
+* \returns half
+* - The sum of \p a and \p b.
+* \internal
+* \exception-guarantee no-throw guarantee
+* \behavior reentrant, thread safe
+* \endinternal
+*/
+__CUDA_FP16_DECL__ __half __hadd_rn(const __half a, const __half b);
+/**
+* \ingroup CUDA_MATH__HALF_ARITHMETIC
+* \brief Performs \p half subtraction in round-to-nearest-even mode.
+*
+* \details Subtracts \p half input \p b from input \p a in round-to-nearest
+* mode. Prevents floating-point contractions of mul+sub into fma.
+* \internal
+* \req DEEPLEARN-SRM_REQ-97
+* \endinternal
+* \param[in] a - half. Is only being read.
+* \param[in] b - half. Is only being read.
+*
+* \returns half
+* - The result of subtracting \p b from \p a.
+* \internal
+* \exception-guarantee no-throw guarantee
+* \behavior reentrant, thread safe
+* \endinternal
+*/
+__CUDA_FP16_DECL__ __half __hsub_rn(const __half a, const __half b);
+/**
+* \ingroup CUDA_MATH__HALF_ARITHMETIC
+* \brief Performs \p half multiplication in round-to-nearest-even mode.
+*
+* \details Performs \p half multiplication of inputs \p a and \p b, in round-to-nearest
+* mode. Prevents floating-point contractions of mul+add or sub into fma.
+* \internal
+* \req DEEPLEARN-SRM_REQ-99
+* \endinternal
+* \param[in] a - half. Is only being read.
+* \param[in] b - half. Is only being read.
+*
+* \returns half
+* - The result of multiplying \p a and \p b.
+*/
+__CUDA_FP16_DECL__ __half __hmul_rn(const __half a, const __half b);
+/**
+* \ingroup CUDA_MATH__HALF_ARITHMETIC
 * \brief Performs \p half division in round-to-nearest-even mode.
-* 
+*
 * \details Divides \p half input \p a by input \p b in round-to-nearest
 * mode.
 * \internal
 * \req DEEPLEARN-SRM_REQ-98
 * \endinternal
-* \param[in] a - half. Is only being read. 
-* \param[in] b - half. Is only being read. 
-* 
+* \param[in] a - half. Is only being read.
+* \param[in] b - half. Is only being read.
+*
 * \returns half
-* \retval The result of dividing \p a by \p b. 
+* - The result of dividing \p a by \p b.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2421,11 +2629,11 @@ __CUDA_FP16_DECL__  __half __hdiv(const __half a, const __half b);
 *
 * \details Performs \p half add of inputs \p a and \p b, in round-to-nearest-even mode,
 * and clamps the result to range [0.0, 1.0]. NaN results are flushed to +0.0.
-* \param[in] a - half. Is only being read. 
-* \param[in] b - half. Is only being read. 
+* \param[in] a - half. Is only being read.
+* \param[in] b - half. Is only being read.
 *
 * \returns half
-* \retval The sum of \p a and \p b, with respect to saturation.
+* - The sum of \p a and \p b, with respect to saturation.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2440,11 +2648,11 @@ __CUDA_FP16_DECL__ __half __hadd_sat(const __half a, const __half b);
 * \details Subtracts \p half input \p b from input \p a in round-to-nearest
 * mode,
 * and clamps the result to range [0.0, 1.0]. NaN results are flushed to +0.0.
-* \param[in] a - half. Is only being read. 
-* \param[in] b - half. Is only being read. 
+* \param[in] a - half. Is only being read.
+* \param[in] b - half. Is only being read.
 *
 * \returns half
-* \retval The result of subtraction of \p b from \p a, with respect to saturation.
+* - The result of subtraction of \p b from \p a, with respect to saturation.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2459,11 +2667,11 @@ __CUDA_FP16_DECL__ __half __hsub_sat(const __half a, const __half b);
 * \details Performs \p half multiplication of inputs \p a and \p b, in round-to-nearest
 * mode, and clamps the result to range [0.0, 1.0]. NaN results are flushed to
 * +0.0.
-* \param[in] a - half. Is only being read. 
-* \param[in] b - half. Is only being read. 
+* \param[in] a - half. Is only being read.
+* \param[in] b - half. Is only being read.
 *
 * \returns half
-* \retval The result of multiplying \p a and \p b, with respect to saturation.
+* - The result of multiplying \p a and \p b, with respect to saturation.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2480,13 +2688,13 @@ __CUDA_FP16_DECL__ __half __hmul_sat(const __half a, const __half b);
 * \internal
 * \req DEEPLEARN-SRM_REQ-96
 * \endinternal
-* \param[in] a - half. Is only being read. 
-* \param[in] b - half. Is only being read. 
-* \param[in] c - half. Is only being read. 
+* \param[in] a - half. Is only being read.
+* \param[in] b - half. Is only being read.
+* \param[in] c - half. Is only being read.
 *
 * \returns half
-* \retval The result of fused multiply-add operation on \p
-* a, \p b, and \p c. 
+* - The result of fused multiply-add operation on \p
+* a, \p b, and \p c.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2502,13 +2710,13 @@ __CUDA_FP16_DECL__ __half __hfma(const __half a, const __half b, const __half c)
 * then performs a \p half add of the result with \p c,
 * rounding the result once in round-to-nearest-even mode, and clamps the result
 * to range [0.0, 1.0]. NaN results are flushed to +0.0.
-* \param[in] a - half. Is only being read. 
-* \param[in] b - half. Is only being read. 
-* \param[in] c - half. Is only being read. 
+* \param[in] a - half. Is only being read.
+* \param[in] b - half. Is only being read.
+* \param[in] c - half. Is only being read.
 *
 * \returns half
-* \retval The result of fused multiply-add operation on \p
-* a, \p b, and \p c, with respect to saturation. 
+* - The result of fused multiply-add operation on \p
+* a, \p b, and \p c, with respect to saturation.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2523,10 +2731,10 @@ __CUDA_FP16_DECL__ __half __hfma_sat(const __half a, const __half b, const __hal
 * \internal
 * \req DEEPLEARN-SRM_REQ-100
 * \endinternal
-* \param[in] a - half. Is only being read. 
+* \param[in] a - half. Is only being read.
 *
 * \returns half
-* \retval minus a
+* - minus a
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2542,13 +2750,13 @@ __CUDA_FP16_DECL__ __half __hneg(const __half a);
 * The bool result is set to true only if both \p half if-equal comparisons
 * evaluate to true, or false otherwise.
 * NaN inputs generate false results.
-* \param[in] a - half2. Is only being read. 
-* \param[in] b - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
 *
 * \returns bool
-* \retval true if both \p half results of if-equal comparison
+* - true if both \p half results of if-equal comparison
 * of vectors \p a and \p b are true;
-* \retval false otherwise.
+* - false otherwise.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2564,13 +2772,13 @@ __CUDA_FP16_DECL__ bool __hbeq2(const __half2 a, const __half2 b);
 * The bool result is set to true only if both \p half not-equal comparisons
 * evaluate to true, or false otherwise.
 * NaN inputs generate false results.
-* \param[in] a - half2. Is only being read. 
-* \param[in] b - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
 *
 * \returns bool
-* \retval true if both \p half results of not-equal comparison
-* of vectors \p a and \p b are true, 
-* \retval false otherwise. 
+* - true if both \p half results of not-equal comparison
+* of vectors \p a and \p b are true,
+* - false otherwise.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2586,13 +2794,13 @@ __CUDA_FP16_DECL__ bool __hbne2(const __half2 a, const __half2 b);
 * The bool result is set to true only if both \p half less-equal comparisons
 * evaluate to true, or false otherwise.
 * NaN inputs generate false results.
-* \param[in] a - half2. Is only being read. 
-* \param[in] b - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
 *
 * \returns bool
-* \retval true if both \p half results of less-equal comparison
-* of vectors \p a and \p b are true; 
-* \retval false otherwise. 
+* - true if both \p half results of less-equal comparison
+* of vectors \p a and \p b are true;
+* - false otherwise.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2608,13 +2816,13 @@ __CUDA_FP16_DECL__ bool __hble2(const __half2 a, const __half2 b);
 * The bool result is set to true only if both \p half greater-equal comparisons
 * evaluate to true, or false otherwise.
 * NaN inputs generate false results.
-* \param[in] a - half2. Is only being read. 
-* \param[in] b - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
 *
 * \returns bool
-* \retval true if both \p half results of greater-equal
-* comparison of vectors \p a and \p b are true; 
-* \retval false otherwise. 
+* - true if both \p half results of greater-equal
+* comparison of vectors \p a and \p b are true;
+* - false otherwise.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2630,13 +2838,13 @@ __CUDA_FP16_DECL__ bool __hbge2(const __half2 a, const __half2 b);
 * The bool result is set to true only if both \p half less-than comparisons
 * evaluate to true, or false otherwise.
 * NaN inputs generate false results.
-* \param[in] a - half2. Is only being read. 
-* \param[in] b - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
 *
 * \returns bool
-* \retval true if both \p half results of less-than comparison
-* of vectors \p a and \p b are true; 
-* \retval false otherwise. 
+* - true if both \p half results of less-than comparison
+* of vectors \p a and \p b are true;
+* - false otherwise.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2652,13 +2860,13 @@ __CUDA_FP16_DECL__ bool __hblt2(const __half2 a, const __half2 b);
 * The bool result is set to true only if both \p half greater-than comparisons
 * evaluate to true, or false otherwise.
 * NaN inputs generate false results.
-* \param[in] a - half2. Is only being read. 
-* \param[in] b - half2. Is only being read. 
-* 
-* \returns bool 
-* \retval true if both \p half results of greater-than
-* comparison of vectors \p a and \p b are true; 
-* \retval false otherwise. 
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
+*
+* \returns bool
+* - true if both \p half results of greater-than
+* comparison of vectors \p a and \p b are true;
+* - false otherwise.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2674,13 +2882,13 @@ __CUDA_FP16_DECL__ bool __hbgt2(const __half2 a, const __half2 b);
 * The bool result is set to true only if both \p half if-equal comparisons
 * evaluate to true, or false otherwise.
 * NaN inputs generate true results.
-* \param[in] a - half2. Is only being read. 
-* \param[in] b - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
 *
 * \returns bool
-* \retval true if both \p half results of unordered if-equal
-* comparison of vectors \p a and \p b are true; 
-* \retval false otherwise. 
+* - true if both \p half results of unordered if-equal
+* comparison of vectors \p a and \p b are true;
+* - false otherwise.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2696,13 +2904,13 @@ __CUDA_FP16_DECL__ bool __hbequ2(const __half2 a, const __half2 b);
 * The bool result is set to true only if both \p half not-equal comparisons
 * evaluate to true, or false otherwise.
 * NaN inputs generate true results.
-* \param[in] a - half2. Is only being read. 
-* \param[in] b - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
 *
 * \returns bool
-* \retval true if both \p half results of unordered not-equal
+* - true if both \p half results of unordered not-equal
 * comparison of vectors \p a and \p b are true;
-* \retval false otherwise. 
+* - false otherwise.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2718,13 +2926,13 @@ __CUDA_FP16_DECL__ bool __hbneu2(const __half2 a, const __half2 b);
 * The bool result is set to true only if both \p half less-equal comparisons
 * evaluate to true, or false otherwise.
 * NaN inputs generate true results.
-* \param[in] a - half2. Is only being read. 
-* \param[in] b - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
 *
 * \returns bool
-* \retval true if both \p half results of unordered less-equal
-* comparison of vectors \p a and \p b are true; 
-* \retval false otherwise. 
+* - true if both \p half results of unordered less-equal
+* comparison of vectors \p a and \p b are true;
+* - false otherwise.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2741,13 +2949,13 @@ __CUDA_FP16_DECL__ bool __hbleu2(const __half2 a, const __half2 b);
 * The bool result is set to true only if both \p half greater-equal comparisons
 * evaluate to true, or false otherwise.
 * NaN inputs generate true results.
-* \param[in] a - half2. Is only being read. 
-* \param[in] b - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
 *
 * \returns bool
-* \retval true if both \p half results of unordered
-* greater-equal comparison of vectors \p a and \p b are true; 
-* \retval false otherwise. 
+* - true if both \p half results of unordered
+* greater-equal comparison of vectors \p a and \p b are true;
+* - false otherwise.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2763,13 +2971,13 @@ __CUDA_FP16_DECL__ bool __hbgeu2(const __half2 a, const __half2 b);
 * The bool result is set to true only if both \p half less-than comparisons
 * evaluate to true, or false otherwise.
 * NaN inputs generate true results.
-* \param[in] a - half2. Is only being read. 
-* \param[in] b - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
 *
 * \returns bool
-* \retval true if both \p half results of unordered less-than comparison of 
-* vectors \p a and \p b are true; 
-* \retval false otherwise. 
+* - true if both \p half results of unordered less-than comparison of
+* vectors \p a and \p b are true;
+* - false otherwise.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2786,13 +2994,13 @@ __CUDA_FP16_DECL__ bool __hbltu2(const __half2 a, const __half2 b);
 * The bool result is set to true only if both \p half greater-than comparisons
 * evaluate to true, or false otherwise.
 * NaN inputs generate true results.
-* \param[in] a - half2. Is only being read. 
-* \param[in] b - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
+* \param[in] b - half2. Is only being read.
 *
 * \returns bool
-* \retval true if both \p half results of unordered
+* - true if both \p half results of unordered
 * greater-than comparison of vectors \p a and \p b are true;
-* \retval false otherwise. 
+* - false otherwise.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2805,11 +3013,11 @@ __CUDA_FP16_DECL__ bool __hbgtu2(const __half2 a, const __half2 b);
 *
 * \details Performs \p half if-equal comparison of inputs \p a and \p b.
 * NaN inputs generate false results.
-* \param[in] a - half. Is only being read. 
-* \param[in] b - half. Is only being read. 
+* \param[in] a - half. Is only being read.
+* \param[in] b - half. Is only being read.
 *
 * \returns bool
-* \retval The boolean result of if-equal comparison of \p a and \p b. 
+* - The boolean result of if-equal comparison of \p a and \p b.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2822,11 +3030,11 @@ __CUDA_FP16_DECL__ bool __heq(const __half a, const __half b);
 *
 * \details Performs \p half not-equal comparison of inputs \p a and \p b.
 * NaN inputs generate false results.
-* \param[in] a - half. Is only being read. 
-* \param[in] b - half. Is only being read. 
+* \param[in] a - half. Is only being read.
+* \param[in] b - half. Is only being read.
 *
 * \returns bool
-* \retval The boolean result of not-equal comparison of \p a and \p b.
+* - The boolean result of not-equal comparison of \p a and \p b.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2839,11 +3047,11 @@ __CUDA_FP16_DECL__ bool __hne(const __half a, const __half b);
 *
 * \details Performs \p half less-equal comparison of inputs \p a and \p b.
 * NaN inputs generate false results.
-* \param[in] a - half. Is only being read. 
-* \param[in] b - half. Is only being read. 
+* \param[in] a - half. Is only being read.
+* \param[in] b - half. Is only being read.
 *
 * \returns bool
-* \retval The boolean result of less-equal comparison of \p a and \p b.
+* - The boolean result of less-equal comparison of \p a and \p b.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2856,11 +3064,11 @@ __CUDA_FP16_DECL__ bool __hle(const __half a, const __half b);
 *
 * \details Performs \p half greater-equal comparison of inputs \p a and \p b.
 * NaN inputs generate false results.
-* \param[in] a - half. Is only being read. 
-* \param[in] b - half. Is only being read. 
+* \param[in] a - half. Is only being read.
+* \param[in] b - half. Is only being read.
 *
 * \returns bool
-* \retval The boolean result of greater-equal comparison of \p a and \p b.
+* - The boolean result of greater-equal comparison of \p a and \p b.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2873,11 +3081,11 @@ __CUDA_FP16_DECL__ bool __hge(const __half a, const __half b);
 *
 * \details Performs \p half less-than comparison of inputs \p a and \p b.
 * NaN inputs generate false results.
-* \param[in] a - half. Is only being read. 
-* \param[in] b - half. Is only being read. 
+* \param[in] a - half. Is only being read.
+* \param[in] b - half. Is only being read.
 *
 * \returns bool
-* \retval The boolean result of less-than comparison of \p a and \p b.
+* - The boolean result of less-than comparison of \p a and \p b.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2890,11 +3098,11 @@ __CUDA_FP16_DECL__ bool __hlt(const __half a, const __half b);
 *
 * \details Performs \p half greater-than comparison of inputs \p a and \p b.
 * NaN inputs generate false results.
-* \param[in] a - half. Is only being read. 
-* \param[in] b - half. Is only being read. 
+* \param[in] a - half. Is only being read.
+* \param[in] b - half. Is only being read.
 *
 * \returns bool
-* \retval The boolean result of greater-than comparison of \p a and \p b.
+* - The boolean result of greater-than comparison of \p a and \p b.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -2907,11 +3115,11 @@ __CUDA_FP16_DECL__ bool __hgt(const __half a, const __half b);
 *
 * \details Performs \p half if-equal comparison of inputs \p a and \p b.
 * NaN inputs generate true results.
-* \param[in] a - half. Is only being read. 
-* \param[in] b - half. Is only being read. 
+* \param[in] a - half. Is only being read.
+* \param[in] b - half. Is only being read.
 *
 * \returns bool
-* \retval The boolean result of unordered if-equal comparison of \p a and
+* - The boolean result of unordered if-equal comparison of \p a and
 * \p b.
 * \internal
 * \exception-guarantee no-throw guarantee
@@ -2925,11 +3133,11 @@ __CUDA_FP16_DECL__ bool __hequ(const __half a, const __half b);
 *
 * \details Performs \p half not-equal comparison of inputs \p a and \p b.
 * NaN inputs generate true results.
-* \param[in] a - half. Is only being read. 
-* \param[in] b - half. Is only being read. 
+* \param[in] a - half. Is only being read.
+* \param[in] b - half. Is only being read.
 *
 * \returns bool
-* \retval The boolean result of unordered not-equal comparison of \p a and
+* - The boolean result of unordered not-equal comparison of \p a and
 * \p b.
 * \internal
 * \exception-guarantee no-throw guarantee
@@ -2943,11 +3151,11 @@ __CUDA_FP16_DECL__ bool __hneu(const __half a, const __half b);
 *
 * \details Performs \p half less-equal comparison of inputs \p a and \p b.
 * NaN inputs generate true results.
-* \param[in] a - half. Is only being read. 
-* \param[in] b - half. Is only being read. 
+* \param[in] a - half. Is only being read.
+* \param[in] b - half. Is only being read.
 *
 * \returns bool
-* \retval The boolean result of unordered less-equal comparison of \p a and
+* - The boolean result of unordered less-equal comparison of \p a and
 * \p b.
 * \internal
 * \exception-guarantee no-throw guarantee
@@ -2961,11 +3169,11 @@ __CUDA_FP16_DECL__ bool __hleu(const __half a, const __half b);
 *
 * \details Performs \p half greater-equal comparison of inputs \p a and \p b.
 * NaN inputs generate true results.
-* \param[in] a - half. Is only being read. 
-* \param[in] b - half. Is only being read. 
+* \param[in] a - half. Is only being read.
+* \param[in] b - half. Is only being read.
 *
 * \returns bool
-* \retval The boolean result of unordered greater-equal comparison of \p a
+* - The boolean result of unordered greater-equal comparison of \p a
 * and \p b.
 * \internal
 * \exception-guarantee no-throw guarantee
@@ -2979,11 +3187,11 @@ __CUDA_FP16_DECL__ bool __hgeu(const __half a, const __half b);
 *
 * \details Performs \p half less-than comparison of inputs \p a and \p b.
 * NaN inputs generate true results.
-* \param[in] a - half. Is only being read. 
-* \param[in] b - half. Is only being read. 
+* \param[in] a - half. Is only being read.
+* \param[in] b - half. Is only being read.
 *
 * \returns bool
-* \retval The boolean result of unordered less-than comparison of \p a and
+* - The boolean result of unordered less-than comparison of \p a and
 * \p b.
 * \internal
 * \exception-guarantee no-throw guarantee
@@ -2997,11 +3205,11 @@ __CUDA_FP16_DECL__ bool __hltu(const __half a, const __half b);
 *
 * \details Performs \p half greater-than comparison of inputs \p a and \p b.
 * NaN inputs generate true results.
-* \param[in] a - half. Is only being read. 
-* \param[in] b - half. Is only being read. 
+* \param[in] a - half. Is only being read.
+* \param[in] b - half. Is only being read.
 *
 * \returns bool
-* \retval The boolean result of unordered greater-than comparison of \p a
+* - The boolean result of unordered greater-than comparison of \p a
 * and \p b.
 * \internal
 * \exception-guarantee no-throw guarantee
@@ -3014,55 +3222,17 @@ __CUDA_FP16_DECL__ bool __hgtu(const __half a, const __half b);
 * \brief Determine whether \p half argument is a NaN.
 *
 * \details Determine whether \p half value \p a is a NaN.
-* \param[in] a - half. Is only being read. 
+* \param[in] a - half. Is only being read.
 *
 * \returns bool
-* \retval true iff argument is NaN. 
+* - true iff argument is NaN.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
 * \endinternal
 */
 __CUDA_FP16_DECL__ bool __hisnan(const __half a);
-#if __CUDA_ARCH__ >= 800 || !defined(__CUDA_ARCH__)
-/**
-* \ingroup CUDA_MATH__HALF_COMPARISON
-* \brief Calculates \p half maximum of two input values.
-*
-* \details Calculates \p half max(\p a, \p b)
-* defined as (\p a > \p b) ? \p a : \p b.
-* - If either of inputs is NaN, the other input is returned.
-* - If both inputs are NaNs, then canonical NaN is returned.
-* - If values of both inputs are 0.0, then +0.0 > -0.0
-* \param[in] a - half. Is only being read.
-* \param[in] b - half. Is only being read.
-*
-* \returns half
-* \internal
-* \exception-guarantee no-throw guarantee
-* \behavior reentrant, thread safe
-* \endinternal
-*/
-__CUDA_FP16_DECL__ __half __hmax(const __half a, const __half b);
-/**
-* \ingroup CUDA_MATH__HALF_COMPARISON
-* \brief Calculates \p half minimum of two input values.
-*
-* \details Calculates \p half min(\p a, \p b)
-* defined as (\p a < \p b) ? \p a : \p b.
-* - If either of inputs is NaN, the other input is returned.
-* - If both inputs are NaNs, then canonical NaN is returned.
-* - If values of both inputs are 0.0, then +0.0 > -0.0
-* \param[in] a - half. Is only being read.
-* \param[in] b - half. Is only being read.
-*
-* \returns half
-* \internal
-* \exception-guarantee no-throw guarantee
-* \behavior reentrant, thread safe
-* \endinternal
-*/
-__CUDA_FP16_DECL__ __half __hmin(const __half a, const __half b);
+#if !defined(__CUDA_ARCH__) || (__CUDA_ARCH__ >= 800)
 /**
 * \ingroup CUDA_MATH__HALF_COMPARISON
 * \brief Calculates \p half maximum of two input values, NaNs pass through.
@@ -3113,7 +3283,7 @@ __CUDA_FP16_DECL__ __half __hmin_nan(const __half a, const __half b);
 * \param[in] c - half. Is only being read.
 *
 * \returns half
-* \retval The result of fused multiply-add operation on \p
+* - The result of fused multiply-add operation on \p
 * a, \p b, and \p c with relu saturation.
 * \internal
 * \exception-guarantee no-throw guarantee
@@ -3123,48 +3293,6 @@ __CUDA_FP16_DECL__ __half __hmin_nan(const __half a, const __half b);
 __CUDA_FP16_DECL__ __half __hfma_relu(const __half a, const __half b, const __half c);
 /**
 * \ingroup CUDA_MATH__HALF2_COMPARISON
-* \brief Calculates \p half2 vector maximum of two inputs.
-*
-* \details Calculates \p half2 vector max(\p a, \p b).
-* Elementwise \p half operation is defined as
-* (\p a > \p b) ? \p a : \p b.
-* - If either of inputs is NaN, the other input is returned.
-* - If both inputs are NaNs, then canonical NaN is returned.
-* - If values of both inputs are 0.0, then +0.0 > -0.0
-* \param[in] a - half2. Is only being read.
-* \param[in] b - half2. Is only being read.
-*
-* \returns half2
-* \retval The result of elementwise maximum of vectors \p a  and \p b
-* \internal
-* \exception-guarantee no-throw guarantee
-* \behavior reentrant, thread safe
-* \endinternal
-*/
-__CUDA_FP16_DECL__ __half2 __hmax2(const __half2 a, const __half2 b);
-/**
-* \ingroup CUDA_MATH__HALF2_COMPARISON
-* \brief Calculates \p half2 vector minimum of two inputs.
-*
-* \details Calculates \p half2 vector min(\p a, \p b).
-* Elementwise \p half operation is defined as
-* (\p a < \p b) ? \p a : \p b.
-* - If either of inputs is NaN, the other input is returned.
-* - If both inputs are NaNs, then canonical NaN is returned.
-* - If values of both inputs are 0.0, then +0.0 > -0.0
-* \param[in] a - half2. Is only being read.
-* \param[in] b - half2. Is only being read.
-*
-* \returns half2
-* \retval The result of elementwise minimum of vectors \p a  and \p b
-* \internal
-* \exception-guarantee no-throw guarantee
-* \behavior reentrant, thread safe
-* \endinternal
-*/
-__CUDA_FP16_DECL__ __half2 __hmin2(const __half2 a, const __half2 b);
-/**
-* \ingroup CUDA_MATH__HALF2_COMPARISON
 * \brief Calculates \p half2 vector maximum of two inputs, NaNs pass through.
 *
 * \details Calculates \p half2 vector max(\p a, \p b).
@@ -3176,7 +3304,7 @@ __CUDA_FP16_DECL__ __half2 __hmin2(const __half2 a, const __half2 b);
 * \param[in] b - half2. Is only being read.
 *
 * \returns half2
-* \retval The result of elementwise maximum of vectors \p a  and \p b, with NaNs pass through
+* - The result of elementwise maximum of vectors \p a  and \p b, with NaNs pass through
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -3196,7 +3324,7 @@ __CUDA_FP16_DECL__ __half2 __hmax2_nan(const __half2 a, const __half2 b);
 * \param[in] b - half2. Is only being read.
 *
 * \returns half2
-* \retval The result of elementwise minimum of vectors \p a  and \p b, with NaNs pass through
+* - The result of elementwise minimum of vectors \p a  and \p b, with NaNs pass through
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -3218,14 +3346,14 @@ __CUDA_FP16_DECL__ __half2 __hmin2_nan(const __half2 a, const __half2 b);
 * \param[in] c - half2. Is only being read.
 *
 * \returns half2
-* \retval The result of elementwise fused multiply-add operation on vectors \p a, \p b, and \p c with relu saturation.
+* - The result of elementwise fused multiply-add operation on vectors \p a, \p b, and \p c with relu saturation.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
 * \endinternal
 */
 __CUDA_FP16_DECL__ __half2 __hfma2_relu(const __half2 a, const __half2 b, const __half2 c);
-#endif /*__CUDA_ARCH__ >= 800 || !defined(__CUDA_ARCH__)*/
+#endif /* !defined(__CUDA_ARCH__) || (__CUDA_ARCH__ >= 800) */
 /**
 * \ingroup CUDA_MATH__HALF2_ARITHMETIC
 * \brief Performs fast complex multiply-accumulate
@@ -3238,7 +3366,7 @@ __CUDA_FP16_DECL__ __half2 __hfma2_relu(const __half2 a, const __half2 b, const
 * \param[in] c - half2. Is only being read.
 *
 * \returns half2
-* \retval The result of complex multiply-accumulate operation on complex numbers \p a, \p b, and \p c
+* - The result of complex multiply-accumulate operation on complex numbers \p a, \p b, and \p c
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -3250,10 +3378,10 @@ __CUDA_FP16_DECL__ __half2 __hcmadd(const __half2 a, const __half2 b, const __ha
 * \brief Calculates \p half square root in round-to-nearest-even mode.
 *
 * \details Calculates \p half square root of input \p a in round-to-nearest-even mode.
-* \param[in] a - half. Is only being read. 
+* \param[in] a - half. Is only being read.
 *
 * \returns half
-* \retval The square root of \p a.
+* - The square root of \p a.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -3267,10 +3395,10 @@ __CUDA_FP16_DECL__ __half hsqrt(const __half a);
 *
 * \details Calculates \p half reciprocal square root of input \p a in round-to-nearest
 * mode.
-* \param[in] a - half. Is only being read. 
+* \param[in] a - half. Is only being read.
 *
 * \returns half
-* \retval The reciprocal square root of \p a.
+* - The reciprocal square root of \p a.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -3282,10 +3410,10 @@ __CUDA_FP16_DECL__ __half hrsqrt(const __half a);
 * \brief Calculates \p half reciprocal in round-to-nearest-even mode.
 *
 * \details Calculates \p half reciprocal of input \p a in round-to-nearest-even mode.
-* \param[in] a - half. Is only being read. 
+* \param[in] a - half. Is only being read.
 *
 * \returns half
-* \retval The reciprocal of \p a.
+* - The reciprocal of \p a.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -3298,10 +3426,10 @@ __CUDA_FP16_DECL__ __half hrcp(const __half a);
 *
 * \details Calculates \p half natural logarithm of input \p a in round-to-nearest-even
 * mode.
-* \param[in] a - half. Is only being read. 
+* \param[in] a - half. Is only being read.
 *
 * \returns half
-* \retval The natural logarithm of \p a.
+* - The natural logarithm of \p a.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -3314,10 +3442,10 @@ __CUDA_FP16_DECL__ __half hlog(const __half a);
 *
 * \details Calculates \p half binary logarithm of input \p a in round-to-nearest-even
 * mode.
-* \param[in] a - half. Is only being read. 
+* \param[in] a - half. Is only being read.
 *
 * \returns half
-* \retval The binary logarithm of \p a.
+* - The binary logarithm of \p a.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -3330,10 +3458,10 @@ __CUDA_FP16_DECL__ __half hlog2(const __half a);
 *
 * \details Calculates \p half decimal logarithm of input \p a in round-to-nearest-even
 * mode.
-* \param[in] a - half. Is only being read. 
+* \param[in] a - half. Is only being read.
 *
 * \returns half
-* \retval The decimal logarithm of \p a.
+* - The decimal logarithm of \p a.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -3347,10 +3475,10 @@ __CUDA_FP16_DECL__ __half hlog10(const __half a);
 *
 * \details Calculates \p half natural exponential function of input \p a in
 * round-to-nearest-even mode.
-* \param[in] a - half. Is only being read. 
+* \param[in] a - half. Is only being read.
 *
 * \returns half
-* \retval The natural exponential function on \p a.
+* - The natural exponential function on \p a.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -3364,10 +3492,10 @@ __CUDA_FP16_DECL__ __half hexp(const __half a);
 *
 * \details Calculates \p half binary exponential function of input \p a in
 * round-to-nearest-even mode.
-* \param[in] a - half. Is only being read. 
+* \param[in] a - half. Is only being read.
 *
 * \returns half
-* \retval The binary exponential function on \p a.
+* - The binary exponential function on \p a.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -3381,10 +3509,10 @@ __CUDA_FP16_DECL__ __half hexp2(const __half a);
 *
 * \details Calculates \p half decimal exponential function of input \p a in
 * round-to-nearest-even mode.
-* \param[in] a - half. Is only being read. 
+* \param[in] a - half. Is only being read.
 *
 * \returns half
-* \retval The decimal exponential function on \p a.
+* - The decimal exponential function on \p a.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -3396,10 +3524,10 @@ __CUDA_FP16_DECL__ __half hexp10(const __half a);
 * \brief Calculates \p half cosine in round-to-nearest-even mode.
 *
 * \details Calculates \p half cosine of input \p a in round-to-nearest-even mode.
-* \param[in] a - half. Is only being read. 
+* \param[in] a - half. Is only being read.
 *
 * \returns half
-* \retval The cosine of \p a.
+* - The cosine of \p a.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -3411,10 +3539,10 @@ __CUDA_FP16_DECL__ __half hcos(const __half a);
 * \brief Calculates \p half sine in round-to-nearest-even mode.
 *
 * \details Calculates \p half sine of input \p a in round-to-nearest-even mode.
-* \param[in] a - half. Is only being read. 
+* \param[in] a - half. Is only being read.
 *
 * \returns half
-* \retval The sine of \p a.
+* - The sine of \p a.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -3427,10 +3555,10 @@ __CUDA_FP16_DECL__ __half hsin(const __half a);
 *
 * \details Calculates \p half2 square root of input vector \p a in round-to-nearest
 * mode.
-* \param[in] a - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
 *
 * \returns half2
-* \retval The elementwise square root on vector \p a.
+* - The elementwise square root on vector \p a.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -3444,10 +3572,10 @@ __CUDA_FP16_DECL__ __half2 h2sqrt(const __half2 a);
 *
 * \details Calculates \p half2 reciprocal square root of input vector \p a in
 * round-to-nearest-even mode.
-* \param[in] a - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
 *
 * \returns half2
-* \retval The elementwise reciprocal square root on vector \p a.
+* - The elementwise reciprocal square root on vector \p a.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -3460,10 +3588,10 @@ __CUDA_FP16_DECL__ __half2 h2rsqrt(const __half2 a);
 *
 * \details Calculates \p half2 reciprocal of input vector \p a in round-to-nearest-even
 * mode.
-* \param[in] a - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
 *
 * \returns half2
-* \retval The elementwise reciprocal on vector \p a.
+* - The elementwise reciprocal on vector \p a.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -3477,10 +3605,10 @@ __CUDA_FP16_DECL__ __half2 h2rcp(const __half2 a);
 *
 * \details Calculates \p half2 natural logarithm of input vector \p a in
 * round-to-nearest-even mode.
-* \param[in] a - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
 *
 * \returns half2
-* \retval The elementwise natural logarithm on vector \p a.
+* - The elementwise natural logarithm on vector \p a.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -3494,10 +3622,10 @@ __CUDA_FP16_DECL__ __half2 h2log(const __half2 a);
 *
 * \details Calculates \p half2 binary logarithm of input vector \p a in round-to-nearest
 * mode.
-* \param[in] a - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
 *
 * \returns half2
-* \retval The elementwise binary logarithm on vector \p a.
+* - The elementwise binary logarithm on vector \p a.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -3511,10 +3639,10 @@ __CUDA_FP16_DECL__ __half2 h2log2(const __half2 a);
 *
 * \details Calculates \p half2 decimal logarithm of input vector \p a in
 * round-to-nearest-even mode.
-* \param[in] a - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
 *
 * \returns half2
-* \retval The elementwise decimal logarithm on vector \p a.
+* - The elementwise decimal logarithm on vector \p a.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -3528,10 +3656,10 @@ __CUDA_FP16_DECL__ __half2 h2log10(const __half2 a);
 *
 * \details Calculates \p half2 exponential function of input vector \p a in
 * round-to-nearest-even mode.
-* \param[in] a - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
 *
 * \returns half2
-* \retval The elementwise exponential function on vector \p a.
+* - The elementwise exponential function on vector \p a.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -3545,10 +3673,10 @@ __CUDA_FP16_DECL__ __half2 h2exp(const __half2 a);
 *
 * \details Calculates \p half2 binary exponential function of input vector \p a in
 * round-to-nearest-even mode.
-* \param[in] a - half2. Is only being read. 
+* \param[in] a - half2. Is only being read.
 *
 * \returns half2
-* \retval The elementwise binary exponential function on vector \p a.
+* - The elementwise binary exponential function on vector \p a.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -3559,13 +3687,13 @@ __CUDA_FP16_DECL__ __half2 h2exp2(const __half2 a);
 * \ingroup CUDA_MATH__HALF2_FUNCTIONS
 * \brief Calculates \p half2 vector decimal exponential function in
 * round-to-nearest-even mode.
-* 
+*
 * \details Calculates \p half2 decimal exponential function of input vector \p a in
 * round-to-nearest-even mode.
-* \param[in] a - half2. Is only being read. 
-* 
+* \param[in] a - half2. Is only being read.
+*
 * \returns half2
-* \retval The elementwise decimal exponential function on vector \p a.
+* - The elementwise decimal exponential function on vector \p a.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -3575,13 +3703,13 @@ __CUDA_FP16_DECL__ __half2 h2exp10(const __half2 a);
 /**
 * \ingroup CUDA_MATH__HALF2_FUNCTIONS
 * \brief Calculates \p half2 vector cosine in round-to-nearest-even mode.
-* 
+*
 * \details Calculates \p half2 cosine of input vector \p a in round-to-nearest-even
 * mode.
-* \param[in] a - half2. Is only being read. 
-* 
+* \param[in] a - half2. Is only being read.
+*
 * \returns half2
-* \retval The elementwise cosine on vector \p a.
+* - The elementwise cosine on vector \p a.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -3591,12 +3719,12 @@ __CUDA_FP16_DECL__ __half2 h2cos(const __half2 a);
 /**
 * \ingroup CUDA_MATH__HALF2_FUNCTIONS
 * \brief Calculates \p half2 vector sine in round-to-nearest-even mode.
-* 
+*
 * \details Calculates \p half2 sine of input vector \p a in round-to-nearest-even mode.
-* \param[in] a - half2. Is only being read. 
-* 
+* \param[in] a - half2. Is only being read.
+*
 * \returns half2
-* \retval The elementwise sine on vector \p a.
+* - The elementwise sine on vector \p a.
 * \internal
 * \exception-guarantee no-throw guarantee
 * \behavior reentrant, thread safe
@@ -3604,19 +3732,52 @@ __CUDA_FP16_DECL__ __half2 h2cos(const __half2 a);
 */
 __CUDA_FP16_DECL__ __half2 h2sin(const __half2 a);
 
-#endif /*if __CUDA_ARCH__ >= 530 || !defined(__CUDA_ARCH__)*/
+#endif /*if !defined(__CUDA_ARCH__) || (__CUDA_ARCH__ >= 530)*/
 
-#if __CUDA_ARCH__ >= 600 || !defined(__CUDA_ARCH__)
+#if !defined(__CUDA_ARCH__) || (__CUDA_ARCH__ >= 600)
 
+/**
+* \ingroup CUDA_MATH__HALF2_ARITHMETIC
+* \brief Vector add \p val to the value stored at \p address in global or shared memory, and writes this
+* value back to \p address. The atomicity of the add operation is guaranteed separately for each of the
+* two __half elements; the entire __half2 is not guaranteed to be atomic as a single 32-bit access.
+*
+* \details The location of \p address must be in global or shared memory. This operation has undefined
+* behavior otherwise. This operation is only supported by devices of compute capability 6.x and higher.
+*
+* \param[in] address - half2*. An address in global or shared memory.
+* \param[in] val - half2. The value to be added.
+*
+* \returns half2
+* - The old value read from \p address.
+*
+* \note_ref_guide_atomic
+*/
 __CUDA_FP16_DECL__ __half2 atomicAdd(__half2 *const address, const __half2 val);
 
-#endif /*if __CUDA_ARCH__ >= 600 || !defined(__CUDA_ARCH__)*/
+#endif /*if !defined(__CUDA_ARCH__) || (__CUDA_ARCH__ >= 600)*/
 
-#if __CUDA_ARCH__ >= 700 || !defined(__CUDA_ARCH__)
+#if !defined(__CUDA_ARCH__) || (__CUDA_ARCH__ >= 700)
 
+/**
+* \ingroup CUDA_MATH__HALF_ARITHMETIC
+* \brief Adds \p val to the value stored at \p address in global or shared memory, and writes this value
+* back to \p address. This operation is performed in one atomic operation.
+*
+* \details The location of \p address must be in global or shared memory. This operation has undefined
+* behavior otherwise. This operation is only supported by devices of compute capability 7.x and higher.
+*
+* \param[in] address - half*. An address in global or shared memory.
+* \param[in] val - half. The value to be added.
+*
+* \returns half
+* - The old value read from \p address.
+*
+* \note_ref_guide_atomic
+*/
 __CUDA_FP16_DECL__ __half atomicAdd(__half *const address, const __half val);
 
-#endif /*if __CUDA_ARCH__ >= 700 || !defined(__CUDA_ARCH__)*/
+#endif /*if !defined(__CUDA_ARCH__) || (__CUDA_ARCH__ >= 700)*/
 
 #endif /* defined(__CUDACC__) */
 
@@ -3627,5 +3788,7 @@ __CUDA_FP16_DECL__ __half atomicAdd(__half *const address, const __half val);
 
 /* Note the .hpp file is included even for host-side compilation, to capture the "half" & "half2" definitions */
 #include "cuda_fp16.hpp"
+#undef ___CUDA_FP16_STRINGIFY_INNERMOST
+#undef __CUDA_FP16_STRINGIFY
 
 #endif /* end of include guard: __CUDA_FP16_H__ */