Re: Code comments as documentation?

Subject: Re: Code comments as documentation?
From: Bruce Byfield <bbyfield -at- axionet -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Thu, 30 Sep 2004 09:51:09 -0700


Quoting John Bartol <johnbartol -at- jaggedpeak -dot- ca>:

> Actually, in a compiled system, the comments are ignored in the
> compilation of the executable code. That is, a "hello world" program
> consisting of 5 lines of code
> will result, when compiled, in an executable binary that is *the same
> size* as
> the same program with 2000 lines of comments. So... no effect on size at
> all.


Of course. I wasn't thinking straight. I'll blame the fact that all I do
regularly is shell scripts. Yeah, that will work as an excuse. ;-)

There is still the question of the size of the source files, but that should be
a non-issue, as I said.

--
Bruce Byfield

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

ROBOHELP X5: Featuring Word 2003 support, Content Management, Multi-Author
support, PDF and XML support and much more!
TRY IT TODAY at http://www.macromedia.com/go/techwrl

WEBWORKS FINALDRAFT: New! Document review system for Word and FrameMaker
authors. Automatic browser-based drafts with unlimited reviewers. Full
online discussions -- no Web server needed! http://www.webworks.com/techwr-l

---
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- techwr-l -dot- com
Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.



References:
RE: Code comments as documentation?: From: France Baril
Re: Code comments as documentation?: From: TechComm Dood
Re: Code comments as documentation?: From: Bruce Byfield
Re: Code comments as documentation?: From: John Bartol

Previous by Author: Re: Code comments as documentation?
Next by Author: RE: Updating Resume?
Previous by Thread: Re: Code comments as documentation?
Next by Thread: Budget time is coming


What this post helpful? Share it with friends and colleagues:


Sponsored Ads