[FFmpeg-cvslog] r12548 - trunk/libavformat/avio.h

[Diego Biurrun]

On Sat, Mar 22, 2008 at 10:00:31AM -0700, Mike Melanson wrote:
> Diego Biurrun wrote:
> > On Fri, Mar 21, 2008 at 11:17:56PM +0100, michael wrote:
> >> Log:
> >> Document get_*_buffer()
> >>
> >> --- trunk/libavformat/avio.h	(original)
> >> +++ trunk/libavformat/avio.h	Fri Mar 21 23:17:56 2008
> >> @@ -260,7 +260,19 @@ char *url_fgets(ByteIOContext *s, char *
> >>  
> >> + * This reads at most 1 packet. If thats not enough fewer bytes will be
> > 
> > Could you please refrain from using these silly contractions in Doxygen
> > comments?
> 
> Are you objecting to the contraction with improper punctuation? Or 
> contractions in general, as docs should have a more formal tone?

I'm objecting to misspelled contractions like "thats, lets, its, etc.".

I would prefer no contractions in general.  This would also have the
positive sideeffect of preempting this class of typos entirely.

Diego