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.
---
 arg_picker/src/arg.rs                        | 1 +
 arg_picker/src/builtin.rs                    | 1 +
 arg_picker/src/builtin/pick_bool.rs          | 1 +
 arg_picker/src/builtin/pick_flag.rs          | 1 +
 arg_picker/src/builtin/pick_ip_attr.rs       | 1 +
 arg_picker/src/builtin/pick_numbers.rs       | 1 +
 arg_picker/src/builtin/pick_pathbuf.rs       | 1 +
 arg_picker/src/builtin/pick_paths.rs         | 1 +
 arg_picker/src/builtin/pick_picker_args.rs   | 1 +
 arg_picker/src/builtin/pick_socket_attr.rs   | 1 +
 arg_picker/src/builtin/pick_string.rs        | 1 +
 arg_picker/src/constants.rs                  | 1 +
 arg_picker/src/infos.rs                      | 1 +
 arg_picker/src/lib.rs                        | 1 +
 arg_picker/src/parselib.rs                   | 1 +
 arg_picker/src/parselib/arg_matcher.rs       | 1 +
 arg_picker/src/parselib/flag_matcher.rs      | 1 +
 arg_picker/src/parselib/multi_arg_matcher.rs | 1 +
 arg_picker/src/parselib/pos_matcher.rs       | 1 +
 arg_picker/src/parselib/single_matcher.rs    | 1 +
 arg_picker/src/parselib/style.rs             | 1 +
 arg_picker/src/parselib/utils.rs             | 1 +
 arg_picker/src/pickable.rs                   | 1 +
 arg_picker/src/pickable/multi_pickable.rs    | 1 +
 arg_picker/src/pickable/single_pickable.rs   | 1 +
 arg_picker/src/picker.rs                     | 1 +
 arg_picker/src/picker/parse.rs               | 1 +
 arg_picker/src/picker/patterns.rs            | 1 +
 arg_picker/src/picker/result.rs              | 1 +
 arg_picker/src/value.rs                      | 1 +
 arg_picker/src/value/flag.rs                 | 1 +
 arg_picker/src/value/paths.rs                | 1 +
 arg_picker/src/value/vec_until.rs            | 1 +
 33 files changed, 33 insertions(+)

(limited to 'arg_picker')

diff --git a/arg_picker/src/arg.rs b/arg_picker/src/arg.rs
index c36fba4..6fad6c7 100644
--- a/arg_picker/src/arg.rs
+++ b/arg_picker/src/arg.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use crate::{Pickable, PickerArgInfo, parselib::ParserStyle};
 use std::marker::PhantomData;
 
diff --git a/arg_picker/src/builtin.rs b/arg_picker/src/builtin.rs
index 76c0645..0053631 100644
--- a/arg_picker/src/builtin.rs
+++ b/arg_picker/src/builtin.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 mod pick_bool;
 mod pick_flag;
 mod pick_ip_attr;
diff --git a/arg_picker/src/builtin/pick_bool.rs b/arg_picker/src/builtin/pick_bool.rs
index ccc4424..e508c7e 100644
--- a/arg_picker/src/builtin/pick_bool.rs
+++ b/arg_picker/src/builtin/pick_bool.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use crate::parselib::{FlagMatcher, Matcher};
 use crate::pickable_needed::*;
 
diff --git a/arg_picker/src/builtin/pick_flag.rs b/arg_picker/src/builtin/pick_flag.rs
index 8afc0fc..15b13a3 100644
--- a/arg_picker/src/builtin/pick_flag.rs
+++ b/arg_picker/src/builtin/pick_flag.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use crate::parselib::{FlagMatcher, Matcher};
 use crate::pickable_needed::*;
 use crate::value::Flag;
diff --git a/arg_picker/src/builtin/pick_ip_attr.rs b/arg_picker/src/builtin/pick_ip_attr.rs
index 57ac80e..cf32426 100644
--- a/arg_picker/src/builtin/pick_ip_attr.rs
+++ b/arg_picker/src/builtin/pick_ip_attr.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use std::net::{IpAddr, Ipv4Addr, Ipv6Addr};
 
 use crate::SinglePickable;
