diff --git a/grace.go b/grace.go
index cf5b703..d9a9254 100644
--- a/grace.go
+++ b/grace.go
@@ -42,6 +42,9 @@ type Listener interface {
 
 	// Will indicate that a Close is requested preventing further Accept. It will
 	// also wait for the active connections to be terminated before returning.
+	// Note, this won't actually do the close, and is provided as part of the
+	// public API for cases where the socket must not be closed (such as systemd
+	// activation).
 	CloseRequest()
 
 	// Will return the underlying file representing this Listener.
diff --git a/readme.md b/readme.md
index edb7f2b..11289cf 100644
--- a/readme.md
+++ b/readme.md
@@ -9,7 +9,7 @@ Demo HTTP Server with graceful termination and restart:
 https://github.com/daaku/go.grace/blob/master/gracedemo/demo.go
 
 http level graceful termination and restart:
-http://go.pkgdoc.org/github.com/daaku/go.grace/gracehttp
+http://godoc.org/github.com/daaku/go.grace/gracehttp
 
 net.Listener level graceful termination and restart:
-http://go.pkgdoc.org/github.com/daaku/go.grace
+http://godoc.org/github.com/daaku/go.grace