Add variants of editing/navagiting methods that take relative index argument (paragraph index, column index)

[JordanMartinez]

No description provided.

[TomasMikula]

Seems a little repetitive wrt. the method above.

[JordanMartinez]

Ah... I'll fix that.

[JordanMartinez]

I chose StyledDocument as the place to implement the base code for getAbsoluteCharPosition and not TwoDimensional because then that method would "pollute" its implementors with a confusing method name and parameters since it doesn't use int paragraphIndex and int columnIndex as its parameters but int major and int minor.

[TomasMikula]

Looks, good, just not sure if I want to use "Char" in the method names. I try to be consistent in using the term position when pointing to a place between characters, and character index when pointing to a character.

 ┌ character 0
 | ┌ character 1
 | |   ┌ character 3
 | |   |
 v v   v

|_|_|_|_|

^ ^     ^
| |     |
| |     └ position 4
| └ position 1
└ position 0

[JordanMartinez]

I agree with keeping it consistent.

At the same time, I don't know if this distinction between position and character index is even stated in the javadoc or is as clear as the above picture.
Should it be in the javadoc? Or somewhere else in the project pages (ReadMe, Wiki, etc.)?

[JordanMartinez]

Well, since so many methods point to getAbsolutePosition(), whose javadoc now includes your picture, I think that takes care of the previous issue I raised.

[TomasMikula]

You mean "i.e." instead of "e.g." ;)

[JordanMartinez]

I used "i.e." a lot until I saw you use "e.g." a lot. So, I thought they were the same and just used that whenever it related to you or this project. 😃 Having looked it up, I see the difference now.

[TomasMikula]

👍