Minimal COMPATIBILITY cleanup:

* Mention that the list is incomplete.
* I implemented %C for groff -current, and it was accepted.
* Font family is \F, not \f.
* Escapes and scaling widths are documented in roff(7), not here.
* Quoting quotes by doubling them is now supported.

diff --git a/mdoc.7 b/mdoc.7
index 2b58495bf1b850d31267e70c0a4c0c6c12edeecf..98c68c11ce03cb6fbafb346a1fd25ad08ac985c3 100644 (file)
--- a/mdoc.7
+++ b/mdoc.7
@@ -1,4 +1,4 @@
-.\"    $Id: mdoc.7,v 1.228 2014/03/31 01:05:32 schwarze Exp $
+.\"    $Id: mdoc.7,v 1.229 2014/06/22 17:07:06 schwarze Exp $

 .\"
 .\" Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv>
 .\" Copyright (c) 2010, 2011, 2013 Ingo Schwarze <schwarze@openbsd.org>
 .\"
 .\" 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.
 .\"
 .\" 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 31 2014 $
+.Dd $Mdocdate: June 22 2014 $

 .Dt MDOC 7
 .Os
 .Sh NAME
 .Dt MDOC 7
 .Os
 .Sh NAME


@@ -3139,8 +3139,9 @@ Manually switching the font using the
 .Ql \ef
 font escape sequences is never required.
 .Sh COMPATIBILITY
 .Ql \ef
 font escape sequences is never required.
 .Sh COMPATIBILITY

-This section documents compatibility between mandoc and other
-troff implementations, at this time limited to GNU troff
+This section provides an incomplete list of compatibility issues
+between mandoc and other troff implementations, at this time limited
+to GNU troff

 .Pq Qq groff .
 The term
 .Qq historic groff
 .Pq Qq groff .
 The term
 .Qq historic groff


@@ -3249,7 +3250,7 @@ certain list types.
 can only be called by other macros, but not at the beginning of a line.
 .It
 .Sx \&%C
 can only be called by other macros, but not at the beginning of a line.
 .It
 .Sx \&%C

-is not implemented.
+is not implemented (up to and including groff-1.22.2).

 .It
 Historic groff only allows up to eight or nine arguments per macro input
 line, depending on the exact situation.
 .It
 Historic groff only allows up to eight or nine arguments per macro input
 line, depending on the exact situation.


@@ -3267,7 +3268,7 @@ in new groff and mandoc.
 .Sq \ef
 .Pq font face
 and
 .Sq \ef
 .Pq font face
 and

-.Sq \ef
+.Sq \eF

 .Pq font family face
 .Sx Text Decoration
 escapes behave irregularly when specified within line-macro scopes.
 .Pq font family face
 .Sx Text Decoration
 escapes behave irregularly when specified within line-macro scopes.


@@ -3289,36 +3290,6 @@ and
 .Fl offset Cm right .
 Groff does not implement centred and flush-right rendering either,
 but produces large indentations.
 .Fl offset Cm right .
 Groff does not implement centred and flush-right rendering either,
 but produces large indentations.

-.It
-The
-.Sq \eh
-.Pq horizontal position ,
-.Sq \ev
-.Pq vertical position ,
-.Sq \em
-.Pq text colour ,
-.Sq \eM
-.Pq text filling colour ,
-.Sq \ez
-.Pq zero-length character ,
-.Sq \ew
-.Pq string length ,
-.Sq \ek
-.Pq horizontal position marker ,
-.Sq \eo
-.Pq text overstrike ,
-and
-.Sq \es
-.Pq text size
-escape sequences are all discarded in mandoc.
-.It
-The
-.Sq \ef
-scaling unit is accepted by mandoc, but rendered as the default unit.
-.It
-In quoted literals, groff allows pairwise double-quotes to produce a
-standalone double-quote in formatted output.
-This is not supported by mandoc.

 .El
 .Sh SEE ALSO
 .Xr man 1 ,
 .El
 .Sh SEE ALSO
 .Xr man 1 ,