From a6e3d4d872b852de308f19a15215180cb4116765 Mon Sep 17 00:00:00 2001 From: Julian Andres Klode Date: Wed, 10 Jun 2015 23:13:58 +0200 Subject: Acquire: Document that items may have transient errors on run() success If run() succeeded, items may still have transient errors, like a Not Found error. Closes: #680997 --- python/acquire.cc | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) (limited to 'python') diff --git a/python/acquire.cc b/python/acquire.cc index 82968a9d..621f0eef 100644 --- a/python/acquire.cc +++ b/python/acquire.cc @@ -244,10 +244,11 @@ static PyObject *PkgAcquireShutdown(PyObject *Self,PyObject *Args) static PyMethodDef PkgAcquireMethods[] = { {"run",PkgAcquireRun,METH_VARARGS, "run() -> int\n\nRun the fetcher and return one of RESULT_CANCELLED,\n" - "RESULT_CONTINUE, RESULT_FAILED. RESULT_CONTINUE means that all items\n" - "which where queued prior to calling run() have been fetched\n" - "successfully. RESULT_CANCELLED means that the process was canceled\n" - "by the progress class. And RESULT_FAILED means a generic failure."}, + "RESULT_CONTINUE, RESULT_FAILED.\n\n" + "RESULT_CONTINUE means that all items which where queued prior to\n" + "calling run() have been fetched successfully or failed transiently.\n\n" + "RESULT_CANCELLED means canceled by the progress class.\n\n" + "RESULT_FAILED means a generic failure."}, {"shutdown",PkgAcquireShutdown, METH_VARARGS, "shutdown()\n\n" "Shut the fetcher down, removing all items from it. Future access to\n" -- cgit v1.2.3