} else if let Some(colon_sp) =

// If the generic param is declared with a colon but without bounds:

// fn foo<T:>(t: T) { ... }

param.colon_span_for_suggestions(

self.inh.tcx.sess.source_map(),

)

{

sp.to(colon_sp)

raise RuntimeError(("src/stage0.json doesn't contain a checksum for {}. "

"Pre-built artifacts might not available for this "

"target at this time, see https://doc.rust-lang.org/nightly"

"/rustc/platform-support.html for more information.")

.format(url))

- [Scraped examples](scraped-examples.md)

Rustdoc has an unstable feature where it can automatically scrape examples of items being documented from the `examples/` directory of a Cargo workspace. These examples will be included within the generated documentation for that item. For example, if your library contains a public function:

```rust,ignore (needs-other-file)

And you have an example calling this function:

```rust,ignore (needs-other-file)

Then this code snippet will be included in the documentation for `a_func`. This documentation is inserted by Rustdoc and cannot be manually edited by the crate author.

This feature is unstable, so you can enable it by calling Rustdoc with the unstable `rustdoc-scrape-examples` flag:

cargo doc -Zunstable-options -Zrustdoc-scrape-examples=examples

To enable this feature on [docs.rs](https://docs.rs), add this to your Cargo.toml:

[package.metadata.docs.rs]

cargo-args = ["-Zunstable-options", "-Zrustdoc-scrape-examples=examples"]

When you run `cargo doc`, Rustdoc will analyze all the crates that match Cargo's `--examples` filter for instances of items being documented. Then Rustdoc will include the source code of these instances in the generated documentation.

Rustdoc has a few techniques to ensure these examples don't overwhelm documentation readers, and that it doesn't blow up the page size:

1. For a given item, a maximum of 5 examples are included in the page. The remaining examples are just links to source code.

2. Only one example is shown by default, and the remaining examples are hidden behind a toggle.

3. For a given file that contains examples, only the item containing the examples will be included in the generated documentation.

For a given item, Rustdoc sorts its examples based on the size of the example &mdash; smaller ones are shown first.

This feature uses Cargo's convention for finding examples. You should ensure that `cargo check --examples` includes your example file.

collect_spans_and_sources, print_sidebar, scrape_examples_help, settings, AllTypes,

LinkFromSrc, NameDoc, StylePath, BASIC_KEYWORDS,

let scrape_examples_help_file = self.dst.join("scrape-examples-help.html");

if self.shared.layout.scrape_examples_extension {

page.title = "About scraped examples";

page.description = "How the scraped examples feature works in Rustdoc";

let v = layout::render(

&self.shared.layout,

&page,

"",

scrape_examples_help(&*self.shared),

&self.shared.style_files,

);

self.shared.fs.write(scrape_examples_help_file, v)?;

}

use crate::html::static_files::SCRAPE_EXAMPLES_HELP_MD;

use crate::DOC_RUST_LANG_ORG_CHANNEL;

fn scrape_examples_help(shared: &SharedContext<'_>) -> String {

let mut content = SCRAPE_EXAMPLES_HELP_MD.to_owned();

content.push_str(&format!(

"## More information\n\n\

DOC_RUST_LANG_ORG_CHANNEL));

let mut ids = IdMap::default();

format!(

"<div class=\"main-heading\">\

Markdown {

content: &content,

links: &[],

ids: &mut ids,

error_codes: shared.codes,

edition: shared.edition(),

playground: &shared.playground,

heading_offset: HeadingOffset::H1

}

.into_string()

)

root_path = cx.root_path(),

let (byte_lo, byte_hi) = loc.call_ident.byte_span;