summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorThierry Vignaud <tv@mageia.org>2013-02-25 17:57:02 +0000
committerThierry Vignaud <tv@mageia.org>2013-02-25 17:57:02 +0000
commit1062d8ac4e6bb3bd2db54c1c73c661eb90df7418 (patch)
tree6327f7a4e468c6e65a5527df71dd1673503f8f1a
parent68f8bd824d92d4e83ca6d8ac64c58f9b29754cf4 (diff)
downloadurpmi-1062d8ac4e6bb3bd2db54c1c73c661eb90df7418.tar
urpmi-1062d8ac4e6bb3bd2db54c1c73c661eb90df7418.tar.gz
urpmi-1062d8ac4e6bb3bd2db54c1c73c661eb90df7418.tar.bz2
urpmi-1062d8ac4e6bb3bd2db54c1c73c661eb90df7418.tar.xz
urpmi-1062d8ac4e6bb3bd2db54c1c73c661eb90df7418.zip
(run) document it
-rw-r--r--NEWS3
-rw-r--r--urpm/main_loop.pm88
2 files changed, 91 insertions, 0 deletions
diff --git a/NEWS b/NEWS
index a98bc377..7121c8e0 100644
--- a/NEWS
+++ b/NEWS
@@ -1,3 +1,6 @@
+- library:
+ o enhanced doc
+
Version 7.19 - 9 February 2013, by Thierry Vignaud
- add basic support for --downgrade (mga#6655)
diff --git a/urpm/main_loop.pm b/urpm/main_loop.pm
index 656950da..66b211b3 100644
--- a/urpm/main_loop.pm
+++ b/urpm/main_loop.pm
@@ -345,6 +345,94 @@ Run the main urpm loop:
Warning: locking is left to callers...
+Parameters:
+
+=over
+
+=item $urpm: the urpm object
+
+=item $state: the state object (see L<URPM>)
+
+=item $something_was_to_be_done
+
+=item $ask_unselect: an array ref of packages that could not be selected
+
+=item $callbacks: a hash ref of callbacks :
+
+=over
+
+=item trans_log: called for displaying download progress
+
+=item interaction with user:
+
+=over
+
+=item ask_yes_or_no($_title, $msg)
+
+=item need_restart($need_restart_formatted) called when restarting urpmi is needed (priority upgrades)
+
+=item message($_title, $msg): display a message (with a title for GUIes)
+
+=back
+
+=item signature management:
+
+=over
+
+=item pre_check_sig(): signature checking startup (for rpmdrake)
+
+=item check_sig(): signature checking progress (for rpmdrake)
+
+=item bad_signature($msg, $msg2): called when a package is not/badly signed
+
+=back
+
+=item removable media management:
+
+=over
+
+=item pre_removable(): called before handling removable media (for rpmdrake)
+
+=item copy_removable($medium_name): called for asking inserting a CD/DVD
+
+=item post_extract($set, $transaction_sources, $transaction_sources_install) called after handling removable media (for rpmdrake)
+
+=back
+
+=item packages installation callbacks (passed to urpm::install::install())
+
+=over
+
+=item open_helper(): called when opening a package, must return a fd
+
+=item close_helper(): called when package is closed
+
+=item inst() called for package opening/progress/end
+
+=item trans() called for transaction opening/progress/end
+
+=item callback_report_uninst(): called for erasure progrses
+
+=back
+
+=item finish callbacks (mainly GUI callbacks for rpmdrake/gurpmi/drakx)
+
+=over
+
+=item completed(): called when everything is completed (for cleanups)
+
+=item trans_error_summary($nok, $errors) called to warn than $nok transactions failed with $errors messages
+
+=item success_summary() called on success
+
+=item already_installed_or_not_installable($msg1, $msg2)
+
+=back
+
+=back
+
+=back
+
=cut