1mup(1)                      General Commands Manual                     mup(1)
2
3
4

NAME

6       mup - music publisher
7

SYNOPSIS

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

DESCRIPTION

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
20       -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
33       -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
37       -d N   Print debugging information. N is a bitmap.
38
39           1      parse phase information
40
41           2      high level parse phase tracing
42
43           4      low level parse phase tracing
44
45           8      reserved
46
47           16     high level placement phase tracing
48
49           32     low level placement phase tracing
50
51           64     reserved
52
53           128    contents of the main internal list
54
55           256    high level print phase tracing
56
57           512    low level print phase tracing
58
59              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
64       -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
72       -e errfile
73              Place error messages into errfile instead of writing them to the
74              standard error output stream.
75
76       -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
81       -f outfile
82              Place the output into outfile instead of writing it to the stan‐
83              dard output.
84
85       -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
96       -l     Print the Mup license and exit.
97
98       -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
104       -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
115       -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
129       -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
134       -q     Quiet mode. Omit  printing  the  version  number  and  Copyright
135              notice on startup.
136
137       -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
147       -v     Print the Mup version number and exit. This manual page  is  for
148              version 6.7.
149
150       -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
169       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
180       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
185       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

SEE ALSO

197       gs(1), mkmupfnt(1), mupdisp(1), mupmate(1), mupprnt(1).
198       Mup — Music Publisher User's Guide
199
200
201
202Arkkra Enterprises             January 21, 2019                         mup(1)
Impressum