couchdb-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Apache Wiki <wikidi...@apache.org>
Subject [Couchdb Wiki] Update of "HTTP_database_API" by JensAlfke
Date Mon, 20 Aug 2012 22:38:37 GMT
Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Couchdb Wiki" for change notification.

The "HTTP_database_API" page has been changed by JensAlfke:
http://wiki.apache.org/couchdb/HTTP_database_API?action=diff&rev1=32&rev2=33

Comment:
Added clarification about 'deleted' attribute in _changes feed with all_docs

  ||''timeout''||milliseconds||''60000''||Maximum period in milliseconds to wait for a change
before the response is sent, even if there are no results. Only applicable for ''longpoll''
or ''continuous'' feeds. '''Note''' that 60000 is also the default maximum timeout to prevent
undetected dead connections.*||
  ||''filter''||designdoc/filtername||''none''||Reference a filter function from a design
document to selectively get updates. See the [[http://books.couchdb.org/relax/reference/change-notifications|section
in the book]] for more information.||
  ||''include_docs''||boolean||''false''||Include the associated document with each result.
If there are conflicts, only the winning revision is returned. (New in version 0.11)||
- ||''style''|| all_docs | main_only ||''main_only''||Specifies how many revisions are returned
in the changes array. The default, ''main_only'', will only return the winning revision; ''all_docs''
will return all the conflicting revisions.||
+ ||''style''|| all_docs | main_only ||''main_only''||Specifies how many revisions are returned
in the changes array. The default, ''main_only'', will only return the current "winning" revision;
''all_docs'' will return all leaf revisions (including conflicts and deleted former conflicts.)||
  
  * You can change the default maximum timeout in your ini-configuration:
  {{{
@@ -193, +193 @@

  "last_seq":5}
  }}}
  
- ''results'' is the list of changes in sequential order. New and changed documents only differ
in the value of the rev; deleted documents include the ''"deleted": true'' attribute.
+ ''results'' is the list of changes in sequential order. New and changed documents only differ
in the value of the rev; deleted documents include the ''"deleted": true'' attribute. (In
the ''style=all_docs'' mode, ''deleted'' applies only to the current/winning revision. The
other revisions listed might be deleted even if there is no ''deleted'' property; you have
to GET them individually to make sure.)
  
  ''last_seq'' is the sequence number of the last update returned. (Currently it will always
be the same as the ''seq'' of the last item in ''results''.)
  

Mime
View raw message