1mupmate(1)                  General Commands Manual                 mupmate(1)
2
3
4

NAME

6       mupmate - user interface for Mup music publisher
7

SYNOPSIS

9       mupmate [file]
10

DESCRIPTION

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

SEE ALSO

70       gs(1), mup(1).
71       Mup — Music Publisher User's Guide
72

CAVEATS

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)
Impressum