Commit | Line | Data |
---|---|---|
69695f33 MW |
1 | .TH mupmate 1 "November 4, 2006" "Arkkra Enterprises" |
2 | .SH NAME | |
3 | .PP | |
4 | mupmate - user interface for Mup music publisher | |
5 | .SH SYNOPSIS | |
6 | .PP | |
7 | mupmate [\fIfile\fP] | |
8 | .SH DESCRIPTION | |
9 | .PP | |
10 | .P | |
11 | You can create a Mup file using any ordinary text editor. | |
12 | On Windows, Notepad is a typical choice; on Linux, editors like | |
13 | vim and emacs are commonly used. But if you prefer to be able to | |
14 | edit, display, and play from a single integrated and more graphical | |
15 | interface, a helper program called "mupmate" is provided. Mupmate is currently | |
16 | only supported on Windows and Linux. However, since the source code is | |
17 | available, and it is based on the cross-platform FLTK toolkit, it | |
18 | can probably be made to run on any system supported by FLTK fairly easily. | |
19 | If you prefer to use the Mup program directly rather than via mupmate, | |
20 | you can. The Mupmate program just helps lead you through some of the steps. | |
21 | .PP | |
22 | Once you have installed Mup and Mupmate on Windows, double clicking | |
23 | a .mup file in Windows explorer will run Mupmate on that file. | |
24 | Or, you can run Mupmate by going to the Start menu, and choosing | |
25 | Programs, then Arkkra, and then Mupmate. If you would like an icon | |
26 | on the desktop, you can create one by right clicking | |
27 | the Mupmate choice in the Arkkra menu, | |
28 | choosing "copy", right clicking somewhere on the desktop, and choosing "paste." | |
29 | .PP | |
30 | On Linux, you can just type the mupmate command, | |
31 | optionally followed by the name of a Mup input file. | |
32 | Or you can add mupmate to your favorite window manager's menus. | |
33 | .P | |
34 | Mupmate provides five top level menus: File, Edit, Run, Config, and Help. | |
35 | The File menu provides commands for opening new files and saving the | |
36 | file you are working on, as well as exit the program. The Edit menu | |
37 | provides the kinds of things you would expect in a editor: commands to find | |
38 | a pattern, or find and replace; to select text; to copy, cut, and paste; | |
39 | to go to a specific line; and to undo the previous operation, if you make | |
40 | a mistake or change you mind. | |
41 | The Run menu lets you set runtime options, | |
42 | and then run the Mup program on your input in various | |
43 | ways. You can either just generate a PostScript or MIDI file, | |
44 | or display the PostScript or play the MIDI. | |
45 | The Config menu lets you specify what application program you want | |
46 | to use to view PostScript files and which you want to use to play MIDI files, | |
47 | and well as specify locations for other Mup files. Mupmate will try to | |
48 | find reasonable default values, but you may want to check that they are | |
49 | what you want, and tweak them if they aren't. | |
50 | The Config menu also provides a way for you to fill in the Mup registration | |
51 | form if you wish to send in a paper form rather than registering online | |
52 | via credit card, as well as a place to entry the registration key you | |
53 | will receive once you have paid. | |
54 | The Help menu lets you browse the Mup User's Guide, view some startup hints, | |
55 | or see the current version number of Mup and Mupmate. | |
56 | .SH "SEE ALSO" | |
57 | .PP | |
58 | gs(1), mup(1). | |
59 | .br | |
60 | Mup \(em Music Publisher User's Guide | |
61 | .SH "CAVEATS" | |
62 | .PP | |
63 | Mupmate is currently only supported on Windows and Linux or similar. | |
64 | .PP | |
65 | Mupmate does not directly provide a print facility. Almost any PostScript | |
66 | viewer already provides this ability, so you can simply select "Display" | |
67 | from the Run menu and use the viewer's print capabilities. | |
68 | Alternately you can use the "Write PostScript File" from the Run menu | |
69 | and then print the resulting file. |