Add part of parameter definitions and fix indentation

src/include/clu_subs.h

@@ -1038,8 +1038,8 @@ void cms(std::complex<double> **am, C1 *c1, C1_AddOns *c1ao, C4 *c4, C6 *c6) {
 
 /*! \brief C++ porting of CRSM1
  *
- * \param vk: `double`
- * \param exri: `double`
+ * \param vk: `double` Wave number.
+ * \param exri: `double` External medium refractive index.
  * \param c1: `C1 *`
  * \param c1ao: `C1_AddOns *`
  * \param c4: `C4 *`
@@ -1167,10 +1167,10 @@ void crsm1(double vk, double exri, C1 *c1, C1_AddOns *c1ao, C4 *c4, C6 *c6) {
 
 /*! \brief C++ porting of HJV
  *
- * \param exri: `double`
- * \param vk: `double`
- * \param jer: `int &`
- * \param lcalc: `int &`
+ * \param exri: `double` External medium refractive index.
+ * \param vk: `double` Wave number.
+ * \param jer: `int &` Reference to error code flag.
+ * \param lcalc: `int &` Reference to the highest order accounted for in calculation.
  * \param arg: `complex\<double\> &`
  * \param c1: `C1 *`
  * \param c1ao: `C1_AddOns *`
@@ -1360,8 +1360,8 @@ void lucin(std::complex<double> **am, const int nddmst, int n, int &ier) {
 
 /*! \brief C++ porting of MEXTC
  *
- * \param vk: `double`
- * \param exri: `double`
+ * \param vk: `double` Wave number.
+ * \param exri: `double` External medium refractive index.
  * \param fsac: Matrix of complex
  * \param cextlr: `double **`
  * \param cext: `double **`
@@ -1419,8 +1419,8 @@ void mextc(double vk, double exri, std::complex<double> **fsac, double **cextlr,
 /*! \brief C++ porting of PCROS
  *
  * This function is intended to evaluate the particle cross-section. QUESTIUON: correct?
- * \param vk: `double`
- * \param exri: `double`
+ * \param vk: `double` Wave number.
+ * \param exri: `double` External medium refractive index.
  * \param c1: `C1 *`
  * \param c1ao: `C1_AddOns *`
  * \param c4: `C4 *`
@@ -1486,9 +1486,9 @@ void pcros(double vk, double exri, C1 *c1, C1_AddOns *c1ao, C4 *c4) {
 
 /*! \brief C++ porting of PCRSM0
  *
- * \param vk: `double`
- * \param exri: `double`
- * \param inpol: `int`
+ * \param vk: `double` Wave number.
+ * \param exri: `double` External medium refractive index.
+ * \param inpol: `int` Incident field polarization type.
  * \param c1: `C1 *`
  * \param c1ao: `C1_AddOns *`
  * \param c4: `C4 *`
@@ -1561,14 +1561,14 @@ void pcrsm0(double vk, double exri, int inpol, C1 *c1, C1_AddOns *c1ao, C4 *c4)
 
 /*! \brief C++ porting of POLAR
  *
- * \param x: `double`
- * \param y: `double`
- * \param z: `double`
- * \param r: `double &`
- * \param cth: `double &`
- * \param sth: `double &`
- * \param cph: `double &`
- * \param sph: `double &`
+ * \param x: `double` X-axis Cartesian coordinate.
+ * \param y: `double` Y-axis Cartesian coordinate.
+ * \param z: `double` Z-axis Cartesian coordinate.
+ * \param r: `double &` Reference to radial vector (output value).
+ * \param cth: `double &` Reference to the cosine of the azimuth coordinate (output value).
+ * \param sth: `double &` Reference to the sine of the azimuth coordinate (output value).
+ * \param cph: `double &` Reference to the cosine of the elevation coordinate (output value).
+ * \param sph: `double &` Reference to the sine of the elevation coordinate (output value).
  */
 void polar(
 	   double x, double y, double z, double &r, double &cth, double &sth,
@@ -1904,8 +1904,8 @@ void rftr(
 
 /*! \brief C++ porting of SCR0
  *
- * \param vk: `double` QUESTION: definition?
- * \param exri: `double` External medium refractive index. QUESTION: correct?
+ * \param vk: `double` Wave number
+ * \param exri: `double` External medium refractive index.
  * \param c1: `C1 *` Pointer to a C1 instance.
  * \param c1ao: `C1_AddOns *` Pointer to C1_AddOns instance.
  * \param c3: `C3 *` Pointer to a C3 instance.
@@ -1959,9 +1959,9 @@ void scr0(double vk, double exri, C1 *c1, C1_AddOns *c1ao, C3 *c3, C4 * c4) {
 
 /*! \brief C++ porting of SCR2
  *
- * \param vk: `double` QUESTION: definition?
+ * \param vk: `double` Wave number.
  * \param vkarg: `double` QUESTION: definition?
- * \param exri: `double` External medium refractive index
+ * \param exri: `double` External medium refractive index.
  * \param duk: `double *` QUESTION: definition?
  * \param c1: `C1 *` Pointer to a C1 instance.
  * \param c1ao: `C1_AddOns *` Pointer to C1_AddOns instance.