gdb/dwarf: add doc for cutu_reader::is_dummy

Change-Id: Ifb80557187c12822bdea7ad400c32c3dce968a7f
Approved-By: Tom Tromey <tom@tromey.com>

diff --git a/gdb/dwarf2/read.h b/gdb/dwarf2/read.h
index b6ff433978c3bd18a23e94152ad77b6a8cfcf9a8..d6d119e038dc2532c43d9ff0cd0a306943e202af 100644 (file)
--- a/gdb/dwarf2/read.h
+++ b/gdb/dwarf2/read.h
@@ -945,6 +945,11 @@ public:
 
   cutu_reader (cutu_reader &&) = default;
 
+  /* Return true if either:
+
+      - the unit is empty (just a header without any DIE)
+      - the unit is a partial unit and this cutu_reader was built with SKIP
+       PARTIAL true.  */
   bool is_dummy () const { return m_dummy_p; }
 
   dwarf2_cu *cu () const { return m_cu; }