Стандарты написания кода в патчах - Ru-MaNGOS

**virusav** · 21.12.2010, 21:50

На текущий момент в ядре одни и те же места (условия, циклы, функции и т.д.) пишутся по-разному, поэтому нередко возникают "пустые" коммиты с правкой этих недочетов.

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

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

**LordJZ** · 21.12.2010, 22:37

https://github.com/mangos/mangos/wiki/CodingStandards

**virusav** · 21.12.2010, 23:00

Особенно интересуют стандарты написания функций с параметрами, т.к. в ядре есть:
void Func ( uint32 a, uint32 b )
void Func (uint32 a, uint32 b)
void Func(uint32 a, uint32 b)
и различные модификации.

**Vladimir** · 21.12.2010, 23:24

Цитата:

void Func(uint32 a, uint32 b)

Стараемся так НО VAssistX зараза предпочитает void Func( uint32 a, uint32 b )
Так что это тоже встречается если не отследили.

**zergtmn** · 22.12.2010, 07:31

Это можно настроить.

**tempura** · 22.12.2010, 07:35

а по уже имеющемуся коду пакетной заменой пройти.

Йоха · 22.12.2010, 08:56

Цитата:

Сообщение от virusav

Особенно интересуют стандарты написания функций с параметрами, т.к. в ядре есть:
void Func ( uint32 a, uint32 b )
void Func (uint32 a, uint32 b)
void Func(uint32 a, uint32 b)
и различные модификации.

эм, я чего-то наверно не понимаю ...
но какая разница как декорированы функции ? для компилятора это три одинаковых объявления

Зачем делать патч для убирания/добавления лишних пробелов или отступов, это же не изменит ни байта в результирующем коде.

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

И вообще в книге Джеффа Элджера есть шикарное высказывание на эту тему, приведу цитату:

Цитата:

Стиль программирования меня не волнует. Я достаточно краток? Если хотя бы
половина времени, израсходованного на правильную расстановку фигурных скобок, тратилась на
обдумывание программы или еще лучше — на общение с пользователями, то вся отрасль работала бы
намного эффективнее. Конечно, единство стиля — вещь хорошая, но я еще не видел книги или
руководства по стилю, которые бы стоили даже часового собрания группы в начале проекта. К тому же
ни одна книга или руководство по стилю не превратят код неаккуратного программиста в нечто
осмысленное. В сущности, стиль часто используется как оправдание недостатка внимания к самой
программе. Наконец, я еще не видел, чтобы в спорах о стиле один программист в чем-то убедил
другого, поэтому любые дискуссии на эту тему считаю бесполезной тратой времени.

По-моему золотые слова!

Sid · 22.12.2010, 09:16

MaNGOS - это открытый проект, его код читают тысячи людей. Для этого существуют стандарты написания кода, чтобы угодить всем, и сделать код читаемым как книжку.

Йоха · 22.12.2010, 09:20

Цитата:

код читаемым как книжку

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

Цитата:

void Func ( uint32 a, uint32 b )
void Func (uint32 a, uint32 b)
void Func(uint32 a, uint32 b)

Лично я не вижу никаких трудностей в прочтении любой из этих трех строк

Уверен что идея заставить всех программистов использовать единый стиль - это утопия.

Так же уверен что бороться надо только с такими формами записи которые действительно трудно читаемы, например:
для примера посмотрите исходники arrai, вот там действительно черт голову сломает

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

PSZ · 22.12.2010, 10:52

Цитата:

Сообщение от Йоха

эм, я чего-то наверно не понимаю ...
но какая разница как декорированы функции ? для компилятора это три одинаковых объявления

Зачем делать патч для убирания/добавления лишних пробелов или отступов, это же не изменит ни байта в результирующем коде.

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

И вообще в книге Джеффа Элджера есть шикарное высказывание на эту тему, приведу цитату:

По-моему золотые слова!

