Source string Read only

(itstool) path: sect3/para
444/4440
Context English State
While we can do surgery in an emergency, do not plan on having mistakes fixed behind the scenes. Plan on mistakes remaining in the logs forever. Be sure to check the output of <command>svn status</command> and <command>svn diff</command> before committing.
Mistakes will happen but, they can generally be fixed without disruption.
Take a case of adding a file in the wrong location. The right thing to do is to <command>svn move</command> the file to the correct location and commit. This causes just a couple of lines of metadata in the repository journal, and the logs are all linked up correctly.
The wrong thing to do is to delete the file and then <command>svn add</command> an independent copy in the correct location. Instead of a couple of lines of text, the repository journal grows an entire new copy of the file. This is a waste.
Using a Subversion Mirror
There is a serious disadvantage to this method: every time something is to be committed, a <command>svn relocate</command> to the main repository has to be done, remembering to <command>svn relocate</command> back to the mirror after the commit. Also, since <command>svn relocate</command> only works between repositories that have the same UUID, some hacking of the local repository's UUID has to occur before it is possible to start using it.
Checkout from a Mirror
Check out a working copy from a mirror by substituting the mirror's <acronym>URL</acronym> for <literal>svn+ssh://repo.freebsd.org/base</literal>. This can be an official mirror or a mirror maintained by using <command>svnsync</command>.
Setting up a <application>svnsync</application> Mirror
Avoid setting up a <application>svnsync</application> mirror unless there is a very good reason for it. Most of the time a <command>git</command> mirror is a better alternative. Starting a fresh mirror from scratch takes a long time. Expect a minimum of 10 hours for high speed connectivity. If international links are involved, expect this to take four to ten times longer.
One way to limit the time required is to grab a <link xlink:href="https://download.freebsd.org/ftp/development/subversion/">seed file</link>. It is large (~1GB) but will consume less network traffic and take less time to fetch than svnsync will.

Loading…

None

New source string

FreeBSD Doc / articles_committers-guideEnglish

New source string 2 weeks ago
Browse all component changes

Glossary

English English
No related strings found in the glossary.

Source information

Source string comment
(itstool) path: sect3/para
Labels
No labels currently set.
Flags
read-only
Source string location
article.translate.xml:1837
Source string age
2 weeks ago
Translation file
, string 384