[MPlayer-dev-eng] more questions about the documentation

[Diego Biurrun]

Moritz Bunkus writes:
 > > Just orient you on the english manual. It has to be the guidance 
 > > anyway. If you want to add new things first add them in the 
 > > english manual, never in the translated one.
 > 
 > I'm doing that - having two windows next to each other, one showing the
 > English version, one the German translation. I didn't intend to add
 > things, I just found it curious that such a whole section was present
 > in the one version (the German one) but not in the other (the English
 > one).

English is the master.  The HTML has shrunk a lot recently in favor of
the man page and the german version is probably quite out of date..

 > > There have been many discussion about how the documentation
 > > should be structured. I'm too tired to summerize it and I have not 
 > > much free time. The archives may help.
 > 
 > Ok, I'll search them. I remember such a discussion, but I didn't follow
 > it closely as I wasn't bothering with the documentation at that time.

All command line parameters should be in the man page, the HTML is for
howtos, guides and more complex examples.  Developer docs go under
tech/, that's it basically.  Not all of this has been accomplished
yet, though, just have a look at DOCS/tech/TODO.

Diego