tech@mandoc.bsd.lv
 help / color / mirror / Atom feed
From: Kristaps Dzonsons <kristaps@bsd.lv>
To: Jason McIntyre <jmc@kerhand.co.uk>
Cc: tech@mdocml.bsd.lv
Subject: Re: [PATCH] Clean up COMPATIBILITY section in mandoc_char.7
Date: Thu, 03 Feb 2011 11:29:00 +0100	[thread overview]
Message-ID: <4D4A836C.1070805@bsd.lv> (raw)
In-Reply-To: <20110129164511.GB19088@kerhand.co.uk>

[-- 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

      parent reply	other threads:[~2011-02-03 10:29 UTC|newest]

Thread overview: 3+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2011-01-29 14:39 Kristaps Dzonsons
2011-01-29 14:41 ` Kristaps Dzonsons
     [not found]   ` <20110129164511.GB19088@kerhand.co.uk>
2011-02-03 10:29     ` Kristaps Dzonsons [this message]

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=4D4A836C.1070805@bsd.lv \
    --to=kristaps@bsd.lv \
    --cc=jmc@kerhand.co.uk \
    --cc=tech@mdocml.bsd.lv \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).