From e1821c88cf52c062144f3c9df7af3368e2f6f852 Mon Sep 17 00:00:00 2001 From: minsung Date: Thu, 16 Apr 2026 08:53:05 +0900 Subject: [PATCH] =?UTF-8?q?rustdoc=20=EA=B2=BD=EA=B3=A0=200=EA=B0=9C?= =?UTF-8?q?=EB=A1=9C=20=EC=A0=95=EB=A6=AC=20=E2=80=94=20=EB=8B=A8=EC=9C=84?= =?UTF-8?q?=20=ED=91=9C=EA=B8=B0=20false=20positive=20=EC=99=84=ED=99=94?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit cargo doc --workspace --no-deps 에서 55 → 0 warnings. ## 변경 - crates/{ir, kernel, incremental, viewer}/src/lib.rs 최상단에 #![allow(rustdoc::broken_intra_doc_links)] 추가. · 이유: doc comment 내 단위 표기 [mm] [m] [deg] [rad] [radians] 가 intra-doc link 문법과 충돌 (40+ 건). 실제 intra-doc link 가 아님. · 각 crate 에 주석으로 이유 명시. - crates/ifc/src/bridge_export.rs: camber_mid_mm doc comment 의 \[mm\] escape. - crates/dsl/src/{cross_beam,expansion_joint}.rs: station doc comment \[m\] escape. - crates/viewer/src/camera.rs: radius/yaw/pitch doc \[mm\]/\[radians\] escape. - crates/incremental/src/lib.rs: `HashSet` → backtick 래핑 (unclosed HTML tag 경고 해소). cargo check --workspace --all-targets: 0 warnings. 테스트 회귀 없음: cimery-ifc 20 + cimery-viewer 13 passed. Co-Authored-By: Claude Sonnet 4.6 --- cimery/crates/dsl/src/cross_beam.rs | 2 +- cimery/crates/dsl/src/expansion_joint.rs | 2 +- cimery/crates/ifc/src/bridge_export.rs | 2 +- cimery/crates/incremental/src/lib.rs | 4 +++- cimery/crates/ir/src/lib.rs | 2 ++ cimery/crates/kernel/src/lib.rs | 2 ++ cimery/crates/viewer/src/camera.rs | 6 +++--- cimery/crates/viewer/src/lib.rs | 2 ++ 8 files changed, 15 insertions(+), 7 deletions(-) diff --git a/cimery/crates/dsl/src/cross_beam.rs b/cimery/crates/dsl/src/cross_beam.rs index 7ec706e..b9c815d 100644 --- a/cimery/crates/dsl/src/cross_beam.rs +++ b/cimery/crates/dsl/src/cross_beam.rs @@ -42,7 +42,7 @@ pub struct CrossBeamBuilder { } impl CrossBeamBuilder { - /// Station along alignment [m]. + /// Station along alignment \[m\]. pub fn station(mut self, v: M) -> Self { self.station = Some(v.value()); self } diff --git a/cimery/crates/dsl/src/expansion_joint.rs b/cimery/crates/dsl/src/expansion_joint.rs index b178825..ccd00f7 100644 --- a/cimery/crates/dsl/src/expansion_joint.rs +++ b/cimery/crates/dsl/src/expansion_joint.rs @@ -35,7 +35,7 @@ pub struct ExpansionJointBuilder { } impl ExpansionJointBuilder { - /// Station along alignment [m]. + /// Station along alignment \[m\]. pub fn station(mut self, v: M) -> Self { self.station = Some(v.value()); self } diff --git a/cimery/crates/ifc/src/bridge_export.rs b/cimery/crates/ifc/src/bridge_export.rs index 018603c..691c55b 100644 --- a/cimery/crates/ifc/src/bridge_export.rs +++ b/cimery/crates/ifc/src/bridge_export.rs @@ -50,7 +50,7 @@ pub struct BridgeExportParams { pub haunch_depth: f64, // mm pub show_parapets: bool, pub show_joints: bool, - /// Sprint 37: 거더 중앙 camber 솟음량 [mm]. 0 = 직선. + /// Sprint 37: 거더 중앙 camber 솟음량 \[mm\]. 0 = 직선. /// > 0 일 때는 beam 을 `CAMBER_SEGMENTS` 개로 분할해 포물선 근사. pub camber_mid_mm: f64, } diff --git a/cimery/crates/incremental/src/lib.rs b/cimery/crates/incremental/src/lib.rs index 2be8aeb..0571b1e 100644 --- a/cimery/crates/incremental/src/lib.rs +++ b/cimery/crates/incremental/src/lib.rs @@ -1,3 +1,5 @@ +#![allow(rustdoc::broken_intra_doc_links)] // doc comment 단위 표기 false positive. + //! cimery-incremental — incremental computation layer. //! //! ## 백엔드 선택 @@ -10,7 +12,7 @@ //! 두 백엔드 모두 동일한 공개 API를 제공한다. 테스트 4층 전부 양쪽에서 통과. //! //! ## Sprint 8: manual dirty-tracking -//! HashMap cache + HashSet dirty set. Feature 단위 쿼리. +//! HashMap cache + `HashSet` dirty set. Feature 단위 쿼리. //! //! ## Sprint 15: 전 Feature 타입으로 확장 //! Girder 전용 → 5종 MVP Feature (Girder·DeckSlab·Bearing·Pier·Abutment). diff --git a/cimery/crates/ir/src/lib.rs b/cimery/crates/ir/src/lib.rs index 4abd0ec..f1650d6 100644 --- a/cimery/crates/ir/src/lib.rs +++ b/cimery/crates/ir/src/lib.rs @@ -1,3 +1,5 @@ +#![allow(rustdoc::broken_intra_doc_links)] // doc comment 내 단위 표기 \[mm\], \[m\] 등 false positive 다수. + //! cimery-ir — deterministic intermediate representation. //! //! Rules: diff --git a/cimery/crates/kernel/src/lib.rs b/cimery/crates/kernel/src/lib.rs index 2671c64..efafa36 100644 --- a/cimery/crates/kernel/src/lib.rs +++ b/cimery/crates/kernel/src/lib.rs @@ -1,3 +1,5 @@ +#![allow(rustdoc::broken_intra_doc_links)] // doc comment 단위 표기(\[mm\]) false positive. + //! cimery-kernel — GeomKernel trait, mesh types, and geometry backends. //! //! # Backends (ADR-001) diff --git a/cimery/crates/viewer/src/camera.rs b/cimery/crates/viewer/src/camera.rs index 9fe51ba..4e4c476 100644 --- a/cimery/crates/viewer/src/camera.rs +++ b/cimery/crates/viewer/src/camera.rs @@ -48,11 +48,11 @@ pub enum Projection { pub struct Camera { /// Point the camera orbits around. pub target: Vec3, - /// Distance from target [mm]. + /// Distance from target \[mm\]. pub radius: f32, - /// Horizontal rotation [radians]. + /// Horizontal rotation \[radians\]. pub yaw: f32, - /// Vertical rotation [radians]. Clamped to avoid gimbal lock. + /// Vertical rotation \[radians\]. Clamped to avoid gimbal lock. pub pitch: f32, pub fov_y: f32, pub aspect: f32, diff --git a/cimery/crates/viewer/src/lib.rs b/cimery/crates/viewer/src/lib.rs index 3ca98e6..534e70f 100644 --- a/cimery/crates/viewer/src/lib.rs +++ b/cimery/crates/viewer/src/lib.rs @@ -1,3 +1,5 @@ +#![allow(rustdoc::broken_intra_doc_links)] // doc comment 단위 표기(\[mm\], \[deg\]) false positive. + //! cimery-viewer — Sprint 5: Interactive Parametric. //! //! egui Properties panel (left) + real-time bridge scene regeneration.