[Feat Req for Documentation] Improvements for selection-setting functions

[alankilborn]

Can these 3 related functions appear sequentially in the documentation?:

 editor.setSel(anchor, caret)
 editor.setSelection(caret, anchor)
 editor.setEmptySelection(caret)

---

Additionally, can the following highlighted text be added?:

---

Some of the information requested appears in the Scintilla documentation and is seen when the associated link in the PS doc is clicked, but it would be nicer to have it directly in the PS docs.

For copying convenience, here is the text from the above:

 The caret is scrolled into view after this operation.
 Note: the argument order is reversed from the editor.setSelection() function.
 The caret is not scrolled into view after this operation.
 Note: the argument order is reversed from the editor.setSel() function.

[chcg]

Docu is generated from e.g.

PythonScript/PythonScript/src/Scintilla.iface

Lines 1184 to 1185 in 1e090b7

	# Set caret to a position, while removing any existing selection.
	fun void SetEmptySelection=2556(position caret,)

, so it would be nicer to have this corrected by scintilla itself.

[alankilborn]

Docu is generated from e.g.

:-(

Consider NOT producing documentation that way? :-)