[Ffmpeg-devel] [PATCH] av_log Doxygen docs

[Michael Niedermayer]

Hi

On Mon, Feb 19, 2007 at 07:29:17PM +0100, Panagiotis Issaris wrote:
[...]
> >>+ * av_log_level. By default, all logging messages are sent to 
> >>stderr. This
> >>+ * behavior can be altered by setting a different av_vlog callback 
> >>function.
> >>+ *
> >>+ * @param avcl The AVClass which provides context for the message
> >
> >No, you pass the address of any structure which has an AVClass* as 
> >first field. Currently, an AVCodecContext* or AVFormatContext*.
> Oh, I figured it was a bit OO-inheritance like and had shortened the 
> following into the above:
> "The instance of AVClass which provides the context for the message."
> 
> Do you agree with the unshortened version, or do you think the 
> shortening was not the problem?

avc1 is a pointer to a pointer to a AVClass

or avc1 is a pointer to an arbitrary struct whos first field is a pointer to
a AVClass struct

or in OOshit talk avc1 is a pointer to an instance of a subclass of a class
which contains exactly one field, and this field is a pointer to a AVClass
instance

all the same just getting more obfuscated as you get closer to CS dreamland


[...]
-- 
Michael     GnuPG fingerprint: 9FF2128B147EF6730BADF133611EC787040B0FAB

The greatest way to live with honor in this world is to be what we pretend
to be. -- Socrates
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
URL: <http://lists.mplayerhq.hu/pipermail/ffmpeg-devel/attachments/20070219/e02b1179/attachment.pgp>