Started cleaning up some of the lints and warnings

Cargo.toml

@@ -43,7 +43,6 @@ ws = { version = "0.7", optional = true}
 # Tests
 [dev-dependencies]
 tempdir = "0.3.4"
-pretty_assertions = "0.2.1"
 
 [build-dependencies]
 error-chain = "0.11"

src/lib.rs

@@ -87,9 +87,6 @@ extern crate serde;
 extern crate serde_json;
 extern crate tempdir;
 
-#[cfg(test)]
-#[macro_use]
-extern crate pretty_assertions;
 #[cfg(test)]
 extern crate tempdir;
 

src/loader/book.rs

@@ -122,6 +122,13 @@ fn load_chapter<P: AsRef<Path>>(link: &Link, src_dir: P) -> Result<Chapter> {
 }
 
 /// A depth-first iterator over the items in a book.
+///
+/// # Note
+///
+/// This struct shouldn't be created directly, instead prefer the
+/// [`Book::iter()`] method.
+///
+/// [`Book::iter()`]: struct.Book.html#method.iter
 pub struct BookItems<'a> {
     items: VecDeque<&'a BookItem>,
 }
@@ -239,7 +246,7 @@ And here is some more text.
 
     #[test]
     fn load_a_book_with_a_single_chapter() {
-        let (link, temp) = dummy_link();
+        let (link, _temp) = dummy_link();
         let summary = Summary {
             numbered_chapters: vec![SummaryItem::Link(link)],
             ..Default::default()

src/loader/mod.rs

@@ -18,7 +18,7 @@
 
 #![deny(missing_docs)]
 
-use std::path::{Path, PathBuf};
+use std::path::Path;
 use std::fs::File;
 use std::io::Read;
 use errors::*;
@@ -27,6 +27,7 @@ mod summary;
 mod book;
 
 pub use self::book::{Book, BookItems, BookItem, Chapter};
+pub use self::summary::SectionNumber;
 
 use self::book::load_book_from_disk;
 use self::summary::parse_summary;

src/loader/summary.rs

@@ -2,7 +2,6 @@ use std::fmt::{self, Formatter, Display};
 use std::ops::{Deref, DerefMut};
 use std::path::{Path, PathBuf};
 use pulldown_cmark::{self, Event, Tag};
-
 use errors::*;
 
 
@@ -248,7 +247,7 @@ impl<'a> SummaryParser<'a> {
             match self.state {
                 State::Begin => self.step_start(next_event)?,
                 State::PrefixChapters => self.step_prefix(next_event)?,
-                State::NumberedChapters(n) => self.step_numbered(next_event, n)?,
+                State::NumberedChapters(_) => self.step_numbered(next_event)?,
                 State::SuffixChapters => self.step_suffix(next_event)?,
                 State::End => {},
             }
@@ -316,7 +315,7 @@ impl<'a> SummaryParser<'a> {
     /// section and need to parse the suffix section.
     ///
     /// Otherwise, ignore the event.
-    fn step_numbered(&mut self, event: Event, nesting: u32) -> Result<()> {
+    fn step_numbered(&mut self, event: Event) -> Result<()> {
         match event {
             Event::Start(Tag::Item) => {
                 let it = self.parse_item().chain_err(
@@ -448,10 +447,6 @@ fn push_item_at_nesting_level(links: &mut Vec<SummaryItem>, mut item: SummaryIte
         links.push(item);
         Ok(section_number)
     } else {
-        let next_level = level - 1;
-        let index_for_item = links.len() + 1;
-
-        // FIXME: This bit needs simplifying!
         let (index, last_link) = get_last_link(links).chain_err(|| {
             format!("The list of links needs to be {} levels deeper (current position {})", 
                 level, section_number)
@@ -465,6 +460,7 @@ fn push_item_at_nesting_level(links: &mut Vec<SummaryItem>, mut item: SummaryIte
 /// Gets a pointer to the last `Link` in a list of `SummaryItem`s, and its
 /// index.
 fn get_last_link(links: &mut [SummaryItem]) -> Result<(usize, &mut Link)> {
+    // TODO: This should probably be integrated into `Link::push_item()`
     links
         .iter_mut()
         .enumerate()

tests/loading.rs

@@ -1,10 +1,7 @@
 //! Integration tests for loading a book into memory
 
-#[macro_use]
-extern crate pretty_assertions;
 extern crate mdbook;
 extern crate env_logger;
-extern crate tempdir;
 
 use std::path::PathBuf;
 
@@ -13,6 +10,8 @@ use mdbook::loader::load_book;
 
 #[test]
 fn load_the_example_book() {
+    env_logger::init().ok();
+
     let example_src_dir = PathBuf::from(env!("CARGO_MANIFEST_DIR"))
         .join("book-example")
         .join("src");