Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

perl::critic::policy::codelayout::prohibitparenswithbuiltins(3pm) [debian man page]

Perl::Critic::Policy::CodeLayout::ProhibitParensWithBuilUser(Contributed Perl DocPerl::Critic::Policy::CodeLayout::ProhibitParensWithBuiltins(3pm)

NAME

       Perl::Critic::Policy::CodeLayout::ProhibitParensWithBuiltins - Write "open $handle, $path" instead of "open($handle, $path)".

AFFILIATION

       This Policy is part of the core Perl::Critic distribution.

DESCRIPTION

       Conway suggests that all built-in functions be called without parentheses around the argument list.  This reduces visual clutter and
       disambiguates built-in functions from user functions.  Exceptions are made for "my", "local", and "our" which require parentheses when
       called with multiple arguments.

	   open($handle, '>', $filename); #not ok
	   open $handle, '>', $filename;  #ok

	   split(/$pattern/, @list); #not ok
	   split /$pattern/, @list;  #ok

CONFIGURATION

       This Policy is not configurable except for the standard options.

NOTES

       Coding with parentheses can sometimes lead to verbose and awkward constructs, so I think the intent of Conway's guideline is to remove only
       the unnecessary parentheses.  This policy makes exceptions for some common situations where parentheses are usually required.  However, you
       may find other situations where the parentheses are necessary to enforce precedence, but they cause still violations.  In those cases,
       consider using the '## no critic' comments to silence Perl::Critic.

BUGS

       Some builtin functions (particularly those that take a variable number of scalar arguments) should probably get parentheses.  This policy
       should be enhanced to allow the user to specify a list of builtins that are exempt from the policy.

AUTHOR

       Jeffrey Ryan Thalhammer <jeff@imaginative-software.com>

COPYRIGHT

       Copyright (c) 2005-2011 Imaginative Software Systems.  All rights reserved.

       This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.  The full text of this license
       can be found in the LICENSE file included with this module.

perl v5.14.2							    2012-06-07	 Perl::Critic::Policy::CodeLayout::ProhibitParensWithBuiltins(3pm)

Check Out this Related Man Page

Perl::Critic::Policy::CodeLayout::ProhibitHardTabs(3pm) User Contributed Perl DocumentationPerl::Critic::Policy::CodeLayout::ProhibitHardTabs(3pm)

NAME

       Perl::Critic::Policy::CodeLayout::ProhibitHardTabs - Use spaces instead of tabs.

AFFILIATION

       This Policy is part of the core Perl::Critic distribution.

DESCRIPTION

       Putting hard tabs in your source code (or POD) is one of the worst things you can do to your co-workers and colleagues, especially if those
       tabs are anywhere other than a leading position.  Because various applications and devices represent tabs differently, they can cause you
       code to look vastly different to other people.  Any decent editor can be configured to expand tabs into spaces.	Perl::Tidy also does this
       for you.

       This Policy catches all tabs in your source code, including POD, quotes, and HEREDOCs.  The contents of the "__DATA__" section are not
       examined.

CONFIGURATION

       Hard tabs in a string are always forbidden (use "	" instead).  But hard tabs in a leading position are allowed when they are used to
       indent code statements, "qw()" word lists, and regular expressions with the "/x" modifier.  However, if you want to forbid all tabs
       everywhere, then add this to your .perlcriticrc file:

	   [CodeLayout::ProhibitHardTabs]
	   allow_leading_tabs = 0

NOTES

       Beware that Perl::Critic may report the location of the string that contains the tab, not the actual location of the tab, so you may need
       to do some hunting.  I'll try and fix this in the future.

AUTHOR

       Jeffrey Ryan Thalhammer <jeff@imaginative-software.com>

COPYRIGHT

       Copyright (c) 2005-2011 Imaginative Software Systems.  All rights reserved.

       This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.  The full text of this license
       can be found in the LICENSE file included with this module.

perl v5.14.2							    2012-06-07		   Perl::Critic::Policy::CodeLayout::ProhibitHardTabs(3pm)
Man Page