Борис, ты не прав. (с)
Если стиль кода стандартизирован, то и писать легче, и искать ошибки, и на психику положительно влияет

.

**virusav** · 22.12.2010, 10:56

Стандарты придумали не идиоты и не просто так, поэтому надо писать в едином стиле.

Йоха · 22.12.2010, 14:28

Цитата:

Сообщение от PSZ

Борис, ты не прав. (с)
Если стиль кода стандартизирован, то и писать легче, и искать ошибки, и на психику положительно влияет

.

Есть некая разница между понятиями "стандарт" и "следовать этому стандарту", не находите ?

На практике дела обстоят таким образом что у каждого программиста есть свой стиль или свои предпочтения в оформлении исходного кода.
И переучиться достаточно сложно.
Я вообще не думаю об этом когда пишу код, привычка так сказать.

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

Так что мое личное мнение что 100%-ая гарантия единого стиля оформления кода во всем проекте - это обрабатывать все новые файлы автоматическим форматером.

Йоха · 22.12.2010, 14:30

P.S. теоретически я за стандарт в оформлении кода. Было бы забавно если бы компилятор выдавал ошибку если где-то стоит лишний пробел или фигурная скобка как-то не так стоит -)

**RomanRom2** · 22.12.2010, 14:39

парни, вы все правильно говорите. единый стиль и всё такое. я тоже за единый стиль - это сильно упрощяет жизнь.

я вам даже больше скажу, у меня у самого с течением времени этот стиль немного видоизменяется.

короче говоря хочу сказать, работая в большой софтверной компании (около 1000-1500 человек), работая с иностранными кастомерами, которые аутсорсят код одного проекта не только в россию, могу сказать что единый стиль - это действительно утопия

никого не научишь единому стилю.

нет, ну конечно какие то рамки "приличия" все же должны быть, но единого стиля никогда не будет. это даже и неправильно - заставлять кодера писать в "чужом" стиле, считается в канаде и америке. да и в европе тоже (полтора года работы в шведском эриксоне).

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

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

**Vladimir** · 22.12.2010, 17:40

1. В мангосе очень рудиментированные требования по стилю, и старый код правится по мере возможности - кстати это еще одна возможность его просмотреть на предмет глюков.
2. Использование тулзы по приведению всего и вся, а потом расхлебывание каких-нибудь диких багов в вызове макрос, потому что она чего-то там не так пропарсила - извините нам этого не надо. Стиль это не нечто, что требуется применить любой ценой.
3. Речь идеть только о желательности использования неких договоренностей по стилю при добавлении нового кода. Например разномастное использования формата имен для функций/ классов/ типов/ макросов/ аргументов/ локальных-переменных/ полей (всмысле для каждого из перечисленного конкретно) сильно усложняет чтение кода. Тоже относится к отсупам и и т.д.

**tempura** · 23.12.2010, 09:40

[cinic mode]

Забавно, но я вижу в этом отзвуки своей "войны за грамотность на форумах".

Помнится, были доводы полных отморозков "я говно, и сру как хочу", интеллигентные "мы все творческие личности - срем как хотим", пофигистические "я сам срать не буду, но и мешать другим срать не стану", устало-бессильные "задолбаешься за всеми срач разбирать", и т.п.

В этой теме примерно такие же доводы (по сути, не по форме), заметьте.

При этом (повторяясь тысячный раз) стандарты литературного языка не изменились, удобство чтения грамотного текста никто отрицать не собирается, словарей полно. Все упирается только в нежелание или неумение недалеких людей научиться грамоте.

Я (к сожалению) далек от программирования, так что тут мне по теме и сказать нечего.

А НЕ по теме (в качестве бреда, утопии, мечты о "светлом будущем" с молочными реками в кисельных берегах и двумя рабами у каждого человека) - станет ли хоть кому-то в действительности очень ПЛОХО от того, что в коде будет использоваться единый стандарт? Да, кому-то это будет непривычно, но эти же люди сами пишут "какая разница как там пробелы вокруг скобок стоят" - вот и пусть они их ставят там, где НАДО, а не там, где ПРИВЫКЛИ.

