Document limitations of this function. (#487909, Peter Moulder)