From nobody Sun Dec 29 16:34:02 2024 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4YLlDV5WG5z5jPXS for ; Sun, 29 Dec 2024 16:34:02 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R11" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4YLlDV4rK7z41LY; Sun, 29 Dec 2024 16:34:02 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1735490042; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=s01Ew1JIdOiAbBHUVwiIpVCWMqjrnHFf25iUG6szrKg=; b=o3Lqujn0Q4nDVPhcZopRirwUAMczZx+bNjtPcj3Iom0AxtqHzwaKvwOB3Gdjybo56vd4Yn a1uH/UncFNDA7lar13Bqn2nM9VxCk8AucSpQHUQtaF9AZ37ZGAVIWYv3zOwiB5wheHYcYa WprjfjY75yAVN9nxPmOzPJYhaoPm6hde4ZzaGv9FunsrE+8eqanO8dni2gP+SQLezupriH 9z5oZ59OpPnuq50dOQpCjvg0OqnFbsUpYhQ9/2H6aoaLLY3YkvZOqRjHGO3sZoWi8MlBsW yM9STUpVrY7tT7P7K+8lweCQLr5FSsY2feePd40fvXyuW+ltMInbG0frepBGNQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1735490042; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=s01Ew1JIdOiAbBHUVwiIpVCWMqjrnHFf25iUG6szrKg=; b=vPh9Z5LsHamzwbqIo4tfDJU2Wu1blGr9CvFVmOCkVvgDwnsBL7zFFAq3xPHfpQMBkczze/ +kmar9g1rZ69nCBRK4ky7cKvDZwbisyDs0nE/3WNcU3MFg2m9j3iK8AgXCzVp6nNn1wiIW qT9h/LbIp+JdN/TMiOev1U3n4P7mVfMQd0KeBuWMqth2IKH8oviqfj2xXpaqhkKP1bAyM1 WgRvf/9QDHlnACiOOakhKbCM36ds2nav92fdDCaUI4x9ijZ+aYfQdziFK7WWpdyvDSWME1 u41ljCjbV197ZGu9o6uAAnf6QBXccy0ZQzKv4IKAlyibkGhNdo4fYjilVfn9dA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1735490042; a=rsa-sha256; cv=none; b=cEtb9EFkBiEiSBIPQJiASSryprnpMYOEIJC5XMs7kufveJrAjrj5TmD9PGPQ76M5BRwABH 48zkanVkAWqe9xPy7YxnRxHgs4EjdoHVOj9UUGEvDV5dvHSr1OX0YnCGtLq9HTP0dZDMp0 EvtgSQBM7Wyfp79j8kH3itOnKcX+L8yDQaRWVg+pgnYe1f2jKdnsJrn7Sj9A15Y3I4nM67 2mJ5ZCYZiSGFJUx3JDLsF/pfSqD/Wt4PRE9FPgSPcgeMexi2BlAcjlsJwLLeGCFaUJ8SH0 mfxZJDiFauHDg+ybc7380vRZyaxErSjD5ZlSgiZ4zyTXJpvUZO7a95uX7PGEbQ== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4YLlDV4N5CzHd9; Sun, 29 Dec 2024 16:34:02 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 4BTGY2nd067280; Sun, 29 Dec 2024 16:34:02 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 4BTGY2FN067277; Sun, 29 Dec 2024 16:34:02 GMT (envelope-from git) Date: Sun, 29 Dec 2024 16:34:02 GMT Message-Id: <202412291634.4BTGY2FN067277@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Sergio Carlavilla Delgado Subject: git: a82c0a6a07 - main - Handbook - Mirrors: Remove Subversion info List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: carlavilla X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: a82c0a6a071d497a45085ceacf8864881b3f9c6d Auto-Submitted: auto-generated The branch main has been updated by carlavilla: URL: https://cgit.FreeBSD.org/doc/commit/?id=a82c0a6a071d497a45085ceacf8864881b3f9c6d commit a82c0a6a071d497a45085ceacf8864881b3f9c6d Author: Sergio Carlavilla Delgado AuthorDate: 2024-12-29 16:33:42 +0000 Commit: Sergio Carlavilla Delgado CommitDate: 2024-12-29 16:33:42 +0000 Handbook - Mirrors: Remove Subversion info --- .../content/en/books/handbook/mirrors/_index.adoc | 135 --------------------- 1 file changed, 135 deletions(-) diff --git a/documentation/content/en/books/handbook/mirrors/_index.adoc b/documentation/content/en/books/handbook/mirrors/_index.adoc index fef82f8902..9fa9563c3b 100644 --- a/documentation/content/en/books/handbook/mirrors/_index.adoc +++ b/documentation/content/en/books/handbook/mirrors/_index.adoc @@ -437,141 +437,6 @@ For more details, including commit messages lists, see the crossref:handbook/ere These are also published as SSHFP records in DNS. -[[svn]] -== Using Subversion - -[[svn-intro]] -=== Introduction - -As of December 2020, FreeBSD uses git as the primary version control system for storing all of FreeBSD's source code and documentation. -Changes from the git repo on the `stable/11`, `stable/12` and related releng branches are exported to the Subversion repository. -This export will continue through the life of these branches. -From July 2012 to March 2021, FreeBSD used Subversion as the only version control system for storing all of FreeBSD's Ports Collection. -As of April 2021, FreeBSD uses git as the only version control system for storing all of FreeBSD's Ports Collection. - -[NOTE] -==== -Subversion is generally a developer tool. -Users may prefer to use `freebsd-update` (crossref:cutting-edge[updating-upgrading-freebsdupdate,“FreeBSD Update”]) to update the FreeBSD base system, and `git` (crossref:ports[ports-using,“Using the Ports Collection”]) to update the FreeBSD Ports Collection. -After March 2021, Subversion use is only for legacy branches (`stable/11` and `stable/12`). -==== - -This section demonstrates how to install Subversion on a FreeBSD system and use it to create a local copy of a FreeBSD repository. Additional information on the use of Subversion is included. - -[[svn-svnlite]] -=== Svnlite - -A lightweight version of Subversion is already installed on FreeBSD as `svnlite`. -The port or package version of Subversion is only needed if the Python or Perl API is needed, or if a later version of Subversion is desired. - -The only difference from normal Subversion use is that the command name is `svnlite`. - -[[svn-install]] -=== Installation - -If `svnlite` is unavailable or the full version of Subversion is needed, then it must be installed. - -Subversion can be installed from the Ports Collection: - -[source,shell] -.... -# cd /usr/ports/devel/subversion -# make install clean -.... - -Subversion can also be installed as a package: - -[source,shell] -.... -# pkg install subversion -.... - -[[svn-usage]] -=== Running Subversion - -To fetch a clean copy of the sources into a local directory, use `svn`. -The files in this directory are called a _local working copy_. - -[WARNING] -==== -Move or delete an existing destination directory before using `checkout` for the first time. -Checkout over an existing non-`svn` directory can cause conflicts between the existing files and those brought in from the repository. -==== - -Subversion uses URLs to designate a repository, taking the form of _protocol://hostname/path_. -The first component of the path is the FreeBSD repository to access. -There are three different repositories, `base` for the FreeBSD base system source code, `ports` for the Ports Collection, and `doc` for documentation. -For example, the URL `https://svn.FreeBSD.org/base/head/` specifies the main branch of the src repository, using the `https` protocol. - -A checkout from a given repository is performed with a command like this: - -[source,shell] -.... -# svn checkout https://svn.FreeBSD.org/repository/branch lwcdir -.... - -where: - -* _repository_ is one of the Project repositories: `base`, `ports`, or `doc`. -* _branch_ depends on the repository used. `ports` and `doc` are mostly updated in the `head` branch, while `base` maintains the latest version of -CURRENT under `head` and the respective latest versions of the -STABLE branches under `stable/11` (11._x_) and `stable/12` (12._x_). -* _lwcdir_ is the target directory where the contents of the specified branch should be placed. This is usually [.filename]#/usr/ports# for `ports`, [.filename]#/usr/src# for `base`, and [.filename]#/usr/doc# for `doc`. - -This example checks out the Source Tree from the FreeBSD repository using the HTTPS protocol, placing the local working copy in [.filename]#/usr/src#. -If [.filename]#/usr/src# is already present but was not created by `svn`, remember to rename or delete it before the checkout. - -[source,shell] -.... -# svn checkout https://svn.FreeBSD.org/base/head /usr/src -.... - -Because the initial checkout must download the full branch of the remote repository, it can take a while. -Please be patient. - -After the initial checkout, the local working copy can be updated by running: - -[source,shell] -.... -# svn update lwcdir -.... - -To update [.filename]#/usr/src# created in the example above, use: - -[source,shell] -.... -# svn update /usr/src -.... - -The update is much quicker than a checkout, only transferring files that have changed. - -An alternate way of updating the local working copy after checkout is provided by the [.filename]#Makefile# in the [.filename]#/usr/ports#, [.filename]#/usr/src#, and [.filename]#/usr/doc# directories. -Set `SVN_UPDATE` and use the `update` target. -For example, to update [.filename]#/usr/src#: - -[source,shell] -.... -# cd /usr/src -# make update SVN_UPDATE=yes -.... - -[[svn-mirrors]] -=== Subversion Mirror Sites - -The FreeBSD Subversion repository is: - -[.programlisting] -.... -svn.FreeBSD.org -.... - -This is a publicly accessible mirror network that uses GeoDNS to select an appropriate back end server. -To view the FreeBSD Subversion repositories through a browser, use https://svnweb.FreeBSD.org/[https://svnweb.FreeBSD.org/]. - -HTTPS is the preferred protocol, but the [.filename]#security/ca_root_nss# package will need to be installed in order to automatically validate certificates. - -=== For More Information - -For other information about using Subversion, please see the "Subversion Book", titled http://svnbook.red-bean.com/[Version Control with Subversion], or the http://subversion.apache.org/docs/[Subversion Documentation]. - [[mirrors-disc]] == Disc Copies