[/cinic mode]

21.12.2010, 21:50	#1
virusav Администратор Регистрация: 19.02.2010 Сообщений: 492 Сказал(а) спасибо: 55 Поблагодарили 341 раз(а) в 154 сообщениях	Стандарты написания кода в патчах На текущий момент в ядре одни и те же места (условия, циклы, функции и т.д.) пишутся по-разному, поэтому нередко возникают "пустые" коммиты с правкой этих недочетов. Есть ли какое-нибудь толковое руководство по стандартам написания кода в ядре мангоса, по которому должны писаться все патчи? Если есть, то было бы замечательно выложить его в разделе написания патчей и продублировать сюда.

22.12.2010, 07:35	#6
tempura Forum bot Регистрация: 01.02.2010 Адрес: пусто Сообщений: 841 Сказал(а) спасибо: 286 Поблагодарили 418 раз(а) в 190 сообщениях Записей в дневнике: 60	а по уже имеющемуся коду пакетной заменой пройти. __________________ Совершенно безопасен для людей, обладающих хотя бы некоторыми минимальными зачатками интеллекта, и способными строить причинно-следственные цепочки.

22.12.2010, 17:40	#15
Vladimir MaNGOS Dev Регистрация: 09.02.2010 Сообщений: 594 Сказал(а) спасибо: 315 Поблагодарили 438 раз(а) в 181 сообщениях	1. В мангосе очень рудиментированные требования по стилю, и старый код правится по мере возможности - кстати это еще одна возможность его просмотреть на предмет глюков. 2. Использование тулзы по приведению всего и вся, а потом расхлебывание каких-нибудь диких багов в вызове макрос, потому что она чего-то там не так пропарсила - извините нам этого не надо. Стиль это не нечто, что требуется применить любой ценой. 3. Речь идеть только о желательности использования неких договоренностей по стилю при добавлении нового кода. Например разномастное использования формата имен для функций/ классов/ типов/ макросов/ аргументов/ локальных-переменных/ полей (всмысле для каждого из перечисленного конкретно) сильно усложняет чтение кода. Тоже относится к отсупам и и т.д. __________________ Так как устал объяснять знайте ICQ не пользуюсь Последний раз редактировалось Vladimir; 22.12.2010 в 17:43.

23.12.2010, 09:40	#16
tempura Forum bot Регистрация: 01.02.2010 Адрес: пусто Сообщений: 841 Сказал(а) спасибо: 286 Поблагодарили 418 раз(а) в 190 сообщениях Записей в дневнике: 60	[cinic mode] Забавно, но я вижу в этом отзвуки своей "войны за грамотность на форумах". Помнится, были доводы полных отморозков "я говно, и сру как хочу", интеллигентные "мы все творческие личности - срем как хотим", пофигистические "я сам срать не буду, но и мешать другим срать не стану", устало-бессильные "задолбаешься за всеми срач разбирать", и т.п. В этой теме примерно такие же доводы (по сути, не по форме), заметьте. При этом (повторяясь тысячный раз) стандарты литературного языка не изменились, удобство чтения грамотного текста никто отрицать не собирается, словарей полно. Все упирается только в нежелание или неумение недалеких людей научиться грамоте. Я (к сожалению) далек от программирования, так что тут мне по теме и сказать нечего. А НЕ по теме (в качестве бреда, утопии, мечты о "светлом будущем" с молочными реками в кисельных берегах и двумя рабами у каждого человека) - станет ли хоть кому-то в действительности очень ПЛОХО от того, что в коде будет использоваться единый стандарт? Да, кому-то это будет непривычно, но эти же люди сами пишут "какая разница как там пробелы вокруг скобок стоят" - вот и пусть они их ставят там, где НАДО, а не там, где ПРИВЫКЛИ. [/cinic mode] __________________ Совершенно безопасен для людей, обладающих хотя бы некоторыми минимальными зачатками интеллекта, и способными строить причинно-следственные цепочки.

