Re: [PATCH v2 07/19] locking/lockdep: Update obsolete struct field description

From: Bart Van Assche
Date: Tue Mar 19 2019 - 12:35:54 EST

On Mon, 2019-03-18 at 16:57 +-0800, Yuyang Du wrote:
+AD4 struct lock+AF8-chain +AHs
+AD4 - /+ACo see BUILD+AF8-BUG+AF8-ON()s in lookup+AF8-chain+AF8-cache() +ACo-/
+AD4 +- /+ACo
+AD4 +- +ACo irq+AF8-context: the same as irq+AF8-context in held+AF8-lock below
+AD4 +- +ACo depth: the number of held locks in this chain
+AD4 +- +ACo base: the index in chain+AF8-hlocks for this chain
+AD4 +- +ACo-/
+AD4 unsigned int irq+AF8-context : 2,
+AD4 depth : 6,
+AD4 base : 24+ADs

Have you considered to use the kernel-doc style for documenting these
structure members?