время
|
|
Глава 6. Проблемы 20
подробно
помнить каждую строчку программы и ее смысл. Но потом вы это забудете, так как
сам код программы вам больше изменять не придется.
Но представьте ситуацию, при которой с развитием новых продуктов либо тех-
нологий доступа и обработки информации у вас возникнет необходимость из-
менить программу. Тут вам можно будет только посочувствовать. Без коммента-
риев будет довольно сложно разобраться в программе, а тем более, если
понадобится изменить программу не вам, а вашему знакомому или товарищу по
работе. На то, чтобы понять, как же работает этот код, придется затратить не-
малое количество часов. Чтобы помочь вам избежать подобной ситуации, в этом
параграфе излагаются некоторые несложные соглашения об именах и коммен-
тариях.
Комментарии во всех языках программирования призваны помочь исчерпывающе
документировать исходный текст программ.
В РНР, впрочем, как и в С, допустимы две разновидности комментариев. Коммен-
тарии традиционного стиля начинаются знаком /* и заканчиваются