friendly to newcomers

Author: yanns

README.rst

@@ -12,3 +12,16 @@ The HTTP implementation based on mio_ and rotor_.
 .. _mio: https://crates.io/crates/mio
 .. _rotor: https://github.com/tailhook/rotor
 .. _libraries and apps using rotor: http://rotor.readthedocs.org/en/latest/ecosystem.html
+
+
+Examples
+--------
+
+You can find some examples in the `examples folder`_.
+
+To run one of them (like `hello_world_server.rs`_)::
+
+  cargo run --example hello_world_server
+
+.. _examples folder: ./examples
+.. _hello_world_server.rs: ./examples/hello_world_server.rs

examples/hello_world_server.rs

@@ -111,6 +111,7 @@ impl Server for HelloWorld {
 }
 
 fn main() {
+    println!("Starting http server on http://127.0.0.1:3000/");
     let event_loop = rotor::Loop::new(&rotor::Config::new()).unwrap();
     let mut loop_inst = event_loop.instantiate(Context {
         counter: 0,

examples/threaded.rs

@@ -113,6 +113,7 @@ impl Server for HelloWorld {
 }
 
 fn main() {
+    println!("Starting http server on http://127.0.0.1:3000/");
     let lst = TcpListener::bind(&"127.0.0.1:3000".parse().unwrap()).unwrap();
     let threads = env::var("THREADS").unwrap_or("2".to_string())
         .parse().unwrap();

examples/threaded_reuse_port.rs

@@ -116,6 +116,7 @@ impl Server for HelloWorld {
 }
 
 fn main() {
+    println!("Starting http server on http://127.0.0.1:3000/");
     let threads = env::var("THREADS").unwrap_or("2".to_string())
         .parse().unwrap();
     let mut children = Vec::new();

examples/threaded_with_shared_counter.rs

@@ -118,6 +118,7 @@ impl Server for HelloWorld {
 }
 
 fn main() {
+    println!("Starting http server on http://127.0.0.1:3000/");
     let lst = TcpListener::bind(&"127.0.0.1:3000".parse().unwrap()).unwrap();
     let threads = env::var("THREADS").unwrap_or("2".to_string())
         .parse().unwrap();

examples/todobackend.rs

@@ -292,6 +292,7 @@ impl Server for TodoBackend {
 
 #[cfg(feature="nightly")]
 fn main() {
+    println!("Starting http server on http://127.0.0.1:3000/");
     let event_loop = rotor::Loop::new(&rotor::Config::new()).unwrap();
     let mut loop_inst = event_loop.instantiate(Context {
         last_id: 0,

examples/two_servers.rs

@@ -131,6 +131,7 @@ impl Server for Get {
 }
 
 fn main() {
+    println!("Starting http servers on http://127.0.0.1:3000/ and http://127.0.0.1:3001/");
     let lst1 = TcpListener::bind(&"127.0.0.1:3000".parse().unwrap()).unwrap();
     let lst2 = TcpListener::bind(&"127.0.0.1:3001".parse().unwrap()).unwrap();
     let event_loop = rotor::Loop::new(&rotor::Config::new()).unwrap();