chiark / gitweb /
Import upstream version 5.3.
[mup] / mup / docs / whatsnew.html
CommitLineData
69695f33
MW
1<HTML>
2<HEAD>
3<TITLE>New Mup Features</TITLE>
4</HEAD>
5<BODY>
6<H1>New Mup Features</H1>
7<H2>New Features in Mup Version 5.3</H2>
8<P>
9Version 5.3 is primarily focused on ease of use enhancements.
10The largest item is the additional of a companion program, called Mupmate,
11that provides an interface for editing, displaying, and playing Mup files
12with the kinds of menus and windows that many people are used to.
13The Help menu will take you right to the
14<A HREF="uguide/index.html">Mup User's Guide,</A>
15which has also had improvements made.
16If you are a user who prefers the command line interface that Mup
17has always had, don't worry; we like to use that too,
18and have no intention of dropping support for it.
19</P>
20<P>
21Windows users now only need to
22<A HREF="obtain.html#windows">download a single file</A>
23and execute it to
24install everything (although you still need to get and install GSview and
25Ghostscript separately, if you want to use that for viewing the PostScript
26files). Other users can also just download a single file that contains
27both program and documentation.
28</P>
29<P>
30Other new features in 5.3 include:
31<UL>
32<LI>
33Error and warning messages have been enhanced to show you the text
34of the line of input where the problem was found.
35<LI>
36There is a new
37<A HREF="uguide/param.html#pgsize">pagesize parameter</A>
38that lets you specify paper size by common names like letter or a4,
39as an alternate to specifying
40<A HREF="uguide/param.html#pgheight">pageheight</A> and
41<A HREF="uguide/param.html#pgheight">pagewidth</A> in
42<A HREF="uguide/param.html#units">inches or cm.</A>
43<LI>
44There is a new
45<A HREF="uguide/param.html#vcombine">vcombine parameter,</A> that lets
46you enter notes on separate voices, yet have them printed on a common stem
47when possible. Typical uses are:
48<UL>
49<LI>
50To have separate
51<A HREF="uguide/midi.html">MIDI</A> tracks for different voices, yet have the
52voices printed on common stems.
53<LI>
54For a style of printing where a single
55stem is used for the two voices on a staff except when the voices share a
56common note, when two opposing stems are printed.
57</UL>
58<LI>
59The
60<A HREF="uguide/param.html#scorepad">scorepad parameter</A> now accepts an
61optional maximum value, in addition to the minimum value.
62</UL>
63</P>
64<H2>New Features in Mup Version 5.2</H2>
65<P>
66<UL>
67<LI>
68There is now a
69<A HREF="uguide/ifclause.html">generalized 'if' clause'</A> that is
70much more flexible and powerful than the simple
71<A HREF="uguide/macros.html">ifdef and ifndef.</A>
72These provide capabilities somewhat similar to the preprocessors for
73the C and C++ languages.
74<LI>
75Complicated
76<A HREF="uguide/param.html#time">time signatures</A> are now supported.
77This includes a numerator with two or more numbers added together,
78like 3+4 / 4, or two or more fractions added together, like 3/4 + 3/8.
79Alternating time signatures, such as when a piece continuously
80switches between 3/4 and 6/8, are also supported.
81<LI>
82The
83<A HREF="uguide/param.html#beamstyl">beamstyle</A>
84and
85<A HREF="uguide/param.html#timeunit">timeunit</A>
86parameter values associated with a
87<A HREF="uguide/param.html#time">time signature</A>
88are now remembered, so that if you later change back to the same time signature,
89you don't have to also set the beamstyle and timeunit at the same time;
90the value used previously for that time signature will be
91restored automatically.
92(Note that if you have existing Mup files that rely on the old behavior,
93they may need small modifications, but that should be rare.)
94<LI>
95It is now possible to
96<A HREF="uguide/chrdattr.html#stemdir">force stem direction</A>on voices 1 and 2
97even when the other voice is not space.
98<LI>
99Improvements have been made to how the
100angle for beams is calculated.
101The &quot;best&quot; angle for a beam is sometimes somewhat subjective,
102but in general, these changes will result in more
103cases where beams are horizontal or less sloped,
104<LI>
105There are also additional ways you can control beams:
106A new
107<A HREF="uguide/ichdattr.html#slope">slope interchord attribute</A>
108lets you force a specific slope.
109The new
110<A HREF="uguide/param.html#sshorten">stemshorten parameter</A>
111lets you determine how much a chord's stem
112is allowed to be shortened when it is beamed.
113And the existing
114<A HREF="uguide/chrdattr.html#stemlen">len chord attribute</A>
115can now be set for
116just one end of a beamed set of chords as an alternative to
117setting it at both ends.
118<LI>
119<A HREF="uguide/index.html">The HTML version of the Mup User's Guide</A>
120now includes 'next page' and 'previous page' links on each page.
121</UL>
122</P>
123<H2>New Features in Mup Version 5.1</H2>
124<P>
125<UL>
126<LI>
127You may specify <A HREF="uguide/chordinp.html#duration">a time value that is the
128summation of several time values.</A> This can be used to obtain
129<A HREF="uguide/param.html#beamstyl">beaming</A>,
130<A HREF="uguide/lyrics.html">lyrics</A>, or
131<A HREF="uguide/tuplets.html">tuplets</A> with durations that
132cannot be represented with a single time value, like a half note plus
133an eighth note. It also gives an alternate way to specify
134<A HREF="uguide/ichdattr.html#tie">chord ties.</A>
135<LI>
136<A HREF="uguide/crossst.html">Cross-staff stems</A> are now supported.
137<LI>
138You can now explicitly specify a direction of &quot;up&quot; on
139<A HREF="uguide/roll.html">rolls</A> to get an upward arrow drawn at the
140top of the roll. (Before, only a downward roll would get an arrow.)
141<LI>
142Mup will now allow you to
143<A HREF="uguide/param.html#beamstyl">beam across spaces</A> as well
144as rests.
145<LI>
146There is a new
147<A HREF="uguide/param.html#restsymm">restsymmult parameter.</A>
148Setting it to y will cause Mup to use an alternate style for
149multirests of eight measures or less, which uses rest symbols.
150<LI>
151There is a new string sequence that will be replaced by
152<A HREF="uguide/headfoot.html#pagenum">the page number of the last page.</A>
153This may useful to be able to automatically get output
154like &quot;Page 2 of 4 pages.&quot;
155<LI>
156There is a new option for printing of
157<A HREF="uguide/tuplets.html">tuplet</A> numbers,
158where the number is always printed, but the bracket is never printed.
159<LI>
160If you want to have the same
161<A HREF="uguide/lyrics.html">lyrics</A>
162above some staffs and below others,
163it is now possible to specify that on a single input line,
164rather than requiring two.
165<LI>
166Improvements have been made to how voice 3 is placed,
167which will often eliminate the need to manually specify a
168<A HREF="uguide/chrdattr.html#hoffset">horizontal offset.</A>
169</UL>
170</P>
171<H2>New Features in Mup Version 5.0</H2>
172<P>
173<UL>
174<LI>
175Mup now supports the
176<A HREF="uguide/shaped.html">shaped notes</A>
177often used in &quot;Sacred
178Harp&quot; music, also sometimes called &quot;fasola&quot; notation.
179New note head characters are available for the most common system of 4 shapes,
180as well as a system with 7 shapes.
181As part of this feature, there is a new
182<A HREF="uguide/shaped.html#hdshape">headshape context</A>
183and a new
184<A HREF="uguide/param.html#notehead">noteheads parameter</A>
185that lets you define what shapes will be used for notes.
186<LI>
187Note head shapes can also be specified on
188<A HREF="uguide/shaped.html#chord">specific chords</A>
189or
190<A HREF="uguide/shaped.html#note">a specific note within a chord.</A>
191This makes it possible to do things like have both normal
192and X-shaped notes on the same stem.
193<LI>
194There are new &quot;slash&quot;
195<A HREF="uguide/shaped.html">note heads,</A>
196often used to indicate
197repeated chords, and a new &quot;blankhead&quot; note head, that can be
198used if you just want a stem without any note head.
199<LI>
200There is a new
201<A HREF="uguide/param.html#stemlen">stemlen parameter</A>
202that lets you set the default stem length. A common use for this would
203be to set this parameter to 0.0,
204to not have any stems at all (sometimes used for chant).
205<LI>
206It is now possible to change the
207<A HREF="uguide/param.html#clef">clef,</A>
208<A HREF="uguide/param.html#defoct">defoct,</A>
209and
210<A HREF="uguide/param.html#release">release</A>
211parameters in the
212<A HREF="uguide/midmeas.html">middle of a measure.</A>
213<LI>
214You can now include
215<A HREF="uguide/prnttext.html#postscript">raw PostScript</A>
216in the input to the copied to the output. This could be used,
217for example, to include a picture or logo with your music.
218<LI>
219In addition to the old way of specifying
220<A HREF="uguide/param.html#key">key signature,</A>
221by stating the number of sharps or flats,
222it is now possible to specify the key by name, as in &quot;a major&quot;
223or &quot;c# minor.&quot;
224<LI>
225There is a new
226<A HREF="uguide/param.html#swing">swingunit parameter.</A>
227Some styles of music are often written with straight eighth notes
228or dotted-eighth-sixteeen notations, but where the players &quot;know&quot;
229that the composer really wants the music played
230with the first note in each pair twice as long as the second,
231as if it were a quarter-eighth triplet.
232This parameter will make Mup's MIDI output automatically follow that kind of
233performance convention.
234<LI>
235It is possible to
236<A HREF="uguide/bars.html#setreh">set the rehearsal letter or number</A>
237to a specific value, to override the automatic incrementing.
238This might be especially useful when there are multiple songs or movements
239in a single Mup file.
240</UL>
241</P>
242<H2>New Features in Mup Version 4.6</H2>
243<P>
244<UL>
245<LI>
246There are new
247<A HREF="uguide/headfoot.html">top, bottom, top2, and bottom2 contexts</A>
248that let you define a second layer of headers and footers. These new
249contexts can be changed multiple times in a file, so you can use different
250headings and footing for different songs or movements within a file.
251<LI>
252There is a new
253<A HREF="uguide/prnttext.html#block">&quot;block&quot; context,</A>
254that lets you place blocks of text in your musical scores.
255<LI>
256There is a new
257<A HREF="uguide/prnttext.html#paragrph">paragraph</A> command for printing
258long sections of text that you would like to have automatically wrapped
259around unto as many lines as needed. The right margin can be justified
260or ragged.
261<LI>
262For Linux, in addition to being available in tar.gz format, Mup files are now
263<A HREF="obtain.html#linux">available in rpm package format,</A>
264for very quick-and-easy installation. The
265MS-DOS/Windows Mup files are now available as
266<A HREF="obtain.html#windows">self-extracting zip files,</A>
267so you don't need to have
268an unzip program to unpack them.
269<LI>
270The
271<A HREF="uguide/param.html#visible">visible parameter</A>
272now accepts a value of &quot;whereused.&quot;
273With this value, when a staff has no notes on an entire score,
274that staff is not printed. This might be used, for example,
275to save paper on an orchestral score by only printing staffs for
276instruments when they are actually playing.
277<LI>
278There are new parameters
279<A HREF="uguide/param.html#mnumfont">measnumfont,</A>
280<A HREF="uguide/param.html#mnumfam">measnumfontfamily,</A>
281and
282<A HREF="uguide/param.html#mnumsize">measnumsize,</A>
283to control the appearance of
284<A HREF="uguide/param.html#measnum">automatic measure numbers.</A>
285<LI>
286It is now possible to
287<A HREF="uguide/param.html">unset parameters</A>
288in voice or staff context, to make them revert to their values
289in the next more general context where they are set (staff or score).
290<LI>
291When a repeatstart gets moved to the beginning of a score, sometimes
292you'd like the bar line at the end of the previous score to be a double
293bar rather than single bar. It is now possible to
294<A HREF="uguide/bars.html">specify that.</A>
295<LI>
296There is a new
297<A HREF="uguide/cmdargs.html#Foption">-F option</A>
298that is like the -f option, except it derives the name of the output
299file based on the name of the input file, rather than you needing to
300specify an output file name.
301<LI>
302The Mup input file name is given in the PostScript output file,
303so that PostScript viewer programs like gv can use it in their window title.
304<LI>
305There is now a
306<A HREF="maillist.html">majordomo mailing list available for
307registered Mup users.</A> This is a forum for talking with other Mup users,
308to discuss questions and tips on using Mup.
309</UL>
310</P>
311<H2>New Features in Mup Version 4.5</H2>
312<P>
313<UL>
314<LI>
315There is a new
316<A HREF="uguide/cmdargs.html#xoption">-x option</A>
317that lets you extract a portion of a song. This can be
318especially useful for MIDI, where you might want
319to listen to just a few measures
320in the middle or end of a piece. But it also works in printing mode,
321so you can print just an excerpt of a piece.
322<LI>
323It is now possible to specify &quot;subbeams,&quot; both with
324<A HREF="uguide/ichdattr.html#custbeam">custom beaming</A> and via the
325<A HREF="uguide/param.html#beamstyl">beamstyle parameter.</A>
326This can be used when there are a lot of very short notes,
327and you want to subdivide the beam groupings.
328<LI>
329The drawing of phrase marks, ties, and slurs has been re-implemented to
330produce more aesthetically pleasing curves.
331<LI>
332There is a new special character,
333<A HREF="uguide/textstr.html#space">called \(space),</A>
334which is printed like
335a normal space on output, but which is not treated like a space when Mup is
336looking for word or syllable boundaries. The most common use for this would
337probably be on
338<A HREF="uguide/lyrics.html">chant lyrics,</A>
339where you want several words to be sung to the same note.
340It might also be useful in cases where Mup would normally split a long
341string at a word boundary to avoid running off the edge of a page,
342but for some reason you want to prevent that splitting.
343<LI>
344It is possible to
345<A HREF="uguide/linecurv.html">print a text string centered above a line.</A>
346This is likely to be the most useful for printing &quot;gliss.&quot; by a wavy
347line for a glissando, but it can be used on any kind of line.
348<LI>
349There are some new <a HREF="userpgms.html">user-donated files,</A>
350including a Windows installer, and Mup syntax files for nedit and vim.
351</UL>
352</P>
353<H2>New Features in Mup Version 4.4</H2>
354<P>
355<UL>
356<LI>
357Many of the changes in this release were to make Mup conform more closely with
358established guidelines or rules for musical notation.
359This mainly involved small adjustments to cosmetic details, like
360how accidentals and dots are placed.
361For mid-score clef changes, the clef is now placed before the barline,
362as it should be, rather than after.
363There is also an improved algorithm for determining where to
364end the underscores on lyrics.
365<LI>
366The use of labels, both
367<A HREF="uguide/param.html#label">labels associated with individual staffs</A>
368and labels associated with staffs grouped by
369<A HREF="uguide/param.html#brace">braces</A> or
370<A HREF="uguide/param.html#bracket">brackets</A>,
371has been made more flexible.
372It used to be that the &quot;label&quot; was only used on
373the very first score, with &quot;label2&quot; used on all subsequent scores.
374Thus resetting label after the beginning really had no effect.
375Now, however, whenever a new label is specified, that label will be used for the
376next score, going back to label2 for subsequent scores.
377As an example, this might be useful if staff 1 was used for just soprano
378at the beginning of the song,
379so you wanted label=&quot;Soprano&quot; and label2=&quot;S&quot;
380for that portion, but later soprano and alto share the staff, so you would
381like label=&quot;Soprano/alto&quot; to clearly point out the change, but then
382revert to just &quot;SA&quot; on subsequent staffs, to conserve space.
383<LI>
384You can specify a bulge direction for
385<A HREF="uguide/noteattr.html#ntie">note ties,</A>
386<A HREF="uguide/noteattr.html#nslur">note slurs,</A>
387<A HREF="uguide/ichdattr.html#tie">chord ties,</A> and
388<A HREF="uguide/ichdattr.html#slur">chord slurs,</A>
389if you wish to override Mup's choice of direction.
390<LI>
391You can now use \s(PV) or \s(previous) in a text string to return to
392the previous
393<A HREF="uguide/textstr.html#size">size.</A>
394<LI>
395The
396<A HREF="uguide/param.html#clef">8treble clef</A> is now supported.
397This is like the treble8 clef, except the 8 is printed above the G clef
398rather than below it, to show notes that sound an octave <I>higher</I> than
399a normal treble clef.
400<LI>
401<A HREF="uguide/phrase.html">Phrase marks</A> can now have
402an optional line type modifier of dotted or dashed.
403</UL>
404</P>
405<H2>New Features in Mup Version 4.3</H2>
406<P>
407<UL>
408<LI>
409There is a new
410<A HREF="uguide/param.html#rehstyle">rehstyle parameter</A>
411that controls whether rehearsal marks are boxed, circled, or plain.
412<LI>
413It is no longer necessary to specify verse numbers for
414<A HREF="uguide/lyrics.html">lyrics</A>
415(unless you want to skip a verse). If not specified, each
416succeeding set of lyrics for a given staff and place defaults
417to having a verse number one more than the previous verse.
418<LI>
419There is a new way to
420<A HREF="uguide/param.html#sylpos">force the position of individual lyrics syllables</A>
421that is particularly useful for ensuring that verse numbers or the
422beginnings of poetic lines align consistently on all verses.
423<LI>
424There are new
425<A HREF="uguide/cmdargs.html#Eoption">-E and -C options</A>
426that let you see how macros expand, which can help you in debugging
427very complex macros.
428<LI>
429There is a new
430<A HREF="uguide/param.html#staffpad">staffpad parameter</A>,
431and the value of the
432<A HREF="uguide/param.html#scorepad">scorepad parameter</A>
433can now be negative. Using negative values for these can let you
434jam staffs or scores closer together in cases where
435Mup is spacing them wider apart than is really necessary.
436<LI>
437It is now possible to have more than one voice on
438<A HREF="uguide/tabstaff.html">tablature staffs</A>
439just like on non-tablature.
440<LI>
441It is now possible to
442<A HREF="uguide/newscore.html">temporarily override margins</A>
443on a particular score. This can let you indent one score differently
444than the others, or end a piece with a shorter-than-normal score.
445<LI>
446There is now an &quot;alt pedstar&quot; value for the
447<A HREF="uguide/param.html#pedstyle">pedstyle parameter</A>
448This is like the &quot;pedstar&quot; value
449except that when there is a pedal &quot;bounce,&quot;
450only a &quot;Ped&quot; is printed, rather than a &quot;* Ped.&quot;
451<LI>
452There is a new
453<A HREF="userpgms.html">user-donated program</A> called
454<A HREF="ftp://ftp.arkkra.com/pub/dos/user.pgms/winmup11.zip">Winmup</A>
455which provides a Windows front-end for the MS-DOS version of Mup. The
456<A HREF="ftp://ftp.arkkra.com/pub/dos/user.pgms/winmup11src.zip">Visual Basic source
457code for Winmup</A> is also available.
458<LI>
459Several miscellaneous changes were made to improve the quality of
460printed output and to improve portability.
461Current Mup users may find the layout of some songs may change
462somewhat when they upgrade.
463</UL>
464</P>
465<H2>New Features in Mup Version 4.2</H2>
466<P>
467<UL>
468<LI>
469A <A HREF="uguide/param.html#vscheme">third voice per staff</A>
470is now supported.
471<LI>
472It is now possible to
473<A HREF="uguide/chrdattr.html#hoffset">adjust the horizontal placement of notes.</A>
474<LI>
475It is now possible to
476<A HREF="uguide/param.html#beamstyl">beam across rests.</A>
477<LI>
478The optional
479<A HREF="uguide/param.html#measnum">automatic measure numbers
480at the beginnings of scores</A> are now printed in a larger size.
481<LI>
482<A HREF="uguide/altinp.html">The chord-at-a-time input style</A>
483has been made more versatile. Previously,
484if a voice was mentioned in a pattern, that voice could not be used for
485voice-at-a-time input style in that measure, even if the pattern was
486never actually used. Now the restriction only applies if the pattern is
487actually used.
488<LI>
489Strings can be printed
490<A HREF="uguide/textstr.html#boxed">enclosed in a circle or elipse.</A>
491<LI>
492There is a new
493<A HREF="uguide/param.html#beamslp">beamslope parameter</A>
494that controls the maximum tilt for beams.
495<LI>
496There is a new
497<A HREF="uguide/param.html#pad">pad parameter</A>
498that provides an additional way to control how close together
499note groups are placed horizontally.
500<LI>
501There is a new
502<A HREF="uguide/midi.html">MIDI "port" keyword.</A>
503This can let you assign different tracks to different ports on
504multi-port MIDI devices, allowing for more than 16 channels.
505<LI>
506The minimum values for the
507<A HREF="uguide/param.html#scoresep">scoresep</A> and
508<A HREF="uguide/param.html#staffsep">staffsep</A> parameters
509can now be set as low as 6, rather than the previous minimum of 9.
510</UL>
511</P>
512<H2>New Features in Mup Version 4.1</H2>
513<P>
514<UL>
515<LI>
516<A HREF="uguide/textmark.html#grids">Guitar grids</A> can now be
517printed, either
518<A HREF="uguide/param.html#gridused">where they are used in the music,</A>
519or
520<A HREF="uguide/param.html#gridend">summarized at the end of a song.</A>
521There is also a
522<A HREF="userpgms.html">library of pre-defined grids</A>
523that you can
524<A HREF="uguide/include.html">&quot;include&quot;</A> in your music.
525<LI>
526<A HREF="uguide/textstr.html#special">Non-ASCII characters from the Latin-1 alphabet</A> can now be typed directly
527into strings in Mup input, rather than needing to be specified by name.
528Shortcut names have also been added for guillemots.
529<LI>
530The maximum
531<A HREF="uguide/param.html#staffs">number of staffs</A> has been raised to 40.
532<LI>
533The
534<A HREF="uguide/param.html#stlines">stafflines</A>
535and
536<A HREF="uguide/param.html#stscale">staffscale</A>
537parameters can now be changed at any bar line rather than only at the
538beginning of a song. Changing either of them forces a new score.
539<LI>
540The <A HREF="uguide/param.html#staffsep">staffsep</A>
541parameter can now be set on a per-staff basis, rather than just
542for the score as a whole.
543<LI>
544There are new parameters that allow you to control the order that items
545<A HREF="uguide/param.html#aboveord">above,</A>
546<A HREF="uguide/param.html#beloword">below,</A>
547and
548<A HREF="uguide/param.html#betwnord">between</A>
549staffs are stacked.
550<LI>
551It is now possible to
552<A HREF="uguide/param.html#nummrpt">
553turn off the automatic numbering of measure repeats</A>
554and the
555<A HREF="uguide/param.html#prmultn">
556printing of multirest numbers.</A>
557<LI>
558It is now possible to
559<A HREF="uguide/chrdattr.html#dist">specify the vertical placement of a rest character,</A>
560if you want to override Mup's automatic placement.
561<LI>
562It is now possible to
563<A HREF="uguide/textstr.html#strcat">concatenate strings.</A>
564This is likely to be most useful in
565<A HREF="uguide/macros.html">macros,</A>
566but can be used anywhere strings are used.
567<LI>
568There is a new
569<A HREF="uguide/param.html#firstpg">firstpage parameter,</A>
570which is similar to the
571<A HREF="uguide/cmdargs.html#poption">-p command line option,</A>
572for setting the first page number.
573<LI>
574There is a new
575<A HREF="uguide/param.html#restcomb">restcombine parameter,</A>
576which is similar to the
577<A HREF="uguide/cmdargs.html#coption">-c command line option,</A>
578for automatically combining a sequences of rest measures into
579<A HREF="uguide/multirst.html">multirests.</A>
580<LI>
581Music symbols that occur inside ital or boldital strings will
582<A HREF="uguide/textmark.html#italmus">automatically be made italics</A>
583to match the string.
584<LI>
585It is possible to
586<A HREF="uguide/lyrics.html#centered">vertically center lyrics.</A>
587This is useful when there is a refrain with identical words for all
588verses, and you only want it printed once.
589<LI>
590It is now allowed to have a
591<A HREF="uguide/param.html#brace">brace</A>
592to the left of
593<A HREF="uguide/param.html#bracket">brackets,</A>
594to group a subset of staffs.
595(Previously, only brackets were allowed to be nested that way.)
596</UL>
597</P>
598<H2>New Features in Mup Version 4.0</H2>
599<P>
600<UL>
601<LI>
602There is now an
603<A HREF="uguide/altinp.html">alternate input style,</A>
604in which you can enter music a chord at a time rather than a voice at
605a time. For certain kinds of music, this may be more natural,
606and allow you to enter music more quickly.
607<A HREF="uguide/chordinp.html">The previous input style</A>
608has also been made more flexible, such that it
609is now possible to specify that one line of input will go to voice 1
610on one staff or set of staffs and voice 2 on another staff or set of staffs.
611These enhancements make it easier to do things like input a vocal score and
612<A HREF="uguide/pianored.html">automatically get a piano reduction.</A>
613<LI>
614It is now possible to
615<A HREF="uguide/macros.html#quoting">transform a parameter passed
616to a macro into a string.</A>
617If you are a C programmer, you will find this works somewhat
618like the # operator of ANSI C preprocessor macros. If you're not a
619C programmer, suffice it to say that this allows Mup macros to be used
620to do things they couldn't do before.
621<LI>
622There is a new special bar type, called
623<A HREF="uguide/bars.html#restart">restart</A>, that lets you
624end the current set of staffs and begin a new set of staffs on the same
625line, as is sometimes done for a short coda.
626<LI>
627The symbols for accidentals (like # and &amp;) are now translated to
628their corresponding musical symbols everywhere in
629<A HREF="uguide/textmark.html#chordmod">chords,</A>
630rather than only if they immediately follow the letters A through G.
631You can, however, turn off this automatic translation
632for individual cases where you want them to be treated literally.
633<LI>
634<A HREF="uguide/chordinp.html#duration">Quadruple whole rests</A> are supported.
635<LI>
636It is possible to force a
637<A HREF="uguide/chordinp.html#measdur">measure rest</A>
638to be shown with a rest symbol other than the whole rest symbol
639that is usually used.
640<LI>
641There is a new
642<A HREF="uguide/param.html#addxpose">addtranspose parameter</A>. This
643enables you to use the
644<A HREF="uguide/param.html#xpose">transpose parameter</A> to change
645the transposition on specific staffs for transposing instruments,
646then use addtranpose to transpose the entire score into a new key.
647<LI>
648There is a new
649<A HREF="uguide/param.html#warn">warn parameter</A> which allows you
650to control whether warning messages are printed or not.
651<LI>
652There is a new
653<A HREF="uguide/param.html#ontheline">ontheline parameter</A>. This
654allows you to control whether notes on 1-line staffs are printed above, below,
655or on the line.
656<LI>
657The
658<A HREF="uguide/param.html#dist">dist,</A>
659<A HREF="uguide/param.html#chdist">chorddist,</A>
660and
661<A HREF="uguide/param.html#cresdist">crescdist</A>
662parameters can be
663<A HREF="uguide/stuff.html#dist">overridden on individual items.</A>
664A dist override can also be specified on
665<A HREF="uguide/bars.html#reh">rehearsal marks.</A>
666Each dist override can also include a modifier
667to force items to a specific place,
668even if they then overwrite other items that Mup would normally avoid.
669<LI>
670There is a new
671<A HREF="uguide/cmdargs.html#moption">-M option</A> which is like the
672-m option, except the name of the MIDI file is derived from the Mup
673input file name, rather than requiring you to supply a name.
674<LI>
675If a given input file name does not exist, Mup will try appending .mup
676to the name and attempt to open that file.
677<LI>
678It is now possible to specify an
679<A HREF="uguide/chordinp.html#restspc">uncollapseable space</A>.
680This may be useful when drawing "slash" marks and at other times.
681<LI>
682There is a new
683<A HREF="userpgms.html">user-donated program</A> called midi2mup, which
684is a Perl script that can convert a MIDI file to Mup input.
685<LI>
686The uguide gives examples of how to
687<A HREF="uguide/verses.html">places verses as text blocks below the scores.</A>
688</UL>
689</P>
690<H2>Coming Attractions</H2>
691<P>
692We're always interested in hearing about what features you would
693like to see in the next version of Mup.
694What features we add will depend on your input, so
695please send us a note at
696<A HREF="mailto:support@arkkra.com">support@arkkra.com.</A>
697</P>
698<!-- add link to home page -->
699</BODY>
700</HTML>