RT1596: Add clarifying doc.