<div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">On 12 July 2013 09:09, Graeme Geldenhuys <span dir="ltr"><<a href="mailto:graeme@geldenhuys.co.uk" target="_blank">graeme@geldenhuys.co.uk</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="im">On 2013-07-12 07:07, vfclists . wrote:<br>
> Coding time is the best<br>
> time for documentation because that is when the intent of the code is clear<br>
> and fresh in the developers mind, and incurs minimal additional cost.<br>
<br>
<br>
</div>And you just said it yourself. If the developer of the code doesn't even<br>
have the time to add code comments in his code, why do you think having<br>
an "Comment" property would make it any better? It will not - the<br>
developer would still not have any time.<br>
<br>
You don't need seperate tools to create documentation - code comments<br>
can serve as documentation. You don't even need special formatting in<br>
code comments, because tools like Lazarus IDE can read plain text<br>
comments and show them as documentation. Please try it yourself to see<br>
what I mean.<br>
<br></blockquote><div><br></div><div>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.<br>
</div><br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
Regards,<br>
  - Graeme -<br>
<div class="HOEnZb"><div class="h5"><br>
_______________________________________________<br>
fpc-pascal maillist  -  <a href="mailto:fpc-pascal@lists.freepascal.org">fpc-pascal@lists.freepascal.org</a><br>
<a href="http://lists.freepascal.org/mailman/listinfo/fpc-pascal" target="_blank">http://lists.freepascal.org/mailman/listinfo/fpc-pascal</a><br>
</div></div></blockquote></div><br><br clear="all"><br>-- <br>Frank Church<br><br>=======================<br><a href="http://devblog.brahmancreations.com">http://devblog.brahmancreations.com</a>
</div></div>