Похожие темы
Тема	Автор	Раздел	Ответов	Последнее сообщение
Разбор кода Спелов	partizanes	Прочая документация	7	24.01.2012 15:29
Помощь написания SQL запроса.	NarkoHeal	Новичкам	3	10.10.2010 02:31
Редактирование кода	Klark	Корзина	8	31.05.2010 10:39

21.12.2010, 22:37	#2
LordJZ Супер-модератор Регистрация: 07.03.2010 Сообщений: 647 Сказал(а) спасибо: 100 Поблагодарили 252 раз(а) в 123 сообщениях	https://github.com/mangos/mangos/wiki/CodingStandards

21.12.2010, 23:00	#3
virusav Администратор Регистрация: 19.02.2010 Сообщений: 492 Сказал(а) спасибо: 55 Поблагодарили 341 раз(а) в 154 сообщениях	Особенно интересуют стандарты написания функций с параметрами, т.к. в ядре есть: void Func ( uint32 a, uint32 b ) void Func (uint32 a, uint32 b) void Func(uint32 a, uint32 b) и различные модификации.

22.12.2010, 07:31	#5
zergtmn MaNGOS Dev Регистрация: 07.03.2010 Сообщений: 314 Сказал(а) спасибо: 30 Поблагодарили 153 раз(а) в 83 сообщениях	Это можно настроить.

22.12.2010, 09:16	#8
Sid Ученый Регистрация: 02.04.2010 Сообщений: 237 Сказал(а) спасибо: 41 Поблагодарили 99 раз(а) в 44 сообщениях	MaNGOS - это открытый проект, его код читают тысячи людей. Для этого существуют стандарты написания кода, чтобы угодить всем, и сделать код читаемым как книжку.

22.12.2010, 10:56	#11
virusav Администратор Регистрация: 19.02.2010 Сообщений: 492 Сказал(а) спасибо: 55 Поблагодарили 341 раз(а) в 154 сообщениях	Стандарты придумали не идиоты и не просто так, поэтому надо писать в едином стиле.

22.12.2010, 14:30	#13
Йоха Умный Регистрация: 02.07.2010 Сообщений: 434 Сказал(а) спасибо: 27 Поблагодарили 73 раз(а) в 45 сообщениях	P.S. теоретически я за стандарт в оформлении кода. Было бы забавно если бы компилятор выдавал ошибку если где-то стоит лишний пробел или фигурная скобка как-то не так стоит -)

22.12.2010, 14:39	#14
RomanRom2 WowCore Dev Регистрация: 31.03.2010 Сообщений: 468 Сказал(а) спасибо: 73 Поблагодарили 106 раз(а) в 70 сообщениях	парни, вы все правильно говорите. единый стиль и всё такое. я тоже за единый стиль - это сильно упрощяет жизнь. я вам даже больше скажу, у меня у самого с течением времени этот стиль немного видоизменяется. короче говоря хочу сказать, работая в большой софтверной компании (около 1000-1500 человек), работая с иностранными кастомерами, которые аутсорсят код одного проекта не только в россию, могу сказать что единый стиль - это действительно утопия никого не научишь единому стилю. нет, ну конечно какие то рамки "приличия" все же должны быть, но единого стиля никогда не будет. это даже и неправильно - заставлять кодера писать в "чужом" стиле, считается в канаде и америке. да и в европе тоже (полтора года работы в шведском эриксоне). проблема решается реально просто: в скприпте компиляции встроены команды на запуск тулзов, приводящий код к этому пресловутому единому стилю. и всё. и никто не парится. а в европе вообще даже и этого не делают. всем срать похоже. мэинтанс этого кода конечно сложнее, но по факту ни разу не вызывал каких либо сложностей.