===================================================================
RCS file: /cvs/mandoc/mdoc.7,v
retrieving revision 1.246
retrieving revision 1.247
diff -u -p -r1.246 -r1.247
--- mandoc/mdoc.7	2014/12/28 15:23:33	1.246
+++ mandoc/mdoc.7	2014/12/31 20:42:31	1.247
@@ -1,4 +1,4 @@
-.\"	$Id: mdoc.7,v 1.246 2014/12/28 15:23:33 schwarze Exp $
+.\"	$Id: mdoc.7,v 1.247 2014/12/31 20:42:31 schwarze Exp $
 .\"
 .\" Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv>
 .\" Copyright (c) 2010, 2011, 2013 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 28 2014 $
+.Dd $Mdocdate: December 31 2014 $
 .Dt MDOC 7
 .Os
 .Sh NAME
@@ -2201,9 +2201,12 @@ See also
 Close quoted context opened by
 .Sx \&Qo .
 .Ss \&Ql
-Format a single-quoted literal.
+Request a literal font and enclose in single quotes.
+For arguments of three or more characters, formatters other than
+.Xr mandoc 1
+usually omit the quotes on non-terminal output devices.
 See also
-.Sx \&Qq
+.Sx \&Li
 and
 .Sx \&Sq .
 .Ss \&Qo