This is what I've done: create a repository, although most of my items are one line fragments and not sub-routines, at present it's got a directory per idiom, but soon it'll be in postgres and fairly cook.

Best practices is a big can of worms, Ideally subroutines should be written like any other code, concisely, legibly etc. Are you asking for details on whether to prototype and such?

I kinda did functions at university in lisp, but in learning the Perl way, I did books, and lo they were good:

• A pretty good book with some generic coding standards is Kernigan and Pikes "Practice of Programming" chapter 2 seperates well-written from beautification.
• "Effective Perl Programming" also has some insights into the matter, highlightig issues with prototypes.
• "Debugging Perl is quite useful on functions, and since reading I've increased my use of return values to return status.
• Damian Conway's "OO Perl" has two blindingly good chapters on what you should already know & what you mightn't already know. There is loads of goodies in there on AUTOLOAD and gifts that can spice up your subroutines ;-)

The only verbal hints I got were, "it's script dummy, check your failures and leave as soon as possible", which works for me.

Now I write functions to be called from a 'jump table' a hash of references to functions, my initial reason for doing this was deprecated when I discovered AUTOLOAD. Other than that I use subs to perfom one overall function and further more low-level functions under that, I like abstraction and subs to be no more than 60 lines ¹.

1. Which is a marked increase from my Lisp days when functions never grew longer than 4 lines.

--

Brother Frankus.

---

---

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! —

• How do I compose an effective node title?
• How do I post a question effectively?
• Markup in the Monastery

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:
	&		&
	<		&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.