From: bors <bors@rust-lang.org>
Date: Sun, 8 Apr 2018 22:02:15 +0000 (+0000)
Subject: Auto merge of #5318 - ehuss:unstable-docs, r=matklad
X-Git-Tag: archive/raspbian/0.35.0-2+rpi1~3^2^2^2^2^2^2^2~22^2~1^2~86
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=0d49d576925a050a3110cb7bc7082ad1f5323d5f;p=cargo.git

Auto merge of #5318 - ehuss:unstable-docs, r=matklad

Add unstable documentation.

I kept most of these relatively brief with the intent that more complete
documentation would be added when a feature is stabilized.  I did my best to be
accurate, but I am unfamiliar with most of these features, so please let me know
if anything should change.

@matklad: I didn't fully understand the use case for `minimal-versions`, so I
didn't say much about it.  In particular, I didn't understand why one wouldn't
just use `~` or `=` semver requirements if you wanted to be careful about not
pulling in a newer version.  When someone says "1.0", aren't they explicitly
saying they want a newer version (up to 2.0) if it's available?  The example
in the RFC of switching a dependency to "=1.0" sounds like a breaking change
(essentially downgrading a dependency).
---

0d49d576925a050a3110cb7bc7082ad1f5323d5f