libp2p: identify replaces addresses

1 files changed, 3 insertions, 1 deletions

diff --git a/src/transport/libp2p/mod.rs b/src/transport/libp2p/mod.rs
index 06e9e15..b2a3da7 100644
--- a/src/transport/libp2p/mod.rs
+++ b/src/transport/libp2p/mod.rs
@@ -11,7 +11,9 @@
 //! (`swarm_config`): opening a stream costs no round trip.
 //!
 //! Connected peers tell each other where they listen (libp2p's identify protocol), so a
-//! node learns the addresses of peers that dialled it. A node publishes where it can be
+//! node learns the addresses of peers that dialled it. While connected, a peer's
+//! identify is all a node goes by for its direct addresses (`Book::identified`): those
+//! it no longer has, or no longer publishes, are forgotten, whoever still names them. A node publishes where it can be
 //! reached (`local_addresses`): the addresses it announces (`--libp2p-announce`, e.g. a
 //! public address forwarded to it), or else those it listens on, loopback left out.
 //!