From a2342de0f41e6037cabcfad463857d553b3cf1a1 Mon Sep 17 00:00:00 2001
From: Mark Linimon <linimon@FreeBSD.org>
Date: Tue, 25 May 2010 00:45:09 +0000
Subject: [PATCH] Document the latest/previous dance (controlled by dopackages'
 "skipstart" internal variable).

---
 en_US.ISO8859-1/articles/portbuild/article.sgml | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/en_US.ISO8859-1/articles/portbuild/article.sgml b/en_US.ISO8859-1/articles/portbuild/article.sgml
index 4899b3b719..11de84a14f 100644
--- a/en_US.ISO8859-1/articles/portbuild/article.sgml
+++ b/en_US.ISO8859-1/articles/portbuild/article.sgml
@@ -388,6 +388,15 @@
       </listitem>
     </itemizedlist>
 
+    <para>Unless you specify <literal>-restart</literal>,
+      <literal>-continue</literal>, or <literal>-finish</literal>,
+      the symlinks for the existing builds will be rotated.  i.e,
+      the existing symlink for <filename>previous</filename> will
+      be deleted; the most recent build will have its symlink changed
+      to <filename>previous/</filename>; and a new build will be
+      created and symlinked into <filename>latest/</filename>.
+    </para>
+
     <para>If the last build finished cleanly you do not need to delete
       anything.  If it was interrupted, or you selected
       <literal>-nocleanup</literal>, you need to clean up clients by running