COMMENT YOUR GOD DAMN CODE

Hi.

It has come to my attention that you faggots need to learn to comment your code. I'm looking at you, C fags, with your unreadable declarations.

char (*(*imafaggot)[])();

Tell me what this is and you win a prize.

Programs should be written for people to read, and only incidentally for machines to execute. - SICP 101

>>40
You sound just as incompetent as your co-workers. At the very least, you do type incompetently.
IHBT

I make my code self-documenting, using good descriptive identifier names and well-factored methods/functions. I comment about non-obvious approaches or decisions I've made in writing the code to provide rational for why I did it that way. I also use doxygen to thoroughly document the public interfaces and APIs of my libraries.

But commenting every line or every few lines of code as the OP suggests is for the novice or amateur.

>>42
Dear Sir:
Our firm represents Deckers Outdoor Corporation, 495-A South Fairview Ave., Goleta, CA, United States ("Deckers") in trademark and copyright matters. Deckes is known in the trade as UGG Australia and owns the UGG trademark for footwear, clothing, outerwear, bags, and other goods. UGG is a registered trademark in the United States (U.S. Reg. No. 3,050,925), China (Reg. No. 880518), and more than 70 other countries around the world. In the United States, the UGG mark was first used at least as early as December 28, 1979, and was first used in interstate commerce at least as early as December 28, 1979. Deckers maintains a website at uggaustralia.com where genuine UGG goods are sold using its UGG trademark, including UGG sheepskin boots,
I. Multiple images and/or text that appear on the website at ugg2all.com are unauthorized reproductions of Deckers' copyrighted works. Pursuant to 17 U.S.C. 512, we hereby request that you expeditiously remove the website located at ugg2all.com from your web search results for violations of United States Copyright law.

Pursuant to 17 U.S.C. 512(c)(3)(A)(ii), we hereby identify the following copyrighted works that are being infringed by the site at (note that this list is representative only -multiple others of Deckers' copyrighted works are being infringed by material found at
UGG Australia's Women's Nightfall (Image).

2. Pursuant to 17 U.S.C. 512(c)(3)(A)(iii), we hereby identify the following images and/or text on the website at , and provide the following representative list of materials on the website at that are infringing our clienf's copyrights:
UOG Australia's Women's Nightfall (Image).
Search query: "UGG boots"
Infringing webpage(s): < http://ugg2all.com/>;
It is noted that several additional materials on the website at are infringing our client's copyrights. However, for the sake ofbrevity and in accordance with the provisions of 5I2(c), only a representative list has been provided.

3. Pursuant to 17 U.S.C. 5l2(c)(3)(A)(iv), we hereby provide the following contact information:

[redacted] GREER, BURNS & CRAIN, LTD. Suite 2500 300 S. Wacker Drive Chicago, IL 60606 Ph:[redacted] Email: [redacted]@gbclaw.net

4. The whois information for the website at indicates the e-mail address of the owner/administration is [redacted]@whoisprivacyprotect.com. The website also provides [redacted]@ugg2all.com.


5. I have a good faith belief that use of the copyrighted materials described above on the allegedly infringing webpages is not authorized by the copyright owner, its agent, or the law.

6. I swear, under penalty of perjury consistent with United States Code Title 17, Section 512, that the information in the notification is accurate and that I am the copyright owner or am authorized to act on behalf of the owner of an exclusive right that is allegedly infringed.

In addition, investigation suggests that the website at is being used to sell counterfeit UGG goods from China and/or other foreign countries to consumers in the U.S. These counterfeit sales violate multiple U.S. laws, including Title 15 of the United States Code. 15 U.S.C. 1117(c)
For these reasons, we request the website at ugg2all.com be removed from the Google web search results. If you have any questions regarding this matter, pleas: contact us.
Yours truly,
GREER, BURNS & CRAIN, LTD.
[redacted]

No. The reason is simple. I don't want you to understand my code.

>>43
I tend to put a two- or three-word comment every 5 or so lines explaining what the batch of lines does. It makes the code very easy to skim. Code should be easy to understand without the comments, but the comments help you read through it very quickly to find what you're looking for.

>>46
# hax my anus
# read sicp
# my other car
# is a cdr

I want to document my code, but leaving it undocumented so that only I can understand it improves my job security.

>>44
clienf

char (*(*imafaggot)[])();
I'm going to go against the mood of the thread and ignore whether I'm being trolled or not.  This is the kind of thing I would look at someone and accuse them of "pendatry for the sake of pedantry" unless there was a good reason why this was the only solution available or that made sense.

>>50
That's because you don't actually know any C.

>>51
Despite having been using it for over ten years?

>>52
Yes, you actually know as much C as you know English.

<-- check em dubz

58 Name: Anonymous 2012-01-12 6:24

ya it makes it easier for me to edit it and pass it off as my own since I don't know how to code free hand.