mention that granting used to be matching
authorRalf Jung <post@ralfj.de>
Tue, 30 Apr 2019 21:25:23 +0000 (23:25 +0200)
committerRalf Jung <post@ralfj.de>
Tue, 30 Apr 2019 21:25:23 +0000 (23:25 +0200)
personal/_posts/2019-04-30-stacked-borrows-2.md

index 79518998508d773ae34eb359bf74846ea1d218f6..8436bff12d820f64378f102163771c9e11172ea4 100644 (file)
@@ -88,6 +88,7 @@ For each affected location, we go through two steps: first we try to find the *g
 **Finding the granting item.**
 To find the granting item, we traverse the borrow stack top-to-bottom and search for an item that has the same tag.
 If this is a write access, we go on looking until we find an item with the right tag whose permission is `SharedReadWrite` or `Unique`---we do not consider items with `SharedReadOnly` permission to grant a write access.
 **Finding the granting item.**
 To find the granting item, we traverse the borrow stack top-to-bottom and search for an item that has the same tag.
 If this is a write access, we go on looking until we find an item with the right tag whose permission is `SharedReadWrite` or `Unique`---we do not consider items with `SharedReadOnly` permission to grant a write access.
+This is the item that grants pointers tagged `tag` the permission to perform the given access, hence the name (the same concept used to be called "matching item" in Stacked Borrows 1).
 Once we found the granting item, we remember its position in the stack; that will be important for the second step.
 If no granting item can be found, the access causes undefined behavior.
 
 Once we found the granting item, we remember its position in the stack; that will be important for the second step.
 If no granting item can be found, the access causes undefined behavior.