Re: git: b7f2a457a883 - main - arch.7: grammar fixes

On Thu, Feb 6, 2025, 5:37 PM Maxim Konovalov <maxim@maxim.int.ru> wrote:

> On Thu, 6 Feb 2025, 17:01-0700, Warner Losh wrote:
>
> > On Thu, Feb 6, 2025, 4:17?PM Benjamin Kaduk <bjkfbsd@gmail.com> wrote:
> >
> > > On Tue, Feb 4, 2025 at 12:29?PM Maxim Konovalov <maxim@freebsd.org>
> wrote:
> > >
> > >> The branch main has been updated by maxim:
> > >>
> > >> URL:
> > >>
> https://cgit.FreeBSD.org/src/commit/?id=b7f2a457a883c8530c9b6111cee6a988ce5b7249
> > >>
> > >> commit b7f2a457a883c8530c9b6111cee6a988ce5b7249
> > >> Author:     Maxim Konovalov <maxim@FreeBSD.org>
> > >> AuthorDate: 2025-02-04 20:26:53 +0000
> > >> Commit:     Maxim Konovalov <maxim@FreeBSD.org>
> > >> CommitDate: 2025-02-04 20:26:53 +0000
> > >>
> > >>     arch.7: grammar fixes
> > >>
> > >>     The "for hysterical raisons" was a nice one, though.
> > >>
> > >>     MFC after:      3 days
> > >> ---
> > >>  share/man/man7/arch.7 | 4 ++--
> > >>  1 file changed, 2 insertions(+), 2 deletions(-)
> > >>
> > >> diff --git a/share/man/man7/arch.7 b/share/man/man7/arch.7
> > >> index a3c875df0bff..796c6db7d299 100644
> > >> --- a/share/man/man7/arch.7
> > >> +++ b/share/man/man7/arch.7
> > >> @@ -352,7 +352,7 @@ userland interfaces relating to underlying
> hardware
> > >> platform
> > >>  differences in bus architecture, device enumeration and boot
> interface.
> > >>  Generally,
> > >>  .Dv MACHINE
> > >> -should only be used in src/sys and src/stand or in system imagers or
> > >> +should only be used in src/sys and src/stand or in system images or
> > >>  installers.
> > >>
> > >
> > > "system imagers" is a real term -- people or scripts who image
> > > (i.e., install) systems.  I think "imagers" makes more sense than
> > > "images" here since the "system image" would typically be a static
> > > set of data and the imager is a thing that is potentially dynamic
> > > (i.e., needing to control MACHINE or behave differently depending
> > > on its value) and the system images that it produce do not gain
> > > any value from examining MACHINE).
> > >
> [...]
>
> Yes, it might be, I thought about that.
>
> Since we have the author of this text -- Warner, is it "imagers" or
> "images"?
>


Imagers was correct... but it's also confusing I'll grant. Usually, you
only need MACHINE to make sure the kernel and boot loader agree on the
booting interface... this used to be what MACHINE meant: pc98 had a very
different interface than i386 as well as different standard devices. It was
hard to detect the difference in time to divthe right thing, so they had
different MACHINE names. But times have changed and we can detect efi vs
bios boot and do the right thing. MACHINE has gone from all you need to
know how to make an image to being one of many factors to know how to build
an image...

So I'd love a better word for that....

Sorry I focused on whimsy instead of substance in my last message...

Warner

Thanks,
>
> Maxim
>
> --
> Maxim Konovalov
>