API Docs: array

[steveklabnik]

Part of #29329

http://doc.rust-lang.org/std/primitive.array.html

Good things to do here: make sure to explain the type level integers / ergonomic issues, point out that most methods happen on slices, talk about .iter() inference weirdness.

[kmcallister]

Going to work on this.

[kmcallister]

Looks like some of this was done in e173ead.

[matthew-piziak]

@kmcallister Yep. I didn't add any exposition about .iter() behavior though. Some of that would definitely be helpful.

[kmcallister]

@steveklabnik: Can you explain what you mean by ".iter() inference weirdness"?

[steveklabnik]

@kmcallister breifly (and I'll try to elaborate more later if this doesn't make sense) but it's about how sometimes, you have to explicitly call .iter() on an array whereas it would be inferred with vec through a for loop

let a = [1, 2, 4, 5, 6];

for e in a {
    println!("{}", e);
}

fails, for example

[frewsxcv]

Opened up a tangential issue: #36391