[binarycloud-dev] var naming

[alex b. <en...@tu...>]

hi all,

on monday I'll be changing some important variable names, if you look at the
global var space now, it contains:

sImportMap <-- static, global var used by import (thus the (sName))
gImportPaths <-- global var used by import for paths
bc_page <-- page declaration (note the discontinuity between this and
gImportMap)
Init <-- Class
Timer
Debug
Sess
bc_lang
bc_lang_name
bc_lang_datespec
bc_lang_timespec
Lang
_lang
bc_lang_charset
bc_lang_currency_name
bc_lang_currency_symbol
Err
Page
_tmpl <-- "external" user-space variable that is significant to the system.

-------

It will contain, instead:

Static, globals vars of the form sVarName:
sImportMap

Global Vars of the form gVarName:
gImportPaths
gPageDef <-- this is what $bc_page will become.
gLangCode <-- formerly $bc_lang
gLangName <-- formerly $bc_lang_name
gLangDateSpec <-- formerly $bc_lang_datespec
gLangTimeSpec <-- formerly $bc_lang_timespec
gLangCharset <-- formerly $bc_lang_charset
gLangCurrencyName <-- formerly $bc_lang_currency_name
gLangCurrencySymbol <-- formerly $bc_lang_currency_symbol

Class names:
Init
Timer
Debug
Sess
Lang
Err
Page

External, user-space vars:
_lang
_tmpl

At the moment, we haven't integrated Request into the page render process.
Once that is done, the system will assume that register_globals is _OFF_ and
act accordingly. (I will probably have init check the ini setting and send a
warning message to Debug if it is on.)

I will update the standards when I am done, but here are the rest:

Class names:
ClassName, must be contained by ClassName.php, one class per file.

Public Methods & Constructor:
PublicMethod

Private Methods:
_PrivateMethod (this is a change for continuity)

Class Vars:
varname

I have not defined public/private class vars as php doesn't support them -
is anyone in favor of making an artificial distinctoin similar to the
private class names?

like:
Private Class Vars:
_varname

--------

time for sleep :)

_alex