tech@mandoc.bsd.lv
 help / color / mirror / Atom feed
* Parsing of .Bl arguments stops prematurely
@ 2010-06-01 15:38 Ulrich Spörlein
  2010-06-03 15:19 ` Kristaps Dzonsons
  0 siblings, 1 reply; 3+ messages in thread
From: Ulrich Spörlein @ 2010-06-01 15:38 UTC (permalink / raw)
  To: tech

Sigh,

one more buglet that I want to get off my chest:

.Bl -column -compact "Microcom Travelcard" "MALO111" "CardBus" "a/b/g" -offset 6n
.It Em Card Ta Em Chip Ta Em Bus Ta Em Standard
.It Netgear WG311v3     88W8335 PCI     b/g
.It Tenda TWL542P       88W8335 PCI     b/g
.It U-Khan UW-2054i     88W8335 PCI     b/g
.El

mdocml will interpret -offset and 6n as additional column width
arguments and then complain that there are only 4 columns, but it wanted
to see 6. Naturally, the list is also *not* offset by 6n.

This, on the other hand, renders just like groff does (ie. offset by 6n)
and also no longer complains while in lint mode.

.Bl -column -offset 6n -compact "Microcom Travelcard" "MALO111" "CardBus" "a/b/g"
.It Em Card Ta Em Chip Ta Em Bus Ta Em Standard
.It Netgear WG311v3     88W8335 PCI     b/g
.It Tenda TWL542P       88W8335 PCI     b/g
.It U-Khan UW-2054i     88W8335 PCI     b/g
.El


If the previous usage won't be supported, that's fine by me I just want
to know so I can fix the FreeBSD manpage corpus the right way ...

Regards,
Uli
--
 To unsubscribe send an email to tech+unsubscribe@mdocml.bsd.lv

^ permalink raw reply	[flat|nested] 3+ messages in thread

* Re: Parsing of .Bl arguments stops prematurely
  2010-06-01 15:38 Parsing of .Bl arguments stops prematurely Ulrich Spörlein
@ 2010-06-03 15:19 ` Kristaps Dzonsons
  2010-06-07 10:10   ` Ulrich Spörlein
  0 siblings, 1 reply; 3+ messages in thread
From: Kristaps Dzonsons @ 2010-06-03 15:19 UTC (permalink / raw)
  To: tech

> one more buglet that I want to get off my chest:
> 
> .Bl -column -compact "Microcom Travelcard" "MALO111" "CardBus" "a/b/g" -offset 6n
> .It Em Card Ta Em Chip Ta Em Bus Ta Em Standard
> .It Netgear WG311v3     88W8335 PCI     b/g
> .It Tenda TWL542P       88W8335 PCI     b/g
> .It U-Khan UW-2054i     88W8335 PCI     b/g
> .El
> 
> mdocml will interpret -offset and 6n as additional column width
> arguments and then complain that there are only 4 columns, but it wanted
> to see 6. Naturally, the list is also *not* offset by 6n.
> 
> This, on the other hand, renders just like groff does (ie. offset by 6n)
> and also no longer complains while in lint mode.
> 
> .Bl -column -offset 6n -compact "Microcom Travelcard" "MALO111" "CardBus" "a/b/g"
> .It Em Card Ta Em Chip Ta Em Bus Ta Em Standard
> .It Netgear WG311v3     88W8335 PCI     b/g
> .It Tenda TWL542P       88W8335 PCI     b/g
> .It U-Khan UW-2054i     88W8335 PCI     b/g
> .El
> 
> 
> If the previous usage won't be supported, that's fine by me I just want
> to know so I can fix the FreeBSD manpage corpus the right way ...

Ulrich,

This is just bad -mdoc: mdoc.samples documents either the "old way" (`Bl
-column xxx yyy zzz -width...') or the "new way" (`Bl -column -width...
xxx yyy zz').  mandoc supports both of these (it internally re-writes
them into the old way).

I'd really rather not support this syntax as it would mean jumping
between "args" and "argv" handling.  This would require a near-complete
overhaul to mdoc_macro.c.  Ugh.

I am, however, pretty surprised groff is able to handle it.

Do you see this happening often?

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

^ permalink raw reply	[flat|nested] 3+ messages in thread

* Re: Parsing of .Bl arguments stops prematurely
  2010-06-03 15:19 ` Kristaps Dzonsons
@ 2010-06-07 10:10   ` Ulrich Spörlein
  0 siblings, 0 replies; 3+ messages in thread
From: Ulrich Spörlein @ 2010-06-07 10:10 UTC (permalink / raw)
  To: tech

Hi Kristaps, sorry for the delay ...

On Thu, 03.06.2010 at 17:19:03 +0200, Kristaps Džonsons wrote:
> > one more buglet that I want to get off my chest:
> > 
> > .Bl -column -compact "Microcom Travelcard" "MALO111" "CardBus" "a/b/g" -offset 6n
> > .It Em Card Ta Em Chip Ta Em Bus Ta Em Standard
> > .It Netgear WG311v3     88W8335 PCI     b/g
> > .It Tenda TWL542P       88W8335 PCI     b/g
> > .It U-Khan UW-2054i     88W8335 PCI     b/g
> > .El
> > 
> > mdocml will interpret -offset and 6n as additional column width
> > arguments and then complain that there are only 4 columns, but it wanted
> > to see 6. Naturally, the list is also *not* offset by 6n.
> > 
> > This, on the other hand, renders just like groff does (ie. offset by 6n)
> > and also no longer complains while in lint mode.
> > 
> > .Bl -column -offset 6n -compact "Microcom Travelcard" "MALO111" "CardBus" "a/b/g"
> > .It Em Card Ta Em Chip Ta Em Bus Ta Em Standard
> > .It Netgear WG311v3     88W8335 PCI     b/g
> > .It Tenda TWL542P       88W8335 PCI     b/g
> > .It U-Khan UW-2054i     88W8335 PCI     b/g
> > .El
> > 
> > 
> > If the previous usage won't be supported, that's fine by me I just want
> > to know so I can fix the FreeBSD manpage corpus the right way ...
> 
> Ulrich,
> 
> This is just bad -mdoc: mdoc.samples documents either the "old way" (`Bl
> -column xxx yyy zzz -width...') or the "new way" (`Bl -column -width...
> xxx yyy zz').  mandoc supports both of these (it internally re-writes
> them into the old way).
> 
> I'd really rather not support this syntax as it would mean jumping
> between "args" and "argv" handling.  This would require a near-complete
> overhaul to mdoc_macro.c.  Ugh.
> 
> I am, however, pretty surprised groff is able to handle it.
> 
> Do you see this happening often?

Yeah, well, groff's ways are mysterious :)

But only a handful of the FreeBSD manpages are affected and I have no
problem with fixing those ...

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

^ permalink raw reply	[flat|nested] 3+ messages in thread

end of thread, other threads:[~2010-06-07 10:10 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2010-06-01 15:38 Parsing of .Bl arguments stops prematurely Ulrich Spörlein
2010-06-03 15:19 ` Kristaps Dzonsons
2010-06-07 10:10   ` Ulrich Spörlein

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