[Bug 290794] loader.efi is confusing about boot1.efi usage

From: <bugzilla-noreply_at_freebsd.org>
Date: Tue, 04 Nov 2025 16:19:52 UTC
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=290794

            Bug ID: 290794
           Summary: loader.efi is confusing about boot1.efi usage
           Product: Documentation
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Only Me
          Priority: ---
         Component: Manual Pages
          Assignee: bugs@FreeBSD.org
          Reporter: mm@dorfdsl.de
                CC: doc@FreeBSD.org

Hello!

https://man.freebsd.org/cgi/man.cgi?loader.efi
contains


       boot1.efi(8)  is used to load loader.efi when it is placed within a UFS
       or ZFS file system.  Alternatively, loader.efi is  used  directly  when
       configured  with  efibootmgr(8), or when placed directly as the default
       boot program as described in uefi(8).  When a  system  is  built  using
       bsdinstall(8), loader.efi will be used directly.

while https://man.freebsd.org/cgi/man.cgi?query=boot1.efi
contains

       boot1.efi  has  been  deprecated  and will be removed from a future re-
       lease.  loader.efi(8) handles all its former use cases with more flexi-
       bility.

There should be the information in which versions boot1 will be used and when
loader.efi supports all situations.

-- 
kind regards
Marco

-- 
You are receiving this mail because:
You are on the CC list for the bug.