style(ascend): reformat CMake comments + restore Gemm/MatMul backticks in common.h

- `src/ascend/custom/cmake/config_envs.cmake`: capitalize + period + Markdown backticks on all comments and status messages.
- `src/ascend/custom/cmake/config_ascend.cmake`: fix `CANN` casing and backticks in the fatal-error message.
- `src/ascend/custom/CMakeLists.txt`: polish status messages and inline comments (Markdown backticks + sentence case).
- `src/ascend/common.h`: restore `Gemm` and `MatMul` backticks in the `BuildAclTensor` docstring per PR #64 review.

Author: zhangyue

src/ascend/common.h

@@ -26,8 +26,8 @@ inline bool IsAclRuntimeAlive() {
 // Build an `aclTensor` descriptor from an InfiniOps `Tensor`.
 //
 // When `transpose_last2` is true the last two dimensions are swapped in the
-// descriptor (shape and strides) without copying data.  This is used by GEMM
-// and Matmul to express a transpose via the view.
+// descriptor (shape and strides) without copying data.  This is used by `Gemm`
+// and `MatMul` to express a transpose via the view.
 inline aclTensor* BuildAclTensor(const Tensor& t,
                                  bool transpose_last2 = false) {
   std::vector<int64_t> shape(t.shape().begin(), t.shape().end());

src/ascend/custom/CMakeLists.txt

@@ -24,7 +24,7 @@ add_compile_options(-Wunused-value -Wcast-align -Wcast-qual -Wwrite-strings
 if(${CMAKE_BUILD_TYPE} MATCHES "RELEASE")
     add_compile_options(-O3 -fvisibility=hidden -fvisibility-inlines-hidden
                         -fstack-protector-strong -fPIE -fPIC)
-    message(STATUS "build type set to RELEASE")
+    message(STATUS "Build type set to `RELEASE`.")
 else()
     add_compile_options(-g -rdynamic)
 endif()
@@ -38,15 +38,15 @@ include(cmake/config_ascend.cmake)
 
 find_program(CCACHE_PROGRAM ccache)
 if(CCACHE_PROGRAM)
-    message(STATUS "Found ccache: ${CCACHE_PROGRAM}")
+    message(STATUS "Found `ccache`: ${CCACHE_PROGRAM}.")
     set(CMAKE_CXX_COMPILER_LAUNCHER "${CCACHE_PROGRAM}")
     set(CMAKE_C_COMPILER_LAUNCHER "${CCACHE_PROGRAM}")
 endif()
 
 # Shared library output location.
 set(CMAKE_LIBRARY_OUTPUT_DIRECTORY ${PROJECT_OUTPUT_PATH})
 
-# Host side files.
+# Host-side files.
 file(GLOB OP_SRCS
     ${PROJECT_OP_SRC_BASE}/torch_binding.cpp
     ${PROJECT_OP_SRC_BASE}/rms_norm/op_host/rms_norm.cpp
@@ -56,12 +56,12 @@ file(GLOB OP_SRCS
 # Python side via `import ascend_kernel`.
 set(OP_PLUGIN_NAME ascend_kernel)
 
-# Kernel side files (device code compiled by `AscendC` toolchain).
+# Kernel-side files (device code compiled by the `AscendC` toolchain).
 ascendc_library(no_workspace_kernel STATIC
     ${PROJECT_OP_SRC_BASE}/rms_norm/op_kernel/rms_norm.cpp
 )
 
-# Create shared library libascend_kernel.so.
+# Create the shared library `libascend_kernel.so`.
 add_library(${OP_PLUGIN_NAME} SHARED ${OP_SRCS})
 
 target_link_libraries(${OP_PLUGIN_NAME} PRIVATE

src/ascend/custom/cmake/config_ascend.cmake

@@ -30,7 +30,7 @@ elseif(EXISTS ${ASCEND_HOME_PATH}/compiler/tikcpp/ascendc_kernel_cmake)
 elseif(EXISTS ${ASCEND_HOME_PATH}/ascendc_devkit/tikcpp/samples/cmake)
     set(ASCENDC_CMAKE_DIR ${ASCEND_HOME_PATH}/ascendc_devkit/tikcpp/samples/cmake)
 else()
-    message(FATAL_ERROR "ascendc_kernel_cmake does not exist, please check whether the cann package is installed.")
+    message(FATAL_ERROR "`ascendc_kernel_cmake` does not exist; please check whether the `CANN` package is installed.")
 endif()
 
 include(${ASCENDC_CMAKE_DIR}/ascendc.cmake)

src/ascend/custom/cmake/config_envs.cmake

@@ -1,11 +1,11 @@
-# find python binary
+# Find the Python binary.
 find_program(PYTHON_EXECUTABLE NAMES python3)
 
 if (NOT EXISTS ${PYTHON_EXECUTABLE})
-    message(FATAL_ERROR "python3 is not found, install python firstly")
+    message(FATAL_ERROR "`python3` is not found; install Python first.")
 endif ()
 
-# get torch path, torch npu path, pybind11 path via python script
+# Get `torch`, `torch_npu`, and `pybind11` paths via a Python helper.
 execute_process(
         COMMAND ${PYTHON_EXECUTABLE} "-c"
         "import torch; import torch_npu; import os; import pybind11; import sysconfig;
@@ -20,46 +20,46 @@ quit(0)
         RESULT_VARIABLE EXEC_RESULT
         OUTPUT_VARIABLE OUTPUT_ENV_DEFINES)
 
-# if failed to run the python script
+# Abort if the Python helper failed.
 if (NOT ${EXEC_RESULT} EQUAL 0)
-    message(FATAL_ERROR "failed to get run python script to get ENVS like TORCH_DIR etc")
+    message(FATAL_ERROR "Failed to run Python script to probe env vars like `TORCH_DIR`.")
 else ()
-    message(STATUS "run python script successfully, output string is [${OUTPUT_ENV_DEFINES}]")
+    message(STATUS "Python probe succeeded; output string is [${OUTPUT_ENV_DEFINES}].")
 endif ()
 
-# extract TORCH_DIR and set it
+# Extract `TORCH_DIR`.
 execute_process(
         COMMAND sh -c "echo \"${OUTPUT_ENV_DEFINES}\" | awk '{print $1}'"
         OUTPUT_VARIABLE TORCH_DIR
         RESULT_VARIABLE EXEC_RESULT
         OUTPUT_STRIP_TRAILING_WHITESPACE
 )
 
-# extract TORCH_NPU_DIR and set it
+# Extract `TORCH_NPU_DIR`.
 execute_process(
         COMMAND sh -c "echo \"${OUTPUT_ENV_DEFINES}\" | awk '{print $2}'"
         OUTPUT_VARIABLE TORCH_NPU_DIR
         RESULT_VARIABLE EXEC_RESULT
         OUTPUT_STRIP_TRAILING_WHITESPACE
 )
 
-# extract PYBIND11_DIR and set it
+# Extract `PYBIND11_DIR`.
 execute_process(
         COMMAND sh -c "echo \"${OUTPUT_ENV_DEFINES}\" | awk '{print $3}'"
         OUTPUT_VARIABLE PYBIND11_DIR
         RESULT_VARIABLE EXEC_RESULT
         OUTPUT_STRIP_TRAILING_WHITESPACE
 )
 
-# extract PYTROCH_ABI and set it
+# Extract the PyTorch C++11 ABI flag.
 execute_process(
         COMMAND sh -c "echo \"${OUTPUT_ENV_DEFINES}\" | awk '{print $4}'"
         OUTPUT_VARIABLE TORCH_API_ENABLED
         RESULT_VARIABLE EXEC_RESULT
         OUTPUT_STRIP_TRAILING_WHITESPACE
 )
 
-# extract PYTHON_INCLUDE_DIR and set it
+# Extract `PYTHON_INCLUDE_DIR`.
 execute_process(
         COMMAND sh -c "echo \"${OUTPUT_ENV_DEFINES}\" | awk '{print $5}'"
         OUTPUT_VARIABLE PYTHON_INCLUDE_DIR
@@ -73,7 +73,7 @@ message(STATUS "TORCH_NPU_DIR=${TORCH_NPU_DIR}")
 message(STATUS "PYBIND11_DIR=${PYBIND11_DIR}")
 message(STATUS "PYTHON_INCLUDE_DIR=${PYTHON_INCLUDE_DIR}")
 
-# set _GLIBCXX_USE_CXX11_ABI
+# Set `_GLIBCXX_USE_CXX11_ABI` to match the PyTorch build.
 if (${TORCH_API_ENABLED} STREQUAL "True")
     add_compile_options(-D_GLIBCXX_USE_CXX11_ABI=1)
     message(STATUS "_GLIBCXX_USE_CXX11_ABI=1")