Documentation of extend() with the 'flat' option