From 92ea5a1c2e0b7ddaa102d6b602d180e84964c3be Mon Sep 17 00:00:00 2001 From: Jokler Date: Fri, 15 Dec 2017 19:29:40 +0100 Subject: Adjust documentation --- src/lib.rs | 4 +++- src/plugin.rs | 4 +++- src/plugins/mod.rs | 1 + 3 files changed, 7 insertions(+), 2 deletions(-) diff --git a/src/lib.rs b/src/lib.rs index d34a728..5d15802 100644 --- a/src/lib.rs +++ b/src/lib.rs @@ -56,6 +56,7 @@ pub use irc::error::Error as IrcError; use plugin::*; +/// The bot which contains the main logic. #[derive(Default)] pub struct Bot { plugins: ThreadedPlugins, @@ -77,7 +78,8 @@ impl Bot { Bot { plugins: ThreadedPlugins::new() } } - /// Add plugins which should evaluate incoming messages from IRC. + /// Adds the plugin. + /// These plugins will be used to evaluate incoming messages from IRC. /// /// # Examples /// ``` diff --git a/src/plugin.rs b/src/plugin.rs index d2338f9..d14c129 100644 --- a/src/plugin.rs +++ b/src/plugin.rs @@ -1,3 +1,4 @@ +//! Definitions required for every `Plugin` use std::fmt; use irc::client::prelude::*; @@ -14,7 +15,8 @@ pub trait Plugin: PluginName + Send + Sync + fmt::Debug { fn command(&self, server: &IrcServer, command: PluginCommand) -> Result<(), IrcError>; } -/// `PluginName` is required by `Plugin`. +/// `PluginName` is required by `Plugin`. +/// /// To implement it simply add `#[derive(PluginName)]` /// above the definition of the struct. /// diff --git a/src/plugins/mod.rs b/src/plugins/mod.rs index 3eb7db4..e8c4622 100644 --- a/src/plugins/mod.rs +++ b/src/plugins/mod.rs @@ -1,3 +1,4 @@ +//! Collection of plugins included mod help; mod url; mod emoji; -- cgit v1.2.3-70-g09d2