Discrepancy between "Using the Session - Cascades" and orm.relation API docs

In doc-section "Using the Session" below "Cascades" it says:

“save-update” cascade indicates that an add() on the parent will cascade to
all child items, and also that items added to a parent which is already
present in the session will also be added

In the doc_string for sqlalchemy.orm.relation it says:

save-update - cascade the "add()" operation (formerly known as save() and update())

Which one is it? Does it only cascade the add operation (as said in the doc_string) or "items added to a parent already present", too? (as said in the cascades section)

Comments (1)