From e85987ab2281e765a2b3e19aefe7f99f656428d8 Mon Sep 17 00:00:00 2001 From: David Kalnischkies Date: Sat, 5 May 2018 01:37:47 +0200 Subject: move special READMEs into doc/ and format as md The formatting is very basic and more should probably be done, but we at least get the files out of the root directory which in case of the various READMEs was confusing salsa which one display as (central) README. --- README.progress-reporting | 69 ----------------------------------------------- 1 file changed, 69 deletions(-) delete mode 100644 README.progress-reporting (limited to 'README.progress-reporting') diff --git a/README.progress-reporting b/README.progress-reporting deleted file mode 100644 index 134ed5334..000000000 --- a/README.progress-reporting +++ /dev/null @@ -1,69 +0,0 @@ -Install-progress reporting --------------------------- - -If the apt options: "APT::Status-Fd" is set, apt will send status -reports to that fd. The status information is separated with a ':', -there are the following status conditions: - -status = {"pmstatus", "dlstatus", "conffile-prompt", "error", "media-change" } - -The reason for using a fd instead of a OpProgress class is that many -apt front-end fork a (vte) terminal for the actual installation. - -The reason to do the mapping and l10n of the dpkg states to human -readable (and translatable) strings is that this way the translation -needs to be done only once for all front-ends. - - -pmstatus --------- -Status of the package manager (dpkg). This is send when packages -are installed/removed. -pmstatus:pkgname:TotalPercentage:action-description - -PkgName = the name of the package -TotalPercentage = the total progress between [0..100] -description = a i18ned human readable description of the current action - - -Example: -# ./apt-get install -o APT::Status-Fd=2 3dchess >/dev/null -pmstatus:3dchess:20:Preparing 3dchess -pmstatus:3dchess:40:Unpacking 3dchess -pmstatus:3dchess:60:Preparing to configure 3dchess -pmstatus:3dchess:80:Configuring 3dchess -pmstatus:3dchess:100:Installed 3dchess - -pmerror -------- -pmerror:deb:TotalPercentage:error string - -Example: -pmerror: /var/cache/apt/archives/krecipes_0.8.1-0ubuntu1_i386.deb : 75% : trying to overwrite `/usr/share/doc/kde/HTML/en/krecipes/krectip.png', which is also in package krecipes-data - - -pmconffile ----------- -pmconffile:conffile:percent:'current-conffile' 'new-conffile' useredited distedited - - -media-change ------------- -media-change:medium:drive:human-readable string - -example: -media-change: Ubuntu 5.10 _Breezy Badger_ - Alpha i386 (20050830):/cdrom/:Please insert the disc labeled: 'Ubuntu 5.10 _Breezy Badger_ - Alpha i386 (20050830)' in the drive '/cdrom/' and press enter. - - -dlstatus --------- -dlstatus:AlreadDownloaded:TotalPercentage:action-description - -AlreadyDownloaded = the number of already downloaded packages -TotalPercentage = the total progress between [0..100] -description = a i18ned human readable description of the current action - -Example: -dlstatus:1:9.05654:Downloading file 1 of 3 (4m40s remaining) -dlstatus:1:9.46357:Downloading file 1 of 3 (4m39s remaining) -dlstatus:1:9.61022:Downloading file 1 of 3 (4m38s remaining) -- cgit v1.2.3