update format

Author: abacus_fixer

source/source_cell/module_symmetry/symmetry.h

@@ -160,8 +160,12 @@ class Symmetry : public Symmetry_Basic
      *
      * @param rhogtot charge density in reciprocal space
      * @param ixyz2ipw index mapping from real to reciprocal space
-     * @param nx, ny, nz grid dimensions
-     * @param fftnx, fftny, fftnz FFT grid dimensions
+     * @param nx grid dimension in x
+     * @param ny grid dimension in y
+     * @param nz grid dimension in z
+     * @param fftnx FFT grid dimension in x
+     * @param fftny FFT grid dimension in y
+     * @param fftnz FFT grid dimension in z
      * @param gamma_only_pw whether to use gamma-only PW
      */
     void rhog_symmetry(std::complex<double> *rhogtot, int* ixyz2ipw, const int &nx, 

source/source_cell/module_symmetry/symmetry_basic.h

@@ -118,7 +118,9 @@ class Symmetry_Basic
          *
          * @param gmatrix rotation matrix
          * @param gtrans translation vector
-         * @param i,j,k indices
+         * @param i index in x
+         * @param j index in y
+         * @param k index in z
          */
         void rotate(
                 ModuleBase::Matrix3 &gmatrix, ModuleBase::Vector3<double> &gtrans, 

source/source_cell/parallel_kpoints.h

@@ -98,7 +98,7 @@ class Parallel_Kpoints
                     std::vector<ModuleBase::Vector3<double>>& vec_global) const;
 #endif
 
-    ///<K-point information>
+    /// K-point information
     std::vector<int> nks_pool;    ///< number of k-points in each pool (without spin)
     std::vector<int> startk_pool; ///< the first k-point in each pool (without spin)
     std::vector<int> whichpool;   ///< whichpool[k]: the pool which k belongs to, dim: nkstot_np

source/source_cell/pseudo.h

@@ -20,7 +20,7 @@ class pseudo
     pseudo();
     ~pseudo();
 
-    ///<PP_HEADER>
+    /// PP_HEADER
     bool has_so = false;  ///< if .true. includes spin-orbit
     int nv = 0;           ///< UPF file version number
     std::string psd;      ///< Element label
@@ -47,37 +47,37 @@ class pseudo
     std::vector<double> jchi = {}; ///< jchi(nwfc), added by zhengdy-soc
     std::vector<int> nn = {};
 
-    ///<PP_LOCAL> Local pseudopotentials
+    /// PP_LOCAL - Local pseudopotentials
     std::vector<double> vloc_at = {}; ///< [mesh], local potential( = pseudopot_upf.vloc )
 
-    ///<PP_MESH>
+    /// PP_MESH
     std::vector<double> r = {};   ///< radial logaritmic mesh, r[0:mesh-1]
     std::vector<double> rab = {}; ///< derivative of the radial mesh, rab[0:mesh-1]
 
-    ///<PP_NLCC>
+    /// PP_NLCC
     std::vector<double> rho_atc = {}; ///< radial core charge density, rho_atc[0:mesh-1]
 
-    ///<PP_RHOATOM>
+    /// PP_RHOATOM
     std::vector<double> rho_at = {}; ///< radial atomic charge density, rho_at[0:mesh-1]
 
-    ///<PP_PSWFC>
+    /// PP_PSWFC
     ModuleBase::matrix chi; ///< radial atomic orbitals, chi(nchi, mesh)
 
-    ///<PP_OTHER>
+    /// PP_OTHER
     int msh = 0;       ///< number of points up to rcut
     double rcut = 0.0; ///< cut-off radius
 
-    ///<PP_BETA>
+    /// PP_BETA
     std::vector<int> lll = {}; ///< lll(nbeta), angular momentum of the beta function
 
-    ///<PP_DIJ>
+    /// PP_DIJ
     ModuleBase::matrix dion;  ///< dion(nbeta,nbeta)
     ModuleBase::matrix betar; ///< (nbeta, mesh), radial beta_{mu} functions
 
-    ///<PP_OTHER>
+    /// PP_OTHER
     int nh = 0; ///< number of beta functions per atomic type
 
-    ///<USPP> Ultrasoft pseudopotential
+    /// USPP - Ultrasoft pseudopotential
     ModuleBase::realArray qfuncl; ///< qfuncl(2*lmax+1,nbeta*(nbeta+1)/2,mesh) Q_{mu,nu}(|r|) function for |r|> r_L
     ModuleBase::matrix qqq;       ///< qqq(nbeta,nbeta) q_{mu,nu}
     /**

source/source_cell/read_pp.h

@@ -20,15 +20,15 @@
 class Pseudopot_upf
 {
 public:
-    ///<PP_INFO>
-    ///<PP_HEADER>
-    ///<PP_MESH>
-    ///<PP_NLCC>
-    ///<PP_LOCAL>
-    ///<PP_NONLOCAL>
-    ///<PP_PSWFC>
-    ///<PP_PSRHOATOM>
-    ///<addinfo>
+    /// PP_INFO
+    /// PP_HEADER
+    /// PP_MESH
+    /// PP_NLCC
+    /// PP_LOCAL
+    /// PP_NONLOCAL
+    /// PP_PSWFC
+    /// PP_PSRHOATOM
+    /// addinfo
 
     /**
      * @brief Default constructor.
@@ -52,7 +52,7 @@ class Pseudopot_upf
     bool q_with_l;            ///< if .true. qfunc is pseudized in
     int nqf;                  ///< number of Q coefficients
 
-    ///<Dynamic arrays>
+    /// Dynamic arrays
     bool coulomb_potential = false;  ///< coulomb potential : z/r
     ModuleBase::matrix chi;          ///< chi(nwfc,mesh) atomic wavefcts
     std::vector<int> kbeta = {};            ///< kbeta(nbeta):number of mesh points for projector i (must be .le. mesh )
@@ -69,7 +69,7 @@ class Pseudopot_upf
 
     int nd; ///< nl_5 // Number of nonzero Dij
 
-    ///<VWR format>
+    /// VWR format
     int spd_loc; ///< s,p,d local component
     int iTB_s;   ///< TB s orbital index
     int iTB_p;   ///< TB p orbital index
@@ -263,7 +263,7 @@ class Pseudopot_upf
      */
     void read_pseudo_so(std::ifstream& ifs, Atom_pseudo& pp);
 
-    ///<UPF201 format>
+    /// UPF201 format
     /**
      * @brief Read UPF201 format pseudopotential.
      *