clean up includes

- I recently discovered the -I flag to gcc
better comments, refactor api return values

- adapt functions to use libcurl's return values so code using this
  library can check success