[Lldb-commits] [lldb] [LLDB] Add user documentation for DIL. (PR #228275)

[via lldb-commits]

================
@@ -0,0 +1,305 @@
+# DIL: The Data Inspection Language
+
+This page explains the Data Inspection Language (DIL) in LLDB. Most of this
+document is intended for LLDB users, from both the command line and through
+IDEs (Integrated Development Environments) via lldb-dap. At the end there is
+some additional information for LLDB developers.
+
+## Background: What is DIL and why did we implement it?
+
+In the context of LLDB, an **expression path** is the structured syntax used to
+navigate and access specific fields, members, or elements within a data
+structure starting from a root variable. A **path expression** is an expression
+consisting entirely of such structured syntax (and starting from a root
+variable).
+
+LLDB has always had two modes for accessing values in your program: path
+expressions, that commands like `frame variable` could understand and interpret;
+and "other" expressions, which could contain path expressions, but usually also
----------------
jimingham wrote:

Would that get confusing since DIL has a `simple` mode?

https://github.com/llvm/llvm-project/pull/228275