Add module and all-pub-things docs and deny missing docs

[rust-lightning] / src / ln / mod.rs

diff --git a/src/ln/mod.rs b/src/ln/mod.rs
index add8b4df1aa2e722dbac5ce577a840c74d2ff5a0..0f3b745443e378d5e53c77c26fc2f339a1693823 100644 (file)
--- a/src/ln/mod.rs
+++ b/src/ln/mod.rs
@@ -1,3 +1,12 @@
+//! High level lightning structs and impls live here.
+//! You probably want to create a channelmanager::ChannelManager, and a router::Router first.
+//! Then, you probably want to pass them both on to a peer_handler::PeerManager and use that to
+//! create/manage connections and call get_and_clear_pending_events after each action, handling
+//! them appropriately.
+//! When you want to open/close a channel or send a payment, call into your ChannelManager and when
+//! you want to learn things about the network topology (eg get a route for sending a payment),
+//! call into your Router.
+
 pub mod channelmanager;
 pub mod channelmonitor;
 pub mod msgs;
@@ -9,9 +18,5 @@ pub mod peer_channel_encryptor;
 #[cfg(not(feature = "fuzztarget"))]
 pub(crate) mod peer_channel_encryptor;
 
-#[cfg(feature = "fuzztarget")]
-pub mod channel;
-#[cfg(not(feature = "fuzztarget"))]
-pub(crate) mod channel;
-
+mod channel;
 mod chan_utils;