On Mar 8, 5:14 pm, "K Viltersten" <[EMAIL PROTECTED]> wrote:
> /** Projects an object from 3D to 2D using > the method of Alexander The Great. > \param 3D structure to be projected > \returns 2D projection > */ > public Proj2D get2Dfrom3D(Proj3D param); > > The above is, to me, very clear and > consistent. Not to mention, easily > handled with e.g. Doxygen to create a > readable documentation. > > I don't see how this is dislikeable. Please > explain. When get2Dfrom3D changes its signature but the comment is not changed. That's where I have a problem, and it's only a matter of time before it happens. -- http://mail.python.org/mailman/listinfo/python-list
