On Fri, Nov 15, 2019 at 8:22 AM Nathan Hartman <[email protected]> wrote:
> On Fri, Nov 15, 2019 at 7:59 AM Daniel Shahaf <[email protected]> > wrote: > >> How about just spelling out the list of known-good and known-bad cases? >> For >> example: >> >> [[[ >> Python is optional. >> >> Subversion does not 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. >> >> In more detail, Python is required for doing any of the following: >> >> * Build Subversion on Windows >> * Build Subversion from a tarball on Unix-like systems and run the test >> suite >> * Build Subversion from a working copy checked out from Subversion's own >> repository >> * Use the SWIG Python bindings >> * Use the ctypes Python bindings >> >> The bindings are used by third-party programs (e.g., ViewVC), as well as >> by >> scripts distributed with Subversion itself in the <a href="…">tools/ >> subdirectory</a>. They may also be used by any in-house scripts you [= >> the >> reader] may have. >> >> Python is *not* required for doing any of the following: >> >> * Build Subversion from a tarball on Unix-like systems without running >> the test suite >> * Use the core command-line binaries (svn, svnadmin, svnsync, …) >> * Use the C libraries >> * Use any other language bindings >> ]]] > > An edited form is committed to staging in r1869856. Edits: * Reordered some of the bulletpoints to put items directed toward end users first, followed by items directed toward builders and developers. * Added that building the SWIG or ctypes Python bindings requires Python. * Made the word ViewVC a link to ViewVC's GitHub project. I wanted to make this a link to viewvc.org but that does not work with https and I would like to avoid our readers getting a browser warning. * I did not (yet) make tools/ a href to 1.13's tools directory. Link: https://subversion-staging.apache.org/docs/release-notes/1.14.html Thanks for your invaluable help so far and as always, I appreciate any thoughts, criticisms, and suggestions... Cheers, Nathan
