The perldoc site is the documentation that came with that particular version of Perl. The PerlFAQ site is the current sources in the perlfaq CVS. When I (or Robert) check in new things, that site updates itself.

I don't think that http://perldoc.perl.org should keep up with the the latest changes. People should get the same version of the docs that came with the latest stable version of perl.

What you don't see is that all of the docs on http://perldoc.perl.org lag behind the current sources. A lot of the perl manpages have been updated since then but you don't see it. The PerlFAQ site is a little bonus and it shouldn't be part of any policy to update anything. It doesn't have the sources that will go into the next version because it will change more, and we may even revert some changes, or make overwrite some changes. It's just a peek at the source repository because it's open source, but those versions aren't for official distribution until the pumpking accepts them and syncs the perlfaq sources with the main perl distro. Incidently, the PerlFAQ server that posts to usenet is in between the two versions. It usually isn't the latest versions, but it's newer than the distributed sources. Someone mentioned perl5porters, but these questions belong on perlfaq-workers or documentation (both @perl.org). :)

--
brian d foy <brian@stonehenge.com>

In reply to Re: perldoc.perl.org and faq.perl.org out of sync? by brian_d_foy
in thread perldoc.perl.org and faq.perl.org out of sync? by ghenry

Title:
Use:  <p> text here (a paragraph) </p>
and:  <code> code here </code>
to format your post, it's "PerlMonks-approved HTML":


  • Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!
  • Titles consisting of a single word are discouraged, and in most cases are disallowed outright.
  • Read Where should I post X? if you're not absolutely sure you're posting in the right place.
  • Please read these before you post! —
  • Posts may use any of the Perl Monks Approved HTML tags:
    a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, details, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, summary, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr
  • You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)
            For:     Use:
    & &amp;
    < &lt;
    > &gt;
    [ &#91;
    ] &#93;
  • Link using PerlMonks shortcuts! What shortcuts can I use for linking?
  • See Writeup Formatting Tips and other pages linked from there for more info.