[WIP] Modify examples to not call `unwrap`

[luisbg]

This is for issue #312

Just fixing one case to check this is what the issue is about and that I understand the intended fix.

---

This change is 

[behnam]

Review status: 0 of 1 files reviewed at latest revision, 1 unresolved discussion.

---

src/lib.rs, line 270 at r1 (raw file):

    /// use url::Url;
    ///
    /// fn foo() -> Result<(), url::ParseError> {

If you like to keep the function definition part of the example, then the content of the block should be indented.

But, rustdoc has a nice way of letting you hide these execution details, using # at the beginning of a line.

For example, this part would be:

    /// # fn foo() -> Result<(), url::ParseError> {
    /// ...
    /// # Ok(())
    /// # }

More here: https://doc.rust-lang.org/book/documentation.html#documenting-macros

---

Comments from Reviewable

[behnam]

Reviewed 1 of 1 files at r1.
Review status: all files reviewed at latest revision, 1 unresolved discussion.

---

Comments from Reviewable

[luisbg]

Cool!

I will fix this tomorrow, probably. Currently traveling for work meeting so might not have the time to get around to it.

[mgeisler]

I believe you should also include a call to the foo() function -- otherwise the code in question is only compiled, but not actually executed.

[luisbg]

I am looking at this again. Thanks for the pointer @mgeisler

Will report soon. Sorry for the delay.

[bors-servo]

☔ The latest upstream changes (presumably #323) made this pull request unmergeable. Please resolve the merge conflicts.

[Enet4]

#312 has been addressed in #323 (see the latest Url#join for instance). Are there any new examples with unwrap since then?

[SimonSapin]

This is done in #323. Thanks for the PR anyway!