Обсуждение:Комментарии (программирование)

Последнее сообщение: 10 дней назад от 94.233.241.2 в теме «Глагол»

Фраза "Написание подробных комментариев — одна из составляющих «хорошего стиля» программирования" плохо сочетается со всё более распространяющимся мнением, что программы надо писать так, чтобы комментарии к ним не требовались, что программа должна быть сама себе лучшим комментарием - в частности, надо использовать говорящие названия переменных, функций, классов, методов и пр., разбивать программу на лёгкие для понимания куски, создавать наиболее структуру классов и структуру БД. Есть даже мнение, что если для понимания программы требуются комментарии - значит она плохо написана. Eugenius 04:02, 4 Апр 2005 (UTC)

Значит надо переформулировать :) Xchgall 09:43, 4 Апр 2005 (UTC)

doxygen, javadoc и т.п. править

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

Думаю, лучше будет отсылать сразу на сайты программ Maxim Razin 14:45, 5 Апр 2005 (UTC)
Если кто-нибудь напишет хорошие статьи на русском, то почему бы и нет? Иван Шихалев 04:32, 13 Апр 2005 (UTC)

Си править

По поводу двухслешового комментария в Си (не С++): вроде бы это нестандарт, хотя, как правило, поддерживается современными компиляторами; надо бы уточнить... Ytse 15:20, 19 января 2007 (UTC)Ответить

Глагол править

Можно объяснить, какого х с какой стати почти никому не известный Глагол находится перед Перлом, Питоном и PHP? — doublep 19:05, 14 марта 2007 (UTC)Ответить

Думаю, это произошло потому, что перед этим языки размещали по алфавиту, а Глагол разместили по Паскалем, Обероном и Модулой потому, что он им родственен. Чтобы никому не было обидно, предлагаю разместить языки по алфавиту (благо, это почти так и сделано). При этом за основу предлагаю взять английский алфавит, так как Глагол - единственный здесь язык с названием на русском языке. Глагол же, я думаю, имеет смысл разместить в соответствии с его транслитерированным на английский названием (Glagol). --Eugenius 15:03, 15 марта 2007 (UTC)Ответить
Я разместил Глагол в том месте по двум причинам. Во-первых, перед интерпретируемыми языками, поскольку Глагол - компилируемый, вместе со всеми компилируемыми. Во-вторых, его тип комментария аналогичен паскалевскому "(*" и "*)", только с тем отличием, что может быть вложенным. Сый 16:09, 15 марта 2007 (UTC)Ответить

хороший фильм 94.233.241.2 19:59, 23 апреля 2024 (UTC)Ответить