sseshachala/joomla-platform — pull request #1 by elkuku (2011-11-05 06:03:41+00:00)
Title: Code style fixes

Please accept some code style fixes.
The remaining errors (as far as I can see) belong to docblocks. A person that really knows the code is required for this job ;)
Here are the remaining (few) errors - don't get discouraged ;)

FILE: .../libraries/joomla/database/database.php
FOUND 5 ERROR(S) AFFECTING 5 LINE(S)
1742 | ERROR | Missing @return tag in function comment
1752 | ERROR | Missing @return tag in function comment
1753 | ERROR | Arguments with default values must be at the end of the argument list
1760 | ERROR | @return tag is empty in function comment
1767 | ERROR | @return tag is empty in function comment

FILE: .../libraries/joomla/database/database/mysql.php
FOUND 16 ERROR(S) AFFECTING 11 LINE(S)
800 | ERROR | Doc comment for "$dbName" missing
802 | ERROR | Missing @return tag in function comment
812 | ERROR | Expected 3 spaces before variable type
812 | ERROR | Expected 2 spaces after the longest type
812 | ERROR | Expected 2 spaces after the longest variable name
813 | ERROR | Expected 3 spaces before variable type
813 | ERROR | The comments for parameters $oldTable (1) and $prefix (2) do not align
814 | ERROR | Expected 3 spaces before variable type
816 | ERROR | Expected 3 spaces before variable type
816 | ERROR | The comments for parameters $backup (3) and $newTable (4) do not align
817 | ERROR | Missing @return tag in function comment
818 | ERROR | Arguments with default values must be at the end of the argument list
837 | ERROR | Expected 3 spaces before variable type
837 | ERROR | Missing comment for param "$table" at position 1
839 | ERROR | @return tag is empty in function comment
859 | ERROR | @return tag is empty in function comment

FILE: .../libraries/joomla/database/database/mysqli.php
FOUND 17 ERROR(S) AFFECTING 11 LINE(S)
830 | ERROR | Doc comment for "$dbName" missing
832 | ERROR | Missing @return tag in function comment
841 | ERROR | Expected 3 spaces before variable type
841 | ERROR | Expected 2 spaces after the longest type
841 | ERROR | Expected 2 spaces after the longest variable name
841 | ERROR | There must be exactly one blank line before the tags in function comment
842 | ERROR | Expected 3 spaces before variable type
842 | ERROR | The comments for parameters $oldTable (1) and $prefix (2) do not align
843 | ERROR | Expected 3 spaces before variable type
845 | ERROR | Expected 3 spaces before variable type
845 | ERROR | The comments for parameters $backup (3) and $newTable (4) do not align
846 | ERROR | Missing @return tag in function comment
847 | ERROR | Arguments with default values must be at the end of the argument list
864 | ERROR | Expected 3 spaces before variable type
864 | ERROR | Missing comment for param "$table" at position 1
866 | ERROR | @return tag is empty in function comment
886 | ERROR | @return tag is empty in function comment

FILE: .../libraries/joomla/database/database/sqlazure.php
FOUND 23 ERROR(S) AFFECTING 11 LINE(S)
225 | ERROR | Doc comment for "$className" missing
280 | ERROR | Doc comment for "$numinarray" missing
412 | ERROR | Doc comment for "$column" missing
445 | ERROR | Last parameter comment requires a blank newline after it
445 | ERROR | Expected 3 spaces before variable type
445 | ERROR | Doc comment for var The does not match actual variable name $key at position 1
445 | ERROR | Expected 2 spaces after the longest type
445 | ERROR | Expected 2 spaces after the longest variable name
445 | ERROR | Doc comment for "$className" missing
569 | ERROR | Parameters must appear immediately after the comment
569 | ERROR | Expected 3 spaces before variable type
569 | ERROR | Doc comment for var $updateNulls does not match actual variable name $table at position 1
569 | ERROR | Missing comment for param "$updateNulls" at position 1
569 | ERROR | Doc comment for "$object" missing
569 | ERROR | Doc comment for "$keyName" missing
569 | ERROR | Doc comment for "$updateNulls" missing
570 | ERROR | Missing @return tag in function comment
616 | ERROR | You must use "/**" style comments for a function comment
1208 | ERROR | Doc comment for "$abortOnError" missing
1208 | ERROR | Doc comment for "$transactionSafe" missing
1318 | ERROR | Doc comment for "$dbName" missing
1320 | ERROR | Missing @return tag in function comment
1337 | ERROR | Arguments with default values must be at the end of the argument list

FILE: .../libraries/joomla/database/database/sqlsrv.php
FOUND 27 ERROR(S) AFFECTING 12 LINE(S)
177 | ERROR | Extra newline(s) found before function comment short description
179 | ERROR | There must be exactly one blank line before the tags in function comment
226 | ERROR | Doc comment for "$className" missing
230 | ERROR | Return comment requires a blank newline after it
286 | ERROR | Expected 3 spaces before variable type
286 | ERROR | Doc comment for var [ UNKNOWN ] does not match actual variable name $numinarray at position 1
286 | ERROR | Missing parameter name at position 1
286 | ERROR | Missing type at position 1
286 | ERROR | Missing comment for param "[ UNKNOWN ]" at position 1
416 | ERROR | Expected 3 spaces before variable type
416 | ERROR | The variable names for parameters $key (1) and [ UNKNOWN ] (2) do not align
416 | ERROR | The comments for parameters $key (1) and [ UNKNOWN ] (2) do not align
416 | ERROR | Doc comment for var [ UNKNOWN ] does not match actual variable name $column at position 2
416 | ERROR | Missing parameter name at position 2
416 | ERROR | Missing type at position 2
416 | ERROR | Missing comment for param "[ UNKNOWN ]" at position 2
416 | ERROR | Expected 2 spaces after the longest type
571 | ERROR | Doc comment for "$table" missing
571 | ERROR | Doc comment for "$object" missing
571 | ERROR | Doc comment for "$keyName" missing
571 | ERROR | Doc comment for "$updateNulls" missing
575 | ERROR | Missing @return tag in function comment
624 | ERROR | @return tag is empty in function comment
1224 | ERROR | Missing comment for param "$abortOnError" at position 1
1225 | ERROR | The comments for parameters $abortOnError (1) and $transactionSafe (2) do not align
1225 | ERROR | Missing comment for param "$transactionSafe" at position 2
1358 | ERROR | Arguments with default values must be at the end of the argument list