LINUX.ORG.RU
Ответ на: комментарий от next_time

конечно, не против, вы же сами предложили умещать комментарии в одну строчку

я против комментария типа

/*
* эта функция написана емулеком в октябре 2000го года
* в туалете, когда я там срал
* туалетной бумаги не было
* впрочем мне пофиг
* ведь настоящие панки жопу не вытирают
*/
но почему-то такие комментарии любят многие быдлокодеры вставлять. Хочется взять, и уеб…

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

Зачем ты заходишь во все темы и оставляешь комментарии, которые никому кроме тебя не интересны?

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

Зачем ты заходишь во все темы и оставляешь комментарии, которые никому кроме тебя не интересны?

ты думаешь, твоё нытьё кому-то интересно?

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

Твоё то экспертное мнение по любому вопросу точно всех интересует: в интернете кто-то не прав, надо срочно исправить это!

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

Твоё то экспертное мнение по любому вопросу точно всех интересует: в интернете кто-то не прав, надо срочно исправить это!

ок, со мной всё понятно. А ты что здесь делаешь?

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

это лучший из возможных вариантов

от такого:

int main(void)
{
    asdfasdf;

    return 0;
}

почему-то тошнит и выбешивает.

Писать каждый раз камент после шапки функции тоже бесит, ибо это не всегда нужно, а высирать из себя лишнее отродясь не умею:

int main(void) {
    // this is boolshit
    int bool_shit;

    blabla;

    return 0;
}

Ставить пробел после шапки вообще считаю не этичным, как бы пропадает связь между названием функции и телом:

int main(void) {

    int where_is_my_mind;

    return 0;
}

Да и комментировать шапку функции вот так:

/**
 * This is widely accepted comment.
 * Also used in younameit-doc systems like javadoc or phpdoc.
 * params: amount of bars per foo
 * return: exit code
 */
int foo(int bar) {
    adsfasdf;

    if(!bar)
        return 0;

    return 1;
}

считается хорошим тоном и многие системы автоматической документации завязаны на таком стиле.

unt1tled ★★★★
()
Последнее исправление: unt1tled (всего исправлений: 1)
Ответ на: комментарий от unt1tled

почему-то тошнит и выбешивает.

родовая травма? Мне норм.

считается хорошим тоном и многие системы автоматической документации завязаны на таком стиле.

ИМХО системы автоматической документации — зло.

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

родовая травма? Мне норм.

а мне норм искать тело функции грепом вот так, если забыл возвращаемый тип:

grep -ir 'foo() {' ./*

ИМХО системы автоматической документации — зло.

ничего автоматического там нет, оно просто форматируется в html за тебя, чтобы проще искать было

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