chore: add "Doc Not Optimize" comments to source files

Mark all source files with a comment indicating they are not optimized
for documentation purposes.

41 files changed, 41 insertions, 0 deletions

diff --git a/mingling_core/src/any.rs b/mingling_core/src/any.rs
index 1c4cabe..34f373d 100644
--- a/mingling_core/src/any.rs
+++ b/mingling_core/src/any.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use crate::ProgramCollect;
 use crate::error::ChainProcessError;
 
diff --git a/mingling_core/src/asset.rs b/mingling_core/src/asset.rs
index 527607a..590e419 100644
--- a/mingling_core/src/asset.rs
+++ b/mingling_core/src/asset.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 #![allow(clippy::redundant_pub_crate)]
 pub(crate) mod chain;
 pub(crate) mod core_invokes;
diff --git a/mingling_core/src/build.rs b/mingling_core/src/build.rs
index 213d529..1cf5d6d 100644
--- a/mingling_core/src/build.rs
+++ b/mingling_core/src/build.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 #[doc(hidden)]
 #[cfg(feature = "comp")]
 mod comp;
diff --git a/mingling_core/src/build/comp.rs b/mingling_core/src/build/comp.rs
index c1000c7..be53463 100644
--- a/mingling_core/src/build/comp.rs
+++ b/mingling_core/src/build/comp.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use std::path::PathBuf;
 
 use just_template::tmpl;
diff --git a/mingling_core/src/build/pathf.rs b/mingling_core/src/build/pathf.rs
index 7f75c6b..97cf672 100644
--- a/mingling_core/src/build/pathf.rs
+++ b/mingling_core/src/build/pathf.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 #![allow(unused_imports)]
 
 pub use mingling_pathf::config::*;
diff --git a/mingling_core/src/comp.rs b/mingling_core/src/comp.rs
index f2e50c8..30b165a 100644
--- a/mingling_core/src/comp.rs
+++ b/mingling_core/src/comp.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 mod comp_ctx;
 mod flags;
 mod shell_ctx;
diff --git a/mingling_core/src/comp/comp_ctx.rs b/mingling_core/src/comp/comp_ctx.rs
index 6384909..f2b83e6 100644
--- a/mingling_core/src/comp/comp_ctx.rs
+++ b/mingling_core/src/comp/comp_ctx.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use crate::{COMPLETION_SUBCOMMAND, Program, ProgramCollect};
 
 impl<C> Program<C>
diff --git a/mingling_core/src/comp/flags.rs b/mingling_core/src/comp/flags.rs
index 0867122..6285570 100644
--- a/mingling_core/src/comp/flags.rs
+++ b/mingling_core/src/comp/flags.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use just_fmt::snake_case;
 
 /// Represents the shell environment for which the output format is intended.
diff --git a/mingling_core/src/comp/shell_ctx.rs b/mingling_core/src/comp/shell_ctx.rs
index 65ee9e2..78ccb87 100644
--- a/mingling_core/src/comp/shell_ctx.rs
+++ b/mingling_core/src/comp/shell_ctx.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 #![allow(deprecated)]
 
 use std::collections::HashSet;
diff --git a/mingling_core/src/comp/suggest.rs b/mingling_core/src/comp/suggest.rs
index 27b227f..7760340 100644
--- a/mingling_core/src/comp/suggest.rs
+++ b/mingling_core/src/comp/suggest.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 #![allow(deprecated)]
 
 use std::collections::BTreeSet;
diff --git a/mingling_core/src/debug.rs b/mingling_core/src/debug.rs
index 4865016..05d7deb 100644
--- a/mingling_core/src/debug.rs
+++ b/mingling_core/src/debug.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 #[macro_export]
 #[doc(hidden)]
 /// A macro that only executes the given expressions when the `debug` feature is enabled.
diff --git a/mingling_core/src/lib.rs b/mingling_core/src/lib.rs
index 9de1f00..0688c94 100644
--- a/mingling_core/src/lib.rs
+++ b/mingling_core/src/lib.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 #![deny(missing_docs)]
 //! Mingling Core
 //!
diff --git a/mingling_core/src/metadata.rs b/mingling_core/src/metadata.rs
index 329576c..339f615 100644
--- a/mingling_core/src/metadata.rs
+++ b/mingling_core/src/metadata.rs
@@ -1,2 +1,3 @@
+// Doc Not Optimize
 mod description;
 pub use description::*;
