1mupmate(1) General Commands Manual mupmate(1)
2
3
4
6 mupmate - user interface for Mup music publisher
7
9 mupmate [file]
10
12 You can create a Mup file using any ordinary text editor. On Windows,
13 Notepad is a typical choice; on Linux, editors like vim and emacs are
14 commonly used. But if you prefer to be able to edit, display, and play
15 from a single integrated and more graphical interface, a helper program
16 called "mupmate" is provided. Mupmate is currently supported on Win‐
17 dows, Apple Mac OS-X, and Linux. However, since the source code is
18 available, and it is based on the cross‐platform FLTK toolkit, it can
19 probably be made to run on any system supported by FLTK fairly easily.
20 If you prefer to use the Mup program directly rather than via mupmate,
21 you can. The Mupmate program just helps lead you through some of the
22 steps.
23
24 Once you have installed Mup and Mupmate on Windows, double clicking a
25 .mup file in Windows explorer will run Mupmate on that file. Or, you
26 can run Mupmate by going to the Start menu, and choosing Programs, then
27 Arkkra, and then Mupmate. If you would like an icon on the desktop,
28 you can create one by right clicking the Mupmate choice in the Arkkra
29 menu, choosing "copy", right clicking somewhere on the desktop, and
30 choosing "paste."
31
32 On Linux, you can just type the mupmate command, optionally followed by
33 the name of a Mup input file. Or you can add mupmate to your favorite
34 window manager's menus.
35
36 On Mac OS-X, you can double‐click on the MupMate.app in Finder. You
37 should also be able to double‐click any file with a .mup suffix, which
38 should then run Mupmate on that file. For setting paths in the Prefer‐
39 ences, several "magic" variables are set automatically, if you have not
40 already set them to something else. $APPL is set to the top of the
41 application directory hierarchy. $RSRC is effectively set to
42 $APPL/MupMate.app/Contents/Resources. $HOME is set to your home direc‐
43 tory. $SUPP is set to your applications support folder (which is typi‐
44 cally $HOME/Library/Application Support). $DOCS is set to your docu‐
45 ment folder (which is typically $HOME/Documents).
46
47 Mupmate provides five top level menus: File, Edit, Run, Config, and
48 Help. The File menu provides commands for opening new files and saving
49 the file you are working on, as well as exit the program. The Edit menu
50 provides the kinds of things you would expect in a editor: commands to
51 find a pattern, or find and replace; to select text; to copy, cut, and
52 paste; to go to a specific line; and to undo the previous operation, if
53 you make a mistake or change you mind. The Run menu lets you set run‐
54 time options, and then run the Mup program on your input in various
55 ways. You can either just generate a PostScript or MIDI file, or dis‐
56 play the PostScript or play the MIDI. The Config menu lets you specify
57 what application program you want to use to view PostScript files and
58 which you want to use to play MIDI files, and well as specify locations
59 for other Mup files. Mupmate will try to find reasonable default val‐
60 ues, but you may want to check that they are what you want, and tweak
61 them if they aren't. For paths, you can include environment variables
62 to be expanded, by giving their name preceded by a dollar sign. A
63 tilde by itself will be expanded to your home directory, whereas a
64 tilde followed by the name of a user will be expanded to that user's
65 home directory. The Help menu lets you browse the Mup User's Guide,
66 view some startup hints, view the Mup license, or see the current ver‐
67 sion number of Mup and Mupmate.
68
70 gs(1), mup(1).
71 Mup — Music Publisher User's Guide
72
74 Mupmate is currently only supported on Microsoft Windows, Apple Mac
75 OS-X, and Linux or similar.
76
77 Mupmate does not directly provide a print facility. Almost any Post‐
78 Script viewer already provides this ability, so you can simply select
79 "Display" from the Run menu and use the viewer's print capabilities.
80 Alternately you can use the "Write PostScript File" from the Run menu
81 and then print the resulting file.
82
83
84
85Arkkra Enterprises November 22, 2012 mupmate(1)