From fba37f7065643a58e34e21b8b34aa100210c5db7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E8=8C=82=E4=B9=8B=E9=92=B3?= <claw@hdtime.space>
Date: Fri, 24 Jul 2026 11:12:49 +0000
Subject: [PATCH] fix: replace /* ... */ with // ... in doxygen code blocks to
 prevent premature comment termination

---
 include/vde/brep/modeling.h      | 2 +-
 include/vde/core/icp.h           | 4 ++--
 include/vde/foundation/io_gltf.h | 4 ++--
 include/vde/foundation/io_ply.h  | 2 +-
 include/vde/foundation/io_stl.h  | 4 ++--
 5 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/include/vde/brep/modeling.h b/include/vde/brep/modeling.h
index fdad300..d53be43 100644
--- a/include/vde/brep/modeling.h
+++ b/include/vde/brep/modeling.h
@@ -104,7 +104,7 @@ using core::AABB3D;
  *
  * @code{.cpp"}
  * auto circle = NurbsCurve::create_circle(Point3D(0,0,0), 0.5);
- * auto helix = NurbsCurve::create_helix(/* ... */);
+ * auto helix = NurbsCurve::create_helix(// ...);
  * auto pipe = sweep(circle, helix);
  * @endcode
  *
diff --git a/include/vde/core/icp.h b/include/vde/core/icp.h
index 0347af9..8a96b92 100644
--- a/include/vde/core/icp.h
+++ b/include/vde/core/icp.h
@@ -53,8 +53,8 @@ struct ICPResult {
  * @note 初始对齐越好，收敛越快；若初始偏差太大，可能收敛到局部最优
  *
  * @code{.cpp}
- * std::vector<Point3D> src = /* ... */;
- * std::vector<Point3D> tgt = /* ... */;
+ * std::vector<Point3D> src = // ...;
+ * std::vector<Point3D> tgt = // ...;
  * auto result = icp_register(src, tgt, 100, 1e-8);
  * if (result.converged) {
  *     std::cout << "RMS error: " << result.rms_error << "\n";
diff --git a/include/vde/foundation/io_gltf.h b/include/vde/foundation/io_gltf.h
index a5a77e4..df2a2c7 100644
--- a/include/vde/foundation/io_gltf.h
+++ b/include/vde/foundation/io_gltf.h
@@ -43,7 +43,7 @@ struct GltfOptions {
  * @note 生成的 glTF 符合 2.0 规范，兼容 Blender、three.js、Unreal Engine 等工具
  *
  * @code{.cpp}
- * mesh::HalfedgeMesh mesh = /* ... */;
+ * mesh::HalfedgeMesh mesh = // ...;
  * GltfOptions opts;
  * opts.binary = true;
  * opts.include_normals = true;
@@ -69,7 +69,7 @@ bool write_gltf(const std::string& filepath, const mesh::HalfedgeMesh& mesh,
  * @return false 导出失败
  *
  * @code{.cpp}
- * brep::BrepModel model = /* ... */;
+ * brep::BrepModel model = // ...;
  * // 高精度曲面导出
  * bool ok = write_brep_gltf("model.glb", model, 64);
  * @endcode
diff --git a/include/vde/foundation/io_ply.h b/include/vde/foundation/io_ply.h
index e6e5062..92c0985 100644
--- a/include/vde/foundation/io_ply.h
+++ b/include/vde/foundation/io_ply.h
@@ -43,7 +43,7 @@ mesh::HalfedgeMesh read_ply(const std::string& filepath);
  * @note 若需要二进制输出以提高性能，请使用 BinarySerializer
  *
  * @code{.cpp}
- * mesh::HalfedgeMesh mesh = /* ... */;
+ * mesh::HalfedgeMesh mesh = // ...;
  * write_ply("output.ply", mesh);
  * @endcode
  *
diff --git a/include/vde/foundation/io_stl.h b/include/vde/foundation/io_stl.h
index e4cdc98..f619ef4 100644
--- a/include/vde/foundation/io_stl.h
+++ b/include/vde/foundation/io_stl.h
@@ -57,7 +57,7 @@ std::vector<StlTriangle> read_stl(const std::string& filepath);
  * @note 法向量在写入时自动归一化
  *
  * @code{.cpp}
- * std::vector<StlTriangle> tris = /* ... */;
+ * std::vector<StlTriangle> tris = // ...;
  * write_stl("output.stl", tris);  // 二进制，体积小
  * @endcode
  *
@@ -77,7 +77,7 @@ void write_stl(const std::string& filepath, const std::vector<StlTriangle>& tris
  * @warning ASCII STL 文件体积约为二进制 STL 的 5-10 倍，不适合大规模网格
  *
  * @code{.cpp}
- * std::vector<StlTriangle> tris = /* ... */;
+ * std::vector<StlTriangle> tris = // ...;
  * write_stl_ascii("debug.stl", tris);  // 可读文本，便于调试
  * @endcode
  *