LINUX.ORG.RU
ФорумTalks

Цензура в комментариях.


0

0

Задумался о сабже, в очередной наткнувшить в комментариях (в коде) на несколько проявлений петросянщины и двачевщины (не говоря уж о падонковщине).

Как вы считаете, должны ли комментарии в коде бить строгими как в плане стиля, так и в плане орфографии? :-)

★☆☆
Ответ на: комментарий от UVV

Правда пару месяцев назад тоже встретил описание параметра "Какая-то х??ня, но нужна Роме" ))

UVV ★★★★★
()

Комментарии должны выглядеть как-то так:

       If you don't see why, please stay the fuck away from my code.
 * Some Athlon laptops have really fucked PST tables.
/*  Some BIOS's are fucked and don't set all MTRRs the same!  */
         * the kernel try to remap our BAR #1 and fuck up bus
        /* fuck me plenty */
        /* Binary compatibility is good American knowhow fuckin' up. */
                               "%d: %s list fucked.\n",
                               "%d: %s list fucked.\n",
         * brain-damage, it's managed to fuck things up one step further..
 *  These chips are basically fucked by design, and getting this driver
                                           BUG? Why does turning the chroma comb on fuck up color?
           registered, to prevent the link/init ordering from fucking
        /* ??? What the fuck is the purpose of the interrupt mask
/* Only Sun can take such nice parts and fuck up the programming interface
                /* This card is _fucking_ hot... */
// FIXME / TODO : understand what those fucking fields mean. If not
                /* urb was fucked up */
 * how bad the target and/or ESP fucks things up.
                /* Be careful, we could really get fucked during synchronous
 * how bad the target and/or ESP fucks things up.
         * phase things.  We don't want to fuck directly with
                /* Be careful, we could really get fucked during synchronous
/* Am I fucking pedantic or what? */
 

redgremlin ★★★★★
()

//XXX, но других путей не вижу. Заодно посылаю разработчикам **** луч тридцатидневной диареи

//детям повторять не рекомендуется

//а я что? я ничего, это ****

//грязный хак, но зато работает

Из текущего проекта, пропади он пропадом.

Zenom ★★★
()

> Как вы считаете, должны ли комментарии в коде бить строгими как в плане стиля, так и в плане орфографии?

Комментарии никому ничего не должны, но, зачастую, бывают должны комментаторы :)

lv ★★
()

> должны ли комментарии в коде бить строгими как в плане стиля, так и в плане орфографии? :-)

Да.

anonymous
()

да.

вопрос навстречу: Должны ли комментарии в коде быть обязательно на английском языке?

mono ★★★★★
()

> Как вы считаете, должны ли комментарии в коде бить строгими как в плане стиля, так и в плане орфографии? :-)

и еще на английском желательно.

phasma ★☆
()

> Как вы считаете, должны ли комментарии в коде бить строгими как в плане стиля, так и в плане орфографии?

Должны ли программы быть строгими в плане стиля, чистоты и отношения к багам? Ну, вообще должны, но практике... "собака бывает кусачей только от жизни собачей" (c)

IMHO, если в проекте кто-то цепляется к стилю комментарием, это п-ц (см. "корпоративный маразм") и лечится только живительной эвтаназией. Цеплятся можно: к плохому коду, к кривому коду, к глючному коду. Код с "вызывающе неверными" комментариями = плохой код. Непонятный и некомментированный код = плохой код.

anonymous
()
Ответ на: комментарий от anonymous

> "вызывающе неверными" комментариями = плохой код. Непонятный и некомментированный код = плохой код.

Хм...паскалист?

r_asian ★☆☆
() автор топика
Ответ на: комментарий от mono

> Должны ли комментарии в коде быть обязательно на английском языке?

Да. Аргументы за: 1) Не будет проблем с кодировкой 2) Твои коменты будут понятны иностранным девелоперам

anonymous
()

Прототип каждой функции должен быть откомментирован.

Как — пох**.

anonymous
()

Нет, цензура ненужна. Из одних комментариев можно всё понять об умственном состоянии писавшего код, и таки решить - читать его код, или проще переписать всё самому.

kranky ★★★★★
()
Ответ на: комментарий от r_asian

> Хм...паскалист?

??! Сишник, если на то пошло.

(непонятный и *одновременно* некомментированый; понятный и некоментированый = коментированый до понятности = хороший)

anonymous
()
Ответ на: комментарий от anonymous

>Сишник, если на то пошло

Тогда непонятно, откуда =

Zenom ★★★
()
Вы не можете добавлять комментарии в эту тему. Тема перемещена в архив.