diff --git a/arg_picker/src/builtin/pick_numbers.rs b/arg_picker/src/builtin/pick_numbers.rs
index 6cbd4fc..3a8f380 100644
--- a/arg_picker/src/builtin/pick_numbers.rs
+++ b/arg_picker/src/builtin/pick_numbers.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use crate::{BoundaryCheck, SinglePickable, pickable_needed::*};
 
 macro_rules! impl_single_pickable_num {
diff --git a/arg_picker/src/builtin/pick_pathbuf.rs b/arg_picker/src/builtin/pick_pathbuf.rs
index 2b48e3d..ec2cae1 100644
--- a/arg_picker/src/builtin/pick_pathbuf.rs
+++ b/arg_picker/src/builtin/pick_pathbuf.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use std::path::PathBuf;
 
 use crate::{
diff --git a/arg_picker/src/builtin/pick_paths.rs b/arg_picker/src/builtin/pick_paths.rs
index 954464b..d5edc65 100644
--- a/arg_picker/src/builtin/pick_paths.rs
+++ b/arg_picker/src/builtin/pick_paths.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use std::{
     fs,
     path::{Path, PathBuf},
diff --git a/arg_picker/src/builtin/pick_picker_args.rs b/arg_picker/src/builtin/pick_picker_args.rs
index 618960f..ea72ef1 100644
--- a/arg_picker/src/builtin/pick_picker_args.rs
+++ b/arg_picker/src/builtin/pick_picker_args.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use crate::{PickerArgResult::Parsed, PickerArgs, parselib::build_masked_args, pickable_needed::*};
 
 impl<'a> Pickable<'a> for PickerArgs<'a> {
diff --git a/arg_picker/src/builtin/pick_socket_attr.rs b/arg_picker/src/builtin/pick_socket_attr.rs
index ba9a410..c227b2b 100644
--- a/arg_picker/src/builtin/pick_socket_attr.rs
+++ b/arg_picker/src/builtin/pick_socket_attr.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use std::net::{SocketAddr, SocketAddrV4, SocketAddrV6};
 
 use crate::SinglePickable;
diff --git a/arg_picker/src/builtin/pick_string.rs b/arg_picker/src/builtin/pick_string.rs
index c7bdd4a..0a08693 100644
--- a/arg_picker/src/builtin/pick_string.rs
+++ b/arg_picker/src/builtin/pick_string.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use crate::PickerArgResult::NotFound;
 use crate::{SinglePickable, pickable_needed::*};
 
diff --git a/arg_picker/src/constants.rs b/arg_picker/src/constants.rs
index 39250f8..0dcdc45 100644
--- a/arg_picker/src/constants.rs
+++ b/arg_picker/src/constants.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use std::marker::PhantomData;
 
 use crate::{PickerArg, PickerArgs};
diff --git a/arg_picker/src/infos.rs b/arg_picker/src/infos.rs
index 08b2be7..a564687 100644
--- a/arg_picker/src/infos.rs
+++ b/arg_picker/src/infos.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use crate::{Pickable, PickerArg, parselib::ParserStyle};
 
 /// Represents the result of parsing or looking up a value.
diff --git a/arg_picker/src/lib.rs b/arg_picker/src/lib.rs
index 06ae959..1de67a3 100644
--- a/arg_picker/src/lib.rs
+++ b/arg_picker/src/lib.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 #![doc = include_str!("../README.md")]
 #![deny(missing_docs)]
 #![deny(clippy::pedantic)]
diff --git a/arg_picker/src/parselib.rs b/arg_picker/src/parselib.rs
index edb03bb..8e5faae 100644
--- a/arg_picker/src/parselib.rs
+++ b/arg_picker/src/parselib.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 mod flag_matcher;
 pub use flag_matcher::*;
 
diff --git a/arg_picker/src/parselib/arg_matcher.rs b/arg_picker/src/parselib/arg_matcher.rs
index d26f6fb..24785d9 100644
--- a/arg_picker/src/parselib/arg_matcher.rs
+++ b/arg_picker/src/parselib/arg_matcher.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use crate::{
     matcher_needed::*,
     parselib::{build_possible_flags, seek_end_of_options},
diff --git a/arg_picker/src/parselib/flag_matcher.rs b/arg_picker/src/parselib/flag_matcher.rs
index 2484cc9..339b1d8 100644
--- a/arg_picker/src/parselib/flag_matcher.rs
+++ b/arg_picker/src/parselib/flag_matcher.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use crate::{
     matcher_needed::*,
     parselib::{build_possible_flags, get_seeked_first, multi_seek_eq, seek_end_of_options},
diff --git a/arg_picker/src/parselib/multi_arg_matcher.rs b/arg_picker/src/parselib/multi_arg_matcher.rs
index 6791121..a251470 100644
--- a/arg_picker/src/parselib/multi_arg_matcher.rs
+++ b/arg_picker/src/parselib/multi_arg_matcher.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use crate::{
     matcher_needed::*,
     parselib::{build_possible_flags, seek_end_of_options},
diff --git a/arg_picker/src/parselib/pos_matcher.rs b/arg_picker/src/parselib/pos_matcher.rs
index 96aceb3..a37c0df 100644
--- a/arg_picker/src/parselib/pos_matcher.rs
+++ b/arg_picker/src/parselib/pos_matcher.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use crate::{matcher_needed::*, parselib::seek_end_of_options};
 
 /// `PositionalMatcher` matches positional arguments — values not associated
diff --git a/arg_picker/src/parselib/single_matcher.rs b/arg_picker/src/parselib/single_matcher.rs
index d7cf6a4..b29513a 100644
--- a/arg_picker/src/parselib/single_matcher.rs
+++ b/arg_picker/src/parselib/single_matcher.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use crate::TagPhaseContext;
 use crate::parselib::{ArgMatcher, Matcher, ParserStyle, PositionalMatcher};
 
diff --git a/arg_picker/src/parselib/style.rs b/arg_picker/src/parselib/style.rs
index 9f7b38f..9b55158 100644
--- a/arg_picker/src/parselib/style.rs
+++ b/arg_picker/src/parselib/style.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use std::sync::OnceLock;
 use std::sync::atomic::{AtomicBool, Ordering};
 
diff --git a/arg_picker/src/parselib/utils.rs b/arg_picker/src/parselib/utils.rs
index dc4e091..97f64df 100644
--- a/arg_picker/src/parselib/utils.rs
+++ b/arg_picker/src/parselib/utils.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use crate::{
     PickerArgInfo,
     parselib::{MaskedArg, ParserStyle},
diff --git a/arg_picker/src/pickable.rs b/arg_picker/src/pickable.rs
index 758ae9a..014bbc2 100644
--- a/arg_picker/src/pickable.rs
+++ b/arg_picker/src/pickable.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use crate::{PickerArg, PickerArgAttr, PickerArgInfo, PickerArgResult, PickerArgs};
 
 mod single_pickable;
diff --git a/arg_picker/src/pickable/multi_pickable.rs b/arg_picker/src/pickable/multi_pickable.rs
index c5cd810..81d1571 100644
--- a/arg_picker/src/pickable/multi_pickable.rs
+++ b/arg_picker/src/pickable/multi_pickable.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use crate::{
     Pickable, PickerArg, PickerArgAttr, PickerArgResult, SinglePickable, TagPhaseContext,
     matcher_needed::Matcher,
diff --git a/arg_picker/src/pickable/single_pickable.rs b/arg_picker/src/pickable/single_pickable.rs
index 8a5b3e6..d916bcc 100644
--- a/arg_picker/src/pickable/single_pickable.rs
+++ b/arg_picker/src/pickable/single_pickable.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use crate::{Pickable, PickerArg, PickerArgAttr, PickerArgResult, TagPhaseContext};
 
 /// `SinglePickable` trait defines how to parse a type from a single command-line argument.
diff --git a/arg_picker/src/picker.rs b/arg_picker/src/picker.rs
index a7f0dfb..e8256ce 100644
--- a/arg_picker/src/picker.rs
+++ b/arg_picker/src/picker.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use std::{marker::PhantomData, ops::Index};
 
 mod parse;
diff --git a/arg_picker/src/picker/parse.rs b/arg_picker/src/picker/parse.rs
index 4a959e3..9d973f2 100644
--- a/arg_picker/src/picker/parse.rs
+++ b/arg_picker/src/picker/parse.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 // --------------------------------------------------------------------------------------------
 // I have to say, the code generated by this `internal_repeat!` macro is really UGLY.
 //
diff --git a/arg_picker/src/picker/patterns.rs b/arg_picker/src/picker/patterns.rs
index 7058d47..75b780d 100644
--- a/arg_picker/src/picker/patterns.rs
+++ b/arg_picker/src/picker/patterns.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use arg_picker_macros::internal_repeat;
 
 use crate::{Pickable, PickerArg, PickerArgResult, PickerArgs};
diff --git a/arg_picker/src/picker/result.rs b/arg_picker/src/picker/result.rs
index f13f52e..32c81cd 100644
--- a/arg_picker/src/picker/result.rs
+++ b/arg_picker/src/picker/result.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 #![allow(clippy::type_complexity)] // Aha, Type Gymnastics!
 
 use arg_picker_macros::internal_repeat;
diff --git a/arg_picker/src/value.rs b/arg_picker/src/value.rs
index 04d3e01..fc23f3d 100644
--- a/arg_picker/src/value.rs
+++ b/arg_picker/src/value.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 mod flag;
 pub use flag::*;
 
diff --git a/arg_picker/src/value/flag.rs b/arg_picker/src/value/flag.rs
index 6449d65..9a9e058 100644
--- a/arg_picker/src/value/flag.rs
+++ b/arg_picker/src/value/flag.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use std::{
     fmt::{Debug, Display},
     ops::{Deref, Not},
diff --git a/arg_picker/src/value/paths.rs b/arg_picker/src/value/paths.rs
index d64a09f..83f262d 100644
--- a/arg_picker/src/value/paths.rs
+++ b/arg_picker/src/value/paths.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use std::{
     ops::{Deref, DerefMut},
     path::{Path, PathBuf},
diff --git a/arg_picker/src/value/vec_until.rs b/arg_picker/src/value/vec_until.rs
index 6394cbf..0f7fede 100644
--- a/arg_picker/src/value/vec_until.rs
+++ b/arg_picker/src/value/vec_until.rs
@@ -1,3 +1,4 @@
+// Doc Not Optimize
 use std::marker::PhantomData;
 use std::ops::{Deref, DerefMut};
 
-- 
cgit