On Sun, 15 Apr 2012 21:34:12 +0900 Carsten Haitzler (The Rasterman) <ras...@rasterman.com> wrote:
> On Sun, 15 Apr 2012 22:07:22 +1000 David Seikel <onef...@gmail.com> > said: > > > On Sun, 15 Apr 2012 12:27:12 +0900 Carsten Haitzler (The Rasterman) > > <ras...@rasterman.com> wrote: > > > > > On Sat, 14 Apr 2012 14:46:32 +0900 Jérôme Pinot <ngc...@gmail.com> > > > said: > > > > > > > > > Then, the question of keeping/removing the comments. It's a > > > > question of taste and does not matter much. I personnaly think > > > > that's better to keep the comments, because it's what output > > > > "doxygen -u", when you update the config file. So, it's easier > > > > to maintain in the long term. Drawback is that it makes a big > > > > config file. Vim can fold all the comments with: > > > > > > sure - just funny that you have lots of "spelling" changes to the > > > comments. (adding .'s etc. :)) > > > > Comments are documentation to, for those looking at the source code. > > It's just as important for them to be correct and easy to read. Not > > everyone is an expert at reading rasteronian. Spell checking > > comments, making them easier to read, is all good. That's one of > > the reasons why I use a spell checker in my IDE. > > the day a config file is code... is the day i'm a monkeys uncle. :) > its a config file. did u read the patch? > > VAL=x > VAL2=y > > that's it. the comments are perfectly readable and its a corner of > the build almost no one ever looks at or needs to. I was making my comments in general. On the other hand, if a config file is being used to control something running during a build, them damn straight it's source code. Source code for an interpreted domain specific language. If you think badly commented config files are OK, you've never looked at sendmail config files. :-P /me hands raster a banana. -- A big old stinking pile of genius that no one wants coz there are too many silver coated monkeys in the world.
signature.asc
Description: PGP signature
------------------------------------------------------------------------------ For Developers, A Lot Can Happen In A Second. Boundary is the first to Know...and Tell You. Monitor Your Applications in Ultra-Fine Resolution. Try it FREE! http://p.sf.net/sfu/Boundary-d2dvs2
_______________________________________________ enlightenment-devel mailing list enlightenment-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/enlightenment-devel
