Page MenuHomeFreeBSD

find.1: fix rendering of find -s example
ClosedPublic

Authored by rlibby on Sep 3 2026, 7:48 PM.
Tags
None
Referenced Files
F175097514: D59353.id185823.diff
Thu, Oct 8, 6:08 AM
Unknown Object (File)
Wed, Oct 7, 1:01 AM
Unknown Object (File)
Tue, Oct 6, 8:35 PM
Unknown Object (File)
Sun, Oct 4, 6:22 PM
Unknown Object (File)
Sun, Oct 4, 6:36 AM
Unknown Object (File)
Fri, Oct 2, 2:38 AM
Unknown Object (File)
Thu, Oct 1, 6:25 PM
Unknown Object (File)
Mon, Sep 28, 11:10 AM
Subscribers

Details

Summary

The period here is part of the literal string in the example. Adding a
space caused the example to be quoted wrongly.

Test Plan

Before, and see https://man.freebsd.org/cgi/man.cgi?query=find&apropos=0&sektion=1&manpath=FreeBSD+15.1-RELEASE&format=html

For example, ‘find -s’ puts a directory ‘foo’ with all its
contents before a directory ‘foo’.  but ‘find | sort’ puts the
directory name ‘foo’.  before any string like ‘foo/bar’ because
‘.’ goes before ‘/’ in ASCII.  In locales other than C results
may vary more due to collation differences.

After

For example, ‘find -s’ puts a directory ‘foo’ with all its
contents before a directory ‘foo.’ but ‘find | sort’ puts the
directory name ‘foo.’ before any string like ‘foo/bar’ because
‘.’ goes before ‘/’ in ASCII.  In locales other than C results
may vary more due to collation differences.

Diff Detail

Repository
rG FreeBSD src repository
Lint
Lint Skipped
Unit
Tests Skipped
Build Status
Buildable 76498
Build 73381: arc lint + arc unit

Event Timeline

rlibby requested review of this revision.Sep 3 2026, 7:48 PM
rlibby added reviewers: gbe, eugen_grosbein.net.
rlibby edited the test plan for this revision. (Show Details)
ziaee requested changes to this revision.Sep 4 2026, 10:00 AM
ziaee added a reviewer: manpages.
ziaee added inline comments.
usr.bin/find/find.1
164

This will cause a linter complaint. You need to escape the period with a zero-width space.

168

Ditto.

This revision now requires changes to proceed.Sep 4 2026, 10:00 AM

ziaee feedback: use a zero-width space to keep the linter happy

This revision is now accepted and ready to land.Sep 4 2026, 3:20 PM
This revision was automatically updated to reflect the committed changes.