Date: Fri, 22 Dec 2023 08:27:34 +0300 From: Gleb Popov <arrowd@freebsd.org> To: Muhammad Moinur Rahman <bofh@freebsd.org> Cc: ports-committers@freebsd.org, dev-commits-ports-all@freebsd.org, dev-commits-ports-main@freebsd.org Subject: Re: git: af1b62b7bc9a - main - Mk/bsd.options.desc.mk: Add ASLR Message-ID: <CALH631kPhZX-gB464U7PhhzW5PzhH_DJM8ZmSJi3zqWEACAq7g@mail.gmail.com> In-Reply-To: <202312220124.3BM1Omb2053073@gitrepo.freebsd.org> References: <202312220124.3BM1Omb2053073@gitrepo.freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Fri, Dec 22, 2023 at 4:24=E2=80=AFAM Muhammad Moinur Rahman <bofh@freebs= d.org> wrote: > > diff --git a/Mk/bsd.options.desc.mk b/Mk/bsd.options.desc.mk > index df0787f752c6..d20740cc888a 100644 > --- a/Mk/bsd.options.desc.mk > +++ b/Mk/bsd.options.desc.mk > @@ -30,6 +30,7 @@ APE_DESC?=3D Monkey's Audio lossless format = support > ARCHIVE_DESC?=3D bzip2/zip/iso9660 archive support > ARMADILLO_DESC?=3D TPS transform computation via Armadillo > ASIO_DESC?=3D Asynchronous I/O support > +ASLR_DESC?=3D Enable ASLR support > ASM_DESC?=3D Use optimized assembly code > ASPELL_DESC?=3D Spell checking support via GNU Aspell > ASSERT_DESC?=3D Enable debug assertions >From Porter Handbook: > When describing options, view it from the perspective of the user: "What = functionality does it change?" and "Why would I want to enable this?" Do no= t just repeat the name. For example, describing the NLS option as "include = NLS support" does not help the user, who can already see the option name bu= t may not know what it means. Describing it as "Native Language Support via= gettext utilities" is much more helpful. Maybe the description should say "Enable Address Space Layout Randomization support" or "Enable Address Space Randomization" if the former is too long.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CALH631kPhZX-gB464U7PhhzW5PzhH_DJM8ZmSJi3zqWEACAq7g>