Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
Jifty::Manual::Style(3User Contributed Perl DocumentatiJifty::Manual::Style(3)

       Jifty::Manual::Style - Jifty coding style guide

       Default style

       When in doubt, default to whatever Damian Conway's Perl Best Practices

       Private documentation

       When documenting	a private method, or providing documentation which is
       not useful to the user of the module (and is presumably useful to the
       developer), wrap	it in =begin/end private.  This	way it does not	show
       up in perldoc where a user would	see it and yet is still	available and
       well formatted (that is,	not just a lump	comment) when looking at the

	 =begin	private

	 =head2	import_extra

	 Called	by L<Test::More>'s C<import> code when L<Jifty::Test> is first
	 C<use>'d, it calls L</setup>, and asks	Test::More to export its
	 symbols to the	namespace that C<use>'d	this one.

	 =end private

	 sub import_extra {

       Test temp files

       Files created by	tests should be	declared as such using
       Jifty::Test->test_file()	so they	are cleaned up on a successful test

       Use Shell::Command

       Shell::Command has a number of functions	which work like	common shell
       file commands such as "touch", "cp" and "mv".  They are battle tested
       and cross-platform.  Use	them instead of	coding your own.

       For example, instead of this:

	   open	my $file, ">foo";
	   close $file;

       Do this:

	   use Shell::Command;
	   touch $file;

       Case insensitive	matching

       To check	if a string equals another string case insensitively, do this

	   lc $foo eq lc $bar;
	   lc $foo eq 'bar';

       not this:

	   $foo	=~ /^\Q$bar\E/i;
	   $foo	=~ /^bar$/i;

perl v5.24.1			  2013-01-29	       Jifty::Manual::Style(3)


Want to link to this manual page? Use this URL:

home | help