mat2: add tables to docs & fix comments

[EasyIP2023]

No description provided.

[EasyIP2023]

@recp Rearranged some functions and changed parameter names for API consistency.

Question with

glms_mat2_(transpose)(mat2s m)

Do we need to break this up into

mat2s
glms_mat2_(transpose_to)(mat2s m);

void
glms_mat2_(transpose)(mat2s m);

[recp]

There is no need to have transpose_to and any other _to versions since we always return a new struct [mat2s] from func ( for structure api ).

[EasyIP2023]

@recp Okay good to know. Left that the same. Lastly wanted to update the docs format. So, that it's hopefully easier for new comers to understand the mathematics

1. Start with function definition, parameters, etc...
2. Given mathematical definition in table format
3. Provide an example in table format of a code snippet

Good? Or is it a bit too much?

[recp]

@EasyIP2023 the docs looks good many thanks. But I'm not sure about naming about src.

m|mat -> src

for instance

glms_mat2_inv(mat2 src, mat2 dest)

we are inverting src okay but also inverting given matrix which is m. I would prefer m/mat and similar over src even it writes to dest param.

Also just realized that glms_mat2_inv() should not have dest since dest is the returned value, see glms_mat4_inv() and glms_mat3_inv()

[EasyIP2023]

@recp Okay cool cool. Will change functions param names when I find time and let you know.

[EasyIP2023]

@recp Believe to be ready for another review.

[recp]

@EasyIP2023 the PR is merged, I may update param names later e.g src to m...

Thanks for your contributions 🚀