Refactoring the header and source file documentation

[Aziz-repo]

For more readability and quick access to the functions' documentation, I refactored the documentation in more nit way to support the hover documentation display. Please check the changes and let me know if there is conflict in the this way of documenting.

[scossu]

This would be really nice to have! I believe it might need to be updated to more recent changes.

[tidwall]

I would consider merging this if it can be updated to the newest version.