move build_all out of tools/build

since that directory is things that are called by cmake
Decorator docs show get_particle_index on my mac

relates #656. If it doesn't show tomorrow, we need to look into doxygen versions or something.