-
Notifications
You must be signed in to change notification settings - Fork 6
/
buildinfo.txt
161 lines (105 loc) · 4.36 KB
/
buildinfo.txt
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
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
# Default start location is the main dir luaotfload
# needed environment variables for the steps 1.-9.
# CONTEXTPATH: should point to ...\context\tex\texmf-context
# for the l3build test the texmf-tree of the repo should be known
# to the tex system
# The man pages needs docutils
1. Update context
2. Check for changes
cmd --> texlua scripts/mkimport news "" %CONTEXTPATH%
bash--> texlua scripts/mkimport news "" $CONTEXTPATH
3. Import changes
cmd --> texlua scripts/mkimport import "" %CONTEXTPATH%
bash--> texlua scripts/mkimport import "" $CONTEXTPATH
This also imports the merged orginal file and saves it as
fontloader-reference.lua in src/fontloader/runtime
!! Check if luatex-fonts.lua has changed (indicates new files ...)
4. Import character definitions
mkcharacters
this create a new luaotfload-character.lua.
requirements char-def.lua and char-ini.lua
the file is created in src/auto by default!
25.12.2018: in the new code luaotfload-character.lua is no longer used.
Perhaps it will be dropped completly.
cmd --> texlua scripts/mkcharacters %CONTEXTPATH%/tex/context/base/mkiv/
bash--> texlua scripts/mkcharacters $CONTEXTPATH/tex/context/base/mkiv/
5. Update glyphlist
must be called twice if glyphlist.txt doesn't exist yet.
files are created in src/auto
--> texlua scripts/mkglyphlist
6. Merge the files to get the default fontloader.
The name contains the current date.
--> texlua scripts/mkimport package
!!! Save and then delete old default fontloader
6.b change version number in build.lua and call l3build tag
7. Update luaotfload-status
!!! date must be naturally correct
--> texlua scripts/mkstatus --fontloader=./src/auto/fontloader-2020-04-30.lua
8. Check lualibs status -- perhaps it needs update too
9. Install the files in the texmf (for travis and for the tests)
--> l3build install
--> mktexlsr
=== end phase 1 - preparation ===
=== phase 2 - tests ==
10. Adapt aaaaa-luakern.tlg.
10. Install new dev luatex version
11. Run tests in default TL and with dev-version
--> l3build check
=== end phase 2 - tests ===
=== phase 3 - documentation ===
12. Update documentation (see below)
=== end phase 3 ===
=== phase 4 - ctan build ===
13. Update version information:
Update date and tag in build.lua
then run
--> l3build tag 0
(number is irrelevant)
14. commit and tag the commit so that status can pick it up. Grumpf.
15. Update luaotfload-status again so that the hashes are correct.
!!! date must be naturally correct
--> texlua scripts/mkstatus --fontloader=./src/auto/fontloader-2020-04-30.lua
==============
Dokumentation
==============
1. Update NEWS -- no tagging needed
2. Update README.md -- tagging is activated
3. Update CTANREADME -- tagging is activated
4. Check text in luaotfload-main -- version is done by tagging.
5. Check text of the other four files
-luaotfload-latex.tex (no version)
-luaotfload.conf.rst (version by tagging)
-luaotfload-tool.rst (version by tagging)
-filegraph.tex (no version)
6. Create man file: (requires docutils)
Done by l3build doc, so only info
the man pages should also go in the manual so we need also a pdf
--> luaotfload/doc> rst2man.py luaotfload.conf.rst luaotfload.conf.5
--> luaotfload/doc> rst2xetex.py luaotfload.conf.rst luaotfload-conf.tex
--> luaotfload/doc> rst2man.py luaotfload-tool.rst luaotfload-tool.1
--> luaotfload/doc> rst2xetex.py luaotfload-tool.rst luaotfload-tool.tex
7. Compile the doc (done by l3build so only info)
--> luaotfload/doc> lualatex luaotfload-tool.tex
--> luaotfload/doc> lualatex luaotfload-conf.tex
--> luaotfload/doc> lualatex filegraph
--> luaotfload/doc lualatex
==============
Finally
=============
1. add a git tag git tag -a v2.98 -m 'my version 2.98'
2. Call again to get the tag in the status file (grr)
texlua scripts/mkstatus --fontloader=./src/auto/fontloader-2019-07-04.lua
3. Adapt/Check ctan.ann, ctanreadme
4. create ctan package
--> l3build ctan
CHECK if in fontloader-basics-gen.lua line 192 is
caches.namespace= 'generic'
(should be set by l3build tag)
5. upload
-->l3build upload
=======
I would do the merge to dev last because it is the least important step and the only
step where we it is quite likely to get merge conflicts.
So my order would be: Do a fast-forward merge to main, then set the tag.
After the Tag tests ran through send the code to CTAN and delete the main-xx branch.
Finally merge main back into dev.