Re: an 'anchor' command is missing from Pod

2012-01-28 Thread Shawn H Corey
On 12-01-27 11:14 PM, Ricardo Signes wrote: You're thinking of X -- Z should always be empty, and is a zero-effect code. Xopen is used to help indexing. It isn't how perldoc -f works, though. No, I've encountered unempty Z in some PODs. -- Just my 0.0002 million dollars worth,

AW: an 'anchor' command is missing from Pod

2012-01-28 Thread Marek Rouchal
AFAIK Z never has any content, and is used only to put something into a place where some content is expected but without actually putting any readable content there... something like: Z I want to start a line with whitespace but it should not be interpreted as a verbatim block Xkeyword is, as

AW: pod checker that finds missing internal links?

2012-01-28 Thread Marek Rouchal
podchecker _does_ detect wrong internal links. If you put any of the following links in the POD you quoted below, podchecker (as of Pod-Parser-1.38 and higher) will flag it as an error: L/open FILEHANDLE,MODE,EXPRESSION Lopen FILEHANDLE,MODE,EXPRESSION L/open FILEHANDLE,MODE,EXPRESSION It is

Re: pod checker that finds missing internal links?

2012-01-28 Thread 'Patrice Dumas'
On Sat, Jan 28, 2012 at 03:38:48PM +0100, Marek Rouchal wrote: podchecker _does_ detect wrong internal links. If you put any of the following links in the POD you quoted below, podchecker (as of Pod-Parser-1.38 and higher) will flag it as an error: L/open FILEHANDLE,MODE,EXPRESSION