=================================================================== RCS file: /cvs/mandoc/mandoc.1,v retrieving revision 1.244 retrieving revision 1.246 diff -u -p -r1.244 -r1.246 --- mandoc/mandoc.1 2020/06/15 18:05:18 1.244 +++ mandoc/mandoc.1 2020/08/27 14:28:11 1.246 @@ -1,4 +1,4 @@ -.\" $OpenBSD: mandoc.1,v 1.244 2020/06/15 18:05:18 schwarze Exp $ +.\" $OpenBSD: mandoc.1,v 1.246 2020/08/27 14:28:11 schwarze Exp $ .\" .\" Copyright (c) 2012, 2014-2020 Ingo Schwarze .\" Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons @@ -15,7 +15,7 @@ .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" -.Dd $Mdocdate: June 15 2020 $ +.Dd $Mdocdate: August 27 2020 $ .Dt MANDOC 1 .Os .Sh NAME @@ -52,13 +52,13 @@ The options are as follows: If the standard output is a terminal device and .Fl c is not specified, use -.Xr more 1 +.Xr less 1 to paginate the output, just like .Xr man 1 would. .It Fl c Copy the formatted manual pages to the standard output without using -.Xr more 1 +.Xr less 1 to paginate them. This is the default. It can be specified to override @@ -423,10 +423,17 @@ MANPAGER='lynx -force_html' man -T html -O tag=MANPAGE MANPAGER='w3m -T text/html' man -T html -O tag=toc mandoc .Ed .Pp -This argument does not work with +Consequently, for HTML output, this argument does not work with .Xr more 1 or .Xr less 1 . +For example, +.Ql MANPAGER=less man -T html -O tag=toc mandoc +does not work because +.Xr less 1 +does not support +.Ic file:// +URIs. .It Cm toc If an input file contains at least two non-standard sections, print a table of contents near the beginning of the output. @@ -650,7 +657,7 @@ It never affects the interpretation of input files. Any non-empty value of the environment variable .Ev MANPAGER is used instead of the standard pagination program, -.Xr more 1 ; +.Xr less 1 ; see .Xr man 1 for details. @@ -664,8 +671,7 @@ Specifies the pagination program to use when .Ev MANPAGER is not defined. If neither PAGER nor MANPAGER is defined, -.Xr more 1 -.Fl s +.Xr less 1 is used. Only used if .Fl a