Jump to content
    

Forger утверждает, что хороший тон - это не писать комментариев вообще.

Вот так и рождаются домыслы - я сказал совсем иное: "Самодокументируемый код практически не нуждается в комментах."

Другими словами: комментарий нужен лишь там, где без них будет сложнее понять код или алгоритм.

А вот оформление кода для удобства чтения и понимания - это я приветсвтую, даже в ущерб размеру его текста.

И должен со временем выработаться четкий и однозначный стиль.

Share this post


Link to post
Share on other sites

Вот так и рождаются домыслы - я сказал совсем иное: "Самодокументируемый код практически не нуждается в комментах."

Другими словами: комментарий нужен лишь там, где без них будет сложнее понять код или алгоритм.

Согласен, но сказали это не Вы, а всякие Google Style Guide'ы много лет назад. =)

Share this post


Link to post
Share on other sites

И хорошим тоном является описание и комментарии именно на Английском языке.

Нормальный программист пишет комментарии на том языке, на каком думает. Комментарии на английском - не более, чем понты никчемные.

Share this post


Link to post
Share on other sites

Добавлю кусочек.

В моём понимании IDE должна давать возможность писать комменты на родном языке

можно работать и на англоязычной WINDOWS, что раньше и делали, но так НЕ ВСЕГДА УДОБНО.

По поводу английских комментов, в моём понимании комменты пишут для СЕБЯ и только великие

для потомков.

Для меня пара слов на родном языке в комментах всегда удобней, про начинающих прогеров не

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

И последняя мысль, если Вы не общаетесь постоянно на английском, то из этого следует, что фразу вы

формируете на родном языке,потом в уме переводите и далее пишете в комменты.

 

Share this post


Link to post
Share on other sites

По поводу английских комментов, в моём понимании комменты пишут для СЕБЯ и только великие

для потомков.

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

 

PS: Тема скатывается в оффтоп, но если модераторы позволяют, то... :)

Share this post


Link to post
Share on other sites

Давайте обсуждать "Как", а не "Зачем". Иначе закрою тему.

Модератор.

Share this post


Link to post
Share on other sites

Я решил проблему !!!

 

Делаем так :

1) Устанавливаем в Keil MDK 4.60 кодировку Encode in UTF8 without singature, при которой русские комментарии писать можно, но комментарии написанные в старых версиях кейла не читаются.

2) Открываем старый файл кода в блокноте.

3) Копируем весь текст разом из блокнота в кейл 4.60 .

4) Наслаждаемся тем, что после копирования в кейл старые комментарии стали читатся. Делаю это в windows 7

 

Прекрасный способ восстновить читаемость комментариев в старых программах !

На восстановление одного файла уходит 1 минута.

Share this post


Link to post
Share on other sites

Комментариев -- да, но не текстовых констант. Они-то тоже будут перекодированы, а это обычно недопустимо. Так что способ, увы, не универсальный.

Share this post


Link to post
Share on other sites

Для себя решил проблему так: поставил ARM 4.60 затем C51 9.50a (по факту вернул старый редактор для С51).

Share this post


Link to post
Share on other sites

А чем всех не устраивает способ замены UvEdit.dll?

UvEdit.dll в 4.23 и в 4.60 идентичны. Если менять, то Uv4.exe из вер. 4.23.

Uv4.23.zip

Share this post


Link to post
Share on other sites

UvEdit.dll в 4.23 и в 4.60 идентичны. Если менять, то Uv4.exe из вер. 4.23.

dll различаются, попробуйте сравнить бинарно.

А на 3 странице этой темы я выкладывал длл от 4.60 и подробную инструкция, что ещё надо сделать, чтоб при любом выбранном шрифте и печаталось по русски и отображалось.

Share this post


Link to post
Share on other sites

Зачем их менять, переходите просто на Keil 4.60 и в настройках поставить

 

post-63824-1358960555_thumb.png

 

Получив при этом нормально работаюую программу

Share this post


Link to post
Share on other sites

Зачем их менять, переходите просто на Keil 4.60 и в настройках поставить

 

Получив при этом нормально работаюую программу

 

Уже не раз отмечалось: этот способ не годится, если нужны текстовые константы на русском языке, а не просто русский в комментариях. Потому что, как правило, эти самые константны должны быть закодированы внутри программы отнюдь не в UTF-8.

Share this post


Link to post
Share on other sites

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.

Guest
Reply to this topic...

×   Pasted as rich text.   Paste as plain text instead

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.

×
×
  • Create New...