@@ -8,10 +8,13 @@ import llvmshims
88/// and provide a way to append to that sequence to build out its body.
99///
1010/// A LLVM function definition contains a list of basic blocks, starting with
11- /// a privileged first block called the "entry block", and proceeding its
12- /// terminating instruction to zero or more other basic blocks. The path the
11+ /// a privileged first block called the "entry block". After the entry blocks'
12+ /// terminating instruction come zero or more other basic blocks. The path the
1313/// flow of control can potentially take, from each block to its terminator
14- /// and back again, forms the "Control Flow Graph" (CFG) for the function.
14+ /// and on to other blocks, forms the "Control Flow Graph" (CFG) for the
15+ /// function. The nodes of the CFG are the basic blocks, and the edges are
16+ /// directed from the terminator instruction of one block to any number of
17+ /// potential target blocks.
1518///
1619/// Additional basic blocks may be created and appended to the function at
1720/// any time.
@@ -27,7 +30,7 @@ import llvmshims
2730/// let freestanding = BasicBlock(name: "freestanding")
2831/// fun.append(freestanding)
2932///
30- /// A LLVM function always has the type `FunctionType`. This type is used to
33+ /// An LLVM function always has the type `FunctionType`. This type is used to
3134/// determine the number and kind of parameters to the function as well as its
3235/// return value, if any. The parameter values, which would normally enter
3336/// the entry block, are instead attached to the function and are accessible
@@ -54,7 +57,7 @@ import llvmshims
5457/// Sections
5558/// ========
5659///
57- /// A function may optionally state the section in the object file the function
60+ /// A function may optionally state the section in the object file it
5861/// should reside in through the use of a metadata attachment. This can be
5962/// useful to satisfy target-specific data layout constraints, or to provide
6063/// some hints to optimizers and linkers. LLVMSwift provides a convenience
0 commit comments