Changeset 2407 for trunk/doc/misc/perlCodeConventions.tex

Timestamp:

Nov 23, 2004, 1:12:00 PM (22 years ago)

Author:

jhoblitt

Message:

allow multiple lexical variables to be declared on the same line under some circumstances

File:

• trunk/doc/misc/perlCodeConventions.tex (modified) (4 diffs)

trunk/doc/misc/perlCodeConventions.tex

@@ -1 @@
-%%% $Id: perlCodeConventions.tex,v 1.28 2004-11-23 05:03:47 jhoblitt Exp $
+%%% $Id: perlCodeConventions.tex,v 1.29 2004-11-23 23:12:00 jhoblitt Exp $
 \documentclass[panstarrs]{panstarrs}
 
@@ -457 +457 @@
 \subsection{Lexical Variables}
 
-One declaration per line with a single place between \code{my} and the identifier.
+One declaration per line with a single place between \code{my} and the identifier:
 
 \begin{verbatim}
@@ -464 +464 @@
 \end{verbatim}
 
-is preferred over
+is preferred over:
 
 \begin{verbatim}
@@ -471 +471 @@
 
 In almost all situations with the exception of when parameters are being passed
-into a subroutine.
-
-Do not put different types on the same line. Example:
-\begin{verbatim}
-    my ($foo, @fooArray);                  # AVOID!
+into a subroutine or variables are highly related \emph{and} the intent is
+plainly obvious.
+
+\begin{verbatim}
+    my ($verbose, $help);                   # Correct when the meaning is clear
+\end{verbatim}
+
+Do not put different types on the same line.  Example:
+
+\begin{verbatim}
+    my ($foo, @fooArray);                   # AVOID!
 \end{verbatim}