[PATCH] update for TOOLS/c (was: Re: [MPlayer-dev-eng] documentation of TOOLS directory)

[Diego Biurrun]

Arpi writes:
> 
> > Anything else that is obsolete in the TOOLS directory?
> 
> audio-select.c - same story as audio-block*, delete!
> blocking.c - "non-blocked disk reading test" - delete, i cant see any use of it
> buffer.c - the prototyp/testbed of ao_sdl.c buffering code, may be deleted
> cache.c, cache2.c - the prototyp/testbed of cache2.c of libmpdemux, delete
> usleep-test.c - silly usleep() tets by me, delete (never worked as expected)

Deleted.

> avi-fix.c - some new tool by me to fix broken avi files, do NOT delete
> fastmem.sh & fastmemcpybench.c - benchmark/testbed for fastmemcpy stuff, keep it
> sws-test - swscaler test, keep
> subrip.c - vobsub+gocr->.srt converter or such, keep it
> calcbpp.pl,countquant.pl - afaik its useful, see docs/tech/encoding-tips.txt

OK, will stay.

> dump_mp4.c - mpeg4-es stream inspector, may be deleted (useful though)
> asfinfo.c  - probably obsolete, can be deleted (use -identify or such option)
> movinfo.c - like asfinfo.c, a bit more useful (keep it, until all .mov bugs
>    are fixed (never?))
> vivodump.c - like movinfo.c, if we have no problem .viv(o) files, delete,
>    otherwise keep it

Might be useful, I'll keep all the *info.c files.

> GL-test/   - it was to test opengl (vo_gl) performance, but since vo_gl
>   was rewritten several times since that, it does not give usefull results
> mpfc/      - font creator, use subfont-c instead (or use builtin ttf support)
> subfont-gimp/ - same

Remove?

> alaw-gen.c - it must stay here, do not delete.
>              it is not useful anyway, never was, it's here to solve some
>              license issue (it is teh tool to use sox for alaw/ulaw
>              table generation which is used by mplayer, but sox is not gpl)

Hmm, maybe this was a problem in the past, but not today:


silver:/usr/share/doc/sox$ cat copyright
This is the Debian Linux prepackaged version of sox, a comprehensive sound
conversion tool.

This package was put together by Guenter Geiger <geiger at debian.org> with sourcesobtained from:
          http://home.sprynet.com/sprynet/cbagwell/projects.html

The following copyright applied to this software:

  Copyright 1991 Lance Norskog And Sundry Contributors
  This source code is freely redistributable and may be used for
  any purpose.  This copyright notice must be maintained.
  Lance Norskog And Sundry Contributors are not responsible for
  the consequences of using this software.

Version 12.16 and above of sox is available from http://sox.sourceforge.net
and is distributed under the GNU LGPL.

On Debian systems, the complete text of the GNU Lesser General Public License
can be found in the '/usr/share/common-licenses/LGPL' file.

The original copyright owner was Lance Norskog.
Current upstream development is being made by Chris Bagwell and others.


Now that sox is LGPL there should be no more problem and even the old
copyright notice should not make any problems.

Remove then?

> cpuinfo.c  - the prototyp/testbed of ../cpuinfo.c, delete, or NO, WAIT,
>      it maybe still used to simulate /proc/cpuinfo on non-linux systems
>      by ./configure?

Yes, it is still useful and used by at least Cygwin and MinGW.

> divx2svcd - afaik it's vmiklos' masterpiece
> dvd2divxscript.pl - yet another dvdrip4dummies script
> menc2pass  - yet another dvdrip4dummies script
> mencvcd  - yet another *->vcd converter script

Somebody should test these in detail, I doubt they are all worth keeping.

> mem2dump.c - like bios2dump, dunno its purpose/use
> mpconsole - yet another wrapper script
> perlbench.pl - somewhat related to fastmemcpy tests?
> plotpsnr.pl - sounds serious
> png2raw.c - .raw file creator, afair used by .raw font creators (ppl+apps)
> subedit.pl - dunno, its big and has nice comment :)

What about these?  Does anybody use them or find them useful?

> w32codec_dl.pl - does it work?

Somewhat.  It downloads and extracts the following stuff from M$
servers:

silver:/usr/src/mplayer/main/TOOLS$ ls codecs/
codecs.locations.info  MPG4DS32.AX  msscrnax.inf  WMV9VCM.dll  WMVDS32.AX
MP4SDS32.AX            mpg4sax.inf  wmv8ax.inf    WMV9VCM.inf
mpeg4ax.inf            MSSCDS32.AX  wmv8ds32.ax   wmvax.inf

But we already distribute all the interesting stuff in our codec
packages and these are just a few of the DLLs necessary to play
everything.

So IMHO this is of very limited usefulness and should be removed.  Any
objections?

> wma2ogg.pl - huh

WMA to Ogg Vorbis converter

> midentify - lol
> mp.pl - wtf? playtree emulator? :)
> x2mpsub.sh - rotfl

Worth keeping?

Also, what about the

benchmark
benchmark-gab

directories?  Are these worth keeping?

Then there is the TVout directory.  It belongs under TOOLS IMO.  If
nobody objects I'll move it there soon.  We discussed this ages ago,
but it was never done.

Diego