svn commit: r1869856 - /subversion/site/staging/docs/release-notes/1.14.html

[hartmannathan]

Author: hartmannathan
Date: Fri Nov 15 14:52:50 2019
New Revision: 1869856

URL: http://svn.apache.org/viewvc?rev=1869856&view=rev
Log:
In 'staging': 1.14 release notes: Explain when/how Python is required

* docs/release-notes/1.14.html:
  ("Python is Optional" note box):
    Explain in detail when Subversion requires Python, and also when
    it does not, replacing short and vague paragraph.

Suggested by: danielsh

Modified:
    subversion/site/staging/docs/release-notes/1.14.html

Modified: subversion/site/staging/docs/release-notes/1.14.html
URL: 
http://svn.apache.org/viewvc/subversion/site/staging/docs/release-notes/1.14.html?rev=1869856&r1=1869855&r2=1869856&view=diff
==============================================================================
--- subversion/site/staging/docs/release-notes/1.14.html (original)
+++ subversion/site/staging/docs/release-notes/1.14.html Fri Nov 15 14:52:50 
2019
@@ -272,10 +272,49 @@ Welcome</a> below.</p>
 <div class="notice">
 <p><strong>Python is Optional.</strong></p>
 
-<p>Note that Subversion does not require Python for its basic
-operation. If you are not using Subversion's SWIG Python bindings,
-Subversion's test suite, or other Python-coded tools that ship with
-Subversion, this change does not affect you.</p>
+<p>Subversion does <strong>not</strong> require Python for its basic
+operation. Python is only required for building Subversion and for
+using Subversion's SWIG Python bindings or hook scripts coded in
+Python.  If you do not do either of these things, then this change
+does not affect you.</p>
+
+<p>In more detail, Python is required for doing any of the
+following:</p>
+
+<ul>
+<li>Use the SWIG Python bindings</li>
+<li>Use the ctypes Python bindings</li>
+<li>Build Subversion on Windows</li>
+<li>Build Subversion from a tarball on Unix-like systems and run
+    Subversion's test suite</li>
+<li>Build Subversion from a working copy checked out from Subversion's
+    own repository</li>
+<li>Build the SWIG Python bindings</li>
+<li>Build the ctypes Python bindings</li>
+</ul>
+
+<p>The Python bindings are used by:</p>
+
+<ul>
+<li>Third-party programs (e.g.,
+    <a href="https://github.com/viewvc/viewvc/";>ViewVC</a>)</li>
+<li>Scripts distributed with Subversion itself in the tools/
+    subdirectory.</li>
+<li>Any in-house scripts you may have.</li>
+</ul>
+
+<p>Python is <strong>not</strong> required for doing any of the
+following:</p>
+
+<ul>
+<li>Use the core command-line binaries (svn, svnadmin, svnsync,
+    &hellip;)</li>
+<li>Use Subversion's C libraries</li>
+<li>Use any of Subversion's other language bindings</li>
+<li>Build Subversion from a tarball on Unix-like systems without
+    running Subversion's test suite</li>
+</ul>
+
 </div> <!-- notice -->
 
 </div>  <!-- apis -->