On Wed, Nov 09, 2022 at 01:47:15PM -0600, Eric Blake wrote:
On Wed, Nov 02, 2022 at 01:36:26PM +0000, Richard W.M. Jones wrote:
> > > -=item 4, 5, 6, 7
> > > +=item S<4>
> >
> > The S<> notation seems new here (so it's going to be inconsistent
with
> > the rest of this file, I think).
>
> I was going to mention this too. The S<> notation is used to insert
> non-breaking spaces (for output formats that support it) in a span of
> text so that it won't be folded over multiple lines. AFAIK it
> shouldn't have any effect here.
Ah, but it does:
Pod input around line 121: Expected text after =item, not a number
The use of S<> is there to keep the pod formatter happy when =item's
sole argument would otherwise look like a number instead of arbitrary
text.
Oh indeed! I had forgotten about this weirdness of pod.
$ cat test.pod
=over 4
=item 2
A
=item 3
B
=back
$ pod2text test.pod
2 A
test.pod around line 7: Expected text after =item, not a number
3 B
Rich.
--
Richard Jones, Virtualization Group, Red Hat
http://people.redhat.com/~rjones
Read my programming and virtualization blog:
http://rwmj.wordpress.com
virt-p2v converts physical machines to virtual machines. Boot with a
live CD or over the network (PXE) and turn machines into KVM guests.
http://libguestfs.org/virt-v2v