Document the fact that auth_mode="digest" only works with curl.

Add check in simple_httpclient that only basic mode is used.