[fpc-pascal] Re: [Lazarus] Should TObject or TComponent have a Comment property?

vfclists . vfclists at gmail.com
Fri Jul 12 11:48:32 CEST 2013


On 12 July 2013 09:09, Graeme Geldenhuys <graeme at 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 at lists.freepascal.org
> http://lists.freepascal.org/mailman/listinfo/fpc-pascal
>



-- 
Frank Church

=======================
http://devblog.brahmancreations.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.freepascal.org/pipermail/fpc-pascal/attachments/20130712/51a69f70/attachment.html>


More information about the fpc-pascal mailing list