Path: csiph.com!v102.xanadu-bbs.net!xanadu-bbs.net!feeder.erje.net!eu.feeder.erje.net!newsfeed.fsmpi.rwth-aachen.de!eternal-september.org!feeder.eternal-september.org!mx02.eternal-september.org!.POSTED!not-for-mail From: Marko Rauhamaa Newsgroups: comp.lang.python Subject: Re: Most gratuitous comments Date: Fri, 21 Nov 2014 08:52:47 +0200 Organization: A noiseless patient Spider Lines: 18 Message-ID: <87fvdd6o5c.fsf@elektro.pacujo.net> References: <546d7505$0$12899$c3e8da3$5496439d@news.astraweb.com> <25fa214f-2060-46a8-bebf-d191d69e9a9c@googlegroups.com> <546e7644$0$13014$c3e8da3$5496439d@news.astraweb.com> <6ab51e97-19c5-4008-a755-c55eb71469ba@googlegroups.com> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: mx02.eternal-september.org; posting-host="ff5cf27ef3d5b31f034d3b72bdc27a41"; logging-data="1599"; mail-complaints-to="abuse@eternal-september.org"; posting-account="U2FsdGVkX19OEpZ1v/4jtkRKnIW20dvj" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.3 (gnu/linux) Cancel-Lock: sha1:bOMJhRyi/ZVh370qzxA0/Kci+XY= sha1:uI4qFDU9aGAV3Vj9p/lPkcwxw30= Xref: csiph.com comp.lang.python:81172 sohcahtoa82@gmail.com: > My point was that I was making fun of CS professors that demand a > comment on every line of code, regardless of how clear the line of > code is. Unfortunately, a lot of software houses do a similar thing. Not quite every line, but stuff like: def write_line_to_file(file, line): """Write a line to a file. file is the file to add a line to line is the line to add to the file""" ... Marko