1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022 |
- <!-- $XConsortium: Ref.sgm /main/11 1996/10/28 19:18:09 cdedoc $ -->
- <!-- (c) Copyright 1995 Digital Equipment Corporation. -->
- <!-- (c) Copyright 1995 Hewlett-Packard Company. -->
- <!-- (c) Copyright 1995 International Business Machines Corp. -->
- <!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
- <!-- (c) Copyright 1995 Novell, Inc. -->
- <!-- (c) Copyright 1995 FUJITSU LIMITED. -->
- <!-- (c) Copyright 1995 Hitachi. -->
- <Chapter Id="Reference">
- <Title>Reference Information</Title>
- <Para>Click any of the topics listed below for help with that particular topic.
- </Para>
- <ItemizedList Mark="•" Role="tight">
- <ListItem Id="HTRM.REF.item.1">
- <Para><XRef Linkend="manpage1x"></Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.2">
- <Para><XRef Linkend="EscapeSequences"></Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.3">
- <Para><XRef Linkend="Keyboard"></Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.4">
- <Para><XRef Linkend="GlobOpts"></Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.5">
- <Para><XRef Linkend="TermOpts"></Para>
- </ListItem>
- </ItemizedList>
- <Sect1 Id="manpage1x">
- <Title>dtterm (1X) Man Page</Title>
- <ItemizedList Mark="•" Role="tight">
- <ListItem Id="HTRM.REF.item.6">
- <Para><XRef Linkend="Synopsis"></Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.7">
- <Para><XRef Linkend="Description"></Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.8">
- <Para><XRef Linkend="Options"></Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.9">
- <Para><XRef Linkend="Resources"></Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.10">
- <Para><XRef Linkend="pointerusage"></Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.11">
- <Para><XRef Linkend="actions"></Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.12">
- <Para><XRef Linkend="translations">
- <!-- *<xref xconsoles> --></Para>
- </ListItem>
- </ItemizedList>
- <Procedure>
- <Title>See Also</Title>
- <Step>
- <ItemizedList Mark="•" Role="tight">
- <ListItem Id="HTRM.REF.item.13">
- <Para><XRef Linkend="EscapeSequences"></Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.14">
- <Para><OLink LocalInfo="X" Type="man"> X(1) </OLink>
- </Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.15">
- <Para><OLink LocalInfo="resize" Type="man"> resize(1) </OLink>
- </Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.16">
- <Para><OLink LocalInfo="xset" Type="man"> xset(1) </OLink>
- </Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.17">
- <Para><OLink LocalInfo="xterm" Type="man"> xterm(1) </OLink>
- </Para>
- </ListItem>
- </ItemizedList>
- </Step>
- </Procedure>
- <Sect2 Id="Synopsis">
- <Title>SYNOPSIS</Title>
- <Para><ComputerOutput>dtterm</ComputerOutput>
- [-options]</Para>
- </Sect2>
- <Sect2 Id="Description">
- <Title>DESCRIPTION</Title>
- <Para>The <Symbol Role="Variable">dtterm</Symbol> client provides runtime support of legacy applications
- written for ANSI X3.64-1979 and ISO 6429:1992(E) conformant character
- terminals such as the DEC VT220.</Para>
- </Sect2>
- <Sect2 Id="Options">
- <Title>OPTIONS</Title>
- <Para>The <Symbol Role="Variable">dtterm</Symbol> terminal emulator
- accepts all of the standard X Toolkit command line options along with
- additional options all of which are listed below (if the option begins
- with a `+' instead of a `-', the option is restored to its default value):</Para>
- <!-- spec pages 11 through 17 -->
- <Para Id="minus132"><ComputerOutput>-132</ComputerOutput>
- </Para>
- <Para Role="indent">Normally the DECCOLM escape sequence that switches between
- 80 and
- 132 column mode is ignored. This option causes the DECCOLM escape
- sequence to be recognized, and the <ComputerOutput>dtterm</ComputerOutput> window will resize
- appropriately.<IndexTerm>
- <Primary>c132</Primary>
- </IndexTerm>
- </Para>
- <Para Role="indent">Associated resource: <Link Type="jump" Linkend="c132"> <ComputerOutput>c132</ComputerOutput></Link>.</Para>
- <Para Id="plus132"><ComputerOutput>+132</ComputerOutput>
- </Para>
- <Para Role="indent">This option causes the DECCOLM
- escape sequence to be ignored. This is the
- default behavior.<IndexTerm>
- <Primary>c132</Primary>
- </IndexTerm>
- </Para>
- <Para Role="indent">Associated resource: <Link Type="jump" Linkend="c132"> <ComputerOutput>c132</ComputerOutput></Link>.</Para>
- <Para Id="minusaw"><ComputerOutput>-aw</ComputerOutput>
- </Para>
- <Para Role="indent">This option indicates that auto-wraparound
- should be allowed. This
- allows the cursor to automatically wrap to the beginning of the next
- line when it is at the right-most position of a line and text is output.
- This is the default behavior.
- </Para>
- <Para Role="indent">Associated resource: <Link Type="jump" Linkend="autowrap"> <ComputerOutput>autoWrap</ComputerOutput></Link>.<IndexTerm>
- <Primary>autoWrap</Primary>
- </IndexTerm>
- </Para>
- <Para Id="plusaw"><ComputerOutput>+aw</ComputerOutput>
- </Para>
- <Para Role="indent">This option indicates that auto-wraparound should not be allowed.
- </Para>
- <Para Role="indent">Associated resource: <Link Type="jump" Linkend="autowrap"> <ComputerOutput>autoWrap</ComputerOutput></Link>.<IndexTerm>
- <Primary>autoWrap</Primary>
- </IndexTerm>
- </Para>
- <Para Id="bkgndopt"><ComputerOutput>-background</ComputerOutput> <Symbol Role="Variable">background_color</Symbol>
- </Para>
- <Para Role="indent">This option specifies the background of the terminal window as well as the
- default background used for the scroll bar and the X11 pointer cursor.
- Under CDE, this option defaults to the primary
- colorset select pixel or background pixel(see
- <Link Type="jump" Linkend="bselect"><ComputerOutput>-bs</ComputerOutput></Link>. Without CDE, this option defaults to
- <ComputerOutput>*background/*Background</ComputerOutput> with an ultimate fallback color of black.
- </Para>
- <Para Role="indent"><Symbol Role="Variable">background_color</Symbol> describes the background color to use.
- </Para>
- <Para Role="indent"><IndexTerm>
- <Primary>background</Primary>
- </IndexTerm>Associated resource: <Link Type="jump" Linkend="background"><ComputerOutput>background</ComputerOutput></Link></Para>
- <Para><ComputerOutput>-bd <Symbol Role="Variable">border_color</Symbol></ComputerOutput>
- </Para>
- <Para Role="indent">This option specifies the border color for all windows. The shell widget's
- border
- may not be visible when reparenting window managers such as <ComputerOutput>dtwm(1X)</ComputerOutput>
- and <ComputerOutput>mwm(1X)</ComputerOutput> are used. The default color is black.
- </Para>
- <Para Role="indent"><Symbol Role="Variable">border_color</Symbol> describes the border color to use.
- </Para>
- <Para Role="indent"><IndexTerm>
- <Primary>borderColor</Primary>
- </IndexTerm>Associated resource: <Link Type="jump" Linkend="bdrcol"> <ComputerOutput>borderColor</ComputerOutput></Link>.</Para>
- <Para Id="bgnd"><ComputerOutput>-bg</ComputerOutput> <Symbol Role="Variable">background_color</Symbol>
- </Para>
- <Para Role="indent">This option is identical to <Link Type="jump" Linkend="bkgndopt"><ComputerOutput>-background</ComputerOutput></Link>.
- </Para>
- <Para Role="indent"><ComputerOutput>background_color</ComputerOutput> describes the background color to use.
- </Para>
- <Para Role="indent"><IndexTerm>
- <Primary>background</Primary>
- </IndexTerm>Associated resource: <Link Type="jump" Linkend="background"> <ComputerOutput>background</ComputerOutput></Link>.</Para>
- <Para><ComputerOutput>-bordercolor</ComputerOutput> <Emphasis>border_color</Emphasis>
- </Para>
- <Para Role="indent">This option is identical to -bd above.
- </Para>
- <Para Role="indent"><Emphasis>border_color</Emphasis>
- Describes the border color to use
- </Para>
- <Para Role="indent"><IndexTerm>
- <Primary>borderColor</Primary>
- </IndexTerm>Associated resource: <Link Type="jump" Linkend="bdrcol"> <ComputerOutput>borderColor</ComputerOutput></Link>.</Para>
- <Para Id="bdrwidthopt"><ComputerOutput>-borderwidth</ComputerOutput> <Symbol Role="Variable">border_width</Symbol>
- </Para>
- <Para Role="indent">This option specifies the border width of the shell widget's window.
- This value may be overridden by reparenting window managers such as
- <ComputerOutput>dtwm(1X)</ComputerOutput> and <ComputerOutput>mwm(1X)</ComputerOutput>. The default is 0.
- </Para>
- <Para Role="indent"><Symbol Role="Variable">border_width</Symbol>
- Specifies the width of the window border in pixels.
- </Para>
- <Para Role="indent"><IndexTerm>
- <Primary>borderwidth</Primary>
- </IndexTerm>Associated resource: <Link Type="jump" Linkend="bwidth"> <ComputerOutput>borderWidth</ComputerOutput></Link>.</Para>
- <Para Id="bselect"><ComputerOutput>-bs</ComputerOutput>
- </Para>
- <Para Role="indent">This option specifies that the
- terminal window should use the Motif select color instead of the background
- color for the terminal window's background color. This is the default
- behavior.
- </Para>
- <Para Role="indent"><IndexTerm>
- <Primary>backgroundIsSelect</Primary>
- </IndexTerm>Associated resource: <Link Type="jump" Linkend="bgndIsSel"> <ComputerOutput>backgroundIsSelect</ComputerOutput></Link>.</Para>
- <Para><ComputerOutput>+bs</ComputerOutput>
- </Para>
- <Para Role="indent">This option specifies that the
- terminal window should not use the Motif select color instead of the
- background color for the terminal window's background color.
- </Para>
- <Para Role="indent">Associated resource: <Link Type="jump" Linkend="bgndIsSel"> <ComputerOutput>backgroundIsSelect</ComputerOutput></Link>.</Para>
- <Para><ComputerOutput>-bw <Symbol Role="Variable">border_width</Symbol></ComputerOutput>
- </Para>
- <Para Role="indent">This option is identical to <Link Type="jump" Linkend="bdrwidthopt"><ComputerOutput>-borderwidth</ComputerOutput></Link> above.
- </Para>
- <Para Role="indent">Associated resource: <Link Type="jump" Linkend="bwidth"> <ComputerOutput>borderWidth</ComputerOutput></Link>.</Para>
- <Para><ComputerOutput>-C</ComputerOutput>
- </Para>
- <Para Role="indent">This option specifies that output directed at <ComputerOutput>/dev/console</ComputerOutput> should be
- directed instead to the terminal window. It is provided as a way to
- prevent output that would normally be displayed on the ITE from
- overwriting the X server's display. It is not provided as a general mechanism to
- direct the output from an arbitrary system's <ComputerOutput>/dev/console</ComputerOutput> to an
- arbitrary X server. Note that you must have ownership of and read/write
- access to <ComputerOutput>/dev/console</ComputerOutput> for this option to work.</Para>
- <Para><ComputerOutput>-display <Symbol Role="Variable">display_name</Symbol></ComputerOutput>
- </Para>
- <Para Role="indent">This option specifies the X11 display server to be used by <ComputerOutput>dtterm</ComputerOutput>.
- This defaults to the value in the $DISPLAY environment variable.
- </Para>
- <Para Role="indent"><Symbol Role="Variable">display_name</Symbol> specifies the X11 server to connect to.<IndexTerm>
- <Primary>display</Primary>
- </IndexTerm>
- </Para>
- <Para><ComputerOutput>-e <Symbol Role="Variable">program_argument ...</Symbol></ComputerOutput>
- </Para>
- <Para Role="indent">This option specifies an executable program to be invoked as a subprocess
- when <ComputerOutput>dtterm</ComputerOutput> is started.
- This option must be the last option on
- the command line.
- </Para>
- <Para Role="indent"><Symbol Role="Variable">program_argument ...</Symbol> specifies the program and command line arguments
- to execute.</Para>
- <Para><ComputerOutput>-fb</ComputerOutput> <Emphasis>fontset</Emphasis>
- </Para>
- <Para Role="indent">This option specifies an XFontSet to be used when displaying bold terminal
- text. It should be specified as a Motif XmFontList.
- Only character or mono spaced fonts are supported. The behavior when
- using proportional fonts is undefined.
- A default bold font will be generated based on the XLFD
- name of the userFont.
- If that font is not available, bold text
- will be generated by overstriking (with a one pixel offset) the
- userFont.
- </Para>
- <Para Role="indent"><Emphasis>fontset</Emphasis> specifies the bold terminal XFontSet to use.
- </Para>
- <Para Role="indent">Associated resource: <Link Type="jump" Linkend="userFont"> <ComputerOutput>userFont</ComputerOutput></Link>.</Para>
- <Para Id="fgopt"><ComputerOutput>-fg</ComputerOutput> <Symbol Role="Variable">foreground_color</Symbol>
- </Para>
- <Para Role="indent">This option specifies the foreground color of the terminal window as
- well as the default foreground color used for the scroll bar and the
- for the X11 pointer cursor. Under CDE, this resource
- will default to the primary color set foreground pixel. Without CDE,
- this resource will default to <ComputerOutput>*foreground</ComputerOutput> or <ComputerOutput>*Foreground</ComputerOutput> with
- an ultimate fallback color of white.
- </Para>
- <Para Role="indent"><Symbol Role="Variable">foreground_color</Symbol> specifies the foreground color to use.
- </Para>
- <Para Role="indent"><IndexTerm>
- <Primary>foreground</Primary>
- </IndexTerm>Associated resource: <Link Type="jump" Linkend="fg"> <ComputerOutput>foreground</ComputerOutput></Link>.</Para>
- <Para Id="fn"><ComputerOutput>-fn</ComputerOutput> <Emphasis>fontset</Emphasis>
- </Para>
- <Para Role="indent">This option specifies an XFontSet to be used when displaying terminal text.
- It should be specified as a Motif XmFontList.
- Only character or mono spaced fonts are supported. The behavior when
- using proportional fonts is undefined.
- This font will not be used
- to display non-terminal text (menu bar, popup menus, dialogs, etc.).
- The default is
- to use the XmNtextFontList value of the parent bulletin board (see
- XmBulletinBoard(3X)) in the same manner as the XmText widget.
- </Para>
- <Para Role="indent"><Emphasis>fontset</Emphasis> Specifies the terminal XFontSet to use.
- Associated resource: <Link Type="jump" Linkend="userFont"> <ComputerOutput>userFont</ComputerOutput></Link>.</Para>
- <Para><ComputerOutput>-font</ComputerOutput> <Emphasis>fontset</Emphasis>
- </Para>
- <Para Role="indent">This option is identical to <ComputerOutput>-fn</ComputerOutput> above.
- </Para>
- <Para Role="indent"><Emphasis>fontset</Emphasis> Specifies the terminal XFontSet to use.</Para>
- <Para>Associated resource: <Link Type="jump" Linkend="userFont"> <ComputerOutput>userFont</ComputerOutput></Link>.
- </Para>
- <Para Id="foregndopt"><ComputerOutput>-foreground</ComputerOutput> <Symbol Role="Variable">foreground</Symbol>
- </Para>
- <Para Role="indent">This option is identical to <Link Type="jump" Linkend="fgopt"><ComputerOutput>-fg</ComputerOutput></Link> above.
- </Para>
- <Para Role="indent"><Symbol Role="Variable">foreground</Symbol> Specifies the foreground color to use.
- </Para>
- <Para Role="indent"><IndexTerm>
- <Primary>foreground</Primary>
- </IndexTerm>Associated resource: <Link Type="jump" Linkend="fg"> <ComputerOutput>foreground</ComputerOutput></Link>.</Para>
- <Para><ComputerOutput>-geometry <Symbol Role="Variable">geometry_string</Symbol></ComputerOutput>
- </Para>
- <Para Role="indent">This option specifies the preferred size and position of the terminal
- window. The default size is 24 lines of 80 characters each.
- There is no default position.
- </Para>
- <Para Role="indent"><Symbol Role="Variable">geometry</Symbol> Specifies the terminal geometry to use.
- </Para>
- <Para Role="indent"><IndexTerm>
- <Primary>geometry</Primary>
- </IndexTerm>Associated resource: <Link Type="jump" Linkend="geometry"> <ComputerOutput>geometry</ComputerOutput></Link>.</Para>
- <Para><ComputerOutput>-help</ComputerOutput>
- </Para>
- <Para Role="indent">Displays a message summarizing the usage of <ComputerOutput>dtterm</ComputerOutput>.<IndexTerm>
- <Primary>help</Primary>
- </IndexTerm>
- </Para>
- <Para><ComputerOutput>-iconic</ComputerOutput>
- </Para>
- <Para Role="indent">This option specifies that the terminal emulator should initially be
- placed on the display iconified.
- </Para>
- <Para Role="indent"><IndexTerm>
- <Primary>iconic</Primary>
- </IndexTerm>Associated resource: <Link Type="jump" Linkend="iconic"> <ComputerOutput>iconic</ComputerOutput></Link>.</Para>
- <Para><ComputerOutput>+iconic</ComputerOutput>
- </Para>
- <Para Role="indent">This option specifies that the terminal emulator should initially be
- placed on the display as a normal window. This is the default behavior.
- </Para>
- <Para Role="indent">Associated resource: <Link Type="jump" Linkend="iconic"> <ComputerOutput>iconic</ComputerOutput></Link>.</Para>
- <Para><ComputerOutput>-j</ComputerOutput>
- </Para>
- <Para Role="indent">This option specifies that jump scrolling should be used. Under jump
- scrolling, the screen may be scrolled more than one line at a time. This
- provides for faster screen updates when multiple lines of text are being
- sent to the terminal. The maximum number of lines that may be jump
- scrolled is limited to the number of lines in the terminal window. It is
- guaranteed that
- all lines will be displayed. This is the default behavior.
- </Para>
- <Para Role="indent"><IndexTerm>
- <Primary>jumpScroll</Primary>
- </IndexTerm>Associated resource: <Link Type="jump" Linkend="jumpScroll"> <ComputerOutput>jumpScroll</ComputerOutput></Link>.</Para>
- <Para><ComputerOutput>+j</ComputerOutput>
- </Para>
- <Para Role="indent">This option specifies that jump scrolling should not be used. For a
- description of jump scrolling, see <ComputerOutput>-j</ComputerOutput> above.
- </Para>
- <Para Role="indent">Associated resource: <Link Type="jump" Linkend="jumpScroll"> <ComputerOutput>jumpScroll</ComputerOutput></Link>.</Para>
- <Para><ComputerOutput>-kshMode</ComputerOutput>
- </Para>
- <Para Role="indent">This option specifies that ksh mode should be enabled.
- Under ksh mode, a key pressed with the extend modifier bit set will
- generate an escape character followed by the character generated by the
- un-extended keystroke. This option is provided for use with emacs and
- the emacs command line editor mode of <ComputerOutput>ksh(1)</ComputerOutput> or <ComputerOutput>ied(1)</ComputerOutput>. It
- conflicts with the normal use of the meta key for generating extended
- single byte characters, and for generating multi-byte Asian characters.<IndexTerm>
- <Primary>kshMode</Primary>
- </IndexTerm>
- </Para>
- <Para Role="indent">Associated resource: <Link Type="jump" Linkend="kshMode"> <ComputerOutput>kshMode</ComputerOutput></Link>.</Para>
- <Para><ComputerOutput>+kshMode</ComputerOutput>
- </Para>
- <Para Role="indent">This option specifies that the ksh mode should not be enabled. This is
- the default behavior.
- </Para>
- <Para Role="indent">Associated resource: <Link Type="jump" Linkend="kshMode"> <ComputerOutput>kshMode</ComputerOutput></Link>.</Para>
- <Para><ComputerOutput>-l</ComputerOutput>
- </Para>
- <Para Role="indent">This option enables output logging. When logging is enabled, all output
- received from the subprocess is logged either to a file or to a command
- pipeline (as specified via the <ComputerOutput>-lf</ComputerOutput> option below). Since the data is
- being logged directly from the subprocess, it includes all escape
- characters and carriage return/newline pairs sent by the terminal line
- discipline. Output may be enabled and disabled via
- escape sequences.
- </Para>
- <Para Role="indent"><IndexTerm>
- <Primary>logging</Primary>
- </IndexTerm>Associated resource: <Link Type="jump" Linkend="logging"> <ComputerOutput>logging</ComputerOutput></Link>.</Para>
- <Para><ComputerOutput>+l</ComputerOutput>
- </Para>
- <Para Role="indent">This option disables output logging. For a description of output
- logging, see <ComputerOutput>-l</ComputerOutput> above. This option is the default.
- </Para>
- <Para Role="indent"><IndexTerm>
- <Primary>logging</Primary>
- </IndexTerm>Associated resource: <Link Type="jump" Linkend="logging"> <ComputerOutput>logging</ComputerOutput></Link>.</Para>
- <Para><ComputerOutput>-lf <Symbol Role="Variable">file_name</Symbol></ComputerOutput>
- </Para>
- <Para Role="indent">This option specifies the name of the file to which the output log described
- above is written. If <Symbol Role="Variable">file_name</Symbol> begins with a pipe symbol (<ComputerOutput>|</ComputerOutput>), the rest of
- the string is assumed to be a command to be used as the endpoint of a pipe.
- The default filename is <ComputerOutput>DttermLog</ComputerOutput><Symbol Role="Variable">XXXXX</Symbol> (where <Symbol Role="Variable">XXXXX</Symbol>
- is the process id of <ComputerOutput>dtterm</ComputerOutput>) and is created in the directory from which
- <ComputerOutput>dtterm</ComputerOutput> was started. If the last five characters are "XXXXX," they
- are replaced by the process ID.
- </Para>
- <Para Role="indent"><Symbol Role="Variable">file_name</Symbol> specifies the log file name to use.
- </Para>
- <Para Role="indent"><IndexTerm>
- <Primary>logFile</Primary>
- </IndexTerm>Associated resource: <Link Type="jump" Linkend="logfile"> <ComputerOutput>logFile</ComputerOutput></Link>.</Para>
- <Para><ComputerOutput>-ls</ComputerOutput>
- </Para>
- <Para Role="indent">This option indicates that the shell that is started
- should be a login shell (i.e. the first character of <ComputerOutput>argv[0]</ComputerOutput> will be a dash,
- indicating to the shell that it should read the system's <ComputerOutput>profile</ComputerOutput>
- and the user's <ComputerOutput>$HOME/.profile</ComputerOutput> (for <ComputerOutput>ksh</ComputerOutput> and <ComputerOutput>sh</ComputerOutput>) or the system's
- <ComputerOutput>csh.login</ComputerOutput> and the user's
- <ComputerOutput>$HOME.login</ComputerOutput> (for <ComputerOutput>csh</ComputerOutput>).
- </Para>
- <Para Role="indent"><IndexTerm>
- <Primary>loginShell</Primary>
- </IndexTerm>Associated resource: <Link Type="jump" Linkend="logShell"><ComputerOutput>loginShell</ComputerOutput></Link>.</Para>
- <Para><ComputerOutput>+ls</ComputerOutput>
- </Para>
- <Para Role="indent">This option specifies that a normal (non-login) shell should be started.
- This is the default behavior.
- </Para>
- <Para Role="indent"><IndexTerm>
- <Primary>loginShell</Primary>
- </IndexTerm>Associated resource: <Link Type="jump" Linkend="logShell"><ComputerOutput>loginShell</ComputerOutput></Link>.</Para>
- <Para><ComputerOutput>-map</ComputerOutput>
- </Para>
- <Para Role="indent">This option indicates that <ComputerOutput>dtterm</ComputerOutput> should map (de-iconify) itself upon
- subprocess output if it is unmapped (iconified). An initial period of time
- during which <ComputerOutput>dtterm</ComputerOutput> will not map itself upon subprocess output may be
- specified
- via the <Link Type="jump" Linkend="maponoutdlay"><ComputerOutput>mapOnOutputDelay</ComputerOutput></Link> resource.
- </Para>
- <Para Role="indent"><IndexTerm>
- <Primary>mapOnOutput</Primary>
- </IndexTerm>Associated resource: <Link Type="jump" Linkend="maponout"> <ComputerOutput>mapOnOutput</ComputerOutput></Link>.</Para>
- <Para><ComputerOutput>+map</ComputerOutput>
- </Para>
- <Para Role="indent">This option specifies that there should be no special mapping behavior.
- This is the default
- behavior.
- </Para>
- <Para Role="indent"><IndexTerm>
- <Primary>mapOnOutput</Primary>
- </IndexTerm>Associated resource: <Link Type="jump" Linkend="maponout"> <ComputerOutput>mapOnOutput</ComputerOutput></Link>.</Para>
- <Para><ComputerOutput>-mb</ComputerOutput>
- </Para>
- <Para Role="indent">This option indicates that <ComputerOutput>dtterm</ComputerOutput> should ring a margin bell when the user
- types near the right margin. The actual distance involved is specified by
- the <Link Type="jump" Linkend="nb"> <ComputerOutput>-nb</ComputerOutput></Link> option.
- </Para>
- <Para Role="indent"><IndexTerm>
- <Primary>marginBell</Primary>
- </IndexTerm>Associated resource: <Link Type="jump" Linkend="marginBell"> <ComputerOutput>marginBell</ComputerOutput></Link>.</Para>
- <Para><ComputerOutput>+mb</ComputerOutput>
- </Para>
- <Para Role="indent">This option indicates that margin bell should not be rung when the user
- types near the right margin. This is the default.
- </Para>
- <Para Role="indent"><IndexTerm>
- <Primary>marginBell</Primary>
- </IndexTerm>Associated resource: <Link Type="jump" Linkend="marginBell"> <ComputerOutput>marginBell</ComputerOutput></Link>.</Para>
- <Para><ComputerOutput>-ms <Symbol Role="Variable">pointer_color</Symbol></ComputerOutput>
- </Para>
- <Para Role="indent">This option specifies the foreground color to use for the terminal window's
- (X11) pointer cursor. The default is to use the terminal window's
- foreground color. See <Link Type="jump" Linkend="foregndopt"><ComputerOutput>foreground</ComputerOutput></Link> above.
- </Para>
- <Para Role="indent"><Emphasis>pointer_color</Emphasis> specifies the pointer foreground color to use.
- </Para>
- <Para Role="indent">Associated resource: <Link Type="jump" Linkend="pointcolor"> <ComputerOutput>pointerColor</ComputerOutput></Link>.</Para>
- <Para><ComputerOutput>-name <Symbol Role="Variable">prog_name</Symbol></ComputerOutput>
- </Para>
- <Para Role="indent">This option specifies the X11 name of the <ComputerOutput>dtterm</ComputerOutput> window.
- </Para>
- <Para Role="indent"><Emphasis>prog_name</Emphasis> the name to use.<IndexTerm>
- <Primary>name</Primary>
- </IndexTerm>
- </Para>
- <Para Id="nb"><ComputerOutput>-nb <Symbol Role="Variable">number</Symbol></ComputerOutput>
- </Para>
- <Para Role="indent">This option specifies the number of characters from the right margin
- at which the margin bell will ring, if enabled. The default is 10.
- </Para>
- <Para Role="indent"><IndexTerm>
- <Primary>nMarginBell</Primary>
- </IndexTerm>Associated resource: <Link Type="jump" Linkend="nMarginBell"> <ComputerOutput>nMarginBell</ComputerOutput></Link>.</Para>
- <Para><ComputerOutput>-r</ComputerOutput>
- </Para>
- <Para Role="indent">This option causes the <ComputerOutput>dtterm</ComputerOutput> window to be displayed with the
- foreground and background colors reversed. This is identical to the
- <ComputerOutput>-r</ComputerOutput> and
- <ComputerOutput>-reverse</ComputerOutput> options.</Para>
- <Para><ComputerOutput>+r</ComputerOutput>
- </Para>
- <Para Role="indent">This option causes the <ComputerOutput>dtterm</ComputerOutput> window to be displayed with the normal
- foreground and background colors. This is the default, and is also
- identical to the <ComputerOutput>+rv</ComputerOutput> option..</Para>
- <Para><ComputerOutput>-reverse</ComputerOutput>
- </Para>
- <Para Role="indent">This option causes the <ComputerOutput>dtterm</ComputerOutput> window to be displayed with the
- foreground and background colors reversed. This is identical to the
- <ComputerOutput>-r</ComputerOutput> and
- <ComputerOutput>-rv</ComputerOutput> options.</Para>
- <Para><ComputerOutput>-rv</ComputerOutput>
- </Para>
- <Para Role="indent">This option causes the <ComputerOutput>dtterm</ComputerOutput> window to be displayed with the
- foreground and background colors reversed. This is identical to choosing
- Options | Global Options, and then changing the "windowBackground" options
- menu to "Inverse." A <ComputerOutput>dtterm</ComputerOutput> window started with this option has the
- "Window Background" options menu set to "Inverse." See <Link Type="jump" Linkend="GlobOpts">"Global Options"</Link>.</Para>
- <Para><ComputerOutput>+rv</ComputerOutput>
- </Para>
- <Para Role="indent">This option causes the <ComputerOutput>dtterm</ComputerOutput> window to be displayed with the normal
- foreground and background colors. This is the default.</Para>
- <Para Id="minusrw"><ComputerOutput>-rw</ComputerOutput>
- </Para>
- <Para Role="indent">This option specifies that reverse-wraparound should be enabled.
- </Para>
- <Para Role="indent"><IndexTerm>
- <Primary>reverseWrap</Primary>
- </IndexTerm>Associated resource: <Link Type="jump" Linkend="reverseWrap"> <ComputerOutput>reverseWrap</ComputerOutput></Link>.</Para>
- <Para Id="plusrw"><ComputerOutput>+rw</ComputerOutput>
- </Para>
- <Para Role="indent">This option indicates that reverse-wraparound should not be enabled. This
- is the default.
- </Para>
- <Para Role="indent"><IndexTerm>
- <Primary>reverseWrap</Primary>
- </IndexTerm>Associated resource: <Link Type="jump" Linkend="reverseWrap"> <ComputerOutput>reverseWrap</ComputerOutput></Link>.</Para>
- <Para><ComputerOutput>-S<Symbol Role="Variable">ccn</Symbol></ComputerOutput>
- </Para>
- <Para Role="indent">This option specifies that the terminal emulator should be run against
- a pre-opened pty or STREAMS device. This option is provided for use where
- the pty or STREAMS device's slave name is
- of the form <ComputerOutput>tty??</ComputerOutput> (i.e., exactly two characters following the
- <ComputerOutput>tty</ComputerOutput>). This option is intended for use when <ComputerOutput>dtterm</ComputerOutput> is invoked
- programmatically from another application.
- </Para>
- <Para Role="indent"><Emphasis>cc</Emphasis> specifies the last two characters of the pty or STREAMS device's
- slave name, where the
- slave name is of the form <ComputerOutput>tty??</ComputerOutput>. This value is ignored, but must be
- exactly two characters in length.
- </Para>
- <Para Role="indent"><Symbol Role="Variable">n</Symbol> specifies the number of the file descriptor that corresponds to the
- pty or STREAMS device's already-opened master side.</Para>
- <Para><ComputerOutput>-S<Symbol Role="Variable">c.n</Symbol></ComputerOutput>
- </Para>
- <Para Role="indent">This option is identical to <ComputerOutput>-Sccn</ComputerOutput> above, but is provided for systems
- with a larger pty name space.
- </Para>
- <Para Role="indent"><Emphasis>c</Emphasis> specifies the last component of the pty slave name. This values is
- ignored and may be empty.
- </Para>
- <Para Role="indent"><Symbol Role="Variable">n</Symbol> specifies the number of the file descriptor that corresponds to the
- pty's already-opened master side.</Para>
- <Para><ComputerOutput>-sb</ComputerOutput>
- </Para>
- <Para Role="indent">This option indicates that a scrollbar should be displayed. This is the
- default.
- </Para>
- <Para Role="indent"><IndexTerm>
- <Primary>scrollBar</Primary>
- </IndexTerm>Associated resource: <Link Type="jump" Linkend="scrollbar"> <ComputerOutput>scrollBar</ComputerOutput></Link>.</Para>
- <Para><ComputerOutput>+sb</ComputerOutput>
- </Para>
- <Para Role="indent">This option indicates that a scrollbar should <Symbol Role="Variable">not</Symbol> be displayed.
- </Para>
- <Para Role="indent"><IndexTerm>
- <Primary>scrollBar</Primary>
- </IndexTerm>Associated resource: <Link Type="jump" Linkend="scrollbar"> <ComputerOutput>scrollBar</ComputerOutput></Link>.</Para>
- <Para><ComputerOutput>-sf</ComputerOutput>
- </Para>
- <Para Role="indent">This option indicates that Sun Function Key escape codes should be
- generated for function keys instead of standard VT220 escape sequences.
- </Para>
- <Para Role="indent"><IndexTerm>
- <Primary>sunFunctionKeys</Primary>
- </IndexTerm>Associated resource: <Link Type="jump" Linkend="sunfnctk"> <ComputerOutput>sunFunctionKeys</ComputerOutput></Link>.</Para>
- <Para><ComputerOutput>+sf</ComputerOutput>
- </Para>
- <Para Role="indent">This option indicates that the standard escape sequences should be
- generated for function keys instead of the Sun Function Key escape codes.
- This is the default behavior.
- </Para>
- <Para Role="indent"><IndexTerm>
- <Primary>sunFunctionKeys</Primary>
- </IndexTerm>Associated resource: <Link Type="jump" Linkend="sunfnctk"> <ComputerOutput>sunFunctionKeys</ComputerOutput></Link>.</Para>
- <Para><ComputerOutput>-sl <Symbol Role="Variable">screens[s|l]</Symbol></ComputerOutput>
- </Para>
- <Para Role="indent">This option specifies the number of lines in the terminal buffer beyond the
- length of the window. The option value consists of a number followed by an
- optional suffix. If no suffix is included, or the suffix is "l" (ell), the
- total length of the terminal buffer will be <Symbol Role="Variable">screens</Symbol> plus the length of
- the terminal window. If the suffix is "s" (ess), the total length of the
- terminal buffer will be (<Symbol Role="Variable">screens</Symbol> plus one) times the length of the
- terminal window. <ComputerOutput>dtterm</ComputerOutput> will try to maintain the same buffer-to-window
- ratio when the window is resized larger. The default is "4s."
- </Para>
- <Para Role="indent"><Symbol Role="Variable">screens</Symbol> specifies the number of screens or lines to save.
- </Para>
- <Para Role="indent"><IndexTerm>
- <Primary>saveLines</Primary>
- </IndexTerm>Associated resource: <Link Type="jump" Linkend="savelines"> <ComputerOutput>saveLines</ComputerOutput></Link>.</Para>
- <Para><ComputerOutput>-ti</ComputerOutput> <Emphasis>term_id</Emphasis>
- </Para>
- <Para Role="indent">This option supplies the name used to select the correct response to
- terminal ID queries. Valid values are <ComputerOutput>vt100, vt101, vt102</ComputerOutput>, and
- <ComputerOutput>vt220</ComputerOutput>. The default is <ComputerOutput>vt220</ComputerOutput>.
- </Para>
- <Para Role="indent"><Emphasis>term_id</Emphasis> specifies the terminal ID to use.</Para>
- <Para><ComputerOutput>-title <Symbol Role="Variable">title_string</Symbol></ComputerOutput>
- </Para>
- <Para Role="indent">This option specifies the window title. If the <ComputerOutput>-e</ComputerOutput> option is
- used, the default will be the last component of the program's path. If
- the <ComputerOutput>-e</ComputerOutput> option is not used, the default will be the last component of
- the name used to execute <ComputerOutput>dtterm</ComputerOutput> (i.e., <ComputerOutput>argv[0]</ComputerOutput>).
- </Para>
- <Para Role="indent"><Emphasis>title_string</Emphasis> specifies the title to use.
- </Para>
- <Para Role="indent"><IndexTerm>
- <Primary>title</Primary>
- </IndexTerm>Associated resource: <Link Type="jump" Linkend="title"> <ComputerOutput>title</ComputerOutput></Link>.</Para>
- <Para><ComputerOutput>-tm <Symbol Role="Variable">term_modes</Symbol></ComputerOutput>
- </Para>
- <Para Role="indent">This option specifies a string containing terminal-setting keywords
- and the characters to which they may be bound. Allowable keywords
- include <ComputerOutput>intr</ComputerOutput>, <ComputerOutput>quit</ComputerOutput>, <ComputerOutput>erase</ComputerOutput>, <ComputerOutput>kill</ComputerOutput>, <ComputerOutput>eof</ComputerOutput>,
- <ComputerOutput>eol</ComputerOutput>, <ComputerOutput>swtch</ComputerOutput>, <ComputerOutput>start</ComputerOutput>, <ComputerOutput>stop</ComputerOutput>, <ComputerOutput>brk</ComputerOutput>,
- <ComputerOutput>susp</ComputerOutput>, <ComputerOutput>dsusp</ComputerOutput>, <ComputerOutput>rprnt</ComputerOutput>, <ComputerOutput>flush</ComputerOutput>, <ComputerOutput>weras</ComputerOutput>,
- and <ComputerOutput>lnext</ComputerOutput>. Keywords that do not apply
- to a specific architecture will be correctly parsed and ignored.
- Control characters may be specified as <ComputerOutput>^</ComputerOutput> followed by <ComputerOutput>char</ComputerOutput>
- (e.g. <ComputerOutput>^c</ComputerOutput> or <ComputerOutput>^u</ComputerOutput>), and <ComputerOutput>^?</ComputerOutput>
- may be used to indicate delete. This is useful for overridding the
- default terminal settings without having to do an <ComputerOutput>stty(1)</ComputerOutput> every time a
- terminal process is started. The default is NULL.
- </Para>
- <Para Role="indent"><Emphasis>term_modes</Emphasis> specifies the terminal mode string.
- </Para>
- <Para Role="indent"><IndexTerm>
- <Primary>ttyModes</Primary>
- </IndexTerm>Associated resource: <Link Type="jump" Linkend="ttymodes"> <ComputerOutput>ttyModes</ComputerOutput></Link>.</Para>
- <Para><ComputerOutput>-tn <Symbol Role="Variable">term_name</Symbol></ComputerOutput>
- </Para>
- <Para Role="indent">This option specifies a name to set the
- <ComputerOutput>$TERM</ComputerOutput> environment variable to. The default is <ComputerOutput>"vt220"</ComputerOutput>.
- </Para>
- <Para Role="indent"><Emphasis>term_name</Emphasis> specifies the terminal name to use.
- </Para>
- <Para Role="indent"><IndexTerm>
- <Primary>termName</Primary>
- </IndexTerm>Associated resource: <Link Type="jump" Linkend="termname"> <ComputerOutput>termName</ComputerOutput></Link>.</Para>
- <Para><ComputerOutput>-usage</ComputerOutput>
- </Para>
- <Para Role="indent">Prints a usage message on the screen.</Para>
- <Para><ComputerOutput>-vb</ComputerOutput>
- </Para>
- <Para Role="indent">This option indicates that a visual bell is preferred over an audible one.
- Instead of ringing the terminal bell whenever a Control-G is received, the
- window will be flashed.
- </Para>
- <Para Role="indent"><IndexTerm>
- <Primary>visualBell</Primary>
- </IndexTerm>Associated resource: <Link Type="jump" Linkend="visbell"> <ComputerOutput>visualBell</ComputerOutput></Link>.</Para>
- <Para><ComputerOutput>+vb</ComputerOutput>
- </Para>
- <Para Role="indent">This option indicates that an audio bell is preferred over a visual one.
- This is the default behavior.
- </Para>
- <Para Role="indent"><IndexTerm>
- <Primary>visualBell</Primary>
- </IndexTerm>Associated resource: <Link Type="jump" Linkend="visbell"> <ComputerOutput>visualBell</ComputerOutput></Link>.</Para>
- <Para><ComputerOutput>-w</ComputerOutput> <Symbol Role="Variable">border_width</Symbol>
- </Para>
- <Para Role="indent">This option is identical to <Link Type="jump" Linkend="bdrwidthopt"><ComputerOutput>-borderwidth</ComputerOutput></Link>
- above.
- </Para>
- <Para Role="indent"><Symbol Role="Variable">border_width</Symbol> specifies the width of the window border in pixels.</Para>
- <Para><ComputerOutput>-xrm <Symbol Role="Variable">resource_string</Symbol></ComputerOutput>
- </Para>
- <Para Role="indent">This option allows X11 Resource Manager-style resources to be specified on
- the command line. <Symbol Role="Variable">resource_string</Symbol> specifies an X11 resource string.</Para>
- <!-- spec pages 22 through 27 -->
- </Sect2>
- <Sect2 Id="Resources">
- <Title>RESOURCES</Title>
- <Para><ComputerOutput>allowSendEvents</ComputerOutput>
- </Para>
- <Para Role="indent">This resource specifies that the terminal emulator should allow
- synthetic events (generated and sent by another application). Enabling
- this resource opens up a possible security hole. The default is
- False.</Para>
- <Para><ComputerOutput>appCursorDefault</ComputerOutput>
- </Para>
- <Para Role="indent">If True, the cursor keys are initially in application mode. If False, they
- are initially in cursor mode. The
- default is False.</Para>
- <Para><ComputerOutput>appKeypadDefault</ComputerOutput>
- </Para>
- <Para Role="indent">If True, the keypad keys are initially in application mode. If False, they
- are initially in numeric mode. The
- default is False.</Para>
- <Para Id="autowrap"><ComputerOutput>autoWrap</ComputerOutput>
- </Para>
- <Para Role="indent">This resource specifies whether or not auto-wraparound is initially
- enabled. The default is True.</Para>
- <Para Id="background"><ComputerOutput>background</ComputerOutput>
- </Para>
- <Para Role="indent">This resource specifies the background color of the terminal window as
- well as the default background color used for the scrollbar. Under CDE,
- this resource
- defaults to either the primary color set select pixel or the primary
- color set background pixe (see <ComputerOutput>backgroundIsSelect</ComputerOutput>). The default is the
- primary color set background pixel. Without CDE,
- this resource defaults to black.</Para>
- <Para Id="bgndIsSel"><ComputerOutput>backgroundIsSelect</ComputerOutput>
- </Para>
- <Para Role="indent">When True, this resource specifies that the terminal window should use the Motif
- select color instead of the background color for the terminal window's
- background color. The default is False.</Para>
- <Para><ComputerOutput>blinkRate</ComputerOutput>
- </Para>
- <Para Role="indent">This resource specifies the number of milliseconds the cursor is in the
- <ComputerOutput>"on"</ComputerOutput> and <ComputerOutput>"off"</ComputerOutput>
- states while blinking. A value of
- 250 will blink the cursor two times per second. A value of 0
- will turn blinking off. The default is 250.</Para>
- <Para Id="bdrcol"><ComputerOutput>borderColor</ComputerOutput>
- </Para>
- <Para Role="indent">This resource defines the border color for the window. The window border
- may not be visible when reparenting window managers such as <ComputerOutput>dtwm</ComputerOutput> and
- <ComputerOutput>mwm</ComputerOutput> are used. The
- default is <ComputerOutput>"black"</ComputerOutput>.</Para>
- <Para Id="bwidth"><ComputerOutput>borderWidth</ComputerOutput>
- </Para>
- <Para Role="indent">This resource specifies the border width of the shell widget's window.
- This value may be overridden by reparenting window managers such as
- <ComputerOutput>dtwm</ComputerOutput> and <ComputerOutput>mwm</ComputerOutput>. The default is <ComputerOutput>0</ComputerOutput>.</Para>
- <Para Id="c132"><ComputerOutput>c132</ComputerOutput>
- </Para>
- <Para Role="indent">This resource specifies whether or not the DECCOLM escape sequence that
- switches to window with between 80 and 132 columns should be honored. The
- default is
- False.</Para>
- <Para><ComputerOutput>charCursorStyle</ComputerOutput>
- </Para>
- <Para Role="indent">This resource specifies the shape of the text cursor. A value of
- <ComputerOutput>char_cursor_box</ComputerOutput> specifies a cursor with the width and height of the
- base font's bounding box. A value of <ComputerOutput>char_cursor_bar</ComputerOutput> specifies a
- cursor with the width of the base font's bounding box, a height of two
- pixels, and drawn with it's top on the baseline. The default is
- <ComputerOutput>char_cursor_box</ComputerOutput>.</Para>
- <Para><ComputerOutput>consoleMode</ComputerOutput>
- </Para>
- <Para Role="indent">This resource specifies that output directed at <ComputerOutput>/dev/console</ComputerOutput> should be
- directed instead to the terminal window. It is provided as a way to
- prevent output that would normally be displayed on the ITE from
- overwriting the X server's display. It is not provided as a
- general mechanism to
- direct the output from an arbitrary system's <ComputerOutput>/dev/console</ComputerOutput> to an
- arbitrary X server. Note that you must have ownership of and read/write
- access to <ComputerOutput>/dev/console</ComputerOutput> for this option to work.
- The default is False.</Para>
- <Para Id="fg"><ComputerOutput>foreground</ComputerOutput>
- </Para>
- <Para Role="indent">This resource specifies the foreground color of the terminal window as well as
- the default foreground color used for the scrollbar and the color used
- for the pointer
- cursor. Under CDE, this resource will default to the primary
- colorset foreground. Otherwise, it defaults to <ComputerOutput>"white"</ComputerOutput>.</Para>
- <Para Id="geometry"><ComputerOutput>geometry</ComputerOutput>
- </Para>
- <Para Role="indent">This resource specifies the preferred size and position of the terminal
- window. The default size is 24 lines of 80 characters each. There is
- no default position.</Para>
- <Para Id="icongeom"><ComputerOutput>iconGeometry</ComputerOutput>
- </Para>
- <Para Role="indent">This resource specifies the preferred position of the terminal
- emulator's icon. Window managers may ignore this value.
- There is no default.</Para>
- <Para Id="iconic"><ComputerOutput>iconic</ComputerOutput>
- </Para>
- <Para Role="indent">If true, this resource specifies that the terminal emulator should
- initially be placed on the display iconified. Window managers (including
- <ComputerOutput>dtwm</ComputerOutput> and <ComputerOutput>mwm</ComputerOutput> may ignore this value.
- The default is False.</Para>
- <Para><ComputerOutput>iconicName</ComputerOutput>
- </Para>
- <Para Role="indent">This resource specifies the name for the icon. If the <ComputerOutput>-e</ComputerOutput> option is
- used, the default will be the last component of the program's path. If
- the <ComputerOutput>-e</ComputerOutput> option is not used, the default will be the base name of the
- name used to execute <ComputerOutput>dtterm</ComputerOutput> (i.e., <ComputerOutput>argv[0]</ComputerOutput>).</Para>
- <Para Id="jumpScroll"><ComputerOutput>jumpScroll</ComputerOutput>
- </Para>
- <Para Role="indent">This resource specifies that jump scrolling should be used. Under jump
- scrolling, the screen may be scrolled more than one line at a time. This
- provides for faster screen updates when multiple lines of text are being
- sent to the terminal. The maximum number of lines that may be jump
- scrolled is limited to the number of lines in the display. It is guaranteed that
- all lines will be displayed. The default is True.</Para>
- <Para Id="kshMode"><ComputerOutput>kshMode</ComputerOutput>
- </Para>
- <Para Role="indent">This resource specifies that ksh mode should be enabled. Under ksh mode,
- a key pressed with the extend modifier bit set will generate an escape
- character followed by the character generated by the un-extended
- keystroke. This option is provided for use with emacs and emacs command
- line editor mode of <ComputerOutput>ksh(1)</ComputerOutput> or <ComputerOutput>ied(1)</ComputerOutput>. It conflicts with the
- normal use of the meta key for generating extended single byte
- characters and for generating multi-byte Asian characters. The default
- is False.</Para>
- <Para Id="logfile"><ComputerOutput>logFile</ComputerOutput>
- </Para>
- <Para Role="indent">This resource specifies the name of the file to which the output log described
- below is written. If the filename begins with a pipe symbol (<ComputerOutput>|</ComputerOutput>), the
- rest of the string is assumed to be a command to be used as the endpoint of
- a pipe. The default filename is <ComputerOutput>DttermLog</ComputerOutput><Symbol Role="Variable">XXXXX</Symbol> (where <Symbol Role="Variable">XXXXX</Symbol>
- is a unique character string) and is created in the directory from
- which the subprocess was started.
- If the last five characters are "XXXXX," they
- are replaced by a unique character string.
- </Para>
- <Para Id="logging"><ComputerOutput>logging</ComputerOutput>
- </Para>
- <Para Role="indent">This resource enables output logging. When logging is enabled, all
- output received from the subprocess is logged either to a file or to a
- command pipeline (as specified via the <ComputerOutput>logFile</ComputerOutput> option above). Since
- the data is being logged directly from the subprocess, it includes all
- escape characters and carriage return/newline pairs sent by the terminal
- line discipline. Output may be enabled and disabled via
- escape sequences. The default is
- False.</Para>
- <Para><ComputerOutput>logInhibit</ComputerOutput>
- </Para>
- <Para Role="indent">This resource specifies that device and file logging should be inhibited.
- The default is False.</Para>
- <Para Id="logShell"><ComputerOutput>loginShell</ComputerOutput>
- </Para>
- <Para Role="indent">This resource specifies that the shell that is started should be a login
- shell (i.e. the first character of <ComputerOutput>argv[0]</ComputerOutput> will be a dash, indicating
- to the shell that it should read the system's <ComputerOutput>profile</ComputerOutput> and the user's
- <ComputerOutput>$HOME/.profile</ComputerOutput> (for <ComputerOutput>ksh</ComputerOutput> and <ComputerOutput>sh</ComputerOutput>) or the system's <ComputerOutput>csh.login</ComputerOutput> and
- the user's <ComputerOutput>$HOME/.login</ComputerOutput> (for <ComputerOutput>csh</ComputerOutput>). The default is False.</Para>
- <Para Id="maponout"><ComputerOutput>mapOnOutput</ComputerOutput>
- </Para>
- <Para Role="indent">This resource indicates that the terminal emulator should map
- (de-iconify) itself upon subprocess output if it is unmapped (iconified). An
- initial period of time during which it will not map itself upon subprocess
- output may be specified via the <ComputerOutput>mapOnOutputDelay</ComputerOutput> resource (see
- below). The default is False.</Para>
- <Para Id="maponoutdlay"><ComputerOutput>mapOnOutputDelay</ComputerOutput>
- </Para>
- <Para Role="indent">This resource specifies the number of seconds after start-up that
- <ComputerOutput>dtterm</ComputerOutput> will not honor the <ComputerOutput>mapOnOutput</ComputerOutput> resource (see above). This
- allows for initial output (e.g., shell prompts) to be sent to the
- terminal without auto mapping the window. The default is <ComputerOutput>0</ComputerOutput> (no delay)</Para>
- <Para Id="marginBell"><ComputerOutput>marginBell</ComputerOutput>
- </Para>
- <Para Role="indent">Specifies whether or not the bell should be run when the user types near
- the right margin. The default is False.</Para>
- <Para Id="menuresource"><ComputerOutput>menuBar</ComputerOutput>
- </Para>
- <Para Role="indent">This resources specifies that a pulldown menu should be displayed. The
- default is True.</Para>
- <Para Id="menuPopup"><ComputerOutput>menuPopup</ComputerOutput>
- </Para>
- <Para Role="indent">This resources specifies that a popup menu should be enabled. The
- default is True.</Para>
- <Para Id="nMarginBell"><ComputerOutput>nMarginBell</ComputerOutput>
- </Para>
- <Para Role="indent">Specifies the number of characters from the right margin at which the
- margin bell should be rung, when enabled. The default is 10.</Para>
- <Para Id="pointblank"><ComputerOutput>pointerBlank</ComputerOutput>
- </Para>
- <Para Role="indent">This resource specifies that the pointer cursor should be put into
- blanking mode. In this mode, the cursor will turn on when the pointer is
- moved, and will be blanked either after a selectable number of seconds
- or after keyboard input has occurred. The delay is set via the
- <ComputerOutput>pointerBlankDelay</ComputerOutput> resource (see below). The default is False.</Para>
- <Para Id="pointblankdelay"><ComputerOutput>pointerBlankDelay</ComputerOutput>
- </Para>
- <Para Role="indent">This resource defines the number of seconds to wait before blanking the
- pointer cursor after the pointer has been moved. A value of 0 invokes
- pointer blanking only on keyboard input. The default is 2
- seconds.</Para>
- <Para Id="pointcolor"><ComputerOutput>pointerColor</ComputerOutput>
- </Para>
- <Para Role="indent">This resource specifies the foreground color to use for the terminal
- window's pointer (X11) cursor. The default is to use the terminal window's
- foreground color. See <Link Type="jump" Linkend="fg"><ComputerOutput>foreground</ComputerOutput></Link> above.</Para>
- <Para><ComputerOutput>pointerColorBackground</ComputerOutput>
- </Para>
- <Para Role="indent">This resource specifies the background color to use for the terminal
- windows pointer (X11) cursor. The default is to use the terminal windows
- background color See <Link Type="jump" Linkend="background"><ComputerOutput>background</ComputerOutput></Link> above.</Para>
- <Para><ComputerOutput>pointerShape</ComputerOutput>
- </Para>
- <Para Role="indent">This resource specifies the X cursor font character to use as the pointer
- cursor. It should be specified as a string from the include file
- <ComputerOutput><X11/cursorfont.h></ComputerOutput> with the leading <ComputerOutput>XC_</ComputerOutput> removed. The default is
- <ComputerOutput>xterm</ComputerOutput>.</Para>
- <Para><ComputerOutput>reverseVideo</ComputerOutput>
- </Para>
- <Para Role="indent">This resource specifies whether or not reverse video should be
- used. The default is False.</Para>
- <Para Id="reverseWrap"><ComputerOutput>reverseWrap</ComputerOutput>
- </Para>
- <Para Role="indent">This resource specifies whether or not reverse-wraparound should be
- enabled. The default is False.</Para>
- <Para Id="savelines"><ComputerOutput>saveLines</ComputerOutput>
- </Para>
- <Para Role="indent">This resource specifies the number of lines in the terminal buffer beyond
- length of the window. The value value consists of a number followed by an
- optional suffix. If no suffix is included, or the suffix is "l" (ell), the
- total length of the terminal buffer will be <Symbol Role="Variable">screens</Symbol> plus the length of
- the terminal window. If the suffix is "s" (ess), the total length of the
- terminal buffer will be (<Symbol Role="Variable">screens</Symbol> plus one) times the length of the
- terminal window. <ComputerOutput>dtterm</ComputerOutput> will try to maintain the same buffer-to-window
- ratio when the window is resized larger. The default is "4s."</Para>
- <Para Id="scrollbar"><ComputerOutput>scrollBar</ComputerOutput>
- </Para>
- <Para Role="indent">This resource specifies whether or not the scrollbar should be visible.
- The
- default is True.</Para>
- <Para Id="sunfnctk"><ComputerOutput>sunFunctionKeys</ComputerOutput>
- </Para>
- <Para Role="indent">Specifies whether or not Sun Function Key escape codes should be
- generated for function keys instead of standard VT220 escape sequences.
- The default is False.</Para>
- <Para Id="termid"><ComputerOutput>termId</ComputerOutput>
- </Para>
- <Para Role="indent">This resource supplies the name used to select the correct response to
- terminal ID queries. Valid values are <ComputerOutput>vt100</ComputerOutput>, <ComputerOutput>vt101</ComputerOutput>, <ComputerOutput>vt102</ComputerOutput>,
- and <ComputerOutput>vt220</ComputerOutput>. The default is <ComputerOutput>vt220</ComputerOutput>.</Para>
- <Para Id="termname"><ComputerOutput>termName</ComputerOutput>
- </Para>
- <Para Role="indent">This resource defines the name for the
- <ComputerOutput>$TERM</ComputerOutput>
- environment variable. The default is <ComputerOutput>vt220</ComputerOutput>.</Para>
- <Para Id="title"><ComputerOutput>title</ComputerOutput>
- </Para>
- <Para Role="indent">This resource specifies the window title. If the <ComputerOutput>-e</ComputerOutput> option is used,
- the default will be the last component of the program's path. If the
- <ComputerOutput>-e</ComputerOutput> option is not used, the default will be the last component of the
- name used to execute <ComputerOutput>dtterm</ComputerOutput> (i.e., <ComputerOutput>argv[0]</ComputerOutput>).</Para>
- <Para Id="ttymodes"><ComputerOutput>ttyModes</ComputerOutput>
- </Para>
- <Para Role="indent">This resource specifies a string containing terminal-setting keywords
- and the characters to which they may be bound. Allowable keywords
- include: <ComputerOutput>intr, quit, erase, kill, eof, eol, swtch, start, stop, brk,
- susp, dsusp, rprnt, flush, weras</ComputerOutput>, and <ComputerOutput>Inext</ComputerOutput>. Keywords that do not
- apply to a specific architecture will be correctly parsed and ignored. Control characters may
- be specified as <ComputerOutput>^</ComputerOutput>followed by <ComputerOutput>char</ComputerOutput> (e.g. <ComputerOutput>^c</ComputerOutput> or <ComputerOutput>^u)</ComputerOutput>, and <ComputerOutput>^?</ComputerOutput>
- may be used to indicate
- delete. This is very useful for overriding the default terminal
- settings without having to do an <ComputerOutput>stty</ComputerOutput> every time a terminal process
- is started. The default is NULL.</Para>
- <Para><ComputerOutput>userBoldFont</ComputerOutput>
- </Para>
- <Para Role="indent">This resource specifies an XFontSet to be used when displaying bold
- terminal text. It should be specified as a Motif <ComputerOutput>XmFontList</ComputerOutput>. Only
- character or mono spaced fonts are supported. The behavior when using
- proportional fonts is undefined. A default bold font will be generated
- based on the XLFD name of the <ComputerOutput>userFont</ComputerOutput>. If that font is not available,
- bold text will be generated by overstriking (with a one pixel offset) the
- <ComputerOutput>userFont</ComputerOutput>.</Para>
- <Para Id="userFont"><ComputerOutput>userFont</ComputerOutput>
- </Para>
- <Para Role="indent">This resource specifies an XFontSet to be used when displaying
- terminal text. It should be specified as a Motif <ComputerOutput>XmFontList</ComputerOutput>. Only
- character or mono spaced fonts are supported. The behavior when using
- proportional fonts is undefined. This font will not be used to display
- non-terminal text (menu bar, popup menu, dialog, etc.). The default is to
- use the <ComputerOutput>XmNtextFontList</ComputerOutput> value of the parent bulletin board (see
- XmBulletinBoard(3X)) in the same manner as the <ComputerOutput>XmText</ComputerOutput> widget.</Para>
- <Para Id="visbell"><ComputerOutput>visualBell</ComputerOutput>
- </Para>
- <Para Role="indent">This resource specifies that a visual bell is preferred over an audible
- one. Instead of ringing the terminal bell whenever a CTRL-G is received,
- the windows will be flashed. The default is False.</Para>
- </Sect2>
- <Sect2 Id="pointerusage">
- <Title>POINTER USAGE</Title>
- <Para><ComputerOutput>dtterm</ComputerOutput>
- allows you to select regions of text. Selection is based on the model
- specified in the <CiteTitle>Inter-Client Communication Conventions Manual</CiteTitle>
- (ICCCM). <ComputerOutput>dtterm</ComputerOutput> supports primary selection only. You can copy or
- paste selected text using primary transfer. Input is treated as keyboard
- input, and is inserted at the cursor. The select/insert operations and their
- default assignments are described below.</Para>
- <VariableList>
- <VarListEntry>
- <Term><GlossTerm Role="nogloss">select</GlossTerm></Term>
- <ListItem>
- <Para>The left button is used to select the text
- to be copied. Move
- the pointer to the beginning of the text to copy, press and hold the left
- button, move the cursor to the end of the text to copy, and release the
- button. Any currently selected text can be deselected by clicking the left
- button once without moving the mouse.</Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term><GlossTerm Role="nogloss">insert</GlossTerm></Term>
- <ListItem>
- <Para>The middle button pastes the text from the primary selection,
- treating it as keyboard input.
- </Para>
- </ListItem>
- </VarListEntry>
- </VariableList>
- </Sect2>
- <Sect2 Id="actions">
- <Title>ACTIONS</Title>
- <Para>This topic describes the <ComputerOutput>dtterm</ComputerOutput> action routines.</Para>
- <Para><ComputerOutput>bell</ComputerOutput> ([<Emphasis>Percentage</Emphasis>])
- </Para>
- <Para Role="indent">This action rings the keyboard bell at the specified <Symbol Role="Variable">percentage</Symbol> above or
- below the base volume.</Para>
- <Para><ComputerOutput>break ()</ComputerOutput>
- </Para>
- <Para Role="indent">This action send a break signal to the child process.</Para>
- <Para><ComputerOutput>cancel ()</ComputerOutput>
- </Para>
- <Para Role="indent">This action sends a <ComputerOutput>CAN</ComputerOutput> (cancel) character to the child process.</Para>
- <Para><ComputerOutput>do ()</ComputerOutput>
- </Para>
- <Para Role="indent">This action sends the escape sequence associated with the <ComputerOutput>Do</ComputerOutput> key
- to the child process.</Para>
- <Para><ComputerOutput>edit-key</ComputerOutput> (<Symbol Role="Variable">string</Symbol>)
- </Para>
- <Para Role="indent">This action sends the escape sequence associated with the corresponding
- edit key to the child process. The interpretation of these keys is
- application specific.
- Valid values for <Symbol Role="Variable">string</Symbol> are
- <ComputerOutput>find</ComputerOutput>,
- <ComputerOutput>insert</ComputerOutput>,
- <ComputerOutput>next</ComputerOutput>,
- <ComputerOutput>prior</ComputerOutput>,
- <ComputerOutput>remove</ComputerOutput>, and
- <ComputerOutput>select</ComputerOutput>.</Para>
- <Para><ComputerOutput>extend-start()</ComputerOutput>
- </Para>
- <Para Role="indent">Start the extension of the currently selected text.</Para>
- <Para><ComputerOutput>extend-end ()</ComputerOutput>
- </Para>
- <Para Role="indent">Extends the current selection. The amount of text selected depends on
- the number of mouse clicks.</Para>
- <Para><ComputerOutput>function-key-execute</ComputerOutput> (<Emphasis>num</Emphasis> [,<Symbol Role="Variable">type</Symbol>])
- </Para>
- <Para Role="indent">This action sends the escape sequence associated with the corresponding
- function key <Emphasis>num</Emphasis> to the child process. Valid values for <Emphasis>num</Emphasis>
- are<ComputerOutput>1</ComputerOutput> through<ComputerOutput>35</ComputerOutput>. If <Symbol Role="Variable">type</Symbol> is set to <ComputerOutput>function</ComputerOutput>
- (or not set at all), the escape sequence associated with function
- key <Emphasis>num</Emphasis> is sent to the child process. If <Symbol Role="Variable">type</Symbol> is set to
- <ComputerOutput>UDK</ComputerOutput>, then the string associated with user defined key <Emphasis>num</Emphasis>
- is sent to the child process.</Para>
- <Para><ComputerOutput>grab-focus ()</ComputerOutput>
- </Para>
- <Para Role="indent">This action performs one of the following depending on the number of
- multiple mouse clicks. One click will deselect any selected text and
- set the selection anchor at the pointer position, two clicks will select
- a word, three clicks will select a line of text, and four clicks will
- select all text.</Para>
- <Para><ComputerOutput>hard-reset ()</ComputerOutput>
- </Para>
- <Para Role="indent">This action will perform a hard reset on the terminal emulator.</Para>
- <Para><ComputerOutput>help ()</ComputerOutput>
- </Para>
- <Para Role="indent">This action sends the escape sequence associated with the <ComputerOutput>DEC VT220</ComputerOutput>
- Help key to the child process.
- The interpretation of this key is application specific.</Para>
- <Para><ComputerOutput>keymap</ComputerOutput> (<Symbol Role="Variable">name</Symbol>)
- </Para>
- <Para Role="indent">This action dynamically defines a new translation table whose resource
- name is name with the suffix Keymap (case is significant). The name
- <ComputerOutput>None</ComputerOutput> restores the original translation table.</Para>
- <Para><ComputerOutput>keypad-key-execute</ComputerOutput> (<Symbol Role="Variable">string</Symbol>)
- </Para>
- <Para Role="indent">This action sends the escape sequence associated with the corresponding
- keypad key to the child process. The interpretation of these keys are
- application specific. Valid values for <Symbol Role="Variable">string</Symbol> include:
- <ComputerOutput>f1</ComputerOutput>-
- <ComputerOutput>f4</ComputerOutput>,
- <ComputerOutput>space</ComputerOutput>,
- <ComputerOutput>tab</ComputerOutput>,
- <ComputerOutput>enter</ComputerOutput>,
- <ComputerOutput>equal</ComputerOutput>,
- <ComputerOutput>multiply</ComputerOutput>,
- <ComputerOutput>add</ComputerOutput>,
- <ComputerOutput>separator</ComputerOutput>,
- <ComputerOutput>subtract</ComputerOutput>,
- <ComputerOutput>decimal</ComputerOutput>,
- <ComputerOutput>divide</ComputerOutput>, and
- <ComputerOutput>0</ComputerOutput> -
- <ComputerOutput>9</ComputerOutput>.</Para>
- <Para><ComputerOutput>move-cursor</ComputerOutput> (<Symbol Role="Variable">direction</Symbol>)
- </Para>
- <Para Role="indent">This action sends the escape sequence associated with the corresponding
- cursor motion to the child process. The interpretation of these keys are
- application specific. Valid values for <Symbol Role="Variable">direction</Symbol> include:
- <ComputerOutput>up</ComputerOutput>,
- <ComputerOutput>down</ComputerOutput>,
- <ComputerOutput>backward</ComputerOutput>, and
- <ComputerOutput>forward</ComputerOutput>.</Para>
- <Para><ComputerOutput>redraw-display ()</ComputerOutput>
- </Para>
- <Para Role="indent">This action redraws the contents of the text window.</Para>
- <Para><ComputerOutput>scroll</ComputerOutput> (<Symbol Role="Variable">count</Symbol> [,<Symbol Role="Variable">units</Symbol>])
- </Para>
- <Para Role="indent">This action will scroll the display memory down if <Symbol Role="Variable">count</Symbol> is less than
- zero, or up if <Symbol Role="Variable">count</Symbol> is ggeater than zero. The number of lines scrolled is
- based on count and units. Valid values for <Symbol Role="Variable">units</Symbol> are
- <ComputerOutput>page</ComputerOutput>,
- <ComputerOutput>halfpage</ComputerOutput>, or
- <ComputerOutput>line</ComputerOutput>.
- The default for units is <ComputerOutput>line</ComputerOutput>.</Para>
- <Para><ComputerOutput>select-adjust ()</ComputerOutput>
- </Para>
- <Para Role="indent">This action extends the selection. The amount of text selected depends on the
- number of mouse clicks:
- </Para>
- <ItemizedList Mark="•" Role="tight">
- <ListItem Id="HTRM.REF.item.18">
- <Para>1 click = char
- </Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.19">
- <Para>2 clicks = word
- </Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.20">
- <Para>3 clicks = line
- </Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.21">
- <Para>4 clicks = buffer
- </Para>
- </ListItem>
- </ItemizedList>
- <Para><ComputerOutput>select-all ()</ComputerOutput>
- </Para>
- <Para Role="indent">This action selects all text.</Para>
- <Para><ComputerOutput>select-page ()</ComputerOutput>
- </Para>
- <Para Role="indent">This action selects all text on the screen.</Para>
- <Para><ComputerOutput>self-insert ()</ComputerOutput>
- </Para>
- <Para Role="indent">This action sends the character associated with the key pressed to the child
- process.</Para>
- <Para><ComputerOutput>soft-reset ()</ComputerOutput>
- </Para>
- <Para Role="indent">This action perform a soft reset of the terminal.</Para>
- <Para><ComputerOutput>stop</ComputerOutput> (<Symbol Role="Variable">state</Symbol>)
- </Para>
- <Para Role="indent">This action either toggles, starts, or stops the process of reading data
- from the child process. Valid values for <Symbol Role="Variable">state</Symbol> are
- <ComputerOutput>toggle</ComputerOutput>,
- <ComputerOutput>on</ComputerOutput>, and
- <ComputerOutput>off</ComputerOutput>.</Para>
- <Para><ComputerOutput>string</ComputerOutput> (<Symbol Role="Variable">string</Symbol>)
- </Para>
- <Para Role="indent">This action insert the specified text string as if it had been typed.
- The string must be quoted if it contains whitespace or non-alphanumeric
- characters. The string is interpreted as a hex character constant if it
- begins with the characters <ComputerOutput>0x</ComputerOutput>.</Para>
- <Para><ComputerOutput>tab ()</ComputerOutput>
- </Para>
- <Para Role="indent">This action sends a tab to the child process.</Para>
- <Para><ComputerOutput>visual-bell ()</ComputerOutput>
- </Para>
- <Para Role="indent">This action flashes the window quickly.</Para>
- <Procedure>
- <Title>Virtual Bindings</Title>
- <Step>
- <Para>The bindings for virtual keys are vendor specific.
- Virtual bindings do not apply when the <ComputerOutput>dtterm</ComputerOutput> widget has input focus.
- For information about bindings for virtual buttons and keys, see <ComputerOutput>VirtualBindings(3X)</ComputerOutput>.</Para>
- </Step>
- </Procedure>
- </Sect2>
- <Sect2 Id="translations">
- <Title>TRANSLATIONS</Title>
- <Para><ComputerOutput>dtterm</ComputerOutput> includes translations from Primitive.
- Note that altering translations in <ComputerOutput>#override</ComputerOutput>
- or <ComputerOutput>#augment</ComputerOutput> mode is undefined.</Para>
- <VariableList>
- <VarListEntry>
- <Term>Shift~Ctrl<Key>KP_Multiply:</Term>
- <ListItem>
- <Para>XtDisplayInstalledAccelerators()
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~ShiftCtrl<Key>KP_Multiply:</Term>
- <ListItem>
- <Para>XtDisplayAccelerators()
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>ShiftCtrl<Key>KP_Multiply:</Term>
- <ListItem>
- <Para>XtDisplayTranslations()
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term><Key>osfCancel:</Term>
- <ListItem>
- <Para>process-cancel()
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term><Key>osfCopy:</Term>
- <ListItem>
- <Para>copy-clipboard()
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term><Key>osfCut:</Term>
- <ListItem>
- <Para>copy-clipboard()
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term><Key>osfPaste:</Term>
- <ListItem>
- <Para>paste-clipboard()
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term><Key>osfBeginLine:</Term>
- <ListItem>
- <Para>beginning-of-buffer()
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term><Key>osfEndLine:</Term>
- <ListItem>
- <Para>end-of-buffer()
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>osfUp:</Term>
- <ListItem>
- <Para>scroll(1,line)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>osfDown:</Term>
- <ListItem>
- <Para>scroll(-1,line)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term><Key>osfUp:</Term>
- <ListItem>
- <Para>move-cursor(up)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term><Key>osfDown:</Term>
- <ListItem>
- <Para>move-cursor(down)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term><Key>osfLeft:</Term>
- <ListItem>
- <Para>move-cursor(backward)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term><Key>osfRight:</Term>
- <ListItem>
- <Para>move-cursor(forward)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term><Key>Find:</Term>
- <ListItem>
- <Para>vt-edit-key(find)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term><Key>Insert:</Term>
- <ListItem>
- <Para>vt-edit-key(insert)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term><Key>Select:</Term>
- <ListItem>
- <Para>vt-edit-key(select)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term><Key>Do:</Term>
- <ListItem>
- <Para>vt-edit-key(do)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term><Key>Help:</Term>
- <ListItem>
- <Para>vt-edit-key(help)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term><Key>Menu:</Term>
- <ListItem>
- <Para>vt-edit-key(menu)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>osfPageUp:</Term>
- <ListItem>
- <Para>vt-edit-key(prior)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>osfPageDown:</Term>
- <ListItem>
- <Para>vt-edit-key(next)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term><Key>osfPageUp:</Term>
- <ListItem>
- <Para>scroll(-1,page)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term><Key>osfPageDown:</Term>
- <ListItem>
- <Para>scroll(1,page)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Mod1<Key>Break:</Term>
- <ListItem>
- <Para>soft-reset()
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>Break:</Term>
- <ListItem>
- <Para>hard-reset()
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift ~Mod1<Key>Break:</Term>
- <ListItem>
- <Para>vt-break()
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Ctrl<Key>Cancel:</Term>
- <ListItem>
- <Para>stop(long)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Ctrl<Key>Cancel:</Term>
- <ListItem>
- <Para>stop()
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>Tab:</Term>
- <ListItem>
- <Para>tab()
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Mod1<Key>KP_Space:</Term>
- <ListItem>
- <Para>keypad-key-execute(space)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Mod1<Key>KP_Tab:</Term>
- <ListItem>
- <Para>keypad-key-execute(tab)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Mod1<Key>KP_Enter:</Term>
- <ListItem>
- <Para>keypad-key-execute(enter)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Mod1<Key>KP_F1:</Term>
- <ListItem>
- <Para>keypad-key-execute(f1)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Mod1<Key>KP_F2:</Term>
- <ListItem>
- <Para>keypad-key-execute(f2)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Mod1<Key>KP_F3:</Term>
- <ListItem>
- <Para>keypad-key-execute(f3)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Mod1<Key>KP_F4:</Term>
- <ListItem>
- <Para>keypad-key-execute(f4)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Mod1<Key>KP_Equal:</Term>
- <ListItem>
- <Para>keypad-key-execute(equal)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Mod1<Key>KP_Multiply:</Term>
- <ListItem>
- <Para>keypad-key-execute(multiply)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Mod1<Key>KP_Add:</Term>
- <ListItem>
- <Para>keypad-key-execute(add)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Mod1<Key>KP_Separator:</Term>
- <ListItem>
- <Para>keypad-key-execute(separator)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Mod1<Key>KP_Subtract:</Term>
- <ListItem>
- <Para>keypad-key-execute(subtract)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Mod1<Key>KP_Decimal:</Term>
- <ListItem>
- <Para>keypad-key-execute(decimal)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Mod1<Key>KP_Divide:</Term>
- <ListItem>
- <Para>keypad-key-execute(divide)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Mod1<Key>KP_0:</Term>
- <ListItem>
- <Para>keypad-key-execute(0)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Mod1<Key>KP_1:</Term>
- <ListItem>
- <Para>keypad-key-execute(1)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Mod1<Key>KP_2:</Term>
- <ListItem>
- <Para>keypad-key-execute(2)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Mod1<Key>KP_3:</Term>
- <ListItem>
- <Para>keypad-key-execute(3)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Mod1<Key>KP_4:</Term>
- <ListItem>
- <Para>keypad-key-execute(4)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Mod1<Key>KP_5:</Term>
- <ListItem>
- <Para>keypad-key-execute(5)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Mod1<Key>KP_6:</Term>
- <ListItem>
- <Para>keypad-key-execute(6)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Mod1<Key>KP_7:</Term>
- <ListItem>
- <Para>keypad-key-execute(7)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Mod1<Key>KP_8:</Term>
- <ListItem>
- <Para>keypad-key-execute(8)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Mod1<Key>KP_9:</Term>
- <ListItem>
- <Para>keypad-key-execute(9)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>F1:</Term>
- <ListItem>
- <Para>vt-function-key-execute(1, UDK)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>F2:</Term>
- <ListItem>
- <Para>vt-function-key-execute(2, UDK)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>F3:</Term>
- <ListItem>
- <Para>vt-function-key-execute(3, UDK)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>F4:</Term>
- <ListItem>
- <Para>vt-function-key-execute(4, UDK)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>F5:</Term>
- <ListItem>
- <Para>vt-function-key-execute(5, UDK)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>F6:</Term>
- <ListItem>
- <Para>vt-function-key-execute(6, UDK)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>F7:</Term>
- <ListItem>
- <Para>vt-function-key-execute(7, UDK)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>F8:</Term>
- <ListItem>
- <Para>vt-function-key-execute(8, UDK)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>F9:</Term>
- <ListItem>
- <Para>vt-function-key-execute(9, UDK)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>F10:</Term>
- <ListItem>
- <Para>vt-function-key-execute(10, UDK)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>F11:</Term>
- <ListItem>
- <Para>vt-function-key-execute(11, UDK)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>F12:</Term>
- <ListItem>
- <Para>vt-function-key-execute(12, UDK)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>F13:</Term>
- <ListItem>
- <Para>vt-function-key-execute(13, UDK)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>F14:</Term>
- <ListItem>
- <Para>vt-function-key-execute(14, UDK)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>F15:</Term>
- <ListItem>
- <Para>vt-function-key-execute(15, UDK)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>F16:</Term>
- <ListItem>
- <Para>vt-function-key-execute(16, UDK)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>F17:</Term>
- <ListItem>
- <Para>vt-function-key-execute(17, UDK)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>F18:</Term>
- <ListItem>
- <Para>vt-function-key-execute(18, UDK)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>F19:</Term>
- <ListItem>
- <Para>vt-function-key-execute(19, UDK)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>F20:</Term>
- <ListItem>
- <Para>vt-function-key-execute(20, UDK)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>F21:</Term>
- <ListItem>
- <Para>vt-function-key-execute(21, UDK)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>F22:</Term>
- <ListItem>
- <Para>vt-function-key-execute(22, UDK)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>F23:</Term>
- <ListItem>
- <Para>vt-function-key-execute(23, UDK)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>F24:</Term>
- <ListItem>
- <Para>vt-function-key-execute(24, UDK)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>F25:</Term>
- <ListItem>
- <Para>vt-function-key-execute(25, UDK)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>F26:</Term>
- <ListItem>
- <Para>vt-function-key-execute(26, UDK)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>F27:</Term>
- <ListItem>
- <Para>vt-function-key-execute(27, UDK)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>F28:</Term>
- <ListItem>
- <Para>vt-function-key-execute(28, UDK)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>F29:</Term>
- <ListItem>
- <Para>vt-function-key-execute(29, UDK)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>F30:</Term>
- <ListItem>
- <Para>vt-function-key-execute(30, UDK)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>F31:</Term>
- <ListItem>
- <Para>vt-function-key-execute(31, UDK)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>F32:</Term>
- <ListItem>
- <Para>vt-function-key-execute(32, UDK)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>F33:</Term>
- <ListItem>
- <Para>vt-function-key-execute(33, UDK)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>F34:</Term>
- <ListItem>
- <Para>vt-function-key-execute(34, UDK)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift<Key>F35:</Term>
- <ListItem>
- <Para>vt-function-key-execute(35, UDK)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>F1:</Term>
- <ListItem>
- <Para>vt-function-key-execute(1, function)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>F2:</Term>
- <ListItem>
- <Para>vt-function-key-execute(2, function)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>F3:</Term>
- <ListItem>
- <Para>vt-function-key-execute(3, function)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>F4:</Term>
- <ListItem>
- <Para>vt-function-key-execute(4, function)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>F5:</Term>
- <ListItem>
- <Para>vt-function-key-execute(5, function)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>F6:</Term>
- <ListItem>
- <Para>vt-function-key-execute(6, function)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>F7:</Term>
- <ListItem>
- <Para>vt-function-key-execute(7, function)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>F8:</Term>
- <ListItem>
- <Para>vt-function-key-execute(8, function)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>F9:</Term>
- <ListItem>
- <Para>vt-function-key-execute(9, function)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>F10:</Term>
- <ListItem>
- <Para>vt-function-key-execute(10, function)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>F11:</Term>
- <ListItem>
- <Para>vt-function-key-execute(11, function)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>F12:</Term>
- <ListItem>
- <Para>vt-function-key-execute(12, function)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>F13:</Term>
- <ListItem>
- <Para>vt-function-key-execute(13, function)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>F14:</Term>
- <ListItem>
- <Para>vt-function-key-execute(14, function)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>F15:</Term>
- <ListItem>
- <Para>vt-function-key-execute(15, function)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>F16:</Term>
- <ListItem>
- <Para>vt-function-key-execute(16, function)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>F17:</Term>
- <ListItem>
- <Para>vt-function-key-execute(17, function)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>F18:</Term>
- <ListItem>
- <Para>vt-function-key-execute(18, function)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>F19:</Term>
- <ListItem>
- <Para>vt-function-key-execute(19, function)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>F20:</Term>
- <ListItem>
- <Para>vt-function-key-execute(20, function)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>F21:</Term>
- <ListItem>
- <Para>vt-function-key-execute(21, function)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>F22:</Term>
- <ListItem>
- <Para>vt-function-key-execute(22, function)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>F23:</Term>
- <ListItem>
- <Para>vt-function-key-execute(23, function)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>F24:</Term>
- <ListItem>
- <Para>vt-function-key-execute(24, function)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>F25:</Term>
- <ListItem>
- <Para>vt-function-key-execute(25, function)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>F26:</Term>
- <ListItem>
- <Para>vt-function-key-execute(26, function)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>F27:</Term>
- <ListItem>
- <Para>vt-function-key-execute(27, function)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>F28:</Term>
- <ListItem>
- <Para>vt-function-key-execute(28, function)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>F29:</Term>
- <ListItem>
- <Para>vt-function-key-execute(29, function)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>F30:</Term>
- <ListItem>
- <Para>vt-function-key-execute(30, function)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>F31:</Term>
- <ListItem>
- <Para>vt-function-key-execute(31, function)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>F32:</Term>
- <ListItem>
- <Para>vt-function-key-execute(32, function)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>F33:</Term>
- <ListItem>
- <Para>vt-function-key-execute(33, function)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>F34:</Term>
- <ListItem>
- <Para>vt-function-key-execute(34, function)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Key>F35:</Term>
- <ListItem>
- <Para>vt-function-key-execute(35, function)
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term><KeyRelease>:</Term>
- <ListItem>
- <Para>key-release()
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term><KeyPress>:</Term>
- <ListItem>
- <Para>insert()
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift~Ctrl<Btn1Down>:</Term>
- <ListItem>
- <Para>grab-focus()
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>Shift~Ctrl<Btn1Down>:</Term>
- <ListItem>
- <Para>extend-start()
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Ctrl<Btn1Motion>:</Term>
- <ListItem>
- <Para>select-adjust()
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Ctrl<Btn1Up>:</Term>
- <ListItem>
- <Para>extend-end()
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Btn2Down>:</Term>
- <ListItem>
- <Para>process-bdrag()
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term>~Shift<Btn2Up>:</Term>
- <ListItem>
- <Para>copy-to()
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term><EnterWindow>:</Term>
- <ListItem>
- <Para>enter()
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term><LeaveWindow>:</Term>
- <ListItem>
- <Para>leave()
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term><FocusIn>:</Term>
- <ListItem>
- <Para>focus-in()
- </Para>
- </ListItem>
- </VarListEntry>
- <VarListEntry>
- <Term><FocusOut>:</Term>
- <ListItem>
- <Para>focus-out()
- </Para>
- </ListItem>
- </VarListEntry>
- </VariableList>
- </Sect2>
- </Sect1>
- <Sect1 Id="EscapeSequences">
- <Title>dtterm Escape Sequences</Title>
- <Para>Each of the topics below contains a list of applicable escape sequences.
- See the <ComputerOutput>dtterm(5x)</ComputerOutput> man page for more detailed information.</Para>
- <ItemizedList Mark="•">
- <ListItem Id="HTRM.REF.item.22">
- <Para><XRef Linkend="CursorKeys"></Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.23">
- <Para><XRef Linkend="AuxKeypad"></Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.24">
- <Para><XRef Linkend="FunctionKeys"></Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.25">
- <Para><XRef Linkend="SunFunctionKeys"></Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.26">
- <Para><XRef Linkend="ReceivedEscapeSequences"></Para>
- </ListItem>
- </ItemizedList>
- <Sect2 Id="CursorKeys">
- <Title>Cursor Keys, VT220 Mode</Title>
- <Para>The table below shows the key press and the corresponding escape sequences
- sent for Normal and Application modes.
- </Para>
- <ProgramListing>Cursor Key Mode
- KEY Normal Application
- ========= ====== ===========
- Cursor Up Esc[A EscOA
- Cursor Down Esc[B EscOB
- Cursor Right Esc[C EscOC
- Cursor Left Esc[D EscOD
- </ProgramListing>
- </Sect2>
- <Sect2 Id="AuxKeypad">
- <Title>Auxiliary Keypad, ANSI Mode</Title>
- <Para>The table below shows the key press and the corresponding escape sequences
- sent for Numeric and Application modes.
- </Para>
- <ProgramListing>Application Keypad Mode
- KEY Normal Application
- ========= ====== ===========
- space space EscOA
- tab tab EscOI
- Enter CR/CR-LF EscOM
- PF1 EscOP EscOP
- PF2 EscOQ EscOQ
- PF3 EscOR EscOR
- PF4 EscOS EscOS
- * (multiply) * EscOj
- + (add) + EscOk
- , (comma) , EscOl
- - (minus) - EscOm
- . (period) . EscOn
- / (divide) / EscOo
- 0 0 EscOp
- 1 1 EscOq
- 2 2 EscOr
- 3 3 EscOs
- 4 4 EscOt
- 5 5 EscOu
- 6 6 EscOv
- 7 7 EscOw
- 8 8 EscOx
- 9 9 EscOy
- =(equal) = EscOX
- </ProgramListing>
- </Sect2>
- <Sect2 Id="FunctionKeys">
- <Title>Function Keys, VT220 Mode</Title>
- <Para>The table below shows the key press and the corresponding escape sequences
- sent.
- </Para>
- <ProgramListing>KEY Escape Sequence Sent
- ========= ====================
- F1 Esc[11~
- F2 Esc[12~
- F3 Esc[13~
- F4 Esc[14~
- F5 Esc[15~
- F6 Esc[17~
- F7 Esc[18~
- F8 Esc[19~
- F9 Esc[20~
- F10 Esc[21~
- F11 Esc[23~
- F12 Esc[24~
- F13 Esc[25~
- F14 Esc[26~
- F15 Esc[28~
- F16 Esc[29~
- F17 Esc[31~
- F18 Esc[32~
- F19 Esc[33~
- F20 Esc[34~
- Help Esc[28~
- Menu Esc[29~
- Find Esc[1~
- Insert Esc[2~
- Remove Esc[3~
- Select Esc[4~
- Prior Esc[5~
- Next Esc[6~
- </ProgramListing>
- </Sect2>
- <Sect2 Id="SunFunctionKeys">
- <Title>Function Keys, sunFunctionKeys Mode</Title>
- <Para>The table below shows the key press and the corresponding escape sequences
- sent.
- </Para>
- <ProgramListing>KEY Escape Sequence Sent
- ========= ====================
- F1 Esc[224z
- F2 Esc[225z
- F3 Esc[226z
- F4 Esc[227z
- F5 Esc[228z
- F6 Esc[229z
- F7 Esc[230z
- F8 Esc[231z
- F9 Esc[232z
- F10 Esc[233z
- F11 Esc[192z
- F12 Esc[193z
- F13 Esc[194z
- F14 Esc[195z
- F15 Esc[196z
- F16 Esc[197z
- F17 Esc[198z
- F18 Esc[199z
- F19 Esc[200z
- F20 Esc[201z
- F21 (R1) Esc[208z
- F22 (R2) Esc[209z
- F23 (R3) Esc[210z
- F24 (R4) Esc[211z
- F25 (R5) Esc[212z
- F26 (R6) Esc[213z
- F27 (R7) Esc[214z
- F28 (R8) Esc[215z
- F29 (R9) Esc[216z
- F30 (R10) Esc[217z
- F31 (R11) Esc[218z
- F32 (R12) Esc[219z
- F33 (R13) Esc[220z
- F34 (R14) Esc[221z
- F35 (R15) Esc[222z
- Help Esc[196z
- Menu Esc[197z
- Find Esc[1z
- Insert Esc[2z
- Remove Esc[3z
- Select Esc[4z
- Prior Esc[5z
- Next Esc[6z
- </ProgramListing>
- </Sect2>
- <Sect2 Id="ReceivedEscapeSequences">
- <Title>Received Escape Sequences</Title>
- <Para>The following table describes the received escape sequences supported by dtterm.
- </Para>
- <ProgramListing>Escape
- Sequence Description
- ======== ===========
- Ctrl-G Bell (Ctrl-G)
- Ctrl-H Backspace (Ctrl-H)
- Ctrl-I Horizontal Tab (HT) (Ctrl-I)
- Ctrl-J Line Feed or New Line (NL) (Ctrl-J)
- Ctrl-K Vertical Tab same as Line Feed
- Ctrl-L Form Feed or New Page same as Line Feed
- Ctrl-M Carriage Return (Ctrl-M)
- Esc ( B Designate ASCII (base font) as G0.
- Esc ( 0 Designate DEC Special Graphic (line draw) as G0.
- Esc ) B Designate ASCII (base font) as G1.
- Esc ) 0 Designate DEC Special Graphic (line draw) as G1.
- Esc * B Designate ASCII (base font) as G2.
- Esc * 0 Designate DEC Special Graphic (line draw) as G2.
- Esc + B Designate ASCII (base font) as G3.
- Esc + 0 Designate DEC Special Graphic (line draw) as G3.
- Ctrl-N Map G1 into GL.
- Ctrl-O Map G0 into GL.
- Esc n Map G2 into GL.
- Esc o Map G3 into GL.
- Esc N Map G2 into GL for the next character.
- Esc O Map G3 into GL for the next character.
- Esc Space F Select 7-bit C1 Control Characters. In this mode, the
- dtterm utility sends all C1 Control Characters to the
- host as 7-bit escape sequences. That is, CSI is sent to
- the host as <ComputerOutput>&newline;f2Esc&newline;fP [</ComputerOutput>.
- Esc Space G Select 8-bit C1 Control Characters. In this mode, the
- dtterm utility sends all C1 Control Characters to the
- host as 8-bit control codes. That is, CSI is sent back
- as the hexadecimal value 0x9B.
- Esc#8 DEC Screen Align Test (DECALN)
- Esc7 Save Cursor (DECSC)
- Esc8 Restore Cursor (DECRC)
- Esc= Application Keypad (DECPAM)
- Esc> Normal Keypad (DECPNM)
- EscD Index (IND)
- EscE Next Line (NEL)
- EscH Tab Set (HTS)
- EscM Reverse Index (RI)
- EscP<Symbol Role="Variable">pi;pi|pi/hex digits;pi/hex digits;...</Symbol>Esc&newline;
- Device Control String (DCS)
- EscZ Return Terminal ID (DECID)
- Escc Full Reset (RIS)
- Escn Select the G2 Character Set (LS2)
- Esco Select the G3 Character Set (LS3)
- Esc[<Symbol Role="Variable">pi</Symbol>"p Select Compatibility Level (DECSCL)
- Esc[<Symbol Role="Variable">pi</Symbol>@ Insert Blank Characters (ICH)
- Esc[<Symbol Role="Variable">pi</Symbol>A Cursor Up (CUU)
- Esc[<Symbol Role="Variable">pi</Symbol>B Cursor Down (CUD)
- Esc[<Symbol Role="Variable">pi</Symbol>C Cursor Forward (CUF)
- Esc[<Symbol Role="Variable">pi</Symbol>D Cursor Backward (CUB)
- Esc[<Symbol Role="Variable">pi</Symbol>F Cursor to <Symbol Role="Variable">pi</Symbol>th preceding line (CPL)
- Esc[<Symbol Role="Variable">pi</Symbol>G Cursor to Column p (CHA)
- Esc[<Symbol Role="Variable">pi;</Symbol> <Symbol Role="Variable">pi</Symbol>H Cursor Position (CUP)
- Esc[<Symbol Role="Variable">pi</Symbol>J Erase in Display (ED)
- Esc[<Symbol Role="Variable">pi</Symbol>K Erase in Line (EL)
- Esc[<Symbol Role="Variable">pi</Symbol>L Insert Lines (IL)
- Esc[<Symbol Role="Variable">pi</Symbol>M Delete Lines (DL)
- Esc[<Symbol Role="Variable">pi</Symbol>P Delete Characters (DCH)
- Esc[<Symbol Role="Variable">pi</Symbol>S Scroll up p lines (SU)
- Esc[<Symbol Role="Variable">pi</Symbol>T Scroll Down (SD)
- Esc[<Symbol Role="Variable">pi</Symbol>X Erase <Symbol Role="Variable">pi</Symbol> characters (ECH)
- Esc[<Symbol Role="Variable">pi</Symbol>c Send Device Attributes
- Esc[<Symbol Role="Variable">pi;</Symbol> <Symbol Role="Variable">pi</Symbol>f Horizontal and Vertical Position (HVP)
- Esc[<Symbol Role="Variable">pi</Symbol>g Tab Clear (TBC)
- Esc[<Symbol Role="Variable">pi</Symbol>h Set Mode (SM)
- Esc[<Symbol Role="Variable">pi</Symbol>l Reset Mode (RM)
- Esc[<Symbol Role="Variable">pi</Symbol>m Character Attributes (SGR)
- Esc[<Symbol Role="Variable">pi</Symbol>n Device Status Report (DSR)
- Esc[<Symbol Role="Variable">pi;</Symbol> <Symbol Role="Variable">pi</Symbol>r Set Scrolling Region (DECSTBM)
- Esc[<Symbol Role="Variable">pi</Symbol>x Request Terminal Parameters
- Esc[?<Symbol Role="Variable">pi</Symbol>h DEC Private Mode Set (DECSET)
- Esc[?<Symbol Role="Variable">pi</Symbol>l DEC Private Mode Reset (DECRSET)
- Esc[?<Symbol Role="Variable">pi</Symbol>n DEC Private Mode Status (DSR)
- Esc[?<Symbol Role="Variable">pi</Symbol>r Restore DEC Private Mode Values
- Esc[?<Symbol Role="Variable">pi</Symbol>s Save DEC Private Mode Values
- Esc]?<Symbol Role="Variable">pi;</Symbol> <Symbol Role="Variable">pi</Symbol>Ctrl-G
- Set Text Parameters
- Esc]<Symbol Role="Variable">p1;p2;p3t</Symbol> Sun Escape Sequences
- Esc_<Symbol Role="Variable">pi</Symbol>Esc\ Application Program
- Esc[?<Symbol Role="Variable">pi</Symbol>K Selective erase in line (DECSEL)
- Esc[?<Symbol Role="Variable">pi</Symbol>J Selective erase in display (DECSED)
- Esc!p Soft Terminal Reset (DECSTR)
- </ProgramListing>
- </Sect2>
- </Sect1>
- <Sect1 Id="Keyboard">
- <Title>dtterm Keyboard Information</Title>
- <IndexTerm>
- <Primary>keyboard information</Primary>
- </IndexTerm>
- <Para>This topic contains a list of keyboard functionality associated with dtterm.
- It
- includes only the keys that are special for dtterm. They apply only
- when the terminal text area has the keyboard focus. They do <Symbol Role="Variable">not</Symbol>
- apply when a dialog, pulldown, or popup menu has the keyboard focus.
- In some cases, additional modifiers
- are ignored. For example, the description for F1 does not apply to Shift
- F1, but the description of Tab applies to both Tab and Shift Tab.</Para>
- <ProgramListing><Key>Home Scroll to beginning of the buffer
- Shift<Key>Home Scroll to the end of the buffer
- Shift<Key>Prior Scroll up one page
- Shift<Key>Next Scroll down one page
- <Key>Up Sends the escape sequence as described
- in dtterm Escape Sequences
- <Key>Down Sends the escape sequence as described
- in dtterm Escape Sequences
- <Key>Left Sends the escape sequence as described
- in dtterm Escape Sequences
- <Key>Right Sends the escape sequence as described
- in dtterm Escape Sequences
- CTRL<Key>Up Sends the escape sequence as described
- in dtterm Escape Sequences
- CTRL<Key>Down Sends the escape sequence as described
- in dtterm Escape Sequences
- CTRL<Key>Left Sends the escape sequence as described
- in dtterm Escape Sequences
- CTRL<Key>Right Sends the escape sequence as described
- in dtterm Escape Sequences
- <Key>Prior
- <Key>Next
- <Key>Find
- <Key>Insert
- <Key>Select
- <Key>Cancel Toggles on/off subprocess output.
- <Key>Tab Sends a tab character.
- <Key>Break Sends an RS232 break to the subprocess.
- Meta<Key>Break Soft Reset as described in dtterm Escape Sequences.
- Shift<Key>Break Hard Reset as described in dtterm Escape Sequences.
- <Key>F1 Sends the function key escape sequence
- through as described in dtterm Escape Sequences.
- <Key>F35
- Shift<Key>F1 Sends the user defined sequence (if any)
- through for that key.
- Shift<Key>F35
- Esc Sends the escape character
- <Key>KP_F1 Sends the escape sequence as described
- through in dtterm Escape Sequences.
- <Key>KP_F4
- <Key>KP_0 Sends either the char or escape sequence
- through as described in dtterm Escape Sequences.
- <Key>KP_9
- <Key>KP_Equal
- <Key>KP_Multiply
- <Key>KP_Add
- <Key>KP_Separator
- <Key>KP_Subtract
- <Key>KP_Decimal
- <Key>KP_Divide
- <Key>KP_Space
- <Key>KP_Tab
- <Key>KP_Enter
- </ProgramListing>
- <para>Note that not all vendors' keyboards supply these keys.
- Please see your local vendor's documentation for alternate key bindings.
- </para>
- </Sect1>
- <Sect1 Id="GlobOpts">
- <Title>Global Options Dialog Box</Title>
- <Para>There are four areas that you can control from the Global Options dialog
- box:
- </Para>
- <ItemizedList Mark="•" Role="tight">
- <ListItem Id="HTRM.REF.item.27">
- <Para><XRef Linkend="CursorControl"></Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.28">
- <Para><XRef Linkend="ColorControl"></Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.29">
- <Para><XRef Linkend="ScrollBehavior"></Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.30">
- <Para><XRef Linkend="BellControl"></Para>
- </ListItem>
- </ItemizedList>
- <Para>Each of these areas contains one or more option menus from which you can
- choose values for a particular option.</Para>
- <Note>
- <Para>Any changes made in the Global Options dialog box apply only to the
- <ComputerOutput>dtterm</ComputerOutput> window from which you accessed the dialog box.
- </Para>
- </Note>
- <Graphic Entityref="globopts" Id="HTRM.REF.fig.1"></Graphic>
- <Sect2 Id="CursorControl">
- <Title>Cursor Control</Title>
- <Para>All of the cursor aspects are controlled by selecting a choice in an options
- menu button or, in the case of the Blink Rate option, entering a value in
- the text
- field.
- </Para>
- <Graphic Entityref="curscont" Id="HTRM.REF.fig.2"></Graphic>
- <Procedure>
- <Title>To Change the Cursor Appearance</Title>
- <IndexTerm>
- <Primary>cursor:appearance</Primary>
- </IndexTerm>
- <Step>
- <OrderedList Role="tight">
- <ListItem Id="HTRM.REF.item.31">
- <Para>Choose Global from the Options menu in the <ComputerOutput>dtterm</ComputerOutput> window.</Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.32">
- <Para>Press mouse button 1 on the Cursor Style list and drag to the cursor
- type you want (Box, Underline, or Invisible).</Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.33">
- <Para>Click Apply to save your change, or OK to save your change and quit
- the dialog box.
- </Para>
- </ListItem>
- </OrderedList>
- </Step>
- </Procedure>
- <Procedure>
- <Title>To Stop the Cursor from Blinking</Title>
- <IndexTerm>
- <Primary>cursor:blinking</Primary>
- </IndexTerm>
- <IndexTerm>
- <Primary>blinking cursor</Primary>
- </IndexTerm>
- <Step>
- <OrderedList Role="tight">
- <ListItem Id="HTRM.REF.item.34">
- <Para>Choose Global from the Options menu in the <ComputerOutput>dtterm</ComputerOutput> window.</Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.35">
- <Para>Press mouse button 1 on the Blinking Cursor menu button and drag to
- the cursor behavior you want.</Para>
- <Para>Enabled (the default) means the cursor will blink; Disabled stops the
- blinking.</Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.36">
- <Para>If you set the cursor to blink and want the blink rate to be
- different from the default 250 milliseconds, type the rate you want in
- the Blink Rate text field.</Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.37">
- <Para>Click Apply to save your change, or OK to save your change and quit
- the dialog box.
- </Para>
- </ListItem>
- </OrderedList>
- </Step>
- </Procedure>
- </Sect2>
- <Sect2 Id="ColorControl">
- <Title>Color Control</Title>
- <Para>The Color Control option enables you to switch your <ComputerOutput>dtterm</ComputerOutput> foreground and
- background colors. The default option is Normal; the foreground
- and background colors you choose are displayed normally.</Para>
- <Procedure>
- <Title>To Switch Foreground and Background Colors</Title>
- <Step>
- <OrderedList Role="tight">
- <ListItem Id="HTRM.REF.item.38">
- <Para>Choose Global from the Options menu in the <ComputerOutput>dtterm</ComputerOutput> window.</Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.39">
- <Para>Press mouse button 1 on the Window Background menu button and drag
- to determine how the colors will appear.</Para>
- <Para>Normal (the default) keeps the colors as assigned; Inverse switches
- them.</Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.40">
- <Para>Click Apply to save your change, or OK to save your change and quit
- the dialog box.
- </Para>
- </ListItem>
- </OrderedList>
- <Graphic Entityref="colrcont" Id="HTRM.REF.fig.3"></Graphic>
- </Step>
- </Procedure>
- </Sect2>
- <Sect2 Id="ScrollBehavior">
- <Title>Scroll Behavior</Title>
- <Para>The Scroll Behavior option allows you to enable and disable smooth scrolling.
- The default is disabled.
- </Para>
- <Procedure>
- <Title>To Make Scrolling Smooth</Title>
- <Step>
- <OrderedList Role="tight">
- <ListItem Id="HTRM.REF.item.41">
- <Para>Choose Global from the Options menu in the <ComputerOutput>dtterm</ComputerOutput> window.</Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.42">
- <Para>Press mouse button 1 on the Smooth Scrolling menu button and drag to
- the type of scrolling you want.</Para>
- <Para>Disabled (the default) scrolls a page at a time, and Enabled scrolls a
- single line at a time, which makes
- scrolling smoother.</Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.43">
- <Para>Click Apply to save your change, or OK to save your change and quit
- the dialog box.
- </Para>
- </ListItem>
- </OrderedList>
- <Graphic Entityref="scrlbeh" Id="HTRM.REF.fig.4"></Graphic>
- </Step>
- </Procedure>
- </Sect2>
- <Sect2 Id="BellControl">
- <Title>Bell Control</Title>
- <Para>All of the Bell Control options are controlled by selecting a choice in an
- options menu button or, in the case of the Margin Distance option, entering
- a value in the text field space.
- </Para>
- <Graphic Entityref="bellcont" Id="HTRM.REF.fig.5"></Graphic>
- <Procedure>
- <Title>To Make the Bell Blink Rather than Ring</Title>
- <IndexTerm>
- <Primary>bell type</Primary>
- </IndexTerm>
- <Step>
- <OrderedList Role="tight">
- <ListItem Id="HTRM.REF.item.44">
- <Para>Choose Global from the Options menu in the <ComputerOutput>dtterm</ComputerOutput> window.</Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.45">
- <Para>Press mouse button 1 on the Bell Type menu button and drag to the
- bell type you want.</Para>
- <Para>Audible (the default) means the bell will ring; Visible means the bell
- will blink the background color rather than ringing.</Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.46">
- <Para>Click Apply to save your change, or OK to save your change and quit
- the dialog box.
- </Para>
- </ListItem>
- </OrderedList>
- </Step>
- </Procedure>
- <Procedure>
- <Title>To Sound a Margin Warning</Title>
- <Step>
- <Para>The Margin Warning Option is either disabled (the default) or enabled.
- </Para>
- <OrderedList Role="tight">
- <ListItem Id="HTRM.REF.item.47">
- <Para>Choose Global from the Options menu in the <ComputerOutput>dtterm</ComputerOutput> window.</Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.48">
- <Para>Press mouse button 1 on the Margin Warning menu button and drag to
- the choice you want.</Para>
- <Para>Disabled (the default) means there will be no margin warning; Enabled
- means a margin warning will sound.</Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.49">
- <Para>If you enable the margin warning bell and want a margin distance
- other than the default 10 characters, type the distance you want in the
- Margin Distance text field.</Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.50">
- <Para>Click Apply to save your change, or OK to save your change and quit
- the dialog box.
- </Para>
- </ListItem>
- </OrderedList>
- </Step>
- </Procedure>
- </Sect2>
- </Sect1>
- <Sect1 Id="TermOpts">
- <Title>Terminal Options Dialog Box</Title>
- <Para>There are two areas that you can control from the "Terminal Options" dialog
- box:
- </Para>
- <ItemizedList Mark="•" Role="tight">
- <ListItem Id="HTRM.REF.item.51">
- <Para><XRef Linkend="KeyboardControl"></Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.52">
- <Para><XRef Linkend="ScreenControl"></Para>
- </ListItem>
- </ItemizedList>
- <Para>Each of these areas contains several option menus from which you can
- choose values for a particular option.</Para>
- <Note>
- <Para>Any changes made in the Terminal Options dialog box apply only to the
- <ComputerOutput>dtterm</ComputerOutput> window from which you accessed the dialog box.
- </Para>
- </Note>
- <Graphic Entityref="termopts" Id="HTRM.REF.fig.6"></Graphic>
- <Sect2 Id="KeyboardControl">
- <Title>Keyboard Control</Title>
- <Para>You can control four aspects of your keyboard when using <ComputerOutput>dtterm</ComputerOutput> by
- setting values from the <ComputerOutput>dtterm</ComputerOutput> Terminal
- Options dialog box:
- </Para>
- <ItemizedList Mark="•" Role="tight">
- <ListItem Id="HTRM.REF.item.53">
- <Para><XRef Linkend="CursorKeyMode"></Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.54">
- <Para><XRef Linkend="KeypadMode"></Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.55">
- <Para><XRef Linkend="NewlineSequence"></Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.56">
- <Para><XRef Linkend="UserFunctionKeys"></Para>
- </ListItem>
- </ItemizedList>
- <Graphic Entityref="keybcont" Id="HTRM.REF.fig.7"></Graphic>
- <Sect3 Id="CursorKeyMode">
- <Title>To Change Cursor Key Mode</Title>
- <IndexTerm>
- <Primary>cursor key mode</Primary>
- </IndexTerm>
- <Para>Cursor Key Mode (see <Link Type="jump" Linkend="CursorKeys">"Cursor Keys, VT220 Mode"</Link>)
- is either Normal (the default) or Application. In Normal
- mode, the cursor keys move the cursor in the specified direction. In
- Application mode, the cursor keys generate escape sequences that the
- application uses for its own purpose.</Para>
- <OrderedList Role="tight">
- <ListItem Id="HTRM.REF.item.57">
- <Para>Choose Terminal from the Options Menu in the <ComputerOutput>dtterm</ComputerOutput> window.
- </Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.58">
- <Para>Click the options menu button next to
- "Cursor Key Mode" in the Keyboard Control Section of the Terminal Options
- dialog box.
- </Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.59">
- <Para>Drag the pointer to the mode you want.
- </Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.60">
- <Para>Click Apply to save your
- changes, or OK to save your changes and quit the dialog box.
- </Para>
- </ListItem>
- </OrderedList>
- </Sect3>
- <Sect3 Id="KeypadMode">
- <Title>To Change Keypad Mode</Title>
- <IndexTerm>
- <Primary>keypad mode</Primary>
- </IndexTerm>
- <Para>Keypad Mode is either Numeric (the default) or Application (see
- <Link Type="jump" Linkend="AuxKeypad">"Auxiliary Keypad, ANSI Mode"</Link>). In Numeric
- mode, when keys on the numeric keypad are pressed, the corresponding
- numeral is displayed in the <ComputerOutput>dtterm</ComputerOutput> window. In Application mode, the
- key presses generate escape sequences that the application uses for its own
- purpose.</Para>
- <OrderedList Role="tight">
- <ListItem Id="HTRM.REF.item.61">
- <Para>Choose Terminal from the Options Menu in the <ComputerOutput>dtterm</ComputerOutput> window.
- </Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.62">
- <Para>Click the options menu button next to
- "Keypad Mode" in the Keyboard Control Section of the Terminal Options
- dialog box.
- </Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.63">
- <Para>Drag the pointer to the mode you want.
- </Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.64">
- <Para>Click Apply to save your
- changes, or OK to save your changes and quit the dialog box.
- </Para>
- </ListItem>
- </OrderedList>
- </Sect3>
- <Sect3 Id="NewlineSequence">
- <Title>To Change Newline Sequence</Title>
- <Para>The Newline Sequence option lets you choose from Return Only (the default)
- or Return/Line Feed. The former option generates only a carriage return, while
- the latter option generates both a carriage return and a line feed.
- </Para>
- <OrderedList Role="tight">
- <ListItem Id="HTRM.REF.item.65">
- <Para>Choose Terminal from the Options Menu in the <ComputerOutput>dtterm</ComputerOutput> window.
- </Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.66">
- <Para>Click the options menu button next to
- "Newline Sequence" in the Keyboard Control Section of the Terminal Options
- dialog box.
- </Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.67">
- <Para>Drag the pointer to the mode you want.
- </Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.68">
- <Para>Click Apply to save your
- changes, or OK to save your changes and quit the dialog box.
- </Para>
- </ListItem>
- </OrderedList>
- </Sect3>
- <Sect3 Id="UserFunctionKeys">
- <Title>To Change User Function Keys</Title>
- <Para>The User Function Keys option allows you to have the user function keys
- locked or unlocked (the default).
- </Para>
- <OrderedList Role="tight">
- <ListItem Id="HTRM.REF.item.69">
- <Para>Choose Terminal from the Options Menu in the <ComputerOutput>dtterm</ComputerOutput> window.
- </Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.70">
- <Para>Click the options menu button next to
- "User Function Keys" in the Keyboard Control Section of the Terminal Options
- dialog box.
- </Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.71">
- <Para>Drag the pointer to the mode you want.
- </Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.72">
- <Para>Click Apply to save your
- changes, or OK to save your changes and quit the dialog box.
- </Para>
- </ListItem>
- </OrderedList>
- </Sect3>
- </Sect2>
- <Sect2 Id="ScreenControl">
- <Title>Screen Control</Title>
- <IndexTerm>
- <Primary>Screen Control</Primary>
- </IndexTerm>
- <Para>You have control of three aspects of screen control in a <ComputerOutput>dtterm</ComputerOutput>
- window:
- </Para>
- <ItemizedList Mark="•" Role="tight">
- <ListItem Id="HTRM.REF.item.73">
- <Para><XRef Linkend="ColSwitch"></Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.74">
- <Para><XRef Linkend="EOLWrap"></Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.75">
- <Para><XRef Linkend="RevEOLWrap"></Para>
- </ListItem>
- </ItemizedList>
- <Figure Id="HTRM.REF.fig.8">
- <Title>Screen Control Options</Title>
- <Graphic Entityref="scrncont" Id="HTRM.REF.grph.1"></Graphic>
- </Figure>
- <Sect3 Id="ColSwitch">
- <Title>To Change 132-Column Switching</Title>
- <Para>The 132 Column Switching option allows you to toggle this capability. The
- default is Disabled. When disabled and an application switches to 132
- columns, nothing happens. When enabled and an application switches to 132
- columns, the <ComputerOutput>dtterm</ComputerOutput> window automatically enlarges to display 132 columns.</Para>
- <Para>This option corresponds to the following <ComputerOutput>dtterm</ComputerOutput> command-line options
- and resource:</Para>
- <ItemizedList Mark="•" Role="tight">
- <ListItem Id="HTRM.REF.item.76">
- <Para><Link Type="jump" Linkend="minus132">"-132"</Link> (command-line option)
- </Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.77">
- <Para><Link Type="jump" Linkend="plus132">"+132"</Link> (command-line option)
- </Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.78">
- <Para><Link Type="jump" Linkend="c132">"c132"</Link> (resource)
- </Para>
- </ListItem>
- </ItemizedList>
- <OrderedList Role="tight">
- <ListItem Id="HTRM.REF.item.79">
- <Para>Choose Terminal from the Options Menu in the <ComputerOutput>dtterm</ComputerOutput> window.
- </Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.80">
- <Para>Click the options menu button next to
- "132 Column Switching" in the Screen Control Section of the Terminal Options
- dialog box.
- </Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.81">
- <Para>Drag the pointer to the mode you want.
- </Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.82">
- <Para>Click Apply to save your
- changes, or OK to save your changes and quit the dialog box.
- </Para>
- </ListItem>
- </OrderedList>
- </Sect3>
- <Sect3 Id="EOLWrap">
- <Title>To Change End-of-Line Wrapping</Title>
- <Para>The End-of-Line Wrapping option allows you to toggle this capability. The
- default is Enabled. When enabled, characters automatically wrap to the
- next line when the end-of-line is reached. When disabled, no wrapping
- occurs.</Para>
- <Para>This option corresponds to the following <ComputerOutput>dtterm</ComputerOutput> command-line options
- and resource:</Para>
- <ItemizedList Mark="•" Role="tight">
- <ListItem Id="HTRM.REF.item.83">
- <Para><Link Type="jump" Linkend="minusaw">"-aw"</Link> (command-line option)
- </Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.84">
- <Para><Link Type="jump" Linkend="plusaw">"+aw"</Link> (command-line option)
- </Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.85">
- <Para><Link Type="jump" Linkend="autowrap">"autoWrap"</Link> (resource)
- </Para>
- </ListItem>
- </ItemizedList>
- <OrderedList Role="tight">
- <ListItem Id="HTRM.REF.item.86">
- <Para>Choose Terminal from the Options Menu in the <ComputerOutput>dtterm</ComputerOutput> window.
- </Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.87">
- <Para>Click the options menu button next to
- "End-of-line Wrapping" in the Screen Control Section of the Terminal Options
- dialog box.
- </Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.88">
- <Para>Drag the pointer to the mode you want.
- </Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.89">
- <Para>Click Apply to save your
- changes, or OK to save your changes and quit the dialog box.
- </Para>
- </ListItem>
- </OrderedList>
- </Sect3>
- <Sect3 Id="RevEOLWrap">
- <Title>To Change Reverse End-of-Line Wrapping</Title>
- <IndexTerm>
- <Primary>Reverse End-of-Line Wrapping</Primary>
- </IndexTerm>
- <Para>The reverse End-of-Line Wrapping option allows you to toggle this capability.
- The default is Disabled. When enabled, backspace characters automatically
- wrap to the
- next higher line when the end-of-line is reached. When disabled, no wrapping
- occurs.</Para>
- <Para>This option corresponds to the following <ComputerOutput>dtterm</ComputerOutput> command-line options
- and resource:</Para>
- <ItemizedList Mark="•" Role="tight">
- <ListItem Id="HTRM.REF.item.90">
- <Para><Link Type="jump" Linkend="minusrw">"-rw"</Link> (command-line option)
- </Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.91">
- <Para><Link Type="jump" Linkend="plusrw">"+rw"</Link> (command-line option)
- </Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.92">
- <Para><Link Type="jump" Linkend="reverseWrap">"reverseWrap"</Link> (resource)
- </Para>
- </ListItem>
- </ItemizedList>
- <OrderedList Role="tight">
- <ListItem Id="HTRM.REF.item.93">
- <Para>Choose Terminal from the Options Menu in the <ComputerOutput>dtterm</ComputerOutput> window.
- </Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.94">
- <Para>Click the options menu button next to "Reverse End-of-line Wrapping"
- in the Screen Control Section of the Terminal Options
- dialog box.
- </Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.95">
- <Para>Drag the pointer to the mode you want.
- </Para>
- </ListItem>
- <ListItem Id="HTRM.REF.item.96">
- <Para>Click Apply to save your
- changes, or OK to save your changes and quit the dialog box.
- </Para>
- </ListItem>
- </OrderedList>
- </Sect3>
- </Sect2>
- </Sect1>
- </Chapter>
- <!--fickle 1.15 help-to-docbook 1.4 01/17/96 16:46:59-->
|