//! An implementation of [FLAC](https://xiph.org/flac), free lossless audio
//! codec, written in Rust.
//!
//! # Examples
//!
//! Basic decoding from a file.
//!
//! ```
//! match flac::Stream::from_file("path/to/file.flac") {
//!   Ok(mut stream) => {
//!     // Copy of `StreamInfo` to help convert to a different audio format.
//!     let info = stream.info();
//!
//!     for sample in stream.iter() {
//!       // Iterate over each decoded sample
//!     }
//!   }
//!   Err(error)     => println!("{}", error),
//! }
//! ```

#[macro_use]
extern crate nom;

#[macro_use]
mod utility;
pub mod metadata;
pub mod frame;
pub mod subframe;
pub mod stream;

pub use metadata::{metadata_parser, Metadata};
pub use frame::{frame_parser, Frame};
pub use subframe::{subframe_parser, Subframe};
pub use stream::{stream_parser, Stream};

//! An implementation of [FLAC](https://xiph.org/flac), free lossless audio
//! codec, written in Rust.

#[macro_use]
extern crate nom;

#[macro_use]
mod utility;
pub mod metadata;
pub mod frame;
pub mod subframe;
pub mod stream;

pub use metadata::{metadata_parser, Metadata};
pub use frame::{frame_parser, Frame};
pub use subframe::{subframe_parser, Subframe};
pub use stream::{stream_parser, Stream};

--- 
+++ 
@@ -1,5 +1,23 @@
 //! An implementation of [FLAC](https://xiph.org/flac), free lossless audio
 //! codec, written in Rust.
+//!
+//! # Examples
+//!
+//! Basic decoding from a file.
+//!
+//! ```
+//! match flac::Stream::from_file("path/to/file.flac") {
+//!   Ok(mut stream) => {
+//!     // Copy of `StreamInfo` to help convert to a different audio format.
+//!     let info = stream.info();
+//!
+//!     for sample in stream.iter() {
+//!       // Iterate over each decoded sample
+//!     }
+//!   }
+//!   Err(error)     => println!("{}", error),
+//! }
+//! ```
 
 #[macro_use]
 extern crate nom;
Add top level code sample for FLAC decoding
