Add coding note about not writing long functions with a lot of variables and/or scopes. Some other minor changes.

git-svn-id: https://geany.svn.sourceforge.net/svnroot/geany/trunk@2173 ea778897-0a13-0410-b9d1-a72fbfd435f5