Clarify that serde is supported

Closes #122
This commit is contained in:
Alex Crichton 2017-01-09 17:37:05 -08:00
parent 5907e0a7d0
commit 0dc5347946
2 changed files with 40 additions and 0 deletions

View file

@ -17,6 +17,37 @@ date with the TOML specification as changes happen.
toml = "0.2" toml = "0.2"
``` ```
By default this crate supports [`rustc-serialize`] style serialization. This can
be disabled though by disabling the default feature set:
[`rustc-serialize`]: http://github.com/rust-lang/rustc-serialize
```toml
# Cargo.toml
[dependencies]
toml = { version = "0.2", default-features = false }
```
If you'd like to enable support for [serde] you can enable the `serde` feature:
[serde]: https://github.com/serde-rs/serde
```toml
# Cargo.toml
[dependencies]
toml = { version = "0.2", features = ["serde"] }
```
If you'd like to *only* support serde, you can also write:
[serde]: https://github.com/serde-rs/serde
```toml
# Cargo.toml
[dependencies]
toml = { version = "0.2", features = ["serde"], default-features = false }
```
# License # License
`toml-rs` is primarily distributed under the terms of both the MIT license and `toml-rs` is primarily distributed under the terms of both the MIT license and

View file

@ -34,6 +34,15 @@
//! //!
//! [1]: https://github.com/mojombo/toml //! [1]: https://github.com/mojombo/toml
//! [2]: https://github.com/BurntSushi/toml-test //! [2]: https://github.com/BurntSushi/toml-test
//!
//! # Encoding support
//!
//! This crate optionally supports the [`rustc-serialize`] crate and also the
//! [`serde`] crate through respective feature names. The `rustc-serialize`
//! feature is enabled by default.
//!
//! [`rustc-serialize`]: http://github.com/rust-lang/rustc-serialize
//! [`serde`]: http://github.com/serde-rs/serde
#![doc(html_root_url = "http://alexcrichton.com/toml-rs")] #![doc(html_root_url = "http://alexcrichton.com/toml-rs")]
#![deny(missing_docs)] #![deny(missing_docs)]