Author: hartmannathan
Date: Fri Nov 15 17:42:51 2019
New Revision: 1869871
URL: http://svn.apache.org/viewvc?rev=1869871&view=rev
Log:
INSTALL: Unify Python-related dependency info from 1.14 release notes
* INSTALL:
(Section I.C. "Dependencies in Detail" -- Python) Bring in the far
more detailed Python dependency info that was added to the 1.14
release notes in r1869856, but with some editing to better fit the
context of INSTALL. In particular, the new text explains when the
optional dependency of Python is needed and when it is not. Also,
bump the Python version to 3.x, but with a paragraph explaining
that although 2.7 support is being phased out, it technically
still works.
Suggested by: julianfoad
Modified:
subversion/trunk/INSTALL
Modified: subversion/trunk/INSTALL
URL:
http://svn.apache.org/viewvc/subversion/trunk/INSTALL?rev=1869871&r1=1869870&r2=1869871&view=diff
==============================================================================
--- subversion/trunk/INSTALL (original)
+++ subversion/trunk/INSTALL Fri Nov 15 17:42:51 2019
@@ -415,13 +415,53 @@ I. INTRODUCTION
is done: See section III for details.
- 10. Python 2.7 or newer (https://www.python.org/) (OPTIONAL)
+ 10. Python 3.x or newer (https://www.python.org/) (OPTIONAL)
+
+ Subversion does not require Python for its basic operation.
+ However, Python is required for building and testing Subversion
+ and for using Subversion's SWIG Python bindings or hook scripts
+ coded in Python.
+
+ The majority of Subversion's test suite is written in Python, as
+ is part of Subversion's build system.
+
+ In more detail, Python is required to do any of the following:
+
+ * Use the SWIG Python bindings.
+ * Use the ctypes Python bindings.
+ * Use hook scripts coded in Python.
+ * Build Subversion from a tarball on Unix-like systems and run
+ Subversion's test suite as described in section II.B.
+ * Build Subversion on Windows as described in section II.E.
+ * Build Subversion from a working copy checked out from
+ Subversion's own repository (whether or not running the test
+ suite).
+ * Build the SWIG Python bindings.
+ * Build the ctypes Python bindings.
+ * Testing as described in section III.D.
+
+ The Python bindings are used by:
+
+ * Third-party programs (e.g., ViewVC)
+ * Scripts distributed with Subversion itself in the tools/
+ subdirectory.
+ * Any in-house scripts you may have.
+
+ Python is NOT required to do any of the following:
+
+ * Use the core command-line binaries (svn, svnadmin, svnsync,
+ etc.)
+ * Use Subversion's C libraries.
+ * Use any of Subversion's other language bindings.
+ * Build Subversion from a tarball on Unix-like systems without
+ running Subversion's test suite
+
+ Although this section calls for Python 3.x, Subversion still
+ technically works with Python 2.7. However, Support for Python
+ 2.7 is being phased out. As of 1 January 2020, Python 2.7 has
+ reached end of life. All users are strongly encouraged to move
+ to Python 3.
- If you want to run "make check" or build from the latest source
- under Unix/Windows as described in section II.B, II.E and III.D,
- install Python 2.7 or higher on your system. The majority of the
- test suite is written in Python, as is part of Subversion's build
- system.
11. Perl 5.8 or newer (Windows only) (OPTIONAL)
