hartmannathan_at_apache.org wrote on Fri, Nov 15, 2019 at 14:52:50 -0000:
> 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.
Thanks for HTMLifying and committing that. More below.
> +++ 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.
This sentence is inaccurate: hook scripts written in Python that don't require
the bindings will not be an issue. Suggestion: say "for building Subversion
and for using the SWIG Python bindings", then move the "The Python bindings are
used by:" bit to after this paragraph.
> 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>
⋮
> +</ul>
> +
> +<p>The Python bindings are used by:</p>
> +
> +<ul>
> +<li>Third-party programs (e.g.,
> + ViewVC)</li>
> +<li>Scripts distributed with Subversion itself in the tools/
> + subdirectory.</li>
> +<li>Any in-house scripts you may have.</li>
> +</ul>
Cheers,
Daniel
Received on 2019-11-16 00:40:02 CET