ссылки для программистов
Apr. 20th, 2009 10:00 am![[personal profile]](https://www.dreamwidth.org/img/silk/identity/user.png){kind=small}
avvaЭта запись будет интересна только программистам.
1. (специально для веб-разработчиков) Прекрасная чашка:
2. Отличная подборка на stackoverflow: What is the best comment in source code you have ever encountered?.
Много хорошего (см. также комментарии на реддит). Отмечу такие шедевры, как
1. (специально для веб-разработчиков) Прекрасная чашка:
2. Отличная подборка на stackoverflow: What is the best comment in source code you have ever encountered?.
Много хорошего (см. также комментарии на реддит). Отмечу такие шедевры, как
1. try {
} finally { // should never happen
}
2. return 1; # returns 1
3. // I'm sorry.
4. вот этот
![[identity profile]](https://www.dreamwidth.org/img/silk/identity/openid.png){kind=small}
no subject
Date: 2009-04-20 07:10 am (UTC)no subject
Date: 2009-04-20 07:13 am (UTC)Тогда мы написали программку на Паскале, которая писала комментарии сама.
если видела ADD, добавляла ;ADDING
если видела MOVE, писала ;MOVING
и т.д.
Мы получили 100
no subject
Date: 2009-04-20 07:14 am (UTC)no subject
Date: 2009-04-20 07:29 am (UTC)no subject
Date: 2009-04-20 07:31 am (UTC)no subject
Date: 2009-04-20 07:32 am (UTC)Ухахаха :))
no subject
Date: 2009-04-20 07:34 am (UTC)Гыыыы :)) Парвало
no subject
Date: 2009-04-20 07:42 am (UTC)try
{
...
}
catch ( Exception HoustonWeHaveAProblem )
{
writeLog( HoustonWeHaveAProblem.ToString() );
}
no subject
Date: 2009-04-20 07:43 am (UTC)no subject
Date: 2009-04-20 07:44 am (UTC)no subject
Date: 2009-04-20 07:48 am (UTC)Так что интересно - а как у вас, принятно писать их
no subject
Date: 2009-04-20 07:50 am (UTC)Пишем много javadoc - заголовки методов и классов, чтобы объяснить что метод делает, когда и что возвращает.
Внутри кода у нас почти нет комментов
no subject
Date: 2009-04-20 08:00 am (UTC)no subject
Date: 2009-04-20 08:04 am (UTC)Комменты для сложных алгоритмов и вычислений
Комменты в условиях
if (parent == null) { // happens for empty data sets
В других местах если хорошие имена переменных и методов - редко нужно
no subject
Date: 2009-04-20 08:10 am (UTC)no subject
Date: 2009-04-20 08:13 am (UTC)no subject
Date: 2009-04-20 08:16 am (UTC)http://www.google.com/codesearch?q=%D0%BF%D0%B8%D0%B7%D0%B4%D0%B5%D1%86
no subject
Date: 2009-04-20 08:19 am (UTC)http://www.google.com/codesearch?q=%D1%85%D1%80%D0%B5%D0%BD
no subject
Date: 2009-04-20 08:24 am (UTC)Вы зануда :)
no subject
Date: 2009-04-20 08:41 am (UTC)throw up; //ha ha
Ха ха ха
no subject
Date: 2009-04-20 08:51 am (UTC)Немало вполне знакомых ситуаций :)
no subject
Date: 2009-04-20 09:05 am (UTC)no subject
Date: 2009-04-20 09:08 am (UTC)no subject
Date: 2009-04-20 09:16 am (UTC)no subject
Date: 2009-04-20 10:28 am (UTC)no subject
Date: 2009-04-20 10:34 am (UTC)no subject
Date: 2009-04-20 10:59 am (UTC)Из своего опыта - в одной программе у меня образовался примерно следующий коммент:
// this line was changed on 23.03.2002.
// ... but what for? I don't remember. 30.09.2005
no subject
Date: 2009-04-20 11:00 am (UTC)no subject
Date: 2009-04-20 11:08 am (UTC)Cup<T>
Я серьезно подумываю такую себе заказать. Но твоя тоже хороша для тех, кто много с веб-дизайном трахается.
no subject
Date: 2009-04-20 11:10 am (UTC)RTFM: Doxygen.
no subject
Date: 2009-04-20 01:38 pm (UTC)return &*m_vect.begin(); /* sorry, stepanov */
}
no subject
Date: 2009-04-20 01:48 pm (UTC)no subject
Date: 2009-04-20 05:09 pm (UTC)Однажды я стал виновником почти такого же комментария.
Делали генерацию переходов. Проблема была, что длина команды JMP зависит от длины прыжка, которая в том числе зависит от длин команд JMP. Я сочинил что-то и диктовал (на русском), а друзья-программеры синхронно переводили на Модулу.
Перевод заработал, но после его прочтения они добавили комментарий: "DONT change anything! Flaass knows why it works"
no subject
Date: 2009-04-20 05:16 pm (UTC)k++; // Increment k.
no subject
Date: 2009-04-20 05:45 pm (UTC)no subject
Date: 2009-04-22 05:53 am (UTC)