mupdisp(1)

💖 NAME 💖

mupdisp — the girl who shows you what Mup just cooked up, straight on your screen 🎀

---

✨ SYNOPSIS ✨

mupdisp [mup_options] file

---

🦋 DESCRIPTION 🦋

okay so bestie, Mupdisp is literally just a way to view your Mup output on your screen instead of printing it out like it's 1997. The file you hand it is Mup input, and yes you can pass any other Mup options along with it too — EXCEPT -C, -E, -f, -F, -l, -m, -M, or -v, because those ones don't produce print output, so there's nothing to display. no cap, just no page. 💀

Mupdisp runs under MS‐DOS, or under UNIX with a TERM of AT386, linux, or xterm (that last one under X windows, iykyk). 🌈

---

🪟 X windows options (the standard ones, she's iconic)

• -geometry XxY+M+N — sets the window size and/or where it sits on your screen. The actual window width gets determined by the width of the Mup output, and the height gets adjusted if it needs to be, so it lands between 400 and the actual height of the Mup output. The window placement specs can be positive or negative, and your window manager may adjust the actual placement anyway because it's the main character. 🙈
• -fg color or -foreground color — says which foreground color to use. 💅
• -bg color or -background color — says which background color to use. 🎨

These X options can also live in your .Xdefaults file using the resource names mupdisp.geometry, mupdisp.foreground, and mupdisp.background. Command line arguments override whatever's in the .Xdefaults file — she said what she said. Periodt.

As an example, you could add these lines to your .Xdefaults file:

mupdisp.foreground:   navy
mupdisp.background:   gray
mupdisp.geometry:     400x760+100-34

---

📖 Page modes, a whole vibe

The Mupdisp program begins in partial page mode, which displays output at approximately actual size (depending on how big your monitor is, so your mileage may vary). In this mode it may be that not all of the page fits on the screen, so the scrolling commands can be used to move up and down and peek at different parts of the page. 🦋

In full page mode, a small version of the entire page is displayed. This is useful for seeing the overall page layout, but it's generally too small to see much detail. This mode is now somewhat of a relic of the days when screens were typically much smaller than they are today, and is thus becoming less useful. she's aging gracefully but she's aging. 😭

If the environment variable MUPDISPMODE is set to some value, Mupdisp will start in full page rather than partial page mode. 💫

---

⌨️ The commands (memorize these, bestie)

• num<Enter> — go to page number num.
• + or <space> or <control‐E> or <control‐F> — move forward on the page by about 1/8 of an inch (partial page mode only)
• - or <backspace> or <control‐Y> or <control‐B> — move backward on the page by about 1/8 of an inch (partial page mode only)
• b or <control‐U> or <control‐P> or <up‐arrow‐key> — move backward on the page by about an inch (partial page mode only)
• f or <Enter> or <control‐D> or <control‐N> or <down‐arrow‐key> — move forward on the page by about an inch (partial page mode only)
• h or ? — display help screen
• m — toggle between partial page and full page modes. 💫
• n or <PageDown> — go to next page
• p or <PageUp> — go to previous page
• q or ZZ — quit (bye bestie 🫶)
• r — repaint the page (useful for exiting help page)

---

🖱️ Mouse girlies

When in X windows, the mouse can be used for scrolling. The left button scrolls downward like the f command, while the right button scrolls backwards like the b command. iconic honestly. 👑

---

📏 Page sizes she supports

Mupdisp supports page sizes of:

• letter (8.5 x 11.0 inches)
• note (7.5 x 10.0 inches)
• legal (8.5 x 14.0 inches)
• A4 (8.26 x 11.69 inches)
• A5 (5.85 x 8.26 inches)
• A6 (4.125 x 5.85 inches)
• flsa (8.5 x 13.0 inches)
• halfletter (5.5 x 8.5 inches)

---

🎀 FILES 🎀

• $HOME/.Xdefaults — default X window resource definitions ✨

---

🌸 SEE ALSO 🌸

gs(1), mup(1), mupmate(1), mupprnt(1).

Mup — Music Publisher User's Guide

---

💀 CAVEATS AND BUGS 💀

bestie listen. You must have mup in your PATH. You must have ghostscript (gs or gs386.exe) in your PATH, and it must be built to include the "bit" device. no bit device, no display. that's just the rules. 😭

Also: resizing the window does not resize the full page view. she's stubborn like that. 💅

---

mupdisp(1) — General Commands Manual — brought to you by Arkkra Enterprises, dated November 22, 2012. that's the whole page, ily, go read some sheet music 💖🎵✨