A little unclear filter documentation

The regular documentation and the API-documentation is a little different on how query filtering works. Which is the correct version?

Regular documentation

query: {
  AND: {
    'description': ['swiss', 'watch']
    'price': [{
       gte: '1000',
       lte: '8'
    }]
  }
}

API

  si.buckets({
    query: [
      {
        AND: {'*': ['*']}
      }
    ],
    buckets: [
      {
        field: 'price',
        gte:   '2',
        lte:   '3',
        set:   false
      }
      {
        field: 'price',
        gte:   '4',
        lte:   '7',
        set:   false
      }
    ]
  }).on('data', function (data) {
    // do something with the data
  }).on('end', function () {
    // finshed
  })

  si.categorize({
    query: [
      {
        AND: {'*': ['swiss', 'watch']}
      }
    ],
    category: {
      field: 'manufacturer'
    }
  }).on('data', function (data) {
    // do something with the data
  }).on('end', function () {
    // finshed
  })

[fergiemcdowall]

Its just that filtering each or query allows you to do both (filter the whole result set, or define different filters per OR clause). So if somebody did have a usecase for per OR clause they could implement it.

[eklem]

Not sure if I agree fully, but maybe not the big issue for me in a while. What do you think would be a usecase for filtering differently on each OR-query?