1 files changed, 361 insertions, 0 deletions
diff --git a/vendor/x11iraf/doc/xtapemon.ps b/vendor/x11iraf/doc/xtapemon.ps
new file mode 100644
index 00000000..bab4ba17
--- /dev/null
+++ b/vendor/x11iraf/doc/xtapemon.ps
@@ -0,0 +1,361 @@
+%!PS-Adobe-3.0
+%%Creator: groff version 1.09
+%%CreationDate: Sat Apr  5 14:54:31 1997
+%%DocumentNeededResources: font Times-Roman
+%%+ font Times-Bold
+%%+ font Times-Italic
+%%DocumentSuppliedResources: procset grops 1.09 0
+%%Pages: 2
+%%PageOrder: Ascend
+%%Orientation: Portrait
+%%EndComments
+%%BeginProlog
+%%BeginResource: procset grops 1.09 0
+/setpacking where{
+pop
+currentpacking
+true setpacking
+}if
+/grops 120 dict dup begin
+/SC 32 def
+/A/show load def
+/B{0 SC 3 -1 roll widthshow}bind def
+/C{0 exch ashow}bind def
+/D{0 exch 0 SC 5 2 roll awidthshow}bind def
+/E{0 rmoveto show}bind def
+/F{0 rmoveto 0 SC 3 -1 roll widthshow}bind def
+/G{0 rmoveto 0 exch ashow}bind def
+/H{0 rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
+/I{0 exch rmoveto show}bind def
+/J{0 exch rmoveto 0 SC 3 -1 roll widthshow}bind def
+/K{0 exch rmoveto 0 exch ashow}bind def
+/L{0 exch rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
+/M{rmoveto show}bind def
+/N{rmoveto 0 SC 3 -1 roll widthshow}bind def
+/O{rmoveto 0 exch ashow}bind def
+/P{rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
+/Q{moveto show}bind def
+/R{moveto 0 SC 3 -1 roll widthshow}bind def
+/S{moveto 0 exch ashow}bind def
+/T{moveto 0 exch 0 SC 5 2 roll awidthshow}bind def
+/SF{
+findfont exch
+[exch dup 0 exch 0 exch neg 0 0]makefont
+dup setfont
+[exch/setfont cvx]cvx bind def
+}bind def
+/MF{
+findfont
+[5 2 roll
+0 3 1 roll 
+neg 0 0]makefont
+dup setfont
+[exch/setfont cvx]cvx bind def
+}bind def
+/level0 0 def
+/RES 0 def
+/PL 0 def
+/LS 0 def
+/PLG{
+gsave newpath clippath pathbbox grestore
+exch pop add exch pop
+}bind def
+/BP{
+/level0 save def
+1 setlinecap
+1 setlinejoin
+72 RES div dup scale
+LS{
+90 rotate
+}{
+0 PL translate
+}ifelse
+1 -1 scale
+}bind def
+/EP{
+level0 restore
+showpage
+}bind def
+/DA{
+newpath arcn stroke
+}bind def
+/SN{
+transform
+.25 sub exch .25 sub exch
+round .25 add exch round .25 add exch
+itransform
+}bind def
+/DL{
+SN
+moveto
+SN
+lineto stroke
+}bind def
+/DC{
+newpath 0 360 arc closepath
+}bind def
+/TM matrix def
+/DE{
+TM currentmatrix pop
+translate scale newpath 0 0 .5 0 360 arc closepath
+TM setmatrix
+}bind def
+/RC/rcurveto load def
+/RL/rlineto load def
+/ST/stroke load def
+/MT/moveto load def
+/CL/closepath load def
+/FL{
+currentgray exch setgray fill setgray
+}bind def
+/BL/fill load def
+/LW/setlinewidth load def
+/RE{
+findfont
+dup maxlength 1 index/FontName known not{1 add}if dict begin
+{
+1 index/FID ne{def}{pop pop}ifelse
+}forall
+/Encoding exch def
+dup/FontName exch def
+currentdict end definefont pop
+}bind def
+/DEFS 0 def
+/EBEGIN{
+moveto
+DEFS begin
+}bind def
+/EEND/end load def
+/CNT 0 def
+/level1 0 def
+/PBEGIN{
+/level1 save def
+translate
+div 3 1 roll div exch scale
+neg exch neg exch translate
+0 setgray
+0 setlinecap
+1 setlinewidth
+0 setlinejoin
+10 setmiterlimit
+[]0 setdash
+/setstrokeadjust where{
+pop
+false setstrokeadjust
+}if
+/setoverprint where{
+pop
+false setoverprint
+}if
+newpath
+/CNT countdictstack def
+userdict begin
+/showpage{}def
+}bind def
+/PEND{
+clear
+countdictstack CNT sub{end}repeat
+level1 restore
+}bind def
+end def
+/setpacking where{
+pop
+setpacking
+}if
+%%EndResource
+%%IncludeResource: font Times-Roman
+%%IncludeResource: font Times-Bold
+%%IncludeResource: font Times-Italic
+grops begin/DEFS 1 dict def DEFS begin/u{.001 mul}bind def end/RES 72
+def/PL 792 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron/Zcaron
+/scaron/zcaron/Ydieresis/trademark/quotesingle/.notdef/.notdef/.notdef
+/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef
+/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef
+/.notdef/.notdef/space/exclam/quotedbl/numbersign/dollar/percent
+/ampersand/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen
+/period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon
+/semicolon/less/equal/greater/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O
+/P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/backslash/bracketright/circumflex
+/underscore/quoteleft/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y
+/z/braceleft/bar/braceright/tilde/.notdef/quotesinglbase/guillemotleft
+/guillemotright/bullet/florin/fraction/perthousand/dagger/daggerdbl
+/endash/emdash/ff/fi/fl/ffi/ffl/dotlessi/dotlessj/grave/hungarumlaut
+/dotaccent/breve/caron/ring/ogonek/quotedblleft/quotedblright/oe/lslash
+/quotedblbase/OE/Lslash/.notdef/exclamdown/cent/sterling/currency/yen
+/brokenbar/section/dieresis/copyright/ordfeminine/guilsinglleft
+/logicalnot/minus/registered/macron/degree/plusminus/twosuperior
+/threesuperior/acute/mu/paragraph/periodcentered/cedilla/onesuperior
+/ordmasculine/guilsinglright/onequarter/onehalf/threequarters
+/questiondown/Agrave/Aacute/Acircumflex/Atilde/Adieresis/Aring/AE
+/Ccedilla/Egrave/Eacute/Ecircumflex/Edieresis/Igrave/Iacute/Icircumflex
+/Idieresis/Eth/Ntilde/Ograve/Oacute/Ocircumflex/Otilde/Odieresis
+/multiply/Oslash/Ugrave/Uacute/Ucircumflex/Udieresis/Yacute/Thorn
+/germandbls/agrave/aacute/acircumflex/atilde/adieresis/aring/ae/ccedilla
+/egrave/eacute/ecircumflex/edieresis/igrave/iacute/icircumflex/idieresis
+/eth/ntilde/ograve/oacute/ocircumflex/otilde/odieresis/divide/oslash
+/ugrave/uacute/ucircumflex/udieresis/yacute/thorn/ydieresis]def
+/Times-Italic@0 ENC0/Times-Italic RE/Times-Bold@0 ENC0/Times-Bold RE
+/Times-Roman@0 ENC0/Times-Roman RE
+%%EndProlog
+%%Page: 1 1
+%%BeginPageSetup
+BP
+%%EndPageSetup
+/F0 10/Times-Roman@0 SF(XT)72 48 Q 332.94(APEMON\(1\) XT)-.93 F
+(APEMON\(1\))-.93 E/F1 9/Times-Bold@0 SF -.18(NA)72 84 S(ME).18 E F0(XT)
+108 96 Q
+(apemon \255 magtape I/O status monitor and display utility for IRAF)-.8
+E F1(SYNOPSIS)72 112.8 Q/F2 10/Times-Bold@0 SF(xtapemon)108 124.8 Q F0
+<5bad>2.5 E/F3 10/Times-Italic@0 SF(toolkitoption)A F0(...] [)2.5 E F3
+(-port)2.5 E F0(<port> ] [)2.5 E F3<ad61>2.5 E F0 2.5(][)2.5 G F3(-d)A
+F0(])2.5 E F1(OPTIONS)72 141.6 Q F0(In addition to the X T)108 153.6 Q
+(oolkit options, the follo)-.8 E(wing are supported:)-.25 E F2(-port)108
+170.4 Q F3(port)2.5 E F0
+(Set the primary port to listen on for client connections.)133 182.4 Q
+(The def)5 E(ault is 5138.)-.1 E F2(-a)108 199.2 Q F0
+(Listen on alternate port, this is the primary port number plus one.)
+16.67 E(The def)5 E(ault is 5139.)-.1 E F2(-d)108 216 Q F0(Deb)16.11 E
+(ug mode, pass client message to the standard out.)-.2 E(The def)5 E
+(ault is f)-.1 E(alse.)-.1 E F1 2.25(XR)72 244.8 S(ESOURCES)-2.25 E F2
+(XT)108 256.8 Q(apemon)-.92 E F0 .551
+(options can appear on the command line or in your X resource \214le.)
+3.051 F .55(Options on the command)5.55 F(line supercede v)108 268.8 Q
+(alues speci\214ed in your X resource \214le.)-.25 E F2(port)108 297.6 Q
+F0(Set the primary port to listen on for client connections.)41.67 E
+(The def)5 E(ault is 5138.)-.1 E F2(alter)108 314.4 Q(nate)-.15 E F0
+(Listen on alternate port, this is the primary port number plus one.)
+21.83 E(The def)5 E(ault is 5139.)-.1 E F2(deb)108 331.2 Q(ug)-.2 E F0
+(Deb)34.08 E(ug mode, pass client message to the standard out.)-.2 E
+(The def)5 E(ault is f)-.1 E(alse.)-.1 E F1(DESCRIPTION)72 348 Q F0 .68
+(Xtapemon is a magtape status monitor and display utility)108 360 R 5.68
+(.Y)-.65 G .681(ou use it to display the status of a IRAF tape)-6.78 F
+.746(job while it is running.)108 372 R .746(TCP/IP sock)5.746 F .746
+(ets are used for communication, so the IRAF tape job and xtapemon)-.1 F
+.984(may be on the same host machine or on dif)108 384 R .984
+(ferent hosts.)-.25 F .985(All V2.10 v)5.985 F .985
+(ersions of IRAF support tape status)-.15 F 1.018(output \(including e)
+108 396 R -.15(ve)-.25 G 3.517(nV).15 G 3.517(MS/IRAF\). F)-3.517 F
+1.017(or e)-.15 F 1.017(xample, suppose our w)-.15 F 1.017
+(orkstation is named)-.1 F F3(cygnus)3.517 E F0 1.017(and we are)3.517 F
+(running IRAF on host)108 408 Q F3 -.37(re)2.5 G(gulus)-.03 E F0 2.5(,u)
+C(sing magtape de)-2.5 E(vice mta.)-.25 E
+(The \214rst step is to start xtapemon on c)5 E(ygnus:)-.15 E 2.5(%x)128
+432 S(tapemon &)-2.5 E(Then in IRAF on re)108 456 Q
+(gulus we might do the follo)-.15 E(wing:)-.25 E
+(cl> set tapecap = ":so=c)128 480 Q(ygnus")-.15 E(cl> allocate mta)128
+492 Q(cl> re)128 504 Q(wind mta)-.25 E .578
+(At this point the IRAF magtape i/o dri)108 528 R -.15(ve)-.25 G 3.078
+(re).15 G -.15(xe)-3.228 G .578(cuting on re).15 F .579
+(gulus should open a connection to the xtapemon)-.15 F
+(tape monitoring serv)108 540 Q(er running on c)-.15 E
+(ygnus, and indicate that a re)-.15 E(wind operation is taking place.)
+-.25 E .781(If both xtapemon and the IRAF tape job are running on the s\
+ame host then the hostname can be omitted,)108 564 R .552
+(e.g. "set tapecap = :so".)108 576 R .553
+(The use of "set tapecap" assumes that the def)5.552 F .553
+(ault IRAF tapecap is being used.)-.1 F(If)5.553 E(the user has a pri)
+108 588 Q -.25(va)-.25 G(te tapecap, the syntax is).25 E
+(cl> set tapecap = "<my-tapecap-\214le>:so=hostname")128 612 Q .247
+(In general you can append an)108 636 R 2.747(yn)-.15 G .247
+(umber of tapecap de)-2.747 F .247(vice capability o)-.25 F -.15(ve)-.15
+G .247(rrides \(the :xx \214elds\) to the tapecap).15 F(en)108 648 Q
+(vironment speci\214cation.)-.4 E(Alternati)5 E -.15(ve)-.25 G(ly).15 E
+2.5(,t)-.65 G(he :so can be speci\214ed on the command line, e.g.)-2.5 E
+(cl> re)128 672 Q(wind "mta[:so=c)-.25 E(ygnus]")-.15 E
+(But in general it will be more con)108 696 Q -.15(ve)-.4 G
+(nient to use set tapecap.).15 E .251(It is safe to ha)108 720 R .551
+-.15(ve :)-.2 H .251(so \(status output\) enabled e).15 F -.15(ve)-.25 G
+2.751(ni).15 G 2.751(ft)-2.751 G .252(here is no xtapemon serv)-2.751 F
+2.752(er; IRAF)-.15 F .252(will try to mak)2.752 F 2.752(et)-.1 G(he)
+-2.752 E(X11IRAF Project)72 768 Q(11 Dec 1996)137.62 E(1)203.45 E EP
+%%Page: 2 2
+%%BeginPageSetup
+BP
+%%EndPageSetup
+/F0 10/Times-Roman@0 SF(XT)72 48 Q 332.94(APEMON\(1\) XT)-.93 F
+(APEMON\(1\))-.93 E 1.227(connection b)108 84 R 1.227
+(ut will proceed without an)-.2 F 3.727(yi)-.15 G 1.227
+(ndication of an error if the status output connection cannot be)-3.727
+F(established.)108 96 Q .013(The amount of tape read or written in Mb w\
+ill be accurate only if the IRAF magtape dri)108 132 R -.15(ve)-.25 G
+2.514(ra).15 G .014(ctually reads or)-2.514 F .073
+(writes all the data between the be)108 144 R .073
+(ginning of tape and the current position of the tape.)-.15 F .072
+(Hence, if one re)5.072 F(winds)-.25 E .184(the tape and then reads or \
+writes a number of tiles, the Mb used \214eld will be accurate.)108 156
+R .184(If ho)5.184 F(we)-.25 E -.15(ve)-.25 G 2.684(ro).15 G .184
+(ne does)-2.684 F 2.651(as)108 168 S .151(kip to a random \214le some)
+-2.651 F .151(where f)-.25 F .151(ar do)-.1 F .15
+(wn on the tape, IRAF will not ha)-.25 F .45 -.15(ve r)-.2 H .15
+(ead the data and the tape used).15 F .736
+(\214eld will indicate only the data actually read or written.)108 180 R
+-.15(Fo)5.737 G 3.237(re).15 G .737(xample, a re)-3.387 F .737
+(wind follo)-.25 F .737(wed by a)-.25 F/F1 10/Times-Italic@0 SF(mte)
+3.237 E(xamine)-.2 E F0 .267
+(will reliably indicate the actual amount of data on the tape, lea)108
+192 R .267(ving the tape positioned to EO)-.2 F 4.246 -.74(T. I)-.4 H
+2.766(fo).74 G .266(ne then)-2.766 F .696(appends ne)108 204 R 3.196
+<778c>-.25 G .696
+(les to the tape the tape used \214eld will still be accurate.)-3.196 F
+.696(If ho)5.696 F(we)-.25 E -.15(ve)-.25 G 3.196(ro).15 G .697
+(ne pops in a ne)-3.196 F 3.197(wt)-.25 G(ape)-3.197 E
+(and then appends a \214le at EO)108 216 Q 1.48 -.74(T, t)-.4 H
+(ape used will be in).74 E -.25(va)-.4 G(lid as the dri).25 E .3 -.15
+(ve w)-.25 H(ill rapidly skip forw).15 E(ard to the EO)-.1 E -.74(T.)-.4
+G/F2 9/Times-Bold@0 SF(AD)72 244.8 Q -1.215(VA)-.36 G(NCED USA)1.215 E
+(GE)-.495 E F0 .005(By def)108 256.8 R .004
+(ault xtapemon listens on the port 5138, called port A.)-.1 F .004
+(If when you start the xtapemon serv)5.004 F .004(er this port)-.15 F
+.048(is already b)108 268.8 R(usy)-.2 E 2.548(,x)-.65 G .048(tapemon wi\
+ll automatically switch to port B instead \(the alternate port, 5139\).)
+-2.548 F .049(This mak)5.049 F(es)-.1 E(it possible to monitor tw)108
+280.8 Q 2.5(ot)-.1 G(ape jobs at the same time.)-2.5 E .974(If you ha)
+108 304.8 R 1.274 -.15(ve x)-.2 H .973(tapemon serv).15 F .973
+(ers running on tw)-.15 F 3.473(op)-.1 G .973
+(orts it will be necessary to tell the second IRAF tape job)-3.473 F
+(what port to use, since the magtape dri)108 316.8 Q -.15(ve)-.25 G 2.5
+(rw).15 G(ill use port A by def)-2.5 E 2.5(ault. F)-.1 F(or e)-.15 E
+(xample,)-.15 E(cl> set tapecap = ":so=c)128 340.8 Q(ygnus,5139" or)-.15
+E(cl> mte)128 352.8 Q(xamine "mta[:so=,5139]")-.15 E 1.423
+(If there is some problem using the b)108 376.8 R 1.423(uiltin port def)
+-.2 F 1.423(aults you can use an)-.1 F 3.924(yp)-.15 G 1.424(ort you w)
+-3.924 F 3.924(ant. The)-.1 F(follo)3.924 E(wing)-.25 E
+(resources tell which port to use.)108 388.8 Q(XT)128 412.8 Q 58.7
+(apemon.port #)-.8 F(port A)2.5 E(XT)128 424.8 Q 40.38
+(apemon.alternate #)-.8 F(port B)2.5 E .146
+(Or you can specify the ports with the ar)108 448.8 R .145
+(gument "-port" or "-a" \(alternate\) on the command line when xtape-)
+-.18 F(mon is started.)108 460.8 Q F2 -.09(BU)72 477.6 S(GS).09 E F0
+-1.1(Yo)108 489.6 S 2.69(uc)1.1 G(an')-2.69 E 2.69(tn)-.18 G .19
+(ecessarily trust displayed information such as the de)-2.69 F .19
+(vice type and tape type.)-.25 F .19(On most platforms)5.19 F 1.002
+(this information is tak)108 501.6 R 1.001
+(en from the tapecap entry for the de)-.1 F 1.001(vice, and the accurac)
+-.25 F 3.501(yo)-.15 G 3.501(ft)-3.501 G 1.001(his information will)
+-3.501 F .87
+(depend upon the diligence of your IRAF system adminstrator when the)108
+513.6 R 3.37(yc)-.15 G .87(on\214gured tapecap for your site)-3.37 F
+(\(and on whether you use the correct logical de)108 525.6 Q
+(vice name for the dri)-.25 E .3 -.15(ve a)-.25 H
+(nd tape capacity you are using\).).15 E .404(Xtapemon tries to k)108
+549.6 R .403
+(eep track of the amount of tape used: the number of Mb \(me)-.1 F -.05
+(ga)-.15 G .403(bytes\) read or written is).05 F 1.953
+(displayed, along with the percent of the tape used.)108 561.6 R 1.953
+(Whether or not the percent used \214eld is accurate)6.953 F .73
+(depends upon a number of f)108 573.6 R 3.23(actors. First)-.1 F .729
+(the tape capacity gi)3.23 F -.15(ve)-.25 G 3.229(ni).15 G 3.229(nt)
+-3.229 G .729(he tapecap \214le must match the actual)-3.229 F 1.336
+(tape being used.)108 585.6 R 1.336
+(Second, if data compression is in use on the dri)6.336 F -.15(ve)-.25 G
+3.837(,x).15 G 1.337(tapemon will display the uncom-)-3.837 F
+(pressed quantity of data written.)108 597.6 Q(On a compression dri)5 E
+.3 -.15(ve p)-.25 H(ercent used can be greater than 100%!).15 E F2
+(SEE ALSO)72 614.4 Q F0(xgterm\(1\), ximtool\(1\))108 626.4 Q F2
+(COPYRIGHT)72 643.2 Q F0(Cop)108 655.2 Q
+(yright\(c\) 1986 Association of Uni)-.1 E -.15(ve)-.25 G
+(rsities for Research in Astronomy Inc.).15 E(X11IRAF Project)72 768 Q
+(11 Dec 1996)137.62 E(2)203.45 E EP
+%%Trailer
+end
+%%EOF