Use '#[rocket::launch]' in guide examples.

site/guide/10-pastebin.md

@@ -54,10 +54,9 @@ And finally, create a skeleton Rocket application to work off of in
 
 #[macro_use] extern crate rocket;
 
-fn main() {
-    # if false {
-    rocket::ignite().launch();
-    # }
+#[rocket::launch]
+fn rocket() -> rocket::Rocket {
+    rocket::ignite()
 }
 ```
 
@@ -113,10 +112,9 @@ to them. To mount the `index` route, modify the main function so that it reads:
 # #[macro_use] extern crate rocket;
 # #[get("/")] fn index() { }
 
-fn main() {
-    # if false {
-    rocket::ignite().mount("/", routes![index]).launch();
-    # }
+#[rocket::launch]
+fn rocket() -> rocket::Rocket {
+    rocket::ignite().mount("/", routes![index])
 }
 ```
 
@@ -294,10 +292,9 @@ Ensure that the route is mounted at the root path:
 # #[get("/")] fn index() {}
 # #[post("/")] fn upload() {}
 
-fn main() {
-    # if false {
-    rocket::ignite().mount("/", routes![index, upload]).launch();
-    # }
+#[rocket::launch]
+fn rocket() -> rocket::Rocket {
+    rocket::ignite().mount("/", routes![index, upload])
 }
 ```
 
@@ -358,10 +355,9 @@ Make sure that the route is mounted at the root path:
 # #[post("/")] fn upload() {}
 # #[get("/<id>")] fn retrieve(id: String) {}
 
-fn main() {
-    # if false {
-    rocket::ignite().mount("/", routes![index, upload, retrieve]).launch();
-    # }
+#[rocket::launch]
+fn rocket() -> rocket::Rocket {
+    rocket::ignite().mount("/", routes![index, upload, retrieve])
 }
 ```
 

site/guide/2-getting-started.md

@@ -66,10 +66,9 @@ fn index() -> &'static str {
     "Hello, world!"
 }
 
-fn main() {
-    # if false {
-    rocket::ignite().mount("/", routes![index]).launch();
-    # }
+#[rocket::launch]
+fn rocket() -> rocket::Rocket {
+    rocket::ignite().mount("/", routes![index])
 }
 ```
 

site/guide/3-overview.md

@@ -159,8 +159,8 @@ requests via the `launch` method. The method starts up the server and waits for
 incoming requests. When a request arrives, Rocket finds the matching route and
 dispatches the request to the route's handler.
 
-We typically call `launch` from the `main` function. Our complete _Hello,
-world!_ application thus looks like:
+We typically use `#[rocket::launch]`, which generates a `main` function.
+Our complete _Hello, world!_ application thus looks like:
 
 ```rust
 #![feature(proc_macro_hygiene)]
@@ -172,10 +172,9 @@ fn world() -> &'static str {
     "Hello, world!"
 }
 
-fn main() {
-    # if false {
-    rocket::ignite().mount("/hello", routes![world]).launch();
-    # }
+#[rocket::launch]
+fn rocket() -> rocket::Rocket {
+    rocket::ignite().mount("/hello", routes![world])
 }
 ```
 

site/guide/4-requests.md

@@ -222,12 +222,9 @@ fn user_int(id: isize) { /* ... */ }
 #[get("/user/<id>", rank = 3)]
 fn user_str(id: &RawStr) { /* ... */ }
 
-fn main() {
-    # if false {
-    rocket::ignite()
-        .mount("/", routes![user, user_int, user_str])
-        .launch();
-    # }
+#[rocket::launch]
+fn rocket() -> rocket::Rocket {
+    rocket::ignite().mount("/", routes![user, user_int, user_str])
 }
 ```
 

site/guide/6-state.md

@@ -303,12 +303,9 @@ use rocket_contrib::databases::diesel;
 #[database("sqlite_logs")]
 struct LogsDbConn(diesel::SqliteConnection);
 
-fn main() {
-    # if false {
-    rocket::ignite()
-       .attach(LogsDbConn::fairing())
-       .launch();
-    # }
+#[rocket::launch]
+fn rocket() -> rocket::Rocket {
+    rocket::ignite().attach(LogsDbConn::fairing())
 }
 ```
 

site/guide/7-fairings.md

@@ -49,15 +49,15 @@ example, the following snippet attached two fairings, `req_fairing` and
 `res_fairing`, to a new Rocket instance:
 
 ```rust
-# let req_fairing = rocket::fairing::AdHoc::on_request("example", |_, _| Box::pin(async {}));
-# let res_fairing = rocket::fairing::AdHoc::on_response("example", |_, _| Box::pin(async {}));
+#[rocket::launch]
+fn rocket() -> rocket::Rocket {
+    # let req_fairing = rocket::fairing::AdHoc::on_request("example", |_, _| Box::pin(async {}));
+    # let res_fairing = rocket::fairing::AdHoc::on_response("example", |_, _| Box::pin(async {}));
 
-# if false {
-rocket::ignite()
-    .attach(req_fairing)
-    .attach(res_fairing)
-    .launch();
-# }
+    rocket::ignite()
+        .attach(req_fairing)
+        .attach(res_fairing)
+}
 ```
 
 [`attach`]: @api/rocket/struct.Rocket.html#method.attach

site/guide/8-testing.md

@@ -125,15 +125,10 @@ fn hello() -> &'static str {
     "Hello, world!"
 }
 
+#[rocket::launch]
 fn rocket() -> rocket::Rocket {
     rocket::ignite().mount("/", routes![hello])
 }
-
-fn main() {
-    # if false {
-    rocket().launch();
-    # }
-}
 ```
 
 Notice that we've separated the _creation_ of the `Rocket` instance from the

site/guide/9-configuration.md

@@ -205,8 +205,8 @@ async fn assets(asset: PathBuf, assets_dir: State<'_, AssetsDir>) -> Option<Name
     NamedFile::open(Path::new(&assets_dir.0).join(asset)).await.ok()
 }
 
-fn main() {
-    # if false {
+#[rocket::launch]
+fn rocket() -> rocket::Rocket {
     rocket::ignite()
         .mount("/", routes![assets])
         .attach(AdHoc::on_attach("Assets Config", |mut rocket| async {
@@ -217,8 +217,6 @@ fn main() {
 
             Ok(rocket.manage(AssetsDir(assets_dir)))
         }))
-        .launch();
-    # }
 }
 ```
 
@@ -275,7 +273,8 @@ let config = Config::build(Environment::Staging)
 # /*
 rocket::custom(config)
     .mount("/", routes![/* .. */])
-    .launch();
+    .launch()
+    .await;
 # */
 ```