On Fri, Oct 9, 2009 at 20:20, Michael Van Canneyt <[email protected]> wrote: > > > On Fri, 9 Oct 2009, Alexander Klenin wrote: > >> On Fri, Oct 9, 2009 at 18:55, Michael Van Canneyt >> <[email protected]> wrote: >>> >>> On Fri, 9 Oct 2009, Alexander Klenin wrote: >>> >>>> 4) Help files generated by FPDoc utility miss description of >>>> enumeration constants. >>> >>> No they don't ? >>> >>> See e.g. http://www.freepascal.org/docs-html/rtl/classes/tfilerflag.html >>> >>> If you mean the full <descr> tag, then: yes, it is unused. >> >> Yes, this is what I meant. >> >>> But this is 'by design'. The idea is that you describe the various >>> enumerated values in depth in the description of the enumerated type >>> itself. >> >> If so, then there are two bugs here: >> 1) FPDoc should issue an error upon encountering <descr> field for >> enumeration constant. > > Well, a warning, at best... It's not an error. > > Also, nothing stops people from enhancing the output engines so they take > the descr tag into consideration.
Ok, I agree. -- Alexander S. Klenin -- _______________________________________________ Lazarus mailing list [email protected] http://lists.lazarus.freepascal.org/mailman/listinfo/lazarus
