From nobody Sat Oct 24 10:16:07 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 4jBbQ01Y2Jz6wL3p for ; Sat, 24 Oct 2026 10:16:08 +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 4jBbQ012Jhz4HCB for ; Sat, 24 Oct 2026 10:16:08 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1792836968; 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=JXJkPIfXAxqVYj1O0zBS7wLET+Flm4ygnAYEi19VIUJlzVwJ0mK/0eF29VPUDgIvum6B45 /DFqrFoO0NrFIZhDyc8JnD+ly2sDz+cYH9m5dPjmZgW45eWR+xVvtLw5ZJ8ptx23Dz4GdQ glx6QL2fW8/mgxb3PTvSF5fctmZ2EDwTCZpWlL7tQZVJAwaODS0IH11Q8d1mx9nbbm37JP QqY4MQIlB+mmUgo0rqn7iiB0tu4lSYUNdyIQSd6t3AveyyOO8hkBmEXNs1PiuT10ieb/P5 RW+DhK6mo3jfRp/BmdZWeAcMWHA8SrVqhfNNs4w+JM79gdD2zWd4lYG1iqTUsg== ARC-Seal: i=1; a=rsa-sha256; d=freebsd.org; s=dkim; cv=none; t=1792836968; b=BgP68rV8m52WpPX/7T2EnPAs0yFblXYHUKDOTrFlmLLzJYQlF7CbYGAnc2t//9Y1RDR/Wg ZN6vO+w8x8RudSp6MBTntjp0TpfepwMqoNVGoKgkG7XixcflIEAmDO+K8+t+yUzDS8UJRk TxlLM0MalqekqAlzexw9odGHpsElzBnRIhiBQZvczSjqif6vsf9ttrSYIYwSSYo/lTPoFq OGFGuKAEjfM6oahc5SQp0f2QNymqtXQ1PFI+ZOksFOtJoiKwVxiWGveg4KNgWX7lzBrEaP Fii6Nie/hDGH47wx86BRP17VLXoSdTwsOxnSySZoLdf2p/w6k62haOQfLvu5qA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1792836968; 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=FpUaquKU2ukCW5PQ1ygSwbyjJo6aRpvKSCFeSyntLjVa9wY08a0ZuMINWG6W5TK2F6p/nm m9ARVjqdfmfl+Nf2htQgH6orjdyZDTvP2hGiqotTAREGjDbZfCnlhiRaiQ8SwTSxx+j1K0 mwvvuOLlKafp6wQoru0BO8iJFhIrWIaCenBEjtq00LgmafAXS0PLbtAUSUx7o4hJxIbEP7 W0jNcNT+6XOk8t03DSUD0er+aYhYSwAUDVOF2XqlHpIxlgR2i1PZ1rGxmtdO+n4oqgw6wM tURJM0RqmHxtJn6Pr7iq0RT3kXG9mPXLmXZS4uuQKwmldm2FZEDJYHtLBRMO/w== 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 4jBbQ00R2Vz1BfR for ; Sat, 24 Oct 2026 10:16:08 +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-main X-BeenThere: dev-commits-src-main@freebsd.org Sender: owner-dev-commits-src-main@FreeBSD.org List-Id: Commit messages for the main branch 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.