From 1198f2b81a845bd475594cdf42d04e7bd750ebd2 Mon Sep 17 00:00:00 2001 From: 魏曹先生 <1992414357@qq.com> Date: Fri, 14 Aug 2026 00:23:06 +0800 Subject: chore: add "Doc Not Optimize" comments to source files Mark all source files with a comment indicating they are not optimized for documentation purposes. --- mingling_pathf/src/patterns/basic_struct.rs | 1 + mingling_pathf/src/patterns/chain.rs | 1 + mingling_pathf/src/patterns/command.rs | 1 + mingling_pathf/src/patterns/completion.rs | 1 + mingling_pathf/src/patterns/dispatcher.rs | 1 + mingling_pathf/src/patterns/dispatcher_clap.rs | 1 + mingling_pathf/src/patterns/group.rs | 1 + mingling_pathf/src/patterns/grouped_derive.rs | 1 + mingling_pathf/src/patterns/help.rs | 1 + mingling_pathf/src/patterns/metadata.rs | 1 + mingling_pathf/src/patterns/pack.rs | 1 + mingling_pathf/src/patterns/renderer.rs | 1 + 12 files changed, 12 insertions(+) (limited to 'mingling_pathf/src/patterns') diff --git a/mingling_pathf/src/patterns/basic_struct.rs b/mingling_pathf/src/patterns/basic_struct.rs index 9218d65..256426c 100644 --- a/mingling_pathf/src/patterns/basic_struct.rs +++ b/mingling_pathf/src/patterns/basic_struct.rs @@ -1,3 +1,4 @@ +// Doc Not Optimize //! The `BasicStructPattern` matches `struct` definitions in Rust source code. //! It identifies root-level structs and structs nested inside inline modules, //! returning their names and optional module path for analysis. diff --git a/mingling_pathf/src/patterns/chain.rs b/mingling_pathf/src/patterns/chain.rs index 2e95db2..73192cd 100644 --- a/mingling_pathf/src/patterns/chain.rs +++ b/mingling_pathf/src/patterns/chain.rs @@ -1,3 +1,4 @@ +// Doc Not Optimize //! The `ChainPattern` matches functions annotated with `#[chain]` and //! extracts the generated internal struct name (e.g., `__internal_chain_`). //! This is used to track chained handler functions for code generation or analysis. diff --git a/mingling_pathf/src/patterns/command.rs b/mingling_pathf/src/patterns/command.rs index fac70af..c30e130 100644 --- a/mingling_pathf/src/patterns/command.rs +++ b/mingling_pathf/src/patterns/command.rs @@ -1,3 +1,4 @@ +// Doc Not Optimize //! The `CommandPattern` matches functions annotated with `#[command]` and //! extracts the generated hidden module name (`__command__module`). //! diff --git a/mingling_pathf/src/patterns/completion.rs b/mingling_pathf/src/patterns/completion.rs index cff62e0..e1fe9b5 100644 --- a/mingling_pathf/src/patterns/completion.rs +++ b/mingling_pathf/src/patterns/completion.rs @@ -1,3 +1,4 @@ +// Doc Not Optimize //! The `CompletionPattern` matches functions annotated with `#[completion(T)]` and //! extracts the generated internal struct name (e.g., `__internal_completion_`). //! This is used to track completion handler functions for code generation or analysis. diff --git a/mingling_pathf/src/patterns/dispatcher.rs b/mingling_pathf/src/patterns/dispatcher.rs index 85220b5..56d2b97 100644 --- a/mingling_pathf/src/patterns/dispatcher.rs +++ b/mingling_pathf/src/patterns/dispatcher.rs @@ -1,3 +1,4 @@ +// Doc Not Optimize //! The `DispatcherPattern` matches invocations of the `dispatcher!` macro and //! extracts the generated type names from its arguments. It supports: //! - `Entry*` — the entry type (always generated) diff --git a/mingling_pathf/src/patterns/dispatcher_clap.rs b/mingling_pathf/src/patterns/dispatcher_clap.rs index ca2ce9e..55001a6 100644 --- a/mingling_pathf/src/patterns/dispatcher_clap.rs +++ b/mingling_pathf/src/patterns/dispatcher_clap.rs @@ -1,3 +1,4 @@ +// Doc Not Optimize //! The `DispatcherClapPattern` matches structs annotated with `#[dispatcher_clap(...)]` and //! extracts key items for code generation or analysis: //! - The entry struct name (always) diff --git a/mingling_pathf/src/patterns/group.rs b/mingling_pathf/src/patterns/group.rs index 905afa9..7aa4c17 100644 --- a/mingling_pathf/src/patterns/group.rs +++ b/mingling_pathf/src/patterns/group.rs @@ -1,3 +1,4 @@ +// Doc Not Optimize //! The `GroupPattern` matches the `group!` and `group_structural!` macros and //! extracts the type name or alias defined within them. //! This is used to track type groups for code generation or analysis. diff --git a/mingling_pathf/src/patterns/grouped_derive.rs b/mingling_pathf/src/patterns/grouped_derive.rs index 56a87f9..b2eae97 100644 --- a/mingling_pathf/src/patterns/grouped_derive.rs +++ b/mingling_pathf/src/patterns/grouped_derive.rs @@ -1,3 +1,4 @@ +// Doc Not Optimize //! The `GroupedDerivePattern` matches structs, enums, and unions annotated with //! `#[derive(Grouped)]` or `#[derive(GroupedSerialize)]` (or any combination //! with other derives). It also recurses into `mod` items to find nested types. diff --git a/mingling_pathf/src/patterns/help.rs b/mingling_pathf/src/patterns/help.rs index 85793c3..b75c771 100644 --- a/mingling_pathf/src/patterns/help.rs +++ b/mingling_pathf/src/patterns/help.rs @@ -1,3 +1,4 @@ +// Doc Not Optimize //! The `HelpPattern` matches functions annotated with `#[help]` and //! extracts the generated internal struct name (e.g., `__internal_help_`). //! This is used to track help functions for code generation or analysis. diff --git a/mingling_pathf/src/patterns/metadata.rs b/mingling_pathf/src/patterns/metadata.rs index 32a283a..21be2e6 100644 --- a/mingling_pathf/src/patterns/metadata.rs +++ b/mingling_pathf/src/patterns/metadata.rs @@ -1,3 +1,4 @@ +// Doc Not Optimize //! The `MetadataPattern` matches functions annotated with `#[metadata(BindType)]` //! and extracts two types referenced by the metadata system: //! - `BindType` — the entry enum variant the metadata is bound to (attribute argument) diff --git a/mingling_pathf/src/patterns/pack.rs b/mingling_pathf/src/patterns/pack.rs index e5e14e6..10327a7 100644 --- a/mingling_pathf/src/patterns/pack.rs +++ b/mingling_pathf/src/patterns/pack.rs @@ -1,3 +1,4 @@ +// Doc Not Optimize //! The `PackPattern` matches types defined by `pack!`, `pack_err!`, `pack_structural!`, and `pack_err_structural!` macros. //! It extracts the registered type name (e.g., `TypeName` from `pack!(TypeName = InnerType)`). //! This is used to track packed type definitions for code generation or analysis. diff --git a/mingling_pathf/src/patterns/renderer.rs b/mingling_pathf/src/patterns/renderer.rs index 153e603..edcd8a7 100644 --- a/mingling_pathf/src/patterns/renderer.rs +++ b/mingling_pathf/src/patterns/renderer.rs @@ -1,3 +1,4 @@ +// Doc Not Optimize //! The `RendererPattern` matches functions annotated with `#[renderer]` and //! extracts the generated internal struct name (e.g., `__internal_renderer_`). //! This is used to track rendering functions for code generation or analysis. -- cgit