The reliance on unix in the perldoc(umentation) has always been a pet peeve of mine. On the one hand, a lot of perl's functions are straight from C unix functions, but perldoc still refers you to unix manpages. The first paragraph of the sprintf documentation:

Returns a string formatted by the usual printf() conventions of the C library function sprintf(). See sprintf(3) or printf(3) on your system for an explanation of the general principles.

I mean, that just slams the door in the face of anyone trying to learn perl on a system without manpages. I might expect this for something obscure like setpgrp, but sprintf?. The docs also has very limited examples. I've been using sprintf since before Perl was conceived, so this is not an issue for me, but it's always rubbed me the wrong way when I peruse the perldocs (even ActiveState's Win32 version) and come across references to unix functions and manpages. Surely we (the perl community) can come up with something better? Telling people to learn unix is not a solution: one of the strengths of perl is, IMO, the way it transcends notions of OS and system flavors. It's a better "write once, run everywhere" than Java is (with exceptions). Basic C books take the time to expand on s?printf - why shouldn't we?

</SOAPBOX>

P.S. I know, less talk, more action. Maybe I'll add it to my incredibly long "todo" list. :)


In reply to Re: Linux vs. Windows for Learning Perl by turnstep
in thread Linux vs. Windows for Learning Perl by OzzyOsbourne

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.