Как вам такой код стайл?
![91 float rayleigh phase func(float mu)
92. {
return
94 B. * (1. + mu*mu)
95 / //.........................
96 (16. * PI);
97 }
98
99 // Henyey-Greenstein phase function factor [-1, 1]
100 // represents the average cosine of the scattered directions
101 // 0 is isotropic scattering
102 //](https://img2.joyreactor.cc/pics/post/it-юмор-geek-5524941.jpeg "it-юмор,geek,Прикольные гаджеты. Научный, инженерный и айтишный юмор")
Имеет право на жизнь.
Если вместо портянки комментария с такой формулой просто втулить эту формулу в return - почему бы и нет ?
Я давно уже себе понял, что комментировать можно и нужно. Особенно в серии длинных и дурных вычислений.
Ибо сам через год хрен вспомнишь, что там и зачем. Не говоря уже о чужом коде.
Если вместо портянки комментария с такой формулой просто втулить эту формулу в return - почему бы и нет ?
Я давно уже себе понял, что комментировать можно и нужно. Особенно в серии длинных и дурных вычислений.
Ибо сам через год хрен вспомнишь, что там и зачем. Не говоря уже о чужом коде.
тогда их надо ставить так, что б явно дистанцировать от формулы
return
( b*b - 4*a*c )
/ //---------------------------------------
( 2*a );
return
( b*b - 4*a*c )
/ //---------------------------------------
( 2*a );
в чем проблема?
Смысл в том - что нормально описано что именно вычисляет данная формула в комментарии - поверь, среди большинства программистов это редкость. Подобное я видел ток в исходниках программ к Кортексу от производителя. Если бы все писали такие комментарии , то многих багов можно было бы избежать
Чтобы написать коммент, необходимо залогиниться
ты это сам придумал?