1mup(1) General Commands Manual mup(1)
2
6 mup - music publisher
7
9 mup [-cN] [-C] [-dN] [-D MACRO[=macro_def]] [-e errfile] [-E] [-f out‐
10 file] [-F] [-l] [-m midifile] [-M] [-o pagelist] [-pN] [-v] [-x N[,M]
11 [file...]
12
14 Mup is a program for producing printed music. There is an optional
15 companion program called Mupmate that provides a more graphical user
16 interface on top of Mup, but this manual page describes the command
17 line interface. The Mup User's Guide should be consulted for details
18 of the format of the input file. Options include:
19 -c N Combine consecutive measures of all rests or spaces into mul‐
21 tirests (multiple measures of rest printed as a single measure,
22 with the number of measures of rest printed above the staff).
23 Any time there are N or more measures in a row that consist
24 entirely of rests or spaces, they will be replaced by a mul‐
25 tirest. The combining of measures stops when there is a visible
26 staff that contains notes, lyrics, or other musical symbols,
27 when there are parameter changes on a visible staff or in score
28 context, or when there is a bar line other than an ordinary or
29 invisible bar. This option is most likely to be useful when
30 printing a subset of staffs, where the particular staff(s) you
31 are printing have long periods of rests. (See the -s option.)
32 -C This option is only used in connection with the -E option. It
34 specifies that comments are to be passed through rather than
35 deleted.
36 -d N Print debugging information. N is a bitmap.
38 1 parse phase information
40 2 high level parse phase tracing
42 4 low level parse phase tracing
44 8 reserved
46 16 high level placement phase tracing
48 32 low level placement phase tracing
50 64 reserved
52 128 contents of the main internal list
54 256 high level print phase tracing
56 512 low level print phase tracing
58 N can be specified in decimal, octal (by using a leading zero),
60 or hex (by using a leading 0x). This information is intended
61 for debugging of Mup itself and thus is not likely to be of use
62 to the average user.
63 -D MACRO[=macro_def]
65 Define the macro MACRO. The macro name must consist of upper
66 case letters, digits, and underscores, beginning with an upper
67 case letter. The macro_def is optional, and gives the text of
68 the macro. If it contains any white space or other special char‐
69 acters, it must be quoted (if quoting is supported by your oper‐
70 ating system or shell).
71 -e errfile
73 Place error messages into errfile instead of writing them to the
74 standard error output stream.
75 -E Rather than produce PostScript or MIDI output, just expand
77 macros and includes, and write the result to the standard output
78 stream. Comments in the input are deleted, unless the -C option
79 is also specified.
80 -f outfile
82 Place the output into outfile instead of writing it to the stan‐
83 dard output.
84 -F This is like the -f option, except the name of the output file
86 is derived from the name of the Mup input file. If the name of
87 the Mup input file ends with a ".mup" suffix, the generated
88 PostScript output file will end with a ".ps" suffix instead. If
89 the name of the Mup input file ends with a ".MUP" suffix, the
90 PostScript file will end with a ".PS" suffix. Otherwise, a
91 ".ps" suffix will be appended to the end of the Mup input file
92 name. If multiple input files are listed, the last is used. If
93 none are specified (input is read from standard input), the name
94 "stdin.ps" will be used for the output file.
95 -l Print the Mup license and exit.
97 -m midifile
99 Instead of generating PostScript output, generate standard MIDI
100 (Musical Instrument Digital Interface) output, and put it in
101 midifile. This option also causes the macro "MIDI" to become
102 defined.
103 -M This is like the -m option, except the name of the MIDI file is
105 derived from the name of the Mup input file. If the name of the
106 Mup input file ends with a ".mup" suffix, the generated MIDI
107 file will end with a ".mid" suffix instead. If the name of the
108 Mup input file ends with a ".MUP" suffix, the MIDI file will end
109 with a ".MID" suffix. Otherwise, a ".mid" suffix will be
110 appended to the end of the Mup input file name. If multiple
111 input files are listed, the last is used. If none are specified
112 (input is read from standard input), the name "stdin.mid" will
113 be used for the MIDI file.
114 -o pagelist
116 Print only the pages given in pagelist. The pagelist can be a
117 comma‐separated list of numbers or ranges, where a range is two
118 numbers separated by a dash. For example, -o1,7-9,12-14 would
119 print pages 1, 7, 8, 9, 12, 13, and 14. Pages will be printed in
120 the order given. They need not be in order, and a page number
121 may be included more than once. Alternately, the pagelist can
122 be the special keyword "odd" or "even" which will cause all odd
123 or even numbered pages to be printed. This may be useful if you
124 have a printer that only makes single‐sided copies, but you wish
125 to print Mup output double‐sided. You could print odd‐numbered
126 pages, then turn the paper over and feed the pages through again
127 for the even‐numbered pages.
128 -pN Start numbering pages at N instead of at 1. If -o and -p are
130 used together, the page numbers given in the -opagelist must be
131 the printed page numbers. For example, if you use -p10 and want
132 to print just the second page, you would need to specify -o11.
133 -sstafflist
135 Only print the staffs that are included in stafflist. This can
136 be a comma‐separated list of staff numbers or ranges, such as
137 "1,5" or "1-3,7-8" To further restrict to a single voice on a
138 staff, add vN where N is the voice number (1, 2, or 3), after
139 the staff, as in "2v1,5v2" You can't specify a list or range for
140 voices; if you only want to make two out of three voices visi‐
141 ble, you have to specify them separately, like "1v2,1v3". No
142 spaces are allowed in the list.
143 -v Print the Mup version number and exit. This manual page is for
145 version 6.6.
146 -xM,N Extract measures M through N of the song. This allows you to
148 print or play a part of a song. The comma and second value are
149 optional; if not specified, the default is to go to the end of
150 the piece. Positive values specify the number of measures from
151 the beginning of the piece, while negative values are relative
152 to the end, with -1 referring to the last measure of the song.
153 So -x1,-1 means the entire song, if the song doesn't have a
154 pickup measure. If the song has a pickup measure, that is spec‐
155 ified by 0. So for a song with a pickup, -x0,-1 would mean the
156 entire song, and -x0,0 would mean just the pickup measure. As
157 other examples, -x-1,-1 means just the final measure of the
158 song, -x2 means starting after the first full measure, -x3,4
159 means only measures 3 and 4, and -x6,6 means just measure 6.
160 The starting measure is not allowed to be inside an ending. A
161 common use for this option might be to generate a MIDI file for
162 just a few measures. For example, if you were trying to tweak
163 tempo values for a ritard in the last 2 measures of a song, you
164 could use -x-2 to listen to just those measures.
165 The options, if any, can be followed by one or more files in Mup for‐
167 mat. If no files are specified, standard input is read. If several
168 files are listed, they are effectively concatenated together and
169 treated as one big file. Since there are some things (such as header
170 and footer) that are only allowed to occur once, if you have several
171 independent pieces, mup should be called on each individually rather
172 than trying to print them all with one command. If a specified file
173 does not exist, and its name does not already end with .mup or .MUP,
174 then Mup will append .mup to the specified name and attempt to open
175 that.
176 On most systems, the environment variable MUPPATH can be set to a list
178 of paths in which to look for 'include' files. The components are sep‐
179 arated by a colon on Unix or Linux systems, and by a semicolon on sys‐
180 tems with DOS‐like file naming conventions.
181 For more debugging, in addition to the -d option, if the environment
183 variable MUP_BB is set to "bcfghnsu" or any subset of those letters,
184 the generated output will include "bounding boxes" for the things Mup
185 internally calls bars (b), chords (c), feeds (f), grpsyls (g),
186 header/footer and top/bottom (h), notes (n), staffs (s), and stuff (u).
187 While this is intended for use in debugging Mup itself, it may also
188 help you understand why Mup places things the way it does, since in
189 general, Mup only allows bounding boxes to overlap according to spe‐
190 cific rules. If viewed with a color PostScript viewer (not mupdisp),
191 these boxes will be in color.
192
194 gs(1), mkmupfnt(1), mupdisp(1), mupmate(1), mupprnt(1).
195 Mup — Music Publisher User's Guide
196Arkkra Enterprises November 22, 2012 mup(1)