[TYPO3-50-general] Documentation update

[Robert Lemke]

Hi Martin,

Martin Kutschker schrieb:

> Secion 1:
> 
> Allows only a-z, A-Z and 0-9 but the examples show underscores.
> 
> The examples for method names are wrong.

That's a copy-paste error - I was too tired yesterday. Of course 
underscores are allowed for the class name, but only for separating the 
package name from the component name from the sub component name.

I fixed that in the documentation.

> I suggest that a file for a class may only contain the class itself. 
> Allowed are only requires and maybe the XCLASS code. No definition of 
> functions or even executed code.

Generally I agree (didn't I write that somewhere in the documentation?). 
There may be exceptions, like for the class.TYPO3.php for example (which 
contains an __autoload function) and the global exception handler.

As we don't support the traditional XCLASSing anymore, we won't have 
XCLASS code either. What I suggest is registering a replacement class 
via TYPO3::registerOverrideClass() [1]

So, what do you think about the rules for classes / objects in general? 
Do they become clear through the documentation?

Cheers,
robert

[1] http://5-0.dev.typo3.org/guide/bk01pt01ch03s03.html#id2542721