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] [-q] [-v] [-x
11 N[,M] [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 -q Quiet mode. Omit printing the version number and Copyright
135 notice on startup.
136 -sstafflist
138 Only print the staffs that are included in stafflist. This can
139 be a comma‐separated list of staff numbers or ranges, such as
140 "1,5" or "1-3,7-8" To further restrict to a single voice on a
141 staff, add vN where N is the voice number (1, 2, or 3), after
142 the staff, as in "2v1,5v2" You can't specify a list or range for
143 voices; if you only want to make two out of three voices visi‐
144 ble, you have to specify them separately, like "1v2,1v3". No
145 spaces are allowed in the list.
146 -v Print the Mup version number and exit. This manual page is for
148 version 6.7.
149 -xM,N Extract measures M through N of the song. This allows you to
151 print or play a part of a song. The comma and second value are
152 optional; if not specified, the default is to go to the end of
153 the piece. Positive values specify the number of measures from
154 the beginning of the piece, while negative values are relative
155 to the end, with -1 referring to the last measure of the song.
156 So -x1,-1 means the entire song, if the song doesn't have a
157 pickup measure. If the song has a pickup measure, that is spec‐
158 ified by 0. So for a song with a pickup, -x0,-1 would mean the
159 entire song, and -x0,0 would mean just the pickup measure. As
160 other examples, -x-1,-1 means just the final measure of the
161 song, -x2 means starting after the first full measure, -x3,4
162 means only measures 3 and 4, and -x6,6 means just measure 6.
163 The starting measure is not allowed to be inside an ending. A
164 common use for this option might be to generate a MIDI file for
165 just a few measures. For example, if you were trying to tweak
166 tempo values for a ritard in the last 2 measures of a song, you
167 could use -x-2 to listen to just those measures.
168 The options, if any, can be followed by one or more files in Mup for‐
170 mat. If no files are specified, standard input is read. If several
171 files are listed, they are effectively concatenated together and
172 treated as one big file. Since there are some things (such as header
173 and footer) that are only allowed to occur once, if you have several
174 independent pieces, mup should be called on each individually rather
175 than trying to print them all with one command. If a specified file
176 does not exist, and its name does not already end with .mup or .MUP,
177 then Mup will append .mup to the specified name and attempt to open
178 that.
179 On most systems, the environment variable MUPPATH can be set to a list
181 of paths in which to look for 'include' files. The components are sep‐
182 arated by a colon on Unix or Linux systems, and by a semicolon on sys‐
183 tems with DOS‐like file naming conventions.
184 For more debugging, in addition to the -d option, if the environment
186 variable MUP_BB is set to "bcfghnsu" or any subset of those letters,
187 the generated output will include "bounding boxes" for the things Mup
188 internally calls bars (b), chords (c), feeds (f), grpsyls (g),
189 header/footer and top/bottom (h), notes (n), staffs (s), and stuff (u).
190 While this is intended for use in debugging Mup itself, it may also
191 help you understand why Mup places things the way it does, since in
192 general, Mup only allows bounding boxes to overlap according to spe‐
193 cific rules. If viewed with a color PostScript viewer (not mupdisp),
194 these boxes will be in color.
195
197 gs(1), mkmupfnt(1), mupdisp(1), mupmate(1), mupprnt(1).
198 Mup — Music Publisher User's Guide
199Arkkra Enterprises January 21, 2019 mup(1)