os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Update cutting-edge chapter to cover svnlite in place of installing the

Browse source 
svn package.

PR:		230176
Reviewed by:	bcr
This commit is contained in:
Tom Rhodes 2019-03-08 18:48:04 +00:00
parent f1ac792898
commit a4792a6334
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=52849
1 changed files with 12 additions and 13 deletions
Download patch file Download diff file Expand all files Collapse all files

25
en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml
View file

@ -114,10 +114,10 @@
</itemizedlist>
<note>
<para>Throughout this chapter, <command>svn</command> is used to
obtain and update &os; sources. To use it, first install the
<para>Throughout this chapter, <command>svnlite</command> is used to
obtain and update &os; sources. Optionally, the
<package>devel/subversion</package> port or
package.</para>
package may be used.</para>
</note>
</sect1>
@ -688,15 +688,14 @@ before running "/usr/sbin/freebsd-update install"</screen>
<para>Rebuilding the &os; documentation from source requires a
collection of tools which are not part of the &os; base
system. The required tools, including
<application>svn</application>, can be installed from the
system. The required tools can be installed from the
<package>textproc/docproj</package> package or port developed
by the &os; Documentation Project.</para>
<para>Once installed, use <application>svn</application> to
<para>Once installed, use <application>svnlite</application> to
fetch a clean copy of the documentation source:</para>
<screen>&prompt.root; <userinput>svn checkout https://svn.FreeBSD.org/doc/head /usr/doc</userinput></screen>
<screen>&prompt.root; <userinput>svnlite checkout https://svn.FreeBSD.org/doc/head /usr/doc</userinput></screen>
<para>The initial download of the documentation sources may take
a while. Let it run until it completes.</para>
@ -1031,7 +1030,7 @@ before running "/usr/sbin/freebsd-update install"</screen>
<listitem>
<para>Synchronize with the &os.current; sources. Typically,
<link linkend="svn">svn</link> is used to check out the
<link linkend="svn">svnlite</link> is used to check out the
-CURRENT code from the <literal>head</literal> branch of
one of the Subversion mirror sites listed in
<xref linkend="svn-mirrors"/>.</para>
@ -1184,7 +1183,7 @@ before running "/usr/sbin/freebsd-update install"</screen>
<step>
<title>Update and Build</title>
<screen>&prompt.root; <userinput>svn update /usr/src</userinput> <co xml:id="updating-src-qs-svnup"/>
<screen>&prompt.root; <userinput>svnlite update /usr/src</userinput> <co xml:id="updating-src-qs-svnup"/>
<emphasis>check <filename>/usr/src/UPDATING</filename></emphasis> <co xml:id="updating-src-qs-review-updating"/>
&prompt.root; <userinput>cd /usr/src</userinput> <co xml:id="updating-src-qs-cd"/>
&prompt.root; <userinput>make -j<replaceable>4</replaceable> buildworld</userinput> <co xml:id="updating-src-qs-buildworld"/>
@ -1267,16 +1266,16 @@ before running "/usr/sbin/freebsd-update install"</screen>
<application>Subversion</application> version control system.
Verify that the source code is under version control:</para>
<screen>&prompt.root; <userinput>svn info /usr/src</userinput>
<screen>&prompt.root; <userinput>svnlite info /usr/src</userinput>
Path: /usr/src
Working Copy Root Path: /usr/src
...</screen>
<para>This indicates that <filename>/usr/src/</filename>
is under version control and can be updated with
&man.svn.1;:</para>
&man.svnlite.1;:</para>
<screen xml:id="synching">&prompt.root; <userinput>svn update /usr/src</userinput></screen>
<screen xml:id="synching">&prompt.root; <userinput>svnlite update /usr/src</userinput></screen>
<para>The update process can take some time if the directory has
not been updated recently. After it finishes, the source code
@ -1357,7 +1356,7 @@ Working Copy Root Path: /usr/src
That path is used when checking out the source:</para>
<screen>&prompt.root; <userinput>mv /usr/src /usr/src.bak</userinput> <co xml:id="updating-src-obtaining-src-mv"/>
&prompt.root; <userinput>svn checkout https://svn.freebsd.org/base/<replaceable>releng/10.3</replaceable> /usr/src</userinput> <co xml:id="updating-src-obtaining-src-checkout-cmd"/></screen>
&prompt.root; <userinput>svnlite checkout https://svn.freebsd.org/base/<replaceable>releng/10.3</replaceable> /usr/src</userinput> <co xml:id="updating-src-obtaining-src-checkout-cmd"/></screen>
<calloutlist>
<callout arearefs="updating-src-obtaining-src-mv">