add some notes about using col(1) and ul(1) to process the ascii markup

since these may not be commonly known utilities;
idea from and joint work with tedu@
CV: ----------------------------------------------------------------------

diff --git a/mandoc.1 b/mandoc.1
index 52a6e6bebffcac434a43b22deaf4a9e842a70a5d..777c657c1a55f5265c8dc55356731cd4d05d46c3 100644 (file)
--- a/mandoc.1
+++ b/mandoc.1
@@ -1,4 +1,4 @@
-.\"    $Id: mandoc.1,v 1.234 2018/12/24 23:37:22 schwarze Exp $
+.\"    $Id: mandoc.1,v 1.235 2018/12/28 00:15:11 schwarze Exp $
 .\"
 .\" Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv>
 .\" Copyright (c) 2012, 2014-2018 Ingo Schwarze <schwarze@openbsd.org>
@@ -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: December 24 2018 $
+.Dd $Mdocdate: December 28 2018 $
 .Dt MANDOC 1
 .Os
 .Sh NAME
@@ -256,6 +256,13 @@ where
 is the back-space character number 8.
 Emboldened characters are rendered as
 .Sq c Ns \e[bs] Ns c .
+This markup is typically converted to appropriate terminal sequences by
+the pager or
+.Xr ul 1 .
+To remove the markup, pipe the output to
+.Xr col 1
+.Fl b
+instead.
 .Pp
 The special characters documented in
 .Xr mandoc_char 7