[svnbook] r6057 committed - trunk/en/book

Daniel Sahlberg daniel.l.sahlberg at gmail.com
Fri Aug 19 06:54:10 UTC 2022


While going through the source for these updates, I made a few notes.

There are two links to collab.net that don't work very well:
* ch04-branching-and-merging.xml#svn.branchmerge.advanced.finalword
  There is an article written by Paul Burba about merge-info (
http://www.open.collab.net/community/subversion/articles/merge-info.html).
www.open.collab.net seems to respond and it even redirects to https,
however the server doesn't support TLS 1.2 and the two browsers I tried
(Firefox and Edge under Win11) both frowned upon the site. I was able to
reach the site using Links (under Ubuntu).
* ch06-server-configuration.xml#svn.serverconfig.pathbasedauthz.gotchas
  There is a link to a blog post by C. Michael Pilato (
http://blogs.collab.net/subversion/2007/03/authz_and_anon_/) where I can't
figure out a way to get the original content from collab.net. It is
possible to access it through archive.org
(*https://web.archive.org/web/20130721090205/http://blogs.collab.net:80/subversion/authz_and_anon_
<https://web.archive.org/web/20130721090205/http://blogs.collab.net:80/subversion/authz_and_anon_>*).
There is a TODO: note "Merge content from the blog post into the book".
Is it possible to rehost those? I assume copyright comes into play in
delicate ways.

Regarding examples:
I changed one (1) pointing to svn.apache.org. Most other were using
example.com and I didn't change those.
There are a few using http://svn.red-bean.com
(ch03-advanced-topics.xml#svn.advanced.pegrevs,
ref-svn.xml#svn.ref.svn.c.blame). I'm not sure if they are supposed to be
working examples (they currently DON'T work, with different error messages
E170011: Repository moved permanently, E175003: The server at '...' does
not support the HTTP/DAV protocol, svn: E235000: In file
'../subversion/libsvn_client/util.c' line 96: assertion failed
(svn_uri__is_ancestor(pathrev->repos_root_url, url))).
If they are supposed to be working, then someone should probably give the
server some love and care. Otherwise we should probably rewrite them to
example.com. Thoughts?

Kind regards,
Daniel


Den fre 19 aug. 2022 kl 08:29 skrev <danielsahlberg at users.sourceforge.net>:

> Revision: 6057
>           http://sourceforge.net/p/svnbook/source/6057
> Author:   danielsahlberg
> Date:     2022-08-19 06:28:42 +0000 (Fri, 19 Aug 2022)
> Log Message:
> -----------
> Replace http:// links with https:// and update links when the old target
> no longer exists.
>
> * en/book/appa-quickstart.xml
>   (svn.intro.install): s/http/https/ for apache.org
>
> * en/book/appc-webdav.xml
>   (svn.webdav.clients.standalone.free): www.ics.uci.edu/~webdav redirect
> to www.davexplorer.org
>   (svn.webdav.clients.file-explorer-extensions.linux-de): s/http/https/
> for gnome.org and kde.org (and kde.org seems to redirect www.k.o to k.o)
>   (svn.webdav.clients.fs-impl.windows): s/http/https/ for
> southrivertech.com (and it seems to redirect www.s.c to s.c)
>   (svn.webdav.clients.fs-impl.linux): s/http/https/ for nongnu.org
>
> * en/book/ch00-preface.xml
>   (svn.intro.righttool): s/http/https/ for git-scm.com and
> mercurial-scm.org (and mercurial-scm.org seems to redirect
> mercurial-scm.org to www.mercurial-scm.org)
>   (svn.intro.history): s/http/https/ for collab.net and apache.org
>   (svn.intro.whatsnew): s/http/https/ for apache.org
>   (svn.preface.free): s/http/https/ for svnbook.red-bean.com
>
> * en/book/ch03-advanced-topics.xml
>   (svn.advanced.changelists): s/http/https/ for mail.google.com,
> www.youtube.com and www.flickr.com
>
> * en/book/ch04-branching-and-merging.xml
>   (svn.branchmerge.basicmerging.reintegrate): s/http/https/ for
> svnbook.red-bean.com
>
> * en/book/ch06-server-configuration.xml
>   (svn.serverconfig.httpd): s/http/https/ for apache.org
>   (svn.serverconfig.httpd.authn.basic): s/http/https/ for apache.org
>   (svn.serverconfig.httpd.authn.digest): s/http/https/ for apache.org
>   (svn.serverconfig.httpd.authz.blanket): s/http/https/ for apache.org
>   (svn.serverconfig.httpd.ssl.server): s/http/https/ for apache.org and
> openssl.org (and openssl.org seems to redirect openssl.org to
> www.openssl.org)
>   (svn.serverconfig.httpd.extra.browsing.syntax): s/http/https/ viewvc.org,
> trac.edgewall.org and websvnphp.github.io
>
> * en/book/ch08-embedding-svn.xml
>   (svn.developer.usingapi): s/http/https/ for apache.org
>   (svn.developer.usingapi.otherlangs): s/http/https/ for swig.org and
> svnkit.com
>
> Modified Paths:
> --------------
>     trunk/en/book/appa-quickstart.xml
>     trunk/en/book/appc-webdav.xml
>     trunk/en/book/ch00-preface.xml
>     trunk/en/book/ch03-advanced-topics.xml
>     trunk/en/book/ch04-branching-and-merging.xml
>     trunk/en/book/ch06-server-configuration.xml
>     trunk/en/book/ch08-embedding-svn.xml
>
> Modified: trunk/en/book/appa-quickstart.xml
> ===================================================================
> --- trunk/en/book/appa-quickstart.xml   2022-08-18 09:07:57 UTC (rev 6056)
> +++ trunk/en/book/appa-quickstart.xml   2022-08-19 06:28:42 UTC (rev 6057)
> @@ -46,7 +46,7 @@
>
>      <para>The easiest way to get Subversion is to download a binary
>        package built for your operating system.  Subversion's web site
> -      (<ulink url="http://subversion.apache.org"/>) often has these
> +      (<ulink url="https://subversion.apache.org"/>) often has these
>        packages available for download, posted by volunteers.  The site
>        usually contains graphical installer packages for users of
>        Microsoft operating systems.  If you run a Unix-like operating
> @@ -67,7 +67,7 @@
>        Subversion repository in which it lives.  Obviously, you'll need
>        to already have a Subversion client on hand to do this.  But
>        once you do, you can check out a working copy from
> -      <ulink url="http://svn.apache.org/repos/asf/subversion"
> +      <ulink url="https://svn.apache.org/repos/asf/subversion"
>        /><footnote><para>Note that the URL checked out in the example
>        ends not with <literal>subversion</literal>, but with a
>        subdirectory thereof called <literal>trunk</literal>.  See our
> @@ -76,7 +76,7 @@
>
>      <informalexample>
>        <screen>
> -$ svn checkout http://svn.apache.org/repos/asf/subversion/trunk
> subversion
> +$ svn checkout https://svn.apache.org/repos/asf/subversion/trunk
> subversion
>  A    subversion/HACKING
>  A    subversion/INSTALL
>  A    subversion/README
>
> Modified: trunk/en/book/appc-webdav.xml
> ===================================================================
> --- trunk/en/book/appc-webdav.xml       2022-08-18 09:07:57 UTC (rev 6056)
> +++ trunk/en/book/appc-webdav.xml       2022-08-19 06:28:42 UTC (rev 6057)
> @@ -457,7 +457,7 @@
>
>          <para>DAV Explorer is another standalone WebDAV client, written
>            in Java.  It's under a free Apache-like license and is
> -          available at <ulink url="http://www.ics.uci.edu/~webdav/"/>.
> +          available at <ulink url="https://www.davexplorer.org/"/>.
>            It does everything cadaver does, but has the
>            advantages of being portable and being a more user-friendly GUI
>            application.  It's also one of the first clients to support
> @@ -576,9 +576,9 @@
>          <title>Nautilus, Konqueror</title>
>
>          <para>Nautilus is the official file manager/browser for the
> -          GNOME desktop (<ulink url="http://www.gnome.org"/>), and
> +          GNOME desktop (<ulink url="https://www.gnome.org"/>), and
>            Konqueror is the manager/browser for the KDE desktop (<ulink
> -          url="http://www.kde.org"/>).  Both of these applications
> +          url="https://kde.org"/>).  Both of these applications
>            have an explorer-level WebDAV client built in, and they
>            operate just fine against an autoversioning repository.</para>
>
> @@ -626,7 +626,7 @@
>            contents of these WebDAV-backed pseudodrives as easily as
>            you can against real local hard drives, and in the same
>            ways.  You can purchase WebDrive from South River
> -          Technologies (<ulink url="http://www.southrivertech.com"/>).
> +          Technologies (<ulink url="https://southrivertech.com"/>).
>            Novell's NetDrive is freely available online, but requires
>            users to have a NetWare license.</para>
>
> @@ -679,7 +679,7 @@
>
>          <para>Linux davfs2 is a filesystem module for the Linux
>            kernel, whose development is organized at
> -         <ulink url="http://savannah.nongnu.org/projects/davfs2"/>.
> Once you
> +         <ulink url="https://savannah.nongnu.org/projects/davfs2"/>.
> Once you
>            install davfs2, you can mount a WebDAV network share using
>            the usual Linux mount command:</para>
>
>
> Modified: trunk/en/book/ch00-preface.xml
> ===================================================================
> --- trunk/en/book/ch00-preface.xml      2022-08-18 09:07:57 UTC (rev 6056)
> +++ trunk/en/book/ch00-preface.xml      2022-08-19 06:28:42 UTC (rev 6057)
> @@ -191,8 +191,8 @@
>          methodology of version control called <firstterm>distributed
>          version control</firstterm> has likewise garnered widespread
>          attention and adoption.  Tools such as Git
> -        (<ulink url="http://git-scm.com/" />) and Mercurial
> -        (<ulink url="http://mercurial-scm.org/" />) have risen
> +        (<ulink url="https://git-scm.com/" />) and Mercurial
> +        (<ulink url="https://www.mercurial-scm.org/" />) have risen
>          to the tops of the distributed version control system (DVCS)
>          ranks.  Distributed version control harnesses the growing
>          ubiquity of high-speed network connections and low storage
> @@ -253,7 +253,7 @@
>          <indexterm>
>            <primary>CollabNet</primary>
>          </indexterm>In early 2000, CollabNet,
> -        Inc. (<ulink url="http://www.collab.net"/>) began seeking
> +        Inc. (<ulink url="https://www.collab.net"/>) began seeking
>          developers to write a replacement for CVS.  CollabNet
>          offered<footnote><para>CollabNet Enterprise Edition has since
>          been replaced by a new product line called CollabNet
> @@ -326,7 +326,7 @@
>          Subversion contributors.  In early 2010, Subversion was fully
>          adopted into the ASF's family of top-level projects, moved its
>          web presence to
> -        <ulink url="http://subversion.apache.org"/>, and was
> +        <ulink url="https://subversion.apache.org"/>, and was
>          rechristened <quote>Apache Subversion</quote>.</para>
>
>      </sect2>
> @@ -510,7 +510,7 @@
>          summary of major new changes since Subversion 1.0.  Note that
>          this is not a complete list; for full details, please visit
>          Subversion's web site at
> -        <ulink url="http://subversion.apache.org"/>.</para>
> +        <ulink url="https://subversion.apache.org"/>.</para>
>
>        <variablelist>
>
> @@ -973,7 +973,7 @@
>
>      <para>The online home of this book's development and most of the
>        volunteer-driven translation efforts regarding it is
> -      <ulink url="http://svnbook.red-bean.com"/>.  There you can find
> +      <ulink url="https://svnbook.red-bean.com"/>.  There you can find
>        links to the latest releases and tagged versions of the book in
>        various formats, as well as instructions for accessing the
>        book's Subversion repository (where its DocBook XML source
>
> Modified: trunk/en/book/ch03-advanced-topics.xml
> ===================================================================
> --- trunk/en/book/ch03-advanced-topics.xml      2022-08-18 09:07:57 UTC
> (rev 6056)
> +++ trunk/en/book/ch03-advanced-topics.xml      2022-08-19 06:28:42 UTC
> (rev 6057)
> @@ -5248,7 +5248,7 @@
>        applied to working copy files for the express purpose of
>        associating multiple files together.  Users of many of Google's
>        software offerings are familiar with this concept already.  For
> -      example, <ulink url="http://mail.google.com/">Gmail</ulink>
> +      example, <ulink url="https://mail.google.com/">Gmail</ulink>
>        doesn't provide the traditional folders-based email organization
>        mechanism.  In Gmail, you apply arbitrary labels to emails, and
>        multiple emails can be said to be part of the same group if they
> @@ -5256,8 +5256,8 @@
>        similarly labeled emails then becomes a simple user interface
>        trick.  Many other Web 2.0 sites have similar
>        mechanisms—consider the <quote>tags</quote> used by sites
> -      such as <ulink url="http://www.youtube.com/">YouTube</ulink> and
> -      <ulink url="http://www.flickr.com/">Flickr</ulink>,
> +      such as <ulink url="https://www.youtube.com/">YouTube</ulink> and
> +      <ulink url="https://www.flickr.com/">Flickr</ulink>,
>        <quote>categories</quote> applied to blog posts, and so on.
>        Folks understand today that organization of data is critical,
>        but that how that data is organized needs to be a flexible
>
> Modified: trunk/en/book/ch04-branching-and-merging.xml
> ===================================================================
> --- trunk/en/book/ch04-branching-and-merging.xml        2022-08-18
> 09:07:57 UTC (rev 6056)
> +++ trunk/en/book/ch04-branching-and-merging.xml        2022-08-19
> 06:28:42 UTC (rev 6057)
> @@ -1277,7 +1277,7 @@
>          versions require some special handling before a feature branch
>          can be reintegrated more than once.  See the earlier version of
>          this chapter for more information: <ulink
> -        url="
> http://svnbook.red-bean.com/en/1.7/svn.branchmerge.basicmerging.html#svn.branchemerge.basicmerging.reintegrate
> "
> +        url="
> https://svnbook.red-bean.com/en/1.7/svn.branchmerge.basicmerging.html#svn.branchemerge.basicmerging.reintegrate
> "
>          /></para></footnote>. If you do this, only the changes made on
> your
>          branch after the first reintegrate are merged to the trunk.</para>
>      </sect2>
>
> Modified: trunk/en/book/ch06-server-configuration.xml
> ===================================================================
> --- trunk/en/book/ch06-server-configuration.xml 2022-08-18 09:07:57 UTC
> (rev 6056)
> +++ trunk/en/book/ch06-server-configuration.xml 2022-08-19 06:28:42 UTC
> (rev 6057)
> @@ -2008,9 +2008,9 @@
>        of the use of these directives, describing them in full is
>        outside the scope of this chapter.  The Apache team maintains
>        excellent documentation, publicly available on their web site at
> -      <ulink url="http://httpd.apache.org"/>.  For example, a general
> +      <ulink url="https://httpd.apache.org"/>.  For example, a general
>        reference for the configuration directives is located at
> -      <ulink url="
> http://httpd.apache.org/docs/current/mod/directives.html"
> +      <ulink url="
> https://httpd.apache.org/docs/current/mod/directives.html"
>        />.</para>
>
>      <para>Also, as you make changes to your Apache setup, it is likely
> @@ -2317,7 +2317,7 @@
>            Basic authentication mechanism, which simply uses a username
>            and password to verify a user's identity.  Apache provides
>            the <command>htpasswd</command> utility<footnote><para>See
> -          <ulink url="
> http://httpd.apache.org/docs/current/programs/htpasswd.html"
> +          <ulink url="
> https://httpd.apache.org/docs/current/programs/htpasswd.html"
>            />.</para></footnote> for managing files containing
>            usernames and passwords.</para>
>
> @@ -2502,7 +2502,7 @@
>            uses a different file format than Basic authentication,
>            created and managed using Apache's <command>htdigest</command>
>            utility<footnote><para>See
> -          <ulink url="
> http://httpd.apache.org/docs/current/programs/htdigest.html"
> +          <ulink url="
> https://httpd.apache.org/docs/current/programs/htdigest.html"
>            />.</para></footnote> rather than <command>htpasswd</command>.
>            Digest authentication also has the additional concept of a
>            <quote>realm</quote>, which must match the value of the
> @@ -2634,7 +2634,7 @@
>            <literal>Require</literal> directive, take a look at the
>            <literal>Security</literal> section of the Apache
>            documentation's tutorials collection at <ulink
> -          url="http://httpd.apache.org/docs-2.0/misc/tutorials.html
> "/>.</para>
> +          url="https://httpd.apache.org/docs-2.0/misc/tutorials.html
> "/>.</para>
>
>        </sect3>
>
> @@ -2922,7 +2922,7 @@
>            generate client and server SSL certificates and how to
>            configure Apache to use them.  Many other references,
>            including Apache's own documentation (<ulink
> -          url="http://httpd.apache.org/docs/current/ssl/"/>),
> +          url="https://httpd.apache.org/docs/current/ssl/"/>),
>            describe the process.</para>
>
>          <tip>
> @@ -2929,7 +2929,7 @@
>            <para>SSL certificates from well-known entities generally
>              cost money, but at a bare minimum, you can configure
>              Apache to use a self-signed certificate generated with a
> -            tool such as OpenSSL (<ulink url="http://openssl.org"
> +            tool such as OpenSSL (<ulink url="https://www.openssl.org"
>              />).<footnote><para>While self-signed certificates are
>              still vulnerable to a <quote>man-in-the-middle</quote>
>              attack (before a client sees the certificate for the first
> @@ -3347,9 +3347,9 @@
>              properties.  For folks who require more extensive browsing
>              of repositories and their history, there are several
>              third-party software packages which offer this.  Some
> -            examples include ViewVC (<ulink url="http://viewvc.org" />),
> -            Trac (<ulink url="http://trac.edgewall.org" />) and WebSVN
> -            (<ulink url="http://websvnphp.github.io" />).  These
> third-party
> +            examples include ViewVC (<ulink url="https://viewvc.org" />),
> +            Trac (<ulink url="https://trac.edgewall.org" />) and WebSVN
> +            (<ulink url="https://websvnphp.github.io" />).  These
> third-party
>              tools don't affect <command>mod_dav_svn</command>'s
>              built-in <quote>browseability</quote>, and generally offer
>              a much wider set of features, including the display of the
>
> Modified: trunk/en/book/ch08-embedding-svn.xml
> ===================================================================
> --- trunk/en/book/ch08-embedding-svn.xml        2022-08-18 09:07:57 UTC
> (rev 6056)
> +++ trunk/en/book/ch08-embedding-svn.xml        2022-08-19 06:28:42 UTC
> (rev 6057)
> @@ -658,7 +658,7 @@
>      <para>Another good source of information about programming against
>        the Subversion APIs is the project's own hacking guidelines,
>        which you can find at
> -      <ulink url="http://subversion.apache.org/docs/community-guide/"
> +      <ulink url="https://subversion.apache.org/docs/community-guide/"
>        />.  This document contains useful information, which, while
>        aimed at developers and would-be developers of Subversion
>        itself, is equally applicable to folks developing against
> @@ -841,7 +841,7 @@
>          compensate for complex APIs that SWIG needs some help
>          translating between languages.  For more information on SWIG
>          itself, see the project's web site at <ulink
> -        url="http://www.swig.org/"/>.</para>
> +        url="https://www.swig.org/"/>.</para>
>
>        <para>Subversion also has language bindings for Java.  The
>          javahl bindings (located in
> @@ -871,7 +871,7 @@
>          interface than the more C-like APIs provided by Subversion's
>          own Python bindings.  And if you're looking for a pure Java
>          implementation of Subversion, check out SVNKit (<ulink
> -        url="http://svnkit.com/" />), which is Subversion rewritten
> +        url="https://svnkit.com/" />), which is Subversion rewritten
>          from the ground up in Java.</para>
>
>        <sidebar>
> @@ -880,7 +880,7 @@
>          <para>In 2005, a small company called TMate announced the
>            1.0.0 release of JavaSVN—a pure Java implementation of
>            Subversion.  Since then, the project has been renamed to
> -          SVNKit (available at <ulink url="http://svnkit.com/" />)
> +          SVNKit (available at <ulink url="https://svnkit.com/" />)
>            and has seen great success as a provider of Subversion
>            functionality to various Subversion clients, IDE
>            integrations, and other third-party tools.</para>
> @@ -899,7 +899,7 @@
>            be accompanied by information on how to obtain complete
>            source code for the software that uses SVNKit and any
>            accompanying software that uses the software that uses
> -          SVNKit. See <ulink url="http://svnkit.com/license.html" />
> +          SVNKit. See <ulink url="https://svnkit.com/license.html" />
>            for details.</para></footnote>  Finally, by aiming to be a
>            pure Java Subversion library, SVNKit is limited in which
>            portions of Subversion can be reasonably cloned while still
>
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mailman.red-bean.com/pipermail/svnbook-dev/attachments/20220819/aa644091/attachment-0001.htm>


More information about the svnbook-dev mailing list