Fabian Lange wrote: > I think the reason for removing them is to avoid duplication. in fact > the end of line comment is never as good as the ref guide. And for > most settings the comment is anyway not that interesting. > But frankly, i do not know the reason why fabien removed them > Fabian
Several reasons: * These comments can become out of date after upgrading to new versions * These comments were more useful when the was no reference guide about them * People kept messing with them by just uncommenting some lines, forgetting to either move the line under the right sub-section, or by having two "all" sections. This was removed to avoid this kind of confusion. Adding a comment at the top of the file with a link to the right section of the reference guide seems like a good idea. Fabien > > 2009/11/22 Łukasz Wojciechowski <[email protected]>: >> I also noticed that they are gone and I also think that It would be >> better If we had them back. >> >> -- >> Best regards >> Łukasz Wojciechowski >> >> New Generation Software >> +48 602 214 629 >> http://www.ngsoft.pl >> >> >> >> 2009/11/22 ever.zet <[email protected]>: >>> Fully agree with Crafty_Shadow. Old comments style in settings.yml was very >>> helpful! >>> >>> 22.11.2009, в 13:39, Crafty_Shadow написал(а): >>> >>>> As of symfony 1.3, the configuration files no longer contain a >>>> reference to the possible configuration options in the form of >>>> commented out lines of the defaults and their explanation. I am well >>>> aware of the symfony reference book, however I strongly believe the >>>> old approach was better. >>>> >>>> For starters, with the old approach I didn't need to open a browser, >>>> find the book, search for that particular config file and finally find >>>> the option I need. This is very time-taking and frustrating compared >>>> to the work-flow with 1.2. What, are we supposed to remember every >>>> configuration option by heart now? >>>> >>>> And what about the people who just start with symfony, or are joining >>>> a project already in progress? How are they supposed to figure this >>>> out? Read the definitive guide, find the reference to the reference >>>> book (pun intended) and all that when all the info they needed >>>> could've been left in the very same configuration file? >>>> >>>> What was the reason for removing this information? It can't be to >>>> speed up the parsing as these files are cached anyways. >>>> >>>> -- >>>> >>>> You received this message because you are subscribed to the Google Groups >>>> "symfony developers" group. >>>> To post to this group, send email to [email protected]. >>>> To unsubscribe from this group, send email to >>>> [email protected]. >>>> For more options, visit this group at >>>> http://groups.google.com/group/symfony-devs?hl=. >>>> >>>> >>> -- >>> >>> You received this message because you are subscribed to the Google Groups >>> "symfony developers" group. >>> To post to this group, send email to [email protected]. >>> To unsubscribe from this group, send email to >>> [email protected]. >>> For more options, visit this group at >>> http://groups.google.com/group/symfony-devs?hl=. >>> >>> >>> >>> >> -- >> >> You received this message because you are subscribed to the Google Groups >> "symfony developers" group. >> To post to this group, send email to [email protected]. >> To unsubscribe from this group, send email to >> [email protected]. >> For more options, visit this group at >> http://groups.google.com/group/symfony-devs?hl=. >> >> >> > > -- > > You received this message because you are subscribed to the Google Groups > "symfony developers" group. > To post to this group, send email to [email protected]. > To unsubscribe from this group, send email to > [email protected]. > For more options, visit this group at > http://groups.google.com/group/symfony-devs?hl=. > > > -- You received this message because you are subscribed to the Google Groups "symfony developers" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/symfony-devs?hl=.
