Re: Non-ASCII data in POD

2012-04-26 Thread Karl Williamson

On 04/25/2012 09:25 PM, Russ Allbery wrote:

Grant McLeangr...@mclean.net.nz  writes:


My thoughts on the second issue are that we could modify Pod::Simple to
'whine' if it sees non-ASCII bytes but no =encoding.  This in turn would
cause Test::Pod to pick up the error and help people fix it.


I would be in favor of that.



FYI, This test is already in the checks that are run on the pods that 
are included with the perl core


Re: =item 1. Error

2012-04-26 Thread Shawn H Corey

On 12-04-26 11:57 AM, Russ Allbery wrote:

1. If the =item tags are numeric, ignore the value of the numbers and just
renumber them.  This is similar to what other markup languages do, but
it has the significant problem of making it a bit more annoying to
document, say, a list of exit status returns, where several numbers are
skipped.


=over

=item Z42

The answer to the Ultimate Question.

=back


--
Just my 0.0002 million dollars worth,
  Shawn

Programming is as much about organization and communication
as it is about coding.

[updated for today's programmers]
Show me your code and conceal your interfaces, and I shall continue
to be mystified. Show me your interfaces, and I won't usually need
your code; it'll be obvious.
-- Fred Brooks

Don't be clever; being great is good enough.