[FFmpeg-devel] [PATCH]Basic XSUB encoder (take 5)

[Måns Rullgård]

Reimar D?ffinger <Reimar.Doeffinger at gmx.de> writes:

> On Fri, Jun 19, 2009 at 11:37:40AM +0200, Michael Niedermayer wrote:
>> On Fri, Jun 19, 2009 at 10:20:59AM +0200, Reimar D?ffinger wrote:
>> > description is an expansion of the function name, i.e.
>> > put_xsub_rle(...);
>> > is a compilable short-hand for
>> > "Encode a single color run."
>> 
>> i tend to see the doxy as an awnser to the question
>> "what does this function do"
>> -> (it) "Encodes a single color run"
>
> Well, it doesn't matter I was just curious.
> I personally consider a function more like a "recipe" and thus consider
> it strange. I mean, while, they would be both strange, what would you
> consider more reasonable to write above a bread recipe:
> "Makes bread"
> or
> "Make break"
> ?
> Just to give you an idea why I did it differently so far..

I, and seemingly Michael, see the documentation more like a user's
manual for a break-making machine.  As with the manual for a household
appliance, I tend not to read it ;-)

-- 
M?ns Rullg?rd
mans at mansr.com