Rename r.coin?

[wenzeslaus]

r.coin as you may or may not know, tabulates the mutual occurrence (coincidence) of categories for two raster map layers as stated in its documentation. However, I find the name completely misleading. Admittedly, I'm not using the tool, so I always forget that this is what it does. I always think it is about a coin toss, i.e., random numbers, like generating zeros and ones or something along those lines.

My issue comes from the word coincidence being shortened to coin. Coin is a different word with different meaning and also different pronunciation. Compare: coin /koin/ and co·in·ci·dence /kōˈin(t)səd(ə)n(t)s/. How do you read r.coin? I read it r-coin /koin/ which is wrong. It should be r-co·in /kōˈin/, but that's hard to get right.

Should we rename it? (We would keep a wrapper tool around which would keep the old name around for some time.)

https://grass.osgeo.org/grass-stable/manuals/r.coin.html
https://grass.osgeo.org/grass-devel/manuals/r.coin.html

This came up because of r.coin popping up now in my feed due to JSON output planning and now related PRs, so not a big priority for me. However, perhaps the unclear name results in lower usage than the tool deserves.

[veroandreo]

I also have issues with r.coin(cidence) name. For me, coincidence refers to the actual same thing happening at the same place/time. But r.coin use is more general than that, i.e., it does not search for matching categories only. Indeed, it cross-tabulates the categories of two maps, regardless of what they represent. So, what about r.crosstab (or r.cross.table), r.joint.dist(ribution) or r.contingency (because of contingency matrix)? I think those names might better reflect the actual functionality of the tool.