===================================================================
RCS file: /cvs/mandoc/man.1,v
retrieving revision 1.28
retrieving revision 1.30
diff -u -p -r1.28 -r1.30
--- mandoc/man.1	2017/03/27 18:51:36	1.28
+++ mandoc/man.1	2017/08/09 12:49:04	1.30
@@ -1,4 +1,4 @@
-.\"	$Id: man.1,v 1.28 2017/03/27 18:51:36 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: March 27 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
 .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 .
@@ -262,7 +274,7 @@ environment variable.
 The format of the path is a colon
 .Pq Ql \&:
 separated list of directories.
-Invalid paths, or paths without manual databases, are ignored.
+Invalid paths are ignored.
 Overridden by
 .Fl M ,
 ignored if
@@ -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