hartmannat...@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.,
> +    <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>

Cheers,

Daniel

Reply via email to