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

next in thread | previous in thread | raw e-mail | index | archive | help
--0000000000000d9a81062d8173eb
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

On Tue, Feb 4, 2025 at 12:29=E2=80=AFPM Maxim Konovalov <maxim@freebsd.org>=
 wrote:

> The branch main has been updated by maxim:
>
> URL:
> https://cgit.FreeBSD.org/src/commit/?id=3Db7f2a457a883c8530c9b6111cee6a98=
8ce5b7249
>
> 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.

-Ben

--0000000000000d9a81062d8173eb
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr"><div dir=3D"ltr">On Tue, Feb 4, 2025 at 12:29=E2=80=AFPM M=
axim Konovalov &lt;<a href=3D"mailto:maxim@freebsd.org">maxim@freebsd.org</=
a>&gt; wrote:</div><div class=3D"gmail_quote gmail_quote_container"><blockq=
uote class=3D"gmail_quote" style=3D"margin:0px 0px 0px 0.8ex;border-left:1p=
x solid rgb(204,204,204);padding-left:1ex">The branch main has been updated=
 by maxim:<br>
<br>
URL: <a href=3D"https://cgit.FreeBSD.org/src/commit/?id=3Db7f2a457a883c8530=
c9b6111cee6a988ce5b7249" rel=3D"noreferrer" target=3D"_blank">https://cgit.=
FreeBSD.org/src/commit/?id=3Db7f2a457a883c8530c9b6111cee6a988ce5b7249</a><b=
r>
<br>
commit b7f2a457a883c8530c9b6111cee6a988ce5b7249<br>
Author:=C2=A0 =C2=A0 =C2=A0Maxim Konovalov &lt;maxim@FreeBSD.org&gt;<br>
AuthorDate: 2025-02-04 20:26:53 +0000<br>
Commit:=C2=A0 =C2=A0 =C2=A0Maxim Konovalov &lt;maxim@FreeBSD.org&gt;<br>
CommitDate: 2025-02-04 20:26:53 +0000<br>
<br>
=C2=A0 =C2=A0 arch.7: grammar fixes<br>
<br>
=C2=A0 =C2=A0 The &quot;for hysterical raisons&quot; was a nice one, though=
.<br>
<br>
=C2=A0 =C2=A0 MFC after:=C2=A0 =C2=A0 =C2=A0 3 days<br>
---<br>
=C2=A0share/man/man7/arch.7 | 4 ++--<br>
=C2=A01 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 pla=
tform<br>
=C2=A0differences in bus architecture, device enumeration and boot interfac=
e.<br>
=C2=A0Generally,<br>
=C2=A0.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>
=C2=A0installers.<br>
</blockquote><div><br></div><div>&quot;system imagers&quot; is a real term =
-- people or scripts who image (i.e., install) systems.=C2=A0 I think &quot=
;imagers&quot; makes more sense than &quot;images&quot; here since the &quo=
t;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 o=
r 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>=C2=A0</div><blockquote class=3D"gmail_quote" style=3D"margin:0px 0px =
0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">=C2=A0.I=
t Dv MACHINE_ARCH<br>
=C2=A0Represents the CPU processor architecture.<br>
@@ -414,7 +414,7 @@ in the top level Makefile for cross building.<br>
=C2=A0Unused outside of that scope.<br>
=C2=A0It is not passed down to the rest of the build.<br>
=C2=A0Makefiles outside of the top level should not use it at all (though<b=
r>
-some have their own private copy for hysterical raisons).<br>
+some have their own private copy for historical reasons).<br><br></blockqu=
ote><div><br></div><div>I agree that &quot;hysterical raisons&quot; is fun =
but do not propose to revert that part.</div><div><br></div><div>-Ben=C2=A0=
</div></div></div>

--0000000000000d9a81062d8173eb--



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAJ5_RoDXv7Ju1HoxcX4i08sGzHxLuq=vw7T_3iByA5puhqvd-w>