[PATCH] Clean up COMPATIBILITY section in mandoc_char.7

[PATCH] Clean up COMPATIBILITY section in mandoc_char.7

[Kristaps Dzonsons]

Hi,

This cleans up the COMPATIBILITY section of mandoc_char.7, which wasn't 
following the convention of mdoc.7 and missing some important bits.

Thoughts?

Kristaps
--
 To unsubscribe send an email to tech+unsubscribe@mdocml.bsd.lv

Re: [PATCH] Clean up COMPATIBILITY section in mandoc_char.7

[Kristaps Dzonsons]

[-- Attachment #1: Type: text/plain, Size: 196 bytes --]

> This cleans up the COMPATIBILITY section of mandoc_char.7, which wasn't
> following the convention of mdoc.7 and missing some important bits.
>
> Thoughts?

Patch actually included this time...

[-- Attachment #2: patch.txt --]
[-- Type: text/plain, Size: 1575 bytes --]

Index: mandoc_char.7
===================================================================
RCS file: /usr/vhosts/mdocml.bsd.lv/cvs/mdocml/mandoc_char.7,v
retrieving revision 1.40
diff -r1.40 mandoc_char.7
517,519c517,519
< This section documents compatibility of
< .Nm
< with older or existing versions of groff.
---
> This section documents compatibility between mandoc and other other
> troff implementations, at this time limited to GNU troff
> .Pq Qq groff .
521,524c521,525
< The following render differently in
< .Fl T Ns Ar ascii
< output mode:
< .Bd -ragged -offset indent
---
> .Bl -dash -compact
> .It
> In
> .Fl T Ns Ar ascii ,
> the
526,529c527,530
< \e[coproduct], \e(gr, \e(-h, \e(a.
< .Ed
< .Pp
< The following render differently in
---
> \e[coproduct], \e(gr, \e(\-h, and \e(a special characters render differently
> between mandoc and groff.
> .It
> In
531,540c532,547
< output mode:
< .Bd -ragged -offset indent
< \e(~=, \e(nb, \e(nc
< .Ed
< .Pp
< Finally, the following have been omitted by being poorly documented or
< having no known representation:
< .Bd -ragged -offset indent
< \e[radicalex], \e[sqrtex], \e(ru
< .Ed
---
> and
> .Fl T Ns Ar xhtml ,
> the \e(~=, \e(nb, and \e(nc special characters render differently between mandoc
> and GNU troff.
> .It
> The
> .Fl T Ns Ar ps
> and
> .Fl T Ns Ar pdf
> modes format like
> .Fl T Ns Ar ascii
> instead of rendering glyphs as in groff.
> .It
> The \e[radicalex], \e[sqrtex], and \e(ru special characters have been omitted
> from mandoc by being poorly documented or having no known representation.
> .El

Re: [PATCH] Clean up COMPATIBILITY section in mandoc_char.7

[Kristaps Dzonsons]

[-- Attachment #1: Type: text/plain, Size: 283 bytes --]

>>> This cleans up the COMPATIBILITY section of mandoc_char.7, which wasn't
>>> following the convention of mdoc.7 and missing some important bits.
>>>
>>> Thoughts?
>>
>> Patch actually included this time...
>
> ugh! can you diff -u it please?

Blarg!  Enclosed in the right way...

[-- Attachment #2: patch.mandoc_char.txt --]
[-- Type: text/plain, Size: 1757 bytes --]

Index: mandoc_char.7
===================================================================
RCS file: /usr/vhosts/mdocml.bsd.lv/cvs/mdocml/mandoc_char.7,v
retrieving revision 1.41
diff -u -r1.41 mandoc_char.7
--- mandoc_char.7	30 Jan 2011 16:05:37 -0000	1.41
+++ mandoc_char.7	3 Feb 2011 10:27:51 -0000
@@ -529,30 +529,37 @@
 .Sq \(dq
 character where possible.
 .Sh COMPATIBILITY
-This section documents compatibility of
-.Nm
-with older or existing versions of groff.
+This section documents compatibility between mandoc and other other
+troff implementations, at this time limited to GNU troff
+.Pq Qq groff .
 .Pp
-The following render differently in
-.Fl T Ns Ar ascii
-output mode:
-.Bd -ragged -offset indent
+.Bl -dash -compact
+.It
+In
+.Fl T Ns Ar ascii ,
+the
 \e(ss, \e(nm, \e(nb, \e(nc, \e(ib, \e(ip, \e(pp, \e[sum], \e[product],
-\e[coproduct], \e(gr, \e(-h, \e(a.
-.Ed
-.Pp
-The following render differently in
+\e[coproduct], \e(gr, \e(\-h, and \e(a special characters render differently
+between mandoc and groff.
+.It
+In
 .Fl T Ns Ar html
-output mode:
-.Bd -ragged -offset indent
-\e(~=, \e(nb, \e(nc
-.Ed
-.Pp
-Finally, the following have been omitted by being poorly documented or
-having no known representation:
-.Bd -ragged -offset indent
-\e[radicalex], \e[sqrtex], \e(ru
-.Ed
+and
+.Fl T Ns Ar xhtml ,
+the \e(~=, \e(nb, and \e(nc special characters render differently between mandoc
+and GNU troff.
+.It
+The
+.Fl T Ns Ar ps
+and
+.Fl T Ns Ar pdf
+modes format like
+.Fl T Ns Ar ascii
+instead of rendering glyphs as in groff.
+.It
+The \e[radicalex], \e[sqrtex], and \e(ru special characters have been omitted
+from mandoc by being poorly documented or having no known representation.
+.El
 .Sh SEE ALSO
 .Xr mandoc 1
 .Sh AUTHORS