| 1 | <HTML> |
| 2 | <HEAD><TITLE> |
| 3 | Running Mup |
| 4 | </TITLE></HEAD> |
| 5 | <BODY> |
| 6 | <P> |
| 7 | <A HREF="basics.html"><-- previous page</A> |
| 8 | |
| 9 | <A HREF="index.html">Table of Contents</A> <A HREF="cmdargs.html">next page --></A> |
| 10 | </P> |
| 11 | |
| 12 | <H1> |
| 13 | RUNNING MUP |
| 14 | </H1> |
| 15 | <P> |
| 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. |
| 20 | </P> |
| 21 | <P> |
| 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. |
| 31 | </P> |
| 32 | <H2> |
| 33 | Mupmate |
| 34 | </H2> |
| 35 | <P> |
| 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. |
| 40 | </P> |
| 41 | <P> |
| 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". |
| 49 | </P> |
| 50 | <P> |
| 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. |
| 54 | </P> |
| 55 | <P> |
| 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. |
| 78 | </P> |
| 79 | <P> |
| 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 |
| 85 | PostScript file. |
| 86 | </P> |
| 87 | <HR><P> |
| 88 | <A HREF="basics.html"><-- previous page</A> <A HREF="index.html">Table of Contents</A> <A HREF="cmdargs.html">next page --></A> |
| 89 | </P> |
| 90 | </BODY></HTML> |