I wouldn’t call it legacy but “under-utilized” and under-documented.
the point of it is to keep GUI responsive without having to call waitKey all the time.
some backends, gtk apparently, don’t implement it. there you have no choice but to keep calling waitKey.