cmake: Document -E remove_directory symlink behavior

Update documentation for the change made by !3738 (merged). Also add a release note.

Issue: #19533 (closed)