chiark - git - mdw - mup/blob - mup/docs/mupmate.1

   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.