jifty::manual::style(3pm) [debian man page]

Jifty::Manual::Style(3pm)				User Contributed Perl Documentation				 Jifty::Manual::Style(3pm)

NAME

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

       Default style

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

       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 code.

	 =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 run.

       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$barE/i;
	   $foo =~ /^bar$/i;

perl v5.14.2							    2010-12-08						 Jifty::Manual::Style(3pm)

Jifty::Manual(3pm)					User Contributed Perl Documentation					Jifty::Manual(3pm)

NAME

       Jifty::Manual - Jifty documentation

DESCRIPTION

       This manual is divided into many separate pages, each covering a specific topic thoroughly.

       Jifty::Manual::AccessControl
	   Implementing access controls in your Jifty app

       Jifty::Manual::Actions
	   All about actions and how to use them

       Jifty::Manual::Continuations
	   Continuations made easy. Easier..

       Jifty::Manual::Cookbook
	   Chunk-sized pearls of wisdom for accomplishing common tasks

       Jifty::Manual::Deploying
	   How to go from "jifty server" to a robust web-server and database environment

       Jifty::Manual::FAQ
	   Frequently asked questions, for some value of frequent

       Jifty::Manual::Glossary
	   Common terms that you might want to learn

       Jifty::Manual::Logging
	   How to control Jifty's logging, which is backed by Log::Log4perl

       Jifty::Manual::Models
	   All about models -- the creepy crawlies that live in your database

       Jifty::Manual::ObjectModel
	   How all the bits of Jifty hang together

       Jifty::Manual::PageRegions
	   You too can have sexy AJAX!

       Jifty::Manual::RequestHandling
	   The life cycle of a page load

       Jifty::Manual::Style
	   Style guide for the Jifty project itself

       Jifty::Manual::Tutorial
	   Your first stop on this tour

       Jifty::Manual::TutorialRest
	   Using the REST API in your application

       Jifty::Manual::Tutorial_de
	   The tutorial in German

       Jifty::Manual::Tutorial_ja
	   The tutorial in Japanese

       Jifty::Manual::Tutorial_zhtw
	   The tutorial in Traditional Chinese

       Jifty::Manual::Upgrading
	   How to change your application's database

       Jifty::Manual::UsingCSSandJS
	   How to use custom CSS and JavaScript in your application

perl v5.14.2							    2010-09-25							Jifty::Manual(3pm)