From b649557726964c2f4b762e4074af6178a63119fa Mon Sep 17 00:00:00 2001
From: pedro_morgan <pedro_morgan@ispconfig3>
Date: Fri, 17 Aug 2007 20:33:53 -0400
Subject: [PATCH] Adding some kind of coding guidelines
---
CODING_NOTES.php.txt | 88 ++++++++++++++++++++++++++++++++++++++++++++
1 files changed, 88 insertions(+), 0 deletions(-)
diff --git a/CODING_NOTES.php.txt b/CODING_NOTES.php.txt
new file mode 100644
index 0000000..2108956
--- /dev/null
+++ b/CODING_NOTES.php.txt
@@ -0,0 +1,88 @@
+Some guidelines for web development with php.
+-----------------------------------------------------
+Unix Line Breaks Only, NO windows breaks please.
+
+Tabs set at 4 spaces either as tabs or spaces.
+
+Pear coding guiidelines
+
+//*****************************************************************************
+// Commenting style
+//*****************************************************************************
+phpdoc is used for creating and autogenerating the documentation, this means that
+some of the comments can be formatted to be included in documentation.
+ie the source files are scanned then processed and html docs are created.
+
+The comments break down into the following types
+// is uses for removing lines and debug dev etc
+//** and //* are used as "sub comments"
+/*
+ is used to comment out blocks
+*/
+/** is used to create documentaion
+* thats over
+* lines
+*/
+
+If you need to block out a section then use
+/*
+function redundant_code(){
+ something here
+}
+*/
+
+To block out single lines use // and all // are assumed to be redundant test code and NOT comments
+
+// print_r($foo);
+
+For incline comment use //** and //* eg
+
+//** Decide what do do
+switch($decide){
+ //* blow it up
+ case 'baloon':
+ $foo->gas(+1);
+ // test_pressure(); << inline comment
+ break;
+
+ //* Do default action
+ default:
+ do_land();
+ get_gps();
+ //* following grant greaceful exit
+ //basket_exit_crash();
+ basket_exit();
+
+}
+
+Do not use the phpdoc on every function, eg
+
+/**
+* Login an user
+* @param string user username
+* @param string password of user
+*/
+>>
+function login($user, $pass){
+.......
+}
+<<
+as this function explains its self, the followinf clean code will suffice
+>>
+function login($user, $pass){
+.......
+}
+
+If you do need to explain a function then put un the summary syntax eg
+
+/** Pass an array of values where third param is bar
+* $foo['bar'] = 1; // allow an user
+* $foo['bar'] = 2; // destroy user
+* $foo['bar'] = -1; // recreate
+*/
+public function do_something($x, $y, $foo){
+... do something interesting
+}
+
+
+
--
Gitblit v1.9.1