misc. doc updates and fixes

Cargo.toml

@@ -530,7 +530,7 @@ dep_unicode_width = ["dep:unicode-width"]
 dep_wide = ["dep:wide"]
 
 
-[dependencies] # 20 (2 required, 18 optional)
+[dependencies] # 20 (2 required, 17 optional)
 # https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html
 # ==============================================================================
 # Links to each crate's crates.io page are provided alongside the entries,

src/code/macros/cdbg.rs

@@ -3,7 +3,7 @@
 //! Custom debug macro.
 //
 
-/// *`c`ustomizable [`dbg!`]* macro.
+/// *`c`ustomizable [`dbg!`]* macro. Concise by default
 ///
 /// - By default uses `{:?}` instead of `{:#?}` for formatting.
 /// - By default doesn't show the location (file, line and column).

src/code/macros/mod.rs

@@ -2,6 +2,10 @@
 //
 //! Utility macros
 //
+// # Documentation for declarative macros
+// - [The Little Book of Rust Macros](https://veykril.github.io/tlborm/decl-macros.html)
+// - [Macros By Example](https://doc.rust-lang.org/reference/macros-by-example.html)
+// - [Specification](https://doc.rust-lang.org/reference/macro-ambiguity.html)
 
 // private
 mod _doc;

src/code/reexports.rs

@@ -89,7 +89,7 @@ doc: "An attempted conversion that consumes self, which may or may not be expens
 
 // functions
 reexport! { rust: core::convert,
-doc: "The identity function.", identity }
+doc: "The identity function. Just returns back its input.", identity }
 
 /* `core::default` re-exports */
 
@@ -100,7 +100,7 @@ pub use core::default::Default;
 /* `core::hint` re-exports */
 
 reexport! { rust: core::hint,
-doc: "Makes a *soundness* promise to the compiler that `cond` holds.", assert_unchecked }
+doc: "Makes a *soundness* promise to the compiler that the `cond`ition holds.", assert_unchecked }
 reexport! { rust: core::hint,
 doc: "Hints the compiler to be maximally pessimistic about what black_box could do.", black_box }
 reexport! { rust: core::hint,

src/error/reexports.rs

@@ -5,7 +5,7 @@
 
 #![allow(unused_imports)]
 
-use crate::code::reexport;
+use crate::reexport;
 
 /* from other modules */