aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/man.1
diff options
context:
space:
mode:
authorIngo Schwarze <schwarze@openbsd.org>2017-08-09 12:49:04 +0000
committerIngo Schwarze <schwarze@openbsd.org>2017-08-09 12:49:04 +0000
commit869ddfc6b23c68ccedf627778460ac91a9b1b1db (patch)
tree7b08c20724df9dfac7860b73efb18b3543b04487 /man.1
parent0b60d089a3f7d62f185c353227572d01e5f2f8dd (diff)
downloadmandoc-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.130
1 files changed, 18 insertions, 12 deletions
diff --git a/man.1 b/man.1
index 075497ac..e09023b3 100644
--- a/man.1
+++ b/man.1
@@ -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