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
F175791865: D59353.diff
Tue, Oct 13, 9:41 AM
Unknown Object (File)
Sun, Oct 11, 5:36 PM
Unknown Object (File)
Fri, Oct 9, 7:08 PM
Unknown Object (File)
Fri, Oct 9, 6:08 PM
Unknown Object (File)
Fri, Oct 9, 6:07 PM
Unknown Object (File)
Fri, Oct 9, 5:12 PM
Unknown Object (File)
Thu, Oct 8, 6:42 PM
Unknown Object (File)
Thu, Oct 8, 6:35 PM
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 76436
Build 73319: 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.