How to report a documentation error

2011-05-06 Thread Shawn H Corey 
I noticed some errors in the documentation of Pod::Simple::HTMLBatch. 
Here's one:


% mkdir out_html
% perl -MPod::Simple::HTMLBatch -e Pod::Simple::HTMLBatch::go @INC out_html
  (to convert the pod from Perl's @INC
   files under the directory ../htmlversion)

Shouldn't ../htmlversion be ./out_html ?

What's the best way to report this?


--
Just my 0.0002 million dollars worth,
  Shawn

Confusion is the first step of understanding.

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

The secret to great software:  Fail early  often.

Eliminate software piracy:  use only FLOSS.

Re: How to report a documentation error

2011-05-06 Thread David E. Wheeler 
On May 6, 2011, at 7:55 AM, Shawn H Corey wrote:

 I noticed some errors in the documentation of Pod::Simple::HTMLBatch. Here's 
 one:
 
 % mkdir out_html
 % perl -MPod::Simple::HTMLBatch -e Pod::Simple::HTMLBatch::go @INC out_html
  (to convert the pod from Perl's @INC
   files under the directory ../htmlversion)
 
 Shouldn't ../htmlversion be ./out_html ?
 
 What's the best way to report this?

Send it to bug-pod-sim...@rt.cpan.org. Or file it here:

  https://github.com/theory/pod-simple/issues

Thanks,

David

Using UTF-8

2011-05-06 Thread Shawn H Corey 
Does Pod::Simple understand UTF-8?  I have a POD with '½' in it but when 
I run it through Pod::Simple::SimpleTree, I get '½'.  The UTF-8 code is 
C2 BD which corresponds to  and ½ in ISO-8859-1.  How do I turn on UTF-8?



--
Just my 0.0002 million dollars worth,
  Shawn

Confusion is the first step of understanding.

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

The secret to great software:  Fail early  often.

Eliminate software piracy:  use only FLOSS.

Re: Using UTF-8

2011-05-06 Thread David E. Wheeler 
On May 6, 2011, at 4:40 PM, Shawn H Corey wrote:

 Does Pod::Simple understand UTF-8?  I have a POD with '½' in it but when I 
 run it through Pod::Simple::SimpleTree, I get '½'.  The UTF-8 code is C2 BD 
 which corresponds to  and ½ in ISO-8859-1. How do I turn on UTF-8?

Add this to your pod:

=encoding utf8

Best,

David

Re: Using UTF-8

2011-05-06 Thread David E. Wheeler 
On May 6, 2011, at 5:10 PM, Shawn H Corey wrote:

 Some things are too obvious.  :)

Hey, I only learned about it by asking Sean years ago. I've used it a lot since 
then, though.

Best,

David