[clang-tools-extra] r350584 - ReleaseNotes: Update with my clang-query contributions this cycle

Stephen Kelly via cfe-commits cfe-commits at lists.llvm.org
Mon Jan 7 16:09:34 PST 2019


Author: steveire
Date: Mon Jan  7 16:09:34 2019
New Revision: 350584

URL: http://llvm.org/viewvc/llvm-project?rev=350584&view=rev
Log:
ReleaseNotes: Update with my clang-query contributions this cycle

Modified:
    clang-tools-extra/trunk/docs/ReleaseNotes.rst

Modified: clang-tools-extra/trunk/docs/ReleaseNotes.rst
URL: http://llvm.org/viewvc/llvm-project/clang-tools-extra/trunk/docs/ReleaseNotes.rst?rev=350584&r1=350583&r2=350584&view=diff
==============================================================================
--- clang-tools-extra/trunk/docs/ReleaseNotes.rst (original)
+++ clang-tools-extra/trunk/docs/ReleaseNotes.rst Mon Jan  7 16:09:34 2019
@@ -57,7 +57,47 @@ The improvements are...
 Improvements to clang-query
 ---------------------------
 
-The improvements are...
+- A new command line parameter ``--preload`` was added to
+  run commands from a file and then start the interactive interpreter.
+
+- The command ``q`` can was added as an alias for ``quit`` to exit the
+  ``clang-query`` interpreter.
+
+- It is now possible to bind to named values (the result of ``let``
+  expressions). For example:
+
+  .. code-block:: none
+
+    let fn functionDecl()
+    match fn.bind("foo")
+
+- It is now possible to write comments in ``clang-query`` code. This
+  is primarily useful when using script-mode. Comments are all content
+  following the ``#`` character on a line:
+
+  .. code-block:: none
+
+    # This is a comment
+    match fn.bind("foo") # This is a trailing comment
+
+- The new ``set print-matcher true`` command now causes ``clang-query`` to
+  print the evaluated matcher together with the resulting bindings.
+
+- A new output mode ``detailed-ast`` was added to ``clang-query``. The
+  existing ``dump`` output mode is now a deprecated alias
+  for ``detailed-ast``
+
+- Output modes can now be enabled or disabled non-exclusively.  For example,
+
+  .. code-block:: none
+
+    # Enable detailed-ast without disabling other output, such as diag
+    enable output detailed-ast
+    m functionDecl()
+
+    # Disable detailed-ast only
+    disable output detailed-ast
+    m functionDecl()
 
 Improvements to clang-rename
 ----------------------------




More information about the cfe-commits mailing list