anchor.diff:  POST test/_doc?refresh
   {
     "body": "some words so there is a little field data",
  -  "soul": "some more words"
  +  "soul": "some more words",
  +  "mind": "even more words"
   }
   
   # Perform a search to load the field data
  -POST test/_search?sort=body,soul
  +POST test/_search?sort=body,soul,mind
   --------------------------------------------------
   // CONSOLE
   ////
   
  +[[cat-fielddata-api-example-ind]]
  +===== Example with an individual field
  +
  +You can specify an individual field in the request body or URL path. The
  +following `fieldata` API request retrieves heap memory size information for the
  +`body` field.
  +
   [source,js]
   --------------------------------------------------
  -GET /_cat/fielddata?v
  +GET /_cat/fielddata?v&fields=body
   --------------------------------------------------
   // CONSOLE
   // TEST[continued]
   
  -Looks like:
  +The API returns the following response:
  +
  +[source,txt]
  +--------------------------------------------------
  +id                     host      ip        node    field   size
  +Nqk-6inXQq-OxUfOUI8jNQ 127.0.0.1 127.0.0.1 Nqk-6in body    544b
  +--------------------------------------------------
  +// TESTRESPONSE[s/544b|480b/\\d+(\\.\\d+)?[tgmk]?b/]
  +// TESTRESPONSE[s/Nqk-6in[^ ]*/.+/ non_json]
  +
  +[[cat-fielddata-api-example-list]]
  +===== Example with a list of fields
  +
  +You can specify a comma-separated list of fields in the request body or URL
  +path. The following `fieldata` API request retrieves heap memory size
  +information for the `body` and `soul` fields.
  +
  +
  +[source,js]
  +--------------------------------------------------
  +GET /_cat/fielddata/body,soul?v
  +--------------------------------------------------
  +// CONSOLE
  +// TEST[continued]
  +
  +The API returns the following response:
   
   [source,txt]
   --------------------------------------------------
  
positive.code:       "soul": {
          "type": "text",
          "fielddata":true
        }
      }
    }
  
negative.code: [[cat-fielddata]]
  === cat fielddata
  
  Returns the amount of heap memory currently used by fielddata on every data node
  in the cluster.
  
  
  [[cat-fielddata-api-request]]
  ==== {api-request-title}
  
  `GET /_cat/fielddata/{fields}`
  
  
  [[cat-fielddata-api-path-params]]
  ==== {api-path-parms-title}
  
  `{fields}`::
  (Optional, string) Comma-separated list of fields used to limit returned
  information.
  
  
  [[cat-fielddata-api-query-params]]
  ==== {api-query-parms-title}
  
  include::{docdir}/rest-api/common-parms.asciidoc[tag=bytes]
  
  include::{docdir}/rest-api/common-parms.asciidoc[tag=http-format]
  
  include::{docdir}/rest-api/common-parms.asciidoc[tag=local]
  
  include::{docdir}/rest-api/common-parms.asciidoc[tag=master-timeout]
  
  include::{docdir}/rest-api/common-parms.asciidoc[tag=cat-h]
  
  include::{docdir}/rest-api/common-parms.asciidoc[tag=help]
  
  include::{docdir}/rest-api/common-parms.asciidoc[tag=cat-s]
  
  include::{docdir}/rest-api/common-parms.asciidoc[tag=cat-v]
  
  
  [[cat-fielddata-api-example]]
  ==== {api-examples-title}
  
  ////
  Hidden setup snippet to build an index with fielddata so our results are real:
  