Improve function reference documentation

[dmoranj]

Current documentation of the functions provided by the library is really hard to read, and some effort should be put on making it more accessible for IoTAgent developers (dividing it into carefully sepparated sections, adding indexes, and so).