fix (#4841)

Co-authored-by: Steve <ubuntu@ip-172-31-34-29.ap-northeast-1.compute.internal>

dgl_sparse/include/sparse/elementwise_op.h

-/*!
+/**
  *  Copyright (c) 2022 by Contributors
- * \file sparse/elementwise_op.h
- * \brief DGL C++ sparse elementwise operators
+ * @file sparse/elementwise_op.h
+ * @brief DGL C++ sparse elementwise operators
  */
 #ifndef SPARSE_ELEMENTWISE_OP_H_
 #define SPARSE_ELEMENTWISE_OP_H_
@@ -13,7 +13,7 @@ namespace dgl {
 namespace sparse {
 
 // TODO(zhenkun): support addition of matrices with different sparsity.
-/*!
+/**
  * @brief Adds two sparse matrices. Currently does not support two matrices with
  * different sparsity.
  *

dgl_sparse/include/sparse/sparse_matrix.h

-/*!
+/**
  *  Copyright (c) 2022 by Contributors
  * @file sparse/sparse_matrix.h
  * @brief DGL C++ sparse matrix header
@@ -15,10 +15,10 @@
 namespace dgl {
 namespace sparse {
 
-/*! @brief SparseFormat enumeration */
+/** @brief SparseFormat enumeration */
 enum SparseFormat { kCOO, kCSR, kCSC };
 
-/*! @brief CSR sparse structure */
+/** @brief CSR sparse structure */
 struct CSR {
   // CSR format index pointer array of the matrix
   torch::Tensor indptr;
@@ -34,7 +34,7 @@ struct CSR {
   torch::optional<torch::Tensor> value_indices;
 };
 
-/*! @brief COO sparse structure */
+/** @brief COO sparse structure */
 struct COO {
   // COO format row array of the matrix
   torch::Tensor row;
@@ -42,10 +42,10 @@ struct COO {
   torch::Tensor col;
 };
 
-/*! @brief SparseMatrix bound to Python  */
+/** @brief SparseMatrix bound to Python  */
 class SparseMatrix : public torch::CustomClassHolder {
  public:
-  /*!
+  /**
    * @brief General constructor to construct a sparse matrix for different
    * sparse formats. At least one of the sparse formats should be provided,
    * while others could be nullptrs.
@@ -61,7 +61,7 @@ class SparseMatrix : public torch::CustomClassHolder {
       const std::shared_ptr<CSR>& csc, torch::Tensor value,
       const std::vector<int64_t>& shape);
 
-  /*!
+  /**
    * @brief Construct a SparseMatrix from a COO format.
    * @param coo The COO format
    * @param value Values of the sparse matrix
@@ -73,7 +73,7 @@ class SparseMatrix : public torch::CustomClassHolder {
       const std::shared_ptr<COO>& coo, torch::Tensor value,
       const std::vector<int64_t>& shape);
 
-  /*!
+  /**
    * @brief Construct a SparseMatrix from a CSR format.
    * @param csr The CSR format
    * @param value Values of the sparse matrix
@@ -85,7 +85,7 @@ class SparseMatrix : public torch::CustomClassHolder {
       const std::shared_ptr<CSR>& csr, torch::Tensor value,
       const std::vector<int64_t>& shape);
 
-  /*!
+  /**
    * @brief Construct a SparseMatrix from a CSC format.
    * @param csc The CSC format
    * @param value Values of the sparse matrix
@@ -97,44 +97,44 @@ class SparseMatrix : public torch::CustomClassHolder {
       const std::shared_ptr<CSR>& csc, torch::Tensor value,
       const std::vector<int64_t>& shape);
 
-  /*! @return Value of the sparse matrix. */
+  /** @return Value of the sparse matrix. */
   inline torch::Tensor value() const { return value_; }
-  /*! @return Shape of the sparse matrix. */
+  /** @return Shape of the sparse matrix. */
   inline const std::vector<int64_t>& shape() const { return shape_; }
-  /*! @return Number of non-zero values */
+  /** @return Number of non-zero values */
   inline int64_t nnz() const { return value_.size(0); }
-  /*! @return Non-zero value data type */
+  /** @return Non-zero value data type */
   inline caffe2::TypeMeta dtype() const { return value_.dtype(); }
-  /*! @return Device of the sparse matrix */
+  /** @return Device of the sparse matrix */
   inline torch::Device device() const { return value_.device(); }
 
-  /*! @return COO of the sparse matrix. The COO is created if not exists. */
+  /** @return COO of the sparse matrix. The COO is created if not exists. */
   std::shared_ptr<COO> COOPtr();
-  /*! @return CSR of the sparse matrix. The CSR is created if not exists. */
+  /** @return CSR of the sparse matrix. The CSR is created if not exists. */
   std::shared_ptr<CSR> CSRPtr();
-  /*! @return CSC of the sparse matrix. The CSC is created if not exists. */
+  /** @return CSC of the sparse matrix. The CSC is created if not exists. */
   std::shared_ptr<CSR> CSCPtr();
 
-  /*! @brief Check whether this sparse matrix has COO format. */
+  /** @brief Check whether this sparse matrix has COO format. */
   inline bool HasCOO() const { return coo_ != nullptr; }
-  /*! @brief Check whether this sparse matrix has CSR format. */
+  /** @brief Check whether this sparse matrix has CSR format. */
   inline bool HasCSR() const { return csr_ != nullptr; }
-  /*! @brief Check whether this sparse matrix has CSC format. */
+  /** @brief Check whether this sparse matrix has CSC format. */
   inline bool HasCSC() const { return csc_ != nullptr; }
 
-  /*! @return {row, col, value} tensors in the COO format. */
+  /** @return {row, col, value} tensors in the COO format. */
   std::vector<torch::Tensor> COOTensors();
-  /*! @return {row, col, value} tensors in the CSR format. */
+  /** @return {row, col, value} tensors in the CSR format. */
   std::vector<torch::Tensor> CSRTensors();
-  /*! @return {row, col, value} tensors in the CSC format. */
+  /** @return {row, col, value} tensors in the CSC format. */
   std::vector<torch::Tensor> CSCTensors();
 
  private:
-  /*! @brief Create the COO format for the sparse matrix internally */
+  /** @brief Create the COO format for the sparse matrix internally */
   void _CreateCOO();
-  /*! @brief Create the CSR format for the sparse matrix internally */
+  /** @brief Create the CSR format for the sparse matrix internally */
   void _CreateCSR();
-  /*! @brief Create the CSC format for the sparse matrix internally */
+  /** @brief Create the CSC format for the sparse matrix internally */
   void _CreateCSC();
 
   // COO/CSC/CSR pointers. Nullptr indicates non-existence.
@@ -146,7 +146,7 @@ class SparseMatrix : public torch::CustomClassHolder {
   const std::vector<int64_t> shape_;
 };
 
-/*!
+/**
  * @brief Create a SparseMatrix from tensors in COO format.
  * @param row Row indices of the COO.
  * @param col Column indices of the COO.
@@ -159,7 +159,7 @@ c10::intrusive_ptr<SparseMatrix> CreateFromCOO(
     torch::Tensor row, torch::Tensor col, torch::Tensor value,
     const std::vector<int64_t>& shape);
 
-/*!
+/**
  * @brief Create a SparseMatrix from tensors in CSR format.
  * @param indptr Index pointer array of the CSR
  * @param indices Indices array of the CSR
@@ -172,7 +172,7 @@ c10::intrusive_ptr<SparseMatrix> CreateFromCSR(
     torch::Tensor indptr, torch::Tensor indices, torch::Tensor value,
     const std::vector<int64_t>& shape);
 
-/*!
+/**
  * @brief Create a SparseMatrix from tensors in CSC format.
  * @param indptr Index pointer array of the CSC
  * @param indices Indices array of the CSC

dgl_sparse/src/elemenwise_op.cc

-/*!
+/**
  *  Copyright (c) 2022 by Contributors
  * @file elementwise_op.cc
  * @brief DGL C++ sparse elementwise operator implementation

dgl_sparse/src/python_binding.cc

-/*!
+/**
  *  Copyright (c) 2022 by Contributors
  * @file python_binding.cc
  * @brief DGL sparse library Python binding

dgl_sparse/src/sparse_matrix.cc

-/*!
+/**
  *  Copyright (c) 2022 by Contributors
  * @file sparse_matrix.cc
  * @brief DGL C++ sparse matrix implementations

dgl_sparse/src/utils.h

-/*!
+/**
  *  Copyright (c) 2022 by Contributors
  * @file utils.h
  * @brief DGL C++ sparse API utilities
@@ -12,7 +12,7 @@
 namespace dgl {
 namespace sparse {
 
-/*! @brief Find a proper sparse format for two sparse matrices. It chooses
+/** @brief Find a proper sparse format for two sparse matrices. It chooses
  * COO if anyone of the sparse matrices has COO format. If none of them has
  * COO, it tries CSR and CSC in the same manner. */
 inline static SparseFormat FindAnyExistingFormat(
@@ -29,7 +29,7 @@ inline static SparseFormat FindAnyExistingFormat(
   return fmt;
 }
 
-/*! @brief Check whether two matrices has the same dtype and shape for
+/** @brief Check whether two matrices has the same dtype and shape for
  * elementwise operators. */
 inline static void ElementwiseOpSanityCheck(
     const c10::intrusive_ptr<SparseMatrix>& A,