[Ffmpeg-devel] [PATCH]Update Doxygen comments for libavutil/tree.h

[Diego Biurrun]

On Mon, Feb 26, 2007 at 10:46:04AM +0100, Dujardin Bernard wrote:
> Benoit Fouet a ?crit :
> >Dujardin Bernard wrote:
> >  
> >>Diego Biurrun a ?crit :
> >>    
> >>>On Mon, Feb 26, 2007 at 10:18:41AM +0100, Dujardin Bernard wrote:
> >>> 
> >>>      
> >>>>Or may be
> >>>>That depends of ...
> >>>>    
> >>>>        
> >>>It depends on grammar, "its" is wrong in this case, the suggestion is
> >>>correct.
> >>>  
> >>>      
> >>Applied on patch attached
> >>    
> >seems not :)
> ? patch abstract of referenced post
> 
> + * if a insertion happened, then either key or NULL is returned (that
> + * depends of the tree state and the implementation, you should make no
> + * assumptions that its one or the other in the code)

its --> it is or it's

"its" is a possessive pronoun, just like "my" or "your" "his/her".  As a
rule of thumb if you can replace "its" in a sentence by "his/her" and it
still makes sense (apart from the changed gender), then you must use
"its", if it does not, then you must use "it's/it is".

For example:

OK:
The dog wagged its tail.  -->  The dog wagged his/her tail.

Nonsense:
It is a shame.  -->  His/her a shame.

Does that clear things up?

Diego