From nobody Fri Jun 19 21:50:56 2026 X-Original-To: dev-commits-src-main@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4ghrrL6qhRz6gwsj; Fri, 19 Jun 2026 21:50:58 +0000 (UTC) (envelope-from des@freebsd.org) Received: from smtp.freebsd.org (smtp.freebsd.org [96.47.72.83]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "smtp.freebsd.org", Issuer "YR1" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 4ghrrL3ltZz4FTl; Fri, 19 Jun 2026 21:50:58 +0000 (UTC) (envelope-from des@freebsd.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1781905858; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=JLy28XR4MZ1iWmkzSyoJRLqP1WlMOE74BtyRJjCfg9g=; b=AlLvBLHgcbWQM+Ow/5891Xl6NlB5D9CJddhA19ttaLwSNqoRQnokXHZbBxwWTFSIswGgwD sKO6Yg+TTiiyE8ytHMb8xVKZmGh6d+CZWzzPU6lG9KTK7gnNgNpXUfu0zRYMWHyQKPbSl7 ThGxmBOPaRSNbb93w7gWTSvANYhqg0bweI18aSRvmAilm2SLG544JiS6RWngA4Bk4Bg4Mr Nlv67z3XJqJAvQSlCfjS8XtDfVywAWdwQ5ekD8+vPREBw060KzS9PXlruF+eU5L9+0W/GI b1V2aaHZBI6N1BD0QgvhXVOeRq2WGObe7wY3Ik2c7aVn4ycmccphlLYDzdrTeA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1781905858; a=rsa-sha256; cv=none; b=i8IR70oCo29sjACBk7Txq7oTZgHldzt21L0akHcDv76tWMfZ7wuUPf8qMG7Q2WpouWjPnV uRO589FC16FGph70z6nreQYQtgU9hutd6JjBkJiaeEfmkANk383oKMn+dU3LGSiyMoAzCo jV7UPLQFbvhet9RykpfPIDWIPhWyQsLe4KF0deUUJZbpxgvUu2GXl9lX4C/2h8US3vDwe6 8fgBgxXT2xd7jxliBts3ki0r6IECL1sSS6yR88JUhp7QFeHqS2WmOMrLNp8biOlzhp/NdT 89pPwvgEpuZ+sFdJur30KCdeE5lb08OtJ7djoT0J2PVhC43Mbr/kwFadlMNSDQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1781905858; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=JLy28XR4MZ1iWmkzSyoJRLqP1WlMOE74BtyRJjCfg9g=; b=T5JfjLmIUeGe0q0ExY4rTdftNWZp61sGOTg84JMXrmS8g+Eo9GcK2fyPh0FEGQXw5E+GbB eP5OUXTEE0ZbQER5UiMQkO8oglfynEMw/1ksDmgoe6XFXQuKtb/QRoYXtWag1fpwoMG98L yvXEI+VxEzbFy1xlr9rRVfhyZevND6w7jNVmTBPsoji+gCCegjop98pAxDqsdt4Xsm3ilo EJ7WCbgwAtCP9hW0fkOF+wgR2IjTrBx+D4NGuaF93k4FCgct2F065/H3QpVfyaq3TXTDhw eprsjNcW5oYIkhhpEmrBJKxXKmgVSra/CfHqkkgbTa1sDY3ucbsBabR0LHNW2g== Received: from ltc.des.dev (unknown [92.183.55.143]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) (Authenticated sender: des/mail) by smtp.freebsd.org (Postfix) with ESMTPSA id 4ghrrL1THcz12ll; Fri, 19 Jun 2026 21:50:58 +0000 (UTC) (envelope-from des@freebsd.org) Received: by ltc.des.dev (Postfix, from userid 1001) id 6E4755060E; Fri, 19 Jun 2026 23:50:56 +0200 (CEST) From: =?utf-8?Q?Dag-Erling_Sm=C3=B8rgrav?= To: "Alexander Ziaee" Cc: "src-committers" , "dev-commits-src-all" , "dev-commits-src-main" , "Artem Bunichev" Subject: Re: git: b3dfd5d59c4a - main - rmdir.1: Document non-POSIX -v option In-Reply-To: (Alexander Ziaee's message of "Fri, 19 Jun 2026 21:03:05 +0000 (UTC)") References: User-Agent: Gnus/5.13 (Gnus v5.13) Date: Fri, 19 Jun 2026 23:50:56 +0200 Message-ID: <86zf0qtd1b.fsf@ltc.des.dev> List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-main@freebsd.org Sender: owner-dev-commits-src-main@FreeBSD.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Alexander Ziaee writes: > Dag-Erling Sm=C3=B8rgrav writes: > > Alexander Ziaee writes: > > > +.Pp > > > +The > > > +.Fl v > > > +option is an extension to that specification. > > This is not the wording we normally use for these cases. > We use in in rm(1), but we do not have a style guide and I am not > aware of a consistent pattern. What would you prefer? Right, so I thought we'd standardized on The .Fl v option is a non-standard extension. but it's actually more varied than that, some pages say =E2=80=9Ca FreeBSD extension=E2=80=9D or =E2=80=9Ca BSD extension=E2=80=9D or even =E2=80=9Ca = GNU extension=E2=80=9D in cases where we copied GNU's homework, and some just say =E2=80=9Can extension=E2=80=9D.= We should clean that up. There is precedent for =E2=80=9Can extension to that specification=E2=80=9D= but only in pages where the previous sentence uses the word =E2=80=9Cspecification=E2= =80=9D. I would prefer not standardizing on a wording that relies on external context. Furthermore, rmdir(1) does not follow the standard pattern, so maybe we should start by fixing that: The .Nm utility is expected to conform to the .St -p1003.1-2008 specification. That's not the latest version of the standard, but we've made no effort to update our codebase for 1003.1-2024, so it's the most recent one we can plausibly claim conformance to (although in this particular case the standard hasn't changed so we can probably go ahead with 1003.1-2024). Finally, the SEE ALSO section should reference rmdir(2). DES --=20 Dag-Erling Sm=C3=B8rgrav - des@FreeBSD.org