man: Add -l option
ClosedPublic
Actions

Authored by des on Sep 4 2025, 5:48 PM.

Details

Reviewers

emaste
ziaee

Commits

rG61735a4f685b: man: Add -l option
rGe5c5d8f78ead: man: Add -l option
rG668fbde7df9a: man: Add -l option
rG14b61b2e9317: man: Add -l option

Summary

Add a -l option which causes man to interpret all arguments as paths to
open directly rather than man pages to search for in MANPATH. See the
PR for a detailed rationale.

PR: 289245
MFC after: 1 week

Diff Detail

Repository

rG FreeBSD src repository

Lint

Lint Not Applicable

Unit

Tests Not Applicable

Event Timeline

des created this revision.Sep 4 2025, 5:48 PM

Herald added subscribers: ziaee, imp. · View Herald TranscriptSep 4 2025, 5:48 PM

des requested review of this revision.Sep 4 2025, 5:48 PM

Harbormaster completed remote builds in B66820: Diff 161536.Sep 4 2025, 5:48 PM

emaste accepted this revision.Sep 4 2025, 5:59 PM

emaste added inline comments.

usr.bin/man/man.sh
526–527	IMO exceeding 80 cols is slightly preferable to wrapping the error message
640	Would be nice for someone to redo this block

This revision is now accepted and ready to land.Sep 4 2025, 5:59 PM

ziaee accepted this revision.Sep 4 2025, 8:05 PM

ziaee added inline comments.

usr.bin/man/man.1
413	Should we fix this one since we're planning to deprecate this syntax?

emaste added inline comments.Sep 4 2025, 10:09 PM

usr.bin/man/man.1
413	Oh yes, if we're emitting a warning for this now it shouldn't be the example in the man page. Good catch.

man page

This revision now requires review to proceed.Sep 4 2025, 10:47 PM

Harbormaster completed remote builds in B66830: Diff 161563.Sep 4 2025, 10:47 PM

des marked 2 inline comments as done.Sep 4 2025, 10:47 PM

Don't forget guanxi co-authored-by

This revision is now accepted and ready to land.Sep 4 2025, 11:03 PM

Closed by commit rG14b61b2e9317: man: Add -l option (authored by Ingo Schwarze <schwarze@usta.de>, committed by des). · Explain WhySep 7 2025, 8:53 PM

This revision was automatically updated to reflect the committed changes.

des added a commit: rG14b61b2e9317: man: Add -l option.

des added a commit: rG668fbde7df9a: man: Add -l option.Tue, Sep 16, 1:59 PM

des added a commit: rGe5c5d8f78ead: man: Add -l option.

des added a commit: rG61735a4f685b: man: Add -l option.

Revision Contents
Changeset List

Path

Size

usr.bin/

man/

man.1

24 lines

man.sh

33 lines

Diff 161690

View Options

usr.bin/man/man.1