Skip Menu |

This queue is for tickets about the Pod-PseudoPod CPAN distribution.

Report information
The Basics
Id: 36988
Status: resolved
Priority: 0/
Queue: Pod-PseudoPod

People
Owner: Nobody in particular
Requestors: rjbs [...] cpan.org
Cc:
AdminCc:

Bug Information
Severity: Unimportant
Broken in: (no value)
Fixed in: (no value)



Subject: many tutorial POD samples lack blanks between paras
POD is paragraph-oriented. I don't know whether PseudoPod wants to change this a bit, but the documentation doesn't seem to make an explicit claim. The tutorial contains a number of segments like this: =foo =bar =baz This should be considered one paragraph, as there are no blanks between the first line (which begins a command) and the rest of the lines (which do not). If this is a difference from POD, it should be explicitly noted (or maybe it is and I missed it). If this is a mistake in the documentation, it should be corrected. If I have grossly misunderstood POD (which I doubt, but admit may be the case) I should be sternly corrected. As I don't know the facts of the matter, I have supplied no patch. -- rjbs
O'Reilly's original PseudoPod parser wasn't strictly paragraph based, and allowed the =tags to be squashed together without a separating empty line. Since that parser doesn't exist anymore, making Pod::PseudoPod *the* parser for PseudoPod, I've updated the code examples in the tutorial in r364.