From f570b68ed107d5e835a71cf1194e2b82c496a387 Mon Sep 17 00:00:00 2001
From: Felix Lange <fjl@twurst.com>
Date: Thu, 29 Oct 2015 22:54:44 +0100
Subject: p2p/nat: add docs for discover

---
 p2p/nat/natupnp.go | 3 +++
 1 file changed, 3 insertions(+)

(limited to 'p2p')

diff --git a/p2p/nat/natupnp.go b/p2p/nat/natupnp.go
index c544fbcb6..890a35043 100644
--- a/p2p/nat/natupnp.go
+++ b/p2p/nat/natupnp.go
@@ -133,6 +133,9 @@ func discoverUPnP() Interface {
 	return nil
 }
 
+// finds devices matching the given target and calls matcher for all
+// advertised services of each device. The first non-nil service found
+// is sent into out. If no service matched, nil is sent.
 func discover(out chan<- *upnp, target string, matcher func(*goupnp.RootDevice, goupnp.ServiceClient) *upnp) {
 	devs, err := goupnp.DiscoverDevices(target)
 	if err != nil {
-- 
cgit v1.2.3