[mgrossmann]

Closes httpd#482. Refs httpd#483 (items 1 to 4; item 5, the JCL headers of the package, comes from the build tool and is not part of this PR).

What changes

• docs/installation.md step 10: the RAKF0004 ... USER:HTTPPRB line is no longer marked "TK5 only"; the text names TK5 (RAKF 1.2.x) and MVS/CE (RAKF 2.0.0), as the books do. It says both starts were measured on throwaway containers.
• docs/installation.md section 12 and guide/ug-remove.typ: the paragraph "not run on a system that holds THTP451" is replaced by the measurement. The five DEL SYSMOD(THTP450) MOD(...) blocks per zone report HMA3572, not HMA2532; figures: UCLIN RC 8, LIST RC 4, HMA2550 35, HMA2532 4, HMA3572 10, no HMA2293, every LIST answer "not found", reinstall RC 0000 with ten HMA2380.
• Skip from 4.4.0 to 4.5.1: now described as run (README, guide/ug-upgrade.typ): RC 0000 in every step, no HMA2380, the banner stays 4.4.0, the library keeps the old modules.
• README troubleshooting row: "library empty" is now "library unchanged"; the matching book row says the library still holds the old modules.
• guide/ug-install.typ: one sentence that a first install on MVS/CE showed the same RAKF0004 line.
• Edition notices of ML07-0001 and ML07-0002: "applies to ... httpd 4.5.1"; the sessions are named as coming from development builds of 4.5.0 and 4.5.1; the install/removal measurements are named.

Captures

23 console captures were recorded again on a throwaway MVS/CE system with a package build of 4.5.1 made from release-4.5.x (version in mbt.toml changed from 4.5.1-dev to 4.5.1, as for the install captures). They are in ex/ug-config, ex/ug-ops, ex/ug-routes, ex/ug-module and ex/ug-security, show 4.5.1 without -DEV, and have the build stamp replaced by nnnnnnn like the install and upgrade captures. Every start now contains the RAKF0004 line of the start probe. ml07-0001 says so in "The Examples in This Book".

Source of the figures

The figures for the removal job on a THTP451 system and the skip are from the QA measurement of the release candidate in throwaway containers (TK5 and MVS/CE images), as recorded in the QA report for the release candidate. They were not repeated for this PR. The MVS/CE start and the new captures were measured on a throwaway MVS/CE container.

Not changed

• ex/ug-security/open-start.txt (needs a RAKF without user and profile tables, which needs an IPL) and ex/ug-remove/dev-banner-dev.txt are from development builds and still show -DEV. The edition notice names them.
• Captures that show no version stay as they were. The notice says they may come from earlier development builds.
• Package JCL headers (item 5 of docs: section 12 and upgrade text still predict what a 4.5.1 system now shows differently #483).

Checks

• typst compile (0.15.1) of ML07-0001 and ML07-0002: rc 0, no errors. sh docs/books/web/build.sh: ok.
• Grep for the old statements ("TK5 only", "not run for this guide", "no package of 4.5.1", "library empty"): no hits.
• No submodule pointer changed.

[read-the-docs-community]

Documentation build overview

📚 httpd | 🛠️ Build #35543792 | 📁 Comparing 0bd8d17 against latest (dca2439)

  🔍 Preview build  

15 files changed · ± 15 modified

± Modified

• guide/index-terms.html
• guide/index.html
• guide/ug-config.html
• guide/ug-first.html
• guide/ug-install.html
• guide/ug-module.html
• guide/ug-ops.html
• guide/ug-remove.html
• guide/ug-routes.html
• guide/ug-security.html
• and 5 more...

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[mgrossmann]

Review of #484 (docs only, base release-4.5.x)

Verdict: APPROVE (no must-fix items). Confidence: high for text and structure, medium-high for the SMP message counts (not checkable against source; see below).

Checked

• docs/installation.md step 10: the TK5 only marker is gone and the text names TK5 (RAKF 1.2.x) and MVS/CE (RAKF 2.0.0), in line with ug-install.typ. The throwaway-container caveat is stated.
• Section 12 and guide/ug-remove.typ: HMA3572 replaces HMA2532 for the ten DEL SYSMOD(THTP450) MOD(...) blocks. The figures (UCLIN RC 8, LIST RC 4, 35x HMA2550, 4x HMA2532, 10x HMA3572, no HMA2293, 14 + 15 LIST answers "not found", reinstall RC 0000 with ten HMA2380) match the QA measurement of the release candidate. The HMA3572 ** MOD ... TO BE DELETED FROM ENTRY DOES NOT EXIST text matches the existing capture ex/ug-remove/dev-old-job-del.txt.
• Skip 4.4.0 -> 4.5.1: now described as run (RC 00 in every step, no HMA2380, banner stays 4.4.0), in README and ug-upgrade.typ. The troubleshooting row says "library unchanged" in both places.
• Edition notices of ML07-0001 and ML07-0002 apply to 4.5.1 and say which sessions come from which build. The residual -DEV captures (open-start.txt, dev-banner-dev.txt) are named there; grep over docs/ shows no other -DEV outside the development-build sections.
• Re-recorded captures (spot checks of start-healthy, d-version, console-session, noprofile-deny-start): 4.5.1 without -DEV, build stamp nnnnnnn, RAKF0004 line present, no internal host or address other than 192.0.2.17.
• CI green on the final commit: build, manuals (typst), SonarCloud gate, Read the Docs preview. No code, no submodule pointer, no mbt.toml change.

Suggestions (not blocking)

• docs/books/guide/ug-install.typ (the added sentences at ~1058) and docs/installation.md (~69-72, ~1432) leave a few over-long lines after the rewrap. Cosmetic only.
• CONS(2) in ex/ug-ops/d-version.txt differs from the other captures (CONS(0)); correct, since it came from the Hercules console, and the text says CONS(n).

Not part of this PR

• Item 5 of docs: section 12 and upgrade text still predict what a 4.5.1 system now shows differently #483 (JCL headers of the package, from the build tool) and HTTPD026W with empty text at every start with the shipped HTTPPRM0 (blank record) #481 (empty-line warning, milestone 4.6.0) stay open.

Next: QA acceptance (the issue has a "Done when"), then merge.