Documentation of apostrophe control character.

2 files changed, 28 insertions, 7 deletions

diff --git a/man.7 b/man.7
index 0f15f2f6..30e315cb 100644
--- a/man.7
+++ b/man.7
@@ -1,4 +1,4 @@
-.\"	$Id: man.7,v 1.58 2010/03/25 07:28:16 kristaps Exp $
+.\"	$Id: man.7,v 1.59 2010/03/27 10:10:10 kristaps Exp $
 .\"
 .\" Copyright (c) 2009 Kristaps Dzonsons <kristaps@kth.se>
 .\"
@@ -14,7 +14,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: March 25 2010 $
+.Dd $Mdocdate: March 27 2010 $
 .Dt MAN 7
 .Os
 .
@@ -403,9 +403,11 @@ Documents any security precautions that operators should consider.
 Macros are one to three three characters in length and begin with a
 control character ,
 .Sq \&. ,
-at the beginning of the line.  An arbitrary amount of whitespace may
-sit between the control character and the macro name.  Thus, the
-following are equivalent:
+at the beginning of the line.  The
+.Sq \(aq
+macro control character is also accepted.  An arbitrary amount of
+whitespace may sit between the control character and the macro name.
+Thus, the following are equivalent:
 .Bd -literal -offset indent
 \&.PP
 \&.\ \ \ PP
@@ -999,22 +1001,33 @@ This section documents areas of questionable portability between
 implementations of the
 .Nm
 language.
+.
 .Pp
 .Bl -dash -compact
 .It
 In quoted literals, GNU troff allowed pair-wise double-quotes to produce
 a standalone double-quote in formatted output.  It is not known whether
 this behaviour is exhibited by other formatters.
+.
 .It
 Blocks of whitespace are stripped from macro and free-form text lines
 (except when in literal mode) in mandoc.  This is not the case for GNU
 troff: for maximum portability, whitespace sensitive blocks should be
 enclosed in literal contexts.
+.
 .It
 The
 .Sx \&sp
 macro does not accept negative values in mandoc.  In GNU troff, this
 would result in strange behaviour.
+.
+.It
+The
+.Sq \(aq
+macro control character, in GNU troff (and prior troffs) suppresses a
+newline before macro output; in mandoc, it is an alias for the standard
+.Sq \&.
+control character.
 .El
 .
 .
diff --git a/mandoc.1 b/mandoc.1
index d2025ebe..068669da 100644
--- a/mandoc.1
+++ b/mandoc.1
@@ -1,4 +1,4 @@
-.\"	$Id: mandoc.1,v 1.53 2010/03/25 07:28:16 kristaps Exp $
+.\"	$Id: mandoc.1,v 1.54 2010/03/27 10:10:10 kristaps Exp $
 .\"
 .\" Copyright (c) 2009 Kristaps Dzonsons <kristaps@kth.se>
 .\"
@@ -14,7 +14,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: March 25 2010 $
+.Dd $Mdocdate: March 27 2010 $
 .Dt MANDOC 1
 .Os
 .
@@ -510,6 +510,7 @@ CSS2 styling used for
 .Fl m Ns Ar doc
 input lists does not render properly in older browsers, such as Internet
 Explorer 6 and earlier.
+.
 .Pp
 In
 .Fl T Ns Ar html
@@ -520,6 +521,7 @@ the maximum size of an element attribute is determined by
 which is usually 1024 bytes.  Be aware of this when setting long link
 formats, e.g.,
 .Fl O Ns Ar style=really/long/link .
+.
 .Pp
 The
 .Fl T Ns Ar html
@@ -531,6 +533,7 @@ font size escape documented in
 .Xr mdoc 7
 and
 .Xr man 7 .
+.
 .Pp
 Nesting elements within next-line element scopes of
 .Fl m Ns Ar an ,
@@ -543,6 +546,7 @@ will confuse
 and
 .Fl T Ns Ar xhtml
 and cause them to forget the formatting of the prior next-line scope.
+.
 .Pp
 The
 .Sq i
@@ -550,3 +554,7 @@ macro in
 .Fl m Ns Ar an
 should italicise all subsequent text if a line argument is not provided.
 This behaviour is not implemented.
+.
+The
+.Sq \(aq
+control character does not have the same