api doc: stream.h: hint at how to select modern vs legacy modeChange-Id: I651fadb1a00e51f347963418b7a6c5d320580d23