Skip to content

docs: document pre_srpm_build and umount_root hooks#1714

Merged
praiskup merged 1 commit intorpm-software-management:mainfrom
praiskup:praiskup-document-pre-srpm-hook
Feb 18, 2026
Merged

docs: document pre_srpm_build and umount_root hooks#1714
praiskup merged 1 commit intorpm-software-management:mainfrom
praiskup:praiskup-document-pre-srpm-hook

Conversation

@praiskup
Copy link
Member

No description provided.

Copy link

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request adds documentation for the pre_srpm_build and umount_root plugin hooks. The changes are clear and maintain the alphabetical order of the hook list. I have one suggestion to improve the clarity of the umount_root documentation by providing more context about its execution order relative to other hooks.

* remove_snapshot
* rollback_to
* scrub
* umount_root - The counterpart to mount_root; called to instruct the buildroot-managing plugin to unmount the buildroot.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

For better clarity and consistency with other hook descriptions, consider adding more context about when umount_root is called. Mentioning its position relative to other hooks like postumount and postclean would be very helpful for plugin developers. Also, mount_root should be enclosed in backticks for consistency.

Suggested change
* umount_root - The counterpart to mount_root; called to instruct the buildroot-managing plugin to unmount the buildroot.
* umount_root - The counterpart to `mount_root`. Called during cleanup to instruct a buildroot-managing plugin to unmount the buildroot. It is called after `postumount` and before `postclean`.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It is not called after postumount.

@praiskup praiskup added no-release-notes no-ci-builds No need to run CI automation (Packit, Copr builds, Testing Farm, ...) labels Feb 18, 2026
@praiskup praiskup mentioned this pull request Feb 18, 2026
@praiskup praiskup merged commit 90f552e into rpm-software-management:main Feb 18, 2026
13 of 30 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

no-ci-builds No need to run CI automation (Packit, Copr builds, Testing Farm, ...) no-release-notes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants