- RU.PERL ----------------------------------------------------------- RU.PERL -
Msg : #3578 [639]
От : Andrew Alakozow 2:5061/6 18 мая 04, 10:46
Кому : Pavel Reich 18 мая 04, 21:56
Тема : Re: coding standart
-------------------------------------------------------------------------------
PR> Hello, All !
PR> Кто какие стандарты кодирования применяет на практике? Какие
PR> рекомендованы в вашей компании?
PR> perldoc perlstyle читал, интересует реальное положение вещей.
Оформление кода осуществляется в соответствии с perlstyle со следующими
изменениями и добавлениями:
a.. комментарии на русском должны быть в кодировке windows-1251;
b.. в начале каждого пакета должен быть краткий комментарий включающий
описание на одну-две строки и тэг "Id:" для CVS;
c.. отступ выравнивания (indent) - один пробельный символ;
d.. обязательное использование use strict;
e.. наследование через use base;
f.. краткий комментарий перед каждой процедурой (методом);
g.. имена методов составляются <верблюдом>, с выделением слов прописными
буквами, первая буква - строчная (myMethodName);
h.. глаголы get и set опускаются в названиях методов-акцессоров, если
методу передается значение, то оно устанавливается;
i.. код <прореживается> пустыми строками, желательно наличие небольшого
комментария после каждой пустой строки;
j.. длинные строки кода (60-80 символов и более) разбиваются на несколько
строк текста с отступами больше одного пробела;
k.. для доступа к полям объекта используется написание $$object{field}
(<стрелка> (->) используется для вызова методов);
aa29
--- Microsoft Outlook Express 6.00.2720.3000
* Origin: Life In The Dark (2:5061/6)