- // The events are bytes read from connections. The burst must be bigger
- // than the largest Read performed on a Conn minus one. This is likely to
- // be the larger of the main read loop buffer (~4096), and the requested
- // chunk size (~16KiB).
+ // Rate limits all reads from connections to peers. Each limiter token
+ // represents one byte. The Limiter's burst must be bigger than the
+ // largest Read performed on a the underlying rate-limiting io.Reader
+ // minus one. This is likely to be the larger of the main read loop buffer
+ // (~4096), and the requested chunk size (~16KiB, see
+ // TorrentSpec.ChunkSize).