From e73a9343870f3cb08369d3a253d0f913de78bb31 Mon Sep 17 00:00:00 2001
From: Ed Page <eopage@gmail.com>
Date: Fri, 15 Apr 2022 12:49:02 -0500
Subject: [PATCH] docs(lex): Clarify context-sensitive lexing

---
 clap_lex/src/lib.rs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/clap_lex/src/lib.rs b/clap_lex/src/lib.rs
index c9c8b3d70497..0d4abde93207 100644
--- 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
 //!