Fixed Doc comment (hopfully for the last time)

They are strange indeed.

src/error.rs

@@ -15,6 +15,9 @@
  * along with irc-stream.  If not, see <https://www.gnu.org/licenses/>.
  */ 
 
+//! Implements IrcStreamError, an error type 
+//! that wraps all possible error that are thrown by IrcStream.
+
 use std::{
 	error::Error,
 	fmt,
@@ -22,8 +25,6 @@ use std::{
 	str,
 };
 
-//! Implements IrcStreamError, an error type 
-//! that wraps all possible error that are thrown by IrcStream.
 /// A custom error type that wraps all error that IrcStream will throw.
 #[derive(Debug)]
 pub enum IrcStreamError {

src/lib.rs

@@ -15,14 +15,15 @@
  * along with irc-stream.  If not, see <https://www.gnu.org/licenses/>.
  */ 
 
+//! This crate provides the `IrcRead` and `IrcWrite` traits and 
+//! the IrcStream struct that implements them.
+
 pub mod error;
 
 pub use self::error::*;
 use std::io::{Read, Write};
 use irc_proto::message::Message;
 
-//! This crate provides the `IrcRead` and `IrcWrite` traits and 
-//! the IrcStream struct that implements them.
 /// A trait that mirrors std::io::Read;
 /// It requires the `read()` method that returns an IRC Message.
 /// The function may or may not block.