git: a82c0a6a07 - main - Handbook - Mirrors: Remove Subversion info
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Sun, 29 Dec 2024 16:34:02 UTC
The branch main has been updated by carlavilla: URL: https://cgit.FreeBSD.org/doc/commit/?id=a82c0a6a071d497a45085ceacf8864881b3f9c6d commit a82c0a6a071d497a45085ceacf8864881b3f9c6d Author: Sergio Carlavilla Delgado <carlavilla@FreeBSD.org> AuthorDate: 2024-12-29 16:33:42 +0000 Commit: Sergio Carlavilla Delgado <carlavilla@FreeBSD.org> 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