Discussion started here: #2214 (comment)
On the one hand it seems changing PHPDoc would solve the problem but i don't think it would be logical approach. I don't quite realize the use case of resetting sequence to the MAX PK value (i.e. trimming it).
I think it's better to change functionality to fit PHPDoc: resetting sequence value to the 1 by default would be far more logical approach. Of course this change will be mentioned in the UPGRADE file, since it's BC breaking.
Moreover we can create another special value (e.g. false) which would reset sequence to the MAX PK value (in case someone needs this).
UPD: After thinking a little bit more i came to opinion that it's better to keep functionality untouched. Everything can be achieved through current implementation:
I've just stumbled upon on another issue: COciSchema::resetSequence() works same way as described in its PHPDoc. BC breaking for Oracle is imminent.
Fixes #2241: resetSequence() inconsistency.