summaryrefslogtreecommitdiff
path: root/Build/TODO
blob: 413659d978736f7afa2e312f0edf47bd04981875 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
TODO
====
started by NP 2006-10-10

Contents
--------
1. Package updates
   a. packages already in tpm-ctan-check
   b. How to add new packages to tpm-ctan-check?  (Karl please fill in!)
   c. Hyphenation patterns
2. Sources updates
3. Infrastructure


-------------------------

1. Package updates
==================
Please see http://www.tug.org/texlive/pkgupdate.html

1a. packages already in tpm-ctan-check
--------------------------------------

texmf-dist/tpm/active-conf.tpm
        the subdirs on CTAN 2006-version and example contain the same files!
        the check compares different files
        ctan2tds calls MAKEflatten which is bad

	I guess I didn't notice the files were the same.  Can you straighten out
	ctan2tds.pl so it does something reasonable?  I guess active-conf has to
	have its own routine :(.  Or ask the author to make the filenames
	unique.

texmf-dist/tpm/beebe.tpm
	MAKEbeebe needs work, this is true!

texmf-dist/tpm/hyperref.tpm
	hyperref-tds.zip seems to be out-of-date, after updating the
        check still spits out changed .html file

texmf-doc/tpm/lshort-turkish.tpm
	turkish is not defined in the @languages array in Tpm.pm, so files in
        the buildPatternsDocumentation (Tpm.pm) function, which checks
        for /doc/$language/.... and /source/$language/....


1b. How to add new packages to tpm-ctan-check?
----------------------------------------------

It's not even necessary to do that unless ctan2tds has to do something
special.  For many packages, the defaults work.

So what I do is nearly the same as updating:


0) Add /pat/to/texlive/svn/repository/Build/tools to your path

1) Choose a package, ie a tpm, best for now one in texmf-dist/tpm/ which
   is NOT already in tpm-ctan-check. You can get a list of the
   not treated packages by calling
        tpm-ctan-check --list-not-treated-tpm


2) check licensing, sources [doc especially], etc.
   if you have the CTAN archive available you can call
        CTAN=/pat/to/CTAN tlpkginfo --ctan-dir <package>
   to get the location of the package.
        (optional, but would be great)
        If you want/can PLEASE update the TeX Catalogue entry or send
        us tex-live@tug.org, debian-tex@lists.debian.org
        the relevant information:
                - version of package checked
                - date checked
                - type of license
                - where the license statement can be found (filename, eg
                  README)

3) run ctan2tl and inspect the output, please see details on the above
   website for a short explanation how to interpret the output

3a) if good, then good:
        - add the package name to ctan-tpm-check (yeah, one more)
        - call ctan2tl --place <package>
        - submit

3b) if bad, then bad:
        Hack ctan2tds as necessary, which can be everything:
        maybe just MAKEflatten, maybe something else.
        Or just inform us here and we will take a look.

4) continue with another package.


If you want to add a NEW package without a tpm, do more or less the same
as above, only in stel 3a) add it also to one of the collections, or ask
us where to add it.



Adaption for ctan2tds:
----------------------
authorindex
	the perl file "authorindex" must be moved to source/latex/authorindex



1c. Hyphenation patterns
------------------------
There are hyphenation files to sort out if you care to work on that
  incredibly frustrating task.


2. sources updates
==================

There are some patches to apply to the sources.
There are the program sources to update in general (e.g., dvipng).


3. Infrastructure
=================
There is running tlrebuild -n and dealing with all the reports of files
  not in the tpm's, etc.  That's probably most in line with what you've
  been doing so far.

  	I (Norbert) am currently checking on this.