Looking at the code it seems the Doc is actually in need of updating[1]. But I feel that using to! should be a much safer choice and have thus suggested an improvement along with a patch[2]. 1. http://d.puremagic.com/issues/show_bug.cgi?id=5308 2. http://d.puremagic.com/issues/show_bug.cgi?id=5307