7 <A HREF="basics.html"><-- previous page</A>
9 <A HREF="index.html">Table of Contents</A> <A HREF="cmdargs.html">next page --></A>
16 There are two basic ways to run Mup: directly from a command line or via
17 the Mupmate program. You can use either approach, or switch between them
18 as you wish. The Mupmate program just
19 provides a more menu-driven environment on top of the Mup program itself.
22 You can create a Mup file using any ordinary text editor,
23 and then run the Mup program on the file you created.
24 On Windows, Notepad is a typical editor choice, and on Linux, editors like
25 vim and emacs are commonly used, but pretty much any text editor (not
26 word processor) can be used. Many people, however, prefer to be able to
27 edit, display, and play from a single integrated and more graphical
28 interface, and for them, a helper program called "Mupmate" is provided.
29 The Mupmate program helps lead you through some of the steps,
30 and you can easily access this User's Guide from its Help menu.
36 Mupmate is currently only supported on Windows and Linux.
37 However, since the source code is
38 available, and it is based on the cross-platform FLTK toolkit, it
39 would probably be fairly easy to make it run on any system supported by FLTK.
42 Once you have installed Mup and Mupmate on Windows, double clicking
43 a .mup file in Windows explorer will run Mupmate on that file.
44 Or, you can run Mupmate by going to the Start menu, and choosing
45 Programs, then Arkkra, and then Mupmate. If you would like an icon
46 on the desktop, you can create one by right clicking the Mupmate choice
47 in the Arkkra menu, choosing "copy",
48 right clicking somewhere on the desktop, and choosing "paste".
51 On Linux, you can just type the mupmate command in a terminal window,
52 optionally followed by the name of a Mup input file.
53 Or you can add mupmate to your favorite window manager's menus.
56 Mupmate provides five top level menus: File, Edit, Run, Config, and Help.
57 The File menu provides commands for opening new files and saving the
58 file you are working on, as well as exiting the program. The Edit menu
59 provides the kinds of things you would expect in a editor: commands to find
60 a pattern, or find and replace; to select text; to copy, cut, and paste;
61 to go to a specific line; and to undo the previous operation, if you make
62 a mistake or change you mind.
63 The Run menu lets you set runtime options,
64 and then run the Mup program on your input in various
65 ways. You can either just generate a PostScript or MIDI file,
66 or display the PostScript or play the MIDI.
67 The Config menu lets you specify what application program you want
68 to use to view PostScript files and which you want to use to play MIDI files,
69 and well as specify locations for other Mup files. Mupmate will try to
70 find reasonable default values, but you may want to check that they are
71 what you want, and tweak them if they aren't.
72 The Config menu also provides a way for you to fill in the Mup registration
73 form if you wish to send in a paper form rather than registering online
74 via credit card, as well as a place to entry the registration key you
75 will receive once you have paid.
76 The Help menu lets you browse this User's Guide, view some startup hints,
77 or see the current version number of Mup and Mupmate.
80 Mupmate does not directly provide a print facility. Almost any PostScript
81 viewer already provides this ability, so you can simply select "Display"
82 from the Run menu and use the viewer's print capabilities.
83 Alternately you can use "Write PostScript File" from the Run menu
84 to create a PostScript file that you can print as you would any other
88 <A HREF="basics.html"><-- previous page</A> <A HREF="index.html">Table of Contents</A> <A HREF="cmdargs.html">next page --></A>
~mdw / mup / blob