Deprecate show, list, rewrite, vhosts

src/api/basics.rst

@@ -92,10 +92,6 @@ listing the supported HTTP methods. For example:
         "reason":"Only GET,HEAD allowed"
     }
 
-The CouchDB design document API and the functions when returning HTML (for
-example as part of a show or list) enables you to include custom HTTP headers
-through the ``headers`` block of the return object.
-
 HTTP Headers
 ============
 

src/api/ddoc/common.rst

@@ -50,9 +50,9 @@
       to process design document functions
     * **options** (*object*): View's default options
     * **filters** (*object*): :ref:`Filter functions <filterfun>` definition
-    * **lists** (*object*): :ref:`List functions <listfun>` definition
-    * **rewrites** (*array* or *string*): Rewrite rules definition
-    * **shows** (*object*): :ref:`Show functions <showfun>` definition
+    * **lists** (*object*): :ref:`List functions <listfun>` definition. *Deprecated.*
+    * **rewrites** (*array* or *string*): Rewrite rules definition. *Deprecated.*
+    * **shows** (*object*): :ref:`Show functions <showfun>` definition. *Deprecated.*
     * **updates** (*object*): :ref:`Update functions <updatefun>` definition
     * **validate_doc_update** (*string*): :ref:`Validate document update
       <vdufun>` function source

src/api/ddoc/render.rst

@@ -16,6 +16,10 @@
 ``/db/_design/design-doc/_show/show-name``
 ==========================================
 
+.. warning::
+
+    Show functions are deprecated in CouchDB 3.0, and will be removed in CouchDB 4.0.
+
 .. http:get:: /{db}/_design/{ddoc}/_show/{func}
     :synopsis: Executes a show function against null document
 
@@ -76,6 +80,10 @@
 ``/db/_design/design-doc/_show/show-name/doc-id``
 =================================================
 
+.. warning::
+
+    Show functions are deprecated in CouchDB 3.0, and will be removed in CouchDB 4.0.
+
 .. http:get:: /{db}/_design/{ddoc}/_show/{func}/{docid}
     :synopsis: Executes a show function against the specified document
 
@@ -137,6 +145,10 @@
 ``/db/_design/design-doc/_list/list-name/view-name``
 ====================================================
 
+.. warning::
+
+    List functions are deprecated in CouchDB 3.0, and will be removed in CouchDB 4.0.
+
 .. http:get:: /{db}/_design/{ddoc}/_list/{func}/{view}
     :synopsis: Executes a list function against the view from the same
                design document
@@ -204,6 +216,10 @@
 ``/db/_design/design-doc/_list/list-name/other-ddoc/view-name``
 ===============================================================
 
+.. warning::
+
+    List functions are deprecated in CouchDB 3.0, and will be removed in CouchDB 4.0.
+
 .. http:get:: /{db}/_design/{ddoc}/_list/{func}/{other-ddoc}/{view}
     :synopsis: Executes a list function against the view from other
                design document

src/api/ddoc/rewrites.rst

@@ -16,6 +16,10 @@
 ``/db/_design/design-doc/_rewrite/path``
 ========================================
 
+.. warning::
+
+    Rewrites are deprecated in CouchDB 3.0, and will be removed in CouchDB 4.0.
+
 .. http:any:: /{db}/_design/{ddoc}/_rewrite/{path}
     :synopsis: Rewrites HTTP request for the specified path by using stored
                array of routing rules or JavaScript function

src/config/http.rst

@@ -527,6 +527,10 @@ Cross-Origin Resource Sharing
 Per Virtual Host Configuration
 ------------------------------
 
+.. warning::
+
+    Virtual Hosts are deprecated in CouchDB 3.0, and will be removed in CouchDB 4.0.
+
 To set the options for a :section:`vhosts`, you will need to create a section
 with the vhost name prefixed by ``cors:``. Example case for the vhost
 `example.com`::
@@ -549,6 +553,10 @@ or behaviour.
 Virtual Hosts
 =============
 
+.. warning::
+
+    Virtual Hosts are deprecated in CouchDB 3.0, and will be removed in CouchDB 4.0.
+
 .. config:section:: vhosts :: Virtual Hosts
 
     CouchDB can map requests to different locations based on the ``Host``

src/ddocs/ddocs.rst

@@ -328,6 +328,10 @@ objects.
 Show Functions
 ==============
 
+.. warning::
+
+    Show functions are deprecated in CouchDB 3.0, and will be removed in CouchDB 4.0.
+
 .. function:: showfun(doc, req)
 
     :param doc: The document that is being processed; may be omitted.
@@ -450,6 +454,10 @@ correctly, and keys with invalid characters, but you've got the idea!
 List Functions
 ==============
 
+.. warning::
+
+    List functions are deprecated in CouchDB 3.0, and will be removed in CouchDB 4.0.
+
 .. function:: listfun(head, req)
 
     :param head: :ref:`view_head_info_object`

src/intro/security.rst

@@ -270,8 +270,7 @@ special security-related constraints applied. Below is a list of how the
   (:get:`GET /_users/_all_docs </{db}/_all_docs>`)
 - Only administrators may listen to :ref:`changes feed
   <changes>` (:get:`GET /_users/_changes </{db}/_changes>`)
-- Only administrators may execute design functions like :ref:`views <viewfun>`,
-  :ref:`shows <showfun>` and :ref:`others <ddocs>`
+- Only administrators may execute design functions like :ref:`views <viewfun>`.
 - There is a special design document ``_auth`` that cannot be modified
 - Every document except the `design documents` represent registered
   CouchDB users and belong to them

src/query-server/index.rst

@@ -17,9 +17,8 @@ Query Server
 ============
 
 The `Query server` is an external process that communicates with CouchDB by JSON
-protocol through stdio interface and processed all
-:ref:`design functions <ddocs>` calls:
-:ref:`views <viewfun>`, :ref:`shows <showfun>`, :ref:`lists <listfun>` and more.
+protocol through stdio interface and processes all
+:ref:`design functions <ddocs>` calls, such as JavaScript :ref:`views <viewfun>`.
 
 The default query server is written in
 :ref:`JavaScript <query-server/js>`, running via `Mozilla SpiderMonkey`_.

src/query-server/protocol.rst

@@ -325,6 +325,10 @@ second phase.
 ``shows``
 ---------
 
+.. warning::
+
+    Show functions are deprecated in CouchDB 3.0, and will be removed in CouchDB 4.0.
+
 :Command: ``ddoc``
 :SubCommand: ``shows``
 :Arguments:
@@ -421,6 +425,10 @@ The Query Server sends::
 ``lists``
 ---------
 
+.. warning::
+
+    List functions are deprecated in CouchDB 3.0, and will be removed in CouchDB 4.0.
+
 :Command: ``ddoc``
 :SubCommand: ``lists``
 :Arguments:

src/whatsnew/3.0.rst

@@ -139,6 +139,19 @@ CouchDB 3.0:
   default. A setting exists in the configuration file to revert this behaviour. The
   ability to override the disable setting is expected to be removed in CouchDB 4.0.
 
+Deprecated feature warnings
+---------------------------
+
+The following features are deprecated in CouchDB 3.0 and will be removed in CouchDB 4.0:
+
+* Show functions (``/{db}/{ddoc}/_show``)
+
+* List functions (``/{db}/{ddoc}/_list``)
+
+* Virtual hosts and ini-file rewrites
+
+* Rewrite functions (``/{db}/{ddoc}/_rewrite``)
+
 .. _release/3.0.0:
 
 Version 3.0.0