Forum.iFiction.Ru

imbeat · 18.11.2008 10:51

добрый всем день!
пара вопросов-комментариев-прозьб по поводу комментариев к классам, методам, константам в библиотеках Rtads:
1) комментарии на английском было бы хорошо перевести на русский
2) комментарии на русском и английском
например:

Код:

#define EC_SUCCESS        0                    /*        удачное завершение */
                                               /*     successful completion */

зачем нужно оставлять английские комментарии? ведь они только громоздят размер библиотеки, ухудшают читабельность кода и навигацию по коду! может быть их поубирать? ведь русской версией библиотек пользоваться то будут только русскочитающие разработчики!!!

uux · 19.11.2008 06:07

По существу согласен, но педантизьма ради хочу внести еще некоторые уточнения:

goraph написал:
Если убирать английские комменты надо менять все названия переменных и функций - например doTake на delaiVziat и т.д. - чтоб комментарии были адекватны.

Название doTake тогда уж надо менять не на delaiVziat, а на poVziat. Префикс do в данном случае - не английский глагол "делай", а сокращение от "direct object" - прямой объект.

goraph написал:
Правда вот ни одна скачанная библиотечка не будет больше работать.

Если поменять названия методов так, как показано в примере у Горафа, боюсь, ни одна из существующих библиотек не заработает еще очень долго: do и io - зарезервированные системой префиксы методов-обработчиков глаголов, и смена этих префиксов потребует либо вмешательства в исходный код ТАДСа, либо совсем уж немыслимых (и, главное, никому не нужных) измывательств над системными библиотеками.

Forum.iFiction.Ru

0 0 #1
18.11.2008 10:51

Комментарии в коде русских версий библиотек (advr.t и т.п.)

Код:

0 0 #2
19.11.2008 06:07

Re: Комментарии в коде русских версий библиотек (advr.t и т.п.)

goraph написал:

goraph написал:

Forum.iFiction.Ru

0 0 #1 18.11.2008 10:51

Комментарии в коде русских версий библиотек (advr.t и т.п.)

Код:

0 0 #2 19.11.2008 06:07

Re: Комментарии в коде русских версий библиотек (advr.t и т.п.)

goraph написал:

goraph написал:

0 0 #1
18.11.2008 10:51

0 0 #2
19.11.2008 06:07