rustdoc 경고 0개로 정리 — 단위 표기 false positive 완화
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<FeatureId>` → 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 <noreply@anthropic.com>
This commit is contained in:
@@ -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
|
||||
}
|
||||
|
||||
@@ -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
|
||||
}
|
||||
|
||||
@@ -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,
|
||||
}
|
||||
|
||||
@@ -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<FeatureId> dirty set. Feature 단위 쿼리.
|
||||
//! HashMap cache + `HashSet<FeatureId>` dirty set. Feature 단위 쿼리.
|
||||
//!
|
||||
//! ## Sprint 15: 전 Feature 타입으로 확장
|
||||
//! Girder 전용 → 5종 MVP Feature (Girder·DeckSlab·Bearing·Pier·Abutment).
|
||||
|
||||
@@ -1,3 +1,5 @@
|
||||
#![allow(rustdoc::broken_intra_doc_links)] // doc comment 내 단위 표기 \[mm\], \[m\] 등 false positive 다수.
|
||||
|
||||
//! cimery-ir — deterministic intermediate representation.
|
||||
//!
|
||||
//! Rules:
|
||||
|
||||
@@ -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)
|
||||
|
||||
@@ -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,
|
||||
|
||||
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user