On 12 July 2013 09:09, Graeme Geldenhuys <gra...@geldenhuys.co.uk> wrote:
> On 2013-07-12 07:07, vfclists . wrote: > > Coding time is the best > > time for documentation because that is when the intent of the code is > clear > > and fresh in the developers mind, and incurs minimal additional cost. > > > And you just said it yourself. If the developer of the code doesn't even > have the time to add code comments in his code, why do you think having > an "Comment" property would make it any better? It will not - the > developer would still not have any time. > > You don't need seperate tools to create documentation - code comments > can serve as documentation. You don't even need special formatting in > code comments, because tools like Lazarus IDE can read plain text > comments and show them as documentation. Please try it yourself to see > what I mean. > > Anyway I am not talking about documentation as such, just a property that an object can be queried about on its role, something no different from the Hint property of components, for the developer rather than the end user. Regards, > - Graeme - > > _______________________________________________ > fpc-pascal maillist - fpc-pascal@lists.freepascal.org > http://lists.freepascal.org/mailman/listinfo/fpc-pascal > -- Frank Church ======================= http://devblog.brahmancreations.com
_______________________________________________ fpc-pascal maillist - fpc-pascal@lists.freepascal.org http://lists.freepascal.org/mailman/listinfo/fpc-pascal