Deprecate mod_python issue2551005

Planning deprecation of mod_python. Intent it to replace with
mod_wsgi, but we have no good docs for it.

Author: rouilj

doc/FAQ.txt

@@ -26,8 +26,8 @@ The cgi-bin is very slow!
 Yep, it sure is. It has to start up Python and load all of the support
 libraries for *every* request.
 
-The solution is to use the built in server (or possibly the mod_python
-or WSGI support).
+The solution is to use the built in server (or possibly mod_wsgi
+or other WSGI support).
 
 To make Roundup more seamless with your website, you may place the built
 in server behind apache and link it into your web tree (see below).

doc/customizing.txt

@@ -4003,7 +4003,7 @@ be able to give a summary of the total time spent on a particular issue.
    and 40 minutes).
 
 6. If you're using a persistent web server - ``roundup-server`` or
-   ``mod_python`` for example - then you'll need to restart that to pick up
+   ``mod_wsgi`` for example - then you'll need to restart that to pick up
    the code changes. When that's done, you'll be able to use the new
    time logging interface.
 

doc/features.txt

@@ -62,7 +62,7 @@ from Ka-Ping Yee in the Software Carpentry "Track" design competition.
  - authentication of user registration and user-driven password resetting
    using email and one time keys
  - may be run using WSGI or through CGI as a normal cgi script, as a
-   stand-alone web server, under mod_python or through Zope
+   stand-alone web server, under mod_wsgi (mod_python is deprecated) or through Zope
  - searching may be performed using many constraints, including a full-text
    search of messages attached to issues
  - file attachments (added through the web or email) are served up with the

doc/installation.txt

@@ -376,8 +376,8 @@ There are multiple web interfaces to choose from:
 2. `cgi-bin for limited-access hosting`_
 3. `stand-alone web server`_
 4. `Zope product - ZRoundup`_
-5. `Apache HTTP Server with mod_python`_
-6. `WSGI handler`_
+5. `WSGI handler`_  (to be written `Apache HTTP Server with mod_wsgi`_)
+6. `Apache HTTP Server with mod_python`_  (deprecated)
 
 You may need to give the web server user permission to access the tracker home
 - see the `UNIX environment steps`_ for information. You may also need to
@@ -505,9 +505,23 @@ code tree lib/python/Products.
 When you next (re)start up Zope, you will be able to add a ZRoundup object
 that interfaces to your new tracker.
 
+Apache HTTP Server with mod_wsgi
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+This needs to be developed by somebody. See:
+https://issues.roundup-tracker.org/issue2550566 to see if there has
+been something developed.
+
+See the main web site for `mod_wsgi`_.
+
 Apache HTTP Server with mod_python
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+As of roundup 2.0, mod_python support is deprecated. The apache.py
+file is still available, but may be limited to working for Python 2
+only. Using mod_wsgi with Apache is the recommended way to deploy
+roundup under apache.
+
 `Mod_python`_ is an `Apache`_ module that embeds the Python interpreter
 within the server.  Running Roundup this way is much faster than all
 above options and, like `web server cgi-bin`_, allows you to use HTTPS
@@ -1119,6 +1133,7 @@ from installation and scripts.
 .. _apache: http://httpd.apache.org/
 .. _flup: https://pypi.org/project/flup/
 .. _mod_python: http://modpython.org/
+.. _mod_wsgi: https://pypi.org/project/mod-wsgi/
 .. _MySQLdb: https://pypi.org/project/mysqlclient/
 .. _Psycopg: http://initd.org/psycopg/
 .. _pysqlite: https://pysqlite.org/