"""Cloudflare DNS Authenticator

This plugin automates the process of completing a dns-01 challenge
(`~acme.challenges.DNS01`) using the Cloudflare API.

Use of this plugin requires a configuration file containing Cloudflare API
credentials, obtained from your Cloudflare
`account page <https://www.cloudflare.com/a/account/my-account>`_.

Example:

.. code-block:: ini

  dns_cloudflare_email = cloudflare@example.com
  dns_cloudflare_api_key = 0123456789abcdef0123456789abcdef01234567

"""

@@ -1,41 +1,52 @@
 %22%22%22
-Cloudflare DNS Authenticator%0A%0AThis
+%0AThe %60~certbot_dns_cloudflare.dns_cloudflare%60
  plu
@@ -73,17 +73,17 @@
 ocess of
- 
+%0A
 completi
@@ -91,14 +91,16 @@
 g a 
+%60
 dns-01
+%60
  cha
@@ -105,17 +105,17 @@
 hallenge
-%0A
+ 
 (%60~acme.
@@ -157,15 +157,41 @@
 lare
- 
+%0A
 API.%0A%0A
+%0ACredentials%0A-----------%0A%0A
 Use 
@@ -376,18 +376,8 @@
 _.%0A%0A
-Example:%0A%0A
 .. c
@@ -392,17 +392,131 @@
 k:: ini%0A
-%0A
+   :name: credentials.ini%0A   :caption: Example credentials file:%0A%0A   # Cloudflare API credentials used by Certbot%0A 
   dns_cl
@@ -555,16 +555,17 @@
 ple.com%0A
+ 
   dns_cl
@@ -625,12 +625,627 @@
 234567%0A%0A
+The path to this file can be provided interactively or using the%0A%60--dns-cloudflare-credentials%60 command-line argument. Certbot records the path%0Ato this file for use during renewal, but does not store the file's contents.%0A%0A.. caution::%0A   You should protect these API credentials as you would the password to your%0A   Cloudflare account. Users who can read this file can use these credentials%0A   to issue API calls on your behalf. Users who can cause Certbot to run using%0A   these credentials can complete a %60dns-01%60 challenge to acquire new%0A   certificates or revoke existing certificates for associated domains.%0A%0A%0A%0A
 %22%22%22%0A

Expand documentation