XDITVIEW(1)

💖 XDITVIEW 💖

okay bestie, so you know xditview? it's the lil' program from the General Commands Manual (that's the manual we're in rn, section 1, the "run this in your shell" section 💅). it displays ditroff output on your screen. yes queen, it's giving "viewer but make it troff". let's get into it 🎀

---

✨ NAME ✨

xditview — display ditroff output

no fr, that's literally it. it shows ditroff output. iconic behavior.

---

🌸 SYNOPSIS 🌸

xditview [ -toolkitoption ... ] [ -option ... ] [ filename ]

she takes toolkit options, her own options, and a filename. all optional, all cute. 💖

---

🦋 DESCRIPTION 🦋

The xditview program displays ditroff output on an X display. 🖥️

it uses no special metrics and automatically converts the printer coordinates into screen coordinates — and here's the tea 🍵 — it uses the user-specified screen resolution, not the actual resolution, so that the appropriate fonts can be found. so you tell it the resolution, it goes off with that. periodt.

if - is given as the filename, xditview reads from standard input. 📥

if | is the first character of filename, xditview forks sh to run the rest of the "file name" and uses the standard output of that command. lowkey unhinged, highkey useful 🫶

---

💅 OPTIONS 💅

Xditview accepts all of the standard X Toolkit command line options along with the additional options listed below:

• -page page-number — This option specifies the page number of the document to be displayed at start up time. 📄
• -resolution screen-resolution — This specifies the desired screen resolution to use; fonts will be opened by requesting this resolution field in the XLFD names. 🔍
• -noPolyText — Some X servers incorrectly implement PolyText with multiple strings per request. This option suppresses the use of this feature in xditview. 💀 (server girlies be buggin)
• -backingStore backing-store-type — Redisplay can take up to a second or so 😭; this option causes the server to save the window contents so that when it is scrolled around the viewport, the window is painted from contents saved in backing store. backing-store-type can be one of Always, WhenMapped or NotUseful.

The following standard X Toolkit command line arguments are commonly used with xditview:

• -bg color — This option specifies the color to use for the background of the window. The default is white.
• -bd color — This option specifies the color to use for the border of the window. The default is black.
• -bw number — This option specifies the width in pixels of the border surrounding the window.
• -fg color — This option specifies the color to use for displaying text. The default is black.
• -fn font — This option specifies the font to be used for displaying widget text. The default is fixed.
• -rv — This option indicates that reverse video should be simulated by swapping the foreground and background colors. 🌗
• -geometry geometry — This option specifies the preferred size and position of the window. 📐
• -display host:display — This option specifies the X server to contact.
• -xrm resourcestring — This option specifies a resource string to be used.

---

👑 X DEFAULTS 👑

This program uses a Dvi widget. It understands all of the core resource names and classes as well as:

• width (class Width) — Specifies the width of the window.
• height (class Height) — Specifies the height of the window.
• foreground (class Foreground) — Specifies the default foreground color.
• font (class Font) — Specifies the font to be used for error messages. 🚨
• FontMap (class FontMap) — To associate the ditroff fonts with appropriate X fonts, this string resource contains a set of new-line separated specifications, each of which consists of a ditroff name, some white space and an XLFD pattern with * characters in appropriate places to allow all sizes to be listed. The default fontMap is:

R    -*-times-medium-r-normal--*-*-*-*-*-*-iso8859-1\n\
I    -*-times-medium-i-normal--*-*-*-*-*-*-iso8859-1\n\
B    -*-times-bold-r-normal--*-*-*-*-*-*-iso8859-1\n\
F    -*-times-bold-i-normal--*-*-*-*-*-*-iso8859-1\n\
BI   -*-times-bold-i-normal--*-*-*-*-*-*-iso8859-1\n\
C    -*-courier-medium-r-normal--*-*-*-*-*-*-iso8859-1\n\
CO   -*-courier-medium-o-normal--*-*-*-*-*-*-iso8859-1\n\
CB   -*-courier-bold-r-normal--*-*-*-*-*-*-iso8859-1\n\
CF   -*-courier-bold-o-normal--*-*-*-*-*-*-iso8859-1\n\
H    -*-helvetica-medium-r-normal--*-*-*-*-*-*-iso8859-1\n\
HO   -*-helvetica-medium-o-normal--*-*-*-*-*-*-iso8859-1\n\
HB   -*-helvetica-bold-r-normal--*-*-*-*-*-*-iso8859-1\n\
HF   -*-helvetica-bold-o-normal--*-*-*-*-*-*-iso8859-1\n\
N    -*-new century schoolbook-medium-r-normal--*-*-*-*-*-*-iso8859-1\n\
NI   -*-new century schoolbook-medium-i-normal--*-*-*-*-*-*-iso8859-1\n\
NB   -*-new century schoolbook-bold-r-normal--*-*-*-*-*-*-iso8859-1\n\
NF   -*-new century schoolbook-bold-i-normal--*-*-*-*-*-*-iso8859-1\n\
A    -*-charter-medium-r-normal--*-*-*-*-*-*-iso8859-1\n\
AI   -*-charter-medium-i-normal--*-*-*-*-*-*-iso8859-1\n\
AB   -*-charter-bold-r-normal--*-*-*-*-*-*-iso8859-1\n\
AF   -*-charter-bold-i-normal--*-*-*-*-*-*-iso8859-1\n\
S    -*-symbol-medium-r-normal--*-*-*-*-*-*-adobe-fontspecific\n\
S2   -*-symbol-medium-r-normal--*-*-*-*-*-*-adobe-fontspecific\n

like, that's the whole map, no skips, we don't gatekeep fonts here 🌈

---

🌟 USING XDITVIEW WITH DITROFF 🌟

You can use any ditroff output file with xditview, although files which use the fonts appropriate to the fontMap will look more accurate on the screen. ✨

On servers which support scaled fonts, all requested font sizes will be accurately reflected on the screen; for servers which do not support scaled, xditview will use the closest font from the same family. (she does her best, okay 😭💖)

---

🔍 SEE ALSO 🔍

X(7), xrdb(1), ditroff(1), X Logical Font Description Conventions

go read those too, bestie, it's giving ✨well-rounded✨ 📚

---

🧚 ORIGIN 🧚

Portions of this program originated in xtroff which was derived from suntroff. the ancestry is real, the lineage is slaying 👑

---

💜 AUTHORS 💜

• Keith Packard (MIT X Consortium)
• Richard L. Hyde (Purdue)
• David Slattengren (Berkeley)
• Malcom Slaney (Schlumberger Palo Alto Research)
• Mark Moraes (University of Toronto)

the founding mothers... well, founding fathers, but they ate regardless 🫶🏆

---

and that's the whole page, bestie!! 💖 this was X Version 11, xditview 1.0.6 — literally the moment, the era, the vibe. if you're reading this on the XDITVIEW(1) page, hi, you're doing amazing, drink some water, go view some ditroff 🎀✨💅