Jan 2013:
========

I have just added Class and object method support, and support for
Function::Parameters' "fun name( params )" and "method name( params )"
lovely new syntax.

In addition, I've written a new Practical Software Development article:

   http://www.doc.ic.ac.uk/~dcw/PSD/article4/

which tells the story of how I developed perlstub and integrated it into
my favourite editor as an example of extending the capabilities of whatever
editor you decide to use.

perlstub-1 to 5 are the various steps along the way, not directly referred
to from the PSD article, but you can easily work out which one's which.

August 2007:
===========

This is a simple but lovely perl subroutine stub generator
that I wrote a few months ago.

It writes a perl subroutine stub based on a standardised comment block!
In particular, the first line of every function comment I write is a
"typical call example", as in:
	my( a, b, c ) = callme( x, y, @z )
	my $object    = Class->method( x, y, @z )
	my( $a, $b )  = $object->method( x, y, @z )

and I observed that THIS CONTAINS ENOUGH INFO TO WRITE THE
PROTOTYPE AND @_ ARG VECTOR BREAK UP STATEMENT, into parameter
variables such as $x, $y and @z.

See eg1..5 for examples of the input format, run
	./perlstub eg1
to see the output that it produces (the expected outputs are
already present - for comparison - in eg{1,2,3}.out.

Install perlstub into your path (eg. cp perlstub ~/bin).

Then, to use it from within your favourite editor - any editor
you like as long as it's vi:-) add the following macro to your
~/.exrc:

map = ma/^}/^M!'aperlstub^M

[type each ^M as CTRL-v followed by CTRL-m]

Then, vi whole-file-eg, which is eg2 stuck in the middle of some "perl" code,
sit the cursor on the first line of the eek() function, and hit =.
Lo and behold, the entire stanza is transmogrificicicied:-) into
perl code!

