diff options
author | Ingo Schwarze <schwarze@openbsd.org> | 2017-08-09 12:49:04 +0000 |
---|---|---|
committer | Ingo Schwarze <schwarze@openbsd.org> | 2017-08-09 12:49:04 +0000 |
commit | 869ddfc6b23c68ccedf627778460ac91a9b1b1db (patch) | |
tree | 7b08c20724df9dfac7860b73efb18b3543b04487 /man.1 | |
parent | 0b60d089a3f7d62f185c353227572d01e5f2f8dd (diff) | |
download | mandoc-869ddfc6b23c68ccedf627778460ac91a9b1b1db.tar.gz mandoc-869ddfc6b23c68ccedf627778460ac91a9b1b1db.tar.zst mandoc-869ddfc6b23c68ccedf627778460ac91a9b1b1db.zip |
Explain how to transform markup for the terminal when not using a
pager, and how to remove markup. Add related cross references.
While here, as suggested by jmc@, replace the excessive cross
references to the intro pages by a more relevant one to mandoc(1).
Triggered by a question from, using feedback from, and OK jmc@.
Diffstat (limited to 'man.1')
-rw-r--r-- | man.1 | 30 |
1 files changed, 18 insertions, 12 deletions
@@ -1,4 +1,4 @@ -.\" $Id: man.1,v 1.29 2017/05/17 23:23:00 schwarze Exp $ +.\" $Id: man.1,v 1.30 2017/08/09 12:49:04 schwarze Exp $ .\" .\" Copyright (c) 1989, 1990, 1993 .\" The Regents of the University of California. All rights reserved. @@ -31,7 +31,7 @@ .\" .\" @(#)man.1 8.2 (Berkeley) 1/2/94 .\" -.Dd $Mdocdate: May 17 2017 $ +.Dd $Mdocdate: August 9 2017 $ .Dt MAN 1 .Os .Sh NAME @@ -78,6 +78,18 @@ Copy the manual page to the standard output instead of using .Xr more 1 to paginate it. This is done by default if the standard output is not a terminal device. +.Pp +When using +.Fl c , +most terminal devices are unable to show the markup. +To print the output of +.Nm +to the terminal with markup but without using a pager, pipe it to +.Xr ul 1 . +To remove the markup, pipe the output to +.Xr col 1 +.Fl b +instead. .It Fl f A synonym for .Xr whatis 1 . @@ -303,18 +315,12 @@ See for details. .Sh SEE ALSO .Xr apropos 1 , -.Xr intro 1 , +.Xr col 1 , +.Xr mandoc 1 , +.Xr ul 1 , .Xr whereis 1 , -.Xr intro 2 , -.Xr intro 3 , -.Xr intro 4 , -.Xr intro 5 , .Xr man.conf 5 , -.Xr intro 6 , -.Xr intro 7 , -.Xr mdoc 7 , -.Xr intro 8 , -.Xr intro 9 +.Xr mdoc 7 .Sh STANDARDS The .Nm |