loader(8) <https://www.freebsd.org/cgi/man.cgi?query=loader&sektion=8&manpath=FreeBSD> * does not mention loader.efi(8) loader.efi(8) <https://www.freebsd.org/cgi/man.cgi?query=loader.efi&sektion=8&manpath=FreeBSD> * does not mention loader(8) or uefi(8) uefi(8) <https://www.freebsd.org/cgi/man.cgi?query=uefi&sektion=8&manpath=FreeBSD> * mentions loader.efi but not loader.efi(8)
Please feel free to work with your mentor to update those manual pages, doc committers are encouraged to work on the doc parts in the src repo.
(In reply to Li-Wen Hsu from comment #1) The coding that's used for manual pages is not my strength. If anyone else would like to make a start on this, whilst I'm away: you're welcome.
Created attachment 240099 [details] Patch uefi(8) as suggested I notice that the suggested changes to loader(8) and loader.efi(8) have already been made. The attached patch resolves the final issue with uefi(8). Please apply it using `git am 0001-Refer-to-a-related-manual-page.patch` to resolve this issue.
(In reply to Tom Hukins from comment #3) I used the content of <https://bz-attachments.freebsd.org/attachment.cgi?id=240099>, which includes the 'From:' line, to create the diff in Phabricator. Is the author information (you) hidden somewhere in Phabricator? I see only my name as author, which is wrong.
(In reply to Graham Perrin from comment #4) I haven't used Phabricator yet, so I don't know. Like you, I see nothing at https://reviews.freebsd.org/D39577 that includes my commit message or committer details. Let me know if it would help for me to create a Phabricator account or if there's anything else I can do to help with this ticket.
(In reply to Tom Hukins from comment #5) Thanks, it makes more sense to me after seeing <https://git-scm.com/docs/git-am>. When the time comes, I'll make a separate commit. (In reply to Tom Hukins from comment #3) > … the suggested changes to loader(8) and loader.efi(8) have already been > made. … Found: cherry-pick <https://github.com/freebsd/freebsd-src/commit/80a80b130ab1f2be89a17758baab48ec04de7444> (2023-01-24).
Please also add description with examples of EFIBOOTMGR !! This utility is completely missed in the uefi docs / manpages and this was crucial to fix uefi boot on my machine after migration to a different hardware. When there was no boot entry for FreeBSD I had to select boot device from BIOS. I know this is done but bsdinstall but sometimes user needs to do the work by hand. It took me some time to find that utility and understand how it works :-) :-) Thanks :-)
(In reply to Tomasz "CeDeROM" CEDRO from comment #7) > … EFIBOOTMGR !! > > This utility is completely missed in the uefi docs / manpages … efibootmgr(8) does now appear under <https://man.freebsd.org/cgi/man.cgi?query=loader.efi&sektion=8&manpath=freebsd-release#DESCRIPTION> and <https://man.freebsd.org/cgi/man.cgi?query=uefi&sektion=8&manpath=freebsd-release#SEE_ALSO>.
TANK U SIR!! =)
Created attachment 242763 [details] Patch uefi(8) as suggested
A commit in branch main references this bug: URL: https://cgit.FreeBSD.org/src/commit/?id=f49d6f583e9df2839b420f27c44edc5c1fa276c6 commit f49d6f583e9df2839b420f27c44edc5c1fa276c6 Author: Tom Hukins <tom@FreeBSD.org> AuthorDate: 2023-08-31 09:21:40 +0000 Commit: Mitchell Horne <mhorne@FreeBSD.org> CommitDate: 2023-09-04 19:22:30 +0000 uefi(8): Refer to a related manual page PR: 265834 Reviewed by: mhorne MFC after: 3 days Differential Revision: https://reviews.freebsd.org/D39577 share/man/man8/uefi.8 | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-)
I suggest this ticket have its status updated to "fixed" now that the three issues in the initial report have been resolved.
(In reply to Tom Hukins from comment #12) Once I have merged this last change to stable branches, I will mark it as closed&fixed.
A commit in branch stable/14 references this bug: URL: https://cgit.FreeBSD.org/src/commit/?id=d01bbdf4572bd8e8e709f6c0020e7352f7727cff commit d01bbdf4572bd8e8e709f6c0020e7352f7727cff Author: Tom Hukins <tom@FreeBSD.org> AuthorDate: 2023-08-31 09:21:40 +0000 Commit: Mitchell Horne <mhorne@FreeBSD.org> CommitDate: 2023-09-11 21:42:03 +0000 uefi(8): Refer to a related manual page PR: 265834 Reviewed by: mhorne MFC after: 3 days Differential Revision: https://reviews.freebsd.org/D39577 (cherry picked from commit f49d6f583e9df2839b420f27c44edc5c1fa276c6) share/man/man8/uefi.8 | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-)
A commit in branch stable/13 references this bug: URL: https://cgit.FreeBSD.org/src/commit/?id=9c6710cd2453b84b115bbdc029de74876fcf6b2f commit 9c6710cd2453b84b115bbdc029de74876fcf6b2f Author: Tom Hukins <tom@FreeBSD.org> AuthorDate: 2023-08-31 09:21:40 +0000 Commit: Mitchell Horne <mhorne@FreeBSD.org> CommitDate: 2023-09-11 21:44:24 +0000 uefi(8): Refer to a related manual page PR: 265834 Reviewed by: mhorne MFC after: 3 days Differential Revision: https://reviews.freebsd.org/D39577 (cherry picked from commit f49d6f583e9df2839b420f27c44edc5c1fa276c6) share/man/man8/uefi.8 | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-)
A commit in branch releng/14.0 references this bug: URL: https://cgit.FreeBSD.org/src/commit/?id=481d727f3ede5362991b89545f072c28c07745c5 commit 481d727f3ede5362991b89545f072c28c07745c5 Author: Tom Hukins <tom@FreeBSD.org> AuthorDate: 2023-08-31 09:21:40 +0000 Commit: Mitchell Horne <mhorne@FreeBSD.org> CommitDate: 2023-09-11 22:34:08 +0000 uefi(8): Refer to a related manual page PR: 265834 Reviewed by: mhorne Approved by: re (delphij) Differential Revision: https://reviews.freebsd.org/D39577 (cherry picked from commit f49d6f583e9df2839b420f27c44edc5c1fa276c6) (cherry picked from commit d01bbdf4572bd8e8e709f6c0020e7352f7727cff) share/man/man8/uefi.8 | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-)