Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 6 Feb 2025 17:01:45 -0700
From:      Warner Losh <imp@bsdimp.com>
To:        Benjamin Kaduk <bjkfbsd@gmail.com>
Cc:        Maxim Konovalov <maxim@freebsd.org>, src-committers <src-committers@freebsd.org>,  "<dev-commits-src-all@freebsd.org>" <dev-commits-src-all@freebsd.org>,  "<dev-commits-src-main@freebsd.org>" <dev-commits-src-main@freebsd.org>
Subject:   Re: git: b7f2a457a883 - main - arch.7: grammar fixes
Message-ID:  <CANCZdfrKhQC4KBf-isWFC7AUi0r54bZ7n9KYQT-GTFhQphHekg@mail.gmail.com>
In-Reply-To: <CAJ5_RoDXv7Ju1HoxcX4i08sGzHxLuq=vw7T_3iByA5puhqvd-w@mail.gmail.com>
References:  <202502042029.514KT9UX045548@gitrepo.freebsd.org> <CAJ5_RoDXv7Ju1HoxcX4i08sGzHxLuq=vw7T_3iByA5puhqvd-w@mail.gmail.com>

index | next in thread | previous in thread | raw e-mail

[-- Attachment #1 --]
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
>

[-- Attachment #2 --]
<div dir="auto"><div><br><br><div class="gmail_quote gmail_quote_container"><div dir="ltr" class="gmail_attr">On Thu, Feb 6, 2025, 4:17 PM Benjamin Kaduk &lt;<a href="mailto:bjkfbsd@gmail.com">bjkfbsd@gmail.com</a>&gt; wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div dir="ltr">On Tue, Feb 4, 2025 at 12:29 PM Maxim Konovalov &lt;<a href="mailto:maxim@freebsd.org" target="_blank" rel="noreferrer">maxim@freebsd.org</a>&gt; wrote:</div><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">The branch main has been updated by maxim:<br>
<br>
URL: <a href="https://cgit.FreeBSD.org/src/commit/?id=b7f2a457a883c8530c9b6111cee6a988ce5b7249" rel="noreferrer noreferrer" target="_blank">https://cgit.FreeBSD.org/src/commit/?id=b7f2a457a883c8530c9b6111cee6a988ce5b7249</a><br>;
<br>
commit b7f2a457a883c8530c9b6111cee6a988ce5b7249<br>
Author:     Maxim Konovalov &lt;maxim@FreeBSD.org&gt;<br>
AuthorDate: 2025-02-04 20:26:53 +0000<br>
Commit:     Maxim Konovalov &lt;maxim@FreeBSD.org&gt;<br>
CommitDate: 2025-02-04 20:26:53 +0000<br>
<br>
    arch.7: grammar fixes<br>
<br>
    The &quot;for hysterical raisons&quot; was a nice one, though.<br>
<br>
    MFC after:      3 days<br>
---<br>
 share/man/man7/arch.7 | 4 ++--<br>
 1 file changed, 2 insertions(+), 2 deletions(-)<br>
<br>
diff --git a/share/man/man7/arch.7 b/share/man/man7/arch.7<br>
index a3c875df0bff..796c6db7d299 100644<br>
--- a/share/man/man7/arch.7<br>
+++ b/share/man/man7/arch.7<br>
@@ -352,7 +352,7 @@ userland interfaces relating to underlying hardware platform<br>
 differences in bus architecture, device enumeration and boot interface.<br>
 Generally,<br>
 .Dv MACHINE<br>
-should only be used in src/sys and src/stand or in system imagers or<br>
+should only be used in src/sys and src/stand or in system images or<br>
 installers.<br>
</blockquote><div><br></div><div>&quot;system imagers&quot; is a real term -- people or scripts who image (i.e., install) systems.  I think &quot;imagers&quot; makes more sense than &quot;images&quot; here since the &quot;system image&quot; 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).</div><div><br></div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"> .It Dv MACHINE_ARCH<br>
 Represents the CPU processor architecture.<br>
@@ -414,7 +414,7 @@ in the top level Makefile for cross building.<br>
 Unused outside of that scope.<br>
 It is not passed down to the rest of the build.<br>
 Makefiles outside of the top level should not use it at all (though<br>
-some have their own private copy for hysterical raisons).<br>
+some have their own private copy for historical reasons).<br><br></blockquote><div><br></div><div>I agree that &quot;hysterical raisons&quot; is fun but do not propose to revert that part.</div></div></div></blockquote></div></div><div dir="auto"><br></div><div dir="auto"><br></div><div dir="auto">This makes me sad, but I understand. It&#39;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 |.</div><div dir="auto"><br></div><div dir="auto">Warner</div><div dir="auto"><br></div><div dir="auto"><div class="gmail_quote gmail_quote_container"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div class="gmail_quote"><div>-Ben </div></div></div>
</blockquote></div></div></div>
help

Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CANCZdfrKhQC4KBf-isWFC7AUi0r54bZ7n9KYQT-GTFhQphHekg>