From 73322a892bc4344cf1de0a48f4aebc53d3689575 Mon Sep 17 00:00:00 2001 From: Jake Goulding Date: Thu, 9 Feb 2017 10:12:23 -0500 Subject: Tighten up the crate-level docs --- src/lib.rs | 23 ++++++++++++----------- 1 file changed, 12 insertions(+), 11 deletions(-) (limited to 'src/lib.rs') diff --git a/src/lib.rs b/src/lib.rs index d2034e7..87e090d 100644 --- a/src/lib.rs +++ b/src/lib.rs @@ -2,8 +2,8 @@ //! //! [TOML]: https://github.com/toml-lang/toml //! -//! This library implements a [TOML] v0.4.0 compatible parser. This crate also -//! primarily supports the [`serde`] library for encoding/decoding support to +//! This library implements a [TOML] v0.4.0 compatible parser, +//! primarily supporting the [`serde`] library for encoding/decoding //! various types in Rust. //! //! TOML itself is a simple, ergonomic, and readable configuration format: @@ -37,8 +37,8 @@ //! } //! ``` //! -//! You'll note that TOML is very similar to JSON with the notable addition of a -//! `Datetime` type. In general TOML and JSON are interchangeable in terms of +//! TOML is similar to JSON with the notable addition of a `Datetime` +//! type. In general, TOML and JSON are interchangeable in terms of //! formats. //! //! ## Parsing TOML @@ -53,14 +53,15 @@ //! assert_eq!(value["foo"].as_str(), Some("bar")); //! ``` //! -//! The `Value` type implements a number of convenience methods and traits, -//! where the example above is using `FromStr` to parse a `str` into a `Value`. +//! The `Value` type implements a number of convenience methods and +//! traits; the example above uses `FromStr` to parse a `str` into a +//! `Value`. //! //! ## Deserialization and Serialization //! -//! This crate currently supports [`serde`] 0.9 with a number of +//! This crate supports [`serde`] 0.9 with a number of //! implementations of the `Deserialize`, `Serialize`, `Deserializer`, and -//! `Serializer` traits. Namely, you'll find in this crate: +//! `Serializer` traits. Namely, you'll find: //! //! * `Deserialize for Value` //! * `Serialize for Value` @@ -71,8 +72,8 @@ //! * `Serializer for ser::Serializer` //! * `Deserializer for Value` //! -//! This notably means that you can use Serde to deserialize/serialize the -//! `Value` type as well as the `Datetime` type in this crate. Similarly you can +//! This means that you can use Serde to deserialize/serialize the +//! `Value` type as well as the `Datetime` type in this crate. You can also //! use the `Deserializer`, `Serializer`, or `Value` type itself to act as //! a deserializer/serializer for arbitrary types. //! @@ -112,7 +113,7 @@ //! } //! ``` //! -//! Similarly you can serialize types in a similar fashion: +//! You can serialize types in a similar fashion: //! //! ```rust //! #[macro_use] -- cgit v1.2.3