Skip to content

[Homebrew/Packaging] Hand manual-page viewing to its bottle#1077

Draft
brandonpayton wants to merge 1 commit into
integration/package-deferred-tree-clean-qk044from
feature/man-package-candidate-qk044
Draft

[Homebrew/Packaging] Hand manual-page viewing to its bottle#1077
brandonpayton wants to merge 1 commit into
integration/package-deferred-tree-clean-qk044from
feature/man-package-candidate-qk044

Conversation

@brandonpayton

Copy link
Copy Markdown
Member

Why

The placeholder man inside posix-utils-lite prints raw files and cannot own normal manual-page behavior. The real mandoc Formula in tap PR #87 should own lookup, formatting, sections, and paging instead.

Manual pages should remain in the bottle for the package that documents them. Merely seeing or statting a linked page must not download it, and reading one page must not materialize unrelated packages.

What changes

  • Remove only the old posix-utils-lite man output from the registry recipe and rootfs projection.
  • Remove its browser lazy-asset import.
  • Regenerate every affected program-package manifest and cache identity.
  • Add a two-bottle runtime-layer test that verifies:
    • manual-page links and metadata are visible without fetching;
    • first read fetches exactly the owning bottle;
    • sibling files from that bottle become available;
    • the unrelated manual-page bottle remains deferred until its own first read.

Stack and rollout

This draft is stacked on #1069. It must not land by itself: tap PR #87 must first publish and validate the real mandoc bottle, and the shell selection must install that replacement so no user-visible man gap is introduced.

Evidence

Exact head: c9c1a85daff17929a2599d7cfb6226f032a051c1

  • Homebrew VFS builder suite: 114/114 passed
  • package/rootfs/browser projection suites: 37/37 passed
  • per-bottle manual-page lazy ownership test: passed
  • generated projection and git diff --check: passed

No kernel, libc, or ABI contract changes.

Retire only the placeholder posix-utils-lite man command so the real mandoc Formula owns manual-page lookup, formatting, and paging. Regenerate every affected package identity instead of leaving stale cache keys.

Prove that linked manual pages remain metadata-only until read, that each first lookup fetches exactly its owning bottle, and that unrelated manual-page bottles stay deferred.
@github-actions

Copy link
Copy Markdown

Phase B-1 matrix build status — pr-1077-staging

ABI v41. 11 built, 0 failed, 11 total.

Package Arch Status Sha
homebrew-bootstrap wasm32 built 5abead30
kandelo-sdk wasm32 built 55c851c7
mariadb-test wasm32 built 0daddd6b
mariadb-vfs wasm32 built cc0b7173
mariadb-vfs wasm64 built 981d439e
posix-utils-lite wasm32 built 62b3b9ea
shell wasm32 built a54feec0
lamp wasm32 built a33a2baf
node-vfs wasm32 built 9d2b98b7
rootfs wasm32 built 51c8a279
wordpress wasm32 built 87effdc9

Auto-generated; replaced on each push. Raw data in the publish-status workflow artifact.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant