document that DecimaterT::decimate does not trigger a garbage collection
DecimaterT::decimate
removes mesh entities but does not trigger a garbage collection. It is expected that a user manually calls garbage_collection
afterwards.
As indicated by this question on StackOverflow, this is unexpected and causes some confusion.
The fact that DecimaterT::decimate
does not prompt a garbage collection should be properly documented.