From: Ian Romanick Date: Wed, 6 Jun 2018 02:00:42 +0000 (-0700) Subject: nir: Document a couple instances of parent_instr X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=355868dbfc88313c0b0c59d3f038422ed6268255;p=mesa.git nir: Document a couple instances of parent_instr nir_ssa_def::parent_instr and nir_src::parent_instr have the same name, but they mean really different things. I choose to save the next person the hour+ that I just spent figuring that out. Even now that I know, I doubt I'd notice in code review that someone typed foo->parent_instr when they actually meant foo->ssa->parent_instr. v2: Minor wording tweak in nir_ssa_def::parent_instr. Suggested by Jason. Signed-off-by: Ian Romanick Reviewed-by: Jason Ekstrand --- diff --git a/src/compiler/nir/nir.h b/src/compiler/nir/nir.h index bb477742dc6..2858e1f2880 100644 --- a/src/compiler/nir/nir.h +++ b/src/compiler/nir/nir.h @@ -490,6 +490,7 @@ typedef struct nir_ssa_def { /** Index into the live_in and live_out bitfields */ unsigned live_index; + /** Instruction which produces this SSA value. */ nir_instr *parent_instr; /** set of nir_instrs where this register is used (read from) */ @@ -529,6 +530,7 @@ struct nir_if; typedef struct nir_src { union { + /** Instruction that consumes this value as a source. */ nir_instr *parent_instr; struct nir_if *parent_if; };