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

Разработка Far.
User avatar
sourcelocalizer
Posts: 7
Joined: Tue 04 Nov, 2014 13:10
Contact:

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

Postby sourcelocalizer » Tue 04 Nov, 2014 13:23

Занимаюсь исследованиями/проверкой локализаций различных программ и обратил внимание на юмор в комментариях к 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/11/far-commentary.html
Last edited by sourcelocalizer on Thu 06 Nov, 2014 17:29, edited 1 time in total.

2useven10
Posts: 2875
Joined: Mon 07 Sep, 2009 10:40
Has thanked: 2 times
Been thanked: 76 times

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

Postby 2useven10 » Tue 04 Nov, 2014 14:51

В этом разделе был бы уместен патч.
Блоговая ботва - offtopic.

User avatar
John Doe
Бюрократ
Posts: 11040
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 9 times
Been thanked: 62 times

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

Postby John Doe » Tue 04 Nov, 2014 14:57

В заголовке темы орфографическая ошибка )

Shmuel
Posts: 4950
Joined: Thu 23 Mar, 2006 21:36
Location: Israel
Has thanked: 11 times
Been thanked: 123 times

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

Postby Shmuel » Tue 04 Nov, 2014 14:57

Не надо патчей на комменты. Пусть остаются, как есть.

2useven10
Posts: 2875
Joined: Mon 07 Sep, 2009 10:40
Has thanked: 2 times
Been thanked: 76 times

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

Postby 2useven10 » Tue 04 Nov, 2014 15:02

на комменты может и не надо, а на орфографические ошибки не помешает.

User avatar
Max Rusov
Posts: 3599
Joined: Wed 23 Nov, 2005 11:11
Location: Москва-Питер
Been thanked: 6 times
Contact:

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

Postby Max Rusov » Tue 04 Nov, 2014 15:11

Комментарии должны быть в стихах. Я считаю.

User avatar
NightRoman
Posts: 5849
Joined: Fri 18 Aug, 2006 13:52
Location: Cambridge, UK
Has thanked: 8 times
Been thanked: 8 times
Contact:

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

Postby NightRoman » Tue 04 Nov, 2014 15:18

Половина и так, как стихи. Хойку.

User avatar
sourcelocalizer
Posts: 7
Joined: Tue 04 Nov, 2014 13:10
Contact:

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

Postby sourcelocalizer » Tue 04 Nov, 2014 15:43

>>В этом разделе был бы уместен патч. Блоговая ботва - offtopic.

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

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

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

User avatar
HaRT
Moderator
Posts: 7908
Joined: Tue 30 Aug, 2005 17:21
Location: Санкт-Петербург
Has thanked: 63 times
Been thanked: 94 times

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

Postby HaRT » Tue 04 Nov, 2014 19:27

NightRoman wrote:Хойку.
Словотворчество засчитано. :)
Фар есть инструмент, а не нянька. © 2009 DrKnS

User avatar
DrKnS
Posts: 4458
Joined: Thu 04 Aug, 2005 06:44
Location: Kyiv
Has thanked: 2 times
Been thanked: 105 times
Contact:

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

Postby DrKnS » Tue 04 Nov, 2014 20:07

Shmuel wrote:Не надо патчей на комменты. Пусть остаются, как есть.

Почти всегда наличие комментария говорит о проблеме в коде.
Если его можно переписать так, чтобы комментарий стал не нужен - патч приветствуется.

User avatar
sourcelocalizer
Posts: 7
Joined: Tue 04 Nov, 2014 13:10
Contact:

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

Postby sourcelocalizer » Tue 04 Nov, 2014 22:20

DrKnS wrote:
Shmuel wrote:Не надо патчей на комменты. Пусть остаются, как есть.

Почти всегда наличие комментария говорит о проблеме в коде.
Если его можно переписать так, чтобы комментарий стал не нужен - патч приветствуется.


Следует ожидать замену комментария "// какой-то злобный чебурашка стер файл!" на понятный код?

if deletebyzloycheburashka then ... :)

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

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

User avatar
DrKnS
Posts: 4458
Joined: Thu 04 Aug, 2005 06:44
Location: Kyiv
Has thanked: 2 times
Been thanked: 105 times
Contact:

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

Postby DrKnS » Tue 04 Nov, 2014 23:03

Следует ожидать замену комментария "// какой-то злобный чебурашка стер файл!" на понятный код?

В описанном вами месте творятся чудеса.
Вызывается функция с невразумительным именем, которая из переданной строки должна вернуть подстроку, если файл найден, пустую строку, если не найден, или нулевой указатель, если файл вообще не искали.

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

User avatar
Skirda
Posts: 3474
Joined: Wed 16 Mar, 2005 11:01
Been thanked: 1 time

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

Postby Skirda » Wed 05 Nov, 2014 07:22

sourcelocalizer wrote:или передано на аудит/прочитано руководством

Что такое "руководство" в опенсорцах?
We are the Borg. You will be assimilated.
So Say We All!

User avatar
sourcelocalizer
Posts: 7
Joined: Tue 04 Nov, 2014 13:10
Contact:

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

Postby sourcelocalizer » Wed 05 Nov, 2014 09:12

DrKnS wrote:
Следует ожидать замену комментария "// какой-то злобный чебурашка стер файл!" на понятный код?

В описанном вами месте творятся чудеса.
Вызывается функция с невразумительным именем, которая из переданной строки должна вернуть подстроку, если файл найден, пустую строку, если не найден, или нулевой указатель, если файл вообще не искали.

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


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

User avatar
sourcelocalizer
Posts: 7
Joined: Tue 04 Nov, 2014 13:10
Contact:

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

Postby sourcelocalizer » Wed 05 Nov, 2014 09:21

Skirda wrote:
sourcelocalizer wrote:или передано на аудит/прочитано руководством

Что такое "руководство" в опенсорцах?

Это обобщение, так как часто opensource это не основная работа и программист помимо разработки opensource занимается и коммерческой разработкой, и должен знать, что его творчество в комментариях не видное пользователям, может быть оценено другими людьми, например, руководством или аудиторами, порой иностранными, которые могут очень удивиться переводу google-translate :)

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

User avatar
sourcelocalizer
Posts: 7
Joined: Tue 04 Nov, 2014 13:10
Contact:

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

Postby sourcelocalizer » Thu 06 Nov, 2014 17:23

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-отчет, а не выложил текст в посте, так как указаны номера строк, подсвечены ошибки по типам и пр.
Attachments
spellcheck-farmanager.zip
Отчет по ошибкам в комментариях
(142.12 KiB) Downloaded 19 times


Return to “Development”

Who is online

Users browsing this forum: No registered users and 1 guest