docs(lex): Clarify context-sensitive lexing

clap-rs · Apr 15, 2022 · 530db32 · 530db32
1 parent 687d361
commit 530db32
Showing 1 changed file with 3 additions and 2 deletions.
diff --git a/clap_lex/src/lib.rs b/clap_lex/src/lib.rs
@@ -1,7 +1,8 @@
 //! Minimal, flexible command-line parser
 //!
-//! As opposed to a declarative parser, this processes arguments as a stream.  The caller
-//! decides when to treat an argument as a flag or value.
+//! As opposed to a declarative parser, this processes arguments as a stream of tokens.  As lexing
+//! a command-line is not context-free, we rely on the caller to decide how to interpret the
+//! arguments.
 //!
 //! # Examples
 //!