Commit | Line | Data |
---|---|---|
69695f33 MW |
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. |