~mdw / mup / blame
| Commit | Line | Data |
|---|---|---|
| 69695f33 MW |
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> |