add rustdoc comments with examples for the string versions of to_base64 and from_base64
rustpkg: Factor out tests; use a condition instead of returning an option

Pulled out tests into their own modules inside the files they test,
as per the draft style guidelines.

Started a new module, path_util, for utility functions to do with
paths and directories.

Changed default_dest_dir to use a condition and return Path
instead of Option<Path>.
Add comments for the implementations of from_base64 and to_base64 for .
move rustdoc comments so that they attach to the functions rather than the impl blocks.
Doc review, as requested :-).

Mostly just phrasing things differently, which is a matter of taste. Feel free to use or not use any of the changes I'm suggesting.

I would say this one thing should be changed, though, not necessarily the way I changed it here.

     * Convert any string (literal, `@`, `&`, `~`)
     * that contains a base64 encoded value, to the byte values it encodes.

If this structure is going to be used, either the entire clause, 'that contains a base64 encoded value', should be bracketed by commas, or the comma at the end of the clause should be removed.
Merge pull request #1 from danluu/silly_style_changes

Doc review, as requested :-).
update copyright notice on base64.rs
Change to 4-space indents in code examples
Tidy
auto merge of #5861 : catamorphism/rust/rustpkg, r=catamorphism

r? @graydon

Pulled out tests into their own modules inside the files they test,
as per the draft style guidelines.

Started a new module, path_util, for utility functions to do with
paths and directories.

Changed default_dest_dir to use a condition and return Path
instead of Option<Path>.
auto merge of #5879 : astrieanna/rust/document_std_base64, r=catamorphism

This adds examples for the methods in std::base64.

Each example is complete in the sense that you can copy-paste it into a file and compile it successfully without adding anything (imports, etc). The hardest part of figuring out how to use this was figuring out the right import statements to put at the top.
Update AUTHORS.txt w/ Brett Cannon, Diggory Hardy, Jack Moffitt, James Miller
libcore,std,syntax,rustc: move tests into `mod tests`, make them private (no pub mod or pub fn).
librustdoc: move tests into dedicated tests module.
auto merge of #5894 : catamorphism/rust/authors, r=catamorphism
update RELEASES.txt
iterator: use an IteratorUtil trait
libcore: missed an import for a test
rustc: Anti-copy police
auto merge of #5899 : catamorphism/rust/copy-cops, r=catamorphism