From 6267da6acfb7130e82094445d1c2cb1cdb6812d5 Mon Sep 17 00:00:00 2001
From: Torprius <torrpriius@gmail.com>
Date: Mon, 25 Aug 2025 17:43:58 +0200
Subject: [PATCH] Update timeout.rs

---
 core/src/transport/timeout.rs | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

diff --git a/core/src/transport/timeout.rs b/core/src/transport/timeout.rs
index ce494216279..3f62cec8569 100644
--- a/core/src/transport/timeout.rs
+++ b/core/src/transport/timeout.rs
@@ -22,7 +22,23 @@
 //!
 //! The connection setup includes all protocol upgrades applied on the
 //! underlying `Transport`.
-// TODO: add example
+//!
+//! # Example
+//!
+//! ```no_run
+//! use std::time::Duration;
+//!
+//! use libp2p_core::{
+//!     transport::{timeout::TransportTimeout, ListenerId, MemoryTransport},
+//!     Transport as _,
+//! };
+//!
+//! let base = MemoryTransport::default();
+//! let mut timeout = TransportTimeout::new(base, Duration::from_secs(1));
+//!
+//! // Listen and dial as usual; the setup will be subject to timeouts.
+//! let _ = timeout.listen_on(ListenerId::next(), "/memory/0".parse().unwrap());
+//! ```
 
 use std::{
     error, fmt, io,