Add basic documentation for with_capacity
Move documentation for vec::windowed where it will be generated
auto merge of #6055 : cmr/rust/incoming, r=graydon,brson
core: Move mkdir_recursive from rustpkg into core::os

mkdir_recursive creates a directory as well as any of its
parent directories that don't exist already. Seems like a useful
thing to have in core.