Repository: seanmonstar/reqwest (language: rust)

Issue:
Document how the "system" proxies work
Since they are now enabled by default, we should document how they work.

- Put this in the main `lib.rs` docs, under the "Proxies" section.
- Adding a `Proxy` to a `ClientBuilder` or calling `ClientBuilder::no_proxy` will disable it.
- Looks for `HTTPS_PROXY`, `https_proxy`, `HTTP_PROXY`, and `http_proxy`.
- Does **not** currently use `NO_PROXY`.


Discussion / hints:

Fix patch:
diff --git a/src/lib.rs b/src/lib.rs
index bbbd1824f..a0747881c 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -130,10 +130,16 @@
 //!
 //! ## Proxies
 //!
-//! A `Client` can be configured to make use of HTTP proxies by adding
-//! [`Proxy`](Proxy)s to a `ClientBuilder`.
+//! ** NOTE ** Proxies are enabled by default.
 //!
-//! ** NOTE** System proxies will be used in the next breaking change.
+//! System proxies look in environment variables to set HTTP or HTTPS proxies.
+//!
+//! `HTTP_PROXY` or `http_proxy` provide http proxies for http connections while
+//! `HTTPS_PROXY` or `https_proxy` provide HTTPS proxies for HTTPS connections.
+//!
+//! These can be overwritten by adding a [`Proxy`](Proxy) to `ClientBuilder`
+//! i.e. `let proxy = reqwest::Proxy::http("https://secure.example")?;`
+//! or disabled by calling `ClientBuilder::no_proxy()`.
 //!
 //! ## TLS
 //!


Test patch: