reorganized the examples
improved interface and documentation for RtMidi::In
improved interface and documentation for RtMidi::Out
plus misc other doc improvements (stopped documenting private classes and modules, got 100% doc coverage)