From nobody Sat Oct 24 10:16:07 2026 X-Original-To: dev-commits-src-all@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 4jBbQ54PNkz6wKXm for ; Sat, 24 Oct 2026 10:16:13 +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 4jBbQ52VBPz4HHY for ; Sat, 24 Oct 2026 10:16:13 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1792836973; 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=xnJFsqkQOwuCmHce7W7VYQ3JfHeQchCZxLnkYYZV628=; b=n/1bsZGWAT3l3i1XlZyFdOLRaOH53u0bTpiklry5MEbXJ5EKyCdbVfw3MnHIsPocWlJdIf stBF/xPOJvWBcaEwLBKv5Vx02zvTWhi2np4DNNGHa9+d5JI27nSlAUjILGvYZshDnj1vUh Tx4loSK9PdoamqlSDZYmxiDecZQxMxrIbwI143wgrpf/7U3mstjlN4yFTE6UpYm+75Cd1o hXIP4eT1jtD6QK7obONRtyS+i/wO/bg3NRHr81HbrmJcL4AwpYzj93bG0qnDl90QqcaTgj gCHPFkPTiD13XVRCAqtekZwr6xQNoADZf7I3BZWf9g6jgHAj5AHf73QoWnGTdQ== ARC-Seal: i=1; a=rsa-sha256; d=freebsd.org; s=dkim; cv=none; t=1792836973; b=oT/ncaGPt1q2U7yaly1TDuo/gLsj3nA03ywM90D3oxxR32lzk0YzCk9oMuBpEtkDOPfx28 CjIAyf8n8TwaHo4xAEb0ZptnceI3Xnbc5WXYBJeLt80t6yVbb0Ye3Elj20/vNQNehbteQX yrCNAt0H+Jps3/EEb5AgN5h1XGssWj5W0GYJUoy6Xz4uoRlXzmLTUUST6AyWQ2qxC6V52M Z2oOuteGDltnIZFCjrVYiCU9RqyGfcKeJ0YNqhDssrm299tzRHt+ukigL7vf1k4+f0823x pkhpnSjuzNKMm+3+qaocesZ/PGPGgDjqpOAGoFnkGO3I0vxPQRL3M5S3dblXJQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1792836973; 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=xnJFsqkQOwuCmHce7W7VYQ3JfHeQchCZxLnkYYZV628=; b=YHz+6qEFMR48cb/DV50kPy9xrUhiD9vy/IMvkmDQl3oJ1EOPU0KHYre4wc+pu6aghpFvdK iJXW+zofrKFArsYZDoKnzI2rVd3gOvdtgGorqidGPeEIaRM+xxYEkUwhm4IMNrvm7QmFvA WEIGQJzcCXmc9JpxR3FBvxucJT6I6pxHxQ203dLd1Bhz+ipzYpFO4lIUUarHtkP2Kb7zsg wCmcys3nn632OmufWHAlP6P3Tnic4mM9Ukhkh6vHfdJtgIId2Tmzhcudkf5ttuohqaqK2P Udirorm6ZRsYgVHlQ1iHeBkcukbk/ILTaZWGych8axtn8q3roxzlcy1dezfiug== 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 4jBbQ527Pnz1BT5 for ; Sat, 24 Oct 2026 10:16:13 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 3c5df by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Sat, 24 Oct 2026 10:16:07 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Wolfram Schneider Subject: git: a03b051f238e - main - locate.1: clarify bytes vs. characters List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all X-BeenThere: dev-commits-src-all@freebsd.org Sender: owner-dev-commits-src-all@FreeBSD.org List-Id: Commit messages for all branches of the 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/main X-Git-Reftype: branch X-Git-Commit: a03b051f238eb78cfccbe834b0cc206e66d566e5 Auto-Submitted: auto-generated Date: Sat, 24 Oct 2026 10:16:07 +0000 Message-Id: <6adc8567.3c5df.76064517@gitrepo.freebsd.org> The branch main has been updated by wosch: URL: https://cgit.FreeBSD.org/src/commit/?id=a03b051f238eb78cfccbe834b0cc206e66d566e5 commit a03b051f238eb78cfccbe834b0cc206e66d566e5 Author: Wolfram Schneider AuthorDate: 2026-10-24 10:12:05 +0000 Commit: Wolfram Schneider CommitDate: 2026-10-24 10:12:05 +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 --- 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.