Page 1 of 2

Юмор в комментариях FAR (злобные буратины и чебурашки) и немного об орфографических ошибках

Posted: Tue 04 Nov, 2014 13:23
by sourcelocalizer
Занимаюсь исследованиями/проверкой локализаций различных программ и обратил внимание на юмор в комментариях к FAR... про злобных буратин, чебурашек и пр. :)

Некоторые комментарии в программе FAR:

cddrv.cpp
if (DrvType == DRIVE_UNKNOWN) // фигня могла кака-нить произойти, посему...
DrvType=DRIVE_CDROM; // ...вертаем в зад сидюк.

copy.cpp
if (Link) // рулесы по поводу линков (предварительные!)
m_FocusPos=0; // убится, блин
continue; // ... т.к. мы ЭТО не мувили, а скопировали, то все, на этом закончим бадаться с этим файлов

delete.cpp
// нефига здесь выделываться, а надо учесть, что удаление

dialog.cpp
// забудим (не нужен)
Если жмакнули Alt-???
} //..., це ж ботва какая-то
ItemFlags&=~DIF_MANUALADDHISTORY; // сбросим нафиг.
if (!NeedSendMsg) // тыкс, а уже посылку делали в диалоговую процедуру?
// Здесь с фокусом ОООЧЕНЬ ТУМАННО!!!

fileedit.cpp
//Дабы избежать бардака, развернём слэшики...

filelist.cpp
Посему, если какой-то злобный буратино ...
в текущем каталоге файло с датой создания поболее текущей,
//Если ЭТО убрать, то... будем жать ESC до потере пулься

filetype.cpp
// какой-то злобный чебурашка стер файл!
Добавим интелектуальности.

plugapi.cpp
И фигля здесь удивлятся тому, что функция не работает :-(

Некоторые фрагменты комментариев заменил многоточием или не указал из-за цензурности...

К сожалению в комментариях к программе присутствуют и орфографические ошибки:

codepage.cpp
ресестре
обыкновынных
разделитеь
останнется
оригинальню
стндартные
стндартные

config.cpp
откключаем

copy.cpp
текщий
корректирем
деламем
заключительеая

и пр.

Подробно все изложил в своем блоге: http://sourcelocalizer.blogspot.ru/2014 ... ntary.html

Юмор в комметариях FAR (злобные буратины и чебурашки) и немного об орфографических ошибках

Posted: Tue 04 Nov, 2014 14:51
by 2useven10
В этом разделе был бы уместен патч.
Блоговая ботва - offtopic.

Юмор в комметариях FAR (злобные буратины и чебурашки) и немного об орфографических ошибках

Posted: Tue 04 Nov, 2014 14:57
by John Doe
В заголовке темы орфографическая ошибка )

Юмор в комметариях FAR (злобные буратины и чебурашки) и немного об орфографических ошибках

Posted: Tue 04 Nov, 2014 14:57
by Shmuel
Не надо патчей на комменты. Пусть остаются, как есть.

Юмор в комметариях FAR (злобные буратины и чебурашки) и немного об орфографических ошибках

Posted: Tue 04 Nov, 2014 15:02
by 2useven10
на комменты может и не надо, а на орфографические ошибки не помешает.

Юмор в комметариях FAR (злобные буратины и чебурашки) и немного об орфографических ошибках

Posted: Tue 04 Nov, 2014 15:11
by Max Rusov
Комментарии должны быть в стихах. Я считаю.

Юмор в комметариях FAR (злобные буратины и чебурашки) и немного об орфографических ошибках

Posted: Tue 04 Nov, 2014 15:18
by NightRoman
Половина и так, как стихи. Хойку.

Юмор в комметариях FAR (злобные буратины и чебурашки) и немного об орфографических ошибках

Posted: Tue 04 Nov, 2014 15:43
by sourcelocalizer
>>В этом разделе был бы уместен патч. Блоговая ботва - offtopic.

Его сюда перенесли модераторы.
Жаль нет раздела "юмор".

А вообще, разработчикам (раздел Development) надо знать, что автор программы борется со злобными буратинами и чебурашками :)
Судя по хорошему качеству программы у него это получается :)

>>В заголовке темы орфографическая ошибка )
Знаю, но поправить не могу :(

Юмор в комметариях FAR (злобные буратины и чебурашки) и немного об орфографических ошибках

Posted: Tue 04 Nov, 2014 19:27
by HaRT
NightRoman wrote:Хойку.
Словотворчество засчитано. :)

Юмор в комметариях FAR (злобные буратины и чебурашки) и немного об орфографических ошибках

Posted: Tue 04 Nov, 2014 20:07
by DrKnS
Shmuel wrote:Не надо патчей на комменты. Пусть остаются, как есть.
Почти всегда наличие комментария говорит о проблеме в коде.
Если его можно переписать так, чтобы комментарий стал не нужен - патч приветствуется.

Юмор в комметариях FAR (злобные буратины и чебурашки) и немного об орфографических ошибках

