FindCURL: Update documentation

- Module documentation synced with other similar find modules.
- Added examples section.
- Joined all hints variables in a single section.
- Added deprecated variables section.
- Described the "module mode" and "config mode" when searching for CURL
  separately in the module introduction, and added notes to some result
  variables.

Fixes #24580