I'm going back through all my scripts and putting 5-7 line comments (depending on how many function arguments) above each function. I will then write a perl script or somesuch to parse the scripts and pull out the function blocks and make a nice, formatted development manual.
I estimate that on some of my scripts this can increase the filesize by up to 20kb. That puts a couple of my scripts near the 90kb mark.
I tried using Google, but I can't find any data on what the optimal filesize range is for PHP scripts, what is too big (that causes sluggish performance), and whether or not lots of comments cause a performance decrease due to added size and parsing.
I'm using '//' at the begining of each comment line, rather than enclosing them in / / ... I would assume this is faster, due to the parser being able to go ahead and write off the rest of a line if it begins with '//'
Any ideas?:
(1) what is the optimal filesize range for PHP scripts?
(2) at what filesize does it really start kicking the tar out of performance?
(3) is over-commenting bad? By over-commenting I mean adding 5-7 lines of comments per function and I have ~400 functions (spread across 11 files)
Thank you in advance for any information.