Beefy Boxes and Bandwidth Generously Provided by pair Networks
go ahead... be a heretic

Comment on

( #3333=superdoc: print w/replies, xml ) Need Help??

For my particualar module, the audience is programmers. I doubt anyone who isn't an experienced Perl programmer cares one whit about what sort of exception they use.

However, this is a tutorial. It needs to consider other sorts of programs, not just my particualar one. It also needs to consider the views of the community and not just personal agendas.

Some software is written for people who program. Some software is written for people who merely want to use it. All they know is that they have to run the script using a perl interpreter. PHP, C, Java all support applications written for both communities. Should Perl be different?

My sense is that the Perl community is divided on this issue. There are some people think Perl should be a language for programmers by programmers and that all modules should either be installed by programmers or people who are willing to learn some of the skills of programmers. For this portion of the community, the idea of a makeless build is silly.

There are others who would like to see Perl attract a wider audience that included non-programmers, developers who think build is a GUI button, and people who just want drop-in functionality on their website or desktop. If this is a goal, making make a prerequiste to downloading CPAN modules is an impediment. You don't need make to write Perl programs. You don't need make to use Perl programs. You don't even need make to copy scripts from one place to another nor to run tests, so why require it? It is like insisting that everyone who wants to eat cheese go out and buy a diamond cutter. It doesn't make the cheese taste better and it gets in the way of eating cheese.

My own views are in the second camp. I would like to see Perl software be readily available to the widest audience possible. However, that is immaterial to this tutorial.

In the tutorial the views expressed about portability were culled from a number of sources both within and without the Perl community. The portability issues of make have been a concern for sometime even within the *nix community. GNU jumps through hoops to make sure its software can be reliably built on multiple platforms using make. Ant, used by the Java community, was in part a response to portability issues related to make/nmake/dmake. Those responsible for the Perl itself were persuaded that this was a legitimate enough issue that they included an option for make-less builds via Module::Build in the Perl core. I would be remiss not to mention the portibility issues, even if I thought they were totally stupid. (Note: my personal view is that for C/C++ compilation we still don't have a better tool, so make stands as the tool of choice regardless of difficulties)

A more reasonable complaint would be something like this: your discussion of CPAN module development is too biased towards pure Perl modules. This tutorial does not address the needs of XS module builders for whom make is still the gold standard.

In reply to Re^6: RFC: How to Release Modules on CPAN in 2011 by ELISHEVA
in thread RFC: How to Release Modules on CPAN in 2011 by ELISHEVA

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, 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, 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.
  • Log In?

    What's my password?
    Create A New User
    and all is quiet...

    How do I use this? | Other CB clients
    Other Users?
    Others chanting in the Monastery: (5)
    As of 2018-02-24 12:56 GMT
    Find Nodes?
      Voting Booth?
      When it is dark outside I am happiest to see ...

      Results (310 votes). Check out past polls.