For some time it was more simple to have the explanations in the config, but now there are so many options (i guess, still growing) that it would ease editing and shorten search times if the file is shorter and 'pure options'. Should be a win-win situation: For wouldn't it be more easier for Andrew to have it in one place only, too ?
I think however to have the defaults explicitly set is helpful for beginners just for overview. And third, i use to comment most of my personal settings -- of course all comments should be preserved through an uprgade. Fortunately Andrew already wrote a very good configuration-migrating tool (and i can tell you how badly this would be needed for so many other projects). � /\/
