discuss@mandoc.bsd.lv
 help / color / mirror / Atom feed
From: Kristaps Dzonsons <kristaps@bsd.lv>
To: discuss@mdocml.bsd.lv
Subject: Re: mdocml: .Bl -column phrases ignore spacing rules for trailing
Date: Sat, 21 Aug 2010 13:18:44 +0200	[thread overview]
Message-ID: <4C6FB614.6010201@bsd.lv> (raw)
In-Reply-To: <201008202251.o7KMpT4F020687@krisdoz.my.domain>

schwarze@mdocml.bsd.lv wrote:
> Log Message:
> -----------
> .Bl -column phrases ignore spacing rules for trailing punctuation
> and render it just like normal text.
> Minimal fix of a formatting bug in operator(7) reported by ray@.
> 
> Modified Files:
> --------------
>     mdocml:
>         TODO
>         mdoc_term.c

This needs to be backed out, unfortunately: it causes fallout.

.Bl -column asdasdf asdfasdf
.It hallo . Ta world .     \" (1)
.It hallo .<TAB>world .    \" (2)
.It hallo . <TAB>world .   \" (3)
.El

Old/new groff:

      hallo.     world.
      hallo .    world.
      hallo.     world.

new mandoc:

      hallo .    world .
      hallo .    world .
      hallo .    world .

old mandoc:

      hallo.     world.
      hallo.     world.
      hallo.     world.

The fallout of case (1) is the biggest: Ta lists should not get 
IGNDELIM.  This is hard to switch on because the TAB-Ta switching is 
done in libmdoc, and is not exported to the formatter.

But I recall (2) and (3) being discussed.  It was agreed, without a 
clear solution, that the issue was the space-before-tab.

By following groff's logic, you'd have to say "if you have a tab 
directly after the last token in a list column, the punctuation will be 
considered normal text", which is not clear to a dummy like me anyway.

I suggest that we go with mandoc's old behaviour at the expense of this 
one issue.  It's easier to make unilateral statements: punctuation at 
the end of a list column, whether separated by Ta, tabs, tabs and 
spaces, etc., is treated as delimiting punctuation.

Note that mdoc.7 explicitly allows for quoted tab-separated `It' 
columns, which may be appropriate in this case.  Or just escaping the 
punctuation.  So the above would be modified "the un-quoted...".

Thoughts?

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

       reply	other threads:[~2010-08-21 11:18 UTC|newest]

Thread overview: 6+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
     [not found] <201008202251.o7KMpT4F020687@krisdoz.my.domain>
2010-08-21 11:18 ` Kristaps Dzonsons [this message]
2010-08-21 16:06   ` Ingo Schwarze
2010-08-21 17:29     ` Kristaps Dzonsons
2010-08-21 20:12       ` mdoc(7) COMPATIBILITY Ingo Schwarze
2010-08-21 20:20         ` Kristaps Dzonsons
2010-08-22  9:27           ` Kristaps Dzonsons

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=4C6FB614.6010201@bsd.lv \
    --to=kristaps@bsd.lv \
    --cc=discuss@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).