From 6659fe9beb527bd3e0f36b1d090e49d54a1ca523 Mon Sep 17 00:00:00 2001
From: Simon Sapin <simon.sapin@exyr.org>
Date: Tue, 29 Jul 2014 17:32:37 +0100
Subject: [PATCH] RFC: Deprecate and later remove the in-tree url crate

---
 active/0000-deprecate-url.md | 43 ++++++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)
 create mode 100644 active/0000-deprecate-url.md

diff --git a/active/0000-deprecate-url.md b/active/0000-deprecate-url.md
new file mode 100644
index 00000000000..20d00e63e98
--- /dev/null
+++ b/active/0000-deprecate-url.md
@@ -0,0 +1,43 @@
+- Start Date: 2014-07-29
+- RFC PR #:
+- Rust Issue #:
+
+# Summary
+
+Deprecate and later remove the in-tree url crate, in favor of rust-url.
+
+
+# Motivation
+
+This code [has](https://github.com/rust-lang/rust/issues/8486)
+a [number](https://github.com/rust-lang/rust/issues/10705)
+of [issues](https://github.com/rust-lang/rust/issues/10706)
+that are [non-trivial](https://github.com/rust-lang/rust/issues/10707)
+to fix incrementally.
+
+[rust-url](http://servo.github.io/rust-url/) is a rewrite from scratch.
+It can be used with Cargo.
+
+
+# Detailed design
+
+Replace `#![experimental]` with `#![deprecated]` in `src/liburl/lib.rs`.
+([PR #16076](https://github.com/rust-lang/rust/pull/16076))
+
+Later, after a deprecation cycle to be determined, remove `src/liburl` entirely.
+
+
+# Drawbacks
+
+Users will have to upgrade to a slightly different API.
+
+
+# Alternatives
+
+If someone wants to keep using the old code for some reason,
+it could be extracted and put in a separate Cargo-enabled repository.
+
+
+# Unresolved questions
+
+How long should be the deprecation cycle?