[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kde-core-devel
Subject:    Re: api.kde.org News
From:       Aurélien Gâteau <aurelien.gateau () free ! fr>
Date:       2008-07-15 10:51:59
Message-ID: 487C814F.1010404 () free ! fr
[Download RAW message or body]

Michael Pyne wrote:
> On Monday 14 July 2008, Krzysztof Lichota wrote:
>  > 2008/7/13 Allen Winter <winter@kde.org>:
>  > > I added a KDE4 History page at http://api.kde.org/history4.php
>  > > But I really don't see much reason to add these older docs to the 
> search.
>  >
>  > Not everyone is always using latest-and-greatest versions.
>  > Also, they are useful for comparisons, for example during porting.
> 
> That's why methods which are added in a later version have a @since 
> marker attached (or should if they do not).
> 
> That way the API reference for trunk applies just as well all the way 
> back to 4.0.

That's true unless one forgot to add the @since marker. In this case 
having the old doc is quite useful.

Aurélien
[prev in list] [next in list] [prev in thread] [next in thread]