document std::path

[brson]

I'd like to be clear on what the methods do, particularly the failure conditions.

[brson]

Not 0.6

[catamorphism]

Nominating for milestone 1, well-defined (I added some docs, but the failure conditions could be better-documented).

[graydon]

accepted for well-covered milestone

[huonw]

Triage: Most of the methods now have a brief piece of documentation, but there's not much mention of failure. (I guess it hasn't changed much since @catamorphism touched it.)

[pnkfelix]

closing as fixed