From: Matt Joiner <anacrolix@gmail.com>
Date: Thu, 1 Feb 2018 03:46:48 +0000 (+1100)
Subject: Code comments
X-Git-Tag: v1.0.0~237
X-Git-Url: http://www.git.stargrave.org/?a=commitdiff_plain;h=3217c5012a868220cd43e8f9ca5348050a479ad6;p=btrtrc.git

Code comments
---

diff --git a/connection.go b/connection.go
index aea9d49d..29d63a56 100644
--- a/connection.go
+++ b/connection.go
@@ -485,6 +485,7 @@ func (cn *connection) Bitfield(haves []bool) {
 	cn.sentHaves = append([]bool(nil), haves...)
 }
 
+// Determines interest and requests to send to a connected peer.
 func nextRequestState(
 	networkingEnabled bool,
 	currentRequests map[request]struct{},
@@ -615,6 +616,7 @@ func (cn *connection) desiredRequestState() (bool, []request, bool) {
 
 func undirtiedChunks(piece int, t *Torrent, f func(chunkSpec) bool) bool {
 	chunkIndices := t.pieces[piece].undirtiedChunkIndices().ToSortedSlice()
+	// TODO: Use "math/rand".Shuffle >= Go 1.10
 	return iter.ForPerm(len(chunkIndices), func(i int) bool {
 		return f(t.chunkIndexSpec(chunkIndices[i], piece))
 	})