[MPlayer-dev-eng] important: doxygen - documenting the source - change of code policy

The Wanderer inverseparadox at comcast.net
Mon Aug 9 06:17:50 CEST 2004


Attila Kinali wrote:

> As with the inclusion of this patch, i also want to make a change in
> code policy, namely that every function/variable/whatever should be
> documented in a way that doxygen can make use of it. I know that it
> will take time until all already written code is documented (if
> ever), but all newly written code should follow this rule.
> 
> Please vote here whether you agree/disagree with this change of
> policy:
> 
> ---8<------
> [X] Yes, i agree with the change, all code should be documented.
> [ ] No, i don't agree, because:
>    
> [ ] I don't have an opinion.
> --->8------

I'm not a developer (yet), although I have some hope of learning enough
about the code over the course of removing printfs to potentially make
some contributions, but although I know next to nothing about doxygen
specifically I support complete code documentation just on principle.
This probably shouldn't be counted as a vote, but for the little it's
worth I did want to make my view known.

-- 
       The Wanderer

Warning: Simply because I argue an issue does not mean I agree with any
side of it.

A government exists to serve its citizens, not to control them.




More information about the MPlayer-dev-eng mailing list