Перейти к содержанию
    

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

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

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

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

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

Поделиться сообщением


Ссылка на сообщение
Поделиться на другие сайты

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

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

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

Поделиться сообщением


Ссылка на сообщение
Поделиться на другие сайты

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

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

Поделиться сообщением


Ссылка на сообщение
Поделиться на другие сайты

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

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

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

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

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

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

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

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

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

 

Поделиться сообщением


Ссылка на сообщение
Поделиться на другие сайты

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

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

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

 

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

Поделиться сообщением


Ссылка на сообщение
Поделиться на другие сайты

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

Модератор.

Поделиться сообщением


Ссылка на сообщение
Поделиться на другие сайты

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

 

Делаем так :

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

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

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

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

 

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

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

Поделиться сообщением


Ссылка на сообщение
Поделиться на другие сайты

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

Поделиться сообщением


Ссылка на сообщение
Поделиться на другие сайты

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

Поделиться сообщением


Ссылка на сообщение
Поделиться на другие сайты

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

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

Uv4.23.zip

Поделиться сообщением


Ссылка на сообщение
Поделиться на другие сайты

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

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

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

Поделиться сообщением


Ссылка на сообщение
Поделиться на другие сайты

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

 

post-63824-1358960555_thumb.png

 

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

Поделиться сообщением


Ссылка на сообщение
Поделиться на другие сайты

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

 

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

 

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

Поделиться сообщением


Ссылка на сообщение
Поделиться на другие сайты

Присоединяйтесь к обсуждению

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

Гость
Ответить в этой теме...

×   Вставлено с форматированием.   Вставить как обычный текст

  Разрешено использовать не более 75 эмодзи.

×   Ваша ссылка была автоматически встроена.   Отображать как обычную ссылку

×   Ваш предыдущий контент был восстановлен.   Очистить редактор

×   Вы не можете вставлять изображения напрямую. Загружайте или вставляйте изображения по ссылке.

×
×
  • Создать...