From nobody Mon Oct 26 11:08:39 2026 X-Original-To: dev-commits-src-branches@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 4jCrTg5jrPz6xRDm for ; Mon, 26 Oct 2026 11:08:39 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 4jCrTg55G2z4FXp for ; Mon, 26 Oct 2026 11:08:39 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1793012919; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=MPtvcQrzBKgoSYue3xx5MgbF7KML16e/WDCVdAMUWpY=; b=AF934RIEoGq7vpJEEejSMeQ6E4jMftdo5e1N8FmhigN5hjxabi08+1NC3y39f3zGoN3Trm lJucYByZhPTensnt0E/dlqNxFQ1FDlpxPywpCQF9P5ZqLhG5C79G6yKrORSUWNBkDN5XiE d2ZHo13IFHcYtdd86xo2BxDcQdOVpcGthzS4WmntXJw5IIQstJ0sqVlSvBXoXl2Ol32B1E RyednoWYdmzfyYPAn3MRpqym/us0QYsrGs3xyMc9JiCRYjthsYdAN026dTZ9PceFgmkBeN cwUJNKQwOQc6Viy6wugWZXNJ9LIpLldmzPJfAhFslk9EqC93PiG9qeKtWeY8cQ== ARC-Seal: i=1; a=rsa-sha256; d=freebsd.org; s=dkim; cv=none; t=1793012919; b=j4imfizbJnz6DmSamuOAt3ASpvThts4IpOrNzaSlgAsXJ4C2Ejd6QZfZtFn/7bJrfuc/EN 04QS+dHtdkxG8ABaDbiCY0u9/bve3aR6B4NzZJcI/EjKI/HSq1K89VXLs0kpSW1TdeFDiO g+u3MRhOiRmGPTUHdbE9mLmy0VvHhTeDfc0eEPwt/94X9eXaoUz20cpm3LpA0l7tAhgfHq zyl8FhF9bMWNoxKJBU5tRceYZkK7o8aOqK+bPfLF8b/D5fs2ZbwW2oWHB5Urq4MZ2u9gqI mcLiNfzE+e1fNQ5pfJuLnukU56T7cv3b0RWafQKvXZ6bAB2SNX8f+NZBdgG9PQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1793012919; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=MPtvcQrzBKgoSYue3xx5MgbF7KML16e/WDCVdAMUWpY=; b=dCdwxq/3911nuHcF0ofjdNsqcAe691CvFLl7HhPqHJXPo/AqM3rnWLlo2WuiUfknv9bmvT 9VrDkUzQ4a433lSXB4FxmxcykfmsdBVmJ0PSum0FCM4vWe9npFwj8GjQOLGfUaEAi7drGS /9TT752UPTZYjNE+7u1JMysXalxO5hJiGGIe30WWWr+RR0Huq0zLo4Xwc/PWb+zxXguTn1 +JSrlmDLFJZ0DuEGsGL7CI38CGvAtNKaC3w6R3BYlP0eMJFz/GL/RE3zRODJeRg7qZYZ5G 3MOFQsEEl4nyXrNP82gVeW5fAnM7Tky8751kx8eUzbXWjmf76VQaijXSHiH8ow== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4jCrTg4lSLzVWb for ; Mon, 26 Oct 2026 11:08:39 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 212a6 by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Mon, 26 Oct 2026 11:08:39 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Wolfram Schneider Subject: git: ae99c82c76f2 - stable/15 - locate.1: clarify bytes vs. characters List-Archive: https://lists.freebsd.org/archives/dev-commits-src-branches X-BeenThere: dev-commits-src-branches@freebsd.org Sender: owner-dev-commits-src-branches@FreeBSD.org List-Id: Commits to the stable branches of the FreeBSD src repository 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: 8bit X-Git-Committer: wosch X-Git-Repository: src X-Git-Refname: refs/heads/stable/15 X-Git-Reftype: branch X-Git-Commit: ae99c82c76f27b2b09e9c605800bd1d84c57ac2a Auto-Submitted: auto-generated Date: Mon, 26 Oct 2026 11:08:39 +0000 Message-Id: <6adf34b7.212a6.7075c56a@gitrepo.freebsd.org> The branch stable/15 has been updated by wosch: URL: https://cgit.FreeBSD.org/src/commit/?id=ae99c82c76f27b2b09e9c605800bd1d84c57ac2a commit ae99c82c76f27b2b09e9c605800bd1d84c57ac2a Author: Wolfram Schneider AuthorDate: 2026-10-24 10:12:05 +0000 Commit: Wolfram Schneider CommitDate: 2026-10-26 11:08:20 +0000 locate.1: clarify bytes vs. characters The database stores bytes, not characters. Remove the historical note about 7-bit storage. Also document that -i ignores case only for ASCII letters. Reviewed by: ziaee MFC after: 3 days (cherry picked from commit a03b051f238eb78cfccbe834b0cc206e66d566e5) --- usr.bin/locate/locate/locate.1 | 21 ++++++++++++--------- 1 file changed, 12 insertions(+), 9 deletions(-) diff --git a/usr.bin/locate/locate/locate.1 b/usr.bin/locate/locate/locate.1 index 4999722acfc5..8deb68ee5e08 100644 --- a/usr.bin/locate/locate/locate.1 +++ b/usr.bin/locate/locate/locate.1 @@ -1,4 +1,4 @@ -.\" Copyright (c) 1995 Wolfram Schneider . Berlin. +.\" Copyright (c) 1995-2026 Wolfram Schneider .\" Copyright (c) 1990, 1993 .\" The Regents of the University of California. All rights reserved. .\" @@ -26,7 +26,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd December 11, 2020 +.Dd October 22, 2026 .Dt LOCATE 1 .Os .Sh NAME @@ -70,17 +70,16 @@ As a special case, a pattern containing no globbing characters is matched as though it were .Dq *foo* . .Pp -Historically, locate only stored characters between 32 and 127. -The -current implementation stores any character except newline +The database can store any byte in a path name except newline .Pq Sq \en and .Dv NUL .Pq Sq \e0 . -The 8-bit character support does not waste extra space for -plain ASCII file names. -Characters less than 32 or greater than 127 -are stored in 2 bytes. +Bytes with values from 32 to 127 +.Pq printable ASCII characters and DEL +are stored in at most one byte; +all other bytes take two bytes. +For example, a two-byte UTF-8 character takes four bytes in the database. .Pp The following options are available: .Bl -tag -width 10n @@ -159,6 +158,7 @@ Note: you can only use pattern for stdin. .It Fl i Ignore case distinctions in both the pattern and the database. +Only ASCII letters are folded. .It Fl l Ar number Limit output to .Ar number @@ -266,3 +266,6 @@ a locate database which was built on SunOS/sparc machine The .Nm utility does not recognize multibyte characters. +The +.Fl i +option ignores case only for ASCII letters.