[F42] cargo doc --workspace --no-deps clean (0 warnings)
Fix all 33 rustdoc warnings across the workspace: - Unresolved intra-doc links: rewrite [`name`] → either backtick text (when not actually a link) or fully-qualified `[Type::method]` / `[crate::module::name]` form. Affected: mxaccess-codec (asb_variant, item_control, metadata_query, observed_write_template, reference_handle, write_message), mxaccess-rpc (pdu), mxaccess-nmx (client), mxaccess-asb-nettcp (nmf), mxaccess-callback (exporter), mxaccess (asb_session, session, lib). - Bracket-text being interpreted as link refs (e.g. `body[17]` → `` `body[17]` ``). - Private-item references in public docs (CALLBACK_BROADCAST_CAPACITY, recover_connection_core, mxvalue_to_writevalue) reduced to backtick-text since they aren't part of the public API. `RUSTDOCFLAGS="-D warnings" cargo doc --workspace --no-deps` now exits clean. Workspace 759 tests pass; clippy clean. Defers `#![warn(missing_docs)]` lint to a future pass — the cleanup target is the broken-link warnings, which are signal; missing-docs would surface hundreds of low-priority public-item gaps that are out of scope for this F-number. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -154,7 +154,7 @@ impl AsbVariant {
|
||||
}
|
||||
}
|
||||
|
||||
/// Standalone encode: convenience wrapper around [`encode_into`].
|
||||
/// Standalone encode: convenience wrapper around [`Self::encode_into`].
|
||||
pub fn encode(&self) -> Vec<u8> {
|
||||
let mut out = Vec::with_capacity(self.wire_len());
|
||||
self.encode_into(&mut out);
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
//!
|
||||
//! Direct port of `src/MxNativeCodec/NmxItemControlMessage.cs`. The body
|
||||
//! carries an advise-supervisory or unadvise command together with a 16-byte
|
||||
//! item correlation GUID and a 14-byte projection of an [`MxReferenceHandle`]
|
||||
//! item correlation GUID and a 14-byte projection of an [`crate::reference_handle::MxReferenceHandle`]
|
||||
//! (handle bytes 6..20 — `object_id` through `attribute_index`).
|
||||
//!
|
||||
//! ## Wire layout
|
||||
@@ -87,7 +87,7 @@ const PAYLOAD_LENGTH: usize = 18; // cs:28 — 7×u16 + u32 tail = 18 bytes
|
||||
pub const DEFAULT_TAIL: u32 = 3;
|
||||
|
||||
/// Decoded NMX item-control body. The fields after `item_correlation_id`
|
||||
/// project bytes 6..20 of an [`MxReferenceHandle`] — see
|
||||
/// project bytes 6..20 of an [`crate::reference_handle::MxReferenceHandle`] — see
|
||||
/// `NmxItemControlMessage.cs:71-81, 134-141`.
|
||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
||||
pub struct NmxItemControlMessage {
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
//! `NmxMetadataQueryMessage` — observed pre-advise metadata-query body.
|
||||
//!
|
||||
//! Direct port of `src/MxNativeCodec/NmxMetadataQueryMessage.cs`. The .NET
|
||||
//! reference exposes a single static helper, [`encode_observed_pre_advise`],
|
||||
//! reference exposes a single static helper, `encode_observed_pre_advise`,
|
||||
//! which returns a fixed observed body with a 16-byte item-correlation GUID
|
||||
//! patched in at offset `0x8a`.
|
||||
//!
|
||||
|
||||
@@ -44,7 +44,7 @@
|
||||
//! `Encode` (`.cs:51-64`) writes:
|
||||
//!
|
||||
//! 1. The captured prefix (`_prefix`, raw bytes) — preserved verbatim.
|
||||
//! 2. The freshly-encoded value bytes from [`encode_value`].
|
||||
//! 2. The freshly-encoded value bytes from `encode_value_bytes`.
|
||||
//! 3. The captured suffix (`_suffixBeforeWriteIndex`) — preserved verbatim.
|
||||
//! 4. The fresh `writeIndex` as i32 LE in the trailing 4 bytes.
|
||||
//!
|
||||
@@ -167,12 +167,12 @@ impl ObservedWriteBodyTemplate {
|
||||
}
|
||||
}
|
||||
|
||||
/// Captured opcode at body[0]. Mirrors `_prefix[0]`.
|
||||
/// Captured opcode at `body[0]`. Mirrors `_prefix[0]`.
|
||||
pub fn command(&self) -> u8 {
|
||||
self.command
|
||||
}
|
||||
|
||||
/// Captured wire-kind byte at body[17]. Drawn from the captured prefix,
|
||||
/// Captured wire-kind byte at `body[17]`. Drawn from the captured prefix,
|
||||
/// not from the runtime [`MxValueKind`] (which can disambiguate
|
||||
/// String vs DateTime past the encoder collapse).
|
||||
pub fn wire_kind(&self) -> u8 {
|
||||
|
||||
@@ -34,8 +34,9 @@ const CRC16_IBM_POLYNOMIAL: u16 = 0xa001;
|
||||
///
|
||||
/// `object_signature` and `attribute_signature` are derived values. The Rust
|
||||
/// port keeps them private — the only constructor that produces a handle from
|
||||
/// names is [`from_names`]; the only mutators that update one signature are
|
||||
/// [`with_object_tag_name`] and [`with_attribute_name`], which both
|
||||
/// names is [`MxReferenceHandle::from_names`]; the only mutators that update
|
||||
/// one signature are [`MxReferenceHandle::with_object_tag_name`] and
|
||||
/// [`MxReferenceHandle::with_attribute_name`], which both
|
||||
/// recompute. This is a deliberate tightening over the .NET reference (which
|
||||
/// is a record with public init-only signature fields).
|
||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default)]
|
||||
@@ -157,7 +158,7 @@ impl MxReferenceHandle {
|
||||
/// # Panics
|
||||
///
|
||||
/// Panics if `destination.len() < 20`. Use a 20-byte slice or call
|
||||
/// [`encode`] for a fresh buffer.
|
||||
/// [`Self::encode`] for a fresh buffer.
|
||||
pub fn write_to(self, destination: &mut [u8]) {
|
||||
assert!(
|
||||
destination.len() >= Self::ENCODED_LEN,
|
||||
|
||||
@@ -72,8 +72,8 @@
|
||||
//! 28.. payload
|
||||
//! ```
|
||||
//!
|
||||
//! The encoder writes `count` (u16) at body[22] and `element_width` (u16) at
|
||||
//! body[24]. The decoder/subscription side reads `element_width` as `i32` at
|
||||
//! The encoder writes `count` (u16) at `body[22]` and `element_width` (u16) at
|
||||
//! `body[24]`. The decoder/subscription side reads `element_width` as `i32` at
|
||||
//! a different offset — that asymmetry is documented in the subscription
|
||||
//! message module, not here. Encoder element widths are 2/4/4/8 for
|
||||
//! Boolean/Int32/Float32/Float64 arrays; for variable arrays (String,
|
||||
|
||||
Reference in New Issue
Block a user