[doc] POD escape B<> is not handled in verbatim section

[fperrad]

in verbatim section, escape B<> is not handled.

for example, in docs/book/ch05_pge.pod :

Run the test script:

  $ B<parrot grammar_test.pir>

becomes in ch05_pge.pod.html

<p>Then compile the grammar:</p>

<pre>  $ B&#60;parrot Perl6Grammar.pbc &#45;&#45;output=Contacts.pir Contacts.pg&#62;</pre>

These escapes were recently added :

• ch02_getting_started.pod in r38451
• ch05_pge.pod in r38564

The attached patch removes them.

[fperrad]

remove B<> in verbatim section

[jkeenan]

This patch seemed reasonable enough. But when I went to apply it and then checked theh patched files with podchecker, I got errors like these:

$ podchecker docs/book/ch02_getting_started.pod 
*** ERROR: Unknown interior-sequence 'U' at line 10 in file docs/book/ch02_getting_started.pod
*** ERROR: Unknown interior-sequence 'U' at line 11 in file docs/book/ch02_getting_started.pod
*** ERROR: Unknown interior-sequence 'U' at line 17 in file docs/book/ch02_getting_started.pod
*** ERROR: =end without =begin at line 120 in file docs/book/ch02_getting_started.pod
*** ERROR: =end without =begin at line 131 in file docs/book/ch02_getting_started.pod
docs/book/ch02_getting_started.pod has 5 pod syntax errors.

And, applying podchecker to docs/book/*.pod more generally, I got abundant errors.

ISTR that Allison is doing some work getting the book ready for publication. Is this a special POD format?

So I didn't apply the patch yet. Thank you very much.

kid51

[jkeenan]

Replying to jkeenan:

Coke reported on #parrot that this is Pseudo-Pod. Assigning ticket to Allison.

[coke]

The right approach here is to make our POD -> HTML converter smarter, not to strip out usages of B<>

[coke]

See also TT#559.