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

Brush up a bit the Ports CVSup method:

Browse source 
- We currently state "Install the net/cvsup port"; let's point directly
  to the package, in particular cvsup-without-gui since all commands, in
  the text, used the legacy "-g"...
- Most of people do not edit the ports-supfile and directly use the -h
  argument for the CVSup server, the reader should uses/knows that.
- Keep, as note, the ports-supfile edition for a "hardcoded" CVSup
  server
- I kept the odd <link linkend/<xref linkend way, maybe this should be
  fixed

The text should, now, be closer to what we do when it's time to CVSup
the Ports tree.
This commit is contained in:
Marc Fonvieille 2005-08-13 16:42:42 +00:00
parent 0aee5437b7
commit 17b5c290e0
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=25358
1 changed files with 46 additions and 18 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

64
en_US.ISO8859-1/books/handbook/ports/chapter.sgml
View file

@ -659,39 +659,67 @@ docbook =
<step>
<para>Install the <filename
role="package">net/cvsup</filename> port. See <link
role="package">net/cvsup-without-gui</filename> package:</para>
<screen>&prompt.root; <userinput>pkg_add -r cvsup-without-gui</userinput></screen>
<para>See <link
linkend="cvsup-install">CVSup Installation</link> (<xref
linkend="cvsup-install">) for more details.</para>
</step>
<step>
<para>As <username>root</username>, copy
<filename>/usr/share/examples/cvsup/ports-supfile</filename>
to a new location, such as <filename>/root</filename> or your
home directory.</para>
</step>
<para>Run <command>cvsup</command>:</para>
<step>
<para>Edit <filename>ports-supfile</filename>.</para>
</step>
<screen>&prompt.root; <userinput>cvsup -L 2 -h <replaceable>cvsup.FreeBSD.org</replaceable> /usr/share/examples/cvsup/ports-supfile</userinput></screen>
<step>
<para>Change
<replaceable>CHANGE_THIS.FreeBSD.org</replaceable> to a
<replaceable>cvsup.FreeBSD.org</replaceable> to a
<application>CVSup</application> server near you. See
<link linkend="cvsup-mirrors">CVSup Mirrors</link> (<xref
linkend="cvsup-mirrors">) for a complete listing of mirror
sites.</para>
<note>
<para>One may want to use his own
<filename>ports-supfile</filename>, for example to avoid
the need of passing the <application>CVSup</application>
server on the command line.</para>
<procedure>
<step>
<para>In this case, as <username>root</username>, copy
<filename>/usr/share/examples/cvsup/ports-supfile</filename>
to a new location, such as
<filename>/root</filename> or your home
directory.</para>
</step>
<step>
<para>Edit <filename>ports-supfile</filename>.</para>
</step>
<step>
<para>Change
<replaceable>CHANGE_THIS.FreeBSD.org</replaceable>
to a <application>CVSup</application> server near
you. See <link linkend="cvsup-mirrors">CVSup
Mirrors</link> (<xref linkend="cvsup-mirrors">) for
a complete listing of mirror sites.</para>
</step>
<step>
<para>And now to run <command>cvsup</command>, use the
following:</para>
<screen>&prompt.root; <userinput>cvsup -L 2 <replaceable>/root/ports-supfile</replaceable></userinput></screen>
</step>
</procedure>
</note>
</step>
<step>
<para>Run <command>cvsup</command>:</para>
<screen>&prompt.root; <userinput>cvsup -g -L 2 <replaceable>/root/ports-supfile</replaceable></userinput></screen>
</step>
<step>
<para>Running this command later will download and apply all
<para>Running the &man.cvsup.1; command later will download and apply all
the recent changes to your Ports Collection, except
actually rebuilding the ports for your own system.</para>
</step>