[wx-dev] wxDocs policy for deprecated functions

[Aggro]

Francesco Montorsi wrote:
> Hi all,
> 
>    what's the wx policy against deprecated stuff in regard to wxDocs?
> 
> All times I browse the manual and see listed functions such as 
> wxControlWithItems::Number I wonder if we shouldn't simply immediately 
> remove docs for _all_ deprecated stuff (except maybe the wxString 1.xx 
> compatibility functions!)...

That would be a really bad idea. If you are updating old code which 
uses deprecated function, you really want to find that function from the 
manual, with a comment describing how to replace it in the new code.

Java and PHP which both have quite good documentation, use similar system.

It shouldn't even matter that much having those around, as long as they 
mention what to use instead. That way even those who are writing new 
code and think that they have found the right function, are instantly 
guided to the right track.