[fpc-devel] Definition of the time-fration in a TDateTime before 30/12/1899

Bram Kuijvenhoven kuifwaremailinglists at xs4all.nl
Tue May 23 10:04:12 CEST 2006


Graeme Geldenhuys wrote:
> On 5/22/06, Vincent Snijders <vsnijders at quicknet.nl> wrote:
>> > Can you introduce constants instead of all these hardcoded numbers 
>> so the
>> > code is more readable ?
>> >
>>
>> Maybe Brams mail should be incorporated, given the fact that the
>> constants don't have a clear meaning.
>>
>> Vincent.
> 
> This is exactly why  I asked my original question regarding the date
> routines. After reading is email, I could see why constants where not
> used.  I meant to document somewhere in fpcdoc or even better, in the
> code what all those numbers meant.  Could we add his email as a
> comment above the code?  Or a comment linking it to some help file
> explaining what he said.

You [i.e. FPC] are free to add the text of the email to the documentation.

Whether the text should be included in one big comment or in the fpdoc documentation, with a link in a comment, is probably depending on some policy -- is there a policy for this? Should implementation details be put in the docs?

Regards,

Bram



More information about the fpc-devel mailing list