Лучшие комментарии в исходниках
Лучшие комментарии в исходном коде.
Иногда люди оставляют в коде забавные комментарии.
Здесь выложен перевод некоторых (понравившихся) коментариев из первых трех страниц этой темы:
http://stackoverflow.com/questions/184618?sort=votes&page=4#sort-top
Мой английский далёк от идеала, но уж что есть то есть. Старался переводить близко к оригиналу, иногда литературно. Матные слова так же переведены как они есть.
Поехали:
Оригинал | Перевод |
// sometimes I believe compiler ignores all my comments | // иногда мне кажется, что компилятор игнорирует все мои комментарии |
// Magic. Do not touch. | // Магия. Не трогать. |
return 1; # returns 1 | return 1; # returns 1 |
//When I wrote this, only God and I understood what I was doing //Now, God only knows |
//Когда я писал это, лишь господь и я знали, что делает это код. //Теперь лишь господь знает |
// I'm sorry. | // Простите меня. |
// // Dear maintainer: // // Once you are done trying to 'optimize' this routine, // and have realized what a terrible mistake that was, // please increment the following counter as a warning // to the next guy: // // total_hours_wasted_here = 16 // |
// // Дорогой программист // // Когда ты закончишь свои потуги "оптимизировать" это простой код, // и осознаешь какой ужасной ошибкой было это решение, // пожалуйста увеличь щечек ниже, как предостережение // следующему человеку, который попытается повторить твою ошибку: // // общее_количество_часов_потраченное_здесь_впустую = 16 // |
/* * You may think you know what the following code does. * But you dont. Trust me. * Fiddle with it, and youll spend many a sleepless * night cursing the moment you thought youd be clever * enough to "optimize" the code below. * Now close this file and go play with something else. */ |
/* * Тебе может показаться, что ты знаешь, что делает следующий код. * Но ты не знаешь. Поверь мне. * Попробуй изменить что-нибудь в нём и ты потратишь много бессонных * ночей, проклиная момент, когда ты решил, что разобрался в нём настолько, * что сможешь "оптимизировать" его. * Теперь закрой этот файл и иди играть в другое место. */ |
const int TEN=10; // As if the value of 10 will fluctuate... | const int ДЕСЯТЬ=10; // Будто значение 10 может измениться... |
Exception up = new Exception("Something is really wrong."); throw up; //ha ha |
Exception up = new Exception("Что-то действительно не так."); throw up; //ха ха |
//This code sucks, you know it and I know it. //Move on and call me an idiot later. |
//Этот код отстой, и мы оба это знаем. //Так что двигайся дальше, а идиотом ты назовешь меня потом. |
// If this comment is removed the program will blow up | // Если этот комментарии будет удален, то тогда программа взорвется |
/* You are not meant to understand this */ | /* Никто и не думает, что ты поймешь это */ |
/** * Always returns true. */ public boolean isAvailable() { return false; } Never rely on a comment... |
/** * Всегда возвращает true. */ public boolean isAvailable() { return false; } Никогда не полагайся на комментарии... |
//I am not sure why this works but it fixes the problem. This was before a set of code that technically did fix the problem it was meant to but broke 3 other things.... |
//Не уверен почему этот код работает, но проблема решена. Это было перед кодом, который решил пробему(технически), но ломал программу в трёх других местах.... |
/* TODO: this is obviously not right ... this whole f*cking module sucks anyway */ /* FIXME: please god, when will the hurting stop? Thus function is so f*cking broken it's not even funny. */ |
/* TODO: очевидно это неправильное решение... но этот *баный модуль уже всё равно уже не испортишь */ /* FIXME: пожалуйста, господи, когда эта пытка закончится? Эта бл*тская функция уже настолько испорчена, что это уже них*я не смешно. */ |
# code below replaces code above - any problems? # yeah, it doesn't f*cking work. |
# код что идет ниже заменяет код, который был выше - какие-то проблемы? # да, он ни х*я не работает. |
# To understand recursion, see the bottom of this file At the bottom of the file: # To understand recursion, see the top of this file |
Комментарий в начале файла: # Чтобы понять рекурсию, прочтите комментарий в конце файла. Комментарий в конце того же файла: # Чтобы понять рекурсию, прочтите комментарий в начале файла. |
// I am not sure if we need this, but too scared to delete. | // Не уверен, что это нужно здесь, но очень боюсь удалять. |
//Please work | //Пожалуйста, работай |
Next to a local variable that had to be declared just to pass a constant to a library function: // This only exists because Scott doesn't know how to use const correctly |
Комментарий идет после локальной переменной, которую пришлось объявить лишь, для того чтобы пробежаться по константам в функции библиотеки: // Это здесь лишь потому, что Скотт не знает, как правильно использовать слово const |
Страницы: [1] [2] далее
При полном или частичном копировании необходимо указывать ссылку на данную статью.
Юрий (Дата )
Все вопросы и предложения высылайте на адрес soft_support@list.ru. Необходимо в заголовке указать название статьи.
Оставь свой отзыв
Lena Дата: 03.01.12 |
Дата: 03.01.12 |
Дата: 29.11.11 |
Mimi Дата: 15.03.10 |
Дата: 25.04.09 |
Дата: 24.04.09 |