doc: add note on tls connection meta data methods

DaftMonk · jasnell · commit ebab03f268fa · 2015-12-23T08:38:33.000-08:00
PR-URL: #3746 Reviewed-By: Ben Noordhuis <info@bnoordhuis.nl>
diff --git a/doc/api/tls.markdown b/doc/api/tls.markdown
@@ -735,6 +735,10 @@ of written data and all required TLS negotiation.
 This instance implements a duplex [Stream][] interfaces.  It has all the
 common stream methods and events.
 
+Methods that return TLS connection meta data (e.g.
+[getPeerCertificate](#tlssocketgetpeercertificate-detailed-))
+will only return data while the connection is open.
+
 ### Event: 'secureConnect'
 
 This event is emitted after a new connection has been successfully handshaked.
