Bug 1652 – problem with /// generating strange output

with the following code: class Camera { private: vec3 m_pos; vec3 m_orth; vec3 m_vecf; vec3 m_vecx; vec3 m_vecy; reell m_angle; uint m_resx, m_resy; reell m_constx, m_consty; public: this(ref vec3 origin, ref vec3 direction, ref vec3 normal, int angle, uint resx, uint resy) { m_pos = origin; m_orth = normal; m_vecf = direction; m_angle = G2R(angle); m_resx = resx; m_resy = resy; } uint resx() {return m_resx;} /// resx property void resx(uint rhs) {m_resx=rhs;} /// ditto uint resy() {return m_resy;} /// resy property void resy(uint rhs) {m_resy=rhs;} /// ditto abstract void InitRay(reell x, reell y, inout Ray ray); /// initialize a ray through (x,y) in the camera plane } I get the following documentation: class Camera ; Camera baseclass this(ref vec3 origin, ref vec3 direction, ref vec3 normal, int angle, uint resx, uint resy); initialize a ray through (x,y) in the camera plane uint resx (); resx property initialize a ray through (x,y) in the camera plane initialize a ray through (x,y) in the camera plane void resx (uint rhs); ditto initialize a ray through (x,y) in the camera plane initialize a ray through (x,y) in the camera plane uint resy (); resy property initialize a ray through (x,y) in the camera plane initialize a ray through (x,y) in the camera plane void resy (uint rhs); ditto initialize a ray through (x,y) in the camera plane initialize a ray through (x,y) in the camera plane abstract void InitRay (double x, double y, ref Ray ray); initialize a ray through (x,y) in the camera plane

Created attachment 207 some testcode for you to reproduce the error some testcode for you to reproduce the error

Created attachment 220 Only allow a lineComment to be used once. Reduced test case: /// Class class Example { public: void foo(); /// only on foo void bar(); /// only on bar } The reason is because public is getting the "only on bar" applied to it. Using curlies or removing that line fixes it. I figure it needs to be marked as "taken" by bar (e.g. set to NULL.) I'm not sure this won't break anything else, but I can't find anything it doesn't make better. This still works as one would expect: /// Class class Example { public{ void foo(); /// only on foo void bar(); /// only on bar } /// everything } -[Unknown]

*** This issue has been marked as a duplicate of issue 1117 ***