SI-6409  Stream flatMap leaks memory if mapper returns many empties

Added Scaladoc explaining that this is necessary behavior, but closed ticket as wontfix.
Merge pull request #3805 from Ichoran/issue/6409

SI-6409  Stream flatMap leaks memory if mapper returns many empties