Posted: Tue 04 Nov, 2014 22:20
by sourcelocalizer
DrKnS wrote:
Shmuel wrote:Не надо патчей на комменты. Пусть остаются, как есть.
Почти всегда наличие комментария говорит о проблеме в коде.
Если его можно переписать так, чтобы комментарий стал не нужен - патч приветствуется.
Следует ожидать замену комментария "// какой-то злобный чебурашка стер файл!" на понятный код?

if deletebyzloycheburashka then ... :)

Комментарии полезны, если лаконичны и по делу. Хороший пример xmldoc/javadoc, которые позволяют еще и сформировать документацию.

Данная тема предназначена не только для юмора, но и показать программистам, что их "творчество" может быть опубликовано в дальнейшем как opensource или передано на аудит/прочитано руководством, поэтому лучше ответственней подойти к оформлению комментариев... хотя юмор в комментариях не только повышает читаемость кода но и рабочее настроение :)

Юмор в комметариях FAR (злобные буратины и чебурашки) и немного об орфографических ошибках

Posted: Tue 04 Nov, 2014 23:03
by DrKnS
Следует ожидать замену комментария "// какой-то злобный чебурашка стер файл!" на понятный код?
В описанном вами месте творятся чудеса.
Вызывается функция с невразумительным именем, которая из переданной строки должна вернуть подстроку, если файл найден, пустую строку, если не найден, или нулевой указатель, если файл вообще не искали.

Понять такое не реально, отсюда и комментарии с объяснением на пальцах.

Юмор в комметариях FAR (злобные буратины и чебурашки) и немного об орфографических ошибках

Posted: Wed 05 Nov, 2014 07:22
by Skirda
sourcelocalizer wrote:или передано на аудит/прочитано руководством
Что такое "руководство" в опенсорцах?

Юмор в комметариях FAR (злобные буратины и чебурашки) и немного об орфографических ошибках

Posted: Wed 05 Nov, 2014 09:12
by sourcelocalizer
DrKnS wrote:
Следует ожидать замену комментария "// какой-то злобный чебурашка стер файл!" на понятный код?
В описанном вами месте творятся чудеса.
Вызывается функция с невразумительным именем, которая из переданной строки должна вернуть подстроку, если файл найден, пустую строку, если не найден, или нулевой указатель, если файл вообще не искали.

Понять такое не реально, отсюда и комментарии с объяснением на пальцах.
Согласен, что комментарий должен быть лаконичным и по делу, а также, что лишние комментарии мешают. Но в целом комментарии в программах нужны.
"комментарии с объяснением на пальцах" конечно лучше заменить, но надеюсь при дополнении/корректировке этого и других комментариев творчество автора останется для "будущих поколений" :)

Юмор в комметариях FAR (злобные буратины и чебурашки) и немного об орфографических ошибках

Posted: Wed 05 Nov, 2014 09:21
by sourcelocalizer
Skirda wrote:
sourcelocalizer wrote:или передано на аудит/прочитано руководством
Что такое "руководство" в опенсорцах?
Это обобщение, так как часто opensource это не основная работа и программист помимо разработки opensource занимается и коммерческой разработкой, и должен знать, что его творчество в комментариях не видное пользователям, может быть оценено другими людьми, например, руководством или аудиторами, порой иностранными, которые могут очень удивиться переводу google-translate :)

Да и в opensource может попасть проект, тогда уже все оценят не только его реализацию алгоритмов, но и его юмор :)

Юмор в комметариях FAR (злобные буратины и чебурашки) и немного об орфографических ошибках

Posted: Thu 06 Nov, 2014 17:23
by sourcelocalizer
2useven10 wrote:на комменты может и не надо, а на орфографические ошибки не помешает.
Если у кого-то появится желание поправить все орфографические ошибки, то приложил список ошибок.
Часть из указанных ошибок в отчете можно пропустить, как ошибочные ("менюха" и пр.).

Общий список ошибок в разделе: "Текст в исходных файлах с ошибками орфографии (orpho.text.spellcheck)".
Остальные разделы, в данном случае, можно игнорировать.

Пример для одного из файлов:

File: C:\testsourcelocalizer\far\cpp\filetype.cpp

000062 chk(YO): учетом text: с IF EXIST с учетом @ и возвращает TRUE, если условие IF EXIST
000063 chk: выполено text: выполено, и FALSE в противном случае/
000072 chk: менюху text: // (например, пока рассматривали менюху, в это время)
000073 chk(YO): чебурашка, стер text: // какой-то злобный чебурашка стер файл!
000124 chk: интелектуальности text: Добавим интелектуальности.

менюха - пропустить, или все же поправить для "официозу" :)
чебурашка - это имя, а не вид животных :) поэтому надо с заглавной, но не обязательно.
учетом, стер - в комментариях используется буква Ё, поэтому, по хорошему, надо Ё поправить, но не обязательно.
выполено - ошибка.

Прим.: один словарь (без Ё) "говорит", что "чебурашка" с маленькой буквы это нормально, а другой (с Ё) "так не считает", поэтому слово и попало в список ошибок с Ё. Наверное можно оставить как есть... если уж "менюха" есть, то и вид животных пусть будет :)

Приложил полный html-отчет, а не выложил текст в посте, так как указаны номера строк, подсвечены ошибки по типам и пр.