well yes, documenting synedit is still a big todo.
but the methods should be self explaining. Use code navigation, and you will see the declaration.
SynEdit.TextBetweenPoints[ Point(x,y), Point(x2,y2) ] := 'abc';
works like setting block-selection begin/end and then SelText := 'abc'
x,y are "logical". see same wiki page