You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@couchdb.apache.org by Apache Wiki <wi...@apache.org> on 2012/08/21 00:38:37 UTC

[Couchdb Wiki] Update of "HTTP_database_API" by JensAlfke

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''.)