Adjust doc; cut release

Cargo.toml

@@ -1,7 +1,7 @@
 [package]
 
 name = "open"
-version = "1.3.5-alpha.0"
+version = "1.4.0"
 authors = ["Sebastian Thiel <[email protected]>"]
 license = "MIT"
 edition = "2018"

README.md

@@ -17,14 +17,14 @@ $ open <path-or-url> || xdg-open <path-or-url> || gnome-open <path-or-url> || kd
 Add this to your Cargo.toml
 ```toml
 [dependencies]
-open = "*"
+open = "1"
 ```
-... and open something using
+…and open something using…
 ```Rust
 open::that("https://rust-lang.org");
 ```
 
-or, open with something app
+…or, open something with an application of your choice
 ```Rust
 open::with("https://rust-lang.org", "firefox");
 ```

changelog.md

@@ -1,4 +1,7 @@
-<a name="v1.2.0"></a>
+## v1.4.0 (2020-03-08)
+
+* add `open::with(path, app)` and `open::with_in_background(…)`
+
 ## v1.3.4 (2020-02-11)
 
 * Add LICENSE.md and README.md into the crates.io tarball.

src/lib.rs

@@ -12,6 +12,15 @@
 //! open::that("http://rust-lang.org").unwrap();
 //! # }
 //! ```
+//! Alternatively, specify the program to open something with. It should expect to receive the path or URL as first argument.
+//! ```test_harness,no_run
+//! extern crate open;
+//!
+//! # #[test]
+//! # fn doit() {
+//! open::with("http://rust-lang.org", "firefox").unwrap();
+//! # }
+//! ```
 //!
 //! # Notes
 //!