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

From: Warner Losh <imp_at_bsdimp.com>
Date: Fri, 07 Feb 2025 00:01:45 UTC
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).
>
>
>
>>  .It Dv MACHINE_ARCH
>>  Represents the CPU processor architecture.
>> @@ -414,7 +414,7 @@ in the top level Makefile for cross building.
>>  Unused outside of that scope.
>>  It is not passed down to the rest of the build.
>>  Makefiles outside of the top level should not use it at all (though
>> -some have their own private copy for hysterical raisons).
>> +some have their own private copy for historical reasons).
>>
>>
> I agree that "hysterical raisons" is fun but do not propose to revert that
> part.
>


This makes me sad, but I understand. It's a joke that goes back to the 90s
when I worked for Solbourne Computer in Longmont. It was in their sh(1)
manual page for why /bin/sh accepted ^ as an alias for |.

Warner

-Ben
>