aboutsummaryrefslogtreecommitdiffstatshomepage
diff options
context:
space:
mode:
authorIngo Schwarze <schwarze@openbsd.org>2020-08-27 14:28:11 +0000
committerIngo Schwarze <schwarze@openbsd.org>2020-08-27 14:28:11 +0000
commit861b32f0c650c391f020df039714a7370b28c40f (patch)
tree08bf261f2712f4a56ff52459ec4e90d075aee263
parent10c7195ae21b46c15b20ccb55be6aea83b9cb237 (diff)
downloadmandoc-861b32f0c650c391f020df039714a7370b28c40f.tar.gz
mandoc-861b32f0c650c391f020df039714a7370b28c40f.tar.zst
mandoc-861b32f0c650c391f020df039714a7370b28c40f.zip
Make it more explicit that the statement "-O tag does not work with less(1)"
only applies to -T html output mode, and why. Of course, -O tag works just fine with less(1) in the -T ascii and -T utf8 output modes. Potential for confusion pointed out by Ian Ropers.
-rw-r--r--mandoc.111
1 files changed, 9 insertions, 2 deletions
diff --git a/mandoc.1 b/mandoc.1
index 43f8d469..193bc763 100644
--- a/mandoc.1
+++ b/mandoc.1
@@ -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: July 20 2020 $
+.Dd $Mdocdate: August 27 2020 $
.Dt MANDOC 1
.Os
.Sh NAME
@@ -423,10 +423,17 @@ MANPAGER='lynx -force_html' man -T html -O tag=MANPAGER man
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.