[Soc2014] Official meta API

Ok - it would be very useful for code-readability to explicitly mark in docstrings which methods/properties are only being kept for legacy reasons (and/or even organize the code with non-legacy APIs on top and legacy APIs at the bottom underneath a big scary comment -- see the way @aaugustin did it with the transaction APIs)