FAQ

Search Discussions

472 discussions - 1,909 posts

  • For reasons too long and unrelated to go into (see <https://github.com/CPAN-API/cpan-api/issues/269 for the tail end of some of it), I spent a couple hours the other night whacking together a draft ...
    John SJ AndersonJohn SJ Anderson
    May 21, 2013 at 11:33 pm
    May 22, 2013 at 4:44 pm
  • This is a test-suite-only release that fixes problems with the test suite failing due to a new warning in Pod::Simple 3.26. The URL http://archives.eyrie.org/software/perl/podlators-2.5.1.tar.gz has ...
    Russ AllberyRuss Allbery
    Feb 28, 2013 at 3:29 am
    Feb 28, 2013 at 3:29 am
  • This was due to this change: https://github.com/theory/pod-simple/commit/5a01eba83824d9f91ecfae302af33fef65a8385c Note that this is a warning, rather than a fatal error, though of course Test::Pod ...
    David E. WheelerDavid E. Wheeler
    Feb 25, 2013 at 4:53 pm
    Feb 26, 2013 at 5:16 pm
  • Pod::Simple 3.24's new warning on mismatched item types has broken podlators. This is pretty unfortunate, since it also fixes hash ordering problems in tests which will be needed if some of the last ...
    Ricardo SignesRicardo Signes
    Feb 19, 2013 at 3:50 am
    Feb 21, 2013 at 1:43 am
  • Ticket https://rt.perl.org/rt3/Ticket/Display.html?id=116252 concerns pod that used hypens for what was meant to be a nested bullet list so that the nested items would not be confused with the outer ...
    Karl WilliamsonKarl Williamson
    Jan 26, 2013 at 6:29 pm
    Feb 14, 2013 at 1:14 am
  • With Pod::Parser, you just do parse_from_file($in_fh, $out_fh) and it outputs the pod to $out_fh. Pod::Simple has a method of the same name which is supposed to emulate the Pod::Parser method, but ...
    Karl WilliamsonKarl Williamson
    Jan 26, 2013 at 4:49 pm
    Mar 6, 2013 at 3:39 pm
  • This is a "clear the decks" release, taking care of various smaller bug reports and feature requests that had accumulated. There is one big change here: as of this release, pod2text and pod2man die ...
    Russ AllberyRuss Allbery
    Jan 2, 2013 at 9:55 pm
    Jan 2, 2013 at 9:55 pm
  • Hello all, The current perlpodspec contains the following requirement: · When rendering Pod to a format that allows comments (i.e., to nearly any format other than plaintext), a Pod formatter must ...
    Russ AllberyRuss Allbery
    Dec 26, 2012 at 10:47 pm
    Dec 28, 2012 at 4:08 pm
  • Pod People, See the forwarded complaint below. Should we allow `=over 0`? I tend not to think of it as the same as `=over`, because that is the same as `=over +=4`, IIRC. Best, David Begin forwarded ...
    David E. WheelerDavid E. Wheeler
    Oct 10, 2012 at 3:53 pm
    Oct 12, 2012 at 4:43 pm
  • Pod People, In https://rt.cpan.org/Ticket/Display.html?id=79232, Saven Rezic writes: None of this says anything about warnings, and it does seem that, as of 3.23, this is exactly how Pod::Simple ...
    David E. WheelerDavid E. Wheeler
    Aug 27, 2012 at 5:17 pm
    Aug 29, 2012 at 1:52 pm
  • Pod People, I got a pull request to switch to metacpan.org for L< http links. AFAIK search.cpan.org is not deprecated, and is still the official community CPAN search site. If there is some ...
    David E. WheelerDavid E. Wheeler
    Aug 13, 2012 at 4:41 pm
    Sep 30, 2012 at 3:32 am
  • So, should Pod::Simple’s HTML output: * Strip links from head elements; or * Exclude head elements with links from the TOC; or * Something else? David
    David E. WheelerDavid E. Wheeler
    Jun 7, 2012 at 4:03 pm
    Jun 7, 2012 at 4:52 pm
  • Hi POD People I've created a bit of a storm by adding the new warning to Pod::Simple which is emitted if the source POD contains non-ASCII characters but does not include an =encoding POD command ...
    Grant McLeanGrant McLean
    Jun 6, 2012 at 4:55 am
    Jun 9, 2012 at 7:45 pm
  • This release contains only a test suite fix with the latest Pod::Simple. The URL http://archives.eyrie.org/software/perl/podlators-2.4.2.tar.gz has entered CPAN as file ...
    Russ AllberyRuss Allbery
    Jun 1, 2012 at 10:53 pm
    Jun 1, 2012 at 10:53 pm
  • This is long-overdue, and still doesn't address the various character set and encoding problems, but it at least fixes a bunch of other bugs. I'm going to try to rethink the UTF-8 problem next. The ...
    Russ AllberyRuss Allbery
    May 30, 2012 at 7:02 pm
    May 30, 2012 at 7:13 pm
  • Hello: I have, what I think is, a rather simple problem, but, unfortunately, am unable to figure out a solution: I have the following, very simple script: use strict; use warnings; use Pod::Simple ...
    Alvis YardleyAlvis Yardley
    May 22, 2012 at 10:26 pm
    May 22, 2012 at 10:26 pm
  • I'm trying to use Pod::Simple::HTML to convert PODs into HTML but my voilà becomes voil&#65533; How do I fix this? Code: my $parser = Pod::Simple::HTML- new(); $parser- output_string( \my $html ) ...
    Shawn H CoreyShawn H Corey
    May 12, 2012 at 3:53 pm
    May 12, 2012 at 11:32 pm
  • I just ran `perldoc perldoc` and got this: SYNOPSIS B<perldoc [B<-h ] [B<-D ] [B<-t ] [B<-u ] [B<-m ] [B<-l ] [B<-F ] [B<-i ] [B<-V ] [B<-T ] [B<-r ] [B<-dI<destination_file ] [B<-oI<formatname ] ...
    Shawn H CoreyShawn H Corey
    Apr 30, 2012 at 2:19 pm
    May 1, 2012 at 7:13 am
  • For ActivePerl we plug in a syntax highlighter for the code snippets in the generated HTML documentation. In order to support this for perl-5.16 I ended up patching Pod::Simple::XHTML like this ...
    Gisle AasGisle Aas
    Apr 27, 2012 at 10:51 pm
    May 4, 2012 at 4:23 pm
  • How come I get this error? POD ERRORS Hey! The above document had some coding errors, which are explained below: Around line 29: You have '=item 1' instead of the expected '=item 2' Every other ...
    Shawn H CoreyShawn H Corey
    Apr 26, 2012 at 2:44 pm
    Apr 26, 2012 at 4:33 pm
  • Hi POD people There's been a discussion on #metacpan about non-ASCII characters in POD being rendered incorrectly on the metacpan.org web site. The short story is that some people use utf8 characters ...
    Grant McLeanGrant McLean
    Apr 26, 2012 at 3:23 am
    May 3, 2012 at 9:50 am
  • I don't like this inconsistency. I believe this "feature" should simply be turned off. This is a patch to do that: https://github.com/gisle/pod-simple/commit/846241382485e039ad3802af81c8c1e87afe1ac9 ...
    Gisle AasGisle Aas
    Apr 24, 2012 at 9:08 pm
    Apr 25, 2012 at 3:35 pm
  • The message cannot be represented in 7-bit ASCII encoding and has been sent as a binary attachment.
    GisleGisle
    Mar 5, 2012 at 5:09 am
    Mar 5, 2012 at 5:09 am
  • I've already asked for some testing on p5p, but oh ye devoted pod people: If you have the time, install perl from git, commit ac2b477 or later, and play around with pod2html and let us know what is ...
    Ricardo SignesRicardo Signes
    Feb 22, 2012 at 4:53 pm
    Feb 22, 2012 at 5:20 pm
  • I kinda passed off perlpodspec to... whoever... I'm pretty sure I did, to somebody.... But I'll chip in about L<guh|http://... in perlpodspec. Long story short, about L<guh|http://stuff.com/hditfn ...
    Sean M. BurkeSean M. Burke
    Feb 21, 2012 at 3:33 am
    Feb 21, 2012 at 4:57 pm
  • As I look in Pod::Simple's ./t/ dir... Gawd those tests I made with \n\n's in them, with like ten lines squooshed into one blob with \n\n\n etc, like this: print "#\n# Tests for simple =item *'s\n"; ...
    Sean M. BurkeSean M. Burke
    Feb 21, 2012 at 12:30 am
    Feb 21, 2012 at 4:56 pm
  • Hello Pod People, When given the following input, Pod::Simple does not warn that the [text] portion of the 2nd and 3rd =item is invalid. =over =item a definition some text =item * a bullet =item 1 a ...
    Marc GreenMarc Green
    Feb 19, 2012 at 9:19 pm
    Jan 18, 2013 at 8:10 pm
  • Hello Pod People, A simple (yet lengthy) question on verbatim paragraphs that immediately follow an =item command, and how Pod::Simple treats them: Given the following POD, =over =item * verbatim ...
    Marc GreenMarc Green
    Feb 19, 2012 at 5:33 am
    Feb 25, 2012 at 5:42 pm
  • Dear all, I had a look at the perlsyn, perldoc and perldocspec documents but cannot seem to find the answer to the following questions. The POD content of a module can be written into its Perl file ...
    Florent AnglyFlorent Angly
    Feb 9, 2012 at 1:32 am
    Feb 21, 2012 at 12:44 am
  • No one was proposing that. The proposal is to *optionally* use A< to create an link target *in addition to* that created by the =head or =item. The trouble with relying on =head/=item to define the ...
    Ronald J KimballRonald J Kimball
    Feb 2, 2012 at 9:21 pm
    Feb 2, 2012 at 9:21 pm
  • Hello, I think that a possibility to add a label without associating it to actual text is missing from the Pod language (unless I missed something). Indeed labels are either associated with =item or ...
    Patrice DumasPatrice Dumas
    Jan 27, 2012 at 11:36 pm
    Jan 29, 2012 at 2:25 pm
  • Hello, I have searched for a pod checker that finds missing internal links, but I haven't found one. More precisely, podchecker coming with perl 5.10 gets it wrong, it finds multiple defined labels ...
    Patrice DumasPatrice Dumas
    Jan 27, 2012 at 11:15 pm
    Feb 20, 2012 at 8:13 pm
  • Opinions? Thanks, David
    David E. WheelerDavid E. Wheeler
    Jan 25, 2012 at 8:12 pm
    Feb 14, 2013 at 12:04 am
  • Version 1.50 of Pod::Parser adds a check and message indicating that L<text|hyperlink is deprecated. This is based on the following sentences in perlpodspec, which has been there since its inception ...
    Karl WilliamsonKarl Williamson
    Jan 23, 2012 at 4:06 pm
    Jan 24, 2012 at 8:52 pm
  • Just reviewing the Pod::Simple bug queues and saw this: https://rt.cpan.org/Ticket/Display.html?id=70848 Is that a related issue? Thanks, David
    David E. WheelerDavid E. Wheeler
    Jan 3, 2012 at 12:48 am
    Jan 3, 2012 at 12:48 am
  • Fellow Pod People, Would you make a quick pass through the Pod::Simple bug queue? I’m trying to ascertain what issues need to be addressed for 3.20. The queue: ...
    David E. WheelerDavid E. Wheeler
    Jan 3, 2012 at 12:45 am
    Jan 3, 2012 at 12:45 am
  • Hello, Unless I have missed something, seems that Pod::Parser is not used much, and pod formatting used within perl uses Pod::Simple and most formatter have switched to using Pod::Simple except for ...
    Patrice DumasPatrice Dumas
    Dec 5, 2011 at 9:33 pm
    Dec 5, 2011 at 9:33 pm
  • Hello all, My refactored version of Pod::Html ( https://github.com/marcgreen/perl/tree/gsoc-pod-final/ext/Pod-Html), which replaces Pod::Parser with Pod::Simple, has passed (or at least failed due to ...
    Marc GreenMarc Green
    Nov 19, 2011 at 8:02 pm
    Nov 20, 2011 at 12:18 pm
  • Hello Pod People, I am emailing to provoke discussion on two warnings that Pod::Checker displays that I think should be removed. Pod::Checker currently warns if there is an '=item' directive with no ...
    Marc GreenMarc Green
    Aug 11, 2011 at 10:40 am
    Aug 12, 2011 at 5:32 pm
  • I can definitely see the usefulness of a link that leads to all the indexed entries for a particular term. However, I'm not convinced this should replace the current behavior for L< . There's a ...
    Ronald J KimballRonald J Kimball
    Aug 5, 2011 at 12:52 am
    Aug 5, 2011 at 3:15 am
  • Hey everyone, This is my weekly status update. I have nothing new to report on Pod::Html except that I plan on doing some commit squashing so the history is not so ugly. On Pod::Checker, however, ...
    Marc GreenMarc Green
    Aug 2, 2011 at 1:19 am
    Aug 24, 2011 at 2:31 pm
  • Cc: pod-people@perl.org ... trying to segue the discussion into that list. It's legal and encouraged for the same index term to reference multiple points in the broader text. Indexes have always done ...
    Rocco CaputoRocco Caputo
    Jul 31, 2011 at 9:34 pm
    Jul 31, 2011 at 9:34 pm
  • Howdy, Over the past week I was able to implement a --nopoderrors flag in Pod::Html and finish the test cases for Pod::Html, both of which were described in my last update. However, I was not able to ...
    Marc GreenMarc Green
    Jul 5, 2011 at 1:50 am
    Jul 27, 2011 at 7:13 pm
  • In perldiag.pod, there is a line like this =item Z< 500 Server error All the other items form a definition list. My guess is that this is to make sure that the 500 isn't mistaken for a numbered =item ...
    Karl WilliamsonKarl Williamson
    Jun 26, 2011 at 3:53 am
    Jun 26, 2011 at 7:57 pm
  • Hello Pod People, Given the following erroneous POD, should the formatter interpret the bold line as the start of a text paragraph and indent it (and therefore each line afterwards would also be ...
    Marc GreenMarc Green
    Jun 25, 2011 at 8:19 pm
    Jun 26, 2011 at 9:12 am
  • Anyone know offhand? Best, David Begin forwarded message:
    David E. WheelerDavid E. Wheeler
    Jun 20, 2011 at 7:04 pm
    Jun 20, 2011 at 7:04 pm
  • Hello, I am having difficulty understanding how Pod::Html uses --htmldir and --htmlroot. Rather, I understand how it uses them in the code, but I cannot grasp their overall function or purpose. Do ...
    Marc GreenMarc Green
    Jun 13, 2011 at 7:58 pm
    Jun 13, 2011 at 7:58 pm
  • David E. WheelerDavid E. Wheeler
    Jun 11, 2011 at 4:07 pm
    Jun 11, 2011 at 5:30 pm
  • Hello again, I am writing another status report as an addendum to my last, as I was able to meet on irc with my mentor today. The primary thing discussed was my test cases for Pod::Html. rjbs ...
    Marc GreenMarc Green
    Jun 7, 2011 at 4:10 am
    Jun 7, 2011 at 4:10 am
  • Howdy, This is my weekly status update for my GSoC Project. I have been on vacation this week, so expectedly not much has been accomplished. Also, I have not met with my mentors this week (because of ...
    Marc GreenMarc Green
    Jun 5, 2011 at 8:28 pm
    Jun 27, 2011 at 11:40 pm
Group Navigation
period‹ prev | Latest | first ›

Top users

Sburke: 249 posts Russ Allbery: 236 posts David E . Wheeler: 82 posts Brad Appleton: 81 posts Ricardo Signes: 76 posts Jarkko Hietaniemi: 47 posts Schwern: 44 posts Karl williamson: 42 posts David E . Wheeler: 37 posts Allison Randal: 33 posts Marc: 32 posts Shawn H Corey: 27 posts Nicholas Clark: 26 posts Reini Urban: 26 posts Marek Rouchal: 25 posts Gbarr: 23 posts Barries: 21 posts Jvromans: 21 posts Rjk: 19 posts Sean M. Burke: 19 posts
show more
Archives