p2p/nat: add docs for discover

fjl · fjl · commit f570b68ed107 · 2015-10-29T22:54:44.000+01:00
diff --git 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 {

Original file line number	Diff line number	Diff line change
`@@ -133,6 +133,9 @@ func discoverUPnP() Interface {`
`133`	`133`	`return nil`
`134`	`134`	`}`
`135`	`135`
	`136`	`+// finds devices matching the given target and calls matcher for all`
	`137`	`+// advertised services of each device. The first non-nil service found`
	`138`	`+// is sent into out. If no service matched, nil is sent.`
`136`	`139`	`func discover(out chan<- upnp, target string, matcher func(goupnp.RootDevice, goupnp.ServiceClient) *upnp) {`
`137`	`140`	`devs, err := goupnp.DiscoverDevices(target)`
`138`	`141`	`if err != nil {`