Added explanation of new append behavior in the API.