summaryrefslogtreecommitdiff
path: root/macros/musixtex/doc/ChangeLog-115.txt
blob: be49e54b0414ed8d63f4646d44d3486105070f77 (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
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
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
Changes from MusiXTeX 114 to 115:

replace the changed tex files to T.115. Includes musixbbm.tex, version from Hiroaki's beta3, dtd 11/19/210 

replace musixper.tex to the fixed one, posted by David Fritzsche on 19 Oct.  (version number may be T.60a, is this ok?) Used file emailed to DAS by J-P Coulon, 1/26/11, 

MusiXTeX T.115 
Hiroaki MORIMOTO <CQX05646(at)nifty.com>

<<<new features>>>
(1) all-new registers allocation routines, ready for 
    12<n<100 instruments
     6<n<100 128th beams
     6<n<100 256th beams
     4<n<100 groups
    12<n<100 font-based slurs (independent of the number of instruments)
     6<n<100 octlines
     6<n<100 trills (MusiXTeX trills only. MusicTeX's legacy "trilles" are 
     out of scope.)
with e-TeX.
Syntax-level 100% compatible with T.111-T.114.
Original (non e-) TeX can be used in case of partial extension.
All The default settings are exactly equal to T.111-T.114, with and without 
musix[add|mad|bm|bbm].tex, individually.  

default (musixtex.tex)
6 voices/128th beams/slurs(font-based)/trills/octave lines
3 chor groups
0 256th beams

(musixadd.tex)
9 voices/slurs(font-based)
4 chor groups
6 128th beams/trills/octave lines
0 256th beams

(musixmad.tex)
12 voices/slurs(font-based)
4 chor groups
6 128th beams/trills/octave lines
0 256th beams

(musixbm.tex)
No function since T.111; just for compatibility with old source files.

(musixbbm.tex)
6 256th beams


(2) \smalltrebleoct, \smalltreclelowoct, \smallbassoct, \smallbasslowoct


<<<changed features>>>
(1) In case of use with M-Tx, users can change the font format of 
instrument names dinamically by redefining \mtxInstrfont in filename.mod.
(for example, writing \def\mtxInstrfont{\relax} in foo.mod.)


<<<bug fixes>>>
(1) If you load musixper.tex and musixdia.tex is not yet loaded then 
the catcode of @ will not be reset correctly, because musixdia will 
overwrite the definition of \catcodeat.  (reported by David Fritzsche)

(2) Other internal macros.


-------------------------------------------------------------------------------
<<<change lists>>>

<<<changes of public macros>>>
\maxinstruments
  Separate from the number of slurs.
  It is defined with \chardef and now a kind of internal values.
  Read-accecible anywhere; but it should not be set directly by a user.
  See below for the number of other items. 

\mxversion
  The expanded string of version string elements.
  See also \mxvernumber and \mxversuffix.

\setname
  Using \def instead of \edef.  This allows users to change the font 
  format of instrument names dynamically by redefining \mtxInstrfont 
  in filename.mod in case of use with M-Tx.

\resetlayout
\resetclefsymbols
  Let them compatible to >12 instruments.


<<<new public macros>>>
\mxvernumber
  Major version number of the MusiXTeX kernel. (make it possible to use 
  \ifnum)

\mxversuffix
  Suffix of the version.  "-beta1", etc.  Optional; it must be empty 
  in case of completed version.

\setmaxinstruments#1
\setmaxcxxviiibeams#1
\setmaxcclvibeams#1
\setmaxgroups#1
\setmaxslurs#1
\setmaxtrills#1
\setmaxoctlines#1
  set the available numbers of the elements to #1 and allocate 
  corresponding registers required.

\maxcxxviiibeams
\maxcclvibeams
\maxgroups
\maxslurs
\maxtrilles
\maxtrills
\maxoctlines
  They are now dynamically defined by \chardef and now a kind of internal 
  values.
  Read-accecible anywhere; but they should not be set directly by a user.


\smalltrebleoct
\smalltreclelowoct
\smallbassoct
\smallbasslowoct
  Reqested by Hermann Hinsch. (beta4)


<<<changes of internal macros>>>
\test@num@slur
\test@num@beam
\s@l@ctslur
\s@l@ctbeam
  Let them be independent from each other.

\z@suspend
  The change in cutslur section; to make the number of slurs independent 
  from the number of instruments.
  Note: some other extension packages which overrides this macro will 
  confuse the internal status of linen-breaking font-based slurs.


<<<new internal macros>>>
\noexpand@newcount
\noexpand@newdimen
\noexpand@newskip
\noexpand@newtoks
  \new... for usage inside the loop, for plain TeX.

\roman@c@
  A shortcut.

\@oldmaxinstruments
\@oldmaxcxxviiibeams
\@oldmaxcclvibeams
\@oldmaxgroups
\@oldmaxslurs
\@oldmaxtrills
\@oldmaxoctlines
  Individual element numbers in previous allocation; set by \chardef.


-------------------------------------------------------------------------------
<<<basic usage>>>
Completely the same of ver T.114-T.103.  It goes on original TeX.
\input musixtex
\input musixmad
...
\input musixlyr
\input musixps    <- this is optional
...

Note that you can use musixps.tex (by Stanislav Kneifl) at your option, 
without any problem.  You can get the benefit of the increase of voices, 
beams, groups, octave lines, trills.


<<<advanced usages (sometimes requires e-TeX, dependent on the numbers)>>>
(a) without using musixadd/musixmad (recommended)
----
\input musixtex
\setmaxinstruments{12}
\setmaxgroups{4}
\setmaxslurs{12}
...
----
This example is equivalent to musixmad.tex.


(b) with musixadd/musixmad
----
\input musixtex
\input musixmad
\setmaxgroups{6}
\setmaxslurs{24}
...
----
From this version T.115, the maximum number of slurs becomes independent 
of the maximum number of instruments.


(c) with musixps.tex by S. Kneifl, efficient usage for TeX's main memory
----
\input musixtex
\setmaxinstruments{12}
\setmaxgroups{4}
\input musixlyr
\input musixps
...
----
Note that there is no need to write \setmaxslurs{12}, because musixps.tex 
0.92a requires pre-allocated registers for font-based slur ID 0-5 
(internally i-vi)  only.


-------------------------------------------------------------------------------
<<<History of T.115-beta from T.114>>>

[beta1: 2010/05/05] private test version, not published.
Drastic change from T.114.  
  _readme_T115-beta1.txt   : this file
  musixtex.tex : T.115 kernel
  musixadd.tex : changed version for T.115
  musixmad.tex : changed version for T.115
  musixbm.tex  : changed version for T.115
  musixbbm.tex : changed version for T.115
  musixper.tex : changed version for T.115


[beta2: 2010/06/24]
musixtex.tex
Additions: 
* error message for n>maxinstruments to \s@l@ctinstr, to avoid 
  the strange error message invoked at \startpiece.
* error message for n>100 to \setmax...{n}.
Fixes:
* \C@acc: adding \expandafter before \@Ti.  
  \@Ti (dynamically let to other instances) can't take any arguments 
  since T.109 due to \check@staff.  
  This is not a bug, however, it is more appropriate to close 
  \check@staff-\fi conditional clause before encountering \@Ti.  
  This fix make it compatible with T.107 and T.108, and MusixExp (need to 
  modify), without any harm.
Others:
  Some old codes are deleted.

_readme_T115-beta2.txt
Others:
* Typo corrections.  


[beta3: 2010/06/27]
musixbbm.tex
Fixes: 
* musixbbm does not work.


[beta4: 2011/01/01]
musixper.tex
Fixes:
* If you load musixper.tex and musixdia.tex is not yet loaded then 
  the catcode of @ will not be reset correctly, because musixdia will 
  overwrite the definition of \catcodeat.  (reported by David Fritzsche)
musixtex.tex
Additions:
  \smalltrebleoct, \smalltreblelowoct, \smallbassoct, \smallbasslowoct
  (requested by Hermann Hinsch)

-------------------------------------------------------------------------------
[End of File]