[FFmpeg-cvslog] r21073 - trunk/libavfilter/avfilter.h

[Diego Biurrun]

On Fri, Jan 08, 2010 at 02:45:50AM +0100, Michael Niedermayer wrote:
> On Fri, Jan 08, 2010 at 01:42:22AM +0100, Diego Biurrun wrote:
> > On Fri, Jan 08, 2010 at 12:02:11AM +0100, Stefano Sabatini wrote:
> > > On date Thursday 2010-01-07 23:57:33 +0100, Diego Biurrun wrote:
> > > > On Thu, Jan 07, 2010 at 11:44:33PM +0100, stefano wrote:
> > > > > 
> > > > > Log:
> > > > > Fix doxy, use third person.
> > > > 
> > > > I made up my mind, I hate it.
> > > 
> > > That was discussed long time ago, and we decided to comply with
> > > JavaDoc recommendations.
> > 
> > I faintly remember something, but I never liked it in the first place.
> > 
> > I just compared POSIX docs and looked at a few random man pages.  The
> > former is completely written in nonpersonal form, the latter mostly.
> > 
> > > That said, if you want to convert each doxy
> > > to impersonal form I won't object - my only request is to keep it
> > > consistent - but that would be higly wasted time I think.
> > 
> > We have more doxy in non-third-person form than the other way around.
> > So the wasted time is being spent on making things less consistent
> > right now.  But let's leave this aside for now.
> > 
> > I've just asked around on IRC, a majority of native speakers agrees
> > with me.
> 
> A vote should be done on the ML and not exclude any developers
> my oppinon is that i prefer 3rd person 

We reach the point where the great unwashed[1] use voting to gang up on
experts[2].  It only took a few months to get to this point, congrats!

You'll have to find yourself another documentation maintainer.
I shall not be a part of this nonsense.

Diego

[1] non-native speakers and people with bad English skills
[2] native speakers and people with good English skills