enchant-provider.h: add documentation (fix #239)

Document enchant_get_user_config_dir and enchant_get_conf_dirs.

Tweak other documentation for consistency.

Correct the name of the preprocessor guard token in the closing comment.

This commit only changes comments.