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