From b0817c4208d09ea19fb91d950cb8987b24e1188c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Robert=20Kr=C3=A1tk=C3=BD?= Date: Thu, 16 Jul 2026 22:00:56 +0200 Subject: [PATCH] docs: add update_output.txt line type explanations to proposed-migration (fixes #398) --- docs/.custom_wordlist.txt | 2 ++ .../proposed-migration/issues-preventing-migration.md | 9 +++++++++ 2 files changed, 11 insertions(+) diff --git a/docs/.custom_wordlist.txt b/docs/.custom_wordlist.txt index cc98e874e..2637a6e95 100644 --- a/docs/.custom_wordlist.txt +++ b/docs/.custom_wordlist.txt @@ -3,6 +3,7 @@ ABIs Ayatana allowlist apport +baz archs auditable autobuilders @@ -163,6 +164,7 @@ rasdaemon recompiles repo retracer +recurse RFPs Rockcraft Rosbrook diff --git a/docs/how-ubuntu-is-made/processes/proposed-migration/issues-preventing-migration.md b/docs/how-ubuntu-is-made/processes/proposed-migration/issues-preventing-migration.md index 28b814bbc..ef6024f85 100644 --- a/docs/how-ubuntu-is-made/processes/proposed-migration/issues-preventing-migration.md +++ b/docs/how-ubuntu-is-made/processes/proposed-migration/issues-preventing-migration.md @@ -183,6 +183,15 @@ If the package, as shown in [update_excuses](https://ubuntu-archive-team.ubuntu. ### Parse the {file}`update_output.txt` file +The {file}`update_output.txt` file is the complete output of the proposed-migration scripts as they recurse through candidate packages. It is terse, but understanding its line types helps: + +* **`trying:`** — the script is evaluating whether this package can migrate. +* **`accepted:`** — the package (or group) appears to make things better and is accepted into the release pocket. +* **`skipped:`** — the package makes things worse and is not accepted. +* **`recur:`** — shows the recursion path. For example, `recur: [foo bar] baz` means "having already found that foo and bar make things better, now trying baz to see what happens, even though it breaks things." + +After all candidates have been tried, the script compares the total number of broken packages before and after. If the result is better, the changes are accepted; otherwise they are discarded. + Using the {pkg}`exim4` package as an example. 1. Find the package in [update output.txt](https://ubuntu-archive-team.ubuntu.com/proposed-migration/update_output.txt):