php: Whats your commenting style?
I was writing up a few scripts and as I was adding my commenting I noticed I tend to comment differently depending on the difficulty of the script and how many different parts or procedures there are to it. I don’t have a set convention, but I suppose as with all things it would make things easier on myself and others if I had some kind of standardization…
For larger ‘areas’ that contain functions or a series of procedures that extract or parse sections of data I’m now starting with this:
/*** * * This is a comment. * Here I leave notes about the section and what it does. * I may also include notes to myself here. * Note: This could probably be done more eficiently * */
As there are more breakdowns within these sections I’m using this:
/* [ Parse out the text file ] */
And further drilled down I use the more inline commenting
/* [ Print data] */
$parts = explode("|", $the_array); // get the parts
$color = false; // set color var for shading every other row
print("<table>");
// loop through data & print
foreach($parts as $key => $row){
// CSS Note: shading <tr>'s with css mostly works with nice browsers
// For IE 6+ one needs to shade the <td>'s
if($color){
print("<tr class=\"rowColor1\"> "); // start row with color 1
$color = !$color; // unset the color so it alternates next loop
} else {
print("</tr><tr class=\"rowColor2\"> "); // start row with color 2
$color = true; // set the color so it alternates next loop
}
print("<td>$row[first_name]</td></tr>"); // print cell data and close the row
}
print("</td></tr></table>");
The inline comments still seem a bit ‘messy’ to me. But for now it will work.
One of the reasons I decided to standardize is because even with commenting and extra line spaces in the scripts it was still difficult to sort out what exactly was going on. Another thing that tripped my thought was having a glance at phpDocumentor. It seems to function on how you comment your code. I did try to install it but for some reason it was way over my head. It looks like a neat tool but I rarely seem to write more than 4 different files and those are often less than 300-400 lines.
I’ve yet to test it in comments but my plugin to allow code viewing is much like bbc code. [code lang="php"] // comment [/code]
So whats your style? Is there a standard? What have you seen that looks the cleanest? Leave a comment… with some comments ;-)
Update 12/3/07 Elizabeth Naramore has written a nice article on the effectiveness of comments in your code over at the Chris Shiflett blog. It’s a great read on WHY commenting is good in your code.
A great post but How to select a cool shoes. we sell cheap shoes We are the best store provided various cheap designer shoes but only a little white to make coach shoes online
We all love and if want to buy ugg boots clearance , please visit the uggs clearance in our site. UGG purses online. We are discount uggs outlet store,and we provide you best quality uggs outlet online store
A bottle of wine, the more the product, good article alcohol is like wine is same, need taste. Wash Slowly you can discover more deeply with the meaning of the layer, thanks for sharing.
Leading any costume using a louis vuitton handbags but you just seem advanced and trendy. Isn’t it time to obtain ones own eluxury ?While louis vuitton bags have so many changes, there’s one thing that doesn’t change .Do you want to know? Well, it’s its theme-brief and high quality.
fashion cheap clothes for women looks beautiful and has the female gentle temperament, and each style cheap clothes online are decorated with lovely lace, very little woman feeling. In addition, wholesale clothing cheap price that let people feel very good.
This is my first time i visit here. I found so many interesting stuff in your blog especially its discussion. From the tons of comments on your articles I guess I am not the only one having all the enjoyment here! keep up the good work
good article!thank you for sharing!
Jiangsu Satellite TV firm
cheap Christian Louboutin support for regulations issued by General Administration , which for the blind Making friends with the healthy growth of the program positive and important role . Jiangsu TV, Bangladesh non- host guests in a dialogue http://www.womenheelsale.com exchange between men and women played a very good role to guide and to control , the program has been welcomed by TV viewers . We will carefully study the provisions of General management , strict requirements , the better off
Christian Louboutin Pumps topic , guest relations ,Christian Louboutin outlet, content clearance, host customs, air off, to further improve program quality. It is reported that Hunan TV will be published subsequently
christian louboutin black suede Guerriere 120 wrapped boots provided for the Administration ’s response . Forward this article to a micro- blog in the latest telecommunications developments, see SAN microblogging User Reviews welcome comment Login: Password : Bo also sent to
Christian Louboutin Slingback the micro- fast up new users
It’s really helpful.THX
Quite good points.Thaks for your share.
I would like to join your blog anyway so please continue sharing with us.
I am happy to find this post very useful for me, as it contains lots of information.gg
Moncler vest
Moncler sale
canada goose outlet,Hvad jeg faktisk se undertiden er næsten en “corkscrew” bevægelse hvorved bestemt larm faktisk flyttes sammen med skulder klappen.Så nogle grunde hvorfor denne fejl? Når alle flytte nogle muskler, eller gruppe af muskler, de altid ønsker at vende tilbage mod en neutral situationen i.elizabeth.gå tilbage i hvor disse mennesker startede.En corkscrew fase opretter derfor konstant den omvendte aktivitet.Dette betyder, at i modsætning til larm staying smides i enhver direkte linje i rumfærgen, det grundlæggende bevægende i hele stien tilhører rumfærgen.Fang typisk rumfærgen på præcis den rigtige tidspunkt, og du får ramt den bedste smash.Endnu, denne metode er forbavsende uforudsigelige samt unøjagtige måde også.Opgave 3 (en videoer forklaring er faktisk tilgængelig) står i rummet ved hjælp af tilstrækkelige regnskabsafslutning omkring dig selv for at svinge larm.]
Two “8-ton” speed of 28,440 kilometers, “screwing” Back in the late 1990s, people started to develop the Shanghai Aerospace docking mechanism, and a lot of ground tests. At
moncler vest sale that time a group of older astronauts, and now also feel like it “holds a sweat.” This is because: two 8-ton object in space to the first cosmic speed (equivalent to 28,440 kilometers per hour) flight, we must also complete the seamless, its difficult to imagine, the consequences of a little scratch is unthinkable. Experts put it this way: “butt, not only related to the separation compartment of the gas can not leak between the compartment and the cabin to ‘perfect’, and bonding is required to maintain a smooth, not sharp rock, which is like in space ‘tighten screws’. ” Temple One target aircraft and spacecraft “God eight” of the butt, to form China’s space history will be the most complex space agencies. It is reported that, to
Moncler Coats achieve successful docking of two vehicles can not exceed the relative speed of 0.2 meters per second, lateral deviation of no more than 18 cm. Only accurate docking, the two can be more “lock” binding, the internal diameter of about 0.8 meters round on the interface will open. And thus wait until the next manned spacecraft “God Nine” or “God
MONCLER ‘Tarn’ quilted gilet with racoon fur trimmed hood purple ten” docking, China’s “astronauts” to cross this “gate”, from “God eight” Towards One Temple. If you thought the use of the Moncler Outlet only in the winter, it is really not fashion! This year’s breakthrough season cortex completely restricted, thin, short leather jacket with a chiffon skirt section has become a symbol of spring and summer look, and in the late summer, large areas of genuine leather Jackets Online is the red carpet and shot in the street highlights. Gorgeous color and superior texture Moncle Jackets Sale each other, must make you the spotlight! This beautiful blonde girl on the red carpet must be the most dazzling scenery. Golden blonde Jackets Online and a perfect fit leather dress, accessories are the national wind Bohemian girl on the city’s favorite. If this is the skirt is red, will look old fashioned lot. The orange-red with orange side blonde to each other, seemed full of
Moncler Kids jackets youthful vigor! Leopard patterns in the animal’s dominance, in the autumn and winter was a Moncler Outlet. Launched a strong attack from the spring and summer that the snake pattern, continue in force this season, with more bright colors, more eye-catching styling, more amazing attitude, easily captured http://www.monclerdownjacketss.com the fashion front. Make a “femme fatale”, no doubt, has become Moncle Jackets Sale this fall and winter women’s top priority!
You made some good points there. I did a search on the topic and found most people will agree with your blog.Keep sharing and
posting articles like these.This article has helped me a lot.Keep posting this stuff…
Canada Goose Parka,Canada Goose outlet sale, buy authentic Canada Goose Jackets & Parka discount without tax at official authorized store¨C
moncler jackets women is the most famous down brand in the world. All the women in the world would like to have these to add idiosyncratic.Motorcycles are harmful. That is component of their appeal. But inside the case of the traffic incident, the motorcycle rider is in a pretty precarious position. None of us actually know when we might be involved inside a horrible incident.canada gooose parkas jackets
is idiosyncratic clothing for broad further besides abyssal fresh chilly Canada Goose Expedition Parka winter now,They started arriving in September and their numbers will peak next month — flying Vs of big, honking Canada geese. There’s still a Canada goose hanging out at Creamer’s Field Migratory Waterfowl Refuge and its goose is going to be cooked
Fendi achieved miraculous repeatedly watch, leather, http://www.ezpayless.com leather will become more in recent years women popular choice, often appear in casual clothing, http://www.onestopclothingshop.com/ accessories achieve miraculous Fendi repeatedly on the details of the logo is a double F bright eye be one of, much change of qualitative capable person, http://www.oneshopclothing.com can ask can hang back can be varied in wrist cubits between design, also meet all different preferences, and dress perfect collocation
Emphasis on shares, the state council has MBT Shoes instruct the relevant departments to MBT Shoes Uk improve MBT Shoes MBT Shoes Clearance Sale school bus standard, completes MBT Shoes the school bus MBT Shoes Clearance design, MBT Shoes Uk production, transformation, equipped with the work, MBT Shoes and establish the MBT Shoes Sale corresponding management system. Well the school bus funds needed for MBT Shoes Uk MBT Karani Shoes the work by the central and local governments share, multiparty raise. To clear the local government and department responsibility, strict liability ZhuiJiuZhi, malignant MBT Shoes Clearance accidents MBT Shoes Sale happened to serious processing according to law.
Just want to say what a great blog you got here!I’ve been around for quite a lot of time, but finally decided to show my appreciation of your work!longchamp le pliage
Canada Goose Banff Parka “Ved følgende eksempel af de fem zoner, der allerede frivilligt har forbudt atomvåben, regeringer og politiske beslutningstagere i Mellemøsten kan hjælpe indse, sikker og sikker fremtid, vores folk er berettiget til,” bemærkede han.canada goose jakker
canada goose jakke
Saudi Prince Turki Al Faisal, som tjente på 2008 International Kommissionen om nukleare ikkespredning og nedrustning, hævdede, at oprettelse af zonen er blevet en nødvendighed for en af de mest militariseret regioner i verden. Canada Goose kvinder MonteBello Parka
[url=http://www.goose2011outlet.com]canada goose jakker[/url]
[url=http://www.goose2011outlet.com/canada-goose-banff-parka-c-1.html]Canada Goose Banff Parka[/url]
[url=http://www.goose2011outlet.com]canada goose jakke[/url]
[url=http://www.goose2011outlet.com/canada-goose-kvinder-montebello-parka-c-6.html]Canada Goose kvinder MonteBello Parka[/url]
[url=http://www.goose2011outlet.com]canada goose Parka[/url]
Oh and Chelsee and Pasha were great too. Loved Pasha’s Shrek outfit – he somehow managed to be even more adorable even when painted green!
You will not peut northeast, moncleronly propaganda function, but My spouse and i humeur, absolutely no, no, monclerI would not have the will, his affecter P dongdong peut along with ‘d instead of peut gagner Chicago conscience will never nobility. Nonetheless, some far more consideration of your child is highly monclerrecommended, such since security. The youngsters Moncler hat export is essential safety coefficient. Proper clothes is essential when employing Moncler, specifically children.
You’ll obtain extensive choices regarding probably the most special as well as sophisticated [url=http://www.monclerdownjacketsmall.com/] moncler jackets sale [/url] available on the market. A large amount of men within community nowadays have begun to savor the truth shade allows you to boost your own trend belief and it’s additionally being mindful of the in that Moncler offers included much more brightly-colored vests inside their distinct products.[url=http://www.monclerdownjacketsmall.com/] moncler down jackets sale [/url] Nonetheless, no matter shades as well as models from the vests.
[url=http://www.monclerjacketswomen-sale.com/] moncler jackets women [/url] have made sure that they can continue cheap uggs being exceptional along with a lot particularly fashion-forward therefore using Moncler every single child fresh height on the planet regarding trend being that they are capable of create special as well as remarkable versions.As the weather becomes colder and colder, more and more people choose Moncler Down Jackets Outlet to protect them from bitterly cold weather.[url=http://www.monclerjacketswomen-sale.com/] moncler jackets women sale [/url] However, most people must have problems in washing the down Jackets.
Moncler can be a well-known as being a ski suit Moncler Jacket, you are able to have a sort of stylish and comfortable winter jackets, moncler outlet, summertime, may perhaps be considered a season Moncler, by using the mark, the development of Moncler commenced to enrich their lines, shirts, bags, shoes also features a very good industry. Irrespective of whether you begin wanting, you’re creating distinctive efforts to ensure that these standards moncler coats for women are right on the facts, suitable for slicing back and shoulder seam of your shoulder needs to be appropriate for your shirt in your own genuine nature, as you explained goal shouldn’t be taken into take into consideration any pull or calculation, only comfortable and all of nature, the woman Moncler, the entire human body shall meet the shirt, so you have to experience essential ?§C he is very good, but probably not feeling nervous, or by these factors, the special superiority, usually immediately after large-scale surveys of crop quantity of male system sort from the entire world. In
Moncler Down Jackets case you believe that Moncler jackets are pricey you then can consider of purchasing them from an online retailer. You can avail them at a discounted value for anyone who is fortunate. Our jackets do not call for much upkeep. It has large endurance and therefore helps make these attires among a form. Our Moncler jackets are extremely in demand on account of its superb finish and its convenience aspect. Moncler Down Jacket Black is actually a
Moncler men vest real worth for funds and worth every single cent that you just devote on them. Moncler jacket coat is a special limited version of the yearyear. Togther vacation time to moderate heat and fashion, Canada Goose leather Zumba Fitness is offering a special liking for the latesttendency guy. In fact, the true religion
Moncler Coats is very much like the gap this season. Moncler Vests is a exampleonline and wholesale distributor logo. Many people accept, rather than the well-known enterprises in the brain, now in the Canadian Expeditionary new clothes. The skiing in the winter time draws close over, more population want to retain functionality in psyche and assure the assembly is getting bewitching, letting you to endure long adequate in the blizzard, and then you can make it back to the sultry drink by the fire. Moncler down windcheater with waterproof woven cloth is principally to retain you dry, tepid and secure, and make your way down the mountain. A windcheater that breaks without difficulty or is not waterproof will be demolished by airstream and blizzard in no time. Ensure that the hood of his windcheater can be included with your helmet is another valued consideration. This is the only brand that will stand the test of time and is therefore always a good idea to buy, even in summer. Buying a jacket of that mark can be simple, you don’t even are on the hunt for special rates for the authentic garment from one store to another or on the line. moncler vest a magnificent
Moncler sale thing. Moncler jacket is well-known emblems in the winter mode! Our Discount Moncler coat with latest tendency method and good value, waterproof cotton fabric inlaid on the exterior and let your body is a moderately hot feeling, you can use it as rainfall, snow. lots of stores on the internet of demand Provide free delivery and discounts. And nowadays with all the additional internet security, purchasing on the internet has turn into safer than ever. And nowadays with all the additional internet security, purchasing on the Internet has turn into safer than ever.
moncler vest sale
As Christmas is just around the corner and many Americans are already thinking about Christmas holiday shopping.For
Monster Beats by Dr. Dre Studio Chicago Bears Black Color women,the warmest womens down parka coats can be your best choice.There are a lot of different styles of womens winter coats to choose from, so here is a quick rundown of the best out there to help you decide what you’ll have wrapped around your shoulders this winter.Canada Goose Women’s Whistler ParkaWhen you want to keep your legs as warm as the rest of you, the chic and sophisticated Whistler Parka is the answer.Below kneelength and insulated with 625 fill power white duck down this parka gets an extra boost of style and a sleek silhouette from an adjustable belt.Women’s Moncler Moka Black Down CoatsWomen’s Moncler Moka Black Down Coats new arrival with the newest style and fresh color designed.It’s stylish design just for this season and never out of fashion.Monlcer Coats can show you various styles here.High quality guaranty,super
Monster beats studio Lamborghiniwith diamond headphones comfort and soft when you wear the Monlcer Coat.It would be the best outwear in winter.Patagonia Women’s Downtown Loft Down ParkaOn winter days when you wish you could wear your sleeping bag or comforter to go to town, slip into the Patagonia Downtown Loft Parka. Decidedly more elegant than a sleeping bag, the Downtown Loft covers you from head to knee in goose down for those days when temps descend well below zero. The satiny shell sheds light snow and blocks the cold, cold wind on those days when the world seems unbearably blustery and icecovered. This parka’s long length, contoured baffling, and shawl collar give you chic style that fits in at the Sundance Film Festival in Park City or a Broadway show in New York City.Women’s Moncler Maillol Black Down CoatsMoncler introduction to the elegant feel of their clothing style has also been improved to some extent fashion how could it not in favor of the people.2011 hot Women’s Moncler Maillol Black Down Coats with
Monster Beats by Dr. Dre Studio New Orleans Saints Black Color fur are so hot for its fashionable and elegant design.It is popular among stars and you may also see many stars wearing it to streets.The classic long style design with waistbandtrimmed dressing highlights your great figure,and long fox collar speaks for your uniquely unequalled taste,keeping you warm and fashionable in winters.The womens Moncler Maillol is in a knee length with a hidden zip and snap front closure.If you warm and stylish Moncler coat can not help you look confidence and personality Moncler down coats fall in love with you!Winter is cold and our moncler women jackets will bring you to a new warm winter.Moncler Maillol Black Down Coats with fur in diamond grid shiny black leather with
Beats by Dr.Dre Special Edition a belt at waist to show your fine body.Moncler Maillol Coats are warm and fashion,make sure to not let you fat with heavy jackets.Moncler will keep your fashion favor and fine figure in the winter.Columbia Women’s Mercury Maven Long Down Jacket Walking Chicago’s Magnificent Mile in February Monster Beats can feel more like trekking Everest. The Columbia Women’s Mercury Maven Long Down Jacket bundles you in insulating down so you’ll be toasty even in the coldest weather. Plus, with its furry collar, long cut, and subtle quilting, you’ll fit right in if you decide to duck into a designer clothing store.Canada Goose Women’s Mystique ParkaCanada Goose Mystique Parka design combines solid warmth and the kind of sleek good looks that make it work onset and on the town.Calflength and insulated with 625 fill power white duck down for warmth, but slimfitting for a fashionable look.The fulllength and formfitting Mystique Parka is a lovely goosedown parka inspired by a block created for actress Rebecca Romijn during the production of XMen II.The North Face Women’s Triple C Down JacketDress up for a fancy French dinner and put on The North Face Women’s Triple C Down Jacket to insulate you when your evening dress doesn’t. Headtoankle 700Fill goose down holds the heat inside when extra bulky layers aren’t quite up to the establishment’s dress code, and with the insulated, snapoff hood you can keep your hair from getting thrashed by the wind or get rid of the
Solo HD High Definition On-Ear Headphones(white) hood for a sleek shopper look. The twoway center zip lets you split the hem for easier walking up the hills as well as provides some venting when you get almost too toasty in the sun.Article From:http:blog.coatwonthewarmestwomensdownparkacoatsforchristmassales451.html
woolrich
woolrich outlet
woolrich prezzi
spaccio woolrich
woolrich artic parka
woolrich sito ufficiale
http://www.woolrich-woolrich.org
Yeah it’s interesting that they let him go but obviously stuck in a buy back clause in case he develops fairly quickly. Though unless they have plans to move busquets to a more forward role, I can’t really see the need for another DM?
I can’t really see the need for another DM?
This is a very unique article, have their own style and characteristics of a high-quality articles for their own performance more features, better design, the latest styles, everyone has their own style and characteristics, a good article with their own characteristics, style and others do not write like a good article to benefit both themselves and others, is a good practice, we should promote it.
A person far more critical factor to observe right here is that the water pump must be treated and replaced pretty often. It is the most critical aspect of your outdoor fountain. Such a fountain is installed in the backyard location. In buy to flaunt it you can throw a social gathering for your good friends and relatives.
This is a really good read for me, Must admit that you are one of the best bloggers I ever saw.Thanks for posting this informative article.
For a lot of people, jewery, flowers, boots no longer attractive, people transfer a gift that surprising others. Overseas send national product may be expensive, for some European, they translate into North Face jackets, the warmest clothes for winter.With heavy snow and chilly wind, it is general for people to think about their warmth.
A Cleaning Cartridge is one such tool, so that the ink comes smoothly out of the Mont Blanc pen refill cartridge and onto the nib, allowing your pen to function at its best.Montblanc pen refills are also available for roller ball pens, ball point pens, as well as pencils, fineliners and Hi-Lighters. Choose a Mont Blanc pen refill for roller ball pens that features fine or medium points in black, blue, red or green colors.
Imagine cruising down the interstate doing a good clip with not a care in the world. As you fly past a really nice looking Vette you suddenly realize that this is no ordinary Corvette; it is in fact a police car. Suddenly you stomach sickens as you realize that the Corvette has pulled in behind you, turned on its dash lights,
Among the exclusively sought after mont blanc pens is the Montblanc Meisterstuck black ballpoint pen 164. This medium-sized rare black resin body pen has a sleek
design, accentuated with gold plating (23.5 karat gold). The price of the mont pens is around $200 to $300, and many of pen enthusiasts worldwide have already found it
more than perfect. Most luxury pen collectors, especially corporate executives, professional writers and young professionals, found the blanc pens useful, long-lasting
and somewhat pride-boosting. Montblanc fountain pens are a perfect gift to your brother or sister, your most trusted friend or, why not, even your boss.