UseEcos: Update documentation

- Module macros described as a list with the usual RST syntax.
- Mention of internal macro ecos_add_target_lib() removed, as it is
  internal implementation meant for the ecos_add_executable().
- Documentation from internal comments moved to the main docs header.
- Variable descriptions updated.
- Internal comments adjusted for readability.