discuss@mandoc.bsd.lv
 help / color / mirror / Atom feed
From: Ingo Schwarze <schwarze@usta.de>
To: discuss@mdocml.bsd.lv
Subject: Re: mdocml: .Bl -column phrases ignore spacing rules for trailing
Date: Sat, 21 Aug 2010 18:06:51 +0200	[thread overview]
Message-ID: <20100821160651.GA31898@iris.usta.de> (raw)
In-Reply-To: <4C6FB614.6010201@bsd.lv>

Hi Kristaps,

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

Or:
Literal tabs are considered normal word characters, even when
delimiting column phrases.
But that is about as confusing and surprising.

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

Right, after pondering this for some time, i tend to agree that
traditional roff behaviour of treating tab, space-tab and Ta
differently is so surprising that it should indeed be called a bug
and not a feature.

Now, as you said, this does not affect column lists only,
but literal tabs outside column lists as well.
But in literal context, there is no issue because spacing
is kept verbatim in any case, and outside literal context,
tabs are discouraged anyway.  So, basically, the tab vs space-tab
surprise only affects column lists in practice.

Given that the traditional behaviour of column lists has been
so quirky in so many ways, i regard it as sane to make it a bit
easier to understand at the expense of minor issues with backward
compatibility.  This is a case where i feel that idea applies.

So, i propose the following patch instead.
It works with all formatters.

Yours,
  Ingo


Index: operator.7
===================================================================
RCS file: /cvs/src/share/man/man7/operator.7,v
retrieving revision 1.7
diff -u -p -r1.7 operator.7
--- operator.7	31 May 2007 19:19:58 -0000	1.7
+++ operator.7	21 Aug 2010 16:04:55 -0000
@@ -41,7 +41,7 @@
 .Bl -column "= += -= *= /= %= <<= >>= &= ^= |="
 .It Operator	Associativity
 .It --------	-------------
-.It \&() [] -> .	left to right
+.It \&() [] -> \&.	left to right
 .It "! ~ ++ -- - (type) * & sizeof"	right to left
 .It \&* / %	left to right
 .It \&+ -	left to right
--
 To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv

  reply	other threads:[~2010-08-21 16:06 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
2010-08-21 16:06   ` Ingo Schwarze [this message]
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=20100821160651.GA31898@iris.usta.de \
    --to=schwarze@usta.de \
    --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).