Define and document the code style and module structure.

[eddyb]

Inconsistency should be avoided where possible.

Rust itself uses UpperCamelCase for non-primitive type names and traits, while the current code base has a few structures using lowercasewithnospaces.

For the module structure, for example, io/x86 is preffered over arch/x86/io, and allows for easy automatic import:

// in io/mod.rs:
#[cfg(arch="x86")]
pub use x86::*;
// everything exported by io/x86.rs or io/x86/mod.rs shows up in io.

[miselin]

The compiler is now firing warnings for things like non-CamelCase type names - hopefully that will help clean these up.

I agree that the module structure should be documented. I am not hugely concerned about the layout - I would like to one day add additional targets (other than pure 32-bit x86) so having a module layout that can cater to that will be important.