anchor.diff:  
   `client`::
   
  -    The name of the s3 client to use to connect to S3. Defaults to `default`.
  +    The name of the <<repository-s3-client,S3 client>> to use to connect to S3.
  +    Defaults to `default`.
   
   `base_path`::
   
  -    Specifies the path within bucket to repository data. Defaults to
  -    value of `repositories.s3.base_path` or to root directory if not set.
  -    Previously, the base_path could take a leading `/` (forward slash).
  -    However, this has been deprecated and setting the base_path now should
  -    omit the leading `/`.
  +    Specifies the path within bucket to repository data. Defaults to value of
  +    `repositories.s3.base_path` or to root directory if not set.  Previously,
  +    the base_path could take a leading `/` (forward slash).  However, this has
  +    been deprecated and setting the base_path now should omit the leading `/`.
   
   `chunk_size`::
   
  -    Big files can be broken down into chunks during snapshotting if needed.
  -    The chunk size can be specified in bytes or by using size value notation,
  -    i.e. `1gb`, `10mb`, `5kb`. Defaults to `1gb`.
  +    Big files can be broken down into chunks during snapshotting if needed.  The
  +    chunk size can be specified in bytes or by using size value notation, i.e.
  +    `1gb`, `10mb`, `5kb`. Defaults to `1gb`.
   
   `compress`::
   
  
positive.code: [[repository-s3-client]]
  ==== Client Settings
  
  The client that you use to connect to S3 has a number of settings available. The
  settings have the form `s3.client.CLIENT_NAME.SETTING_NAME`. The default client
  name that is looked up by an `s3` repository is `default`. It can be modified
  using the <<repository-s3-repository,repository setting>> `client`. For example:
  
  [source,js]
  ----
  
negative.code: 
  `access_key` ({ref}/secure-settings.html[Secure])::
  
      An S3 access key. The `secret_key` setting must also be specified.
  
  `secret_key` ({ref}/secure-settings.html[Secure])::
  
      An S3 secret key. The `access_key` setting must also be specified.
  
  `session_token`::
  
      An S3 session token. The `access_key` and `secret_key` settings must also be
      specified. (Secure)
  
  `endpoint`::
  
      The S3 service endpoint to connect to. This defaults to `s3.amazonaws.com`
      but the
      http://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region[AWS
      documentation] lists alternative S3 endpoints. If you are using an
      <<repository-s3-compatible-services,S3-compatible service>> then you should
      set this to the service's endpoint.
  
  `protocol`::
  
      The protocol to use to connect to S3. Valid values are either `http` or
      `https`. Defaults to `https`.
  
  `proxy.host`::
  
      The host name of a proxy to connect to S3 through.
  
  `proxy.port`::
  
      The port of a proxy to connect to S3 through.
  
  `proxy.username` ({ref}/secure-settings.html[Secure])::
  
      The username to connect to the `proxy.host` with.
  
  `proxy.password` ({ref}/secure-settings.html[Secure])::
  
      The password to connect to the `proxy.host` with.
  
  `read_timeout`::
  
      The socket timeout for connecting to S3. The value should specify the unit.
      For example, a value of `5s` specifies a 5 second timeout. The default value
      is 50 seconds.
  
  `max_retries`::
  
      The number of retries to use when an S3 request fails. The default value is
      `3`.
  
  `use_throttle_retries`::
  
      Whether retries should be throttled (i.e. should back off). Must be `true`
      or `false`. Defaults to `true`.
  
  [float]
  [[repository-s3-compatible-services]]
  ===== S3-compatible services
  
  There are a number of storage systems that provide an S3-compatible API, and
  the `repository-s3` plugin allows you to use these systems in place of AWS S3.
  To do so, you should set the `s3.client.CLIENT_NAME.endpoint` setting to the
  system's endpoint. This setting accepts IP addresses and hostnames and may
  include a port. For example, the endpoint may be `172.17.0.2` or
  `172.17.0.2:9000`. You may also need to set `s3.client.CLIENT_NAME.protocol` to
  `http` if the endpoint does not support HTTPS.
  
  https://minio.io[Minio] is an example of a storage system that provides an
  S3-compatible API. The `repository-s3` plugin allows {es} to work with
  Minio-backed repositories as well as repositories stored on AWS S3. Other
  S3-compatible storage systems may also work with {es}, but these are not tested
  or supported.
  
  [[repository-s3-repository]]
  ==== Repository Settings
  
  The `s3` repository type supports a number of settings to customize how data is
  stored in S3. These can be specified when creating the repository. For example:
  
  [source,js]
  ----
  