docs: Sketch out rustpkg manual
rustpkg: In doc, mention other implicit RUST_PATH entries

as per Graydon's comment
auto merge of #6015 : catamorphism/rust/rustpkg-doc-second-try, r=catamorphism

r? @graydon

Only change from the version that you read is that I addressed your comment about `RUST_PATH`.