From a112231c55eab31d7c7f4fbfa6a18e9cd694ebb0 Mon Sep 17 00:00:00 2001
From: Jordi Boggiano <j.boggiano@seld.be>
Date: Sat, 30 Mar 2013 20:02:29 +0100
Subject: [PATCH] Add prefer-stable docs

---
 doc/04-schema.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/doc/04-schema.md b/doc/04-schema.md
index f7de1a3df..22361d40d 100644
--- a/doc/04-schema.md
+++ b/doc/04-schema.md
@@ -493,6 +493,13 @@ a given package can be done in `require` or `require-dev` (see
 Available options (in order of stability) are `dev`, `alpha`, `beta`, `RC`,
 and `stable`.
 
+### prefer-stable <span>(root-only)</span>
+
+When this is enabled, Composer will prefer more stable packages over unstable
+ones when finding compatible stable packages is possible. If you require a
+dev version or only alphas are available for a package, those will still be
+selected granted that the minimum-stability allows for it.
+
 ### repositories <span>(root-only)</span>
 
 Custom package repositories to use.