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

   1 .TH mupdisp 1 "November 4, 2006" "Arkkra Enterprises"
   2 .SH NAME
   3 .PP
   4 mupdisp - display output from Mup music publisher program
   5 .SH SYNOPSIS
   6 .PP
   7 mupdisp \fI[mup_options] file\fP
   8 .SH DESCRIPTION
   9 .PP
  10 Mupdisp provides a way to view Mup output on your screen.
  11 The \fIfile\fP is Mup input. Any other Mup options can be given,
  12 except -f, -m, -M, -r, or -v, which don't produce print output.
  13 .PP
  14 Mupdisp will run under MS-DOS or will run under
  15 UNIX with a TERM of AT386, linux, or xterm (under X windows).
  16 .PP
  17 When running under X windows, several standard X options are
  18 available:
  19 .TP
  20 \fB-geometry\fP \fIXxY+M+N\fP
  21 Sets the window size and/or location on the screen. The actual window
  22 width will be determined by the width of the Mup output. The height
  23 will be adjusted if necessary to be between 400 and the actual height
  24 of the Mup output. The window placment specifications can be positive
  25 or negative. The actual placement may be adjusted by your window manager.
  26 .TP
  27 \fB-fg\fP \fIcolor\fP or \fB-foreground\fP \fIcolor\fP
  28 Specifies the foreground color to use.
  29 .TP
  30 \fB-bg\fP \fIcolor\fP or \fB-background\fP \fIcolor\fP
  31 Specifies the background color to use.
  32 .PP
  33 These X options can also be set in your .Xdefaults file using resource names of
  34 mupdisp.geometry, mupdisp.foreground, and mupdisp.background. Command
  35 line arguments will override values in the .Xdefaults file.
  36 As an example, you could add these lines to your .Xdefaults file:
  37 .nf
  38 .na
  39 .ft CW
  40 .in +1i
  41
  42 mupdisp.foreground:   navy
  43 mupdisp.background:   gray
  44 mupdisp.geometry:     400x760+100-34
  45
  46 .in -1i
  47 .ft P
  48 .fi
  49 .ad
  50 .PP
  51 The Mupdisp program begins in partial page mode,
  52 which displays output at approximately actual size (depending
  53 on the size of your monitor). In this mode, most likely
  54 not all of the page fits on the
  55 screen, so the scrolling commands can be used to move up and down to view
  56 different parts of the page. In full page mode, a small version of the
  57 entire page is displayed.  This is useful
  58 for seeing overall page layout, but is generally too small to see much detail.
  59 This mode is now somewhat of a relic of the days when screens were typically
  60 much smaller than they are today, and is thus becoming less useful.
  61 .PP
  62 If the environment variable MUPDISPMODE is set to some value,
  63 Mupdisp will start in full page rather than partial page mode.
  64 .PP
  65 The commands are:
  66 .TP
  67 \fInum\fP<Enter>
  68 Go to page number \fInum\fP.
  69 .TP
  70 + or <space> or <control-E> or <control-F>
  71 move forward on the page by about 1/8 of an inch
  72 (partial page mode only)
  73 .TP
  74 - or <backspace> or <control-Y> or <control-B>
  75 move backward on the page by about 1/8 of an inch
  76 (partial page mode only)
  77 .TP
  78 b or <control-U> or <control-P> or <up-arrow-key>
  79 move backward on the page by about an inch
  80 (partial page mode only)
  81 .TP
  82 f or <Enter> or <control-D> or <control-N> or <down-arrow-key>
  83 move forward on the page by about an inch
  84 (partial page mode only)
  85 .TP
  86 h or ?
  87 display help screen
  88 .TP
  89 m
  90 toggle between partial page and full page modes.
  91 .TP
  92 n or <PageDown>
  93 go to next page
  94 .TP
  95 p or <PageUp>
  96 go to previous page
  97 .TP
  98 q or ZZ
  99 quit
 100 .TP
 101 r
 102 Repaint the page (useful for exiting help page)
 103 .PP
 104 When in X windows, the mouse can be used for scrolling. The left button scrolls
 105 downward like the f command, while the right button scrolls backwards like
 106 the b command.
 107 .PP
 108 Mupdisp supports page sizes of letter (8.5 x 11.0 inches),
 109 note (7.5 x 10.0 inches), legal (8.5 x 14.0 inches),
 110 A4 (8.26 x 11.69 inches), A5 (5.85 x 8.26 inches),
 111 A6 (4.125 x 5.85 inches), flsa (8.5 x 13.0 inches), and
 112 halfletter (5.5 x 8.5 inches).
 113 .SH FILES
 114 .P
 115 $HOME/.Xdefaults   default X window resource definitions
 116 .SH "SEE ALSO"
 117 .PP
 118 gs(1), mup(1), mupmate(1), mupprnt(1).
 119 .br
 120 Mup \(em Music Publisher User's Guide
 121 .SH "CAVEATS AND BUGS"
 122 .PP
 123 You must have mup in your PATH.
 124 You must have ghostscript (gs or gs386.exe) in your PATH
 125 and it must be built to include the "bit" device.
 126 .PP
 127 Resizing the window does not resize the full page view.