diff --git a/mingling_core/src/metadata/description.rs b/mingling_core/src/metadata/description.rs
index 48bf095..3d7b5fd 100644
--- a/mingling_core/src/metadata/description.rs
+++ b/mingling_core/src/metadata/description.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 /// Provides a description for any Grouped type.
 pub struct Description {
     desc: String,
diff --git a/mingling_core/src/private.rs b/mingling_core/src/private.rs
index 371ada2..2d5cb79 100644
--- a/mingling_core/src/private.rs
+++ b/mingling_core/src/private.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 /// Sealed trait for `StructuralData` — only implementable via derive macro.
 #[cfg(feature = "structural_renderer")]
 pub trait StructuralDataSealed<C>
diff --git a/mingling_core/src/program.rs b/mingling_core/src/program.rs
index be8d85c..3c4212c 100644
--- a/mingling_core/src/program.rs
+++ b/mingling_core/src/program.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 #[cfg(not(windows))]
 use std::env;
 
diff --git a/mingling_core/src/program/collection.rs b/mingling_core/src/program/collection.rs
index 6ec4a27..0a37106 100644
--- a/mingling_core/src/program/collection.rs
+++ b/mingling_core/src/program/collection.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 #[cfg(feature = "async")]
 use std::pin::Pin;
 
diff --git a/mingling_core/src/program/collection/mock.rs b/mingling_core/src/program/collection/mock.rs
index 52fbd17..ad8ba0a 100644
--- a/mingling_core/src/program/collection/mock.rs
+++ b/mingling_core/src/program/collection/mock.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 #[cfg(feature = "async")]
 use std::pin::Pin;
 
diff --git a/mingling_core/src/program/config.rs b/mingling_core/src/program/config.rs
index b098961..86b8c23 100644
--- a/mingling_core/src/program/config.rs
+++ b/mingling_core/src/program/config.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 /// Output mode for error messages
 #[derive(Debug, Clone, Copy, PartialEq, Eq)]
 pub enum ErrorOutput {
diff --git a/mingling_core/src/program/error.rs b/mingling_core/src/program/error.rs
index 0a5bfd0..dcec7ec 100644
--- a/mingling_core/src/program/error.rs
+++ b/mingling_core/src/program/error.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use std::any::Any;
 use std::fmt;
 
diff --git a/mingling_core/src/program/exec.rs b/mingling_core/src/program/exec.rs
index 5948cfe..923b47b 100644
--- a/mingling_core/src/program/exec.rs
+++ b/mingling_core/src/program/exec.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 #![allow(clippy::borrowed_box)]
 #![allow(clippy::too_many_lines)]
 
diff --git a/mingling_core/src/program/exec/error.rs b/mingling_core/src/program/exec/error.rs
index c8cb15a..188610e 100644
--- a/mingling_core/src/program/exec/error.rs
+++ b/mingling_core/src/program/exec/error.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use crate::error::{ChainProcessError, ProgramPanic};
 use std::fmt;
 
diff --git a/mingling_core/src/program/flag.rs b/mingling_core/src/program/flag.rs
index 81d83e6..834f01f 100644
--- a/mingling_core/src/program/flag.rs
+++ b/mingling_core/src/program/flag.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use crate::{Program, ProgramCollect};
 
 /// A wrapper for a collection of static string slices representing command-line flags or arguments.
diff --git a/mingling_core/src/program/flag/tests.rs b/mingling_core/src/program/flag/tests.rs
index 60f90eb..9d6dfcd 100644
--- a/mingling_core/src/program/flag/tests.rs
+++ b/mingling_core/src/program/flag/tests.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use crate::Flag;
 
 #[test]
diff --git a/mingling_core/src/program/hook.rs b/mingling_core/src/program/hook.rs
index 6f468b3..cb8e4e1 100644
--- a/mingling_core/src/program/hook.rs
+++ b/mingling_core/src/program/hook.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 #![allow(dead_code)]
 
 //! Program lifecycle hook system.
diff --git a/mingling_core/src/program/hook/control_unit.rs b/mingling_core/src/program/hook/control_unit.rs
index d71a203..47a3260 100644
--- a/mingling_core/src/program/hook/control_unit.rs
+++ b/mingling_core/src/program/hook/control_unit.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use crate::{AnyOutput, ChainProcess, NextProcess, ProgramCollect};
 
 /// Collection variants for program control instructions.
diff --git a/mingling_core/src/program/hook/hook_info.rs b/mingling_core/src/program/hook/hook_info.rs
index 060e368..768f652 100644
--- a/mingling_core/src/program/hook/hook_info.rs
+++ b/mingling_core/src/program/hook/hook_info.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use crate::{AnyOutput, ProgramCollect, RenderResult};
 
 /// Represents the data passed to `begin` hook.
diff --git a/mingling_core/src/program/once_exec.rs b/mingling_core/src/program/once_exec.rs
index fc48e6d..b1fba36 100644
--- a/mingling_core/src/program/once_exec.rs
+++ b/mingling_core/src/program/once_exec.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use crate::THIS_PROGRAM;
 use crate::{Program, ProgramCollect, RenderResult, error::ProgramExecuteError};
 
diff --git a/mingling_core/src/program/repl_exec.rs b/mingling_core/src/program/repl_exec.rs
index fe29d16..9d9be30 100644
--- a/mingling_core/src/program/repl_exec.rs
+++ b/mingling_core/src/program/repl_exec.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 #![allow(unused_imports)]
 #![allow(dead_code)]
 
diff --git a/mingling_core/src/program/repl_exec/res.rs b/mingling_core/src/program/repl_exec/res.rs
index 53e82d8..d16a58d 100644
--- a/mingling_core/src/program/repl_exec/res.rs
+++ b/mingling_core/src/program/repl_exec/res.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 /// Internal resource for the REPL runtime, used to control the REPL's state during execution
 #[derive(Default, Clone)]
 pub struct ResREPL {
diff --git a/mingling_core/src/program/repl_exec/splitter.rs b/mingling_core/src/program/repl_exec/splitter.rs
index c74a3f1..312ad73 100644
--- a/mingling_core/src/program/repl_exec/splitter.rs
+++ b/mingling_core/src/program/repl_exec/splitter.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 /// Wraps `split_input` to work with owned `String` inputs.
 pub fn split_input_string(input: &str) -> Vec<String> {
     split_input(input)
diff --git a/mingling_core/src/program/setup.rs b/mingling_core/src/program/setup.rs
index a8ff114..dfc3e1d 100644
--- a/mingling_core/src/program/setup.rs
+++ b/mingling_core/src/program/setup.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use crate::{ProgramCollect, program::Program};
 
 /// Trait for defining initialization/setup logic for a `Program`.
diff --git a/mingling_core/src/program/single_instance.rs b/mingling_core/src/program/single_instance.rs
index 083897d..3cd0010 100644
--- a/mingling_core/src/program/single_instance.rs
+++ b/mingling_core/src/program/single_instance.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use std::cell::UnsafeCell;
 use std::sync::atomic::{AtomicBool, Ordering};
 
diff --git a/mingling_core/src/program/string_vec.rs b/mingling_core/src/program/string_vec.rs
index a2eb433..7af4bec 100644
--- a/mingling_core/src/program/string_vec.rs
+++ b/mingling_core/src/program/string_vec.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 #[derive(Debug, Clone)]
 #[doc(hidden)]
 pub struct StringVec {
diff --git a/mingling_core/src/renderer.rs b/mingling_core/src/renderer.rs
index 6e67431..6a6fc7c 100644
--- a/mingling_core/src/renderer.rs
+++ b/mingling_core/src/renderer.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 pub mod render_result;
 #[cfg(feature = "structural_renderer")]
 pub mod structural;
diff --git a/mingling_core/src/renderer/render_result.rs b/mingling_core/src/renderer/render_result.rs
index a14bfda..4857a88 100644
--- a/mingling_core/src/renderer/render_result.rs
+++ b/mingling_core/src/renderer/render_result.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use std::{
     fmt::{Display, Formatter},
     io::Write,
diff --git a/mingling_core/src/renderer/structural.rs b/mingling_core/src/renderer/structural.rs
index 0449e72..aeb637f 100644
--- a/mingling_core/src/renderer/structural.rs
+++ b/mingling_core/src/renderer/structural.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use crate::{
     ProgramCollect, RenderResult, StructuralRendererSetting,
     renderer::structural::error::StructuralRendererSerializeError,
diff --git a/mingling_core/src/renderer/structural/error.rs b/mingling_core/src/renderer/structural/error.rs
index 2787dff..af886e1 100644
--- a/mingling_core/src/renderer/structural/error.rs
+++ b/mingling_core/src/renderer/structural/error.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 /// Represents an error that occurs during serialization of a structural renderer.
 ///
 /// This error stores a human-readable message describing what went wrong
diff --git a/mingling_core/src/renderer/structural/structural_data.rs b/mingling_core/src/renderer/structural/structural_data.rs
index 583808c..ab97e97 100644
--- a/mingling_core/src/renderer/structural/structural_data.rs
+++ b/mingling_core/src/renderer/structural/structural_data.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use serde::Serialize;
 
 use crate::ProgramCollect;
diff --git a/mingling_core/src/tester.rs b/mingling_core/src/tester.rs
index 152d000..c188cb1 100644
--- a/mingling_core/src/tester.rs
+++ b/mingling_core/src/tester.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 #[doc(hidden)]
 pub mod chain_process_tester;
 pub use crate::test::chain_process_tester::*;
diff --git a/mingling_core/src/tester/chain_process_tester.rs b/mingling_core/src/tester/chain_process_tester.rs
index ca809e4..821dac7 100644
--- a/mingling_core/src/tester/chain_process_tester.rs
+++ b/mingling_core/src/tester/chain_process_tester.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use std::fmt::Display;
 
 use crate::{ChainProcess, NextProcess, ProgramCollect};