[SR-Dev] what to do if function names differ?

Jan Janak jan at iptel.org
Mon Apr 20 14:10:08 CEST 2009


On 20-04 14:16, Juha Heinanen wrote:
> Jan Janak writes:
> 
>  > For new code maybe, but I wouldn't be so picky about existing code. I do not
>  > want to throw away stuff that already exists just because it is not
>  > documented.
> 
> yes, i need to soften my position.  
> 
> undocumented features just makes merge much harder, because it is not
> enough to compare readme files.  also, it more or less means that the
> party who has not documented its features needs to make the merge,
> because that party understands what the undocumented features are
> doing.

Nobody said it would be easy. I too had my share of this while I was trying to
convert kamailio modules. Not everything can be documented in readmes, for
example, there is a lot of changes in kamailio internals that I didn't
understand and I had to ask Daniel, Henning, and others.

If you need to find the author of a particular change then you can use 'git
blame' and talk to them directly. But I am afraid there is no way around
browsing through the code and trying to spot what is different.

But yes, I find it reasonable to ask from people that all new code must be
documented somehow (readme, wiki,...).

  Jan.



More information about the sr-dev mailing list