[PATCH] D65164: Define some basic terminology around loops in our documentation

[Philip Reames via Phabricator via llvm-commits]

reames created this revision.
reames added reviewers: sanjoy, atrick, apilipenko, skatkov, Meinersbur, Whitney, kbarton.
Herald added subscribers: bollu, mcrosier.
Herald added a project: LLVM.

I've noticed a lot of confusion around this area recently with key terms being misused in a number of threads.  To help reign that in, let's go ahead and document the current terminology and meaning thereof.

Note that I'm deliberately only documenting current meaning.  If we wish to change or extend at a later point, we can do so then.  It is explicitly out of scope for this review.

My hope is to grow this over time into a broader discussion of canonical loop forms - yes, there are more than one ... many more than one - but for the moment, simply having the key terminology is a good stopping place.


Repository:
  rL LLVM

https://reviews.llvm.org/D65164

Files:
  docs/LoopTerminology.rst
  include/llvm/Analysis/LoopInfo.h

-------------- next part --------------
A non-text attachment was scrubbed...
Name: D65164.211351.patch
Type: text/x-patch
Size: 4823 bytes
Desc: not available
URL: <http://lists.llvm.org/pipermail/llvm-commits/attachments/20190723/d402e727/attachment.bin>