aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAvatar Ciaran McCreesh <ciaran.mccreesh@googlemail.com> 2009-10-15 13:26:57 +0100
committerAvatar Ciaran McCreesh <ciaran.mccreesh@googlemail.com> 2009-10-15 13:26:57 +0100
commitfa0523349f3a99978786fe8e49db5260d079cfb2 (patch)
tree5b4b98a9f7f6d031cd89b0127844c502bcb88ce5
parent0f90fa7150e882fdf218419375c3c4a719831346 (diff)
downloadpaludis-fa0523349f3a99978786fe8e49db5260d079cfb2.tar.gz
paludis-fa0523349f3a99978786fe8e49db5260d079cfb2.tar.xz
Document updates
-rw-r--r--doc/faq/index.html.part1
-rw-r--r--doc/faq/operation.html.part21
2 files changed, 22 insertions, 0 deletions
diff --git a/doc/faq/index.html.part b/doc/faq/index.html.part
index 55452cc..ab270d7 100644
--- a/doc/faq/index.html.part
+++ b/doc/faq/index.html.part
@@ -43,6 +43,7 @@ functionality. Pestering anyone about these is liable to get you hurt a lot.</p>
<li><a href="operation.html#updateworldmissesthings">Updating world misses things</a></li>
<li><a href="operation.html#info">Get package information for a bug report</a></li>
<li><a href="operation.html#arrows">What do those fancy arrows when merging things mean?</a></li>
+ <li><a href="operation.html#updates">Profiles Updates for Package Moves and Slot Moves</a></li>
</ul>
<h2>Stricter than Portage</h2>
diff --git a/doc/faq/operation.html.part b/doc/faq/operation.html.part
index 0bd9303..e0c3261 100644
--- a/doc/faq/operation.html.part
+++ b/doc/faq/operation.html.part
@@ -6,6 +6,7 @@
<li><a href="operation.html#updatingdepends">Paludis does not update DEPENDs of already installed packages</a></li>
<li><a href="operation.html#updateworldmissesthings">Updating world misses things</a></li>
<li><a href="operation.html#info">Get package information for a bug report</a></li>
+ <li><a href="operation.html#updates">Profiles Updates for Package Moves and Slot Moves</a></li>
</ul>
<h2 id="updatingdepends">Paludis does not update DEPENDs of already installed packages</h2>
@@ -77,3 +78,23 @@ If it's an installed package, <em>spec</em> can usually just be the qualified pa
<dd>Copied xattrs</dd>
</dl></li>
</ul>
+
+<h2 id="updates">Profiles Updates for Package Moves and Slot Moves</h2>
+
+<p>Gentoo includes support for repositories specifying that a package has moved (e.g. <code>app-misc/foo</code> is now
+called <code>app-admin/foo</code>) or changed slot (e.g. <code>app-misc/foo:0</code> is now
+<code>app-misc/foo:2</code>). Paludis has experimental support for performing these updates after a sync, but by default
+updates are not carried out.</p>
+
+<p><strong>Carrying out updates is not guaranteed to work. Before allowing Paludis to carry out updates, you should back
+ up your VDB. If you don't know what this means, wait until updates have received wider testing. If you don't have a
+ backup of your VDB and things do go wrong, you will have to do a full system reinstall to fix things.</strong></p>
+
+<p>If you fully understand the above paragraph, you can set the <code>PALUDIS_CARRY_OUT_UPDATES</code> environment
+variable to <code>yes</code> and then sync to perform updates.</p>
+
+<p>Sometimes it is possible for renames to cause collisions. For example, if <code>foo</code> is being renamed to
+<code>bar</code>, and you have both <code>foo</code> and <code>bar</code> installed, Paludis will be unable to perform
+the update. In this situation, you should generally manually uninstall the older of <code>foo</code> or
+<code>bar</code>.</p>
+