Parsing of .Bl arguments stops prematurely

Parsing of .Bl arguments stops prematurely

[Ulrich Spörlein]

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

Re: Parsing of .Bl arguments stops prematurely

[Kristaps Dzonsons]

> 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

Re: Parsing of .Bl arguments stops prematurely

[Ulrich Spörlein]

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