PR/59625: Ingo Schwarze: Add a new -l flag that specifies to interpret
arguments as filenames, keeping the current behavior of interpreting
arguments as filenames if they begin with "/" "./" or "../" for compatibility.
In the future we can remove that.

man(1): document arguments in the list

For options that have an argument, add that argument to
the entry in the list.

branches: 1.30.4;
man.1: add a small note about alternate machine name searches

Document -f option for man(1).
Also remove unsupported options for `man -k` from the synopsis and usage.

More detail about treating a local file as a man page,
and about how to request machine-specific man pages.
re

Merge riastradh-drm2 to HEAD.

whatis.db is no more, so don't mention its location in FILES.

Remove unnecessary line wrap.

branches: 1.24.2; 1.24.8; 1.24.12;
Refer to X11R7.

Fix usage in man page and sync usage in executable with it.

Add support for man -p to print the search path for manual pages (not
including cat page directories).

From Abhinav Upadhyay as part of Google's Summer of Code 2011

branches: 1.21.4;
Mimic OSX behaviour:

On OS X it is possible to specify the manpage filename
with a full or relative path like this:

man ./foo.5

or

man /cd/foo/bar.1.gz

This is really helpful to view the manpage quickly while editing it.

patch presented on current-users@ and tech-userlevel@:
http://mail-index.netbsd.org/current-users/2009/10/06/msg010767.html
http://mail-index.netbsd.org/tech-userlevel/2009/10/06/msg002675.html

No objections

branches: 1.20.28; 1.20.34;
Bump date for previous, slightly reword a sentencen.

rework the wording in these man pages (mainly in man.conf.5) based on
some old notes I found to make it clearer and easier to understand
how the man stuff works (hopefully!).

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22365, verified by myself.

.Nm does not need a dummy argument ("") before punctuation or
for correct formatting of the SYNOPSIS any longer.

New sentence, new line. Some mdoc cleanup.

Remove unneeded Ns.

Whitespace cleanup.

Remove /usr/X11/man/whatis.db from path list, as it can no longer found
in /etc/man.conf

Supply missing "as".

branches: 1.11.2;
Allow "-s" to specify a section name, ala the SysV man command.
Unlike the SysV man command, this doesn't allow for the -s argument
to be a list.

allow to specify relative paths for sections in man.conf - they are used
similarily to _subdir, but only when appropriate
fix -m handling, so that e.g. "man -m . 3 printf" works as it should
add new -S flag, to specify a string the result path has to contain
g/c some unused stuff

Written by Chuck Cranor, with only cosmetic changes & const poisoning by me.

branches: 1.9.6;
Doc previously undocumented `-k' option, correctly note mutually exclusive
options, various stylistic changes.
Closes PR bin/8325.

Fall back to more(1) if PAGER is set but null.

branches: 1.7.2;
More and more .Os cleanups. .Os is defined in the tmac.doc-common file,
so we shouldn't override it with versions in the manpages. Many more to
come.

Added .Xr mdoc 7 and .Xr mdoc.samples 7 per PR#5284

RCS Id Police.

fix up .Nm usage

fix typo

Sync with 4.4-Lite, plus local changes.

branches: 1.1.1;
add man(1) ; part of new man(1) package from Bostic