Specifications
==============

(I opt AGAINST @foobar, this makes perl code much more complicate!)

1) tlsrc
--------
one file *WITHOUT* empty lines (but beginning and end)
every line looks like
	key value
possible keys are
	name		(must be first)
	shortdesc
	longdesc
	catalogue
	runpatterns
	srcpatterns
	docpatterns
	binpatterns
	execute
	depend

Interpretation:
name
	name of the package

catalogue
	name of the respective Catalogue entry, if missing, same as name

(run|src|doc|bin)patterns
	(cheap/expensive means working time)

	current status:
		TYPE PAT
		TYPE = t f d r
	t word1 ... wordN wordL
		include all files below all dirs of the form
			word1/.../wordN/.../wordL/...
		(cheap)
	f string
		include file "string"
		(should we add glob expansion?)
		(cheap, with glob I don't know)
	d string
		include all files in and below the directory "string"
		(cheap)
	r regexp
		include all files matching /^regexp$/
		(expensive)
	
	Note that if one of the patterns section is empty an entry 
	is automatically generated:
	for runpatterns:
		t texmf-dist topdir $tlp
			(with topdir = bibtex, context, ... see tlsrc2tlp.pl)
	for docpatterns:
		t texmf-dist doc $tlp
	for srcpatterns:
		t texmf-dist source $tlp
	for binpatterns:
		NONE!!	

execute free form
	is taken one to one into the tlp file

depend
	is taken one to one into the tlp file

shortdesc
	short one line desc
	is taken one to one into the tlp file
	if missing can be taken from Catalogue

longdesc
	longer multiline dscription
	is taken one to one into the tlp file
	if missing can be taken from Catalogue

2) tlp file
-----------
same format as tlsrc, but the keys are
	name
	revision
	shortdesc
	longdesc
	catalogue
	runfiles
	docfiles
	srcfiles
	binfiles
	execute
	depend
	??? what am I missing ???

Interpretation
	bin|src|doc|runfiles MUST be saved in multi line entries with
	continuation lines intended by one (1) space. all of them
	can have (must have?) the size tag size=......, in addition
	binfiles can have the arch tag arch=...
		/----------
		|docfiles size=....
		| file1
		| file2
		| ...
	For binfiles the architecture can be given on the binfile line:
		/------------
		|binfiles arch=i386-solaris size=....
		| file1
		| file2
		| file3
		| ...
	Note that only *ONE* *files entry per tlp is allowed

	rest obvious

	revision
		maxmimum of all the last_changed_revisions of all
		contained files

3) tldp file
------------
concatenation of all the tlp files, separated by empty line(s)