Improve doc on Torrent.Drop

https://github.com/anacrolix/torrent/issues/73

diff --git a/t.go b/t.go
index e207a09a337c5d14b8923b6b79895a1fc165f037..c6d23f059f05255f629ebeac44aa8d0f748dda01 100644 (file)
--- a/t.go
+++ b/t.go
@@ -56,7 +56,9 @@ func (t *Torrent) NumPieces() int {
        return t.numPieces()
 }
 
-// Drop the torrent from the client, and close it.
+// Drop the torrent from the client, and close it. It's always safe to do
+// this. No data corruption can, or should occur to either the torrent's data,
+// or connected peers.
 func (t *Torrent) Drop() {
        t.cl.mu.Lock()
        t.cl.dropTorrent(t.infoHash)