aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAvatar Ciaran McCreesh <ciaran.mccreesh@googlemail.com> 2006-09-12 20:15:58 +0000
committerAvatar Ciaran McCreesh <ciaran.mccreesh@googlemail.com> 2006-09-12 20:15:58 +0000
commitcc6ef4567cfda582014a46e5ea534d5dda7cf9cf (patch)
tree8ff7bbc1e14ffac8a6d60ebd4a6f8d3b3411aedf
parent73989ab9a441154c65f19809c50fd5178da2729b (diff)
downloadpaludis-cc6ef4567cfda582014a46e5ea534d5dda7cf9cf.tar.gz
paludis-cc6ef4567cfda582014a46e5ea534d5dda7cf9cf.tar.xz
Update known issues doc
-rw-r--r--doc/doc_known_issues.doxygen22
-rw-r--r--doc/header.html2
2 files changed, 21 insertions, 3 deletions
diff --git a/doc/doc_known_issues.doxygen b/doc/doc_known_issues.doxygen
index 7b29ae7..db7b562 100644
--- a/doc/doc_known_issues.doxygen
+++ b/doc/doc_known_issues.doxygen
@@ -1,14 +1,18 @@
/* vim: set ft=cpp tw=80 sw=4 et : */
/**
-\page KnownIssues Known Issues
+\page KnownIssues Known Issues and Non-Issues
-\section KnownIssuesMain About these issues
+\section KnownIssuesMain About the issues
This document describes some of the more commonly encountered problems, issues
and things that aren't bugs but might look like they are. Pestering anyone about
these is liable to get you hurt.
+\section KnownIssuesMain About the non-issues
+
+This document also describes some things that are not bugs or missing functionality. Pestering anyone about these is liable to get you hurt a lot.
+
\section KnownIssuesPackages Packages
\subsection KnownIssuesUdev sys-fs/udev
@@ -57,6 +61,20 @@ Problem: Sandbox violations when ROOT!=/
Workaround: Paludis enforces ROOT. However, some packages don't honour ROOT. To
temporarily disable sandbox for these packages, <code>export SANDBOX_PREDICT=/</code>.
+\section KnownNonIssuesPortageThings Things Portage Does
+
+\subsection KnownNonIssuesWget wget Resume Support
+
+Non-Problem: With Portage, <code>wget -c</code> is used to attempt to resume downloads of partial files. With Paludis, resumes are not allowed.
+
+Rationale: This leads to corruption and wasted bandwidth far too frequently. In particular, if an error page that isn't recognised as a 404 is fetched from one server (this is common for <code>mirror://sourceforge/</code>), resume support means <code>wget</code> would then download all but the first few hundred bytes of the file from somewhere else, leading to a corrupt distfile notice only after lots of bandwidth has been wasted.
+
+\subsection KnownNonIssesResume Resume / Skip First Support
+
+Non-Problem: Paludis doesn't have an equivalent to --resume --skipfirst in Portage.
+
+Rationale: Too unreliable, too flaky and far too widely abused. There's talk of echoing a command (<code>paludis -i10 =sys-apps/foo-1.23-r1 =app-misc/fnord-2 ...</code>) that can be used to resume if an ebuild exits with an error, but that's not set in stone.
+
*/
diff --git a/doc/header.html b/doc/header.html
index d6934f6..e1c5daf 100644
--- a/doc/header.html
+++ b/doc/header.html
@@ -20,7 +20,7 @@
<div class="qindex">User Documentation: [
<a class="qindex" href="BootstrapHowto.html">Bootstrap&nbsp;Howto</a> |
<a class="qindex" href="MigrationHowto.html">Migration&nbsp;Howto</a> |
- <a class="qindex" href="KnownIssues.html">Known&nbsp;Issues</a>&nbsp;(<strong>Important</strong>) |
+ <a class="qindex" href="KnownIssues.html">Known&nbsp;Issues&nbsp;and&nbsp;Non-Issues</a>&nbsp;(<strong>Important</strong>) |
<a class="qindex" href="ConfigurationFiles.html">Configuration&nbsp;Files</a> |
<a class="qindex" href="PortageDifferences.html">Portage&nbsp;Differences</a> ]
</div>