[Mono-devel-list] monodoc --update deprecation

jpease at twcny.rr.com jpease at twcny.rr.com
Wed Dec 8 12:00:59 EST 2004

Using the latest stable 1.0.4, monodoc --update will deprecate existing methods when variable names change in the method header.  In my opinion, this should not occur.  The method signature, in this case, hasn't changed and the method still does the same thing (accepts arguments of a certain type and returns an argument of a certain type).

In order to increase readability, variable names are often changed, without any affect on the functionality of the code.  The documentation, if it references variable names at all, should reflect these changes.  At the same time, it should not be marked as deprecated and removed.

Has this issue been considered, or have changes already been made?

Thanks in advance.

More information about the Mono-devel-list mailing list