DVX_GUI/docs/manual/dvxManual.html
2026-11-01 19:45:47 -06:00

28079 lines
No EOL
1.9 MiB

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="generator" content="Asciidoctor 2.0.26">
<meta name="description" content="How to install and use DVX, a windowed desktop for DOS PCs.">
<title>DVX User&#8217;s Guide: DOS Visual eXecutive</title>
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:300,300italic,400,400italic,600,600italic%7CNoto+Serif:400,400italic,700,700italic%7CDroid+Sans+Mono:400,700">
<style>
/*! Asciidoctor default stylesheet | MIT License | https://asciidoctor.org */
/* Uncomment the following line when using as a custom stylesheet */
/* @import "https://fonts.googleapis.com/css?family=Open+Sans:300,300italic,400,400italic,600,600italic%7CNoto+Serif:400,400italic,700,700italic%7CDroid+Sans+Mono:400,700"; */
html{font-family:sans-serif;-webkit-text-size-adjust:100%}
a{background:none}
a:focus{outline:thin dotted}
a:active,a:hover{outline:0}
h1{font-size:2em;margin:.67em 0}
b,strong{font-weight:bold}
abbr{font-size:.9em}
abbr[title]{cursor:help;border-bottom:1px dotted #dddddf;text-decoration:none}
dfn{font-style:italic}
hr{height:0}
mark{background:#ff0;color:#000}
code,kbd,pre,samp{font-family:monospace;font-size:1em}
pre{white-space:pre-wrap}
q{quotes:"\201C" "\201D" "\2018" "\2019"}
small{font-size:80%}
sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}
sup{top:-.5em}
sub{bottom:-.25em}
img{border:0}
svg:not(:root){overflow:hidden}
figure{margin:0}
audio,video{display:inline-block}
audio:not([controls]){display:none;height:0}
fieldset{border:1px solid silver;margin:0 2px;padding:.35em .625em .75em}
legend{border:0;padding:0}
button,input,select,textarea{font-family:inherit;font-size:100%;margin:0}
button,input{line-height:normal}
button,select{text-transform:none}
button,html input[type=button],input[type=reset],input[type=submit]{-webkit-appearance:button;cursor:pointer}
button[disabled],html input[disabled]{cursor:default}
input[type=checkbox],input[type=radio]{padding:0}
button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}
textarea{overflow:auto;vertical-align:top}
table{border-collapse:collapse;border-spacing:0}
*,::before,::after{box-sizing:border-box}
html,body{font-size:100%}
body{background:#fff;color:rgba(0,0,0,.8);padding:0;margin:0;font-family:"Noto Serif","DejaVu Serif",serif;line-height:1;position:relative;cursor:auto;-moz-tab-size:4;-o-tab-size:4;tab-size:4;word-wrap:anywhere;-moz-osx-font-smoothing:grayscale;-webkit-font-smoothing:antialiased}
a:hover{cursor:pointer}
img,object,embed{max-width:100%;height:auto}
object,embed{height:100%}
img{-ms-interpolation-mode:bicubic}
.left{float:left!important}
.right{float:right!important}
.text-left{text-align:left!important}
.text-right{text-align:right!important}
.text-center{text-align:center!important}
.text-justify{text-align:justify!important}
.hide{display:none}
img,object,svg{display:inline-block;vertical-align:middle}
textarea{height:auto;min-height:50px}
select{width:100%}
.subheader,.admonitionblock td.content>.title,.audioblock>.title,.exampleblock>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.stemblock>.title,.openblock>.title,.paragraph>.title,.quoteblock>.title,table.tableblock>.title,.verseblock>.title,.videoblock>.title,.dlist>.title,.olist>.title,.ulist>.title,.qlist>.title,.hdlist>.title{line-height:1.45;color:#7a2518;font-weight:400;margin-top:0;margin-bottom:.25em}
div,dl,dt,dd,ul,ol,li,h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6,pre,form,p,blockquote,th,td{margin:0;padding:0}
a{color:#2156a5;text-decoration:underline;line-height:inherit}
a:hover,a:focus{color:#1d4b8f}
a img{border:0}
p{line-height:1.6;margin-bottom:1.25em;text-rendering:optimizeLegibility}
p aside{font-size:.875em;line-height:1.35;font-style:italic}
h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{font-family:"Open Sans","DejaVu Sans",sans-serif;font-weight:300;font-style:normal;color:#ba3925;text-rendering:optimizeLegibility;margin-top:1em;margin-bottom:.5em;line-height:1.0125em}
h1 small,h2 small,h3 small,#toctitle small,.sidebarblock>.content>.title small,h4 small,h5 small,h6 small{font-size:60%;color:#e99b8f;line-height:0}
h1{font-size:2.125em}
h2{font-size:1.6875em}
h3,#toctitle,.sidebarblock>.content>.title{font-size:1.375em}
h4,h5{font-size:1.125em}
h6{font-size:1em}
hr{border:solid #dddddf;border-width:1px 0 0;clear:both;margin:1.25em 0 1.1875em}
em,i{font-style:italic;line-height:inherit}
strong,b{font-weight:bold;line-height:inherit}
small{font-size:60%;line-height:inherit}
code{font-family:"Droid Sans Mono","DejaVu Sans Mono",monospace;font-weight:400;color:rgba(0,0,0,.9)}
ul,ol,dl{line-height:1.6;margin-bottom:1.25em;list-style-position:outside;font-family:inherit}
ul,ol{margin-left:1.5em}
ul li ul,ul li ol{margin-left:1.25em;margin-bottom:0}
ul.circle{list-style-type:circle}
ul.disc{list-style-type:disc}
ul.square{list-style-type:square}
ul.circle ul:not([class]),ul.disc ul:not([class]),ul.square ul:not([class]){list-style:inherit}
ol li ul,ol li ol{margin-left:1.25em;margin-bottom:0}
dl dt{margin-bottom:.3125em;font-weight:bold}
dl dd{margin-bottom:1.25em}
blockquote{margin:0 0 1.25em;padding:.5625em 1.25em 0 1.1875em;border-left:1px solid #ddd}
blockquote,blockquote p{line-height:1.6;color:rgba(0,0,0,.85)}
@media screen and (min-width:768px){h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{line-height:1.2}
h1{font-size:2.75em}
h2{font-size:2.3125em}
h3,#toctitle,.sidebarblock>.content>.title{font-size:1.6875em}
h4{font-size:1.4375em}}
table{background:#fff;margin-bottom:1.25em;border:1px solid #dedede;word-wrap:normal}
table thead,table tfoot{background:#f7f8f7}
table thead tr th,table thead tr td,table tfoot tr th,table tfoot tr td{padding:.5em .625em .625em;font-size:inherit;color:rgba(0,0,0,.8);text-align:left}
table tr th,table tr td{padding:.5625em .625em;font-size:inherit;color:rgba(0,0,0,.8)}
table tr.even,table tr.alt{background:#f8f8f7}
table thead tr th,table tfoot tr th,table tbody tr td,table tr td,table tfoot tr td{line-height:1.6}
h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{line-height:1.2;word-spacing:-.05em}
h1 strong,h2 strong,h3 strong,#toctitle strong,.sidebarblock>.content>.title strong,h4 strong,h5 strong,h6 strong{font-weight:400}
.center{margin-left:auto;margin-right:auto}
.stretch{width:100%}
.clearfix::before,.clearfix::after,.float-group::before,.float-group::after{content:" ";display:table}
.clearfix::after,.float-group::after{clear:both}
:not(pre).nobreak{word-wrap:normal}
:not(pre).nowrap{white-space:nowrap}
:not(pre).pre-wrap{white-space:pre-wrap}
:not(pre):not([class^=L])>code{font-size:.9375em;font-style:normal!important;letter-spacing:0;padding:.1em .5ex;word-spacing:-.15em;background:#f7f7f8;border-radius:4px;line-height:1.45;text-rendering:optimizeSpeed}
pre{color:rgba(0,0,0,.9);font-family:"Droid Sans Mono","DejaVu Sans Mono",monospace;line-height:1.45;text-rendering:optimizeSpeed}
pre code,pre pre{color:inherit;font-size:inherit;line-height:inherit}
pre.nowrap,pre.nowrap pre{white-space:pre;word-wrap:normal}
em em{font-style:normal}
strong strong{font-weight:400}
.keyseq{color:rgba(51,51,51,.8)}
kbd{font-family:"Droid Sans Mono","DejaVu Sans Mono",monospace;display:inline-block;color:rgba(0,0,0,.8);font-size:.65em;line-height:1.45;background:#f7f7f7;border:1px solid #ccc;border-radius:3px;box-shadow:0 1px 0 rgba(0,0,0,.2),inset 0 0 0 .1em #fff;margin:0 .15em;padding:.2em .5em;vertical-align:middle;position:relative;top:-.1em;white-space:nowrap}
.keyseq kbd:first-child{margin-left:0}
.keyseq kbd:last-child{margin-right:0}
.menuseq,.menuref{color:#000}
.menuseq b:not(.caret),.menuref{font-weight:inherit}
.menuseq{word-spacing:-.02em}
.menuseq b.caret{font-size:1.25em;line-height:.8}
.menuseq i.caret{font-weight:bold;text-align:center;width:.45em}
b.button::before,b.button::after{position:relative;top:-1px;font-weight:400}
b.button::before{content:"[";padding:0 3px 0 2px}
b.button::after{content:"]";padding:0 2px 0 3px}
p a>code:hover{color:rgba(0,0,0,.9)}
#header,#content,#footnotes,#footer{width:100%;margin:0 auto;max-width:62.5em;*zoom:1;position:relative;padding-left:.9375em;padding-right:.9375em}
#header::before,#header::after,#content::before,#content::after,#footnotes::before,#footnotes::after,#footer::before,#footer::after{content:" ";display:table}
#header::after,#content::after,#footnotes::after,#footer::after{clear:both}
#content{margin-top:1.25em}
#content::before{content:none}
#header>h1:first-child{color:rgba(0,0,0,.85);margin-top:2.25rem;margin-bottom:0}
#header>h1:first-child+#toc{margin-top:8px;border-top:1px solid #dddddf}
#header>h1:only-child{border-bottom:1px solid #dddddf;padding-bottom:8px}
#header .details{border-bottom:1px solid #dddddf;line-height:1.45;padding-top:.25em;padding-bottom:.25em;padding-left:.25em;color:rgba(0,0,0,.6);display:flex;flex-flow:row wrap}
#header .details span:first-child{margin-left:-.125em}
#header .details span.email a{color:rgba(0,0,0,.85)}
#header .details br{display:none}
#header .details br+span::before{content:"\00a0\2013\00a0"}
#header .details br+span.author::before{content:"\00a0\22c5\00a0";color:rgba(0,0,0,.85)}
#header .details br+span#revremark::before{content:"\00a0|\00a0"}
#header #revnumber{text-transform:capitalize}
#header #revnumber::after{content:"\00a0"}
#content>h1:first-child:not([class]){color:rgba(0,0,0,.85);border-bottom:1px solid #dddddf;padding-bottom:8px;margin-top:0;padding-top:1rem;margin-bottom:1.25rem}
#toc{border-bottom:1px solid #e7e7e9;padding-bottom:.5em}
#toc>ul{margin-left:.125em}
#toc ul.sectlevel0>li>a{font-style:italic}
#toc ul.sectlevel0 ul.sectlevel1{margin:.5em 0}
#toc ul{font-family:"Open Sans","DejaVu Sans",sans-serif;list-style-type:none}
#toc li{line-height:1.3334;margin-top:.3334em}
#toc a{text-decoration:none}
#toc a:active{text-decoration:underline}
#toctitle{color:#7a2518;font-size:1.2em}
@media screen and (min-width:768px){#toctitle{font-size:1.375em}
body.toc2{padding-left:15em;padding-right:0}
body.toc2 #header>h1:nth-last-child(2){border-bottom:1px solid #dddddf;padding-bottom:8px}
#toc.toc2{margin-top:0!important;background:#f8f8f7;position:fixed;width:15em;left:0;top:0;border-right:1px solid #e7e7e9;border-top-width:0!important;border-bottom-width:0!important;z-index:1000;padding:1.25em 1em;height:100%;overflow:auto}
#toc.toc2 #toctitle{margin-top:0;margin-bottom:.8rem;font-size:1.2em}
#toc.toc2>ul{font-size:.9em;margin-bottom:0}
#toc.toc2 ul ul{margin-left:0;padding-left:1em}
#toc.toc2 ul.sectlevel0 ul.sectlevel1{padding-left:0;margin-top:.5em;margin-bottom:.5em}
body.toc2.toc-right{padding-left:0;padding-right:15em}
body.toc2.toc-right #toc.toc2{border-right-width:0;border-left:1px solid #e7e7e9;left:auto;right:0}}
@media screen and (min-width:1280px){body.toc2{padding-left:20em;padding-right:0}
#toc.toc2{width:20em}
#toc.toc2 #toctitle{font-size:1.375em}
#toc.toc2>ul{font-size:.95em}
#toc.toc2 ul ul{padding-left:1.25em}
body.toc2.toc-right{padding-left:0;padding-right:20em}}
#content #toc{border:1px solid #e0e0dc;margin-bottom:1.25em;padding:1.25em;background:#f8f8f7;border-radius:4px}
#content #toc>:first-child{margin-top:0}
#content #toc>:last-child{margin-bottom:0}
#footer{max-width:none;background:rgba(0,0,0,.8);padding:1.25em}
#footer-text{color:hsla(0,0%,100%,.8);line-height:1.44}
#content{margin-bottom:.625em}
.sect1{padding-bottom:.625em}
@media screen and (min-width:768px){#content{margin-bottom:1.25em}
.sect1{padding-bottom:1.25em}}
.sect1:last-child{padding-bottom:0}
.sect1+.sect1{border-top:1px solid #e7e7e9}
#content h1>a.anchor,h2>a.anchor,h3>a.anchor,#toctitle>a.anchor,.sidebarblock>.content>.title>a.anchor,h4>a.anchor,h5>a.anchor,h6>a.anchor{position:absolute;z-index:1001;width:1.5ex;margin-left:-1.5ex;display:block;text-decoration:none!important;visibility:hidden;text-align:center;font-weight:400}
#content h1>a.anchor::before,h2>a.anchor::before,h3>a.anchor::before,#toctitle>a.anchor::before,.sidebarblock>.content>.title>a.anchor::before,h4>a.anchor::before,h5>a.anchor::before,h6>a.anchor::before{content:"\00A7";font-size:.85em;display:block;padding-top:.1em}
#content h1:hover>a.anchor,#content h1>a.anchor:hover,h2:hover>a.anchor,h2>a.anchor:hover,h3:hover>a.anchor,#toctitle:hover>a.anchor,.sidebarblock>.content>.title:hover>a.anchor,h3>a.anchor:hover,#toctitle>a.anchor:hover,.sidebarblock>.content>.title>a.anchor:hover,h4:hover>a.anchor,h4>a.anchor:hover,h5:hover>a.anchor,h5>a.anchor:hover,h6:hover>a.anchor,h6>a.anchor:hover{visibility:visible}
#content h1>a.link,h2>a.link,h3>a.link,#toctitle>a.link,.sidebarblock>.content>.title>a.link,h4>a.link,h5>a.link,h6>a.link{color:#ba3925;text-decoration:none}
#content h1>a.link:hover,h2>a.link:hover,h3>a.link:hover,#toctitle>a.link:hover,.sidebarblock>.content>.title>a.link:hover,h4>a.link:hover,h5>a.link:hover,h6>a.link:hover{color:#a53221}
details,.audioblock,.imageblock,.literalblock,.listingblock,.stemblock,.videoblock{margin-bottom:1.25em}
details{margin-left:1.25rem}
details>summary{cursor:pointer;display:block;position:relative;line-height:1.6;margin-bottom:.625rem;outline:none;-webkit-tap-highlight-color:transparent}
details>summary::-webkit-details-marker{display:none}
details>summary::before{content:"";border:solid transparent;border-left:solid;border-width:.3em 0 .3em .5em;position:absolute;top:.5em;left:-1.25rem;transform:translateX(15%)}
details[open]>summary::before{border:solid transparent;border-top:solid;border-width:.5em .3em 0;transform:translateY(15%)}
details>summary::after{content:"";width:1.25rem;height:1em;position:absolute;top:.3em;left:-1.25rem}
.admonitionblock td.content>.title,.audioblock>.title,.exampleblock>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.stemblock>.title,.openblock>.title,.paragraph>.title,.quoteblock>.title,table.tableblock>.title,.verseblock>.title,.videoblock>.title,.dlist>.title,.olist>.title,.ulist>.title,.qlist>.title,.hdlist>.title{text-rendering:optimizeLegibility;text-align:left;font-family:"Noto Serif","DejaVu Serif",serif;font-size:1rem;font-style:italic}
table.tableblock.fit-content>caption.title{white-space:nowrap;width:0}
.paragraph.lead>p,#preamble>.sectionbody>[class=paragraph]:first-of-type p{font-size:1.21875em;line-height:1.6;color:rgba(0,0,0,.85)}
.admonitionblock>table{border-collapse:separate;border:0;background:none;width:100%}
.admonitionblock>table td.icon{text-align:center;width:80px}
.admonitionblock>table td.icon img{max-width:none}
.admonitionblock>table td.icon .title{font-weight:bold;font-family:"Open Sans","DejaVu Sans",sans-serif;text-transform:uppercase}
.admonitionblock>table td.content{padding-left:1.125em;padding-right:1.25em;border-left:1px solid #dddddf;color:rgba(0,0,0,.6);word-wrap:anywhere}
.admonitionblock>table td.content>:last-child>:last-child{margin-bottom:0}
.exampleblock>.content{border:1px solid #e6e6e6;margin-bottom:1.25em;padding:1.25em;background:#fff;border-radius:4px}
.sidebarblock{border:1px solid #dbdbd6;margin-bottom:1.25em;padding:1.25em;background:#f3f3f2;border-radius:4px}
.sidebarblock>.content>.title{color:#7a2518;margin-top:0;text-align:center}
.exampleblock>.content>:first-child,.sidebarblock>.content>:first-child{margin-top:0}
.exampleblock>.content>:last-child,.exampleblock>.content>:last-child>:last-child,.exampleblock>.content .olist>ol>li:last-child>:last-child,.exampleblock>.content .ulist>ul>li:last-child>:last-child,.exampleblock>.content .qlist>ol>li:last-child>:last-child,.sidebarblock>.content>:last-child,.sidebarblock>.content>:last-child>:last-child,.sidebarblock>.content .olist>ol>li:last-child>:last-child,.sidebarblock>.content .ulist>ul>li:last-child>:last-child,.sidebarblock>.content .qlist>ol>li:last-child>:last-child{margin-bottom:0}
.literalblock pre,.listingblock>.content>pre{border-radius:4px;overflow-x:auto;padding:1em;font-size:.8125em}
@media screen and (min-width:768px){.literalblock pre,.listingblock>.content>pre{font-size:.90625em}}
@media screen and (min-width:1280px){.literalblock pre,.listingblock>.content>pre{font-size:1em}}
.literalblock pre,.listingblock>.content>pre:not(.highlight),.listingblock>.content>pre[class=highlight],.listingblock>.content>pre[class^="highlight "]{background:#f7f7f8}
.literalblock.output pre{color:#f7f7f8;background:rgba(0,0,0,.9)}
.listingblock>.content{position:relative}
.listingblock pre>code{display:block}
.listingblock code[data-lang]::before{display:none;content:attr(data-lang);position:absolute;font-size:.75em;top:.425rem;right:.5rem;line-height:1;text-transform:uppercase;color:inherit;opacity:.5}
.listingblock:hover code[data-lang]::before{display:block}
.listingblock.terminal pre .command::before{content:attr(data-prompt);padding-right:.5em;color:inherit;opacity:.5}
.listingblock.terminal pre .command:not([data-prompt])::before{content:"$"}
.listingblock pre.highlightjs{padding:0}
.listingblock pre.highlightjs>code{padding:1em;border-radius:4px}
.listingblock pre.prettyprint{border-width:0}
.prettyprint{background:#f7f7f8}
pre.prettyprint .linenums{line-height:1.45;margin-left:2em}
pre.prettyprint li{background:none;list-style-type:inherit;padding-left:0}
pre.prettyprint li code[data-lang]::before{opacity:1}
pre.prettyprint li:not(:first-child) code[data-lang]::before{display:none}
table.linenotable{border-collapse:separate;border:0;margin-bottom:0;background:none}
table.linenotable td[class]{color:inherit;vertical-align:top;padding:0;line-height:inherit;white-space:normal}
table.linenotable td.code{padding-left:.75em}
table.linenotable td.linenos,pre.pygments .linenos{border-right:1px solid;opacity:.35;padding-right:.5em;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none}
pre.pygments span.linenos{display:inline-block;margin-right:.75em}
.quoteblock{margin:0 1em 1.25em 1.5em;display:table}
.quoteblock:not(.excerpt)>.title{margin-left:-1.5em;margin-bottom:.75em}
.quoteblock blockquote,.quoteblock p{color:rgba(0,0,0,.85);font-size:1.15rem;line-height:1.75;word-spacing:.1em;letter-spacing:0;font-style:italic;text-align:justify}
.quoteblock blockquote{margin:0;padding:0;border:0}
.quoteblock blockquote::before{content:"\201c";float:left;font-size:2.75em;font-weight:bold;line-height:.6em;margin-left:-.6em;color:#7a2518;text-shadow:0 1px 2px rgba(0,0,0,.1)}
.quoteblock blockquote>.paragraph:last-child p{margin-bottom:0}
.quoteblock .attribution{margin-top:.75em;margin-right:.5ex;text-align:right}
.verseblock{margin:0 1em 1.25em}
.verseblock pre{font-family:"Open Sans","DejaVu Sans",sans-serif;font-size:1.15rem;color:rgba(0,0,0,.85);font-weight:300;text-rendering:optimizeLegibility}
.verseblock pre strong{font-weight:400}
.verseblock .attribution{margin-top:1.25rem;margin-left:.5ex}
.quoteblock .attribution,.verseblock .attribution{font-size:.9375em;line-height:1.45;font-style:italic}
.quoteblock .attribution br,.verseblock .attribution br{display:none}
.quoteblock .attribution cite,.verseblock .attribution cite{display:block;letter-spacing:-.025em;color:rgba(0,0,0,.6)}
.quoteblock.abstract blockquote::before,.quoteblock.excerpt blockquote::before,.quoteblock .quoteblock blockquote::before{display:none}
.quoteblock.abstract blockquote,.quoteblock.abstract p,.quoteblock.excerpt blockquote,.quoteblock.excerpt p,.quoteblock .quoteblock blockquote,.quoteblock .quoteblock p{line-height:1.6;word-spacing:0}
.quoteblock.abstract{margin:0 1em 1.25em;display:block}
.quoteblock.abstract>.title{margin:0 0 .375em;font-size:1.15em;text-align:center}
.quoteblock.excerpt>blockquote,.quoteblock .quoteblock{padding:0 0 .25em 1em;border-left:.25em solid #dddddf}
.quoteblock.excerpt,.quoteblock .quoteblock{margin-left:0}
.quoteblock.excerpt blockquote,.quoteblock.excerpt p,.quoteblock .quoteblock blockquote,.quoteblock .quoteblock p{color:inherit;font-size:1.0625rem}
.quoteblock.excerpt .attribution,.quoteblock .quoteblock .attribution{color:inherit;font-size:.85rem;text-align:left;margin-right:0}
p.tableblock:last-child{margin-bottom:0}
td.tableblock>.content{margin-bottom:1.25em;word-wrap:anywhere}
td.tableblock>.content>:last-child{margin-bottom:-1.25em}
table.tableblock,th.tableblock,td.tableblock{border:0 solid #dedede}
table.grid-all>*>tr>*{border-width:1px}
table.grid-cols>*>tr>*{border-width:0 1px}
table.grid-rows>*>tr>*{border-width:1px 0}
table.frame-all{border-width:1px}
table.frame-ends{border-width:1px 0}
table.frame-sides{border-width:0 1px}
table.frame-none>colgroup+*>:first-child>*,table.frame-sides>colgroup+*>:first-child>*{border-top-width:0}
table.frame-none>:last-child>:last-child>*,table.frame-sides>:last-child>:last-child>*{border-bottom-width:0}
table.frame-none>*>tr>:first-child,table.frame-ends>*>tr>:first-child{border-left-width:0}
table.frame-none>*>tr>:last-child,table.frame-ends>*>tr>:last-child{border-right-width:0}
table.stripes-all>*>tr,table.stripes-odd>*>tr:nth-of-type(odd),table.stripes-even>*>tr:nth-of-type(even),table.stripes-hover>*>tr:hover{background:#f8f8f7}
th.halign-left,td.halign-left{text-align:left}
th.halign-right,td.halign-right{text-align:right}
th.halign-center,td.halign-center{text-align:center}
th.valign-top,td.valign-top{vertical-align:top}
th.valign-bottom,td.valign-bottom{vertical-align:bottom}
th.valign-middle,td.valign-middle{vertical-align:middle}
table thead th,table tfoot th{font-weight:bold}
tbody tr th{background:#f7f8f7}
tbody tr th,tbody tr th p,tfoot tr th,tfoot tr th p{color:rgba(0,0,0,.8);font-weight:bold}
p.tableblock>code:only-child{background:none;padding:0}
p.tableblock{font-size:1em}
ol{margin-left:1.75em}
ul li ol{margin-left:1.5em}
dl dd{margin-left:1.125em}
dl dd:last-child,dl dd:last-child>:last-child{margin-bottom:0}
li p,ul dd,ol dd,.olist .olist,.ulist .ulist,.ulist .olist,.olist .ulist{margin-bottom:.625em}
ul.checklist,ul.none,ol.none,ul.no-bullet,ol.no-bullet,ol.unnumbered,ul.unstyled,ol.unstyled{list-style-type:none}
ul.no-bullet,ol.no-bullet,ol.unnumbered{margin-left:.625em}
ul.unstyled,ol.unstyled{margin-left:0}
li>p:empty:only-child::before{content:"";display:inline-block}
ul.checklist>li>p:first-child{margin-left:-1em}
ul.checklist>li>p:first-child>.fa-square-o:first-child,ul.checklist>li>p:first-child>.fa-check-square-o:first-child{width:1.25em;font-size:.8em;position:relative;bottom:.125em}
ul.checklist>li>p:first-child>input[type=checkbox]:first-child{margin-right:.25em}
ul.inline{display:flex;flex-flow:row wrap;list-style:none;margin:0 0 .625em -1.25em}
ul.inline>li{margin-left:1.25em}
.unstyled dl dt{font-weight:400;font-style:normal}
ol.arabic{list-style-type:decimal}
ol.decimal{list-style-type:decimal-leading-zero}
ol.loweralpha{list-style-type:lower-alpha}
ol.upperalpha{list-style-type:upper-alpha}
ol.lowerroman{list-style-type:lower-roman}
ol.upperroman{list-style-type:upper-roman}
ol.lowergreek{list-style-type:lower-greek}
.hdlist>table,.colist>table{border:0;background:none}
.hdlist>table>tbody>tr,.colist>table>tbody>tr{background:none}
td.hdlist1,td.hdlist2{vertical-align:top;padding:0 .625em}
td.hdlist1{font-weight:bold;padding-bottom:1.25em}
td.hdlist2{word-wrap:anywhere}
.literalblock+.colist,.listingblock+.colist{margin-top:-.5em}
.colist td:not([class]):first-child{padding:.4em .75em 0;line-height:1;vertical-align:top}
.colist td:not([class]):first-child img{max-width:none}
.colist td:not([class]):last-child{padding:.25em 0}
.thumb,.th{line-height:0;display:inline-block;border:4px solid #fff;box-shadow:0 0 0 1px #ddd}
.imageblock.left{margin:.25em .625em 1.25em 0}
.imageblock.right{margin:.25em 0 1.25em .625em}
.imageblock>.title{margin-bottom:0}
.imageblock.thumb,.imageblock.th{border-width:6px}
.imageblock.thumb>.title,.imageblock.th>.title{padding:0 .125em}
.image.left,.image.right{margin-top:.25em;margin-bottom:.25em;display:inline-block;line-height:0}
.image.left{margin-right:.625em}
.image.right{margin-left:.625em}
a.image{text-decoration:none;display:inline-block}
a.image object{pointer-events:none}
sup.footnote,sup.footnoteref{font-size:.875em;position:static;vertical-align:super}
sup.footnote a,sup.footnoteref a{text-decoration:none}
sup.footnote a:active,sup.footnoteref a:active,#footnotes .footnote a:first-of-type:active{text-decoration:underline}
#footnotes{padding-top:.75em;padding-bottom:.75em;margin-bottom:.625em}
#footnotes hr{width:20%;min-width:6.25em;margin:-.25em 0 .75em;border-width:1px 0 0}
#footnotes .footnote{padding:0 .375em 0 .225em;line-height:1.3334;font-size:.875em;margin-left:1.2em;margin-bottom:.2em}
#footnotes .footnote a:first-of-type{font-weight:bold;text-decoration:none;margin-left:-1.05em}
#footnotes .footnote:last-of-type{margin-bottom:0}
#content #footnotes{margin-top:-.625em;margin-bottom:0;padding:.75em 0}
div.unbreakable{page-break-inside:avoid}
.big{font-size:larger}
.small{font-size:smaller}
.underline{text-decoration:underline}
.overline{text-decoration:overline}
.line-through{text-decoration:line-through}
.aqua{color:#00bfbf}
.aqua-background{background:#00fafa}
.black{color:#000}
.black-background{background:#000}
.blue{color:#0000bf}
.blue-background{background:#0000fa}
.fuchsia{color:#bf00bf}
.fuchsia-background{background:#fa00fa}
.gray{color:#606060}
.gray-background{background:#7d7d7d}
.green{color:#006000}
.green-background{background:#007d00}
.lime{color:#00bf00}
.lime-background{background:#00fa00}
.maroon{color:#600000}
.maroon-background{background:#7d0000}
.navy{color:#000060}
.navy-background{background:#00007d}
.olive{color:#606000}
.olive-background{background:#7d7d00}
.purple{color:#600060}
.purple-background{background:#7d007d}
.red{color:#bf0000}
.red-background{background:#fa0000}
.silver{color:#909090}
.silver-background{background:#bcbcbc}
.teal{color:#006060}
.teal-background{background:#007d7d}
.white{color:#bfbfbf}
.white-background{background:#fafafa}
.yellow{color:#bfbf00}
.yellow-background{background:#fafa00}
span.icon>.fa{cursor:default}
a span.icon>.fa{cursor:inherit}
.admonitionblock td.icon [class^="fa icon-"]{font-size:2.5em;text-shadow:1px 1px 2px rgba(0,0,0,.5);cursor:default}
.admonitionblock td.icon .icon-note::before{content:"\f05a";color:#19407c}
.admonitionblock td.icon .icon-tip::before{content:"\f0eb";text-shadow:1px 1px 2px rgba(155,155,0,.8);color:#111}
.admonitionblock td.icon .icon-warning::before{content:"\f071";color:#bf6900}
.admonitionblock td.icon .icon-caution::before{content:"\f06d";color:#bf3400}
.admonitionblock td.icon .icon-important::before{content:"\f06a";color:#bf0000}
.conum[data-value]{display:inline-block;color:#fff!important;background:rgba(0,0,0,.8);border-radius:50%;text-align:center;font-size:.75em;width:1.67em;height:1.67em;line-height:1.67em;font-family:"Open Sans","DejaVu Sans",sans-serif;font-style:normal;font-weight:bold}
.conum[data-value] *{color:#fff!important}
.conum[data-value]+b{display:none}
.conum[data-value]::after{content:attr(data-value)}
pre .conum[data-value]{position:relative;top:-.125em}
b.conum *{color:inherit!important}
.conum:not([data-value]):empty{display:none}
dt,th.tableblock,td.content,div.footnote{text-rendering:optimizeLegibility}
h1,h2,p,td.content,span.alt,summary{letter-spacing:-.01em}
p strong,td.content strong,div.footnote strong{letter-spacing:-.005em}
p,blockquote,dt,td.content,td.hdlist1,span.alt,summary{font-size:1.0625rem}
p{margin-bottom:1.25rem}
.sidebarblock p,.sidebarblock dt,.sidebarblock td.content,p.tableblock{font-size:1em}
.exampleblock>.content{background:#fffef7;border-color:#e0e0dc;box-shadow:0 1px 4px #e0e0dc}
.print-only{display:none!important}
@page{margin:1.25cm .75cm}
@media print{*{box-shadow:none!important;text-shadow:none!important}
html{font-size:80%}
a{color:inherit!important;text-decoration:underline!important}
a.bare,a[href^="#"],a[href^="mailto:"]{text-decoration:none!important}
a[href^="http:"]:not(.bare)::after,a[href^="https:"]:not(.bare)::after{content:"(" attr(href) ")";display:inline-block;font-size:.875em;padding-left:.25em}
abbr[title]{border-bottom:1px dotted}
abbr[title]::after{content:" (" attr(title) ")"}
pre,blockquote,tr,img,object,svg{page-break-inside:avoid}
thead{display:table-header-group}
svg{max-width:100%}
p,blockquote,dt,td.content{font-size:1em;orphans:3;widows:3}
h2,h3,#toctitle,.sidebarblock>.content>.title{page-break-after:avoid}
#header,#content,#footnotes,#footer{max-width:none}
#toc,.sidebarblock,.exampleblock>.content{background:none!important}
#toc{border-bottom:1px solid #dddddf!important;padding-bottom:0!important}
body.book #header{text-align:center}
body.book #header>h1:first-child{border:0!important;margin:2.5em 0 1em}
body.book #header .details{border:0!important;display:block;padding:0!important}
body.book #header .details span:first-child{margin-left:0!important}
body.book #header .details br{display:block}
body.book #header .details br+span::before{content:none!important}
body.book #toc{border:0!important;text-align:left!important;padding:0!important;margin:0!important}
body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-break-before:always}
.listingblock code[data-lang]::before{display:block}
#footer{padding:0 .9375em}
.hide-on-print{display:none!important}
.print-only{display:block!important}
.hide-for-print{display:none!important}
.show-for-print{display:inherit!important}}
@media amzn-kf8,print{#header>h1:first-child{margin-top:1.25rem}
.sect1{padding:0!important}
.sect1+.sect1{border:0}
#footer{background:none}
#footer-text{color:rgba(0,0,0,.6);font-size:.9em}}
@media amzn-kf8{#header,#content,#footnotes,#footer{padding:0}}
</style>
<style>
/* DVX user's guide: additions to the Asciidoctor stylesheet. */
#dvx-logo { text-align: center; margin: 2em auto 0; max-width: 62.5em; }
#dvx-logo img { width: 240px; height: auto; }
/* Screenshots are pixel art: keep them sharp when scaled. */
.imageblock img, span.image img { image-rendering: pixelated; }
.imageblock .content { text-align: center; }
.imageblock .title { text-align: center; }
/* Index (made by ext/htmlIndex.rb). */
.dvx-index .ixjump { font-size: 1.15em; word-spacing: .4em; }
.dvx-index h3 { margin-top: 1.25em; border-bottom: 1px solid #dde3ea; }
.dvx-index ul.ixlist { list-style: none; margin-left: 0; columns: 2 22em; column-gap: 2.5em; }
.dvx-index ul.ixlist ul { list-style: none; margin: 0 0 0 1.25em; }
.dvx-index ul.ixlist li { break-inside: avoid; line-height: 1.5; }
.dvx-index .ixname { color: rgba(0, 0, 0, .85); }
.dvx-index a { font-size: .92em; }
</style>
</head>
<body class="book toc2 toc-left">
<div id="dvx-logo"><img src="images/dvxLogo.svg" alt="DVX"></div>
<div id="header">
<h1>DVX User&#8217;s Guide: DOS Visual eXecutive</h1>
<div class="details">
<span id="revnumber">version 1.0.0</span>
</div>
<div id="toc" class="toc2">
<div id="toctitle">Table of Contents</div>
<ul class="sectlevel1">
<li><a href="#aboutDvx">Chapter 1. About DVX</a>
<ul class="sectlevel2">
<li><a href="#about-what">1.1. What DVX is</a></li>
<li><a href="#about-programs">1.2. The programs that come with DVX</a></li>
<li><a href="#about-parts">1.3. The optional parts</a></li>
<li><a href="#about-extras">1.4. Fonts, themes, pictures, and sounds</a></li>
<li><a href="#about-guide">1.5. About this guide</a></li>
</ul>
</li>
<li><a href="#requirements">Chapter 2. System Requirements</a>
<ul class="sectlevel2">
<li><a href="#req-summary">2.1. At a glance</a></li>
<li><a href="#req-computer">2.2. The computer</a></li>
<li><a href="#req-video">2.3. Video</a></li>
<li><a href="#req-mouse">2.4. Mouse</a></li>
<li><a href="#req-disk">2.5. Disk space</a></li>
<li><a href="#req-optional">2.6. Optional hardware</a></li>
</ul>
</li>
<li><a href="#installing">Chapter 3. Installing DVX</a>
<ul class="sectlevel2">
<li><a href="#installing-media">3.1. The DVX disks</a></li>
<li><a href="#installing-before">3.2. Before you install</a></li>
<li><a href="#installing-setup">3.3. Running Setup</a></li>
<li><a href="#installing-fonts">3.4. Choosing the fonts</a></li>
<li><a href="#installing-parts">3.5. Choosing the parts</a></li>
<li><a href="#installing-addons-cd">3.6. The add-ons on the CD</a></li>
<li><a href="#installing-finish">3.7. Installing and finishing</a></li>
<li><a href="#installing-upgrade">3.8. Upgrading or repairing DVX</a></li>
<li><a href="#installing-remove">3.9. Removing DVX</a></li>
<li><a href="#installing-switches">3.10. Setup&#8217;s command-line switches</a></li>
<li><a href="#installing-files">3.11. Where DVX puts its files</a></li>
<li><a href="#installing-starting">3.12. Starting DVX</a></li>
<li><a href="#installing-safe-start">3.13. Safe start and safe video mode</a></li>
<li><a href="#installing-first-start">3.14. The first start</a></li>
</ul>
</li>
<li><a href="#networking">Chapter 4. Setting Up Networking</a>
<ul class="sectlevel2">
<li><a href="#net-uses">4.1. What networking gives you</a></li>
<li><a href="#net-hardware">4.2. What you need</a></li>
<li><a href="#net-driver">4.3. Loading the packet driver</a></li>
<li><a href="#net-setup">4.4. Network settings</a></li>
<li><a href="#net-check">4.5. Checking that it works</a></li>
<li><a href="#net-trouble">4.6. If the network does not work</a></li>
</ul>
</li>
<li><a href="#desktop">Chapter 5. Using the Desktop</a>
<ul class="sectlevel2">
<li><a href="#desktop-screen">5.1. The screen after start-up</a></li>
<li><a href="#desktop-mouse-keyboard">5.2. Using the mouse and the keyboard</a></li>
<li><a href="#desktop-windows">5.3. Windows</a></li>
<li><a href="#desktop-menus">5.4. Menus</a></li>
<li><a href="#desktop-dialogs">5.5. Dialog boxes and controls</a></li>
<li><a href="#desktop-file-dialogs">5.6. Opening and saving files</a></li>
<li><a href="#desktop-clipboard">5.7. Copying and pasting</a></li>
<li><a href="#desktop-screenshots">5.8. Saving a picture of the screen</a></li>
<li><a href="#desktop-keys">5.9. Keys that work in every program</a></li>
<li><a href="#desktop-task-manager">5.10. Task Manager</a></li>
<li><a href="#desktop-help">5.11. Getting help</a></li>
<li><a href="#desktop-screen-saver">5.12. The screen saver</a></li>
<li><a href="#desktop-sounds">5.13. Desktop sounds</a></li>
<li><a href="#desktop-full-screen">5.14. Programs that use the whole screen</a></li>
<li><a href="#desktop-dos-programs">5.15. Running DOS programs</a></li>
<li><a href="#desktop-exit">5.16. Exiting DVX</a></li>
</ul>
</li>
<li><a href="#programManager">Chapter 6. Program Manager</a>
<ul class="sectlevel2">
<li><a href="#progman-window">6.1. The Program Manager window</a></li>
<li><a href="#progman-starting">6.2. Starting programs</a></li>
<li><a href="#progman-groups">6.3. Groups</a></li>
<li><a href="#progman-items">6.4. Items</a></li>
<li><a href="#progman-views">6.5. Views and arranging icons</a></li>
<li><a href="#progman-search">6.6. Searching for a program</a></li>
<li><a href="#progman-run">6.7. Running a command</a></li>
<li><a href="#progman-dos">6.8. DOS program items</a></li>
<li><a href="#progman-options">6.9. Options</a></li>
<li><a href="#progman-menus">6.10. Menus</a></li>
<li><a href="#progman-keys">6.11. Keyboard shortcuts in Program Manager</a></li>
</ul>
</li>
<li><a href="#controlPanel">Chapter 7. Control Panel</a>
<ul class="sectlevel2">
<li><a href="#cpanel-opening">7.1. Opening Control Panel</a></li>
<li><a href="#cpanel-window">7.2. The Control Panel window</a></li>
<li><a href="#cpanel-changes">7.3. Trying out, keeping, and canceling changes</a></li>
<li><a href="#cpanel-mouse">7.4. Mouse page</a></li>
<li><a href="#cpanel-colors">7.5. Colors page</a></li>
<li><a href="#cpanel-desktop">7.6. Desktop page</a></li>
<li><a href="#cpanel-video">7.7. Video page</a></li>
<li><a href="#cpanel-file-types">7.8. File Types page</a></li>
<li><a href="#cpanel-network">7.9. Network page</a></li>
<li><a href="#cpanel-printer">7.10. Printer page</a></li>
<li><a href="#cpanel-game-controllers">7.11. Game Controllers page</a></li>
<li><a href="#cpanel-sounds">7.12. Sounds page</a></li>
<li><a href="#cpanel-elsewhere">7.13. Settings that are not in Control Panel</a></li>
</ul>
</li>
<li><a href="#programs">Chapter 8. The Standard Programs</a>
<ul class="sectlevel2">
<li><a href="#programs-parts">8.1. Which programs you have</a></li>
<li><a href="#programs-common">8.2. What all programs share</a></li>
<li><a href="#programs-file-manager">8.3. File Manager</a></li>
<li><a href="#programs-notepad">8.4. Notepad</a></li>
<li><a href="#programs-clock">8.5. Clock</a></li>
<li><a href="#programs-image-viewer">8.6. Image Viewer</a></li>
<li><a href="#programs-media-player">8.7. Media Player</a></li>
<li><a href="#programs-sound-recorder">8.8. Sound Recorder</a></li>
<li><a href="#programs-help">8.9. DVX Help</a></li>
<li><a href="#programs-welcome">8.10. Welcome</a></li>
<li><a href="#programs-demos">8.11. DVX Demo and BASIC Demo</a></li>
<li><a href="#programs-screen-savers">8.12. Screen savers</a></li>
<li><a href="#programs-developer">8.13. Developer tools</a></li>
</ul>
</li>
<li><a href="#terminal">Chapter 9. Terminal</a>
<ul class="sectlevel2">
<li><a href="#terminal-needs">9.1. What you need</a></li>
<li><a href="#terminal-starting">9.2. Starting Terminal</a></li>
<li><a href="#terminal-window">9.3. The Terminal window</a></li>
<li><a href="#terminal-phone-book">9.4. The Phone Book</a></li>
<li><a href="#terminal-connecting">9.5. Connecting and disconnecting</a></li>
<li><a href="#terminal-transfers">9.6. Sending and receiving files</a></li>
<li><a href="#terminal-secure-link">9.7. The secure link</a></li>
<li><a href="#terminal-settings">9.8. Terminal settings</a></li>
<li><a href="#terminal-problems">9.9. When something goes wrong in Terminal</a></li>
</ul>
</li>
<li><a href="#addons">Chapter 10. Managing Add-ons</a>
<ul class="sectlevel2">
<li><a href="#addons-kinds">10.1. Add-ons and packages</a></li>
<li><a href="#addons-software">10.2. The Software program</a></li>
<li><a href="#addons-installing">10.3. Installing add-ons</a></li>
<li><a href="#addons-removing">10.4. Removing add-ons</a></li>
<li><a href="#addons-updates">10.5. Keeping DVX and your add-ons up to date</a></li>
<li><a href="#addons-server">10.6. The package server</a></li>
<li><a href="#addons-publishing">10.7. Publishing your own packages</a></li>
<li><a href="#addons-signatures">10.8. Signatures and trusted publishers</a></li>
<li><a href="#addons-parts">10.9. The optional parts of DVX</a></li>
<li><a href="#addons-trouble">10.10. When an add-on causes trouble</a></li>
</ul>
</li>
<li><a href="#troubleshooting">Chapter 11. Troubleshooting</a>
<ul class="sectlevel2">
<li><a href="#trouble-first-steps">11.1. First steps for any problem</a></li>
<li><a href="#trouble-start">11.2. DVX will not start</a></li>
<li><a href="#trouble-video">11.3. The screen is wrong</a></li>
<li><a href="#trouble-mouse">11.4. The mouse does not work</a></li>
<li><a href="#trouble-keyboard">11.5. The keyboard does not work as expected</a></li>
<li><a href="#trouble-joystick">11.6. Game controllers do not work</a></li>
<li><a href="#trouble-sound">11.7. There is no sound</a></li>
<li><a href="#trouble-printing">11.8. Nothing prints</a></li>
<li><a href="#trouble-network">11.9. The network does not work</a></li>
<li><a href="#trouble-serial">11.10. Serial ports, modems, and Terminal</a></li>
<li><a href="#trouble-addons">11.11. Setup, add-ons, and Software</a></li>
<li><a href="#trouble-files">11.12. Files, disks, and folders</a></li>
<li><a href="#trouble-programs">11.13. A program does not work</a></li>
<li><a href="#trouble-programs-basic">11.14. Error messages from DVX BASIC programs</a></li>
<li><a href="#trouble-settings">11.15. Going back to the default settings</a></li>
<li><a href="#trouble-log">11.16. The log file</a></li>
<li><a href="#trouble-messages">11.17. Messages, A to Z</a></li>
</ul>
</li>
<li><a href="#keyboard">Appendix A: Keyboard Shortcuts</a>
<ul class="sectlevel2">
<li><a href="#keys-global">A.1. Keys that work in every program</a></li>
<li><a href="#keys-menus">A.2. Menus</a></li>
<li><a href="#keys-text">A.3. Typing and editing text</a></li>
<li><a href="#keys-clipboard">A.4. Cut, copy, and paste</a></li>
<li><a href="#keys-progman">A.5. Program Manager</a></li>
<li><a href="#keys-cpanel">A.6. Control Panel</a></li>
<li><a href="#keys-file-manager">A.7. File Manager</a></li>
<li><a href="#keys-notepad">A.8. Notepad</a></li>
<li><a href="#keys-terminal">A.9. Terminal</a></li>
<li><a href="#keys-more">A.10. Other programs</a></li>
</ul>
</li>
<li><a href="#folders">Appendix B: DVX Folders and Settings Files</a>
<ul class="sectlevel2">
<li><a href="#folders-layout">B.1. The DVX folders</a></li>
<li><a href="#folders-dvx-ini">B.2. DVX.INI, the settings file</a></li>
<li><a href="#folders-assoc">B.3. ASSOC.INI: which program opens each kind of file</a></li>
<li><a href="#folders-other">B.4. Other settings files</a></li>
<li><a href="#folders-defaults">B.5. Going back to the default settings</a></li>
<li><a href="#folders-log">B.6. The log file, DVX.LOG</a></li>
</ul>
</li>
<li><a href="#index">Index</a></li>
</ul>
</div>
</div>
<div id="content">
<div class="sect1">
<h2 id="aboutDvx"><a class="anchor" href="#aboutDvx"></a>Chapter 1. About DVX</h2>
<div class="sectionbody">
<div class="paragraph">
<p><a id="_ix1" class="ixterm"></a>DVX, the DOS Visual eXecutive, turns a DOS PC into a graphical desktop: windows, menus, icons, and a mouse, with programs to run in them. This chapter tells you what DVX gives you, which programs come with it, which parts you can add or leave out, and how this guide is laid out.</p>
</div>
<div class="sect2">
<h3 id="about-what"><a class="anchor" href="#about-what"></a>1.1. What DVX is</h3>
<div class="paragraph">
<p><a id="_ix2" class="ixterm"></a>DVX is a graphical desktop for DOS computers. Instead of typing commands at the DOS prompt, you work with windows, menus, icons, and a mouse, much like Windows 3.1. You start DVX from the DOS prompt, and when you leave it you are back at the DOS prompt.</p>
</div>
<div class="paragraph">
<p><a id="_ix3" class="ixterm"></a><a id="_ix4" class="ixterm"></a>With DVX you can run several programs at the same time, each in its own window. You can move and resize those windows, switch between them, and copy text from one program to another.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/aboutDesktop.png" alt="The DVX desktop with the Program Manager window showing program icons and a Clock window in front of it">
</div>
<div class="title">Figure 1. The DVX desktop, with Program Manager and Clock open</div>
</div>
<div class="paragraph">
<p>DVX gives you:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>A desktop with the <strong>Program Manager</strong>, which shows your programs as icons sorted into groups. Double-click an icon to start a program.</p>
</li>
<li>
<p><a id="_ix5" class="ixterm"></a>Windows you can move, size, stack, tile, and minimize with the mouse or the keyboard, with menus and dialog boxes that work the same way in every program.</p>
</li>
<li>
<p>Help on every screen: press <kbd>F1</kbd> in any program for help about it.</p>
</li>
<li>
<p>A set of everyday programs: a file manager, a text editor, a clock, a picture viewer, and more (see <a href="#about-programs">Section 1.2</a>).</p>
</li>
<li>
<p>A Control Panel that sets the colors, the desktop picture, the screen resolution, the mouse, sounds, printers, joysticks, and the network.</p>
</li>
<li>
<p><a id="_ix6" class="ixterm"></a>The Software program, which installs, lists, and removes add-on software, from a file or from the package server.</p>
</li>
<li>
<p><a id="_ix7" class="ixterm"></a>A way to start your ordinary DOS programs from the desktop (see <a href="#desktop-dos-programs">Section 5.15</a>).</p>
</li>
</ul>
</div>
<div class="paragraph">
<p><a id="_ix8" class="ixterm"></a><a id="_ix9" class="ixterm"></a>DVX is free software under the MIT licence, Copyright 2026 Scott Duensing. Setup shows the licence before it installs anything. This guide describes DVX version 1.0.0.</p>
</div>
</div>
<div class="sect2">
<h3 id="about-programs"><a class="anchor" href="#about-programs"></a>1.2. The programs that come with DVX</h3>
<div class="paragraph">
<p><a id="_ix10" class="ixterm"></a>These programs are always installed with DVX. Each one is described in the section named beside it.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 50%;">
<col style="width: 30%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Program</th>
<th class="tableblock halign-left valign-top">What it does</th>
<th class="tableblock halign-left valign-top">See</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix11" class="ixterm"></a>Program Manager</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Your home base on the desktop. It opens when DVX starts, stays open while DVX runs, and starts every other program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#programManager">Chapter 6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix12" class="ixterm"></a>File Manager</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Browses, copies, moves, renames, and deletes files and folders.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#programs-file-manager">Section 8.3</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix13" class="ixterm"></a>Notepad</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A simple text editor.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#programs-notepad">Section 8.4</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix14" class="ixterm"></a>Clock</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A digital clock with the date.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#programs-clock">Section 8.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix15" class="ixterm"></a>Image Viewer</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Shows BMP, PNG, JPEG, and GIF pictures.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#programs-image-viewer">Section 8.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix16" class="ixterm"></a>DVX Help</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Shows the help for DVX and its programs, with an index and a search. <kbd>F1</kbd> opens it.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#programs-help">Section 8.9</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix17" class="ixterm"></a>Control Panel</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">System settings and preferences.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#controlPanel">Chapter 7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix18" class="ixterm"></a>Software</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Installs, lists, and removes add-on software.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#addons-software">Section 10.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix19" class="ixterm"></a>Welcome</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Introduces DVX when it starts for the first time, with a short tour.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#programs-welcome">Section 8.10</a></p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix20" class="ixterm"></a>DVX itself also includes the <strong>Task Manager</strong>, which <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Esc</kbd></span> opens from anywhere: it lists the programs that are running and can end one that stopped responding (see <a href="#desktop-task-manager">Section 5.10</a>).</p>
</div>
<div class="paragraph">
<p><a id="_ix21" class="ixterm"></a>Four screen savers come with DVX as well: Blank Screen, Marquee, Mystify, and Starfield (see <a href="#desktop-screen-saver">Section 5.12</a>).</p>
</div>
</div>
<div class="sect2">
<h3 id="about-parts"><a class="anchor" href="#about-parts"></a>1.3. The optional parts</h3>
<div class="paragraph">
<p><a id="_ix22" class="ixterm"></a><a id="_ix23" class="ixterm"></a>Besides DVX itself, which is always installed, DVX comes in seven optional parts. Setup offers each part with a box to tick, and on a new install every box starts ticked. A part you leave out takes no disk space and leaves more memory for your programs.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 23.0769%;">
<col style="width: 53.8461%;">
<col style="width: 23.077%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Part</th>
<th class="tableblock halign-left valign-top">What it adds</th>
<th class="tableblock halign-left valign-top">See</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix24" class="ixterm"></a>DVX BASIC</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC, for writing your own programs: the editor, form designer, compiler, and debugger, with its guides. It also adds <code>BASCOMP.EXE</code>, which builds BASIC programs at the DOS prompt.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#programs-developer">Section 8.13</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix25" class="ixterm"></a>Databases</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">SQLite databases for BASIC programs, with the Data control and the DBGrid control that show them.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#programs-developer">Section 8.13</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix26" class="ixterm"></a>Networking</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The use of a network card (through its DOS packet driver), web requests, and the link from Software to the package server.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#networking">Chapter 4</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix27" class="ixterm"></a><a id="_ix28" class="ixterm"></a>Communications</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The Terminal: modems, serial ports, secure links, Telnet (with Networking), and XMODEM, YMODEM, and ZMODEM file transfers.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#terminal">Chapter 9</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix29" class="ixterm"></a><a id="_ix30" class="ixterm"></a>Media</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The Media Player and the Sound Recorder.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#programs-media-player">Section 8.7</a>, <a href="#programs-sound-recorder">Section 8.8</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix31" class="ixterm"></a>Developer Tools</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The Icon Editor, Resource Editor, Help Editor, Package Builder, and Widget Showcase, with <code>DVXRES.EXE</code> and <code>DVXHLPC.EXE</code> for the DOS prompt.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#programs-developer">Section 8.13</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix32" class="ixterm"></a>Demos</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The DVX Demo and the BASIC Demo.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#programs-demos">Section 8.11</a></p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix33" class="ixterm"></a>No part needs another. In particular, Communications works without Networking: only the Terminal&#8217;s Telnet and the secure link over a network need the Networking part.</p>
</div>
<div class="paragraph">
<p><a id="_ix34" class="ixterm"></a><a id="_ix35" class="ixterm"></a>You can change your mind later. To add a part, run Setup again and choose <b class="button">Upgrade or repair DVX</b> (see <a href="#installing-upgrade">Section 3.8</a>). To remove one, use Setup the same way, or remove it with the Software program, which lists each part you installed as one package (see <a href="#addons-parts">Section 10.9</a>).</p>
</div>
<div class="paragraph">
<p><a id="_ix36" class="ixterm"></a>When a part is not installed, the programs that would use it work without it:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>Welcome hides its <b class="button">Write a program</b> tile without DVX BASIC, and its <b class="button">See it in action</b> tile without the Demos.</p>
</li>
<li>
<p>Without Networking, the <strong>Network</strong> page of the Control Panel shows only &#8220;Networking is not installed.&#8221;, and Software installs packages from files only.</p>
</li>
<li>
<p>Without Networking, the Terminal says &#8220;Telnet and the secure link over the network need Networking, which is not installed. Setup can add it.&#8221;</p>
</li>
</ul>
</div>
</div>
<div class="sect2">
<h3 id="about-extras"><a class="anchor" href="#about-extras"></a>1.4. Fonts, themes, pictures, and sounds</h3>
<div class="paragraph">
<p>DVX comes with more than programs. These are the things that change how it looks and sounds.</p>
</div>
<div class="sect3">
<h4 id="about-fonts"><a class="anchor" href="#about-fonts"></a>1.4.1. Fonts</h4>
<div class="paragraph">
<p><a id="_ix37" class="ixterm"></a><a id="_ix38" class="ixterm"></a>DVX always has its own built-in font. Setup can also install the base set of fonts: DejaVu Sans, DejaVu Sans Mono, and DejaVu Serif, each in regular, bold, italic, and bold italic, in sizes for the screen and for printing. The base set takes about 8 MB. Software lists it as &#8220;DVX Fonts&#8221;.</p>
</div>
<div class="paragraph">
<p><a id="_ix39" class="ixterm"></a><a id="_ix40" class="ixterm"></a>The DVX CD also holds the More Fonts add-on: more than forty more typefaces for documents, programs, and games, including condensed DejaVu, Arimo, Tinos, Cousine, display faces, and pixel fonts (see <a href="#installing-addons-cd">Section 3.6</a>).</p>
</div>
<div class="paragraph">
<p><a id="_ix41" class="ixterm"></a>A program that asks for a font you did not install shows its text in DVX&#8217;s own font instead, unless it carries that font itself. Some programs do, such as Welcome and the DVX Demo.</p>
</div>
<div class="paragraph">
<p><a id="_ix42" class="ixterm"></a>Every font file holds its own licence. The <b class="button">Licence&#8230;&#8203;</b> button of the Font dialog shows it.</p>
</div>
</div>
<div class="sect3">
<h4 id="about-themes"><a class="anchor" href="#about-themes"></a>1.4.2. Color themes and desktop pictures</h4>
<div class="paragraph">
<p><a id="_ix43" class="ixterm"></a>DVX comes with four color themes, in the style of CDE (the Common Desktop Environment), GEOS Ensemble, Hot Dog Stand, and Windows 3.1. You choose a theme, change single colors, and save your own themes on the <strong>Colors</strong> page of the Control Panel (see <a href="#cpanel-colors">Section 7.5</a>).</p>
</div>
<div class="paragraph">
<p><a id="_ix44" class="ixterm"></a>Three desktop pictures (wallpaper) come with DVX, and you can use any BMP, JPEG, PNG, or GIF picture of your own. You choose one on the <strong>Desktop</strong> page of the Control Panel (see <a href="#cpanel-desktop">Section 7.6</a>).</p>
</div>
</div>
<div class="sect3">
<h4 id="about-sounds"><a class="anchor" href="#about-sounds"></a>1.4.3. Sounds and music</h4>
<div class="paragraph">
<p><a id="_ix45" class="ixterm"></a>DVX plays short sounds when it starts and ends, when a message appears, and, if you choose, when a window opens or closes. You choose the sound for each event on the <strong>Sounds</strong> page of the Control Panel (see <a href="#cpanel-sounds">Section 7.12</a>). DVX finds the sound hardware by itself; without any, DVX and its programs work the same, silently.</p>
</div>
<div class="paragraph">
<p><a id="_ix46" class="ixterm"></a>For MIDI music on a sound card&#8217;s music chip, DVX comes with two General MIDI instrument banks, DMXOPL and DMXOPL3, made to sound like a Roland Sound Canvas.</p>
</div>
<div class="paragraph">
<p><a id="_ix47" class="ixterm"></a>The DVX CD also holds the DVX General MIDI add-on, which gives a Gravis UltraSound or a Sound Blaster AWE32 or AWE64 General MIDI instruments (see <a href="#installing-addons-cd">Section 3.6</a>).</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="about-guide"><a class="anchor" href="#about-guide"></a>1.5. About this guide</h3>
<div class="sect3">
<h4 id="about-guide-readers"><a class="anchor" href="#about-guide-readers"></a>1.5.1. Who it is for</h4>
<div class="paragraph">
<p><a id="_ix48" class="ixterm"></a>This guide is for anyone who uses DVX on a DOS PC. You do not need to know how to program. You should know how to turn the computer on and type a command at the DOS prompt. Where DVX needs something done at the DOS level, such as loading a mouse driver from <code>AUTOEXEC.BAT</code>, the guide explains the steps.</p>
</div>
</div>
<div class="sect3">
<h4 id="about-guide-layout"><a class="anchor" href="#about-guide-layout"></a>1.5.2. How it is organized</h4>
<div class="paragraph">
<p><a id="_ix49" class="ixterm"></a>If you are new to DVX, read the first chapters in order: they take you from checking your computer to using the desktop.</p>
</div>
<div class="ulist">
<ul>
<li>
<p><a href="#requirements">Chapter 2</a> lists what your computer needs, and what extra hardware DVX can use.</p>
</li>
<li>
<p><a href="#installing">Chapter 3</a> takes you through Setup, page by page, and through starting DVX for the first time.</p>
</li>
<li>
<p><a href="#networking">Chapter 4</a> connects DVX to a network, if you have a network card.</p>
</li>
<li>
<p><a href="#desktop">Chapter 5</a> explains windows, menus, dialog boxes, the clipboard, help, and the Task Manager.</p>
</li>
<li>
<p><a href="#programManager">Chapter 6</a> explains how to start programs and arrange them in groups.</p>
</li>
<li>
<p><a href="#controlPanel">Chapter 7</a> covers every setting, page by page.</p>
</li>
<li>
<p><a href="#programs">Chapter 8</a> describes each of the programs that come with DVX.</p>
</li>
<li>
<p><a href="#terminal">Chapter 9</a> covers modems, serial links, Telnet, and file transfers.</p>
</li>
<li>
<p><a href="#addons">Chapter 10</a> explains how to install, update, and remove add-on software.</p>
</li>
<li>
<p><a href="#troubleshooting">Chapter 11</a> helps when something does not work, and explains DVX&#8217;s messages.</p>
</li>
<li>
<p>The appendixes list the keyboard shortcuts (<a href="#keyboard">Appendix A</a>) and the folders and settings files DVX uses (<a href="#folders">Appendix B</a>).</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>The index at the end lists every topic, setting, and message.</p>
</div>
</div>
<div class="sect3">
<h4 id="about-guide-conventions"><a class="anchor" href="#about-guide-conventions"></a>1.5.3. Conventions</h4>
<div class="paragraph">
<p><a id="_ix50" class="ixterm"></a>This guide shows the things you see and do in these ways:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 30%;">
<col style="width: 30%;">
<col style="width: 40%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">What</th>
<th class="tableblock halign-left valign-top">How it looks</th>
<th class="tableblock halign-left valign-top">Meaning</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">A menu command</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Exit DVX</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Open the File menu and choose Exit DVX.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">A button</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">OK</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Click the OK button.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">A key, or keys pressed together</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F1</kbd>, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Esc</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Press F1. Hold down Ctrl and press Esc.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">The label of a box, list, check box, option button, or tab</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Computer name</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The box labelled Computer name on the screen. Labels are shown without the colon that follows them on the screen.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">A window title or the name of a page</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Program Manager</strong>, <strong>Network</strong> page</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The window or page with that name.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">A file, a folder, a command, or anything you type</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>DVX.INI</code>, <code>C:\DVX\USER</code>, <code>SETUP</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Type it exactly as shown.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">A message DVX shows</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Are you sure you want to exit DVX?&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The exact words on the screen.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">A word that stands for something that changes</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> is already running.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">In the message, <em>name</em> is replaced by the file name of a program, such as <code>NOTEPAD.APP</code>.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix51" class="ixterm"></a>The examples assume that DVX is installed in <code>C:\DVX</code>, which is where Setup suggests putting it. If you chose another folder, use that folder instead. Your own settings and files are in the <code>USER</code> folder inside it, <code>C:\DVX\USER</code>.</p>
</div>
<div class="paragraph">
<p><a id="_ix52" class="ixterm"></a>To <em>click</em> means to press and release the left mouse button; to <em>double-click</em> means to click twice quickly. To <em>tick</em> a check box means to click it so a mark shows in it; to <em>untick</em> it means to click it again so the mark goes away. You can do almost everything with the keyboard as well (see <a href="#desktop-mouse-keyboard">Section 5.2</a>).</p>
</div>
<div class="admonitionblock note">
<table>
<tr>
<td class="icon">
<div class="title">Note</div>
</td>
<td class="content">
A note gives extra information.
</td>
</tr>
</table>
</div>
<div class="admonitionblock tip">
<table>
<tr>
<td class="icon">
<div class="title">Tip</div>
</td>
<td class="content">
A tip shows an easier or quicker way.
</td>
</tr>
</table>
</div>
<div class="admonitionblock important">
<table>
<tr>
<td class="icon">
<div class="title">Important</div>
</td>
<td class="content">
An important note tells you something you must do for a step to work.
</td>
</tr>
</table>
</div>
<div class="admonitionblock warning">
<table>
<tr>
<td class="icon">
<div class="title">Warning</div>
</td>
<td class="content">
A warning tells you about something that can lose your work or your files.
</td>
</tr>
</table>
</div>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="requirements"><a class="anchor" href="#requirements"></a>Chapter 2. System Requirements</h2>
<div class="sectionbody">
<div class="paragraph">
<p><a id="_ix53" class="ixterm"></a>This chapter lists what your computer needs to run DVX, and the extra hardware DVX can use if you have it. Check it before you install DVX.</p>
</div>
<div class="sect2">
<h3 id="req-summary"><a class="anchor" href="#req-summary"></a>2.1. At a glance</h3>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 22.2222%;">
<col style="width: 44.4444%;">
<col style="width: 33.3334%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">What</th>
<th class="tableblock halign-left valign-top">You need</th>
<th class="tableblock halign-left valign-top">Better</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Processor</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">An 80486DX or newer (a 486 with a math coprocessor)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A Pentium</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Memory</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">4 MB of extended memory</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">8 MB or more</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DOS</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DOS 5.0 or later, such as MS-DOS or FreeDOS</p></td>
<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Video</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A video card with a VESA BIOS (or a VESA driver) and a 640x480 mode at 256 colors or more</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Modes with more colors and higher resolutions</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Mouse</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A two-button mouse and its DOS mouse driver</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A wheel mouse with a driver that supports the wheel</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Hard disk</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">About 9 MB for the smallest install, about 22 MB for everything</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">More for the add-ons on the CD and for your own files</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>Sound cards, MIDI equipment, network cards, modems, printers, and joysticks are all optional (see <a href="#req-optional">Section 2.6</a>).</p>
</div>
</div>
<div class="sect2">
<h3 id="req-computer"><a class="anchor" href="#req-computer"></a>2.2. The computer</h3>
<div class="sect3">
<h4 id="req-processor"><a class="anchor" href="#req-processor"></a>2.2.1. Processor</h4>
<div class="paragraph">
<p><a id="_ix54" class="ixterm"></a><a id="_ix55" class="ixterm"></a>DVX needs an 80486DX or newer processor, that is, a 486 with a math coprocessor: a 486DX, DX2, or DX4, or any Pentium. A 486SX needs a 487 math coprocessor added. DVX does not run on a 386. A faster processor makes everything quicker. It matters most for music modules (MOD, S3M, XM, and IT files), which the computer mixes itself unless a Gravis UltraSound or a Sound Blaster AWE plays them on its own voices.</p>
</div>
</div>
<div class="sect3">
<h4 id="req-memory"><a class="anchor" href="#req-memory"></a>2.2.2. Memory</h4>
<div class="paragraph">
<p><a id="_ix56" class="ixterm"></a><a id="_ix57" class="ixterm"></a>DVX needs 4 MB of extended memory (the memory above the first megabyte), and 8 MB or more is recommended. DVX brings what it needs to use that memory: you do not have to load anything extra for it.</p>
</div>
<div class="paragraph">
<p><a id="_ix58" class="ixterm"></a>Each running program uses memory. To leave more room for your programs:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>Leave out the optional parts of DVX you do not need (see <a href="#installing-parts">Section 3.5</a>). A part you leave out leaves more memory for your programs.</p>
</li>
<li>
<p>Use a lower screen resolution or fewer colors (see <a href="#cpanel-video">Section 7.7</a>).</p>
</li>
<li>
<p>Close programs you are not using.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p><a id="_ix59" class="ixterm"></a><a id="_ix60" class="ixterm"></a>To see how much memory is in use now, open the Task Manager with <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Esc</kbd></span>: its bottom line shows the memory in use and the total. <span class="menuseq"><b class="menu">Help</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">System Information&#8230;&#8203;</b></span> in the Program Manager shows how much memory was free when DVX started.</p>
</div>
</div>
<div class="sect3">
<h4 id="req-dos"><a class="anchor" href="#req-dos"></a>2.2.3. DOS</h4>
<div class="paragraph">
<p><a id="_ix61" class="ixterm"></a><a id="_ix62" class="ixterm"></a>DVX needs DOS 5.0 or later, such as MS-DOS or FreeDOS. You start DVX from the DOS prompt.</p>
</div>
<div class="paragraph">
<p><a id="_ix63" class="ixterm"></a>DVX handles disks formatted with FAT32 and files larger than 2 GB. It uses long file names when a long-file-name driver, such as DOSLFN, is loaded before DVX; without one, it uses the usual short DOS names.</p>
</div>
<div class="paragraph">
<p><a id="_ix64" class="ixterm"></a>The drivers DVX uses, such as the mouse driver, a VESA driver, and a network packet driver, are DOS programs you load before you start DVX. The usual place for them is the file <code>AUTOEXEC.BAT</code> in the top folder of your start-up disk (normally <code>C:\AUTOEXEC.BAT</code>), which DOS runs each time the computer starts. Settings that DVX reads from DOS, such as <code>BLASTER</code> for a Sound Blaster, also go there, as <code>SET</code> lines.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="req-video"><a class="anchor" href="#req-video"></a>2.3. Video</h3>
<div class="sect3">
<h4 id="req-video-vesa"><a class="anchor" href="#req-video-vesa"></a>2.3.1. A VESA video card</h4>
<div class="paragraph">
<p><a id="_ix65" class="ixterm"></a><a id="_ix66" class="ixterm"></a><a id="_ix67" class="ixterm"></a>DVX draws its screen in a graphics mode, which it sets through the video card&#8217;s VESA BIOS (also called VBE). Nearly every video card made from about 1992 on has one. DVX needs:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>a VESA BIOS of any version, built into the card or added by a VESA driver (see <a href="#req-video-driver">Section 2.3.2</a>), and</p>
</li>
<li>
<p>at least one mode of 640x480 or more, with 256 colors or more.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p><a id="_ix68" class="ixterm"></a>DVX can use the card&#8217;s modes with 256 colors, 32 thousand colors, 65 thousand colors, or 16 million colors. Of the 16 million color modes it uses those that store a pixel in 32 bits; it does not use modes that store a pixel in 24 bits.</p>
</div>
<div class="paragraph">
<p><a id="_ix69" class="ixterm"></a>You pick the resolution and colors on the <strong>Video</strong> page of the Control Panel, which lists every mode your card offers (see <a href="#cpanel-video">Section 7.7</a>). Setup itself normally runs at 640x480, and after a new install DVX starts in the mode Setup used, because that mode is known to work on your computer. Your monitor must be able to show the mode you choose; if it cannot, start DVX in safe video mode (see <a href="#installing-safe-start">Section 3.13</a>).</p>
</div>
<div class="paragraph">
<p><a id="_ix70" class="ixterm"></a>Smooth text, where the edges of letters are shaded, needs a mode with more than 256 colors.</p>
</div>
<div class="paragraph">
<p><a id="_ix71" class="ixterm"></a>Older cards whose VESA BIOS is version 1, or which cannot give DVX direct access to all of their video memory, work too, but the screen updates more slowly on them. A VESA driver such as UniVBE may make such a card faster.</p>
</div>
</div>
<div class="sect3">
<h4 id="req-video-driver"><a class="anchor" href="#req-video-driver"></a>2.3.2. When the card has no VESA BIOS</h4>
<div class="paragraph">
<p><a id="_ix72" class="ixterm"></a><a id="_ix73" class="ixterm"></a>Many older cards have no VESA BIOS of their own, or only an incomplete one. They need a VESA driver, a small DOS program that is loaded before DVX:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>UniVBE (Scitech Display Doctor) works with most cards.</p>
</li>
<li>
<p>Some cards came with their own VESA driver, such as S3VBE20 for S3 cards and M64VBE for ATI Mach64 cards. Look on the card&#8217;s driver disk.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>To use one:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Copy the driver to your hard disk, as its instructions say.</p>
</li>
<li>
<p>Load it before DVX. Either type its name at the DOS prompt each time before you start DVX or Setup, or add it to <code>AUTOEXEC.BAT</code> above the line that starts DVX, so it loads each time the computer starts.</p>
</li>
<li>
<p>Start Setup, or DVX.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p><a id="_ix74" class="ixterm"></a><a id="_ix75" class="ixterm"></a>If DVX finds no mode it can use, it does not start. It prints this message at the DOS prompt:</p>
</div>
<div class="paragraph">
<p>&#8220;DVX could not start: the video card offered no usable graphics mode. DVX needs a VESA video BIOS with a mode of at least 640x480 at 256 colors or more. Many older cards need their VESA driver loaded first: UniVBE (Scitech Display Doctor) works with most cards, and some cards came with their own, such as S3VBE20 for S3 cards and M64VBE for ATI Mach64 cards. The details are in DVX.LOG in the USER folder.&#8221;</p>
</div>
<div class="paragraph">
<p><a id="_ix76" class="ixterm"></a><a id="_ix77" class="ixterm"></a>Setup needs the same kind of video. Without it, Setup says &#8220;DVX Setup needs a video card with a VESA video BIOS and a 640x480 mode at 256 colors or more; many older cards need their VESA driver loaded first, such as UniVBE (see README.TXT).&#8221;</p>
</div>
<div class="paragraph">
<p>For more help with the screen, see <a href="#trouble-video">Section 11.3</a>.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="req-mouse"><a class="anchor" href="#req-mouse"></a>2.4. Mouse</h3>
<div class="paragraph">
<p><a id="_ix78" class="ixterm"></a><a id="_ix79" class="ixterm"></a>DVX works with a two-button mouse through its DOS mouse driver. Load the mouse driver before you start DVX, usually from <code>AUTOEXEC.BAT</code>, or by typing its name at the DOS prompt.</p>
</div>
<div class="paragraph">
<p><a id="_ix80" class="ixterm"></a>Without a mouse driver DVX still starts, but the pointer does not move. You can still do almost everything with the keyboard (see <a href="#desktop-mouse-keyboard">Section 5.2</a>).</p>
</div>
<div class="paragraph">
<p><a id="_ix81" class="ixterm"></a>A scroll wheel works when the mouse driver supports the wheel the way the CuteMouse driver does. To check, choose <span class="menuseq"><b class="menu">Help</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">System Information&#8230;&#8203;</b></span> in the Program Manager: it shows &#8220;Wheel: Yes (CuteMouse Wheel API)&#8221; when DVX can use the wheel, and &#8220;Wheel: No&#8221; when it cannot. Without wheel support everything else still works.</p>
</div>
<div class="paragraph">
<p>For more help with the mouse, see <a href="#trouble-mouse">Section 11.4</a>.</p>
</div>
</div>
<div class="sect2">
<h3 id="req-disk"><a class="anchor" href="#req-disk"></a>2.5. Disk space</h3>
<div class="paragraph">
<p><a id="_ix82" class="ixterm"></a><a id="_ix83" class="ixterm"></a><a id="_ix84" class="ixterm"></a>How much room DVX needs depends on what you install. Setup shows the amount your choices need on its <strong>What to install</strong> page, in the line &#8220;DVX needs about <em>n</em> MB of disk space.&#8221;, which changes as you tick and untick the choices. Before it unpacks anything, Setup checks that the disk has that much room free.</p>
</div>
<div class="paragraph">
<p>The figures below are approximate:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 71.4285%;">
<col style="width: 28.5715%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">What you install</th>
<th class="tableblock halign-left valign-top">About</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Everything: all seven parts and the base set of fonts (Setup&#8217;s choice for a new install)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">22 MB</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">All seven parts, without fonts</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">14 MB</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX itself and the base set of fonts, without the optional parts</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">17 MB</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX itself only, without the optional parts or fonts</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">9 MB</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Everything, plus both add-ons on the CD</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">33 MB</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix85" class="ixterm"></a>The choices add roughly these amounts:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 71.4285%;">
<col style="width: 28.5715%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Choice</th>
<th class="tableblock halign-left valign-top">About</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Base set of fonts</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">8 MB</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2.7 MB</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Databases</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">0.7 MB</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Networking</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">0.3 MB</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Communications</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">0.4 MB</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Media</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">0.1 MB</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Developer Tools</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">0.9 MB</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Demos</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">0.2 MB</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">More Fonts (add-on on the CD)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">8 MB</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX General MIDI (add-on on the CD)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">4 MB</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix86" class="ixterm"></a>When you upgrade, Setup counts only what the folder does not already have.</p>
</div>
<div class="paragraph">
<p>Leave room as well for your own files and settings, which DVX keeps in its <code>USER</code> folder (see <a href="#folders-layout">Section B.1</a>).</p>
</div>
<div class="paragraph">
<p><a id="_ix87" class="ixterm"></a>If the disk is too full, Setup says &#8220;There is not enough free space for DVX on that disk. DVX needs about <em>n</em> bytes; <em>n</em> bytes are free.&#8221; Free some space, or choose another disk, and try again.</p>
</div>
</div>
<div class="sect2">
<h3 id="req-optional"><a class="anchor" href="#req-optional"></a>2.6. Optional hardware</h3>
<div class="paragraph">
<p>DVX works without any of the hardware in this section. Each item adds something when you have it.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 25%;">
<col style="width: 50%;">
<col style="width: 25%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Hardware</th>
<th class="tableblock halign-left valign-top">What it gives you</th>
<th class="tableblock halign-left valign-top">See</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">A sound card</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Event sounds, and sound and music in the Media Player and other programs. Recording, on most cards.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#req-sound">Section 2.6.1</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">A MIDI port or a wavetable card</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">MIDI music on an external synthesizer, recorded instruments, and recording from a MIDI keyboard.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#req-midi">Section 2.6.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">A network card</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Telnet, the secure link over a network, and the package server in Software.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#req-network">Section 2.6.3</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Serial ports and a modem</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Dialling bulletin boards and other computers, serial links, file transfers, and serial printers.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#req-serial">Section 2.6.4</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">A printer</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Printing from programs.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#req-printer">Section 2.6.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">A joystick</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Games and BASIC programs that use one.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#req-joystick">Section 2.6.6</a></p></td>
</tr>
</tbody>
</table>
<div class="sect3">
<h4 id="req-sound"><a class="anchor" href="#req-sound"></a>2.6.1. Sound cards</h4>
<div class="paragraph">
<p><a id="_ix88" class="ixterm"></a><a id="_ix89" class="ixterm"></a>DVX finds the sound hardware by itself. If <code>DVX.INI</code> names a sound driver, DVX tries that one first; otherwise, or if it does not start, DVX looks, in this order, for a Windows Sound System board, a Sound Blaster, a Gravis UltraSound, a sound device on the printer port, and the PC speaker. Without any sound hardware, DVX and its programs work the same, silently.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 30%;">
<col style="width: 70%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Hardware</th>
<th class="tableblock halign-left valign-top">Notes</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix90" class="ixterm"></a><a id="_ix91" class="ixterm"></a>Sound Blaster</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The Sound Blaster 1.x, 1.5, 2.0, Pro, Pro 2, and 16, and the music chip of the AWE32 and AWE64. DVX reads the card&#8217;s settings from the <code>BLASTER</code> line in <code>AUTOEXEC.BAT</code>, for example <code>SET BLASTER=A220 I5 D1 H5</code> (an AWE&#8217;s setting adds <code>E620</code> for its music chip). The card&#8217;s manual or setup program gives the numbers. A Sound Blaster 16 is also found without the <code>BLASTER</code> line, at port 220h or 240h; older Sound Blasters, and the music chip of an AWE, need it.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix92" class="ixterm"></a>Windows Sound System</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Windows Sound System boards and compatibles: Microsoft, Crystal CS4231 and CS4248, Aztech, and OPTi cards in Windows Sound System mode. DVX looks for them at their usual ports, 530h, 604h, E80h, and F40h.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix93" class="ixterm"></a><a id="_ix94" class="ixterm"></a>Gravis UltraSound</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The Gravis UltraSound, including the UltraSound MAX. DVX reads the card&#8217;s settings from the <code>ULTRASND</code> line in <code>AUTOEXEC.BAT</code>, for example <code>SET ULTRASND=220,1,1,11,5</code>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix95" class="ixterm"></a>Printer-port sound devices</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A Disney Sound Source or a Stereo-on-1 is found by itself. A Covox Speech Thing must be named in <code>DVX.INI</code>: in the <code>[audio]</code> section, set <code>lptDac = covox</code>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix96" class="ixterm"></a>PC speaker</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Plays tones and beeps, but not recorded sounds. Setting <code>speakerPcm = true</code> in the <code>[audio]</code> section of <code>DVX.INI</code> makes it play recorded sounds as well, but that takes much of the computer&#8217;s time.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix97" class="ixterm"></a>FM music chip</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The AdLib-style music chip on an AdLib or Sound Blaster card (OPL2 or OPL3, at port 388h) plays MIDI music with DVX&#8217;s instrument banks.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix98" class="ixterm"></a>Sound Blasters, Windows Sound System boards, and the Gravis UltraSound can also record, from a microphone, the line input, or a CD, as the card has them. The Sound Recorder uses this (see <a href="#programs-sound-recorder">Section 8.8</a>).</p>
</div>
<div class="paragraph">
<p>The <strong>Sounds</strong> page of the Control Panel shows the sound device in use, lets you choose another, and sets the volume (see <a href="#cpanel-sounds">Section 7.12</a>). If there is no sound, see <a href="#trouble-sound">Section 11.7</a>.</p>
</div>
</div>
<div class="sect3">
<h4 id="req-midi"><a class="anchor" href="#req-midi"></a>2.6.2. MIDI</h4>
<div class="paragraph">
<p><a id="_ix99" class="ixterm"></a>DVX plays MIDI music in one of several ways, which you choose under <strong>MIDI music</strong> on the <strong>Sounds</strong> page of the Control Panel. With the first choice, &#8220;Automatic&#8221;, DVX uses a Gravis UltraSound&#8217;s or Sound Blaster AWE&#8217;s recorded instruments when it has them, else the card&#8217;s FM music chip, else its own built-in synthesizer, which needs no MIDI hardware at all. Changes to the sound driver and to MIDI take effect when DVX next starts.</p>
</div>
<div class="ulist">
<ul>
<li>
<p><a id="_ix100" class="ixterm"></a><a id="_ix101" class="ixterm"></a>A MIDI port (an MPU-401 or compatible, such as a Sound Blaster 16&#8217;s) drives an external synthesizer, such as a Roland MT-32 or SC-55. <code>DVX.INI</code> tells DVX what is on the port: <code>mpuMode</code> in the <code>[audio]</code> section is <code>gm</code> for a General MIDI synthesizer, <code>mt32</code> for a Roland MT-32, or <code>raw</code> to send the music unchanged.</p>
</li>
<li>
<p><a id="_ix102" class="ixterm"></a>A Gravis UltraSound or a Sound Blaster AWE32 or AWE64 plays MIDI music with recorded instruments. The DVX General MIDI add-on on the CD gives these cards a General MIDI set of instruments (see <a href="#installing-addons-cd">Section 3.6</a>).</p>
</li>
<li>
<p><a id="_ix103" class="ixterm"></a><a id="_ix104" class="ixterm"></a>A MIDI keyboard on the MIDI port can be recorded into MIDI files with the Sound Recorder. Choose &#8220;MIDI port&#8221; under <strong>MIDI in</strong> on the <strong>Sounds</strong> page.</p>
</li>
</ul>
</div>
</div>
<div class="sect3">
<h4 id="req-network"><a class="anchor" href="#req-network"></a>2.6.3. Network card</h4>
<div class="paragraph">
<p><a id="_ix105" class="ixterm"></a><a id="_ix106" class="ixterm"></a>DVX uses an Ethernet network card through the card&#8217;s DOS packet driver, which you load before DVX. You also need DVX&#8217;s Networking part. With them you can use Telnet and the secure link over a network in the Terminal, the package server in Software, and BASIC programs that use the network. <a href="#networking">Chapter 4</a> explains how to set it up.</p>
</div>
</div>
<div class="sect3">
<h4 id="req-serial"><a class="anchor" href="#req-serial"></a>2.6.4. Serial ports and modems</h4>
<div class="paragraph">
<p><a id="_ix107" class="ixterm"></a><a id="_ix108" class="ixterm"></a>DVX uses the serial ports COM1 to COM4 and finds out by itself which kind of serial chip each one has (8250, 16450, 16550, or 16550A). The Terminal, in the Communications part, uses them for modems, direct serial links, and the secure link (see <a href="#terminal">Chapter 9</a>). The serial ports can also drive a serial printer.</p>
</div>
</div>
<div class="sect3">
<h4 id="req-printer"><a class="anchor" href="#req-printer"></a>2.6.5. Printers</h4>
<div class="paragraph">
<p><a id="_ix109" class="ixterm"></a><a id="_ix110" class="ixterm"></a>DVX prints on printers connected to LPT1 to LPT3 or to a serial port, and can also print to a file. You choose the printer on the <strong>Printer</strong> page of the Control Panel (see <a href="#cpanel-printer">Section 7.10</a>). It knows these kinds of printer:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>Text only (any printer)</p>
</li>
<li>
<p>Epson 9-pin and 24-pin printers (ESC/P), in black and in color</p>
</li>
<li>
<p>HP LaserJet (PCL), and the HP LaserJet III or DeskJet at 300 dpi</p>
</li>
<li>
<p>HP DeskJet 500C, and the DeskJet 550C and later, in color</p>
</li>
<li>
<p>PostScript printers, in black and in color</p>
</li>
<li>
<p>Apple ImageWriter II, in black and in color</p>
</li>
</ul>
</div>
</div>
<div class="sect3">
<h4 id="req-joystick"><a class="anchor" href="#req-joystick"></a>2.6.6. Joysticks</h4>
<div class="paragraph">
<p><a id="_ix111" class="ixterm"></a>DVX uses joysticks on the standard game port: two joysticks with two buttons each, or one joystick with four axes and four buttons, such as a flight stick with a throttle or rudder. When no joystick is found, programs can use the keyboard as a joystick instead. You set this up on the <strong>Game Controllers</strong> page of the Control Panel (see <a href="#cpanel-game-controllers">Section 7.11</a>).</p>
</div>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="installing"><a class="anchor" href="#installing"></a>Chapter 3. Installing DVX</h2>
<div class="sectionbody">
<div class="paragraph">
<p><a id="_ix112" class="ixterm"></a><a id="_ix113" class="ixterm"></a>DVX is installed with Setup, which copies DVX from the DVX CD or floppy disks onto your hard disk. It takes a few minutes. This chapter takes you through Setup page by page, then explains how to upgrade, repair, and remove DVX, how to start it, and what you see the first time it starts.</p>
</div>
<div class="paragraph">
<p>In short, a new install goes like this:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Start Setup from the CD or from Disk 1 (see <a href="#installing-setup">Section 3.3</a>).</p>
</li>
<li>
<p>Accept the licence.</p>
</li>
<li>
<p>Choose <b class="button">Install DVX</b>.</p>
</li>
<li>
<p>Choose the folder for DVX, normally <code>C:\DVX</code>.</p>
</li>
<li>
<p>Choose the fonts, the parts of DVX, and the add-ons you want.</p>
</li>
<li>
<p>Click <b class="button">Install</b> and wait while Setup unpacks DVX.</p>
</li>
<li>
<p>Click <b class="button">Finish</b> to start DVX.</p>
</li>
</ol>
</div>
<div class="sect2">
<h3 id="installing-media"><a class="anchor" href="#installing-media"></a>3.1. The DVX disks</h3>
<div class="paragraph">
<p><a id="_ix114" class="ixterm"></a>DVX comes on a CD or on a set of floppy disks. Both hold the same DVX; only the CD also has the add-ons.</p>
</div>
<div class="sect3">
<h4 id="installing-media-cd"><a class="anchor" href="#installing-media-cd"></a>3.1.1. The CD</h4>
<div class="paragraph">
<p><a id="_ix115" class="ixterm"></a><a id="_ix116" class="ixterm"></a>The top folder of the DVX CD holds:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 28.5714%;">
<col style="width: 71.4286%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">File or folder</th>
<th class="tableblock halign-left valign-top">What it is</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>SETUP.EXE</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Setup, with all of DVX packed inside it.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>README.TXT</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A short text file that says what DVX needs and how to install it.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>SETUP.INI</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The list of DVX&#8217;s optional parts, which Setup reads.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>ADDONS</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The add-ons: More Fonts (<code>MOREFONT.DPK</code>) and DVX General MIDI (<code>DVXGM.DPK</code>), each with its signature file (<code>MOREFONT.SIG</code> and <code>DVXGM.SIG</code>). See <a href="#installing-addons-cd">Section 3.6</a>.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>You cannot run DVX from the CD itself: it holds Setup and DVX in packed form. Install DVX on your hard disk first.</p>
</div>
</div>
<div class="sect3">
<h4 id="installing-media-floppy"><a class="anchor" href="#installing-media-floppy"></a>3.1.2. The floppy disks</h4>
<div class="paragraph">
<p><a id="_ix117" class="ixterm"></a><a id="_ix118" class="ixterm"></a>The floppy disks are 1.44 MB disks, numbered Disk 1, Disk 2, and so on. Disk 1 holds <code>SETUP.EXE</code>, <code>README.TXT</code>, <code>SETUP.INI</code>, and the start of DVX; each of the other disks holds the next piece. Setup asks for each disk in turn. The last disks hold only the base set of fonts, so if you choose not to install the fonts, Setup does not ask for them.</p>
</div>
<div class="paragraph">
<p>The floppy disks have no add-ons. You can install the add-ons later from the package server with the Software program (see <a href="#addons-installing">Section 10.3</a>).</p>
</div>
<div class="paragraph">
<p><a id="_ix119" class="ixterm"></a>Setup never writes to the CD or the floppy disks, so you can keep the floppy disks write-protected.</p>
</div>
<div class="paragraph">
<p><a id="_ix120" class="ixterm"></a>DVX, its parts, its fonts, and its add-ons are also published on the package server, where the Software program finds updates to them (see <a href="#addons-updates">Section 10.5</a>).</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="installing-before"><a class="anchor" href="#installing-before"></a>3.2. Before you install</h3>
<div class="paragraph">
<p><a id="_ix121" class="ixterm"></a>Check these things before you start Setup:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Your computer meets the requirements in <a href="#requirements">Chapter 2</a>.</p>
</li>
<li>
<p>The mouse driver is loaded (see <a href="#req-mouse">Section 2.4</a>). You can also use Setup with the keyboard alone.</p>
</li>
<li>
<p>If your video card needs a VESA driver, it is loaded (see <a href="#req-video-driver">Section 2.3.2</a>). Setup uses the same graphics screen as DVX, so it needs the VESA driver too.</p>
</li>
<li>
<p>The hard disk has room for DVX: about 22 MB for everything (see <a href="#req-disk">Section 2.5</a>). Setup tells you how much your choices need before it starts.</p>
</li>
</ol>
</div>
</div>
<div class="sect2">
<h3 id="installing-setup"><a class="anchor" href="#installing-setup"></a>3.3. Running Setup</h3>
<div class="sect3">
<h4 id="installing-setup-start"><a class="anchor" href="#installing-setup-start"></a>3.3.1. Starting Setup</h4>
<div class="paragraph">
<p><a id="_ix122" class="ixterm"></a>To start Setup from the CD:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Put the DVX CD in the CD-ROM drive.</p>
</li>
<li>
<p>At the DOS prompt, type the letter of the CD-ROM drive followed by a colon, for example <code>D:</code>, and press <kbd>Enter</kbd>.</p>
</li>
<li>
<p>Type <code>SETUP</code> and press <kbd>Enter</kbd>.</p>
</li>
</ol>
</div>
<div class="listingblock">
<div class="content">
<pre>D:
SETUP</pre>
</div>
</div>
<div class="paragraph">
<p>To start Setup from the floppy disks:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Put Disk 1 in drive A:.</p>
</li>
<li>
<p>At the DOS prompt, type <code>A:</code> and press <kbd>Enter</kbd>.</p>
</li>
<li>
<p>Type <code>SETUP</code> and press <kbd>Enter</kbd>.</p>
</li>
</ol>
</div>
<div class="listingblock">
<div class="content">
<pre>A:
SETUP</pre>
</div>
</div>
<div class="paragraph">
<p><a id="_ix123" class="ixterm"></a>Setup changes the screen to graphics. On a dark blue background it shows a large gold DVX, the words &#8220;The DOS Visual eXecutive&#8221; and &#8220;Windows, programs, and games for your DOS computer&#8221;, and a window titled <strong>DVX Setup</strong>, which shows one page at a time.</p>
</div>
<div class="paragraph">
<p><a id="_ix124" class="ixterm"></a><a id="_ix125" class="ixterm"></a>You can use Setup with the mouse or the keyboard, as everywhere in DVX: <kbd>Tab</kbd> moves from one control to the next, <kbd>Alt</kbd> with an underlined letter chooses that control, and <kbd>Enter</kbd> or <kbd>Space</kbd> presses the button that has the focus.</p>
</div>
<div class="paragraph">
<p><a id="_ix126" class="ixterm"></a>Until Setup starts installing, every page has an <b class="button">Exit</b> button, which quits Setup without installing anything. Closing the <strong>DVX Setup</strong> window with its Close box also quits Setup, and stops an install that is in progress.</p>
</div>
</div>
<div class="sect3">
<h4 id="installing-licence"><a class="anchor" href="#installing-licence"></a>3.3.2. The licence</h4>
<div class="paragraph">
<p><a id="_ix127" class="ixterm"></a><a id="_ix128" class="ixterm"></a>The first page says &#8220;Welcome! Setup puts DVX on your hard disk in a few minutes.&#8221; and shows the licence that DVX is distributed under, the MIT licence, in a box you can scroll.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/instLicence.png" alt="The DVX Setup screen: the gold DVX title over a blue background" width="and the DVX Setup window showing the licence" height="the I accept the licence check box">
</div>
<div class="title">Figure 2. Setup&#8217;s first page, with the licence</div>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Read the licence.</p>
</li>
<li>
<p>Tick <strong>I accept the licence</strong>. The <b class="button">Next &gt;</b> button can only be used once the box is ticked.</p>
</li>
<li>
<p>Click <b class="button">Next &gt;</b>.</p>
</li>
</ol>
</div>
</div>
<div class="sect3">
<h4 id="installing-choice"><a class="anchor" href="#installing-choice"></a>3.3.3. Choosing what to do</h4>
<div class="paragraph">
<p><a id="_ix129" class="ixterm"></a>The next page asks &#8220;What would you like to do?&#8221; It has three choices, each with a picture and a button. Click either the picture or the button.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/instStart.png" alt="The DVX Setup window asking What would you like to do" width="with the Install DVX" height="Upgrade or repair DVX">
</div>
<div class="title">Figure 3. Setup&#8217;s start page</div>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 27.2727%;">
<col style="width: 45.4545%;">
<col style="width: 27.2728%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Choice</th>
<th class="tableblock halign-left valign-top">What the page says</th>
<th class="tableblock halign-left valign-top">See</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">Install DVX</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Put DVX on this computer, in a folder you choose.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">This section</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">Upgrade or repair DVX</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Bring DVX up to date, or put back missing files.&#8221; &#8220;Your settings and saved files are kept.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#installing-upgrade">Section 3.8</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">Remove DVX</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Take DVX off this computer.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#installing-remove">Section 3.9</a></p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix130" class="ixterm"></a>If DVX is already in the folder Setup suggests, the page also says &#8220;DVX is already installed in C:\DVX.&#8221; (with your folder) and <b class="button">Upgrade or repair DVX</b> has the focus. Otherwise <b class="button">Install DVX</b> has the focus.</p>
</div>
<div class="paragraph">
<p><b class="button">&lt; Back</b> returns to the licence.</p>
</div>
</div>
<div class="sect3">
<h4 id="installing-folder"><a class="anchor" href="#installing-folder"></a>3.3.4. Choosing the folder</h4>
<div class="paragraph">
<p><a id="_ix131" class="ixterm"></a><a id="_ix132" class="ixterm"></a>After you choose <b class="button">Install DVX</b>, Setup asks where to put DVX, in the box <strong>Install DVX in this folder</strong>. It suggests the folder <code>DVX</code> on the drive the computer started from, normally <code>C:\DVX</code>.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/instFolder.png" alt="The DVX Setup window with the folder C:\DVX typed in the box" width="the Browse button" height="and the Start DVX when the computer starts check box">
</div>
<div class="title">Figure 4. Choosing the folder for DVX</div>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Keep the folder Setup suggests, or type another one. Type the whole path, starting with the drive, for example <code>D:\DVX</code>. To pick a folder from a list instead, click <b class="button">Browse&#8230;&#8203;</b>: the <strong>Choose a Folder</strong> dialog opens (see <a href="#desktop-file-dialogs">Section 5.6</a>). The folder does not have to exist yet; Setup makes it when it starts installing.</p>
</li>
<li>
<p>If you want DVX to start each time the computer starts, tick <strong>Start DVX when the computer starts (AUTOEXEC.BAT)</strong>. Setup then offers to add DVX to <code>AUTOEXEC.BAT</code> at the end of the install (see <a href="#installing-autoexec">Section 3.7.4</a>). The box starts unticked. It appears only when Setup can tell which drive the computer started from.</p>
</li>
<li>
<p>Click <b class="button">Next &gt;</b>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p><a id="_ix133" class="ixterm"></a>Setup checks the folder when you click <b class="button">Next &gt;</b>:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 55.5555%;">
<col style="width: 44.4445%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Message</th>
<th class="tableblock halign-left valign-top">What to do</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix134" class="ixterm"></a>&#8220;Type the folder to install DVX in.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The box is empty. Type a folder.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix135" class="ixterm"></a>&#8220;Type the whole path of the folder, starting with the drive, for example C:\DVX.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Type the drive and the folder, such as <code>C:\DVX</code>, not just a folder name.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix136" class="ixterm"></a>&#8220;Setup is reading DVX from <em>folder</em>. Choose a folder that is not this one and not inside it.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">You chose the folder Setup is running from, or a folder inside it. Choose a folder on your hard disk.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix137" class="ixterm"></a>&#8220;DVX is already installed in <em>folder</em>. Upgrade or repair it instead, keeping your settings and saved files?&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The folder already holds DVX. Click <b class="button">Yes</b> to upgrade it instead (see <a href="#installing-upgrade">Section 3.8</a>); the next page&#8217;s button then reads <b class="button">Upgrade</b>. Click <b class="button">No</b> to stay on this page and choose another folder.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix138" class="ixterm"></a>&#8220;Setup could not create the folder <em>folder</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">This appears when installing starts. Check the drive and the folder name, or choose another folder.</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect3">
<h4 id="installing-what"><a class="anchor" href="#installing-what"></a>3.3.5. Choosing what to install</h4>
<div class="paragraph">
<p><a id="_ix139" class="ixterm"></a>The next page lists everything you can choose. It has three groups, each explained in a section of its own:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><strong>Fonts to install</strong>: none, or the base set (see <a href="#installing-fonts">Section 3.4</a>).</p>
</li>
<li>
<p><strong>Parts of DVX to install</strong>: the seven optional parts (see <a href="#installing-parts">Section 3.5</a>).</p>
</li>
<li>
<p><strong>Add-ons to install</strong>: the add-ons on the CD (see <a href="#installing-addons-cd">Section 3.6</a>). This group appears only when you install from the CD.</p>
</li>
</ul>
</div>
<div class="imageblock">
<div class="content">
<img src="images/instWhat.png" alt="The DVX Setup window with the Fonts to install choices" width="the seven parts all ticked" height="the two add-ons unticked">
</div>
<div class="title">Figure 5. Choosing the fonts, parts, and add-ons</div>
</div>
<div class="paragraph">
<p>On a new install the page starts with the base set of fonts, every part ticked, and no add-ons.</p>
</div>
<div class="paragraph">
<p><a id="_ix140" class="ixterm"></a>Under the choices, the line &#8220;DVX needs about <em>n</em> MB of disk space.&#8221; changes as you tick and untick them.</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Choose the fonts, parts, and add-ons you want.</p>
</li>
<li>
<p>Click <b class="button">Install</b>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p><b class="button">&lt; Back</b> returns to the folder page.</p>
</div>
<div class="paragraph">
<p><a id="_ix141" class="ixterm"></a>Before it unpacks anything, Setup checks that the disk has room. If not, it says &#8220;There is not enough free space for DVX on that disk. DVX needs about <em>n</em> bytes; <em>n</em> bytes are free.&#8221; Free some space on the disk, or click <b class="button">&lt; Back</b> and choose a folder on another disk.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="installing-fonts"><a class="anchor" href="#installing-fonts"></a>3.4. Choosing the fonts</h3>
<div class="paragraph">
<p><a id="_ix142" class="ixterm"></a><a id="_ix143" class="ixterm"></a>Under <strong>Fonts to install</strong>, choose one of:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>None: DVX&#8217;s own font only</strong></dt>
<dd>
<p>DVX uses its own built-in font for all text. This saves about 8 MB of disk space.</p>
</dd>
<dt class="hdlist1"><strong>Base set: DejaVu Sans, Sans Mono, and Serif (8 MB)</strong></dt>
<dd>
<p><a id="_ix144" class="ixterm"></a>Adds 12 font files: DejaVu Sans, DejaVu Sans Mono, and DejaVu Serif, each in regular, bold, italic, and bold italic, in sizes for the screen and for printing. A new install starts with this choice.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p><a id="_ix145" class="ixterm"></a>Without the base set, a program that asks for a font you did not install shows its text in DVX&#8217;s own font instead, unless it carries that font itself. Some programs do, such as Welcome and the DVX Demo.</p>
</div>
<div class="paragraph">
<p>With the floppy disks, choosing <strong>None</strong> also means Setup does not ask for the last disks, which hold only the fonts.</p>
</div>
<div class="paragraph">
<p><a id="_ix146" class="ixterm"></a>You can add the base set later. Software lists it as &#8220;DVX Fonts&#8221; and can install it from the package server; or run Setup again, choose <b class="button">Upgrade or repair DVX</b>, and choose <strong>Base set</strong> (see <a href="#installing-upgrade">Section 3.8</a>). Software also offers updates to the base set as they are published.</p>
</div>
<div class="paragraph">
<p><a id="_ix147" class="ixterm"></a>Every font file holds its own licence; the <b class="button">Licence&#8230;&#8203;</b> button of the Font dialog shows it. For many more typefaces, install the More Fonts add-on from the CD (see <a href="#installing-addons-cd">Section 3.6</a>).</p>
</div>
</div>
<div class="sect2">
<h3 id="installing-parts"><a class="anchor" href="#installing-parts"></a>3.5. Choosing the parts</h3>
<div class="paragraph">
<p><a id="_ix148" class="ixterm"></a><a id="_ix149" class="ixterm"></a>Under <strong>Parts of DVX to install</strong> there is a check box for each of DVX&#8217;s seven optional parts. On a new install they all start ticked. Untick a part to leave it out. Rest the mouse pointer on a box to see what the part holds.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 25%;">
<col style="width: 62.5%;">
<col style="width: 12.5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Box</th>
<th class="tableblock halign-left valign-top">What it holds (as Setup shows it)</th>
<th class="tableblock halign-left valign-top">About</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>DVX BASIC</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Write your own programs: the BASIC editor, compiler, and debugger, with its guides.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2.7 MB</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Databases</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;SQLite databases for BASIC programs, with the Data control and the DBGrid that show them.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">0.7 MB</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Networking</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Network cards (with their DOS packet driver), the web, and the package server.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">0.3 MB</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Communications</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The Terminal: modems, serial and secure links, Telnet (with Networking), and file transfers.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">0.4 MB</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Media</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The Media Player and the Sound Recorder.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">0.1 MB</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Developer Tools</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The Icon, Resource, and Help Editors, Package Builder, and Widget Showcase, with DVXRES and DVXHLPC for the DOS prompt.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">0.9 MB</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Demos</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The DVX Demo and the BASIC Demo.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">0.2 MB</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix150" class="ixterm"></a>A part you leave out takes no disk space and leaves more memory for your programs. The desktop and the everyday programs (see <a href="#about-programs">Section 1.2</a>) are always installed.</p>
</div>
<div class="paragraph">
<p><a id="_ix151" class="ixterm"></a>No part needs another. You can install Communications without Networking, for example: the Terminal then works with modems and serial links, and only its Telnet and its secure link over a network need Networking.</p>
</div>
<div class="paragraph">
<p><a id="_ix152" class="ixterm"></a><a id="_ix153" class="ixterm"></a>To add or remove parts later, run Setup again and choose <b class="button">Upgrade or repair DVX</b> (see <a href="#installing-upgrade">Section 3.8</a>). Software lists each part you installed as one package; its details name what the part holds, and Software can remove it (see <a href="#addons-parts">Section 10.9</a>).</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/instSoftware.png" alt="The Software window&#8217;s Installed page listing DVX" width="DVX Fonts" height="More Fonts">
</div>
<div class="title">Figure 6. Software lists each installed part, the base fonts, and an add-on as packages</div>
</div>
</div>
<div class="sect2">
<h3 id="installing-addons-cd"><a class="anchor" href="#installing-addons-cd"></a>3.6. The add-ons on the CD</h3>
<div class="paragraph">
<p><a id="_ix154" class="ixterm"></a><a id="_ix155" class="ixterm"></a>When you install from the CD, Setup also offers the add-ons in the CD&#8217;s <code>ADDONS</code> folder, under <strong>Add-ons to install</strong>. Each has a check box with its size. On a new install they start unticked: tick the ones you want.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 27.2727%;">
<col style="width: 54.5454%;">
<col style="width: 18.1819%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Add-on</th>
<th class="tableblock halign-left valign-top">What it holds (as Setup shows it)</th>
<th class="tableblock halign-left valign-top">File</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix156" class="ixterm"></a><a id="_ix157" class="ixterm"></a><strong>DVX General MIDI (4 MB)</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;General MIDI instruments for MIDI music on wavetable sound cards (Gravis UltraSound, Sound Blaster AWE32 and AWE64).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>DVXGM.DPK</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix158" class="ixterm"></a><a id="_ix159" class="ixterm"></a><strong>More Fonts (8 MB)</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;More typefaces for documents, programs, and games: condensed DejaVu, Arimo, Tinos, Cousine, display faces, and pixel fonts.&#8221; That is more than forty more typefaces.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>MOREFONT.DPK</code></p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>DVX uses the DVX General MIDI instruments for MIDI music on a Gravis UltraSound or a Sound Blaster AWE32 or AWE64. Without them, those cards use their own instruments when they have them (see <a href="#cpanel-sounds">Section 7.12</a>).</p>
</div>
<div class="paragraph">
<p><a id="_ix160" class="ixterm"></a>Setup offers only add-ons that are signed: each comes with a signature file (<code>.SIG</code>) beside it. An add-on that is not signed, or cannot be read, is not offered.</p>
</div>
<div class="paragraph">
<p>An add-on already in the folder shows &#8220;(installed)&#8221; instead of its size.</p>
</div>
<div class="paragraph">
<p><a id="_ix161" class="ixterm"></a>Setup installs the add-ons you tick after it has unpacked DVX, showing &#8220;Installing More Fonts&#8221; and so on. If one cannot be installed, Setup says &#8220;<em>name</em> could not be installed: <em>reason</em>&#8221; and goes on with the others.</p>
</div>
<div class="paragraph">
<p><a id="_ix162" class="ixterm"></a>Once installed, the add-ons are packages like any other: the Software program lists them and can remove them. To add one later:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Put the DVX CD in the drive.</p>
</li>
<li>
<p>Start Software from the Program Manager.</p>
</li>
<li>
<p>Choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Install from File&#8230;&#8203;</b></span>.</p>
</li>
<li>
<p>Go to the <code>ADDONS</code> folder of the CD and open <code>MOREFONT.DPK</code> or <code>DVXGM.DPK</code>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>See <a href="#addons-installing">Section 10.3</a> for the rest of the steps. With the Networking part, Software can also install both add-ons from the package server.</p>
</div>
</div>
<div class="sect2">
<h3 id="installing-finish"><a class="anchor" href="#installing-finish"></a>3.7. Installing and finishing</h3>
<div class="sect3">
<h4 id="installing-progress"><a class="anchor" href="#installing-progress"></a>3.7.1. While Setup installs</h4>
<div class="paragraph">
<p><a id="_ix163" class="ixterm"></a>After you click <b class="button">Install</b>, Setup says &#8220;Setup is installing DVX. This can take a few minutes.&#8221; Under it are the name of the file being unpacked (with the floppy disks, &#8220;Disk <em>n</em>: <em>file</em>&#8221;), a progress bar, and a panel that shows a different feature of DVX every few seconds: &#8220;Windows, your way&#8221;, &#8220;Build your own programs&#8221;, &#8220;Games, sound, and music&#8221;, &#8220;Help on every screen&#8221;, and &#8220;Files and the world&#8221;.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/instCopy.png" alt="The DVX Setup window showing Setup is installing DVX" width="a progress bar" height="and the Windows">
</div>
<div class="title">Figure 7. Setup unpacking DVX</div>
</div>
<div class="paragraph">
<p>When DVX itself is unpacked, Setup installs the add-ons you ticked. Setup checks every file as it unpacks it; if a file on the CD or a floppy disk is damaged, Setup stops and says so.</p>
</div>
<div class="paragraph">
<p><a id="_ix164" class="ixterm"></a><a id="_ix165" class="ixterm"></a>To stop, click <b class="button">Cancel</b>. While Setup is unpacking DVX, it then returns to the <strong>What to install</strong> page and says what happened:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>On a new install, Setup removes everything it wrote: &#8220;Setup was cancelled. Nothing was installed in <em>folder</em>.&#8221;</p>
</li>
<li>
<p>On an upgrade, DVX is left half-updated: &#8220;Setup was cancelled. DVX in <em>folder</em> is incomplete now; run Setup again to repair it.&#8221;</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>If you click <b class="button">Cancel</b> while the add-ons are being installed, DVX itself is already in place. Setup says &#8220;Setup was cancelled: <em>name</em> and the add-ons after it are not as you chose. Software (in Program Manager) can install and remove them.&#8221; and goes on to finish the install and show the last page.</p>
</div>
</div>
<div class="sect3">
<h4 id="installing-floppies"><a class="anchor" href="#installing-floppies"></a>3.7.2. Changing floppy disks</h4>
<div class="paragraph">
<p><a id="_ix166" class="ixterm"></a><a id="_ix167" class="ixterm"></a>With the floppy disks, Setup asks for each disk it needs:</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/instDisk.png" alt="A DVX Setup message box saying Please insert Disk 6 of 6 in drive A: and choose OK" width="with OK and Cancel buttons">
</div>
<div class="title">Figure 8. Setup asking for the next floppy disk</div>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 55.5555%;">
<col style="width: 44.4445%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Message</th>
<th class="tableblock halign-left valign-top">What to do</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Please insert Disk <em>n</em> of <em>total</em> in drive A: and choose OK.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Take out the disk in drive A:, put in the disk it asks for, and click <b class="button">OK</b>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix168" class="ixterm"></a>&#8220;The disk in drive A: belongs to a different set of DVX disks. Please insert Disk <em>n</em> of <em>total</em> of this set and choose OK.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The disk is from another copy or version of DVX. Use the disks from one set only.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix169" class="ixterm"></a>&#8220;This is not Disk <em>n</em>. Please insert Disk <em>n</em> of <em>total</em> in drive A: and choose OK.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the number on the disk and put in the right one.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix170" class="ixterm"></a>&#8220;The disk in drive A: cannot be read. Please insert Disk <em>n</em> of <em>total</em> and choose OK.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Make sure the disk is pushed fully in, then click <b class="button">OK</b>. If it still cannot be read, the disk may be damaged.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>Clicking <b class="button">Cancel</b> in any of these stops the install, as described above.</p>
</div>
</div>
<div class="sect3">
<h4 id="installing-settings"><a class="anchor" href="#installing-settings"></a>3.7.3. DVX&#8217;s settings file</h4>
<div class="paragraph">
<p><a id="_ix171" class="ixterm"></a><a id="_ix172" class="ixterm"></a>When the files are unpacked on a new install, or on an upgrade with <strong>Start over</strong> ticked, Setup writes DVX&#8217;s settings file, <code>DVX.INI</code>, into the <code>USER</code> folder. It sets DVX&#8217;s screen mode to the mode Setup itself is running in, normally 640x480, because that mode is known to work on your computer. You can choose a higher resolution later in the Control Panel (see <a href="#cpanel-video">Section 7.7</a>).</p>
</div>
<div class="paragraph">
<p><a id="_ix173" class="ixterm"></a>If the file cannot be written, Setup says &#8220;DVX was installed, but the settings file in <em>folder</em> could not be written.&#8221;</p>
</div>
</div>
<div class="sect3">
<h4 id="installing-autoexec"><a class="anchor" href="#installing-autoexec"></a>3.7.4. Starting DVX when the computer starts</h4>
<div class="paragraph">
<p><a id="_ix174" class="ixterm"></a><a id="_ix175" class="ixterm"></a>If you ticked <strong>Start DVX when the computer starts (AUTOEXEC.BAT)</strong> on the folder page, and <code>AUTOEXEC.BAT</code> does not start DVX already, Setup says &#8220;Setup will add this line to the end of C:\AUTOEXEC.BAT, so DVX starts when the computer starts:&#8221;, shows the line, for example <code>C:\DVX\DVX.EXE</code> (with your folder), and asks &#8220;The file as it is now is saved as C:\AUTOEXEC.DVX first. Add the line?&#8221; When there is no <code>AUTOEXEC.BAT</code> yet, Setup says instead &#8220;There is no C:\AUTOEXEC.BAT yet. Setup will make one with this line, so DVX starts when the computer starts:&#8221;, shows the line, and asks &#8220;Add the line?&#8221;</p>
</div>
<div class="ulist">
<ul>
<li>
<p><a id="_ix176" class="ixterm"></a>Click <b class="button">Yes</b> to add it. Setup first saves the file as it was, as <code>AUTOEXEC.DVX</code> beside it, and then adds the line at the end. If there is no <code>AUTOEXEC.BAT</code> yet, Setup makes one, with nothing to save first.</p>
</li>
<li>
<p>Click <b class="button">No</b> to leave <code>AUTOEXEC.BAT</code> as it is.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>The line names DVX by its short DOS name, which DOS needs, so a folder with a long name appears in its short form.</p>
</div>
<div class="admonitionblock important">
<table>
<tr>
<td class="icon">
<div class="title">Important</div>
</td>
<td class="content">
The drivers DVX uses (the mouse driver, a VESA driver, a network packet driver) must be loaded by lines above the line that starts DVX. Setup adds its line at the end, after the lines already there. If you add a driver to <code>AUTOEXEC.BAT</code> later, put it above the DVX line.
</td>
</tr>
</table>
</div>
<div class="paragraph">
<p><a id="_ix177" class="ixterm"></a>To stop DVX starting with the computer, delete the line from <code>AUTOEXEC.BAT</code> with a text editor (for example, type <code>EDIT C:\AUTOEXEC.BAT</code> at the DOS prompt), or let Setup remove it when you remove DVX.</p>
</div>
</div>
<div class="sect3">
<h4 id="installing-done"><a class="anchor" href="#installing-done"></a>3.7.5. The last page</h4>
<div class="paragraph">
<p><a id="_ix178" class="ixterm"></a>When everything is done, Setup shows &#8220;DVX is ready!&#8221; and &#8220;Your new desktop is waiting.&#8221;, the folder DVX is in (&#8220;DVX is installed in C:\DVX.&#8221;), and how to start it (&#8220;To start it from the DOS prompt, type C:\DVX\DVX.EXE&#8221;).</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/instDone.png" alt="The DVX Setup window saying DVX is ready" width="DVX is installed in C:\DVX" height="with the Start DVX now check box ticked and the Finish button">
</div>
<div class="title">Figure 9. The last page of Setup</div>
</div>
<div class="ulist">
<ul>
<li>
<p>With <strong>Start DVX now</strong> ticked (as it starts), click <b class="button">Finish</b>: Setup closes and starts DVX. When you later exit DVX, you are back at the DOS prompt.</p>
</li>
<li>
<p>Untick <strong>Start DVX now</strong> and click <b class="button">Finish</b> to return to the DOS prompt without starting DVX.</p>
</li>
</ul>
</div>
<div class="admonitionblock tip">
<table>
<tr>
<td class="icon">
<div class="title">Tip</div>
</td>
<td class="content">
When Setup starts DVX for you, Setup stays in memory until you exit DVX. To give DVX all of the computer&#8217;s memory, untick <strong>Start DVX now</strong> and start DVX from the DOS prompt instead (see <a href="#installing-starting">Section 3.12</a>).
</td>
</tr>
</table>
</div>
<div class="paragraph">
<p>What you see the first time DVX starts is described in <a href="#installing-first-start">Section 3.14</a>.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="installing-upgrade"><a class="anchor" href="#installing-upgrade"></a>3.8. Upgrading or repairing DVX</h3>
<div class="paragraph">
<p><a id="_ix179" class="ixterm"></a><a id="_ix180" class="ixterm"></a><a id="_ix181" class="ixterm"></a>Run Setup again and choose <b class="button">Upgrade or repair DVX</b> to:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>install a new version of DVX over the old one,</p>
</li>
<li>
<p>put back DVX files that are missing or damaged,</p>
</li>
<li>
<p>add or remove the base set of fonts, parts of DVX, or add-ons from the CD, or</p>
</li>
<li>
<p>start over with fresh settings.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>To upgrade or repair DVX:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Start Setup from the CD or from Disk 1 of the DVX you want to install (see <a href="#installing-setup-start">Section 3.3.1</a>). The copy of Setup in the DVX folder can only remove DVX.</p>
</li>
<li>
<p>Tick <strong>I accept the licence</strong> and click <b class="button">Next &gt;</b>.</p>
</li>
<li>
<p>Choose <b class="button">Upgrade or repair DVX</b>. When DVX is in the folder Setup suggests, Setup says so and gives this choice the focus.</p>
<div class="imageblock">
<div class="content">
<img src="images/instUpgradeStart.png" alt="The DVX Setup start page saying DVX is already installed in C:\DVX" width="with Upgrade or repair DVX highlighted">
</div>
<div class="title">Figure 10. Setup has found DVX in C:\DVX</div>
</div>
</li>
<li>
<p>On the folder page, check that the box <strong>Upgrade or repair DVX in this folder</strong> holds the folder DVX is in. Tick <strong>Start over: also remove my settings and saved files</strong> only if you want to throw away your settings and saved files (see below). Tick <strong>Start DVX when the computer starts (AUTOEXEC.BAT)</strong> if you want that. Click <b class="button">Next &gt;</b>.</p>
<div class="imageblock">
<div class="content">
<img src="images/instUpgradeFolder.png" alt="The DVX Setup folder page for an upgrade" width="with the Start over and Start DVX when the computer starts check boxes">
</div>
<div class="title">Figure 11. Upgrading DVX in C:\DVX</div>
</div>
</li>
<li>
<p>The <strong>What to install</strong> page starts with the fonts, parts, and add-ons the folder already has, and the parts group is headed <strong>Parts of DVX to have (an unticked one is removed)</strong>. Tick what you want to add and untick what you want to remove. Choose <strong>None</strong> under <strong>Fonts to install</strong> to remove the base set of fonts. An add-on the folder has shows &#8220;(installed)&#8221;; untick it to remove it.</p>
<div class="imageblock">
<div class="content">
<img src="images/instUpgradeWhat.png" alt="The DVX Setup What to install page for an upgrade" width="with the parts heading Parts of DVX to have" height="an unticked one is removed">
</div>
<div class="title">Figure 12. Choosing what to keep, add, and remove</div>
</div>
</li>
<li>
<p>Click <b class="button">Upgrade</b>. Setup unpacks DVX, removes what you left out, installs or removes add-ons, and shows the last page (see <a href="#installing-done">Section 3.7.5</a>).</p>
</li>
</ol>
</div>
<div class="paragraph">
<p><a id="_ix182" class="ixterm"></a>Setup writes every DVX file again, so an upgrade also repairs DVX. Files that the new DVX no longer has, and the fonts and parts you left out, are removed. When Setup checks the free space, it counts only what the folder does not have already.</p>
</div>
<div class="paragraph">
<p><a id="_ix183" class="ixterm"></a><a id="_ix184" class="ixterm"></a>Your settings and saved files, in the <code>USER</code> folder, are kept: an upgrade does not touch them. Because your settings are kept, the Welcome window does not appear again after an upgrade.</p>
</div>
<div class="paragraph">
<p><a id="_ix185" class="ixterm"></a>With <strong>Start over</strong> ticked, Setup removes the old <code>USER</code> folder after unpacking (only if it holds a <code>DVX.INI</code> file) and writes fresh settings, as on a new install. DVX then starts as it did the first time, with the Welcome window.</p>
</div>
<div class="admonitionblock warning">
<table>
<tr>
<td class="icon">
<div class="title">Warning</div>
</td>
<td class="content">
<strong>Start over</strong> deletes everything in the <code>USER</code> folder: your settings, your Program Manager groups, and the files programs saved there. Copy the folder somewhere safe first if you want to keep anything from it.
</td>
</tr>
</table>
</div>
<div class="paragraph">
<p><a id="_ix186" class="ixterm"></a>Messages you may see:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 55.5555%;">
<col style="width: 44.4445%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Message</th>
<th class="tableblock halign-left valign-top">Meaning</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix187" class="ixterm"></a>&#8220;DVX is not installed in <em>folder</em>. To put DVX there, choose Back, then Install DVX.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">There is no DVX in that folder. Choose the folder DVX is in, or go back and choose <b class="button">Install DVX</b>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix188" class="ixterm"></a>&#8220;Other software in <em>folder</em> needs these parts, so Setup keeps them: <em>parts</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">You unticked a part that other installed software needs, so Setup keeps it.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix189" class="ixterm"></a>&#8220;These files in <em>folder</em> changed since they were installed, so Setup left them:&#8221;, the files, and &#8220;Delete them too?&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A part or add-on you unticked, or an add-on Setup upgraded, had files that changed after they were installed, such as data you edited. Setup does not delete them unless you click <b class="button">Yes</b>. <b class="button">No</b> leaves them where they are.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix190" class="ixterm"></a>&#8220;These files in <em>folder</em> could not be deleted, so Setup left them:&#8221;, the files, and &#8220;A program may be using them, or the disk may be write-protected.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Some files of a part or add-on Setup removed could not be deleted. Delete them yourself with File Manager.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix191" class="ixterm"></a>&#8220;Your old settings and saved files in <em>folder</em> could not all be removed.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">With <strong>Start over</strong> ticked, some files in the <code>USER</code> folder could not be deleted. Delete them yourself.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix192" class="ixterm"></a><a id="_ix193" class="ixterm"></a>With the Networking part you can also bring DVX up to date without Setup: the <strong>Updates</strong> page of the Software program lists newer versions published on the package server, and <b class="button">Update All</b> installs them. The new DVX runs from the next time you start DVX (see <a href="#addons-updates">Section 10.5</a>).</p>
</div>
</div>
<div class="sect2">
<h3 id="installing-remove"><a class="anchor" href="#installing-remove"></a>3.9. Removing DVX</h3>
<div class="paragraph">
<p><a id="_ix194" class="ixterm"></a><a id="_ix195" class="ixterm"></a><a id="_ix196" class="ixterm"></a>Setup removes DVX as well. You can run it from the DVX CD or Disk 1, or use the copy of Setup that is in the DVX folder.</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Start Setup in one of these ways:</p>
<div class="ulist">
<ul>
<li>
<p>From the CD or Disk 1 (see <a href="#installing-setup-start">Section 3.3.1</a>). Tick <strong>I accept the licence</strong>, click <b class="button">Next &gt;</b>, and choose <b class="button">Remove DVX</b>.</p>
</li>
<li>
<p>From the DVX folder: type <code>C:\DVX\SETUP</code> at the DOS prompt. This copy of Setup opens straight at the remove page, for its own folder only (see below).</p>
</li>
</ul>
</div>
</li>
<li>
<p>On the remove page, check that the box <strong>Remove DVX from this folder</strong> holds the folder DVX is in.</p>
</li>
<li>
<p>To delete your settings and saved files too, tick <strong>Also remove my settings and saved files (the USER folder)</strong>. Leave it unticked to keep them.</p>
</li>
<li>
<p>Click <b class="button">Remove</b>.</p>
</li>
<li>
<p>If <code>AUTOEXEC.BAT</code> starts DVX, Setup says &#8220;C:\AUTOEXEC.BAT starts DVX with the line&#8221;, shows the line, for example <code>C:\DVX\DVX.EXE</code>, and asks &#8220;Remove that line? (The file as it is now is saved as AUTOEXEC.DVX first.)&#8221; Click <b class="button">Yes</b> to remove the line, or <b class="button">No</b> to leave it.</p>
</li>
<li>
<p>Setup removes DVX and says &#8220;DVX was removed from <em>folder</em>.&#8221; Click <b class="button">OK</b>; Setup ends.</p>
</li>
</ol>
</div>
<div class="imageblock">
<div class="content">
<img src="images/instRemove.png" alt="The DVX Setup remove page with the folder C:\DVX" width="the Also remove my settings and saved files check box" height="and the Remove button">
</div>
<div class="title">Figure 13. Removing DVX</div>
</div>
<div class="admonitionblock warning">
<table>
<tr>
<td class="icon">
<div class="title">Warning</div>
</td>
<td class="content">
Setup does not ask whether you are sure: clicking <b class="button">Remove</b> removes DVX at once. If you ticked the <code>USER</code> folder box, your settings and every file saved in the <code>USER</code> folder are deleted too. Copy anything you want to keep first.
</td>
</tr>
</table>
</div>
<div class="paragraph">
<p><a id="_ix197" class="ixterm"></a>Setup removes, in this order:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>the files of add-on packages that the Software program installed,</p>
</li>
<li>
<p>every file Setup put in the folder,</p>
</li>
<li>
<p>the <code>USER</code> folder, only if you ticked the box,</p>
</li>
<li>
<p>the folders left empty, including the DVX folder itself.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>&#8220;Files you added to the folder yourself are not removed.&#8221; Those files, and the folders that hold them, stay.</p>
</div>
<div class="paragraph">
<p><a id="_ix198" class="ixterm"></a>If you keep the <code>USER</code> folder somewhere else with the <code>DVXUSER</code> setting (see <a href="#installing-files">Section 3.11</a>), Setup removes that folder only if you tick the box and it holds a <code>DVX.INI</code> file.</p>
</div>
<div class="paragraph">
<p><a id="_ix199" class="ixterm"></a>Messages you may see:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 55.5555%;">
<col style="width: 44.4445%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Message</th>
<th class="tableblock halign-left valign-top">What to do</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix200" class="ixterm"></a>&#8220;DVX is not installed in <em>folder</em> (or it was not installed by this Setup).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Setup found no record of an install there. Check the folder name. Setup can only remove a DVX that Setup installed, because it removes the files on its list.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix201" class="ixterm"></a>&#8220;<em>n</em> file(s) in <em>folder</em> could not be removed. Close any program using them and choose Remove DVX again.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Close any program that uses files in the folder, then run Setup again and choose <b class="button">Remove DVX</b>.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix202" class="ixterm"></a>The copy of Setup in the DVX folder has no DVX inside it, so it can only remove DVX, and only from its own folder. It opens at the remove page with the folder filled in and fixed (no <b class="button">Browse&#8230;&#8203;</b> or <b class="button">&lt; Back</b>), and the note &#8220;To install or upgrade DVX, run SETUP from its CD or Disk 1.&#8221;</p>
</div>
<div class="paragraph">
<p><a id="_ix203" class="ixterm"></a>If this copy of Setup is run from a folder where DVX is not installed, it prints &#8220;DVX Setup: there is no DVX package (or it is damaged) beside <em>path</em>, and DVX is not installed in its folder.&#8221; and stops.</p>
</div>
</div>
<div class="sect2">
<h3 id="installing-switches"><a class="anchor" href="#installing-switches"></a>3.10. Setup&#8217;s command-line switches</h3>
<div class="paragraph">
<p><a id="_ix204" class="ixterm"></a><a id="_ix205" class="ixterm"></a>You can give Setup switches after its name at the DOS prompt, for example:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>SETUP /AUTO=C:\DVX /PARTS=BASIC,COMM /LOG=C:\SETUP.LOG</pre>
</div>
</div>
<div class="paragraph">
<p>Upper and lower case are the same in the names after the switches.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 30%;">
<col style="width: 70%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Switch</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>/AUTO=<em>folder</em></code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Installs DVX in that folder without asking any questions (see <a href="#installing-unattended">Section 3.10.1</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>/FONTS=NONE</code> or <code>/FONTS=BASE</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Chooses the fonts: none, or the base set. Without it, Setup keeps the fonts the folder already has, or chooses the base set on a new install.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>/PARTS=ALL</code>, <code>/PARTS=NONE</code>, or <code>/PARTS=<em>names</em></code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Chooses the parts of DVX, by these names, separated by commas: <code>BASIC</code> (DVX BASIC), <code>DATA</code> (Databases), <code>NET</code> (Networking), <code>COMM</code> (Communications), <code>MEDIA</code> (Media), <code>DEVTOOLS</code> (Developer Tools), and <code>DEMOS</code> (Demos). Without it, Setup keeps the parts the folder already has, or chooses them all on a new install.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>/ADDONS=ALL</code>, <code>/ADDONS=NONE</code>, or <code>/ADDONS=<em>names</em></code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Chooses the add-ons by their file names, separated by commas: <code>MOREFONT</code> (More Fonts) and <code>DVXGM</code> (DVX General MIDI). Without it, Setup keeps the add-ons the folder already has (none on a new install).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>/LOG=<em>file</em></code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Writes Setup&#8217;s record of what it did to that file, for example <code>/LOG=C:\SETUP.LOG</code>. Without it, Setup keeps no record on disk.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix206" class="ixterm"></a>Without <code>/AUTO</code>, the switches <code>/FONTS</code>, <code>/PARTS</code>, and <code>/ADDONS</code> set the choices the <strong>What to install</strong> page starts with; you can still change them there.</p>
</div>
<div class="paragraph">
<p><a id="_ix207" class="ixterm"></a>If <code>/FONTS=</code> is followed by anything else, Setup prints &#8220;DVX Setup: /FONTS= takes NONE or BASE.&#8221; and stops.</p>
</div>
<div class="sect3">
<h4 id="installing-unattended"><a class="anchor" href="#installing-unattended"></a>3.10.1. Installing without questions</h4>
<div class="paragraph">
<p><a id="_ix208" class="ixterm"></a><a id="_ix209" class="ixterm"></a>With <code>/AUTO=<em>folder</em></code>, Setup installs DVX in that folder without waiting for you:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>the licence is taken as accepted,</p>
</li>
<li>
<p>a folder that already has DVX is upgraded, and its <code>USER</code> folder is kept,</p>
</li>
<li>
<p><code>AUTOEXEC.BAT</code> is not changed.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>The screen still switches to graphics and shows Setup&#8217;s pages briefly while it works. Setup shows no messages; any problem is written only to the log, so give <code>/LOG</code> as well.</p>
</div>
<div class="paragraph">
<p><a id="_ix210" class="ixterm"></a>When it ends, Setup returns the exit code 0 if DVX was installed and 1 if it was not, which a batch file can test with <code>IF ERRORLEVEL 1</code>:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>D:
SETUP /AUTO=C:\DVX /FONTS=BASE /PARTS=ALL /LOG=C:\SETUP.LOG
IF ERRORLEVEL 1 ECHO DVX was not installed. See C:\SETUP.LOG.</pre>
</div>
</div>
</div>
</div>
<div class="sect2">
<h3 id="installing-files"><a class="anchor" href="#installing-files"></a>3.11. Where DVX puts its files</h3>
<div class="paragraph">
<p><a id="_ix211" class="ixterm"></a><a id="_ix212" class="ixterm"></a>Setup puts DVX in the folder you chose, for example <code>C:\DVX</code>:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 25%;">
<col style="width: 75%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">File or folder</th>
<th class="tableblock halign-left valign-top">What it holds</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>DVX.EXE</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX itself. This is what you run to start DVX.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>SETUP.EXE</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A copy of Setup, which can remove DVX (see <a href="#installing-remove">Section 3.9</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>SETUP.LST</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Setup&#8217;s list of the files it installed. Setup needs it to remove DVX; do not delete it.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>SYSTEM</code>, <code>LIBS</code>, <code>WIDGETS</code>, <code>APPS</code>, <code>SHARED</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX&#8217;s own files: its tools for the DOS prompt, its libraries and controls, its programs, and the fonts, sounds, themes, desktop pictures, instrument banks, and screen savers every program shares. DVX only reads these folders.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>USER</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix213" class="ixterm"></a>Everything that changes while you use DVX: your settings (<code>DVX.INI</code>), the log of the last start (<code>DVX.LOG</code>), your own fonts, sounds, themes, and pictures, each program&#8217;s settings and saved files, and the Terminal&#8217;s downloads.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix214" class="ixterm"></a><a id="_ix215" class="ixterm"></a>To back up your work and settings, copy the <code>USER</code> folder.</p>
</div>
<div class="paragraph">
<p><a id="_ix216" class="ixterm"></a><a id="_ix217" class="ixterm"></a>To keep the <code>USER</code> folder somewhere else (on another disk, or one for each person who uses the computer), set <code>DVXUSER</code> to that folder before starting DVX, for example with this line in <code>AUTOEXEC.BAT</code>:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>SET DVXUSER=D:\MYDVX</pre>
</div>
</div>
<div class="paragraph">
<p>Setup uses <code>DVXUSER</code> too: it writes a new install&#8217;s settings file there.</p>
</div>
<div class="paragraph">
<p>The folders and the settings files are described fully in <a href="#folders-layout">Section B.1</a> and <a href="#folders-dvx-ini">Section B.2</a>.</p>
</div>
<div class="sect3">
<h4 id="installing-read-only"><a class="anchor" href="#installing-read-only"></a>3.11.1. Running DVX from a CD-ROM or a write-protected disk</h4>
<div class="paragraph">
<p><a id="_ix218" class="ixterm"></a><a id="_ix219" class="ixterm"></a>A copy of an installed DVX folder can also be run from a disk DVX cannot write to, such as a CD-ROM you made or a write-protected disk. DVX then cannot save into its <code>USER</code> folder:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><a id="_ix220" class="ixterm"></a><a id="_ix221" class="ixterm"></a>If there is a <code>TEMP</code> folder (set by the <code>TEMP</code> or <code>TMP</code> setting in <code>AUTOEXEC.BAT</code>), DVX keeps your settings and files in a folder named <code>DVXUSER</code> inside it, and says once: &#8220;DVX is running from a disk it cannot write to, such as a CD-ROM, so your settings are kept in the TEMP folder. To keep them somewhere else, set DVXUSER to a folder on your hard disk before starting DVX.&#8221; The first time, the settings there start as a copy of the <code>DVX.INI</code> in the <code>USER</code> folder on that disk.</p>
</li>
<li>
<p><a id="_ix222" class="ixterm"></a><a id="_ix223" class="ixterm"></a>If there is no <code>TEMP</code> folder, DVX says: &#8220;DVX cannot save anything: it is running from a disk it cannot write to, such as a CD-ROM, and there is no TEMP folder. Settings you change are kept until you exit DVX. To keep them, set DVXUSER to a folder on your hard disk before starting DVX, or install DVX with SETUP.&#8221; The first time you save a change after that, DVX reminds you: &#8220;Your changes cannot be saved to disk, so they last only until you exit DVX. To keep them, set DVXUSER to a folder DVX can write to before starting DVX.&#8221;</p>
</li>
</ul>
</div>
<div class="paragraph">
<p><a id="_ix224" class="ixterm"></a><a id="_ix225" class="ixterm"></a>The same happens when you set <code>DVXUSER</code> (see <a href="#installing-files">Section 3.11</a>) to a folder DVX cannot write to; the messages then name that folder: &#8220;DVX cannot write to <em>folder</em>, the folder DVXUSER names, so your settings are kept in the TEMP folder. To keep them somewhere else, set DVXUSER to a folder DVX can write to before starting DVX.&#8221;, or, with no <code>TEMP</code> folder, &#8220;DVX cannot save anything: it cannot write to <em>folder</em>, the folder DVXUSER names, and there is no TEMP folder. Settings you change are kept until you exit DVX. To keep them, set DVXUSER to a folder DVX can write to before starting DVX.&#8221;</p>
</div>
<div class="paragraph">
<p>To keep everything on your hard disk, install DVX there with Setup.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="installing-starting"><a class="anchor" href="#installing-starting"></a>3.12. Starting DVX</h3>
<div class="paragraph">
<p><a id="_ix226" class="ixterm"></a><a id="_ix227" class="ixterm"></a>To start DVX:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Make sure the drivers DVX uses are loaded: the mouse driver, and the VESA driver and network packet driver if you use them.</p>
</li>
<li>
<p>At the DOS prompt, change to the DVX folder and type <code>DVX</code>:</p>
<div class="listingblock">
<div class="content">
<pre>C:
CD \DVX
DVX</pre>
</div>
</div>
<div class="paragraph">
<p>You can also start DVX from any folder by typing its whole path, for example <code>C:\DVX\DVX</code>.</p>
</div>
</li>
</ol>
</div>
<div class="paragraph">
<p>If you ticked <strong>Start DVX when the computer starts (AUTOEXEC.BAT)</strong> in Setup and clicked <b class="button">Yes</b> when Setup offered to add its line, DVX starts by itself each time the computer starts.</p>
</div>
<div class="sect3">
<h4 id="installing-switches-dvx"><a class="anchor" href="#installing-switches-dvx"></a>3.12.1. DVX&#8217;s command-line switches</h4>
<div class="paragraph">
<p><a id="_ix228" class="ixterm"></a><a id="_ix229" class="ixterm"></a>You can add these switches after <code>DVX</code>. Upper and lower case are the same. Put <code>/SAFE</code> before <code>/RUN=</code>: everything after <code>/RUN=</code> belongs to the program it names.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Switch</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix230" class="ixterm"></a><code>DVX /SAFE</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A safe start: DVX starts in safe video mode and without the libraries and controls that add-ons installed (see <a href="#installing-safe-start">Section 3.13</a>). Holding down a <kbd>Shift</kbd> key while DVX starts does the same.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix231" class="ixterm"></a><code>DVX /RUN=<em>program</em> <em>arguments</em></code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Starts that program once the desktop is up. For example, <code>DVX /RUN=APPS\KPUNCH\NOTEPAD\NOTEPAD.APP</code> starts Notepad. A path like this one, without a drive, is found from the DVX folder. Anything you type after the program, separated by a space, is given to it, for example a document for it to open: <code>DVX /RUN=APPS\KPUNCH\NOTEPAD\NOTEPAD.APP C:\LETTERS\TODO.TXT</code>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>DVX /RUN=<em>document</em></code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens that document in the program set up for its kind of file once the desktop is up. For example, <code>DVX /RUN=C:\LETTERS\TODO.TXT</code> opens the file in Notepad. The kinds of file are set on the <strong>File Types</strong> page of the Control Panel (see <a href="#cpanel-file-types">Section 7.8</a>).</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix232" class="ixterm"></a><a id="_ix233" class="ixterm"></a><a id="_ix234" class="ixterm"></a>If the program or document cannot be found, DVX says &#8220;Cannot find <em>file</em>.&#8221; If no program is set up for a document&#8217;s kind of file, it says &#8220;No program is set up to open <em>file</em>. Choose one on the File Types page of the Control Panel.&#8221; If a program&#8217;s file is there but cannot be started, for example because it is damaged, DVX says &#8220;Failed to load <em>file</em>:&#8221; followed by the reason.</p>
</div>
</div>
<div class="sect3">
<h4 id="installing-startup-screen"><a class="anchor" href="#installing-startup-screen"></a>3.12.2. What you see while DVX starts</h4>
<div class="paragraph">
<p><a id="_ix235" class="ixterm"></a>While DVX loads, you see a title screen with a bar that fills from left to right. Sometimes the bar fills a second time. That happens after programs or parts of DVX were added or removed, while DVX brings its help files up to date. It only takes a moment.</p>
</div>
<div class="paragraph">
<p><a id="_ix236" class="ixterm"></a>The screen then changes to the DVX desktop, and these appear in turn:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>the <strong>Safe Video Mode</strong> question, if DVX started in safe video mode (see <a href="#installing-safe-start">Section 3.13</a>),</p>
</li>
<li>
<p>the <strong>Program Manager</strong> window,</p>
</li>
<li>
<p>the start-up sound,</p>
</li>
<li>
<p>a message if DVX is running from a disk it cannot write to (see <a href="#installing-read-only">Section 3.11.1</a>),</p>
</li>
<li>
<p>an <strong>Add-ons</strong> message if an add-on could not be loaded (see below),</p>
</li>
<li>
<p>the <strong>Welcome</strong> window, the first time DVX starts (see <a href="#installing-first-start">Section 3.14</a>),</p>
</li>
<li>
<p>the program or document named with <code>/RUN=</code>, if any.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>The programs in the Program Manager&#8217;s <strong>Startup</strong> group also start once the desktop is up (see <a href="#progman-groups">Section 6.3</a>).</p>
</div>
<div class="paragraph">
<p><a id="_ix237" class="ixterm"></a><a id="_ix238" class="ixterm"></a>If an add-on&#8217;s library or control cannot be loaded (for example, it was made for another version of DVX, or it needs something that is not installed), DVX starts without it. A message titled <strong>Add-ons</strong> then lists each one as &#8220;<em>file</em> was not loaded: <em>reason</em>.&#8221; and ends &#8220;The Software program can reinstall or remove an add-on.&#8221; The rest of DVX works as usual. See <a href="#trouble-addons">Section 11.11</a>.</p>
</div>
<div class="paragraph">
<p><a id="_ix239" class="ixterm"></a><a id="_ix240" class="ixterm"></a>If one of DVX&#8217;s own files cannot be loaded, DVX does not start. It prints &#8220;FATAL: <em>file</em> could not be loaded: <em>reason</em>.&#8221; and &#8220;Run Setup and choose Upgrade or repair to fix DVX.&#8221; Do that (see <a href="#installing-upgrade">Section 3.8</a>).</p>
</div>
<div class="paragraph">
<p>If DVX cannot find a video mode it can use, it prints a message and does not start (see <a href="#req-video-driver">Section 2.3.2</a> and <a href="#trouble-start">Section 11.2</a>).</p>
</div>
<div class="paragraph">
<p><a id="_ix241" class="ixterm"></a><a id="_ix242" class="ixterm"></a>If a program crashes while DVX starts, for example a program in the <strong>Startup</strong> group, DVX ends that program with the <strong>Application Error</strong> message and goes on starting. If something goes wrong inside DVX itself while it starts, DVX returns to DOS with &#8220;DVX stopped while starting: something went wrong inside DVX itself. Start DVX again with a safe start: hold down a Shift key while it starts, or type DVX /SAFE. If DVX still stops, run Setup and choose Upgrade or repair to fix DVX.&#8221; (see <a href="#trouble-start">Section 11.2</a>).</p>
</div>
</div>
<div class="sect3">
<h4 id="installing-exit"><a class="anchor" href="#installing-exit"></a>3.12.3. Leaving DVX</h4>
<div class="paragraph">
<p><a id="_ix243" class="ixterm"></a>To leave DVX, choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Exit DVX</b></span> in the Program Manager, or close the Program Manager window. DVX asks &#8220;Are you sure you want to exit DVX?&#8221; Click <b class="button">Yes</b> to close every program and return to DOS. See <a href="#desktop-exit">Section 5.16</a> for what happens to programs with unsaved work.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="installing-safe-start"><a class="anchor" href="#installing-safe-start"></a>3.13. Safe start and safe video mode</h3>
<div class="sect3">
<h4 id="installing-safe-video"><a class="anchor" href="#installing-safe-video"></a>3.13.1. Safe video mode</h4>
<div class="paragraph">
<p><a id="_ix244" class="ixterm"></a><a id="_ix245" class="ixterm"></a>If the screen mode DVX is set to use does not work on your computer (for example, after you changed video cards), DVX starts in safe video mode instead: 640x480 with 65 thousand colors, or the nearest mode your card has. It then asks, in a box titled <strong>Safe Video Mode</strong>:</p>
</div>
<div class="paragraph">
<p><a id="_ix246" class="ixterm"></a>&#8220;The screen mode DVX is set to use (<em>resolution</em>, <em>n</em>-bit color) does not work on this computer, so DVX started in safe video mode (<em>resolution</em>, <em>n</em>-bit color). Use this mode from now on?&#8221;</p>
</div>
<div class="paragraph">
<p>Each <em>resolution</em> is a width and height in pixels, such as 640x480.</p>
</div>
<div class="ulist">
<ul>
<li>
<p><a id="_ix247" class="ixterm"></a>Click <b class="button">Yes</b> to keep the safe mode from now on. If it cannot be saved, DVX says &#8220;The screen mode could not be saved. Change it in the Control Panel instead.&#8221;</p>
</li>
<li>
<p>Click <b class="button">No</b> to leave the setting alone. DVX tries the old mode again the next time it starts.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>You can choose another mode at any time on the <strong>Video</strong> page of the Control Panel (see <a href="#cpanel-video">Section 7.7</a>).</p>
</div>
</div>
<div class="sect3">
<h4 id="installing-safe-start-how"><a class="anchor" href="#installing-safe-start-how"></a>3.13.2. Safe start</h4>
<div class="paragraph">
<p><a id="_ix248" class="ixterm"></a><a id="_ix249" class="ixterm"></a>If DVX starts but you cannot read the screen (for example, your monitor cannot show the mode DVX is set to use), or DVX stopped starting after you installed an add-on, start DVX in safe mode:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>hold down a <kbd>Shift</kbd> key while DVX starts, from the moment you press <kbd>Enter</kbd> until the desktop appears, or</p>
</li>
<li>
<p>type <code>DVX /SAFE</code> at the DOS prompt.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>A safe start does two things:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>DVX starts in safe video mode and asks: &#8220;DVX started in safe video mode (<em>resolution</em>, <em>n</em>-bit color) as you asked. Use this mode from now on instead of <em>resolution</em>, <em>n</em>-bit color?&#8221; Click <b class="button">Yes</b> to keep the safe mode, or <b class="button">No</b> to keep your usual mode for the next start.</p>
</li>
<li>
<p><a id="_ix250" class="ixterm"></a>DVX leaves out every library and control that add-on packages installed, in case one of them is what stops DVX from starting. DVX&#8217;s own parts load as usual. If any were left out, a message titled <strong>Add-ons</strong> says &#8220;DVX was started in safe mode, so no add-on libraries or widgets were loaded.&#8221; and &#8220;The Software program can reinstall or remove an add-on.&#8221;</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>To use the add-ons again, start DVX the usual way. If an add-on is what stopped DVX from starting, remove it with the Software program during the safe start (see <a href="#addons-removing">Section 10.4</a>).</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="installing-first-start"><a class="anchor" href="#installing-first-start"></a>3.14. The first start</h3>
<div class="paragraph">
<p><a id="_ix251" class="ixterm"></a><a id="_ix252" class="ixterm"></a>The first time DVX starts after a new install, the <strong>Welcome to DVX</strong> window opens in front of the Program Manager. Its banner says &#8220;Welcome to DVX!&#8221; and &#8220;Your desktop for DOS. Here is where to start.&#8221;</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/instWelcome.png" alt="The Welcome to DVX window with six tiles: Take the tour" width="Make it yours" height="See it in action">
</div>
<div class="title">Figure 14. The Welcome window</div>
</div>
<div class="sect3">
<h4 id="installing-welcome-tiles"><a class="anchor" href="#installing-welcome-tiles"></a>3.14.1. The Welcome tiles</h4>
<div class="paragraph">
<p><a id="_ix253" class="ixterm"></a>The window has six tiles, each with a picture, a button, and a line under it. Click the picture or the button:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 25%;">
<col style="width: 33.3333%;">
<col style="width: 41.6667%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Button</th>
<th class="tableblock halign-left valign-top">Line under it</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">Take the tour</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;A quick look around DVX&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Shows a tour of DVX in seven pages (see below).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">Make it yours</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Colors, wallpaper, and more&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Starts the Control Panel (see <a href="#controlPanel">Chapter 7</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">See it in action</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The DVX Demo shows it off&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Starts the DVX Demo. Shown only when the Demos part is installed.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">Write a program</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Make your own in DVX BASIC&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Starts DVX BASIC. Shown only when the DVX BASIC part is installed.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">Browse your files</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;With the File Manager&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Starts the File Manager (see <a href="#programs-file-manager">Section 8.3</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">Read the User Guide</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Everything, explained&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens the DVX user guide in DVX Help (see <a href="#desktop-help">Section 5.11</a>).</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>Under the tiles, a tip that starts &#8220;Did you know?&#8221; changes every few seconds, for example &#8220;Did you know? Press F1 in any program for help about it.&#8221;</p>
</div>
</div>
<div class="sect3">
<h4 id="installing-welcome-tour"><a class="anchor" href="#installing-welcome-tour"></a>3.14.2. The tour</h4>
<div class="paragraph">
<p><a id="_ix254" class="ixterm"></a>The tour shows one page at a time in place of the tiles, with &#8220;Page <em>n</em> of 7&#8221; and the buttons <b class="button">&lt; Previous</b>, <b class="button">Next &gt;</b>, and <b class="button">End the tour</b>. Its pages are &#8220;A quick tour of DVX&#8221;, &#8220;Program Manager&#8221;, &#8220;Windows&#8221;, &#8220;Your files&#8221;, &#8220;Make it yours&#8221;, &#8220;Write your own programs&#8221;, and &#8220;Help is always there&#8221;.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/instTour.png" alt="The Welcome to DVX window showing page 1 of 7 of the tour" width="A quick tour of DVX" height="with the Previous">
</div>
<div class="title">Figure 15. The first page of the tour</div>
</div>
</div>
<div class="sect3">
<h4 id="installing-welcome-again"><a class="anchor" href="#installing-welcome-again"></a>3.14.3. Closing Welcome and seeing it again</h4>
<div class="paragraph">
<p><a id="_ix255" class="ixterm"></a>At the bottom of the window, <strong>Don&#8217;t show this again</strong> starts ticked. If you close the window with it ticked, Welcome does not open the next time DVX starts. Untick it before you close the window if you want Welcome every time DVX starts. <b class="button">Close</b> closes the window.</p>
</div>
<div class="paragraph">
<p><a id="_ix256" class="ixterm"></a>To see Welcome again later, start it from the <strong>Installed Programs</strong> group in the Program Manager. The <strong>Help</strong> menu of the Welcome window has <span class="menuseq"><b class="menu">Help</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Contents</b></span> (<kbd>F1</kbd>) and <span class="menuseq"><b class="menu">Help</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">About Welcome&#8230;&#8203;</b></span>.</p>
</div>
</div>
<div class="sect3">
<h4 id="installing-first-desktop"><a class="anchor" href="#installing-first-desktop"></a>3.14.4. The Program Manager the first time</h4>
<div class="paragraph">
<p><a id="_ix257" class="ixterm"></a><a id="_ix258" class="ixterm"></a>Behind the Welcome window is the Program Manager. The first time DVX starts, it has three groups:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><strong>Installed Programs</strong>, which always lists every program installed in DVX,</p>
</li>
<li>
<p><strong>Main</strong> and <strong>Startup</strong>, two empty groups of your own. Programs you put in <strong>Startup</strong> start each time DVX starts.</p>
</li>
</ul>
</div>
<div class="imageblock">
<div class="content">
<img src="images/instDesktop.png" alt="The DVX desktop with the Program Manager window showing the Installed Programs" width="Main" height="and Startup groups and the icons of the installed programs">
</div>
<div class="title">Figure 16. The Program Manager the first time DVX starts</div>
</div>
<div class="paragraph">
<p>See <a href="#programManager">Chapter 6</a> to start programs and arrange your groups, and <a href="#desktop">Chapter 5</a> to learn to work with windows.</p>
</div>
<div class="paragraph">
<p><a id="_ix259" class="ixterm"></a><a id="_ix260" class="ixterm"></a>DVX starts in the screen mode Setup used, normally 640x480. To use a higher resolution or more colors, choose one on the <strong>Video</strong> page of the Control Panel (see <a href="#cpanel-video">Section 7.7</a>).</p>
</div>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="networking"><a class="anchor" href="#networking"></a>Chapter 4. Setting Up Networking</h2>
<div class="sectionbody">
<div class="paragraph">
<p><a id="_ix261" class="ixterm"></a>With a network card, DVX can reach other computers on your network and on the Internet. This chapter explains what you need, how to load the card&#8217;s driver, how to set up DVX&#8217;s network settings, and how to check that the network works. If you have no network card, you can skip it: DVX works the same without one.</p>
</div>
<div class="sect2">
<h3 id="net-uses"><a class="anchor" href="#net-uses"></a>4.1. What networking gives you</h3>
<div class="paragraph">
<p><a id="_ix262" class="ixterm"></a>With the network set up, you can:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><a id="_ix263" class="ixterm"></a><a id="_ix264" class="ixterm"></a>connect to bulletin boards and other computers over the network with Telnet in the Terminal, and use the Terminal&#8217;s secure link over the network (see <a href="#terminal-connecting">Section 9.5</a> and <a href="#terminal-secure-link">Section 9.7</a>),</p>
</li>
<li>
<p><a id="_ix265" class="ixterm"></a><a id="_ix266" class="ixterm"></a>install, update, and publish software from the package server with the Software program, on its <strong>Available</strong>, <strong>Updates</strong>, and <strong>Published</strong> pages (see <a href="#addons-server">Section 10.6</a>),</p>
</li>
<li>
<p>run BASIC programs that use the network or fetch pages from the web.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>Modems and serial links in the Terminal do not need the network.</p>
</div>
</div>
<div class="sect2">
<h3 id="net-hardware"><a class="anchor" href="#net-hardware"></a>4.2. What you need</h3>
<div class="paragraph">
<p><a id="_ix267" class="ixterm"></a><a id="_ix268" class="ixterm"></a><a id="_ix269" class="ixterm"></a>To use a network, you need:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><strong>A network card with its DOS packet driver.</strong> The card must be an Ethernet card. The packet driver is a small DOS program for your card, usually on the card&#8217;s driver disk, that lets DOS programs use the card. It follows the Packet Driver specification; the card&#8217;s manual or driver disk says whether it has one. DVX uses only packet drivers for Ethernet cards.</p>
</li>
<li>
<p><strong>The Networking part of DVX.</strong> Setup installs it unless you untick <strong>Networking</strong> on the <strong>What to install</strong> page (see <a href="#installing-parts">Section 3.5</a>).</p>
</li>
<li>
<p><strong>Your network&#8217;s settings.</strong> Most networks give out the settings by themselves (DHCP), so there is nothing to type. Otherwise, ask whoever runs the network for an address, a subnet mask, a gateway, and name servers for this computer.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>To use Telnet, you also need the Communications part, which holds the Terminal.</p>
</div>
<div class="sect3">
<h4 id="net-part"><a class="anchor" href="#net-part"></a>4.2.1. Adding the Networking part</h4>
<div class="paragraph">
<p><a id="_ix270" class="ixterm"></a><a id="_ix271" class="ixterm"></a><a id="_ix272" class="ixterm"></a>If the Networking part is not installed:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>the <strong>Network</strong> page of the Control Panel shows only &#8220;Networking is not installed.&#8221;,</p>
</li>
<li>
<p>the Software program&#8217;s package server pages say &#8220;The package server needs DVX&#8217;s Networking part. To add it, run Setup from DVX&#8217;s CD or Disk 1 and choose Upgrade or repair.&#8221;,</p>
</li>
<li>
<p>the Terminal says &#8220;Telnet and the secure link over the network need Networking, which is not installed. Setup can add it.&#8221;</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>To add it:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Run Setup from the DVX CD or Disk 1.</p>
</li>
<li>
<p>Choose <b class="button">Upgrade or repair DVX</b> and the folder DVX is in.</p>
</li>
<li>
<p>On the <strong>What to install</strong> page, tick <strong>Networking</strong>. Leave the other choices as they are.</p>
</li>
<li>
<p>Click <b class="button">Upgrade</b>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>See <a href="#installing-upgrade">Section 3.8</a> for each step.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="net-driver"><a class="anchor" href="#net-driver"></a>4.3. Loading the packet driver</h3>
<div class="paragraph">
<p><a id="_ix273" class="ixterm"></a><a id="_ix274" class="ixterm"></a>The packet driver must be loaded before DVX starts, every time. The usual way is to load it from <code>AUTOEXEC.BAT</code>, on a line above the line that starts DVX.</p>
</div>
<div class="paragraph">
<p>A packet driver&#8217;s command line usually names three things: the software interrupt it uses to talk to programs (normally <code>0x60</code>), and the card&#8217;s interrupt (IRQ) and I/O port. The order and the exact form depend on the driver: look in the card&#8217;s manual or the driver&#8217;s own instructions. For example, for an NE2000 card at I/O port 300h, using IRQ 3, on software interrupt 60h, the line is:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>NE2000.COM 0x60 3 0x300</pre>
</div>
</div>
<div class="paragraph">
<p>To add the packet driver to <code>AUTOEXEC.BAT</code>:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Copy the packet driver from the card&#8217;s driver disk to a folder on your hard disk, for example <code>C:\NET</code>.</p>
</li>
<li>
<p>At the DOS prompt, open <code>AUTOEXEC.BAT</code> in a text editor, for example by typing <code>EDIT C:\AUTOEXEC.BAT</code>.</p>
</li>
<li>
<p>Add the packet driver&#8217;s line above the line that starts DVX, if there is one.</p>
</li>
<li>
<p>Save the file and restart the computer.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>The end of <code>AUTOEXEC.BAT</code> might then look like this (your drivers' names, folders, and settings will differ):</p>
</div>
<div class="listingblock">
<div class="content">
<pre>REM The mouse driver
C:\MOUSE\MOUSE.COM
REM The network card's packet driver
C:\NET\NE2000.COM 0x60 3 0x300
REM Start DVX
C:\DVX\DVX.EXE</pre>
</div>
</div>
<div class="paragraph">
<p>You can also type the packet driver&#8217;s command at the DOS prompt before you start DVX; it then stays loaded until the computer is restarted.</p>
</div>
<div class="paragraph">
<p><a id="_ix275" class="ixterm"></a>DVX looks for the packet driver by itself on the software interrupts 60h to 80h, and uses the first one it finds. Load the driver on an interrupt in that range. If you have more than one packet driver loaded, you can tell DVX which one to use (see <strong>Packet driver</strong> in <a href="#net-setup">Section 4.4</a>).</p>
</div>
<div class="paragraph">
<p><a id="_ix276" class="ixterm"></a>Without a packet driver DVX works as usual, but only this computer can be reached.</p>
</div>
<div class="paragraph">
<p><a id="_ix277" class="ixterm"></a>While DVX runs a DOS program, the network stops. It starts again the next time a program uses it.</p>
</div>
</div>
<div class="sect2">
<h3 id="net-setup"><a class="anchor" href="#net-setup"></a>4.4. Network settings</h3>
<div class="paragraph">
<p><a id="_ix278" class="ixterm"></a><a id="_ix279" class="ixterm"></a>DVX&#8217;s network settings are on the <strong>Network</strong> page of the Control Panel. This section explains the settings you need; <a href="#cpanel-network">Section 7.9</a> describes the page itself.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/netControlPanel.png" alt="The Control Panel&#8217;s Network page with Get the address automatically (DHCP) ticked" width="the Address" height="Subnet mask">
</div>
<div class="title">Figure 17. The Network page of the Control Panel</div>
</div>
<div class="paragraph">
<p>To change the network settings:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Start the Control Panel from the Program Manager.</p>
</li>
<li>
<p>Click the <strong>Network</strong> tab. If the tabs do not all fit, the arrows beside them show the others.</p>
</li>
<li>
<p>Change the settings, as described below.</p>
</li>
<li>
<p>Click <b class="button">OK</b>. The settings are saved. If they changed, the network restarts with them, and any connections that were open are closed.</p>
</li>
</ol>
</div>
<div class="sect3">
<h4 id="net-dhcp"><a class="anchor" href="#net-dhcp"></a>4.4.1. Getting the address automatically (DHCP)</h4>
<div class="paragraph">
<p><a id="_ix280" class="ixterm"></a><a id="_ix281" class="ixterm"></a><strong>Get the address automatically (DHCP)</strong> is ticked to begin with. The network then gives DVX its address, subnet mask, gateway, and name servers. Most networks work this way, so try it first.</p>
</div>
<div class="paragraph">
<p>Right after the network starts, a program that connects or looks up a name waits up to 20 seconds for the address to arrive, instead of failing at once.</p>
</div>
</div>
<div class="sect3">
<h4 id="net-manual"><a class="anchor" href="#net-manual"></a>4.4.2. Setting the address yourself</h4>
<div class="paragraph">
<p><a id="_ix282" class="ixterm"></a><a id="_ix283" class="ixterm"></a>If your network gives out no addresses, untick <strong>Get the address automatically (DHCP)</strong> and fill in:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Address</strong></dt>
<dd>
<p>The address of this computer, such as <code>192.168.1.10</code>. It must be one no other computer on the network uses.</p>
</dd>
<dt class="hdlist1"><strong>Subnet mask</strong></dt>
<dd>
<p>Which addresses are on your own network, usually <code>255.255.255.0</code>.</p>
</dd>
<dt class="hdlist1"><strong>Gateway</strong></dt>
<dd>
<p>The router that leads to other networks and the Internet, such as <code>192.168.1.1</code>. Leave it empty if there is none.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>These three boxes can be used only when <strong>Get the address automatically (DHCP)</strong> is unticked.</p>
</div>
</div>
<div class="sect3">
<h4 id="net-dns"><a class="anchor" href="#net-dns"></a>4.4.3. Name servers</h4>
<div class="paragraph">
<p><a id="_ix284" class="ixterm"></a><a id="_ix285" class="ixterm"></a>A name server turns a name, such as a bulletin board&#8217;s name, into an address.</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Name server 1</strong>, <strong>Name server 2</strong></dt>
<dd>
<p>Leave them empty to use the name servers the network gives out with DHCP. Fill them in, for example with <code>192.168.1.1</code>, to use those name servers instead, even with DHCP.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>When you set the address yourself, there is no DHCP to give out name servers, so type at least one here; otherwise names cannot be looked up, and you can reach other computers only by their numeric addresses.</p>
</div>
</div>
<div class="sect3">
<h4 id="net-name"><a class="anchor" href="#net-name"></a>4.4.4. Computer name and packet driver</h4>
<div class="dlist">
<dl>
<dt class="hdlist1"><a id="_ix286" class="ixterm"></a><strong>Computer name</strong></dt>
<dd>
<p>This computer&#8217;s name on the network, <code>DVX</code> to begin with. It may be up to 63 characters long and use letters, digits, and hyphens, but it may not start or end with a hyphen. DVX sends it to the DHCP server.</p>
</dd>
<dt class="hdlist1"><a id="_ix287" class="ixterm"></a><strong>Packet driver</strong></dt>
<dd>
<p>&#8220;Find it&#8221;, the first choice, makes DVX look for the packet driver by itself. Choose one of &#8220;Interrupt 60h&#8221; to &#8220;Interrupt 80h&#8221; only if DVX does not find the packet driver, or if you have more than one and want a particular one.</p>
</dd>
</dl>
</div>
</div>
<div class="sect3">
<h4 id="net-messages"><a class="anchor" href="#net-messages"></a>4.4.5. When a setting is not valid</h4>
<div class="paragraph">
<p><a id="_ix288" class="ixterm"></a>When you click <b class="button">OK</b> with a setting that is not valid, a warning box titled <strong>Network</strong> says what is wrong, and the Control Panel stays open so you can fix it:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 55.5555%;">
<col style="width: 44.4445%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Message</th>
<th class="tableblock halign-left valign-top">What to fix</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix289" class="ixterm"></a>&#8220;The computer name may only use letters, digits and hyphens&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Computer name</strong> has another character in it, starts or ends with a hyphen, or is empty.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix290" class="ixterm"></a>&#8220;A name server is not a valid address (like 192.168.1.1)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Name server 1</strong> or <strong>Name server 2</strong> is not an address of four numbers separated by dots. Correct it, or empty the box.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix291" class="ixterm"></a>&#8220;The address is not a valid address (like 192.168.1.10)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Address</strong> is empty or not an address of four numbers.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix292" class="ixterm"></a>&#8220;The subnet mask is not valid (like 255.255.255.0)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Subnet mask</strong> is empty or not a valid mask.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix293" class="ixterm"></a>&#8220;The gateway is not a valid address (like 192.168.1.1)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Gateway</strong> is not an address of four numbers. Correct it, or empty the box.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>The address, subnet mask, and gateway are checked only when <strong>Get the address automatically (DHCP)</strong> is unticked.</p>
</div>
<div class="paragraph">
<p><a id="_ix294" class="ixterm"></a>The settings are kept in the <code>[network]</code> section of <code>DVX.INI</code> (see <a href="#folders-dvx-ini">Section B.2</a>).</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="net-check"><a class="anchor" href="#net-check"></a>4.5. Checking that it works</h3>
<div class="paragraph">
<p><a id="_ix295" class="ixterm"></a><a id="_ix296" class="ixterm"></a>The network starts by itself the first time a program uses it, with the saved settings. To start it yourself and watch it come up:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Load the packet driver and start DVX.</p>
</li>
<li>
<p>Start the Control Panel and click the <strong>Network</strong> tab.</p>
</li>
<li>
<p>Click <b class="button">Status&#8230;&#8203;</b>. The <strong>Network Status</strong> window opens. It is updated every second, and it can stay open after you close the Control Panel.</p>
</li>
<li>
<p>Click <b class="button">Restart</b>. The network starts with the saved settings. (If you have just changed the settings, click <b class="button">OK</b> first to save them; that restarts the network too.)</p>
</li>
<li>
<p>Wait until the first line of the <strong>Network Status</strong> window says &#8220;Connected&#8221;.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p><a id="_ix297" class="ixterm"></a>The <strong>Network Status</strong> window has these lines:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 44.4444%;">
<col style="width: 55.5556%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Line</th>
<th class="tableblock halign-left valign-top">What it shows</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">What the network is doing</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">One of the states in the next table.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Address <em>a</em> mask <em>m</em> gateway <em>g</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The address, subnet mask, and gateway in use. A dash means none yet.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Name servers <em>first</em> <em>second</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The name servers in use.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Card <em>name</em> <em>address</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The packet driver&#8217;s name for the card, and the card&#8217;s hardware address.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Received <em>n</em> packets (<em>n</em> bytes, <em>n</em> lost) sent <em>n</em> (<em>n</em> bytes)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">How much has been received and sent. &#8220;Lost&#8221; counts arrivals DVX was too busy to take; for a connection, the other computer sends them again.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix298" class="ixterm"></a>The first line shows one of these states:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 44.4444%;">
<col style="width: 55.5556%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">State</th>
<th class="tableblock halign-left valign-top">Meaning</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix299" class="ixterm"></a>&#8220;Connected&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The network is working. DVX has its address.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix300" class="ixterm"></a>&#8220;Waiting for a DHCP server&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX has found the card and is waiting for the network to give it an address. If it stays this way, check the cable, or set the address yourself (see <a href="#net-manual">Section 4.4.2</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix301" class="ixterm"></a>&#8220;No packet driver found: load one (for example NE2000.COM) before DVX&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX found no packet driver on the interrupts 60h to 80h. Exit DVX, load the packet driver (see <a href="#net-driver">Section 4.3</a>), and start DVX again.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix302" class="ixterm"></a>&#8220;Networking is not started&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No program has used the network yet. Opening the <strong>Network Status</strong> window does not start it: click <b class="button">Restart</b>, or start a program that uses the network.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix303" class="ixterm"></a>When the status says &#8220;Connected&#8221;, try the network out: connect to a bulletin board with Telnet in the Terminal (see <a href="#terminal-connecting">Section 9.5</a>), or look at the <strong>Available</strong> page of the Software program (see <a href="#addons-server">Section 10.6</a>).</p>
</div>
<div class="paragraph">
<p><a id="_ix304" class="ixterm"></a><code>DVX.LOG</code>, in the <code>USER</code> folder, also records whether DVX found a packet driver and which address it got (see <a href="#folders-log">Section B.6</a>).</p>
</div>
</div>
<div class="sect2">
<h3 id="net-trouble"><a class="anchor" href="#net-trouble"></a>4.6. If the network does not work</h3>
<div class="paragraph">
<p><a id="_ix305" class="ixterm"></a>Check these first:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>The <strong>Network</strong> page says &#8220;Networking is not installed.&#8221;: add the Networking part (see <a href="#net-part">Section 4.2.1</a>).</p>
</li>
<li>
<p>The status says &#8220;No packet driver found&#8221;: the packet driver was not loaded before DVX, or it uses an interrupt outside 60h to 80h. Check the line in <code>AUTOEXEC.BAT</code> and the driver&#8217;s own messages when the computer starts.</p>
</li>
<li>
<p>The status stays at &#8220;Waiting for a DHCP server&#8221;: the cable may be loose, or the network may give out no addresses. Set the address yourself.</p>
</li>
<li>
<p>Names cannot be found, but numeric addresses work: check the name servers.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>For more, see <a href="#trouble-network">Section 11.9</a>.</p>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="desktop"><a class="anchor" href="#desktop"></a>Chapter 5. Using the Desktop</h2>
<div class="sectionbody">
<div class="paragraph">
<p><a id="_ix306" class="ixterm"></a>This chapter explains the parts of DVX that work the same in every program: the screen, the mouse and the keyboard, windows, menus, dialog boxes and the controls inside them, the Open and Save dialog boxes, the clipboard, and the keys that work everywhere. It also covers the Task Manager, help, the screen saver, desktop sounds, programs that use the whole screen, DOS programs, and how to leave DVX. Each program&#8217;s own commands are described in its own chapter or help.</p>
</div>
<div class="sect2">
<h3 id="desktop-screen"><a class="anchor" href="#desktop-screen"></a>5.1. The screen after start-up</h3>
<div class="paragraph">
<p><a id="_ix307" class="ixterm"></a>While DVX loads, it shows a title screen with a bar that fills from left to right. The bar can fill a second time after programs or parts of DVX were added or removed, while DVX brings its help files up to date. Then the screen changes to the DVX desktop.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/dtDesktop.png" alt="The DVX desktop: a teal background with the Program Manager window near the top">
</div>
<div class="title">Figure 18. The DVX screen after start-up</div>
</div>
<div class="paragraph">
<p><a id="_ix308" class="ixterm"></a>The <em>desktop</em> is the background behind all the windows. It is teal unless you choose other colors or a picture (wallpaper); see <a href="#cpanel-colors">Section 7.5</a> and <a href="#cpanel-desktop">Section 7.6</a>. Clicking or right-clicking the desktop itself does nothing. Windows of programs you minimize wait as small icons along the bottom of the desktop (see <a href="#desktop-minimizing">Section 5.3.6</a>).</p>
</div>
<div class="paragraph">
<p><a id="_ix309" class="ixterm"></a>The window near the top of the screen is Program Manager. It opens when DVX starts and stays open the whole time DVX runs: it is where you start your programs, and closing it leaves DVX. <a href="#programManager">Chapter 6</a> describes it in full.</p>
</div>
<div class="paragraph">
<p><a id="_ix310" class="ixterm"></a>Right after the desktop appears, a few more things can happen, in this order:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>If DVX started in safe video mode, a <strong>Safe Video Mode</strong> message asks whether to keep that mode (see <a href="#installing-safe-start">Section 3.13</a>).</p>
</li>
<li>
<p>Program Manager opens.</p>
</li>
<li>
<p>The start-up sound plays, if your computer has sound hardware (see <a href="#desktop-sounds">Section 5.13</a>).</p>
</li>
<li>
<p>If DVX runs from a disk it cannot write to, such as a CD-ROM, a message says what happens to the settings you change (see <a href="#troubleshooting">Chapter 11</a>).</p>
</li>
<li>
<p>If an add-on could not be loaded, an <strong>Add-ons</strong> message lists it and why; it ends &#8220;The Software program can reinstall or remove an add-on.&#8221; (see <a href="#trouble-addons">Section 11.11</a>).</p>
</li>
<li>
<p><a id="_ix311" class="ixterm"></a>The <strong>Welcome to DVX</strong> window opens. Its <strong>Don&#8217;t show this again</strong> check box starts ticked, so the window appears only once; untick the box before you close the window to see it at every start (see <a href="#programs-welcome">Section 8.10</a>).</p>
</li>
<li>
<p>A program named on the DVX command line with <code>/RUN=</code>, for example <code>DVX /RUN=APPS\KPUNCH\NOTEPAD\NOTEPAD.APP</code>, starts.</p>
</li>
<li>
<p><a id="_ix312" class="ixterm"></a>The programs in Program Manager&#8217;s <strong>Startup</strong> group start (see <a href="#progman-groups">Section 6.3</a>).</p>
</li>
</ol>
</div>
</div>
<div class="sect2">
<h3 id="desktop-mouse-keyboard"><a class="anchor" href="#desktop-mouse-keyboard"></a>5.2. Using the mouse and the keyboard</h3>
<div class="paragraph">
<p><a id="_ix313" class="ixterm"></a><a id="_ix314" class="ixterm"></a>You can do almost everything in DVX with either the mouse or the keyboard. DVX uses your DOS mouse driver, which must be loaded before you start DVX (see <a href="#trouble-mouse">Section 11.4</a> if the pointer does not move).</p>
</div>
<div class="sect3">
<h4 id="desktop-mouse"><a class="anchor" href="#desktop-mouse"></a>5.2.1. The mouse</h4>
<div class="paragraph">
<p><a id="_ix315" class="ixterm"></a><a id="_ix316" class="ixterm"></a>Moving the mouse moves the pointer on the screen. These are the mouse actions this guide uses:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 25%;">
<col style="width: 75%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Action</th>
<th class="tableblock halign-left valign-top">How to do it</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix317" class="ixterm"></a>Point</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Move the pointer over something.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Click</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Press and release the left mouse button once.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix318" class="ixterm"></a>Double-click</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Click the left button twice, quickly. How quickly is set on the Mouse page of Control Panel (see <a href="#cpanel-mouse">Section 7.4</a>); it starts at half a second.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Drag</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Point at something, hold the left button down while you move the mouse, then let go.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix319" class="ixterm"></a>Right-click</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Press and release the right mouse button. Inside a window, this opens a short menu of commands for what is under the pointer, when the program has one (see <a href="#desktop-context-menus">Section 5.4.4</a>).</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix320" class="ixterm"></a><a id="_ix321" class="ixterm"></a><strong>The scroll wheel.</strong> If your mouse has a wheel and your mouse driver supports it, turning the wheel scrolls the active window: the window you are working in, not the window under the pointer. Inside that window it scrolls the highlighted control (such as a list or a text box), otherwise the window itself. Scrolling a list or a tree does not change which item is selected. On a drop-down list whose list is closed, the wheel changes the choice instead, one choice a notch. Each notch scrolls three lines unless you change it on the Mouse page of Control Panel.</p>
</div>
<div class="paragraph">
<p><a id="_ix322" class="ixterm"></a><strong>Tooltips.</strong> Hold the pointer still for half a second over a button or other control that has a tip, and a small box below the pointer says what it does. The tip goes away as soon as you move the mouse or press a button. Minimized windows show their titles this way too. No tips appear while a menu is open.</p>
</div>
<div class="paragraph">
<p><a id="_ix323" class="ixterm"></a><strong>The pointer.</strong> The pointer changes shape to show what is going on:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 25%;">
<col style="width: 75%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Pointer</th>
<th class="tableblock halign-left valign-top">Meaning</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Arrow</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The normal pointer.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Double arrow (left-right, up-down, or diagonal)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix324" class="ixterm"></a>The pointer is on the edge or corner of a window, and dragging changes the window&#8217;s size (see <a href="#desktop-sizing">Section 5.3.4</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix325" class="ixterm"></a><a id="_ix326" class="ixterm"></a>Hourglass</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A program is loading or DVX is busy. Wait for the arrow to come back: while the hourglass shows, clicks and keys are ignored, and keys typed then are thrown away.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Crosshair, or a circle with a line through it</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Some programs use these, for example while you drag something.</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect3">
<h4 id="desktop-keyboard"><a class="anchor" href="#desktop-keyboard"></a>5.2.2. The keyboard</h4>
<div class="paragraph">
<p><a id="_ix327" class="ixterm"></a><a id="_ix328" class="ixterm"></a>Only one window at a time takes what you type: the <em>active</em> window. Its title bar is drawn in different colors from the others: with the standard colors, it is dark with white letters, and the others are grey.</p>
</div>
<div class="paragraph">
<p><a id="_ix329" class="ixterm"></a><a id="_ix330" class="ixterm"></a>Inside the active window, one control has the <em>keyboard focus</em>: the button, box, or list that your keys go to. It shows a dotted rectangle, or a blinking cursor in a text box. Click a control to give it the focus, or press <kbd>Tab</kbd> to move to the next control and <span class="keyseq"><kbd>Shift</kbd>+<kbd>Tab</kbd></span> to move back. Moving to a control this way also scrolls it into view.</p>
</div>
<div class="paragraph">
<p><a id="_ix331" class="ixterm"></a><a id="_ix332" class="ixterm"></a>Letters that are underlined in menu names, buttons, and labels are shortcuts. Hold down <kbd>Alt</kbd> and press the underlined letter to open that menu, press that button, or move to that control. Pressing and releasing <kbd>Alt</kbd> by itself does nothing; hold it while you press the letter. In a menu that is already open, press a command&#8217;s underlined letter without <kbd>Alt</kbd> (see <a href="#desktop-menus-keyboard">Section 5.4.2</a>).</p>
</div>
<div class="paragraph">
<p>Other keys that work the same everywhere:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><kbd>Enter</kbd> or the Space bar presses the highlighted button.</p>
</li>
<li>
<p><kbd>Esc</kbd> closes a menu or a drop-down list, or cancels a dialog box (or presses <b class="button">Cancel</b> in a window that has one, such as Control Panel).</p>
</li>
<li>
<p><kbd>F1</kbd> opens help for the program you are using (see <a href="#desktop-help">Section 5.11</a>).</p>
</li>
<li>
<p><kbd>F10</kbd> opens the menu bar of the active window (see <a href="#desktop-menus">Section 5.4</a>).</p>
</li>
<li>
<p><span class="keyseq"><kbd>Alt</kbd>+<kbd>Tab</kbd></span> switches to the next window (see <a href="#desktop-active-window">Section 5.3.2</a>).</p>
</li>
</ul>
</div>
<div class="paragraph">
<p><a href="#desktop-keys">Section 5.9</a> lists every key that works in all programs.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="desktop-windows"><a class="anchor" href="#desktop-windows"></a>5.3. Windows</h3>
<div class="paragraph">
<p><a id="_ix333" class="ixterm"></a>Every program shows its work in one or more windows. You can move them around the screen, change their size, make them fill the screen, put them away as icons, and close them.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/dtWindow.png" alt="The Notepad window, showing the Close box at the left of the title bar, the Minimize and Maximize buttons at the right, and the menu bar">
</div>
<div class="title">Figure 19. A window, with its title bar, menu bar, and frame</div>
</div>
<div class="sect3">
<h4 id="desktop-window-parts"><a class="anchor" href="#desktop-window-parts"></a>5.3.1. Parts of a window</h4>
<div class="paragraph">
<p><a id="_ix334" class="ixterm"></a>A window has these parts:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Title bar</strong></dt>
<dd>
<p><a id="_ix335" class="ixterm"></a><a id="_ix336" class="ixterm"></a>The bar across the top, with the window&#8217;s name in the middle. A title too long to fit is cut short. The title bar of the active window stands out in different colors from the others.</p>
</dd>
<dt class="hdlist1"><strong>Close box</strong></dt>
<dd>
<p><a id="_ix337" class="ixterm"></a><a id="_ix338" class="ixterm"></a>The small button at the left end of the title bar, showing a short horizontal bar. Click it once to open the window menu (see <a href="#desktop-window-menu">Section 5.3.9</a>); double-click it to close the window.</p>
</dd>
<dt class="hdlist1"><strong>Minimize button</strong></dt>
<dd>
<p><a id="_ix339" class="ixterm"></a>The button with a small filled square, at the right end of the title bar. It puts the window away as an icon (see <a href="#desktop-minimizing">Section 5.3.6</a>). Dialog boxes do not have one.</p>
</dd>
<dt class="hdlist1"><strong>Maximize button</strong></dt>
<dd>
<p><a id="_ix340" class="ixterm"></a>The button at the far right of the title bar, showing a box outline. It makes the window fill the screen; when the window fills the screen, the button shows a smaller box and puts the window back (see <a href="#desktop-maximizing">Section 5.3.5</a>). Only windows that can change size have this button.</p>
</dd>
<dt class="hdlist1"><strong>Menu bar</strong></dt>
<dd>
<p><a id="_ix341" class="ixterm"></a>Under the title bar, in many windows: the names of the window&#8217;s menus, such as File, Edit, and Help (see <a href="#desktop-menus">Section 5.4</a>).</p>
</dd>
<dt class="hdlist1"><strong>Frame</strong></dt>
<dd>
<p><a id="_ix342" class="ixterm"></a>The raised border around the window. On a window that can change size, small grooves cross the frame near each corner; drag the frame to change the window&#8217;s size (see <a href="#desktop-sizing">Section 5.3.4</a>).</p>
</dd>
<dt class="hdlist1"><strong>Scroll bars</strong></dt>
<dd>
<p><a id="_ix343" class="ixterm"></a>Along the right and bottom edges, when there is more to see than fits in the window (see <a href="#desktop-scroll-bars">Section 5.3.8</a>).</p>
</dd>
</dl>
</div>
</div>
<div class="sect3">
<h4 id="desktop-active-window"><a class="anchor" href="#desktop-active-window"></a>5.3.2. The active window and switching windows</h4>
<div class="paragraph">
<p><a id="_ix344" class="ixterm"></a><a id="_ix345" class="ixterm"></a>Click anywhere in a window (its contents, title bar, frame, menu bar, or scroll bars) to bring it to the front and make it the active window. Right-clicking inside the window&#8217;s contents does the same. A window a program opens comes to the front and becomes active by itself; if it would land exactly on top of another window, DVX moves it a little down and to the right so you can see both.</p>
</div>
<div class="paragraph">
<p><a id="_ix346" class="ixterm"></a><a id="_ix347" class="ixterm"></a>With the keyboard:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><span class="keyseq"><kbd>Alt</kbd>+<kbd>Tab</kbd></span> sends the active window to the back and makes the next window active. No list appears: each press switches at once, so press it again until the window you want is in front.</p>
</li>
<li>
<p><span class="keyseq"><kbd>Shift</kbd>+<kbd>Alt</kbd>+<kbd>Tab</kbd></span> goes the other way: it brings the window at the back to the front.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p><span class="keyseq"><kbd>Alt</kbd>+<kbd>Tab</kbd></span> skips minimized windows, and does nothing while a dialog box is open (see <a href="#desktop-dialog-boxes">Section 5.5.1</a>). The Task Manager can also switch to any program (see <a href="#desktop-task-manager">Section 5.10</a>).</p>
</div>
<div class="paragraph">
<p>When you close or minimize the active window, the window in front of the others becomes active.</p>
</div>
</div>
<div class="sect3">
<h4 id="desktop-moving"><a class="anchor" href="#desktop-moving"></a>5.3.3. Moving a window</h4>
<div class="paragraph">
<p><a id="_ix348" class="ixterm"></a>To move a window, drag its title bar. The window moves with the pointer once you have moved the mouse a few pixels, so a double-click on the title bar does not move it.</p>
</div>
<div class="paragraph">
<p>DVX keeps the window where you can reach it: its top edge cannot go above the top of the screen, its title bar cannot go below the bottom of the screen, and at least 50 pixels of it stay on the screen at the left and right.</p>
</div>
<div class="paragraph">
<p>To move a window with the keyboard, choose <strong>Move</strong> from its window menu (see <a href="#desktop-keyboard-move">Section 5.3.9.1</a>).</p>
</div>
</div>
<div class="sect3">
<h4 id="desktop-sizing"><a class="anchor" href="#desktop-sizing"></a>5.3.4. Changing the size of a window</h4>
<div class="paragraph">
<p><a id="_ix349" class="ixterm"></a><a id="_ix350" class="ixterm"></a>To change the size of a window, point at its frame and drag:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>Drag the left or right edge to change the width.</p>
</li>
<li>
<p>Drag the top or bottom edge to change the height.</p>
</li>
<li>
<p>Drag a corner to change the width and the height together.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>The pointer turns into a double arrow when it is on a spot you can drag: left-right on the side edges, up-down on the top and bottom edges, and diagonal at the corners. You can grab an edge anywhere along the frame and up to two pixels inside it.</p>
</div>
<div class="paragraph">
<p><a id="_ix351" class="ixterm"></a>The grooves across the frame near each corner show where the corners begin: anywhere on the frame between a corner and its grooves, dragging changes the width and the height together.</p>
</div>
<div class="paragraph">
<p>A window cannot be made smaller than its title bar buttons and the start of its title, nor narrower than its menu bar, and it cannot be made larger than the screen (some programs set a smaller limit). When you reach a limit, the edge stops, and the pointer stays on it.</p>
</div>
<div class="paragraph">
<p>Dialog boxes, and some other windows, always keep the same size; their frames have no grooves and do not change the pointer.</p>
</div>
<div class="paragraph">
<p>To change the size with the keyboard, choose <strong>Size</strong> from the window menu (see <a href="#desktop-keyboard-move">Section 5.3.9.1</a>).</p>
</div>
</div>
<div class="sect3">
<h4 id="desktop-maximizing"><a class="anchor" href="#desktop-maximizing"></a>5.3.5. Maximizing and restoring a window</h4>
<div class="paragraph">
<p><a id="_ix352" class="ixterm"></a><a id="_ix353" class="ixterm"></a>To make a window fill the whole screen, click its Maximize button. Some programs limit how large their windows can be; such a window grows as much as the program allows, starting from the top left corner of the screen.</p>
</div>
<div class="paragraph">
<p>To put a maximized window back to the size and place it had before, click the same button again (it now shows a smaller box: the Restore button).</p>
</div>
<div class="paragraph">
<p>Double-clicking the title bar of a window that can change size does the same as the Maximize or Restore button. The window menu has <strong>Maximize</strong> and <strong>Restore</strong> commands too.</p>
</div>
<div class="paragraph">
<p>A maximized window covers the icons of minimized windows. It cannot be moved or have its size changed: dragging its title bar or its frame does nothing, and the window menu&#8217;s <strong>Move</strong> and <strong>Size</strong> are grey. Restore it first. After you change the screen resolution (see <a href="#cpanel-video">Section 7.7</a>), no window counts as maximized any more.</p>
</div>
</div>
<div class="sect3">
<h4 id="desktop-minimizing"><a class="anchor" href="#desktop-minimizing"></a>5.3.6. Minimizing a window</h4>
<div class="paragraph">
<p><a id="_ix354" class="ixterm"></a><a id="_ix355" class="ixterm"></a><a id="_ix356" class="ixterm"></a>To put a window away without closing it, click its Minimize button, or choose <strong>Minimize</strong> from its window menu. The program keeps running.</p>
</div>
<div class="paragraph">
<p>The window becomes a square icon along the bottom of the screen. The icons line up from left to right; when a row is full, a new row starts above it. An icon shows the program&#8217;s own picture, or, for a program without one, a small copy of the window&#8217;s contents that keeps up to date while the window is minimized. Hold the pointer still over an icon to see the window&#8217;s title.</p>
</div>
<div class="paragraph">
<p><a id="_ix357" class="ixterm"></a>To bring the window back, double-click its icon: the window comes back where it was, in front of the others, and becomes active. A single click on an icon does nothing, and icons have no right-click menu. You can also use the Task Manager: select the program and click <b class="button">Switch To</b> (see <a href="#desktop-task-manager">Section 5.10</a>).</p>
</div>
<div class="paragraph">
<p>Icons lie underneath all windows. If a window covers an icon, move or minimize that window to reach it. While a dialog box is open, icons cannot be restored.</p>
</div>
<div class="paragraph">
<p>Dialog boxes cannot be minimized: they have no Minimize button, and the window menu&#8217;s <strong>Minimize</strong> command is grey.</p>
</div>
</div>
<div class="sect3">
<h4 id="desktop-closing"><a class="anchor" href="#desktop-closing"></a>5.3.7. Closing a window</h4>
<div class="paragraph">
<p><a id="_ix358" class="ixterm"></a>Any of these closes a window:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>Double-click the Close box at the left end of the title bar.</p>
</li>
<li>
<p>Click the Close box once, then choose <strong>Close</strong> from the window menu.</p>
</li>
<li>
<p>Press <span class="keyseq"><kbd>Alt</kbd>+<kbd>F4</kbd></span> while the window is active.</p>
</li>
<li>
<p>Choose the program&#8217;s own command, such as <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Exit</b></span>, if it has one.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>A program with unsaved work usually asks whether to save it first (see <a href="#desktop-message-boxes">Section 5.5.2</a>). Closing a program&#8217;s last window usually ends the program.</p>
</div>
<div class="paragraph">
<p>While a dialog box is open, <span class="keyseq"><kbd>Alt</kbd>+<kbd>F4</kbd></span> closes only the dialog box. Closing a dialog box with its Close box is the same as choosing <b class="button">Cancel</b>.</p>
</div>
</div>
<div class="sect3">
<h4 id="desktop-scroll-bars"><a class="anchor" href="#desktop-scroll-bars"></a>5.3.8. Scroll bars</h4>
<div class="paragraph">
<p><a id="_ix359" class="ixterm"></a>A scroll bar shows that a window, list, or box holds more than fits, and lets you see the rest:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>Click the arrow at either end to move one step (for example, one line). Hold the mouse button down on the arrow to keep moving: after a moment, the steps repeat until you let go.</p>
</li>
<li>
<p>Click the empty track on either side of the box to move one page. Hold the button down to keep moving a page at a time, until the box reaches the pointer.</p>
</li>
<li>
<p>Drag the box in the middle to move to any place.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>If you move the pointer off the window, list, or box while you hold the button down, the scrolling pauses until you move back.
* Turn the mouse wheel to scroll the active window (see <a href="#desktop-mouse">Section 5.2.1</a>).</p>
</div>
</div>
<div class="sect3">
<h4 id="desktop-window-menu"><a class="anchor" href="#desktop-window-menu"></a>5.3.9. The window menu</h4>
<div class="paragraph">
<p><a id="_ix360" class="ixterm"></a><a id="_ix361" class="ixterm"></a><a id="_ix362" class="ixterm"></a>Every window has a window menu with commands for the window itself. To open it, click the Close box once, or press <span class="keyseq"><kbd>Alt</kbd>+<kbd>Space</kbd></span> (press <span class="keyseq"><kbd>Alt</kbd>+<kbd>Space</kbd></span> again to close it). The menu opens just below the Close box.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 25%;">
<col style="width: 75%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Command</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Restore</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Puts a maximized window back to its earlier size and place. Grey unless the window is maximized.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Move</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Moves the window with the arrow keys (see <a href="#desktop-keyboard-move">Section 5.3.9.1</a>). Grey while the window is maximized.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Size</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Changes the window&#8217;s size with the arrow keys. Grey while the window is maximized, and for windows that cannot change size.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Minimize</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Puts the window away as an icon. Grey for dialog boxes.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Maximize</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Makes the window fill the screen. Grey while the window is maximized, and for windows that cannot change size.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Screenshot&#8230;&#8203;</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix363" class="ixterm"></a>Saves a picture of the whole screen in a file (see <a href="#desktop-screenshots">Section 5.8</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Window Shot&#8230;&#8203;</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Saves a picture of the inside of this window in a file (see <a href="#desktop-screenshots">Section 5.8</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Close</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Closes the window.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>Grey commands cannot be chosen. To choose a command with the keyboard, press <kbd>Up</kbd> or <kbd>Down</kbd> to highlight it and press <kbd>Enter</kbd>, or press its underlined letter. <kbd>Esc</kbd> closes the menu. With the mouse, click a command; a click anywhere outside the menu closes it, and that click also acts on whatever you clicked.</p>
</div>
<div class="sect4">
<h5 id="desktop-keyboard-move"><a class="anchor" href="#desktop-keyboard-move"></a>Moving and sizing with the keyboard</h5>
<div class="paragraph">
<p><a id="_ix364" class="ixterm"></a><a id="_ix365" class="ixterm"></a>After you choose <strong>Move</strong> or <strong>Size</strong> from the window menu, the arrow keys move the window or change its size, 8 pixels at a time:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><strong>Move</strong>: each arrow key moves the window 8 pixels in its direction. The window stays on the screen, as when you drag it.</p>
</li>
<li>
<p><strong>Size</strong>: <kbd>Right</kbd> and <kbd>Down</kbd> make the window wider and taller; <kbd>Left</kbd> and <kbd>Up</kbd> make it narrower and shorter. Only the right and bottom edges move.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>Press <kbd>Enter</kbd> to keep the new place or size, or <kbd>Esc</kbd> to put the window back as it was. Other keys are ignored until you do, except <span class="keyseq"><kbd>Alt</kbd>+<kbd>Tab</kbd></span> (which ends moving or sizing), <span class="keyseq"><kbd>Alt</kbd>+<kbd>F4</kbd></span>, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Esc</kbd></span>, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>F12</kbd></span>, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>F12</kbd></span>, <kbd>F1</kbd>, and <kbd>F10</kbd>.</p>
</div>
</div>
</div>
<div class="sect3">
<h4 id="desktop-arranging"><a class="anchor" href="#desktop-arranging"></a>5.3.10. Arranging windows</h4>
<div class="paragraph">
<p><a id="_ix366" class="ixterm"></a><a id="_ix367" class="ixterm"></a><a id="_ix368" class="ixterm"></a>Program Manager&#8217;s <b class="menuref">Window</b> menu arranges every window on the screen at once. Minimized windows stay icons; every other window is moved and resized, Program Manager&#8217;s own window included:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Cascade</strong></dt>
<dd>
<p><a id="_ix369" class="ixterm"></a>Makes every window two thirds of the screen&#8217;s width and height and stacks them like a staircase from the top left corner, each one a title bar&#8217;s height further down and to the right, so that every title bar shows. When the next window would run off the screen, the staircase starts again at the corner.</p>
</dd>
<dt class="hdlist1"><strong>Tile</strong></dt>
<dd>
<p><a id="_ix370" class="ixterm"></a>Divides the screen into a grid of tiles that fills it, one window to a tile. The grid is about as many columns wide as it is rows high: two windows go side by side, three or four in two columns, five to nine in three columns, and so on. When the last row has fewer windows than the others, its windows are wider, so that the row is still filled.</p>
</dd>
<dt class="hdlist1"><strong>Tile Horizontally</strong></dt>
<dd>
<p><a id="_ix371" class="ixterm"></a>Puts the windows one above the other, from top to bottom, each as wide as the screen and all the same height.</p>
</dd>
<dt class="hdlist1"><strong>Tile Vertically</strong></dt>
<dd>
<p><a id="_ix372" class="ixterm"></a>Puts the windows side by side, from left to right, each as tall as the screen and all the same width.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>Tiles are never made smaller than 80 by 60 pixels. With so many windows that they would be, the last windows overlap at the right or bottom edge of the screen.</p>
</div>
<div class="admonitionblock tip">
<table>
<tr>
<td class="icon">
<div class="title">Tip</div>
</td>
<td class="content">
If a window is lost behind the others, <span class="keyseq"><kbd>Alt</kbd>+<kbd>Tab</kbd></span> brings each window to the front in turn, and <span class="menuseq"><b class="menu">Window</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Cascade</b></span> brings every window into view.
</td>
</tr>
</table>
</div>
</div>
</div>
<div class="sect2">
<h3 id="desktop-menus"><a class="anchor" href="#desktop-menus"></a>5.4. Menus</h3>
<div class="paragraph">
<p><a id="_ix373" class="ixterm"></a>Many windows have a menu bar under the title bar, with names such as File, Edit, and Help. Each name opens a menu of commands.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/dtMenu.png" alt="Notepad&#8217;s File menu open, with the commands New, Open&#8230;&#8203;, Save, Save As&#8230;&#8203;, Page Setup&#8230;&#8203;, Print&#8230;&#8203;, and Exit">
</div>
<div class="title">Figure 20. An open menu</div>
</div>
<div class="sect3">
<h4 id="desktop-menus-mouse"><a class="anchor" href="#desktop-menus-mouse"></a>5.4.1. Using menus with the mouse</h4>
<div class="paragraph">
<p><a id="_ix374" class="ixterm"></a>Click a menu name to open its menu; the name looks pressed in while its menu is open. Then click a command to choose it.</p>
</div>
<div class="ulist">
<ul>
<li>
<p>While a menu is open, move the pointer along the menu bar to open the other menus.</p>
</li>
<li>
<p>Click the open menu&#8217;s name again to close it.</p>
</li>
<li>
<p>Point at a command with a small triangle to open its submenu. Moving the pointer back to the first menu closes the submenu.</p>
</li>
<li>
<p>Click anywhere outside the menu to close it without choosing anything. That click does nothing else.</p>
</li>
</ul>
</div>
</div>
<div class="sect3">
<h4 id="desktop-menus-keyboard"><a class="anchor" href="#desktop-menus-keyboard"></a>5.4.2. Using menus with the keyboard</h4>
<div class="paragraph">
<p><a id="_ix375" class="ixterm"></a><a id="_ix376" class="ixterm"></a>Press <kbd>F10</kbd> to open the first menu of the active window (press it again to close the menu), or hold <kbd>Alt</kbd> and press the underlined letter of a menu name. If a menu name and a control in the same window have the same underlined letter, <kbd>Alt</kbd> and that letter open the menu.</p>
</div>
<div class="paragraph">
<p>When a menu opens from the keyboard, no command is highlighted yet: press <kbd>Down</kbd> to highlight the first one. Then:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 28.5714%;">
<col style="width: 71.4286%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Up</kbd>, <kbd>Down</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Move the highlight to the previous or next command. The highlight wraps around from the bottom to the top and skips the lines between groups.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Right</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens the submenu of the highlighted command; otherwise opens the next menu on the menu bar.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Left</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Closes the open submenu; otherwise opens the previous menu on the menu bar.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Enter</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Chooses the highlighted command, or opens its submenu. With nothing highlighted, closes the menu.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">A letter</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Chooses the command with that underlined letter (you do not need <kbd>Alt</kbd> in an open menu). If no command has that letter, opens the menu on the menu bar that has it.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Esc</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Closes the open submenu, or the menu.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>While a menu is open, the window and its controls get no keys: what you type goes to the menu, apart from the few keys that work everywhere, such as <span class="keyseq"><kbd>Alt</kbd>+<kbd>Tab</kbd></span> and <kbd>F1</kbd> (see <a href="#desktop-keys">Section 5.9</a>).</p>
</div>
</div>
<div class="sect3">
<h4 id="desktop-menu-marks"><a class="anchor" href="#desktop-menu-marks"></a>5.4.3. Marks in menus</h4>
<div class="paragraph">
<p><a id="_ix377" class="ixterm"></a><a id="_ix378" class="ixterm"></a><a id="_ix379" class="ixterm"></a>Some commands show extra marks:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 25%;">
<col style="width: 75%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Mark</th>
<th class="tableblock halign-left valign-top">Meaning</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Three dots (&#8230;&#8203;) after the command</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The command opens a dialog box where you give more details before anything happens.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">A key name at the right edge, such as <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Esc</kbd></span> or <kbd>F5</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix380" class="ixterm"></a>A shortcut: press those keys to give the command without opening the menu.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">A tick mark before the command</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">An option that is turned on. Choose the command again to turn it off.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">A filled diamond before the command</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix381" class="ixterm"></a>The chosen one of a group of options, of which only one can be chosen, such as Program Manager&#8217;s <span class="menuseq"><b class="menu">View</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Large Icons</b></span>, <span class="menuseq"><b class="menu">View</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Small Icons</b></span>, and <span class="menuseq"><b class="menu">View</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">List</b></span>. Choose another option of the group to change it; choosing the marked one again leaves it chosen.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">A small triangle at the right edge</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The command opens a submenu.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Grey command</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The command cannot be used right now.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Line between commands</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Separates groups of related commands.</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect3">
<h4 id="desktop-context-menus"><a class="anchor" href="#desktop-context-menus"></a>5.4.4. Context menus</h4>
<div class="paragraph">
<p><a id="_ix382" class="ixterm"></a><a id="_ix383" class="ixterm"></a><a id="_ix384" class="ixterm"></a>Many programs show a short menu when you right-click inside a window. The menu opens at the pointer and holds commands for the thing you right-clicked (or for the window). Right-clicking also brings the window to the front.</p>
</div>
<div class="paragraph">
<p>Choose a command with the left mouse button, or with the keyboard as in any menu. Click outside the menu or press <kbd>Esc</kbd> to close it. A second right-click while the menu is open does nothing.</p>
</div>
<div class="paragraph">
<p>Right-clicking an item in a list does not always select it: in most lists, select the item with the left button first, then right-click. Program Manager&#8217;s icons are selected by a right-click.</p>
</div>
<div class="paragraph">
<p>Right-clicking a title bar, a frame, or the desktop does nothing.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="desktop-dialogs"><a class="anchor" href="#desktop-dialogs"></a>5.5. Dialog boxes and controls</h3>
<div class="paragraph">
<p><a id="_ix385" class="ixterm"></a>A <em>dialog box</em> is a small window that asks you a question, or asks for details before a command is carried out. Windows and dialog boxes are built from the same few kinds of <em>controls</em> (buttons, check boxes, lists, and so on), which work the same in every program.</p>
</div>
<div class="sect3">
<h4 id="desktop-dialog-boxes"><a class="anchor" href="#desktop-dialog-boxes"></a>5.5.1. How dialog boxes work</h4>
<div class="paragraph">
<p><a id="_ix386" class="ixterm"></a>Dialog boxes open in the middle of the screen. They have no Minimize or Maximize button, and they always keep the same size.</p>
</div>
<div class="admonitionblock important">
<table>
<tr>
<td class="icon">
<div class="title">Important</div>
</td>
<td class="content">
While a dialog box is open, you must answer it before you can use anything else on the desktop, in any program. The dialog box stays in front; clicks on other windows are ignored, minimized windows cannot be restored, <span class="keyseq"><kbd>Alt</kbd>+<kbd>Tab</kbd></span> does nothing, and Program Manager&#8217;s shortcut keys do nothing. <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Esc</kbd></span> and <kbd>F1</kbd> still open the Task Manager or help, but the dialog box comes back in front, and the new window can be used only once the dialog box is answered.
</td>
</tr>
</table>
</div>
<div class="paragraph">
<p><a id="_ix387" class="ixterm"></a><a id="_ix388" class="ixterm"></a>Keys in a dialog box:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><kbd>Enter</kbd> presses the main button, usually <b class="button">OK</b>, <b class="button">Open</b>, <b class="button">Save</b>, or <b class="button">Yes</b>, whichever control has the focus, except these, which use <kbd>Enter</kbd> themselves: a button (<kbd>Enter</kbd> presses that button), an open drop-down list (<kbd>Enter</kbd> takes the highlighted choice and closes the list), and a text box that holds several lines (<kbd>Enter</kbd> starts a new line). On a check box, an option button, a closed drop-down list, a list, or a number box, <kbd>Enter</kbd> presses the main button and leaves the control as it is.</p>
</li>
<li>
<p><kbd>Esc</kbd> presses <b class="button">Cancel</b> (or the last button of a message box) and closes the dialog box without making changes. When a drop-down list is open, <kbd>Esc</kbd> first closes the list.</p>
</li>
<li>
<p><kbd>Tab</kbd> and <span class="keyseq"><kbd>Shift</kbd>+<kbd>Tab</kbd></span> move between the controls; <kbd>Alt</kbd> and an underlined letter goes straight to a control or presses a button.</p>
</li>
<li>
<p>Closing a dialog box with its Close box (or <span class="keyseq"><kbd>Alt</kbd>+<kbd>F4</kbd></span>) is the same as <b class="button">Cancel</b>.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p><a id="_ix389" class="ixterm"></a><a id="_ix390" class="ixterm"></a>Some windows that are not dialog boxes have <b class="button">OK</b> and <b class="button">Cancel</b> buttons too, such as Control Panel. <kbd>Enter</kbd> and <kbd>Esc</kbd> work there the same way: <kbd>Enter</kbd> presses <b class="button">OK</b> (except on the controls above that use <kbd>Enter</kbd> themselves), and <kbd>Esc</kbd> presses <b class="button">Cancel</b>.</p>
</div>
<div class="paragraph">
<p><a id="_ix391" class="ixterm"></a>In most dialog boxes with <b class="button">OK</b> and <b class="button">Cancel</b>, <span class="keyseq"><kbd>Alt</kbd>+<kbd>C</kbd></span> presses <b class="button">Cancel</b>.</p>
</div>
</div>
<div class="sect3">
<h4 id="desktop-message-boxes"><a class="anchor" href="#desktop-message-boxes"></a>5.5.2. Message boxes</h4>
<div class="paragraph">
<p><a id="_ix392" class="ixterm"></a><a id="_ix393" class="ixterm"></a><a id="_ix394" class="ixterm"></a>A <em>message box</em> shows a short message, usually with a picture, and a row of buttons. Click a button to answer.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/dtSaveChanges.png" alt="A message box titled Notepad with a question mark picture, the text Save changes?, and the buttons Yes, No, and Cancel">
</div>
<div class="title">Figure 21. A message box asking a question</div>
</div>
<div class="paragraph">
<p>The picture shows what kind of message it is:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>An "i" in a circle: information.</p>
</li>
<li>
<p>An "!" in a triangle: a warning.</p>
</li>
<li>
<p>An "X" in a circle: an error.</p>
</li>
<li>
<p>A "?" in a circle: a question.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>The buttons are <b class="button">OK</b>; <b class="button">OK</b> and <b class="button">Cancel</b>; <b class="button">Yes</b> and <b class="button">No</b>; <b class="button">Yes</b>, <b class="button">No</b>, and <b class="button">Cancel</b>; or <b class="button">Retry</b> and <b class="button">Cancel</b>. Their underlined letters are O, C, Y, N, and R. <kbd>Enter</kbd> presses the first button and <kbd>Esc</kbd> presses the last. Closing a message box with its Close box answers <b class="button">Cancel</b>; in a box with only <b class="button">Yes</b> and <b class="button">No</b>, that is neither answer.</p>
</div>
<div class="paragraph">
<p><a id="_ix395" class="ixterm"></a><a id="_ix396" class="ixterm"></a>When you close a program, or start a new file, while you have unsaved work, most programs ask &#8220;Save changes?&#8221;:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><b class="button">Yes</b> saves your work first.</p>
</li>
<li>
<p><b class="button">No</b> throws the changes away.</p>
</li>
<li>
<p><b class="button">Cancel</b> goes back to your work without doing anything.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>Each kind of message box plays its own desktop sound, if sounds are set (see <a href="#desktop-sounds">Section 5.13</a>).</p>
</div>
</div>
<div class="sect3">
<h4 id="desktop-controls"><a class="anchor" href="#desktop-controls"></a>5.5.3. Controls</h4>
<div class="paragraph">
<p><a id="_ix397" class="ixterm"></a>This section describes each kind of control and how to use it with the mouse and with the keyboard. With the keyboard, first give the control the focus: press <kbd>Tab</kbd> until it shows the dotted rectangle, or press <kbd>Alt</kbd> and the underlined letter of its label.</p>
</div>
<div class="sect4">
<h5 id="desktop-buttons"><a class="anchor" href="#desktop-buttons"></a>Buttons</h5>
<div class="paragraph">
<p><a id="_ix398" class="ixterm"></a><a id="_ix399" class="ixterm"></a>Click a button to use it: the button acts when you let go of the mouse button over it. With the keyboard, press the Space bar or <kbd>Enter</kbd> while the button has the focus, or press <kbd>Alt</kbd> and its underlined letter.</p>
</div>
</div>
<div class="sect4">
<h5 id="desktop-check-boxes"><a class="anchor" href="#desktop-check-boxes"></a>Check boxes</h5>
<div class="paragraph">
<p><a id="_ix400" class="ixterm"></a><a id="_ix401" class="ixterm"></a>A check box turns one option on or off; an X in the box means the option is on. Click the box or its label, press the Space bar while it has the focus, or press <kbd>Alt</kbd> and its underlined letter. As with a button, the box changes when you let go of the mouse button over it: while you hold the button down the box shows pressed, and moving the pointer off it before you let go leaves it as it was. <kbd>Enter</kbd> never changes a check box: in a dialog box, or a window with a main button, it presses that button, and anywhere else it does nothing.</p>
</div>
</div>
<div class="sect4">
<h5 id="desktop-option-buttons"><a class="anchor" href="#desktop-option-buttons"></a>Option buttons</h5>
<div class="paragraph">
<p><a id="_ix402" class="ixterm"></a><a id="_ix403" class="ixterm"></a><a id="_ix404" class="ixterm"></a>Option buttons come in groups, and only one in a group can be chosen; a diamond marks the chosen one. Click the one you want: it is chosen when you let go of the mouse button over it, as a button acts (move the pointer off it before you let go to change nothing). With the keyboard, <kbd>Up</kbd> or <kbd>Left</kbd> chooses the one before, and <kbd>Down</kbd> or <kbd>Right</kbd> the one after (they stop at the ends of the group); the Space bar, or <kbd>Alt</kbd> and its underlined letter, chooses an option button. <kbd>Enter</kbd> never chooses one: in a dialog box, or a window with a main button, it presses that button, and anywhere else it does nothing.</p>
</div>
</div>
<div class="sect4">
<h5 id="desktop-text-boxes"><a class="anchor" href="#desktop-text-boxes"></a>Text boxes</h5>
<div class="paragraph">
<p><a id="_ix405" class="ixterm"></a><a id="_ix406" class="ixterm"></a><a id="_ix407" class="ixterm"></a>Click in a text box and type. What you type is always inserted at the cursor; there is no overtype mode. A text box that holds several lines works like a small editor.</p>
</div>
<div class="paragraph">
<p>With the mouse, click to place the cursor, drag across text to select it, double-click to select a word, and triple-click to select the whole line.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 28.5714%;">
<col style="width: 71.4286%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Left</kbd>, <kbd>Right</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Move one character.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Left</kbd></span>, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Right</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Move one word.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Home</kbd>, <kbd>End</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Go to the start or end of the line.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Up</kbd>, <kbd>Down</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">In a box of several lines: move one line.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Page Up</kbd>, <kbd>Page Down</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">In a box of several lines: move one boxful of lines.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Home</kbd></span>, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>End</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">In a box of several lines: go to the start or end of the text.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Shift</kbd> with a moving key</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Select text as you move.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Backspace</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Delete the character before the cursor, or the selected text.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Del</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Delete the character at the cursor, or the selected text.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Enter</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">In a box of several lines: start a new line.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>A</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Select all the text.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>X</kbd></span>, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>C</kbd></span>, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>V</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Cut, copy, and paste (see <a href="#desktop-clipboard">Section 5.7</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Z</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix408" class="ixterm"></a>Undo the last change. Press it again to redo the change. Only the last change can be undone.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix409" class="ixterm"></a>A box for a password shows other characters in place of what you type, and does not let you cut or copy its text.</p>
</div>
<div class="paragraph">
<p>In most windows <kbd>Tab</kbd> moves to the next control. A few large text boxes take <kbd>Tab</kbd> themselves to type a tab; click another control to move on.</p>
</div>
</div>
<div class="sect4">
<h5 id="desktop-number-boxes"><a class="anchor" href="#desktop-number-boxes"></a>Number boxes</h5>
<div class="paragraph">
<p><a id="_ix410" class="ixterm"></a><a id="_ix411" class="ixterm"></a><a id="_ix412" class="ixterm"></a>A number box has small up and down arrows beside it. Click an arrow to go up or down one step, or press <kbd>Up</kbd> or <kbd>Down</kbd>; <kbd>Page Up</kbd> and <kbd>Page Down</kbd> go ten steps. You can also type a number and press <kbd>Enter</kbd> to take it, or <kbd>Esc</kbd> to throw away what you typed. In a dialog box, <kbd>Enter</kbd> presses the main button, with the number you typed.</p>
</div>
</div>
<div class="sect4">
<h5 id="desktop-lists"><a class="anchor" href="#desktop-lists"></a>Lists</h5>
<div class="paragraph">
<p><a id="_ix413" class="ixterm"></a><a id="_ix414" class="ixterm"></a>A list shows several items. Click an item to select it, and double-click it (or press <kbd>Enter</kbd>) to open or use it. In a dialog box, or a window with a main button (such as Control Panel&#8217;s <b class="button">OK</b>), <kbd>Enter</kbd> presses the main button instead. With the keyboard:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><kbd>Up</kbd>, <kbd>Down</kbd>, <kbd>Page Up</kbd>, <kbd>Page Down</kbd>, <kbd>Home</kbd>, and <kbd>End</kbd> move through the list.</p>
</li>
<li>
<p><kbd>Left</kbd> and <kbd>Right</kbd> scroll a wide list sideways.</p>
</li>
<li>
<p><a id="_ix415" class="ixterm"></a><a id="_ix416" class="ixterm"></a>Typing the first letters of an item quickly, one after another, jumps to the first item that starts with them, counting from the item you are on: in a list of names, <kbd>B</kbd> then <kbd>O</kbd> goes to Bob. Typing the same letter again moves on to the next item that starts with it, going round to the top after the last one. After a pause of a second, the next letter starts again. If no item starts with the letters typed, the list stays where it is.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p><a id="_ix417" class="ixterm"></a>Some lists let you select several items at once:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>Hold <kbd>Ctrl</kbd> while you click to add an item to the selection, or to take it out.</p>
</li>
<li>
<p>Hold <kbd>Shift</kbd> while you click to select every item between the last one you clicked and this one.</p>
</li>
<li>
<p>Hold <kbd>Shift</kbd> while you press the arrow keys to extend the selection.</p>
</li>
<li>
<p>Press the Space bar to select the item at the cursor, or take it out.</p>
</li>
<li>
<p>Press <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>A</kbd></span> to select every item.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>In some lists you can change the order of the items by dragging them.</p>
</div>
<div class="paragraph">
<p><a id="_ix418" class="ixterm"></a><a id="_ix419" class="ixterm"></a><strong>Lists with columns.</strong> Some lists show their items in columns, with a heading above each column. Click a heading to sort the list by that column; click it again to sort it the other way. Drag the line between two headings to make a column wider or narrower.</p>
</div>
</div>
<div class="sect4">
<h5 id="desktop-drop-down-lists"><a class="anchor" href="#desktop-drop-down-lists"></a>Drop-down lists</h5>
<div class="paragraph">
<p><a id="_ix420" class="ixterm"></a><a id="_ix421" class="ixterm"></a>A drop-down list shows the current choice, with an arrow button beside it. Click it to open the list of choices, then click the one you want. Clicking anywhere else closes the list without changing the choice.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/dtDropDown.png" alt="A drop-down list labelled Scroll Wheel, open to show the choices Normal and Reversed">
</div>
<div class="title">Figure 22. An open drop-down list</div>
</div>
<div class="paragraph">
<p>With the keyboard, while the drop-down list has the focus:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><kbd>Up</kbd> and <kbd>Down</kbd> change the choice without opening the list.</p>
</li>
<li>
<p>Typing the first letters of a choice chooses it, the same way as in a list (see <a href="#desktop-lists">Section 5.5.3.6</a>).</p>
</li>
<li>
<p><kbd>F4</kbd>, <span class="keyseq"><kbd>Alt</kbd>+<kbd>Down</kbd></span>, or <span class="keyseq"><kbd>Alt</kbd>+<kbd>Up</kbd></span> opens the list. <kbd>Alt</kbd> and the underlined letter of the list&#8217;s label also opens it. The Space bar and <kbd>Enter</kbd> do not: in a dialog box, or a window with a main button, <kbd>Enter</kbd> presses that button.</p>
</li>
<li>
<p>In the open list, <kbd>Up</kbd> and <kbd>Down</kbd> move the highlight; <kbd>Enter</kbd>, the Space bar, <kbd>F4</kbd>, <span class="keyseq"><kbd>Alt</kbd>+<kbd>Down</kbd></span>, or <span class="keyseq"><kbd>Alt</kbd>+<kbd>Up</kbd></span> takes the highlighted choice and closes the list (in a dialog box too: <kbd>Enter</kbd> then does not press the main button); <kbd>Esc</kbd> closes the list without changing the choice.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p><a id="_ix422" class="ixterm"></a>Some drop-down lists also let you type your own entry, such as the <strong>Open</strong> box of the Run dialog box (see <a href="#progman-run">Section 6.7</a>). Type in the box as in a text box. <kbd>Up</kbd> and <kbd>Down</kbd> put the choice before or after the current one in the box without opening the list, and <kbd>F4</kbd>, <span class="keyseq"><kbd>Alt</kbd>+<kbd>Down</kbd></span>, or <span class="keyseq"><kbd>Alt</kbd>+<kbd>Up</kbd></span> opens the list. In the open list of such a box, <kbd>Up</kbd> and <kbd>Down</kbd> put each choice in the box as they move to it.</p>
</div>
</div>
<div class="sect4">
<h5 id="desktop-sliders"><a class="anchor" href="#desktop-sliders"></a>Sliders</h5>
<div class="paragraph">
<p><a id="_ix423" class="ixterm"></a><a id="_ix424" class="ixterm"></a>A slider sets a value by the position of a knob along a track. Drag the knob, or click the track to move the knob there. With the keyboard, <kbd>Left</kbd> or <kbd>Up</kbd> lowers the value one step and <kbd>Right</kbd> or <kbd>Down</kbd> raises it; <kbd>Page Up</kbd> and <kbd>Page Down</kbd> move a tenth of the way; <kbd>Home</kbd> and <kbd>End</kbd> go to the lowest and highest values.</p>
</div>
</div>
<div class="sect4">
<h5 id="desktop-tabs"><a class="anchor" href="#desktop-tabs"></a>Tabs</h5>
<div class="paragraph">
<p><a id="_ix425" class="ixterm"></a><a id="_ix426" class="ixterm"></a>Some windows hold several pages, with a row of tabs along the top like the tabs of file folders. Click a tab to show its page, or press <kbd>Alt</kbd> and the tab&#8217;s underlined letter. When the row of tabs has the focus, <kbd>Left</kbd> and <kbd>Right</kbd> move to the tab beside the current one, and <kbd>Home</kbd> and <kbd>End</kbd> to the first and last tabs. When there are more tabs than fit, small arrow buttons at the ends of the row scroll the tabs into view.</p>
</div>
</div>
<div class="sect4">
<h5 id="desktop-trees"><a class="anchor" href="#desktop-trees"></a>Trees</h5>
<div class="paragraph">
<p><a id="_ix427" class="ixterm"></a><a id="_ix428" class="ixterm"></a>A tree shows items inside other items, like folders inside folders. Click the small box beside an item to open it (+) or close it (-), or double-click the item. With the keyboard:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><kbd>Up</kbd> and <kbd>Down</kbd> move through the items.</p>
</li>
<li>
<p><kbd>Right</kbd> opens a closed item, or moves into an open one.</p>
</li>
<li>
<p><kbd>Left</kbd> closes an open item, or moves to the item it is in.</p>
</li>
<li>
<p><kbd>Enter</kbd> opens or closes an item that holds others, or uses an item that does not.</p>
</li>
<li>
<p>Typing the first letters of an item jumps to it, the same way as in a list (see <a href="#desktop-lists">Section 5.5.3.6</a>); only the items you can see (in open branches) count.</p>
</li>
</ul>
</div>
</div>
</div>
<div class="sect3">
<h4 id="desktop-other-dialogs"><a class="anchor" href="#desktop-other-dialogs"></a>5.5.4. Dialog boxes that many programs share</h4>
<div class="paragraph">
<p><a id="_ix429" class="ixterm"></a>Besides message boxes and the Open and Save dialog boxes (see <a href="#desktop-file-dialogs">Section 5.6</a>), several programs use these same dialog boxes:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Input boxes</strong></dt>
<dd>
<p><a id="_ix430" class="ixterm"></a>A question and one text box to type the answer in, with <b class="button">OK</b> and <b class="button">Cancel</b>.</p>
</dd>
<dt class="hdlist1"><strong>Number boxes</strong></dt>
<dd>
<p>A question and a number box, with <b class="button">OK</b> and <b class="button">Cancel</b>.</p>
</dd>
<dt class="hdlist1"><strong>Lists to choose from</strong></dt>
<dd>
<p><a id="_ix431" class="ixterm"></a>A question and a list. Select an item and click <b class="button">OK</b>, or double-click the item, or press <kbd>Enter</kbd>. <b class="button">OK</b> does nothing until an item is selected.</p>
</dd>
<dt class="hdlist1"><strong>Font</strong></dt>
<dd>
<p><a id="_ix432" class="ixterm"></a><a id="_ix433" class="ixterm"></a>The <strong>Font</strong>, <strong>Font style</strong>, and <strong>Size</strong> lists, the <strong>Underline</strong> and <strong>Strikeout</strong> check boxes, a <strong>Sample</strong> of the chosen font, and a <b class="button">Licence&#8230;&#8203;</b> button that shows the font&#8217;s licence.</p>
</dd>
<dt class="hdlist1"><strong>Color</strong></dt>
<dd>
<p><a id="_ix434" class="ixterm"></a>A palette of colors to pick from, <strong>Red</strong>, <strong>Green</strong>, and <strong>Blue</strong> sliders with number boxes for mixing your own, and a preview of the color.</p>
</dd>
</dl>
</div>
</div>
</div>
<div class="sect2">
<h3 id="desktop-file-dialogs"><a class="anchor" href="#desktop-file-dialogs"></a>5.6. Opening and saving files</h3>
<div class="paragraph">
<p><a id="_ix435" class="ixterm"></a><a id="_ix436" class="ixterm"></a><a id="_ix437" class="ixterm"></a><a id="_ix438" class="ixterm"></a><a id="_ix439" class="ixterm"></a><a id="_ix440" class="ixterm"></a><a id="_ix441" class="ixterm"></a>Every program that opens or saves files uses the same dialog boxes: <strong>Open</strong> to open a file, <strong>Save As</strong> to save one, and <strong>Choose a Folder</strong> where a program needs a folder rather than a file. (A program can give them a title of its own, such as <strong>Save Screenshot</strong>.) The <strong>Browse&#8230;&#8203;</strong> buttons in programs open these dialog boxes too.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/dtOpen.png" alt="The top of the Open dialog box: the Path box showing c:\dvx, the Drive list open with drives A:, C:, Y:, and Z:, and the folder list">
</div>
<div class="title">Figure 23. The top of the Open dialog box, with the Drive list open</div>
</div>
<div class="sect3">
<h4 id="desktop-file-dialog-parts"><a class="anchor" href="#desktop-file-dialog-parts"></a>5.6.1. Parts of the dialog box</h4>
<div class="paragraph">
<p><a id="_ix442" class="ixterm"></a>From top to bottom, the dialog box has these parts:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Path</strong></dt>
<dd>
<p><a id="_ix443" class="ixterm"></a>The folder you are looking at. Type another folder here and press <kbd>Enter</kbd> to go there (see <a href="#desktop-typing-paths">Section 5.6.5</a>).</p>
</dd>
<dt class="hdlist1"><strong>Drive</strong></dt>
<dd>
<p><a id="_ix444" class="ixterm"></a>Beside the Path box: the drive of the folder you are looking at. Choose another drive to go to its top folder (see <a href="#desktop-drives">Section 5.6.7</a>).</p>
</dd>
<dt class="hdlist1">The list</dt>
<dd>
<p><a id="_ix445" class="ixterm"></a>The folders, in square brackets such as <code>[DOCS]</code>, then the files, each in alphabetical order. <code>[..]</code> takes you up one folder. Only files that match the <strong>Filter</strong> are listed; folders always are.</p>
</dd>
<dt class="hdlist1"><strong>Filter</strong></dt>
<dd>
<p><a id="_ix446" class="ixterm"></a><a id="_ix447" class="ixterm"></a>Chooses which kinds of files the list shows, for example &#8220;Text Files (*.txt)&#8221;. Choosing another filter lists the folder again. Only some programs offer filters, and the Choose a Folder dialog box has none.</p>
</dd>
<dt class="hdlist1"><strong>File name</strong></dt>
<dd>
<p>The name of the file to open or save. The Choose a Folder dialog box has <strong>Folder name</strong> here.</p>
</dd>
<dt class="hdlist1">Buttons</dt>
<dd>
<p><b class="button">Open</b> in the Open dialog box, <b class="button">Save</b> in the Save As dialog box, or <b class="button">OK</b> in the Choose a Folder dialog box; and <b class="button">Cancel</b>.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>With the keyboard, <span class="keyseq"><kbd>Alt</kbd>+<kbd>P</kbd></span> goes to the <strong>Path</strong> box and <span class="keyseq"><kbd>Alt</kbd>+<kbd>N</kbd></span> to the <strong>File name</strong> (or <strong>Folder name</strong>) box; <span class="keyseq"><kbd>Alt</kbd>+<kbd>D</kbd></span> opens the <strong>Drive</strong> list and <span class="keyseq"><kbd>Alt</kbd>+<kbd>I</kbd></span> the <strong>Filter</strong> list.</p>
</div>
</div>
<div class="sect3">
<h4 id="desktop-opening-file"><a class="anchor" href="#desktop-opening-file"></a>5.6.2. Opening a file</h4>
<div class="paragraph">
<p><a id="_ix448" class="ixterm"></a>To open a file:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Choose the program&#8217;s open command, usually <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Open&#8230;&#8203;</b></span>.</p>
</li>
<li>
<p>Go to the folder that holds the file: double-click a folder in the list to look inside it, or double-click <code>[..]</code> to go up one folder.</p>
</li>
<li>
<p>Click the file. Its name appears in the <strong>File name</strong> box.</p>
</li>
<li>
<p>Click <b class="button">Open</b>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>Double-clicking the file (or selecting it and pressing <kbd>Enter</kbd>) opens it at once. You can also type the file&#8217;s name in the <strong>File name</strong> box and click <b class="button">Open</b>.</p>
</div>
<div class="paragraph">
<p><a id="_ix449" class="ixterm"></a><a id="_ix450" class="ixterm"></a>The Open dialog box opens only a file that is there. If you type the name of a file that does not exist, a box titled <strong>File Not Found</strong> says &#8220;<em>name</em> does not exist. Check the file name and try again.&#8221; Click <b class="button">OK</b> and choose again. To start a new file, use the program&#8217;s command for a new file (usually <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">New</b></span>) and give it its name when you save it.</p>
</div>
<div class="paragraph">
<p><a id="_ix451" class="ixterm"></a>A program that makes new files from its Open dialog box, such as DVX BASIC with <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Add File&#8230;&#8203;</b></span>, asks instead: a <strong>Confirm Create</strong> message says &#8220;<em>name</em> does not exist. Do you want to create it?&#8221; Click <b class="button">Yes</b> to go on with a new file of that name, or <b class="button">No</b> to choose again.</p>
</div>
</div>
<div class="sect3">
<h4 id="desktop-saving-file"><a class="anchor" href="#desktop-saving-file"></a>5.6.3. Saving a file</h4>
<div class="paragraph">
<p><a id="_ix452" class="ixterm"></a>To save a file under a new name:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Choose the program&#8217;s save command, usually <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Save As&#8230;&#8203;</b></span>.</p>
</li>
<li>
<p>Go to the folder you want, as in the Open dialog box.</p>
</li>
<li>
<p>Type a name in the <strong>File name</strong> box.</p>
</li>
<li>
<p>Click <b class="button">Save</b>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p><a id="_ix453" class="ixterm"></a>If you leave off the ending of the name (such as <code>.txt</code>), the dialog box adds the ending of the chosen filter. Nothing is added when the filter is <code>*.*</code>.</p>
</div>
<div class="paragraph">
<p><a id="_ix454" class="ixterm"></a>If a file of that name is already there, a <strong>Confirm Save</strong> message asks &#8220;<em>name</em> already exists. Do you want to replace it?&#8221; Click <b class="button">Yes</b> to replace the old file, or <b class="button">No</b> to choose another name.</p>
</div>
</div>
<div class="sect3">
<h4 id="desktop-choosing-folder"><a class="anchor" href="#desktop-choosing-folder"></a>5.6.4. Choosing a folder</h4>
<div class="paragraph">
<p><a id="_ix455" class="ixterm"></a>The <strong>Choose a Folder</strong> dialog box works like the Open dialog box, but lists folders only. Go into the folder you want and click <b class="button">OK</b>: with the <strong>Folder name</strong> box empty, that folder is the one chosen.</p>
</div>
<div class="paragraph">
<p>To choose a folder that does not exist yet, type its name in the <strong>Folder name</strong> box (or a full path, such as <code>C:\GAMES\NEW</code>) and click <b class="button">OK</b>; the program makes the folder when it needs it. When a program suggests a folder that does not exist yet, the dialog box opens at the nearest folder above it that does, with the rest of the path already in the <strong>Folder name</strong> box.</p>
</div>
<div class="paragraph">
<p><a id="_ix456" class="ixterm"></a>If the name cannot be a folder, an <strong>Invalid Folder</strong> message says why, for example &#8220;<em>path</em> is a file, not a folder.&#8221;</p>
</div>
</div>
<div class="sect3">
<h4 id="desktop-typing-paths"><a class="anchor" href="#desktop-typing-paths"></a>5.6.5. Typing a path</h4>
<div class="paragraph">
<p><a id="_ix457" class="ixterm"></a><a id="_ix458" class="ixterm"></a>You can type where to go instead of clicking through folders:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>In the <strong>Path</strong> box, type a folder and press <kbd>Enter</kbd>. It can be a full path (<code>C:\DOCS</code>), a folder inside the one shown (<code>LETTERS</code>), <code>..</code> for the folder above, or a drive letter and colon (<code>D:</code>). If there is no such folder, nothing happens.</p>
</li>
<li>
<p>In the <strong>File name</strong> box, type a name with a folder or drive in front of it, such as <code>..\NOTES.TXT</code> or <code>C:\DOCS\NOTES.TXT</code>, and click <b class="button">Open</b> or <b class="button">Save</b>. The dialog box goes to that folder and then opens or saves the file there, as if you had typed just its name. If the folder does not exist, an <strong>Invalid Path</strong> message says &#8220;The folder does not exist.&#8221;</p>
</li>
<li>
<p>Type the name of a folder in the <strong>File name</strong> box and click <b class="button">Open</b> or <b class="button">Save</b> to go into that folder.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p><a id="_ix459" class="ixterm"></a>You can type <code>/</code> in place of <code>\</code> anywhere you type a path in DVX: <code>C:/DOCS/NOTES.TXT</code> works the same as <code>C:\DOCS\NOTES.TXT</code>. Once the dialog box has gone to a folder, the Path box shows its full path with <code>\</code>.</p>
</div>
</div>
<div class="sect3">
<h4 id="desktop-file-names"><a class="anchor" href="#desktop-file-names"></a>5.6.6. File names</h4>
<div class="paragraph">
<p><a id="_ix460" class="ixterm"></a><a id="_ix461" class="ixterm"></a><a id="_ix462" class="ixterm"></a>DVX uses long file names on disks and DOS versions that support them, and the usual DOS names otherwise: up to eight characters, then a dot and an ending of up to three, such as <code>LETTER01.TXT</code>.</p>
</div>
<div class="paragraph">
<p><a id="_ix463" class="ixterm"></a>If a name breaks the rules, an <strong>Invalid Filename</strong> message says which rule:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 33.3333%;">
<col style="width: 66.6667%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Message</th>
<th class="tableblock halign-left valign-top">Meaning</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Filename must not be empty.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Type a name.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Filename must be 255 characters or fewer.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A long file name is too long.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Filename must be 1-8 characters before the extension.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">On a disk without long file names, the part before the dot must have from one to eight characters.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Filename may contain only one dot.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">On a disk without long file names, a name has at most one dot.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Extension must be 3 characters or fewer.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">On a disk without long file names, the ending is too long.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Filename contains invalid characters.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The name has a character that file names cannot have.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Filename must not end with a dot or a space.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Remove the dot or space at the end.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;That name is reserved.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">On a disk with long file names, the name is <code>.</code> or <code>..</code>, which DOS keeps for a folder itself and the folder above it.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;That name is a reserved device name.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DOS uses that name for a device (for example <code>CON</code>, <code>PRN</code>, or <code>NUL</code>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The name is too long for this folder.&#8221; or &#8220;The path is too long.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The folder and the name together are too long. Choose a shorter name, or a folder nearer the top of the drive.</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect3">
<h4 id="desktop-drives"><a class="anchor" href="#desktop-drives"></a>5.6.7. Drives</h4>
<div class="paragraph">
<p><a id="_ix464" class="ixterm"></a><a id="_ix465" class="ixterm"></a>The <strong>Drive</strong> list shows every drive DOS knows about, as <code>A:</code>, <code>C:</code>, and so on, and always shows the drive you are looking at. Choose a drive to go to its top folder. The list does not check whether each drive has a disk in it.</p>
</div>
<div class="paragraph">
<p>If the drive you choose cannot be read, for example a floppy drive with no disk in it, a <strong>Drive Not Ready</strong> message says &#8220;Drive <em>X</em>: is not ready.&#8221; and the dialog box stays where it was. Put a disk in and choose the drive again.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/dtDriveNotReady.png" alt="A message box titled Drive Not Ready, with an error picture and the text Drive A: is not ready.">
</div>
<div class="title">Figure 24. The message for an empty drive</div>
</div>
</div>
</div>
<div class="sect2">
<h3 id="desktop-clipboard"><a class="anchor" href="#desktop-clipboard"></a>5.7. Copying and pasting</h3>
<div class="paragraph">
<p><a id="_ix466" class="ixterm"></a><a id="_ix467" class="ixterm"></a><a id="_ix468" class="ixterm"></a>The <em>clipboard</em> is a holding place for text. Cut or Copy puts text on it, and Paste takes it back out. There is one clipboard for every program, so you can copy text in one program and paste it into another. The clipboard keeps its text until you cut or copy something else, so you can paste the same text many times.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">Command</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix469" class="ixterm"></a><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>X</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Cut</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Removes the selected text and puts it on the clipboard.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix470" class="ixterm"></a><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>C</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Copy</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Puts a copy of the selected text on the clipboard.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix471" class="ixterm"></a><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>V</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Paste</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Puts the clipboard&#8217;s text where the cursor is. If text is selected, the pasted text replaces it.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>These keys work in every text box. The older DOS keys <span class="keyseq"><kbd>Shift</kbd>+<kbd>Del</kbd></span>, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Ins</kbd></span>, and <span class="keyseq"><kbd>Shift</kbd>+<kbd>Ins</kbd></span> do not. Many programs have the same commands in their <b class="menuref">Edit</b> menu, and some on a right-click menu. Password boxes do not let you cut or copy.</p>
</div>
<div class="paragraph">
<p><a id="_ix472" class="ixterm"></a>To copy text from one program to another:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Select the text in the first program, by dragging across it or with <kbd>Shift</kbd> and the arrow keys.</p>
</li>
<li>
<p>Press <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>C</kbd></span>.</p>
</li>
<li>
<p>Switch to the other program: click its window, or press <span class="keyseq"><kbd>Alt</kbd>+<kbd>Tab</kbd></span>.</p>
</li>
<li>
<p>Click where the text should go, and press <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>V</kbd></span>.</p>
</li>
</ol>
</div>
</div>
<div class="sect2">
<h3 id="desktop-screenshots"><a class="anchor" href="#desktop-screenshots"></a>5.8. Saving a picture of the screen</h3>
<div class="paragraph">
<p><a id="_ix473" class="ixterm"></a><a id="_ix474" class="ixterm"></a>DVX can save a picture of the screen, or of one window, in a picture file:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><a id="_ix475" class="ixterm"></a><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>F12</kbd></span>, or <strong>Screenshot&#8230;&#8203;</strong> in any window menu, saves a picture of the whole screen. A <strong>Save Screenshot</strong> dialog box asks for the file.</p>
</li>
<li>
<p><a id="_ix476" class="ixterm"></a><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>F12</kbd></span>, or <strong>Window Shot&#8230;&#8203;</strong> in a window menu, saves a picture of the inside of the active window (or of the window whose menu you used), without its title bar, frame, and menu bar. A <strong>Save Window Screenshot</strong> dialog box asks for the file.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>The picture is taken the moment you press the keys, before the dialog box appears, so the picture shows the screen as it was. With the window menu&#8217;s <strong>Screenshot&#8230;&#8203;</strong>, the picture shows the screen without the open menu.</p>
</div>
<div class="paragraph">
<p>To save the picture:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Press <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>F12</kbd></span> (or <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>F12</kbd></span>).</p>
</li>
<li>
<p>In the dialog box, go to the folder where you want the picture.</p>
</li>
<li>
<p>Type a name for the picture, such as <code>MYSCREEN.PNG</code>.</p>
</li>
<li>
<p>Click <b class="button">Save</b>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p><a id="_ix477" class="ixterm"></a>The picture goes in the folder and file you chose. A name ending in <code>.bmp</code> saves a BMP picture; any other name saves a PNG picture. If you leave off the ending, the ending of the chosen <strong>Filter</strong> is added: &#8220;PNG Images (*.png)&#8221; (the first choice) or &#8220;BMP Images (*.bmp)&#8221;. Image Viewer can show either kind (see <a href="#programs-image-viewer">Section 8.6</a>).</p>
</div>
<div class="paragraph">
<p><a id="_ix478" class="ixterm"></a>If something goes wrong, a message says &#8220;Not enough memory to capture the image.&#8221; or &#8220;The image could not be saved.&#8221;</p>
</div>
<div class="paragraph">
<p>These keys do not work while a program uses the whole screen (see <a href="#desktop-full-screen">Section 5.14</a>); the program gets the keys instead.</p>
</div>
</div>
<div class="sect2">
<h3 id="desktop-keys"><a class="anchor" href="#desktop-keys"></a>5.9. Keys that work in every program</h3>
<div class="paragraph">
<p><a id="_ix479" class="ixterm"></a><a id="_ix480" class="ixterm"></a>These keys work the same in every program:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 28.5714%;">
<col style="width: 71.4286%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix481" class="ixterm"></a><span class="keyseq"><kbd>Alt</kbd>+<kbd>Tab</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Switch to the next window: the active window goes to the back. Minimized windows are skipped. Does nothing while a dialog box is open.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix482" class="ixterm"></a><span class="keyseq"><kbd>Shift</kbd>+<kbd>Alt</kbd>+<kbd>Tab</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Switch the other way: the window at the back comes to the front.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix483" class="ixterm"></a><span class="keyseq"><kbd>Alt</kbd>+<kbd>F4</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Close the active window. While a dialog box is open, close only the dialog box.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix484" class="ixterm"></a><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Esc</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Open the Task Manager, or bring it to the front (see <a href="#desktop-task-manager">Section 5.10</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix485" class="ixterm"></a><kbd>F1</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Open help for the program you are using (see <a href="#desktop-help">Section 5.11</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F10</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Open the first menu of the active window, or close the open menu.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix486" class="ixterm"></a><span class="keyseq"><kbd>Alt</kbd>+<kbd>Space</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Open or close the window menu of the active window.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Alt</kbd> + a letter</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Open the menu whose underlined letter you typed; otherwise move to, or press, the control with that underlined letter.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Tab</kbd>, <span class="keyseq"><kbd>Shift</kbd>+<kbd>Tab</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Move to the next or previous control.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Enter</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Press the highlighted button, or the main button of a dialog box or of a window that has one (such as Control Panel&#8217;s <b class="button">OK</b>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Esc</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Close a menu or a drop-down list, or press <b class="button">Cancel</b> in a dialog box or a window that has one (such as Control Panel).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>F12</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Save a picture of the whole screen (see <a href="#desktop-screenshots">Section 5.8</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>F12</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Save a picture of the inside of the active window.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Shortcut keys of Program Manager items</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Start that item, whichever window is in front (see <a href="#progman-shortcut-keys">Section 6.4.4</a>).</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><span class="keyseq"><kbd>Alt</kbd>+<kbd>Tab</kbd></span>, <span class="keyseq"><kbd>Alt</kbd>+<kbd>F4</kbd></span>, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Esc</kbd></span>, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>F12</kbd></span>, and <span class="keyseq"><kbd>Alt</kbd>+<kbd>Space</kbd></span> do the same with <kbd>Ctrl</kbd>, <kbd>Alt</kbd>, or <kbd>Shift</kbd> held as well: <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>F4</kbd></span> closes the active window, and <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Esc</kbd></span> and <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Esc</kbd></span> open the Task Manager. DVX acts on these keys before any program sees them, so no program and no Program Manager item can use them (see <a href="#progman-shortcut-keys">Section 6.4.4</a>).</p>
</div>
<div class="paragraph">
<p>The keys for editing text are listed in <a href="#desktop-text-boxes">Section 5.5.3.4</a>, and the clipboard keys in <a href="#desktop-clipboard">Section 5.7</a>. Programs have shortcut keys of their own, shown at the right edge of their menus and listed in their help.</p>
</div>
<div class="paragraph">
<p><a id="_ix487" class="ixterm"></a>While a program uses the whole screen, only <span class="keyseq"><kbd>Alt</kbd>+<kbd>Tab</kbd></span>, <span class="keyseq"><kbd>Shift</kbd>+<kbd>Alt</kbd>+<kbd>Tab</kbd></span>, <span class="keyseq"><kbd>Alt</kbd>+<kbd>F4</kbd></span>, and <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Esc</kbd></span> work as described here; every other key goes to the program (see <a href="#desktop-full-screen">Section 5.14</a>).</p>
</div>
</div>
<div class="sect2">
<h3 id="desktop-task-manager"><a class="anchor" href="#desktop-task-manager"></a>5.10. Task Manager</h3>
<div class="paragraph">
<p><a id="_ix488" class="ixterm"></a>The Task Manager lists every program that is running. Use it to switch to a program, to stop a program that has stopped responding, or to start another program.</p>
</div>
<div class="paragraph">
<p><a id="_ix489" class="ixterm"></a><a id="_ix490" class="ixterm"></a>To open it, press <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Esc</kbd></span> from any program (even one that uses the whole screen), or choose <span class="menuseq"><b class="menu">Help</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Task Manager</b></span> in Program Manager. There is only one Task Manager: if it is already open, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Esc</kbd></span> brings it to the front. The Task Manager is part of DVX itself, so it works even when Program Manager is not running.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/dtTaskManager.png" alt="The Task Manager window, listing Program Manager and Notepad with their title, file, type, memory, and status, above the Switch To, End Task, and Run buttons">
</div>
<div class="title">Figure 25. The Task Manager</div>
</div>
<div class="sect3">
<h4 id="desktop-task-manager-list"><a class="anchor" href="#desktop-task-manager-list"></a>5.10.1. The list of programs</h4>
<div class="paragraph">
<p><a id="_ix491" class="ixterm"></a>Each row is one running program. The Task Manager does not list itself; Program Manager is listed, and should be left running, because it is the desktop. The columns are:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Name</strong></dt>
<dd>
<p>The program&#8217;s name.</p>
</dd>
<dt class="hdlist1"><strong>Title</strong></dt>
<dd>
<p>The title of the program&#8217;s first window.</p>
</dd>
<dt class="hdlist1"><strong>File</strong></dt>
<dd>
<p>The name of the program&#8217;s file.</p>
</dd>
<dt class="hdlist1"><strong>Type</strong></dt>
<dd>
<p><a id="_ix492" class="ixterm"></a>&#8220;Task&#8221; for a program that keeps running on its own between the things you do, or &#8220;Callback&#8221; for one that runs only when something happens in its windows, such as a click or a key press. You do not need to do anything about it.</p>
</dd>
<dt class="hdlist1"><strong>Memory</strong></dt>
<dd>
<p><a id="_ix493" class="ixterm"></a>How much memory the program is using, in KB, or in MB from 1 MB up.</p>
</dd>
<dt class="hdlist1"><strong>Status</strong></dt>
<dd>
<p><a id="_ix494" class="ixterm"></a><a id="_ix495" class="ixterm"></a>&#8220;Running&#8221;, or &#8220;Not responding&#8221; for a program that has been busy for 5 seconds or more without coming back to DVX. A program that is only waiting for you to answer one of its own dialog boxes is not counted as not responding. While the Task Manager is open, it checks every second.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>The list is a list with columns: click a heading to sort by that column (see <a href="#desktop-lists">Section 5.5.3.6</a>). It keeps itself up to date as programs start and end.</p>
</div>
<div class="paragraph">
<p><a id="_ix496" class="ixterm"></a><a id="_ix497" class="ixterm"></a>The line at the bottom says how many programs are running and how much memory is in use, for example &#8220;Applications: 2 Memory: 4/30 MB&#8221;: 4 MB of the computer&#8217;s 30 MB are in use.</p>
</div>
</div>
<div class="sect3">
<h4 id="desktop-task-manager-buttons"><a class="anchor" href="#desktop-task-manager-buttons"></a>5.10.2. The buttons</h4>
<div class="paragraph">
<p>No program is selected when the Task Manager opens, and the buttons do nothing until you select one: click a row first (or use <kbd>Up</kbd> and <kbd>Down</kbd>).</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Switch To</strong></dt>
<dd>
<p><a id="_ix498" class="ixterm"></a>Brings the selected program&#8217;s front window forward and makes it active. A minimized window is restored; a maximized window stays maximized. Double-clicking a row, or pressing <kbd>Enter</kbd> on it, does the same.</p>
</dd>
<dt class="hdlist1"><strong>End Task</strong></dt>
<dd>
<p><a id="_ix499" class="ixterm"></a><a id="_ix500" class="ixterm"></a>Ends the selected program at once. The other programs keep running, and the selection moves to the row that took its place. Program Manager is the exception (see below).</p>
</dd>
<dt class="hdlist1"><strong>Run&#8230;&#8203;</strong></dt>
<dd>
<p><a id="_ix501" class="ixterm"></a>Opens the <strong>Run</strong> dialog box to start a program or open a document by typing its name (see <a href="#progman-run">Section 6.7</a>). Unlike Program Manager&#8217;s, this Run dialog box does not list the commands you ran before.</p>
</dd>
</dl>
</div>
<div class="admonitionblock warning">
<table>
<tr>
<td class="icon">
<div class="title">Warning</div>
</td>
<td class="content">
End Task does not ask first, and does not give the program a chance to save. Any unsaved work in that program is lost.
</td>
</tr>
</table>
</div>
<div class="paragraph">
<p><a id="_ix502" class="ixterm"></a><a id="_ix503" class="ixterm"></a><a id="_ix504" class="ixterm"></a>Ending Program Manager exits DVX, so DVX asks first, in a box titled <strong>Exit DVX</strong>: &#8220;Are you sure you want to exit DVX?&#8221; Click <b class="button">No</b> to leave everything running. Click <b class="button">Yes</b> to exit DVX as <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Exit DVX</b></span> does: every other program is closed as if you had closed it, and asks about work it has not saved (see <a href="#desktop-exit">Section 5.16</a>). If you click <b class="button">Cancel</b> in one of those questions, DVX keeps running, with Program Manager. A Program Manager that has stopped responding is ended at once instead, and DVX then exits the same way.</p>
</div>
</div>
<div class="sect3">
<h4 id="desktop-not-responding"><a class="anchor" href="#desktop-not-responding"></a>5.10.3. When a program stops responding</h4>
<div class="paragraph">
<p><a id="_ix505" class="ixterm"></a><a id="_ix506" class="ixterm"></a>If a program stops reacting to the mouse and the keyboard:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Press <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Esc</kbd></span> to open the Task Manager.</p>
</li>
<li>
<p>Wait a few seconds. The program&#8217;s <strong>Status</strong> changes to &#8220;Not responding&#8221;.</p>
</li>
<li>
<p>Click the program&#8217;s row.</p>
</li>
<li>
<p>Click <b class="button">End Task</b>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>If the whole screen is frozen and even the pointer does not move, DVX cannot recover: restart the computer. See also <a href="#trouble-programs">Section 11.13</a>.</p>
</div>
<div class="paragraph">
<p><a id="_ix507" class="ixterm"></a><a id="_ix508" class="ixterm"></a>If a program makes a serious mistake, DVX ends it and shows an <strong>Application Error</strong> message: &#8220;'<em>name</em>' has caused a fault and will be terminated.&#8221; Click <b class="button">OK</b>. Your other programs keep running, but unsaved work in the program that was ended is lost.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="desktop-help"><a class="anchor" href="#desktop-help"></a>5.11. Getting help</h3>
<div class="paragraph">
<p><a id="_ix509" class="ixterm"></a><a id="_ix510" class="ixterm"></a><a id="_ix511" class="ixterm"></a>Help opens in the <strong>DVX Help</strong> window. There are three ways to open it:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>Press <kbd>F1</kbd>. Help opens for the program whose window is active, at the page that program chooses for what you are doing. A program without help of its own, or a window that belongs to DVX itself such as the Task Manager, opens the general DVX help instead.</p>
</li>
<li>
<p>Choose <span class="menuseq"><b class="menu">Help</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Contents</b></span> (or a similar command) in a program&#8217;s <b class="menuref">Help</b> menu.</p>
</li>
<li>
<p><a id="_ix512" class="ixterm"></a>In Program Manager, <kbd>F1</kbd> and <span class="menuseq"><b class="menu">Help</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Contents</b></span> open Program Manager&#8217;s own help, and <span class="menuseq"><b class="menu">Help</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">DVX Help</b></span> opens the general DVX help: a short guide to the desktop, settings, and troubleshooting.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>If DVX Help is already open, <kbd>F1</kbd> shows the new page in the same window and brings it to the front. <kbd>F1</kbd> in the DVX Help window shows help about DVX Help itself. If a help file cannot be read, a message says &#8220;Could not open help file.&#8221;</p>
</div>
<div class="paragraph">
<p><a href="#programs-help">Section 8.9</a> explains the DVX Help window: the table of contents, links, Back and Forward, the index, and searching.</p>
</div>
<div class="paragraph">
<p>The <b class="menuref">Help</b> menu of most programs also has an <strong>About</strong> command, which shows the program&#8217;s name and copyright.</p>
</div>
</div>
<div class="sect2">
<h3 id="desktop-screen-saver"><a class="anchor" href="#desktop-screen-saver"></a>5.12. The screen saver</h3>
<div class="paragraph">
<p><a id="_ix513" class="ixterm"></a>A screen saver fills the screen with a moving picture after the computer has not been used for a while. No screen saver is set when DVX is installed. Choose one, and how many minutes to wait (from 1 to 60; 10 at first), on the Desktop page of Control Panel (see <a href="#cpanel-desktop">Section 7.6</a>). <a href="#programs-screen-savers">Section 8.12</a> describes the screen savers that come with DVX.</p>
</div>
<div class="paragraph">
<p><a id="_ix514" class="ixterm"></a>The screen saver starts when no key has been pressed and the mouse has not moved for the number of minutes you chose. It never starts while a dialog box is open or while a program uses the whole screen. After a screen saver ends, the next one starts no sooner than the same wait.</p>
</div>
<div class="paragraph">
<p><a id="_ix515" class="ixterm"></a>To bring your work back, press any key or move the mouse. Keys and mouse movements in the first second after the screen saver starts are ignored, so a nudge of the mouse just as it starts does not end it at once.</p>
</div>
</div>
<div class="sect2">
<h3 id="desktop-sounds"><a class="anchor" href="#desktop-sounds"></a>5.13. Desktop sounds</h3>
<div class="paragraph">
<p><a id="_ix516" class="ixterm"></a><a id="_ix517" class="ixterm"></a>DVX plays a short sound when certain things happen, if your computer has sound hardware. These are the events, with their names on the Sounds page of Control Panel and the sounds DVX comes with:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 25%;">
<col style="width: 50%;">
<col style="width: 25%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Event</th>
<th class="tableblock halign-left valign-top">When it plays</th>
<th class="tableblock halign-left valign-top">Sound at first</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Default beep</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A program beeps, or a message box without a picture opens.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>beep.wav</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Start DVX</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The desktop has loaded.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>startup.wav</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Exit DVX</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX is about to return to DOS. DVX waits up to 5 seconds for the sound to finish.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>exit.wav</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Error</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">An error message opens.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>error.wav</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Warning</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A warning message opens.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>warning.wav</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Question</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A question opens.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>question.wav</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Information</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">An information message opens.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>info.wav</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Open window</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A program opens a window (not a dialog box).</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">none</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Close window</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A program closes a window (not a dialog box).</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">none</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>Dialog boxes, programs that use the whole screen, and screen savers make no open or close sound. To choose other sounds, turn one off, or set the volume, see <a href="#cpanel-sounds">Section 7.12</a>. Without sound hardware, DVX works the same, silently.</p>
</div>
</div>
<div class="sect2">
<h3 id="desktop-full-screen"><a class="anchor" href="#desktop-full-screen"></a>5.14. Programs that use the whole screen</h3>
<div class="paragraph">
<p><a id="_ix518" class="ixterm"></a><a id="_ix519" class="ixterm"></a>Some programs, games especially, can use the whole screen instead of a window. How you switch a program to the whole screen depends on the program; see its help. Your other programs keep running meanwhile.</p>
</div>
<div class="paragraph">
<p><a id="_ix520" class="ixterm"></a>While such a program has the screen, it gets the mouse and every key except these, which DVX keeps:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><span class="keyseq"><kbd>Alt</kbd>+<kbd>Tab</kbd></span> and <span class="keyseq"><kbd>Shift</kbd>+<kbd>Alt</kbd>+<kbd>Tab</kbd></span> switch to another window, which brings the desktop back.</p>
</li>
<li>
<p><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Esc</kbd></span> opens the Task Manager, which brings the desktop back.</p>
</li>
<li>
<p><span class="keyseq"><kbd>Alt</kbd>+<kbd>F4</kbd></span> asks the program to close.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>All other keys, <kbd>F1</kbd>, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>F12</kbd></span>, and Program Manager&#8217;s shortcut keys included, go to the program. The same is true of some games that run in a window and take every key.</p>
</div>
<div class="paragraph">
<p>When the program is no longer the active window (because you pressed <span class="keyseq"><kbd>Alt</kbd>+<kbd>Tab</kbd></span> or <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Esc</kbd></span>, a dialog box opened, or the program&#8217;s window was minimized), the desktop comes back and the program waits. When its window is active again, the program fills the screen again. If its screen mode cannot be set again, the program goes back to a window.</p>
</div>
<div class="paragraph">
<p>While a program has the whole screen, no tooltips appear, the screen saver does not start, and the screen resolution cannot be changed.</p>
</div>
</div>
<div class="sect2">
<h3 id="desktop-dos-programs"><a class="anchor" href="#desktop-dos-programs"></a>5.15. Running DOS programs</h3>
<div class="paragraph">
<p><a id="_ix521" class="ixterm"></a><a id="_ix522" class="ixterm"></a>DVX can also run ordinary DOS programs: files whose names end in <code>.EXE</code>, <code>.COM</code>, or <code>.BAT</code>, such as games, editors, and batch files. You can start one:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>from a Program Manager item (see <a href="#progman-dos">Section 6.8</a>, which also explains the item&#8217;s settings);</p>
</li>
<li>
<p>with Program Manager&#8217;s <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Run&#8230;&#8203;</b></span> or the Task Manager&#8217;s <b class="button">Run&#8230;&#8203;</b> (see <a href="#progman-run">Section 6.7</a>);</p>
</li>
<li>
<p>by opening a document whose file type is set to open in a DOS program (see <a href="#cpanel-file-types">Section 7.8</a>), for example by double-clicking it in File Manager.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p><a id="_ix523" class="ixterm"></a><a id="_ix524" class="ixterm"></a>A DOS program needs the computer to itself, so DVX closes your other programs first. If any program other than Program Manager is running, a <strong>Run DOS Program</strong> message names them and asks: &#8220;Running <em>name</em> closes these programs first:&#8221; followed by the list, then &#8220;Each one asks about unsaved work as it closes. Continue?&#8221;</p>
</div>
<div class="ulist">
<ul>
<li>
<p>Click <b class="button">Yes</b> to go on. Each program then closes as if you had closed it yourself, and a program with unsaved work asks whether to save it.</p>
</li>
<li>
<p>Click <b class="button">No</b> to keep everything as it is. The DOS program does not run.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>If you choose <b class="button">Cancel</b> when a program asks about saving its work, that program stays open and the DOS program does not run; programs that had already closed stay closed. When nothing but Program Manager is running, the DOS program runs without asking.</p>
</div>
<div class="paragraph">
<p><a id="_ix525" class="ixterm"></a>While the DOS program runs:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>The screen changes to the usual 80-column DOS text screen (the program may then change it).</p>
</li>
<li>
<p>The program has the keyboard, the mouse, and the sound card to itself.</p>
</li>
<li>
<p>The program runs in the working folder of its Program Manager item, or else in the folder it is in. A program file with a long name is started by its short DOS name.</p>
</li>
<li>
<p>DVX stays in memory, so the program has less memory than it would have without DVX. A program that needs a great deal of memory is best started from DOS after you leave DVX.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p><a id="_ix526" class="ixterm"></a>When the program ends, the DVX screen comes back with the pointer where it was. If the Program Manager item has <strong>Wait for a key when a DOS program ends</strong> ticked, DVX first shows &#8220;Press any key to return to DVX.&#8221; on the DOS screen and waits for a key, so you can read what the program printed. The programs that were closed stay closed; start them again when you need them. Program Manager looks for programs that may have been installed or removed while the DOS program ran.</p>
</div>
<div class="paragraph">
<p><a id="_ix527" class="ixterm"></a><a id="_ix528" class="ixterm"></a>Messages:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>&#8220;Cannot find <em>path</em>.&#8221; (title <strong>Run DOS Program</strong>): the program was given with a folder, and there is no such file.</p>
</li>
<li>
<p>&#8220;DVX could not run <em>name</em>.&#8221; followed by the reason (title <strong>Run DOS Program</strong>): DVX could not start the program at all.</p>
</li>
</ul>
</div>
</div>
<div class="sect2">
<h3 id="desktop-exit"><a class="anchor" href="#desktop-exit"></a>5.16. Exiting DVX</h3>
<div class="paragraph">
<p><a id="_ix529" class="ixterm"></a><a id="_ix530" class="ixterm"></a><a id="_ix531" class="ixterm"></a>To leave DVX and return to the DOS prompt:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Exit DVX</b></span> in Program Manager, or close the Program Manager window (with its Close box, <span class="keyseq"><kbd>Alt</kbd>+<kbd>F4</kbd></span>, or <strong>Close</strong> in its window menu).</p>
</li>
<li>
<p>An <strong>Exit DVX</strong> message asks &#8220;Are you sure you want to exit DVX?&#8221; Click <b class="button">Yes</b> (or press <kbd>Enter</kbd>). <b class="button">No</b>, <kbd>Esc</kbd>, or the message&#8217;s Close box keeps DVX running.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p><a id="_ix532" class="ixterm"></a>DVX then closes every running program, one program at a time. Each window comes to the front and is closed as if you had closed it yourself, so a program with unsaved work asks whether to save it:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><b class="button">Yes</b> saves the work and <b class="button">No</b> throws it away; either way the program closes and DVX goes on to the next one.</p>
</li>
<li>
<p><b class="button">Cancel</b> keeps that program open and stops the exit. DVX keeps running: programs that had already closed stay closed, and the others keep running. Finish or save your work, then choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Exit DVX</b></span> again.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p><a id="_ix533" class="ixterm"></a><a id="_ix534" class="ixterm"></a>If a program shows nothing and has not closed its window after 5 seconds, an <strong>Exit DVX</strong> message says &#8220;'<em>name</em>' is not responding to the request to close. End it and continue exiting DVX?&#8221; Click <b class="button">Yes</b> to end the program (its unsaved work is lost) and go on, or <b class="button">No</b> to stop the exit and stay in DVX.</p>
</div>
<div class="paragraph">
<p>When every program has closed, the Exit DVX sound plays (DVX waits up to 5 seconds for it) and DVX returns to DOS.</p>
</div>
<div class="paragraph">
<p><a id="_ix535" class="ixterm"></a>When a program asks DVX to close another program, the same happens for that one program; a program that does not close brings a <strong>Close Program</strong> message: &#8220;'<em>name</em>' is not responding to the request to close. End it?&#8221;</p>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="programManager"><a class="anchor" href="#programManager"></a>Chapter 6. Program Manager</h2>
<div class="sectionbody">
<div class="paragraph">
<p><a id="_ix536" class="ixterm"></a>Program Manager is the DVX desktop: it opens when DVX starts, stays open the whole time DVX runs, and is where you find and start your programs. Its window shows your programs as icons, sorted into groups. One group, Installed Programs, always lists every program installed in DVX; you can make groups of your own and fill them with the programs and documents you use most, each with its own name, icon, and shortcut key. Program Manager can also start DOS programs, run a command you type, arrange the windows on the screen, and leave DVX.</p>
</div>
<div class="sect2">
<h3 id="progman-window"><a class="anchor" href="#progman-window"></a>6.1. The Program Manager window</h3>
<div class="imageblock">
<div class="content">
<img src="images/pmWindow.png" alt="The Program Manager window: the menu bar, the Groups list on the left, the Search box and the program icons on the right, and the status bar at the bottom">
</div>
<div class="title">Figure 26. The Program Manager window</div>
</div>
<div class="paragraph">
<p><a id="_ix537" class="ixterm"></a>The window is titled <strong>Program Manager</strong>. It opens near the top of the screen, centered from left to right, each time DVX starts; DVX does not remember where you moved it or how large you made it. It has these parts:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Menu bar</strong></dt>
<dd>
<p><a id="_ix538" class="ixterm"></a>The <b class="menuref">File</b>, <b class="menuref">View</b>, <b class="menuref">Options</b>, <b class="menuref">Window</b>, and <b class="menuref">Help</b> menus (see <a href="#progman-menus">Section 6.10</a>).</p>
</dd>
<dt class="hdlist1"><strong>Groups</strong></dt>
<dd>
<p><a id="_ix539" class="ixterm"></a>The list on the left: your program groups. Click a group to show its items (see <a href="#progman-groups">Section 6.3</a>). <span class="keyseq"><kbd>Alt</kbd>+<kbd>G</kbd></span> moves to the list.</p>
</dd>
<dt class="hdlist1"><strong>Search</strong></dt>
<dd>
<p><a id="_ix540" class="ixterm"></a>The box at the top right: type here to find programs in every group (see <a href="#progman-search">Section 6.6</a>). <span class="keyseq"><kbd>Alt</kbd>+<kbd>S</kbd></span> moves to the box.</p>
</dd>
<dt class="hdlist1">The icon area</dt>
<dd>
<p><a id="_ix541" class="ixterm"></a>The items of the selected group: programs and documents, each shown as an icon with its name (see <a href="#progman-items">Section 6.4</a>). Double-click one to start it. The scroll bar beside it, or the mouse wheel, scrolls through the items when they do not all fit.</p>
</dd>
<dt class="hdlist1"><strong>Status bar</strong></dt>
<dd>
<p><a id="_ix542" class="ixterm"></a><a id="_ix543" class="ixterm"></a>The line at the bottom. Its left part describes the selected item (its description, or its program file if it has none), or, with nothing selected, says how many items are shown, such as &#8220;19 item(s)&#8221;. Its right part says how many other programs are running, not counting Program Manager itself: &#8220;No applications running&#8221;, &#8220;1 application running&#8221;, &#8220;2 applications running&#8221;, and so on.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p><kbd>Tab</kbd> moves between the Groups list, the Search box, and the icon area.</p>
</div>
<div class="paragraph">
<p><a id="_ix544" class="ixterm"></a>When there is nothing to show, the icon area says why: &#8220;This group is empty. Use File &gt; New Item to add a program.&#8221;, &#8220;No programs match the search.&#8221;, or, in Installed Programs, &#8220;No programs are installed.&#8221;</p>
</div>
<div class="admonitionblock warning">
<table>
<tr>
<td class="icon">
<div class="title">Warning</div>
</td>
<td class="content">
<a id="_ix545" class="ixterm"></a><a id="_ix546" class="ixterm"></a>Program Manager is the desktop. Closing its window (with its Close box, <span class="keyseq"><kbd>Alt</kbd>+<kbd>F4</kbd></span>, or <strong>Close</strong> in its window menu) asks whether to exit DVX, just as <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Exit DVX</b></span> does (see <a href="#desktop-exit">Section 5.16</a>). To put Program Manager out of the way without leaving DVX, minimize it instead.
</td>
</tr>
</table>
</div>
</div>
<div class="sect2">
<h3 id="progman-starting"><a class="anchor" href="#progman-starting"></a>6.2. Starting programs</h3>
<div class="paragraph">
<p><a id="_ix547" class="ixterm"></a><a id="_ix548" class="ixterm"></a>To start a program, use any of these:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>Double-click its icon.</p>
</li>
<li>
<p>Select its icon and press <kbd>Enter</kbd>.</p>
</li>
<li>
<p>Select its icon and choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Open</b></span>, or right-click the icon and choose <strong>Open</strong>.</p>
</li>
<li>
<p>Press the item&#8217;s shortcut key, from any program (see <a href="#progman-shortcut-keys">Section 6.4.4</a>).</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>While the program loads, the pointer is an hourglass. The program opens in a window of its own, and Program Manager stays open behind it (unless you ask it to step aside; see <a href="#progman-options">Section 6.9</a>). To start a program that has no icon, use <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Run&#8230;&#8203;</b></span> (see <a href="#progman-run">Section 6.7</a>).</p>
</div>
<div class="paragraph">
<p><a id="_ix549" class="ixterm"></a>An item can also open a document, such as a text file or a picture. DVX starts the program set up for that kind of file and gives it the document (see <a href="#cpanel-file-types">Section 7.8</a>).</p>
</div>
<div class="paragraph">
<p><a id="_ix550" class="ixterm"></a>Most programs can run only once at a time. If you start a program that is already running, an <strong>Error</strong> message says &#8220;<em>file</em> is already running.&#8221;, with the name of the program&#8217;s file; find its window with <span class="keyseq"><kbd>Alt</kbd>+<kbd>Tab</kbd></span> or the Task Manager instead. A few programs that open documents take the new document instead of showing this message. Some programs can run more than once, each copy in its own window.</p>
</div>
<div class="paragraph">
<p><a id="_ix551" class="ixterm"></a>If a program was made for another version of DVX, a message says &#8220;This program was built for a different version of DVX and cannot run.&#8221; Get a copy of the program made for your version of DVX.</p>
</div>
</div>
<div class="sect2">
<h3 id="progman-groups"><a class="anchor" href="#progman-groups"></a>6.3. Groups</h3>
<div class="paragraph">
<p><a id="_ix552" class="ixterm"></a><a id="_ix553" class="ixterm"></a>A <em>group</em> is a set of items you keep together, such as Games or Writing. The same program can be in several groups. The Groups list on the left shows every group; click one to show its items.</p>
</div>
<div class="sect3">
<h4 id="progman-new-installation"><a class="anchor" href="#progman-new-installation"></a>6.3.1. The groups on a new installation</h4>
<div class="paragraph">
<p><a id="_ix554" class="ixterm"></a><a id="_ix555" class="ixterm"></a>The first time DVX runs, Program Manager has three groups, with Installed Programs selected:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Installed Programs</strong></dt>
<dd>
<p>Always the first group. It lists every program installed in DVX, in alphabetical order (Program Manager itself is not listed). It keeps itself up to date: when Program Manager&#8217;s window comes back to the front after programs were installed or removed, or after a DOS program ran, Program Manager looks again, and <span class="menuseq"><b class="menu">View</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Refresh</b></span> looks at once. You cannot change this group: you cannot add, move, rename, delete, or drag its items, or change their properties. To put one of its programs in a group of your own, copy it (see <a href="#progman-copying">Section 6.4.8</a>).</p>
</dd>
<dt class="hdlist1"><strong>Main</strong></dt>
<dd>
<p>An empty group of your own.</p>
</dd>
<dt class="hdlist1"><strong>Startup</strong></dt>
<dd>
<p><a id="_ix556" class="ixterm"></a><a id="_ix557" class="ixterm"></a>An empty group of your own with a special job: every item in it starts by itself each time DVX starts, once the desktop is up. Put a program there to have it start with DVX, and delete its item from Startup to stop that (the program stays installed). Program Manager finds this group by its name, in capitals or small letters: if you rename or delete it, nothing starts by itself until you make a group named Startup again.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>After the first time, Program Manager opens with the group that was selected when DVX last ran.</p>
</div>
</div>
<div class="sect3">
<h4 id="progman-new-group"><a class="anchor" href="#progman-new-group"></a>6.3.2. Making a group</h4>
<div class="paragraph">
<p><a id="_ix558" class="ixterm"></a><a id="_ix559" class="ixterm"></a>To make a group:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">New Group&#8230;&#8203;</b></span>.</p>
</li>
<li>
<p>In the <strong>New Group</strong> dialog box, type the group&#8217;s name in the <strong>Group name</strong> box.</p>
</li>
<li>
<p>Click <b class="button">OK</b>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>The new group appears at the end of the Groups list, selected and empty.</p>
</div>
<div class="paragraph">
<p><a id="_ix560" class="ixterm"></a>Every group needs a name, and no two groups can have the same name (capitals and small letters count as the same): otherwise a message says &#8220;A group needs a name no other group has.&#8221; <a id="_ix561" class="ixterm"></a>You can have up to 64 groups of your own. With 64 already, <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">New Group&#8230;&#8203;</b></span> does not ask for a name: a <strong>New Group</strong> message says &#8220;There is no room for another group: Program Manager holds up to 64 groups of your own. Delete a group to make room for a new one.&#8221;</p>
</div>
</div>
<div class="sect3">
<h4 id="progman-rename-group"><a class="anchor" href="#progman-rename-group"></a>6.3.3. Renaming a group</h4>
<div class="paragraph">
<p><a id="_ix562" class="ixterm"></a><a id="_ix563" class="ixterm"></a>To rename a group:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Click the group in the Groups list.</p>
</li>
<li>
<p>Choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Rename Group&#8230;&#8203;</b></span>.</p>
</li>
<li>
<p>In the <strong>Rename Group</strong> dialog box, type the new name in the <strong>New name</strong> box, and click <b class="button">OK</b>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>The same rule about names applies. Installed Programs cannot be renamed.</p>
</div>
</div>
<div class="sect3">
<h4 id="progman-delete-group"><a class="anchor" href="#progman-delete-group"></a>6.3.4. Deleting a group</h4>
<div class="paragraph">
<p><a id="_ix564" class="ixterm"></a><a id="_ix565" class="ixterm"></a>To delete a group and all its items:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Click the group in the Groups list.</p>
</li>
<li>
<p>Choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Delete Group</b></span>.</p>
</li>
<li>
<p>A <strong>Delete Group</strong> message asks &#8220;Delete the group "<em>name</em>" and its <em>n</em> item(s)? The programs themselves are not removed.&#8221; Click <b class="button">Yes</b>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>Only the items are deleted: the programs and documents they start stay where they are. Installed Programs cannot be deleted.</p>
</div>
<div class="paragraph">
<p><a id="_ix566" class="ixterm"></a>Right-click the Groups list for a short menu with <strong>New Group&#8230;&#8203;</strong>, <strong>Rename Group&#8230;&#8203;</strong>, and <strong>Delete Group</strong>. Right-clicking does not select the group under the pointer: these commands act on the group that is already selected, so click the group first.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="progman-items"><a class="anchor" href="#progman-items"></a>6.4. Items</h3>
<div class="paragraph">
<p><a id="_ix567" class="ixterm"></a><a id="_ix568" class="ixterm"></a>Each icon in a group is an <em>item</em>. An item says what to start (a program, a DOS program, or a document) and how: with what arguments, in which folder, with which icon, and with which shortcut key. Deleting an item never deletes the program. A group holds up to 256 items; when it is full, a message says &#8220;That group is full.&#8221;</p>
</div>
<div class="sect3">
<h4 id="progman-selecting"><a class="anchor" href="#progman-selecting"></a>6.4.1. Selecting items</h4>
<div class="paragraph">
<p><a id="_ix569" class="ixterm"></a>Click an item to select it: its name is highlighted, and the status bar shows its description. Clicking empty space in the icon area clears the selection. With the keyboard, when the icon area has the focus:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>The arrow keys move between the icons.</p>
</li>
<li>
<p><kbd>Home</kbd> and <kbd>End</kbd> go to the first and last icons.</p>
</li>
<li>
<p><kbd>Page Up</kbd> and <kbd>Page Down</kbd> move up or down by as many rows as the icon area shows.</p>
</li>
<li>
<p>Typing the first letters of a name quickly, one after another, goes to the icon that starts with them; the same letter again goes on to the next icon starting with it (see <a href="#desktop-lists">Section 5.5.3.6</a>).</p>
</li>
</ul>
</div>
</div>
<div class="sect3">
<h4 id="progman-adding"><a class="anchor" href="#progman-adding"></a>6.4.2. Adding an item</h4>
<div class="paragraph">
<p><a id="_ix570" class="ixterm"></a><a id="_ix571" class="ixterm"></a>To add a program or document to one of your groups:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Click the group in the Groups list.</p>
</li>
<li>
<p>Choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">New Item&#8230;&#8203;</b></span>. (If Installed Programs is selected, or a search is showing, a <strong>New Item</strong> list first asks which <strong>Group</strong> the item goes in.)</p>
</li>
<li>
<p>In the <strong>New Program Item</strong> dialog box, type the program&#8217;s file in the <strong>Program</strong> box, or click the <b class="button">Browse&#8230;&#8203;</b> beside it and choose the file.</p>
</li>
<li>
<p>Fill in the other boxes you need (see <a href="#progman-properties">Section 6.4.3</a>). Only <strong>Program</strong> is required.</p>
</li>
<li>
<p>Click <b class="button">OK</b>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>The new item appears in the group, selected.</p>
</div>
</div>
<div class="sect3">
<h4 id="progman-properties"><a class="anchor" href="#progman-properties"></a>6.4.3. Item properties</h4>
<div class="paragraph">
<p><a id="_ix572" class="ixterm"></a><a id="_ix573" class="ixterm"></a>To change an item, select it and press <span class="keyseq"><kbd>Alt</kbd>+<kbd>Enter</kbd></span>, or choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Properties&#8230;&#8203;</b></span>, or right-click it and choose <strong>Properties&#8230;&#8203;</strong>. The <strong>Program Item Properties</strong> dialog box has the same boxes as the New Program Item dialog box:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Name</strong></dt>
<dd>
<p><a id="_ix574" class="ixterm"></a>The name shown under the icon. Leave it empty to use the program&#8217;s own name.</p>
</dd>
<dt class="hdlist1"><strong>Program</strong></dt>
<dd>
<p><a id="_ix575" class="ixterm"></a>The program to start, with its folder, for example <code>C:\GAMES\PINBALL.EXE</code>. It can be a DVX program (a file ending in <code>.APP</code>), a DOS program (see <a href="#progman-dos">Section 6.8</a>), or a document, which opens in the program set up for its kind of file. Click <b class="button">Browse&#8230;&#8203;</b> beside it to choose the file in a <strong>Choose Program</strong> dialog box, which starts in DVX&#8217;s <code>APPS</code> folder and offers the filters &#8220;Programs (*.app)&#8221;, &#8220;DOS programs (*.exe;*.com;*.bat)&#8221;, and &#8220;All Files (*.*)&#8221;. <a id="_ix576" class="ixterm"></a>If you leave this box empty, a message says &#8220;Type the program or document this item opens.&#8221;</p>
</dd>
<dt class="hdlist1"><strong>Arguments</strong></dt>
<dd>
<p><a id="_ix577" class="ixterm"></a>Extra information the program gets when it starts, such as the name of a file to open. Put a name with spaces in double quotes.</p>
</dd>
<dt class="hdlist1"><strong>Working folder</strong></dt>
<dd>
<p><a id="_ix578" class="ixterm"></a><a id="_ix579" class="ixterm"></a>The folder where files named in <strong>Arguments</strong> are looked for. For example, with the working folder <code>C:\LETTERS</code> and the argument <code>JUNE.TXT</code>, the program gets <code>C:\LETTERS\JUNE.TXT</code>. A DOS program runs in this folder; when the box is empty, it runs in its own folder. Click <b class="button">Browse&#8230;&#8203;</b> beside it to choose the folder in a <strong>Choose Working Folder</strong> dialog box.</p>
</dd>
<dt class="hdlist1"><strong>Icon file</strong></dt>
<dd>
<p><a id="_ix580" class="ixterm"></a>A different picture for the item: a DVX program file (its icon is used) or a picture file (BMP, PNG, JPEG, or GIF). Leave it empty for the usual icon (see <a href="#progman-icons">Section 6.4.5</a>). Click <b class="button">Browse&#8230;&#8203;</b> beside it to choose the file in a <strong>Choose Icon</strong> dialog box, whose filters are &#8220;Icons (*.app;*.bmp;*.png;*.jpg;*.gif)&#8221; and &#8220;All Files (*.*)&#8221;.</p>
</dd>
<dt class="hdlist1"><strong>Shortcut key</strong></dt>
<dd>
<p><a id="_ix581" class="ixterm"></a>Keys that start the item from any program, such as <code>Ctrl+Alt+N</code> (see <a href="#progman-shortcut-keys">Section 6.4.4</a>). Leave it empty for none.</p>
</dd>
<dt class="hdlist1"><strong>Run minimized</strong></dt>
<dd>
<p><a id="_ix582" class="ixterm"></a><a id="_ix583" class="ixterm"></a>Starts the program with its windows minimized to icons. It does not apply to DOS programs.</p>
</dd>
<dt class="hdlist1"><strong>Wait for a key when a DOS program ends</strong></dt>
<dd>
<p><a id="_ix584" class="ixterm"></a>For a DOS program: when it ends, DVX shows &#8220;Press any key to return to DVX.&#8221; and waits for a key, so you can read what the program printed.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>The picture beside the check boxes shows the item&#8217;s icon. It changes when you choose a program or an icon file with <b class="button">Browse&#8230;&#8203;</b>.</p>
</div>
<div class="paragraph">
<p>With the keyboard, <kbd>Alt</kbd> and an underlined letter moves to a box, ticks or clears a check box, or presses a button: N, P, A, W, I, and S for the boxes, M and K for the check boxes, and B, E, and R for the three <b class="button">Browse&#8230;&#8203;</b> buttons, from top to bottom.</p>
</div>
<div class="paragraph">
<p><a id="_ix585" class="ixterm"></a>Items in Installed Programs cannot be changed: for them, Properties shows a <strong>Properties</strong> message with the program&#8217;s name, its file (&#8220;Program: <em>file</em>&#8221;), and its description.</p>
</div>
</div>
<div class="sect3">
<h4 id="progman-shortcut-keys"><a class="anchor" href="#progman-shortcut-keys"></a>6.4.4. Shortcut keys</h4>
<div class="paragraph">
<p><a id="_ix586" class="ixterm"></a><a id="_ix587" class="ixterm"></a><a id="_ix588" class="ixterm"></a>An item&#8217;s shortcut key starts it from any program, whichever window is in front, so you can start your favourite programs without going back to Program Manager. Type the shortcut in the item&#8217;s <strong>Shortcut key</strong> box as the key names joined with <code>+</code>, for example <code>Ctrl+Alt+N</code> or <code>Ctrl+Shift+F5</code> (capitals and small letters are the same).</p>
</div>
<div class="paragraph">
<p>A shortcut key is:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><kbd>Ctrl</kbd>, together with <kbd>Alt</kbd> or <kbd>Shift</kbd> or both, and</p>
</li>
<li>
<p>one of these keys: a letter, a digit, <kbd>F1</kbd> to <kbd>F12</kbd>, or one of <code>Backspace</code>, <code>Del</code> (or <code>Delete</code>), <code>Down</code>, <code>End</code>, <code>Enter</code>, <code>Esc</code>, <code>Home</code>, <code>Ins</code> (or <code>Insert</code>), <code>Left</code>, <code>PgDn</code>, <code>PgUp</code>, <code>Right</code>, <code>Space</code>, <code>Tab</code>, and <code>Up</code>.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p><a id="_ix589" class="ixterm"></a>Anything else brings the message &#8220;A shortcut key is Ctrl with Alt or Shift, and a letter, a digit, F1 to F12, or one of Backspace, Del, Down, End, Enter, Esc, Home, Ins, Left, PgDn, PgUp, Right, Space, Tab, and Up, for example Ctrl+Alt+P.&#8221;</p>
</div>
<div class="paragraph">
<p><a id="_ix590" class="ixterm"></a><a id="_ix591" class="ixterm"></a>A few of these keys belong to DVX, which acts on them first in every program, so they could never start an item. The <strong>Shortcut key</strong> box refuses them, with the message &#8220;<em>keys</em> cannot be a shortcut key: it <em>does</em>.&#8221;, which says what the keys do:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>F4</kbd></span>: &#8220;closes the active window&#8221; (as <span class="keyseq"><kbd>Alt</kbd>+<kbd>F4</kbd></span> does);</p>
</li>
<li>
<p><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Tab</kbd></span>: &#8220;switches to another window&#8221; (as <span class="keyseq"><kbd>Alt</kbd>+<kbd>Tab</kbd></span> does);</p>
</li>
<li>
<p><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Space</kbd></span>: &#8220;opens the window menu&#8221; (as <span class="keyseq"><kbd>Alt</kbd>+<kbd>Space</kbd></span> does);</p>
</li>
<li>
<p><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Esc</kbd></span> and <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Esc</kbd></span>: &#8220;opens the Task Manager&#8221; (as <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Esc</kbd></span> does);</p>
</li>
<li>
<p><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>F12</kbd></span>: &#8220;saves a picture of the screen&#8221;, and <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>F12</kbd></span>: &#8220;saves a picture of the active window&#8217;s contents&#8221; (see <a href="#desktop-screenshots">Section 5.8</a>);</p>
</li>
<li>
<p><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd></span>: &#8220;restarts the computer&#8221;.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>The same keys with <kbd>Shift</kbd> held as well are refused too.</p>
</div>
<div class="paragraph">
<p><a id="_ix592" class="ixterm"></a>If an item already has shortcut keys that are not allowed (any more), for example because <code>PROGMAN.INI</code> was changed by hand or DVX now keeps those keys for itself, Program Manager removes the key when it starts, keeps the rest of the item, and tells you once: &#8220;"<em>item</em>" no longer has its shortcut key <em>keys</em>. <em>reason</em> Choose another one in the item&#8217;s Properties.&#8221;, where the reason is one of the two messages above.</p>
</div>
<div class="paragraph">
<p>Shortcut keys work while Program Manager is running, even while it is minimized. They do not work while a menu, a window menu, or a dialog box is open, or while a program uses the whole screen. When a program uses the same keys for one of its own commands, the item&#8217;s shortcut key wins.</p>
</div>
<div class="paragraph">
<p><a id="_ix593" class="ixterm"></a>Two items should not share one shortcut key: only one of them would start. The Properties dialog box refuses a key another item already has, with the message &#8220;<em>keys</em> is already the shortcut for "<em>name</em>".&#8221; A copy of an item (see <a href="#progman-copying">Section 6.4.8</a>) has no shortcut key, so the original&#8217;s key keeps starting the original; give the copy a key of its own in its Properties if you like.</p>
</div>
</div>
<div class="sect3">
<h4 id="progman-icons"><a class="anchor" href="#progman-icons"></a>6.4.5. Icons</h4>
<div class="paragraph">
<p><a id="_ix594" class="ixterm"></a><a id="_ix595" class="ixterm"></a>An item shows the first of these that it has:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>the picture in its <strong>Icon file</strong> box;</p>
</li>
<li>
<p>the program&#8217;s own icon;</p>
</li>
<li>
<p>for a DOS program, the standard DOS icon;</p>
</li>
<li>
<p>for a document, the icon of the program that opens it, or, for a picture, the picture itself;</p>
</li>
<li>
<p>otherwise, a raised square with the first letter of the item&#8217;s name.</p>
</li>
</ol>
</div>
</div>
<div class="sect3">
<h4 id="progman-renaming"><a class="anchor" href="#progman-renaming"></a>6.4.6. Renaming an item</h4>
<div class="paragraph">
<p><a id="_ix596" class="ixterm"></a><a id="_ix597" class="ixterm"></a>To rename an item, select it and press <kbd>F2</kbd>, or choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Rename&#8230;&#8203;</b></span>. In the <strong>Rename</strong> dialog box, type the new name in the <strong>New name</strong> box and click <b class="button">OK</b>. An empty name leaves the item as it was. (You can also change the name in the <strong>Name</strong> box of the item&#8217;s properties.)</p>
</div>
</div>
<div class="sect3">
<h4 id="progman-moving"><a class="anchor" href="#progman-moving"></a>6.4.7. Moving an item to another group</h4>
<div class="paragraph">
<p><a id="_ix598" class="ixterm"></a><a id="_ix599" class="ixterm"></a>To move an item to another of your groups:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Select the item.</p>
</li>
<li>
<p>Press <kbd>F7</kbd>, or choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Move&#8230;&#8203;</b></span>.</p>
</li>
<li>
<p>In the <strong>Move Item</strong> dialog box, click the group in the <strong>Group</strong> list, and click <b class="button">OK</b>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>The list shows your own groups except the item&#8217;s current group. Items of Installed Programs cannot be moved (copy them instead).</p>
</div>
</div>
<div class="sect3">
<h4 id="progman-copying"><a class="anchor" href="#progman-copying"></a>6.4.8. Copying an item to a group</h4>
<div class="paragraph">
<p><a id="_ix600" class="ixterm"></a><a id="_ix601" class="ixterm"></a>To put a copy of an item in one of your groups, for example a program from Installed Programs:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Select the item.</p>
</li>
<li>
<p>Press <kbd>F8</kbd>, or choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Copy&#8230;&#8203;</b></span>.</p>
</li>
<li>
<p>In the <strong>Copy Item</strong> dialog box, click the group in the <strong>Group</strong> list, and click <b class="button">OK</b>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>The copy has the same properties as the original, except its shortcut key: a copy has none (see <a href="#progman-shortcut-keys">Section 6.4.4</a>).</p>
</div>
<div class="paragraph">
<p><a id="_ix602" class="ixterm"></a>If you have no group to move or copy the item to, a message says &#8220;There is no other group. Make one with File &gt; New Group first.&#8221;</p>
</div>
</div>
<div class="sect3">
<h4 id="progman-deleting"><a class="anchor" href="#progman-deleting"></a>6.4.9. Deleting an item</h4>
<div class="paragraph">
<p><a id="_ix603" class="ixterm"></a><a id="_ix604" class="ixterm"></a>To delete an item from a group:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Select the item.</p>
</li>
<li>
<p>Press <kbd>Del</kbd>, or choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Delete</b></span>.</p>
</li>
<li>
<p>A <strong>Delete Item</strong> message asks &#8220;Delete "<em>name</em>" from the group "<em>group</em>"? The program itself is not removed.&#8221; Click <b class="button">Yes</b>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>Only the icon goes; the program or document stays where it is. Items of Installed Programs cannot be deleted; to remove a program from DVX, use the Software program (see <a href="#addons-removing">Section 10.4</a>).</p>
</div>
<div class="paragraph">
<p><a id="_ix605" class="ixterm"></a>Right-click an item for a short menu with <strong>Open</strong>, <strong>Move&#8230;&#8203;</strong>, <strong>Copy&#8230;&#8203;</strong>, <strong>Delete</strong>, <strong>Rename&#8230;&#8203;</strong>, <strong>Properties&#8230;&#8203;</strong>, and <strong>New Item&#8230;&#8203;</strong>. Right-clicking selects the item under the pointer first.</p>
</div>
<div class="admonitionblock note">
<table>
<tr>
<td class="icon">
<div class="title">Note</div>
</td>
<td class="content">
<kbd>Enter</kbd>, <kbd>Del</kbd>, and <kbd>F2</kbd> work only while the icon area has the keyboard focus. <kbd>F5</kbd>, <kbd>F7</kbd>, <kbd>F8</kbd>, and <span class="keyseq"><kbd>Alt</kbd>+<kbd>Enter</kbd></span> work anywhere in the Program Manager window.
</td>
</tr>
</table>
</div>
</div>
</div>
<div class="sect2">
<h3 id="progman-views"><a class="anchor" href="#progman-views"></a>6.5. Views and arranging icons</h3>
<div class="paragraph">
<p><a id="_ix606" class="ixterm"></a><a id="_ix607" class="ixterm"></a>The <b class="menuref">View</b> menu chooses how the items are shown. A diamond marks the view in use:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Large Icons</strong></dt>
<dd>
<p><a id="_ix608" class="ixterm"></a>A large picture, with the name under it (on up to two lines). This is the view at first.</p>
</dd>
<dt class="hdlist1"><strong>Small Icons</strong></dt>
<dd>
<p><a id="_ix609" class="ixterm"></a>A small picture, with the name beside it.</p>
</dd>
<dt class="hdlist1"><strong>List</strong></dt>
<dd>
<p>One item per line, with its name and its description (or its program file).</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p><a id="_ix610" class="ixterm"></a><a id="_ix611" class="ixterm"></a><a id="_ix612" class="ixterm"></a>In your own groups, you can drag an item with the mouse to another place. How the items are placed depends on <span class="menuseq"><b class="menu">View</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Auto Arrange</b></span>, which has a tick mark while it is on:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>With <strong>Auto Arrange</strong> on (as at first), the items always sit in order, row after row. Dragging an item moves it to a new place in that order, and the others make room.</p>
</li>
<li>
<p>With <strong>Auto Arrange</strong> off, an item stays where you drop it, even with gaps around it, and trades places with an item already there. <span class="menuseq"><b class="menu">View</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Arrange Icons</b></span> lines all the items up again in order; it is grey when it does not apply.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>In the List view, dragging always changes the order. Items cannot be dragged in Installed Programs, or while a search is showing.</p>
</div>
<div class="paragraph">
<p><a id="_ix613" class="ixterm"></a>There is no sort command: Installed Programs is always in alphabetical order, and your own groups keep the order you give them.</p>
</div>
<div class="paragraph">
<p><a id="_ix614" class="ixterm"></a><a id="_ix615" class="ixterm"></a><span class="menuseq"><b class="menu">View</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Refresh</b></span> (or <kbd>F5</kbd>) looks at once for programs that were installed or removed, and updates Installed Programs.</p>
</div>
<div class="paragraph">
<p><a id="_ix616" class="ixterm"></a>Program Manager saves your groups, items, their places, the view, the options, and the commands you ran as soon as you change them, and they are all there again the next time you start DVX.</p>
</div>
</div>
<div class="sect2">
<h3 id="progman-search"><a class="anchor" href="#progman-search"></a>6.6. Searching for a program</h3>
<div class="paragraph">
<p><a id="_ix617" class="ixterm"></a><a id="_ix618" class="ixterm"></a>To find a program, click the <strong>Search</strong> box (or press <span class="keyseq"><kbd>Alt</kbd>+<kbd>S</kbd></span>) and type part of its name. As you type, the icon area shows the items of every group whose name, description, or file name contains what you typed, in capitals or small letters. A program that is in several groups appears once for each group.</p>
</div>
<div class="paragraph">
<p>To end the search, empty the Search box, or click a group in the Groups list.</p>
</div>
<div class="paragraph">
<p>While a search is showing, you can start the items found and use the <b class="menuref">File</b> menu&#8217;s commands on them, but you cannot drag them; <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">New Item&#8230;&#8203;</b></span> asks which group the new item goes in.</p>
</div>
</div>
<div class="sect2">
<h3 id="progman-run"><a class="anchor" href="#progman-run"></a>6.7. Running a command</h3>
<div class="paragraph">
<p><a id="_ix619" class="ixterm"></a><a id="_ix620" class="ixterm"></a><a id="_ix621" class="ixterm"></a><span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Run&#8230;&#8203;</b></span> starts a program that has no icon, or opens a document by its name:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Run&#8230;&#8203;</b></span>.</p>
</li>
<li>
<p>In the <strong>Run</strong> dialog box, type the program or document in the <strong>Open</strong> box, followed by any arguments, or click <b class="button">Browse&#8230;&#8203;</b> to choose the file.</p>
</li>
<li>
<p>Click <b class="button">OK</b>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p><a id="_ix622" class="ixterm"></a>What you can type:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>A program file, with its folder, for example <code>C:\DVX\APPS\KPUNCH\NOTEPAD\NOTEPAD.APP</code> or <code>C:\GAMES\PINBALL.EXE</code>, optionally followed by arguments. Put a name that has spaces in double quotes.</p>
</li>
<li>
<p>A DOS program without a folder, such as <code>EDIT.COM</code>, which is looked for as at the DOS prompt.</p>
</li>
<li>
<p>A document, for example <code>C:\DOCS\NOTES.TXT</code>. It opens in the program set up for its kind of file (see <a href="#cpanel-file-types">Section 7.8</a>).</p>
</li>
</ul>
</div>
<div class="paragraph">
<p><a id="_ix623" class="ixterm"></a>The <strong>Open</strong> box is a drop-down list that remembers the last ten commands you ran, newest first, and starts with the newest one already filled in. Open the list (click its arrow, or press <kbd>F4</kbd> or <span class="keyseq"><kbd>Alt</kbd>+<kbd>Down</kbd></span>) and choose a command to run it again, or press <kbd>Up</kbd> and <kbd>Down</kbd> to step through the commands in the box itself, or type over it. <b class="button">OK</b> with an empty box does nothing.</p>
</div>
<div class="paragraph">
<p><b class="button">Browse&#8230;&#8203;</b> opens a <strong>Browse</strong> dialog box that starts in DVX&#8217;s <code>APPS</code> folder, with the filters &#8220;Programs (*.app)&#8221;, &#8220;DOS programs (*.exe;*.com;*.bat)&#8221;, and &#8220;All Files (*.*)&#8221;. The file you choose goes in the Open box, in quotes if its name has a space.</p>
</div>
<div class="paragraph">
<p><a id="_ix624" class="ixterm"></a><a id="_ix625" class="ixterm"></a>Messages (title <strong>Run</strong>):</p>
</div>
<div class="ulist">
<ul>
<li>
<p>&#8220;Cannot find <em>name</em>.&#8221;: there is no such document.</p>
</li>
<li>
<p>&#8220;No program is set up to open <em>name</em>. Choose one on the File Types page of the Control Panel.&#8221;: DVX does not know which program opens this kind of file (see <a href="#cpanel-file-types">Section 7.8</a>).</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>The Task Manager&#8217;s <b class="button">Run&#8230;&#8203;</b> button opens the same dialog box, without the list of earlier commands (see <a href="#desktop-task-manager">Section 5.10</a>). A DOS program started from Run behaves as described in <a href="#desktop-dos-programs">Section 5.15</a>.</p>
</div>
</div>
<div class="sect2">
<h3 id="progman-dos"><a class="anchor" href="#progman-dos"></a>6.8. DOS program items</h3>
<div class="paragraph">
<p><a id="_ix626" class="ixterm"></a><a id="_ix627" class="ixterm"></a>An item can start an ordinary DOS program (a file ending in <code>.EXE</code>, <code>.COM</code>, or <code>.BAT</code>), such as a game, an editor, or a batch file. The program has the whole computer to itself while it runs; when it ends, DVX comes back.</p>
</div>
<div class="sect3">
<h4 id="progman-dos-setup"><a class="anchor" href="#progman-dos-setup"></a>6.8.1. Setting up a DOS program item</h4>
<div class="paragraph">
<p><a id="_ix628" class="ixterm"></a>To add a DOS program to one of your groups:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Click the group, and choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">New Item&#8230;&#8203;</b></span>.</p>
</li>
<li>
<p>In the <strong>Program</strong> box, type the program&#8217;s file with its folder, for example <code>C:\GAMES\PINBALL.EXE</code>. Or click <b class="button">Browse&#8230;&#8203;</b>, choose &#8220;DOS programs (*.exe;*.com;*.bat)&#8221; in the <strong>Filter</strong> list, and find the file.</p>
</li>
<li>
<p>Type a <strong>Name</strong> for the item.</p>
</li>
<li>
<p>If the program needs them, type its <strong>Arguments</strong> (as you would type them after the program&#8217;s name at the DOS prompt) and its <strong>Working folder</strong>.</p>
</li>
<li>
<p>Tick <strong>Wait for a key when a DOS program ends</strong> for a program that prints something and stops, so you can read it before DVX comes back.</p>
</li>
<li>
<p>If you like, choose an <strong>Icon file</strong> and a <strong>Shortcut key</strong>.</p>
</li>
<li>
<p>Click <b class="button">OK</b>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>The settings that matter for a DOS program:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Program</strong></dt>
<dd>
<p>The <code>.EXE</code>, <code>.COM</code>, or <code>.BAT</code> file. A batch file runs as it would at the DOS prompt, so it can run several programs in turn.</p>
</dd>
<dt class="hdlist1"><strong>Arguments</strong></dt>
<dd>
<p>What the program gets after its name, as at the DOS prompt.</p>
</dd>
<dt class="hdlist1"><strong>Working folder</strong></dt>
<dd>
<p>The folder the program runs in, as if you had changed to it with <code>CD</code> before starting the program. Empty: the folder the program is in.</p>
</dd>
<dt class="hdlist1"><strong>Icon file</strong></dt>
<dd>
<p>Without one, the item shows the standard DOS icon.</p>
</dd>
<dt class="hdlist1"><strong>Shortcut key</strong></dt>
<dd>
<p>Works as for any item (see <a href="#progman-shortcut-keys">Section 6.4.4</a>).</p>
</dd>
<dt class="hdlist1"><strong>Run minimized</strong></dt>
<dd>
<p>Does not apply to DOS programs.</p>
</dd>
<dt class="hdlist1"><strong>Wait for a key when a DOS program ends</strong></dt>
<dd>
<p>When the program ends, DVX shows &#8220;Press any key to return to DVX.&#8221; on the DOS screen and waits for a key before the DVX screen comes back.</p>
</dd>
</dl>
</div>
</div>
<div class="sect3">
<h4 id="progman-dos-running"><a class="anchor" href="#progman-dos-running"></a>6.8.2. What happens when it runs</h4>
<div class="paragraph">
<p><a id="_ix629" class="ixterm"></a>Start the item as any other. Then:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>If programs other than Program Manager are running, a <strong>Run DOS Program</strong> message names them and asks whether to close them and go on. Each one then closes as if you had closed it, asking about unsaved work. If you choose <b class="button">No</b>, or keep a program open by choosing <b class="button">Cancel</b> when it asks about saving, the DOS program does not run.</p>
</li>
<li>
<p>The screen changes to the DOS screen, and the program runs with the keyboard, the mouse, and the sound card to itself.</p>
</li>
<li>
<p>When it ends (after you press a key, if the item waits for one), the DVX screen comes back, with Program Manager. The programs that were closed stay closed.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>DVX stays in memory while the program runs, so a program that needs a great deal of memory is best started from DOS after you leave DVX. <a href="#desktop-dos-programs">Section 5.15</a> gives the details and the messages.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="progman-options"><a class="anchor" href="#progman-options"></a>6.9. Options</h3>
<div class="paragraph">
<p><a id="_ix630" class="ixterm"></a>The <b class="menuref">Options</b> menu has two settings, each with a tick mark while it is on. Both are off at first.</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Minimize on Run</strong></dt>
<dd>
<p><a id="_ix631" class="ixterm"></a>Program Manager minimizes itself to an icon each time you start an item (other than one set to <strong>Run minimized</strong>), start an item with its shortcut key, or run a command with <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Run&#8230;&#8203;</b></span>. Items of the Startup group do not minimize it.</p>
</dd>
<dt class="hdlist1"><strong>Restore when Alone</strong></dt>
<dd>
<p><a id="_ix632" class="ixterm"></a>When Program Manager is minimized and the last other program ends, Program Manager comes back by itself.</p>
</dd>
</dl>
</div>
</div>
<div class="sect2">
<h3 id="progman-menus"><a class="anchor" href="#progman-menus"></a>6.10. Menus</h3>
<div class="paragraph">
<p><a id="_ix633" class="ixterm"></a><a id="_ix634" class="ixterm"></a>This section lists every command of Program Manager&#8217;s menus. Commands that need a selected item are grey when none is selected; commands that change an item or a group are grey for Installed Programs.</p>
</div>
<div class="sect3">
<h4 id="progman-file-menu"><a class="anchor" href="#progman-file-menu"></a>6.10.1. File menu</h4>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 25%;">
<col style="width: 75%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Command</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>New Item&#8230;&#8203;</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Adds an item to the selected group (see <a href="#progman-adding">Section 6.4.2</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>New Group&#8230;&#8203;</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Makes a group (see <a href="#progman-new-group">Section 6.3.2</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Open</strong> (<kbd>Enter</kbd>)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Starts the selected item.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Move&#8230;&#8203;</strong> (<kbd>F7</kbd>)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Moves the selected item to another of your groups (see <a href="#progman-moving">Section 6.4.7</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Copy&#8230;&#8203;</strong> (<kbd>F8</kbd>)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Copies the selected item to one of your groups (see <a href="#progman-copying">Section 6.4.8</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Delete</strong> (<kbd>Del</kbd>)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Deletes the selected item from its group (see <a href="#progman-deleting">Section 6.4.9</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Rename&#8230;&#8203;</strong> (<kbd>F2</kbd>)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Renames the selected item (see <a href="#progman-renaming">Section 6.4.6</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Properties&#8230;&#8203;</strong> (<span class="keyseq"><kbd>Alt</kbd>+<kbd>Enter</kbd></span>)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Shows or changes the selected item&#8217;s properties (see <a href="#progman-properties">Section 6.4.3</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Rename Group&#8230;&#8203;</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Renames the selected group (see <a href="#progman-rename-group">Section 6.3.3</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Delete Group</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Deletes the selected group and its items (see <a href="#progman-delete-group">Section 6.3.4</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Run&#8230;&#8203;</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Starts a program or opens a document by its name (see <a href="#progman-run">Section 6.7</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Exit DVX</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Leaves DVX, after asking you first (see <a href="#desktop-exit">Section 5.16</a>).</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><strong>Open</strong>, <strong>Copy&#8230;&#8203;</strong>, and <strong>Properties&#8230;&#8203;</strong> need a selected item; <strong>Move&#8230;&#8203;</strong>, <strong>Delete</strong>, and <strong>Rename&#8230;&#8203;</strong> need a selected item in one of your own groups; <strong>Rename Group&#8230;&#8203;</strong> and <strong>Delete Group</strong> need one of your own groups selected.</p>
</div>
</div>
<div class="sect3">
<h4 id="progman-view-menu"><a class="anchor" href="#progman-view-menu"></a>6.10.2. View menu</h4>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 25%;">
<col style="width: 75%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Command</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Large Icons</strong>, <strong>Small Icons</strong>, <strong>List</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">How the items are shown; a diamond marks the one in use (see <a href="#progman-views">Section 6.5</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Auto Arrange</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Keeps the items in order, row after row. A tick mark shows that it is on.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Arrange Icons</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Lines the items up again, when <strong>Auto Arrange</strong> is off.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Refresh</strong> (<kbd>F5</kbd>)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Looks for programs that were installed or removed.</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect3">
<h4 id="progman-options-menu"><a class="anchor" href="#progman-options-menu"></a>6.10.3. Options menu</h4>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 25%;">
<col style="width: 75%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Command</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Minimize on Run</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Minimizes Program Manager each time you start a program (see <a href="#progman-options">Section 6.9</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Restore when Alone</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Brings Program Manager back when no other program is running.</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect3">
<h4 id="progman-window-menu"><a class="anchor" href="#progman-window-menu"></a>6.10.4. Window menu</h4>
<div class="paragraph">
<p><a id="_ix635" class="ixterm"></a>The commands of the <b class="menuref">Window</b> menu arrange every window on the screen that is not minimized, Program Manager&#8217;s included. <a href="#desktop-arranging">Section 5.3.10</a> describes what each one does.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 25%;">
<col style="width: 75%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Command</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Cascade</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Stacks the windows like a staircase from the top left corner.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Tile</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Arranges the windows in a grid that fills the screen.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Tile Horizontally</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Puts the windows one above the other, each as wide as the screen.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Tile Vertically</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Puts the windows side by side, each as tall as the screen.</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect3">
<h4 id="progman-help-menu"><a class="anchor" href="#progman-help-menu"></a>6.10.5. Help menu</h4>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 25%;">
<col style="width: 75%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Command</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Contents</strong> (<kbd>F1</kbd>)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens Program Manager&#8217;s own help.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>DVX Help</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix636" class="ixterm"></a>Opens the general DVX help, a short guide to the desktop, settings, and troubleshooting (see <a href="#desktop-help">Section 5.11</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>About DVX&#8230;&#8203;</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix637" class="ixterm"></a>Shows the DVX version number (1.0.0), the name &#8220;DOS Visual eXecutive&#8221;, the copyright, and the web address of Kangaroo Punch Studios.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>System Information&#8230;&#8203;</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix638" class="ixterm"></a>Opens a <strong>System Information</strong> window (see below).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Task Manager</strong> (<span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Esc</kbd></span>)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens the Task Manager (see <a href="#desktop-task-manager">Section 5.10</a>).</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix639" class="ixterm"></a><a id="_ix640" class="ixterm"></a><a id="_ix641" class="ixterm"></a>The <strong>System Information</strong> window shows details about your computer, in sections headed <strong>CPU</strong>, <strong>Memory</strong>, <strong>DOS</strong>, <strong>Video</strong>, <strong>Mouse</strong>, and <strong>Disk Drives</strong>, then <strong>Log</strong>. You can scroll the text but not change it, and you can change the size of the window. DVX gathers this information each time you open the window, so the free memory, the screen mode, and the free disk space are those of that moment. The <strong>Log</strong> section says where DVX&#8217;s log file is, or, when DVX can write no log file, shows the latest lines of the log, which DVX then keeps in memory (see <a href="#folders-log">Section B.6</a>). If no information could be gathered, a message says &#8220;No system information available.&#8221;</p>
</div>
</div>
<div class="sect3">
<h4 id="progman-context-menus"><a class="anchor" href="#progman-context-menus"></a>6.10.6. Right-click menus</h4>
<div class="paragraph">
<p><a id="_ix642" class="ixterm"></a>Right-clicking an item selects it and opens a menu with <strong>Open</strong>, <strong>Move&#8230;&#8203;</strong>, <strong>Copy&#8230;&#8203;</strong>, <strong>Delete</strong>, <strong>Rename&#8230;&#8203;</strong>, <strong>Properties&#8230;&#8203;</strong>, and <strong>New Item&#8230;&#8203;</strong>. Right-clicking empty space in the icon area opens the same menu for the item that was already selected.</p>
</div>
<div class="paragraph">
<p>Right-clicking the Groups list opens a menu with <strong>New Group&#8230;&#8203;</strong>, <strong>Rename Group&#8230;&#8203;</strong>, and <strong>Delete Group</strong>, which act on the selected group.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="progman-keys"><a class="anchor" href="#progman-keys"></a>6.11. Keyboard shortcuts in Program Manager</h3>
<div class="paragraph">
<p><a id="_ix643" class="ixterm"></a><a id="_ix644" class="ixterm"></a>These keys work in the Program Manager window:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 28.5714%;">
<col style="width: 71.4286%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Tab</kbd>, <span class="keyseq"><kbd>Shift</kbd>+<kbd>Tab</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Move between the Groups list, the Search box, and the icon area.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Alt</kbd>+<kbd>G</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Go to the Groups list.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Alt</kbd>+<kbd>S</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Go to the Search box.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Arrow keys, <kbd>Home</kbd>, <kbd>End</kbd>, <kbd>Page Up</kbd>, <kbd>Page Down</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Move between the icons.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">A letter or digit</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Go to the next icon whose name starts with it (in the icon area).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Enter</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Start the selected item (in the icon area).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Del</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Delete the selected item (in the icon area).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F2</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Rename the selected item (in the icon area).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Alt</kbd>+<kbd>Enter</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Properties of the selected item.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F5</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Look for programs that were installed or removed.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F7</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Move the selected item to another group.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F8</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Copy the selected item to a group.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F1</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Open Program Manager&#8217;s help.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Esc</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Open the Task Manager.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>The shortcut keys you give your items work in every program (see <a href="#progman-shortcut-keys">Section 6.4.4</a>), and the keys of <a href="#desktop-keys">Section 5.9</a> work here too.</p>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="controlPanel"><a class="anchor" href="#controlPanel"></a>Chapter 7. Control Panel</h2>
<div class="sectionbody">
<div class="paragraph">
<p><a id="_ix645" class="ixterm"></a><a id="_ix646" class="ixterm"></a>Control Panel is where you change how DVX looks and works. It sets the mouse, the colors of every part of the screen, the picture behind the windows (the wallpaper), the screen saver, the screen resolution and number of colors, which program opens each kind of file, the network settings, the printer, game controllers (joysticks), and the sounds DVX makes and the sound hardware it uses.</p>
</div>
<div class="paragraph">
<p>Most changes show up as soon as you make them, so you can see what they do before you decide to keep them. This chapter first explains how to open Control Panel and how its <b class="button">OK</b> and <b class="button">Cancel</b> buttons work, then describes each of its nine pages in the order the window shows them.</p>
</div>
<div class="sect2">
<h3 id="cpanel-opening"><a class="anchor" href="#cpanel-opening"></a>7.1. Opening Control Panel</h3>
<div class="paragraph">
<p><a id="_ix647" class="ixterm"></a><a id="_ix648" class="ixterm"></a>Control Panel is part of DVX itself, so it is always installed. To open it:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>In Program Manager, click the <strong>Installed Programs</strong> group.</p>
</li>
<li>
<p>Double-click the <strong>Control Panel</strong> icon. (When the icon is selected, the status bar at the bottom of Program Manager says &#8220;System settings and preferences&#8221;.)</p>
</li>
</ol>
</div>
<div class="paragraph">
<p><a id="_ix649" class="ixterm"></a>You can also open it from the Welcome window: click <b class="button">Make it yours</b> (or the picture beside it). See <a href="#programs-welcome">Section 8.10</a>.</p>
</div>
<div class="paragraph">
<p><a id="_ix650" class="ixterm"></a><a id="_ix651" class="ixterm"></a>Only one Control Panel can be open at a time. If it is already open, starting it again shows the message &#8220;<em>name</em> is already running.&#8221;, with Control Panel&#8217;s file name in place of <em>name</em>. Switch to the Control Panel window that is already open instead, for example with Task Manager (see <a href="#desktop-task-manager">Section 5.10</a>).</p>
</div>
</div>
<div class="sect2">
<h3 id="cpanel-window"><a class="anchor" href="#cpanel-window"></a>7.2. The Control Panel window</h3>
<div class="paragraph">
<p><a id="_ix652" class="ixterm"></a>The window is titled <strong>Control Panel</strong>. It opens in the middle of the screen, and you can make it larger by dragging its border.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/cpMouse.png" alt="The Control Panel window with its row of tabs" width="the Mouse page" height="and the OK and Cancel buttons">
</div>
<div class="title">Figure 27. The Control Panel window, open at the Mouse page</div>
</div>
<div class="paragraph">
<p>The window has three parts:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><a id="_ix653" class="ixterm"></a>A menu bar with one menu, <strong>Help</strong>. <span class="menuseq"><b class="menu">Help</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Contents</b></span> (or <kbd>F1</kbd>) opens Control Panel&#8217;s help in DVX Help. <span class="menuseq"><b class="menu">Help</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">About Control Panel&#8230;&#8203;</b></span> shows the program&#8217;s name, what it does, and its copyright.</p>
</li>
<li>
<p><a id="_ix654" class="ixterm"></a>A row of tabs, one for each page: <strong>Mouse</strong>, <strong>Colors</strong>, <strong>Desktop</strong>, <strong>Video</strong>, <strong>File Types</strong>, <strong>Network</strong>, <strong>Printer</strong>, <strong>Game Controllers</strong>, and <strong>Sounds</strong>. Click a tab to see its page. When the window is too narrow to show every tab, click the small arrows at the ends of the row to scroll to the others.</p>
</li>
<li>
<p><a id="_ix655" class="ixterm"></a>The <b class="button">OK</b> and <b class="button">Cancel</b> buttons at the bottom right, which work for all the pages together (see <a href="#cpanel-changes">Section 7.3</a>).</p>
</li>
</ul>
</div>
<div class="paragraph">
<p><a id="_ix656" class="ixterm"></a>There is no Apply button for the whole window. The <b class="button">Apply</b> buttons on the Colors and Desktop pages, and <b class="button">Apply Mode</b> on the Video page, only put the theme, picture, or screen mode chosen in their lists on the screen so you can see it. To keep it, you still click <b class="button">OK</b>.</p>
</div>
<div class="paragraph">
<p><a id="_ix657" class="ixterm"></a><a id="_ix658" class="ixterm"></a>A few pages need parts of DVX that might be missing. When one is missing, its page shows a single line instead of its settings:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 33.3333%;">
<col style="width: 66.6667%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Page</th>
<th class="tableblock halign-left valign-top">Line shown when its part is missing</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Network</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Networking is not installed.&#8221; Networking is an optional part of DVX; see <a href="#installing-parts">Section 3.5</a> to add it.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Printer</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Printing is not installed.&#8221;</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Game Controllers</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Game controller support is not installed.&#8221;</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Sounds</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Sound is not installed.&#8221;</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>Printing, game controller support, and sound are part of DVX itself, so you see the last three lines only if some of DVX&#8217;s files are missing.</p>
</div>
<div class="sect3">
<h4 id="cpanel-keyboard"><a class="anchor" href="#cpanel-keyboard"></a>7.2.1. Using the keyboard</h4>
<div class="paragraph">
<p><a id="_ix659" class="ixterm"></a><a id="_ix660" class="ixterm"></a>You can use Control Panel without a mouse:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 25%;">
<col style="width: 75%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F1</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens Control Panel&#8217;s help.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Alt</kbd>+<kbd>H</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens the <strong>Help</strong> menu.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Tab</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Moves to the next setting or button. <kbd>Space</kbd> or <kbd>Enter</kbd> presses the button that is highlighted.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Enter</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Presses <b class="button">OK</b>, as in a dialog box (see <a href="#desktop-dialog-boxes">Section 5.5.1</a>), when no button is highlighted. On a list, such as the list of video modes, it presses <b class="button">OK</b> too: to use the item, double-click it or click its button.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Esc</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Presses <b class="button">Cancel</b>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Left</kbd> and <kbd>Right</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">When the row of tabs is highlighted: shows the page of the previous or next tab (after the last tab comes the first).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Home</kbd> and <kbd>End</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">When the row of tabs is highlighted: shows the first or last page.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>The tab names have no underlined letters. On the pages, some labels and buttons do: <kbd>Alt</kbd> with the underlined letter moves to that setting or presses that button. They are <strong>Screen saver</strong> (<span class="keyseq"><kbd>Alt</kbd>+<kbd>V</kbd></span>), <strong>Wait</strong> (<span class="keyseq"><kbd>Alt</kbd>+<kbd>W</kbd></span>), and <b class="button">Test</b> (<span class="keyseq"><kbd>Alt</kbd>+<kbd>T</kbd></span>) on the Desktop page; <b class="button">Add&#8230;&#8203;</b> (<span class="keyseq"><kbd>Alt</kbd>+<kbd>A</kbd></span>), <b class="button">Change&#8230;&#8203;</b> (<span class="keyseq"><kbd>Alt</kbd>+<kbd>C</kbd></span>), and <b class="button">Remove</b> (<span class="keyseq"><kbd>Alt</kbd>+<kbd>R</kbd></span>) on the File Types page; and <b class="button">Browse&#8230;&#8203;</b> (<span class="keyseq"><kbd>Alt</kbd>+<kbd>B</kbd></span>) on the Printer page. Only the page showing is searched for the letter.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="cpanel-changes"><a class="anchor" href="#cpanel-changes"></a>7.3. Trying out, keeping, and canceling changes</h3>
<div class="paragraph">
<p><a id="_ix661" class="ixterm"></a><a id="_ix662" class="ixterm"></a>Control Panel lets you try most changes before you keep them. Some settings change the screen or the mouse the moment you change them; others wait until you click <b class="button">OK</b>; and a few wait until DVX starts again. This table shows which is which:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">When it takes effect</th>
<th class="tableblock halign-left valign-top">Settings</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">At once, while you try it out. <b class="button">OK</b> keeps it; <b class="button">Cancel</b> puts it back.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Every setting on the Mouse page. Colors and themes. The wallpaper and its <strong>Mode</strong>. The screen saver and its <strong>Wait</strong>. The video mode (once you click <b class="button">Keep</b>; <b class="button">OK</b> saves it only if you chose a mode on the Video page). <strong>Smooth the edges of text</strong>. Every setting on the Game Controllers page, including a calibration. <strong>Volume</strong> on the Sounds page.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">When you click <b class="button">OK</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Changes on the File Types page. Every setting on the Network page. Every setting on the Printer page except Page Setup. The sound for each event on the Sounds page.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">For the next music that starts, after you click <b class="button">OK</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Modules</strong>, <strong>Instruments</strong>, and <strong>SoundFont</strong> on the Sounds page.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">The next time DVX starts, after you click <b class="button">OK</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Sound driver</strong>, <strong>MIDI music</strong>, and <strong>MIDI in</strong> on the Sounds page.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">At once, and kept even if you click <b class="button">Cancel</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A theme saved with <b class="button">Save As&#8230;&#8203;</b> on the Colors page (the theme file stays saved). Page Setup changes (saved when you click <b class="button">OK</b> in the <strong>Page Setup</strong> dialog). <b class="button">Restart</b> on the Network page (the network restarts at once).</p></td>
</tr>
</tbody>
</table>
<div class="sect3">
<h4 id="cpanel-ok"><a class="anchor" href="#cpanel-ok"></a>7.3.1. Clicking OK</h4>
<div class="paragraph">
<p><a id="_ix663" class="ixterm"></a><a id="_ix664" class="ixterm"></a>When you click <b class="button">OK</b>, Control Panel first checks the Network and Printer pages. If a setting there cannot work, a warning box titled <strong>Network</strong> or <strong>Printer</strong> says what is wrong, and Control Panel stays open so you can fix it (the messages are listed with those pages). Otherwise Control Panel:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Saves your settings, so DVX uses them again every time it starts. Only the settings you changed are saved: anything another program saved while Control Panel was open (Software&#8217;s package server, for example), and anything you typed into <code>DVX.INI</code> meanwhile, stays as it is. The video mode is saved only if you chose one on the Video page.</p>
</li>
<li>
<p>Puts your File Types changes into effect.</p>
</li>
<li>
<p>Restarts the network with the new settings, if you changed them.</p>
</li>
<li>
<p>Starts using the new sounds for the events.</p>
</li>
<li>
<p>Closes.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>DVX keeps most of these settings in the file <code>DVX.INI</code> in your USER folder. See <a href="#folders-dvx-ini">Section B.2</a>.</p>
</div>
<div class="paragraph">
<p><a id="_ix665" class="ixterm"></a>If your settings cannot be saved, for example because the disk is full, a box titled <strong>Control Panel</strong> says &#8220;The settings could not be saved: the disk may be full or write-protected. Control Panel stays open: click its OK to try again, or Cancel to undo the changes.&#8221; Nothing is saved, and the settings you tried out are still in use. Make room on the disk and click <b class="button">OK</b> again, or click <b class="button">Cancel</b>. <a id="_ix666" class="ixterm"></a>If only the File Types changes cannot be saved, the box says &#8220;The file types could not be saved: the disk may be full or write-protected.&#8221;, and Control Panel closes with your other settings saved.</p>
</div>
</div>
<div class="sect3">
<h4 id="cpanel-cancel"><a class="anchor" href="#cpanel-cancel"></a>7.3.2. Clicking Cancel</h4>
<div class="paragraph">
<p><a id="_ix667" class="ixterm"></a>Clicking <b class="button">Cancel</b>, or closing the window, puts back the mouse settings, the colors, the wallpaper and its mode, the screen saver and its wait, the video mode, text smoothing, the game controller settings, and the volume as they were when you opened Control Panel. File Types, Network, Printer, and Sounds choices you had not saved are forgotten. Nothing is saved.</p>
</div>
<div class="paragraph">
<p>The exceptions are the ones in the last row of the table above: a theme file you saved, Page Setup changes, and a network restart cannot be undone with <b class="button">Cancel</b>.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="cpanel-mouse"><a class="anchor" href="#cpanel-mouse"></a>7.4. Mouse page</h3>
<div class="paragraph">
<p><a id="_ix668" class="ixterm"></a><a id="_ix669" class="ixterm"></a>The Mouse page sets how fast the pointer moves, how quickly you must double-click, and how the scroll wheel works. It is the page Control Panel shows when it opens (see the picture in <a href="#cpanel-window">Section 7.2</a>). Every change works at once, so you can try it with the mouse before you click <b class="button">OK</b>.</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Scroll Wheel</strong></dt>
<dd>
<p><a id="_ix670" class="ixterm"></a><a id="_ix671" class="ixterm"></a><strong>Normal</strong> or <strong>Reversed</strong>. <strong>Reversed</strong> makes the wheel scroll the other way. It is <strong>Normal</strong> unless you change it.</p>
</dd>
<dt class="hdlist1"><strong>Scroll Speed</strong></dt>
<dd>
<p><a id="_ix672" class="ixterm"></a><a id="_ix673" class="ixterm"></a>How many lines each click of the wheel scrolls, from 1 (at the <strong>Slow</strong> end of the slider) to 10 (at the <strong>Fast</strong> end). The number is shown at the right. It starts at 3.</p>
</dd>
<dt class="hdlist1"><strong>Double-Click Speed</strong></dt>
<dd>
<p><a id="_ix674" class="ixterm"></a><a id="_ix675" class="ixterm"></a><a id="_ix676" class="ixterm"></a>How quickly you must click twice for DVX to count it as a double-click, from 200 to 900 milliseconds (thousandths of a second). This slider has <strong>Fast</strong> at the left and <strong>Slow</strong> at the right; toward <strong>Slow</strong> gives you more time. The time is shown at the right, such as <code>500 ms</code>, the setting it starts at.</p>
</dd>
<dt class="hdlist1"><strong>Acceleration</strong></dt>
<dd>
<p><a id="_ix677" class="ixterm"></a><a id="_ix678" class="ixterm"></a><strong>Off</strong>, <strong>Low</strong>, <strong>Medium</strong>, or <strong>High</strong>. With acceleration, moving the mouse quickly makes the pointer travel farther. It starts at <strong>Medium</strong>.</p>
</dd>
<dt class="hdlist1"><strong>Cursor Speed</strong></dt>
<dd>
<p><a id="_ix679" class="ixterm"></a><a id="_ix680" class="ixterm"></a><a id="_ix681" class="ixterm"></a>How far the pointer moves when you move the mouse. Toward <strong>Fast</strong> moves it farther. The number at the right is the slider&#8217;s position, from 2 to 32; it starts at 26.</p>
</dd>
<dt class="hdlist1"><b class="button">Test Area</b></dt>
<dd>
<p><a id="_ix682" class="ixterm"></a><a id="_ix683" class="ixterm"></a>Double-click this button to test the double-click speed. Each time it sees a double-click, the text beside it, &#8220;Double-click the button to test&#8221;, changes to &#8220;Double-click detected! (<em>n</em>)&#8221;, with <em>n</em> counting up.</p>
</dd>
</dl>
</div>
<div class="sect3">
<h4 id="cpanel-mouse-double-click"><a class="anchor" href="#cpanel-mouse-double-click"></a>7.4.1. Adjusting the double-click speed</h4>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Click the <strong>Mouse</strong> tab.</p>
</li>
<li>
<p>Double-click the <b class="button">Test Area</b> button the way you usually double-click.</p>
</li>
<li>
<p>If the text beside it does not change to &#8220;Double-click detected!&#8221;, drag the <strong>Double-Click Speed</strong> slider toward <strong>Slow</strong> and try again. If DVX takes two separate clicks for a double-click, move it toward <strong>Fast</strong>.</p>
</li>
<li>
<p>Click <b class="button">OK</b> to keep the setting.</p>
</li>
</ol>
</div>
<div class="admonitionblock tip">
<table>
<tr>
<td class="icon">
<div class="title">Tip</div>
</td>
<td class="content">
If the pointer is hard to control, set <strong>Acceleration</strong> to <strong>Off</strong> and adjust <strong>Cursor Speed</strong> until it feels right. Then turn acceleration back on if you like.
</td>
</tr>
</table>
</div>
<div class="admonitionblock note">
<table>
<tr>
<td class="icon">
<div class="title">Note</div>
</td>
<td class="content">
<a id="_ix684" class="ixterm"></a>The scroll wheel works only with a mouse driver that supports wheels, such as CuteMouse (CTMOUSE). With another driver, <strong>Scroll Wheel</strong> and <strong>Scroll Speed</strong> do nothing, and everything else works as usual. See <a href="#trouble-mouse">Section 11.4</a>.
</td>
</tr>
</table>
</div>
</div>
</div>
<div class="sect2">
<h3 id="cpanel-colors"><a class="anchor" href="#cpanel-colors"></a>7.5. Colors page</h3>
<div class="paragraph">
<p><a id="_ix685" class="ixterm"></a><a id="_ix686" class="ixterm"></a><a id="_ix687" class="ixterm"></a>The Colors page sets the color of every part of the screen: the desktop, title bars, menus, buttons, and so on. You can change the colors one at a time, or all at once with a theme, a saved set of all the colors. Every change shows at once.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/cpColors.png" alt="Control Panel&#8217;s Colors page" width="with the System Colors list" height="the selected color">
</div>
<div class="title">Figure 28. The Colors page</div>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>System Colors</strong></dt>
<dd>
<p><a id="_ix688" class="ixterm"></a><a id="_ix689" class="ixterm"></a>The list of the parts of the screen that have a color: <strong>Desktop</strong>, <strong>Window Face</strong>, <strong>Window Highlight</strong>, <strong>Window Shadow</strong>, <strong>Active Title Bar</strong>, <strong>Active Title Text</strong>, <strong>Inactive Title Bar</strong>, <strong>Inactive Title Text</strong>, <strong>Content Background</strong>, <strong>Content Text</strong>, <strong>Menu Background</strong>, <strong>Menu Text</strong>, <strong>Menu Highlight</strong>, <strong>Menu Highlight Text</strong>, <strong>Button Face</strong>, <strong>Scrollbar Background</strong>, <strong>Scrollbar Foreground</strong>, <strong>Scrollbar Trough</strong>, <strong>Cursor Color</strong>, and <strong>Cursor Outline</strong>. Click a name to see its color at the right. Double-click a name to change its color.</p>
</dd>
<dt class="hdlist1"><strong>Color</strong></dt>
<dd>
<p>The selected part&#8217;s color, with its amounts of red, green, and blue below it (<code>Red 0</code>, <code>Green 128</code>, <code>Blue 128</code>, for example). Each amount goes from 0 (none of that color) to 255 (full).</p>
</dd>
<dt class="hdlist1"><b class="button">Change&#8230;&#8203;</b></dt>
<dd>
<p><a id="_ix690" class="ixterm"></a>Opens the color box for the selected part (described below). Double-clicking the name does the same.</p>
</dd>
<dt class="hdlist1"><strong>Theme</strong></dt>
<dd>
<p><a id="_ix691" class="ixterm"></a><a id="_ix692" class="ixterm"></a>The themes you can choose from, by name, in alphabetical order. DVX comes with four: <strong>cde</strong> (the colors of CDE), <strong>geos</strong> (GEOS Ensemble), <strong>hotdog</strong> (Hot Dog Stand: yellow, red, and black), and <strong>win31</strong> (Windows 3.1). Themes you save yourself are listed too. The list shows nothing until you choose a theme in it.</p>
</dd>
<dt class="hdlist1"><b class="button">Apply</b></dt>
<dd>
<p><a id="_ix693" class="ixterm"></a>Uses the colors of the theme chosen in the <strong>Theme</strong> list.</p>
</dd>
<dt class="hdlist1"><b class="button">Load&#8230;&#8203;</b></dt>
<dd>
<p><a id="_ix694" class="ixterm"></a>Opens a <strong>Load Theme</strong> box, where you can choose a theme file (a file ending in .THM) in any folder, such as one on a floppy disk. Its colors are used at once.</p>
</dd>
<dt class="hdlist1"><b class="button">Save As&#8230;&#8203;</b></dt>
<dd>
<p><a id="_ix695" class="ixterm"></a>Saves the current colors as a new theme file. The <strong>Save Theme</strong> box starts in the THEMES folder in your USER folder; a theme saved there appears in the <strong>Theme</strong> list.</p>
</dd>
<dt class="hdlist1"><b class="button">Reset</b></dt>
<dd>
<p><a id="_ix696" class="ixterm"></a><a id="_ix697" class="ixterm"></a>Puts back DVX&#8217;s standard colors: a teal desktop, grey windows, and charcoal title bars.</p>
</dd>
</dl>
</div>
<div class="sect3">
<h4 id="cpanel-colors-box"><a class="anchor" href="#cpanel-colors-box"></a>7.5.1. The color box</h4>
<div class="paragraph">
<p><a id="_ix698" class="ixterm"></a><a id="_ix699" class="ixterm"></a><b class="button">Change&#8230;&#8203;</b> opens a box titled with the name of the part you are changing. It has:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>A grid of 48 basic colors (8 across and 6 down). Click one to choose it.</p>
</li>
<li>
<p><strong>Red</strong>, <strong>Green</strong>, and <strong>Blue</strong> rows, each with a slider and a number box from 0 to 255, for mixing a color of your own. Drag a slider or type a number.</p>
</li>
<li>
<p>A preview of the color you are making.</p>
</li>
<li>
<p><b class="button">OK</b>, which changes the part to the new color at once, and <b class="button">Cancel</b>, which leaves it as it was.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>The underlined letters are R, G, and B for the three rows, O for <b class="button">OK</b>, and C for <b class="button">Cancel</b>.</p>
</div>
</div>
<div class="sect3">
<h4 id="cpanel-colors-theme"><a class="anchor" href="#cpanel-colors-theme"></a>7.5.2. Choosing a theme</h4>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Click the <strong>Colors</strong> tab.</p>
</li>
<li>
<p>Choose a theme in the <strong>Theme</strong> list.</p>
</li>
<li>
<p>Click <b class="button">Apply</b>. The whole screen changes to the theme&#8217;s colors.</p>
</li>
<li>
<p>Click <b class="button">OK</b> to keep the colors, or <b class="button">Cancel</b> to go back to the ones you had.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>To use a theme file that is not in the list, click <b class="button">Load&#8230;&#8203;</b> instead of choosing from the list, find the file, and click <b class="button">Open</b>. To go back to DVX&#8217;s own colors, click <b class="button">Reset</b>.</p>
</div>
</div>
<div class="sect3">
<h4 id="cpanel-colors-own"><a class="anchor" href="#cpanel-colors-own"></a>7.5.3. Changing a color and saving your own theme</h4>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>On the <strong>Colors</strong> page, click a name in the <strong>System Colors</strong> list, such as <strong>Desktop</strong>, and click <b class="button">Change&#8230;&#8203;</b> (or double-click the name).</p>
</li>
<li>
<p>In the color box, click one of the basic colors, or set <strong>Red</strong>, <strong>Green</strong>, and <strong>Blue</strong>. Watch the preview.</p>
</li>
<li>
<p>Click <b class="button">OK</b> in the color box. The part changes color at once.</p>
</li>
<li>
<p>Repeat for any other parts you want to change.</p>
</li>
<li>
<p><a id="_ix700" class="ixterm"></a>To keep this set of colors as a theme, click <b class="button">Save As&#8230;&#8203;</b>. In the <strong>Save Theme</strong> box, type a name in <strong>File name</strong>, such as <code>MYCOLORS</code>, and click <b class="button">Save</b>. If you do not type an ending, DVX adds <code>.THM</code>. The new theme appears in the <strong>Theme</strong> list.</p>
</li>
<li>
<p>Click <b class="button">OK</b> on Control Panel to keep the colors.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p><a id="_ix701" class="ixterm"></a><a id="_ix702" class="ixterm"></a>If the name is too long to add <code>.THM</code> to, DVX says &#8220;Theme file name is too long.&#8221; If the file cannot be written, for example because the disk is full, it says &#8220;Could not save the theme file.&#8221;</p>
</div>
<div class="admonitionblock note">
<table>
<tr>
<td class="icon">
<div class="title">Note</div>
</td>
<td class="content">
A theme file you save stays saved even if you then click <b class="button">Cancel</b>. <b class="button">Cancel</b> only puts the screen&#8217;s colors back.
</td>
</tr>
</table>
</div>
</div>
</div>
<div class="sect2">
<h3 id="cpanel-desktop"><a class="anchor" href="#cpanel-desktop"></a>7.6. Desktop page</h3>
<div class="paragraph">
<p><a id="_ix703" class="ixterm"></a><a id="_ix704" class="ixterm"></a>The Desktop page has two parts: the wallpaper, a picture shown on the desktop behind all the windows, and, in the bottom row, the screen saver. Every change on this page shows at once.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/cpDesktop.png" alt="Control Panel&#8217;s Desktop page" width="with the Wallpaper list" height="its buttons and Mode list">
</div>
<div class="title">Figure 29. The Desktop page</div>
</div>
<div class="sect3">
<h4 id="cpanel-desktop-wallpaper"><a class="anchor" href="#cpanel-desktop-wallpaper"></a>7.6.1. Wallpaper</h4>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Wallpaper</strong></dt>
<dd>
<p><a id="_ix705" class="ixterm"></a><a id="_ix706" class="ixterm"></a><a id="_ix707" class="ixterm"></a>The pictures you can choose from, by file name, in alphabetical order. DVX comes with three: <code>blueglow.jpg</code>, <code>swoop.jpg</code>, and <code>triangle.jpg</code>. Double-click a picture to put it on the desktop at once.</p>
</dd>
<dt class="hdlist1">The line under the list</dt>
<dd>
<p>Shows the picture in use, or <code>(none)</code>.</p>
</dd>
<dt class="hdlist1"><b class="button">Apply</b></dt>
<dd>
<p>Puts the picture selected in the list on the desktop.</p>
</dd>
<dt class="hdlist1"><b class="button">Browse&#8230;&#8203;</b></dt>
<dd>
<p><a id="_ix708" class="ixterm"></a>Opens a <strong>Choose Wallpaper</strong> box, where you can pick any BMP, JPEG, PNG, or GIF picture in any folder. The picture goes on the desktop at once.</p>
</dd>
<dt class="hdlist1"><b class="button">Clear</b></dt>
<dd>
<p><a id="_ix709" class="ixterm"></a>Removes the picture, leaving the plain desktop color (the <strong>Desktop</strong> color on the Colors page).</p>
</dd>
<dt class="hdlist1"><strong>Mode</strong></dt>
<dd>
<p><a id="_ix710" class="ixterm"></a><a id="_ix711" class="ixterm"></a>How the picture fills the screen. <strong>Stretch</strong> (the usual setting) stretches the picture to fill the whole screen. <strong>Tile</strong> repeats the picture across the screen like floor tiles. <strong>Center</strong> shows the picture once, in the middle of the screen.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p><a id="_ix712" class="ixterm"></a>If DVX cannot load a picture, it says &#8220;Could not load wallpaper image.&#8221; and the desktop stays as it was.</p>
</div>
<div class="admonitionblock tip">
<table>
<tr>
<td class="icon">
<div class="title">Tip</div>
</td>
<td class="content">
<a id="_ix713" class="ixterm"></a>To have your own pictures in the <strong>Wallpaper</strong> list, copy them into a folder named WPAPER in your USER folder (make the folder if it is not there). <b class="button">Browse&#8230;&#8203;</b> also starts in that folder when it exists.
</td>
</tr>
</table>
</div>
<div class="paragraph">
<p>To set the wallpaper:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Click the <strong>Desktop</strong> tab.</p>
</li>
<li>
<p>Click a picture in the <strong>Wallpaper</strong> list and click <b class="button">Apply</b>, or double-click the picture. To use a picture from another folder, click <b class="button">Browse&#8230;&#8203;</b> instead and choose it.</p>
</li>
<li>
<p>Choose <strong>Stretch</strong>, <strong>Tile</strong>, or <strong>Center</strong> in the <strong>Mode</strong> list.</p>
</li>
<li>
<p>Click <b class="button">OK</b> to keep the wallpaper.</p>
</li>
</ol>
</div>
</div>
<div class="sect3">
<h4 id="cpanel-desktop-saver"><a class="anchor" href="#cpanel-desktop-saver"></a>7.6.2. Screen saver</h4>
<div class="paragraph">
<p><a id="_ix714" class="ixterm"></a><a id="_ix715" class="ixterm"></a>A screen saver fills the screen with a moving picture when the computer has not been used for a while, and goes away when you press a key or move the mouse. The screen saver row has three settings:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Screen saver</strong></dt>
<dd>
<p><a id="_ix716" class="ixterm"></a><strong>(None)</strong>, for no screen saver, then each screen saver by its name. <strong>(None)</strong> is chosen until you choose a screen saver. DVX comes with four:</p>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 25%;">
<col style="width: 75%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Screen saver</th>
<th class="tableblock halign-left valign-top">What it shows</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Blank Screen</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A black screen.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Marquee</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The words &#8220;The DOS Visual eXecutive&#8221; drifting across the screen, bouncing off the edges and changing color.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Mystify</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Two four-cornered outlines bouncing around the screen, each leaving a trail of outlines behind it and changing color every few seconds.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Starfield</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Stars flying out of the middle of the screen, as if you were moving through them.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>Screen savers that come with add-ons are listed too. See <a href="#programs-screen-savers">Section 8.12</a>.</p>
</div>
</dd>
<dt class="hdlist1"><strong>Wait</strong></dt>
<dd>
<p><a id="_ix717" class="ixterm"></a><a id="_ix718" class="ixterm"></a>The number of minutes, from 1 to 60, with no key pressed and no mouse movement before the screen saver starts. It starts at 10.</p>
</dd>
<dt class="hdlist1"><b class="button">Test</b></dt>
<dd>
<p><a id="_ix719" class="ixterm"></a>Starts the chosen screen saver now, so you can see it. Press a key or move the mouse to end it. <b class="button">Test</b> is greyed out while <strong>(None)</strong> is chosen.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>The screen saver does not start while a message or dialog box is waiting for an answer, or while a program (such as a game) is using the whole screen. The key you press or the mouse movement that wakes the screen does nothing else, so it cannot change your work. See <a href="#desktop-screen-saver">Section 5.12</a>.</p>
</div>
<div class="paragraph">
<p>To choose and test a screen saver:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Click the <strong>Desktop</strong> tab.</p>
</li>
<li>
<p>Choose a screen saver in the <strong>Screen saver</strong> list (<span class="keyseq"><kbd>Alt</kbd>+<kbd>V</kbd></span>).</p>
</li>
<li>
<p>Set <strong>Wait</strong> (<span class="keyseq"><kbd>Alt</kbd>+<kbd>W</kbd></span>) to the number of minutes the computer must be idle before it starts.</p>
</li>
<li>
<p>Click <b class="button">Test</b> (<span class="keyseq"><kbd>Alt</kbd>+<kbd>T</kbd></span>) to see it. Press a key or move the mouse to end it.</p>
</li>
<li>
<p>Click <b class="button">OK</b> to keep it.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>To turn the screen saver off, choose <strong>(None)</strong> and click <b class="button">OK</b>.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="cpanel-video"><a class="anchor" href="#cpanel-video"></a>7.7. Video page</h3>
<div class="paragraph">
<p><a id="_ix720" class="ixterm"></a><a id="_ix721" class="ixterm"></a><a id="_ix722" class="ixterm"></a>The Video page sets the screen mode: how many dots (pixels) the screen has across and down, and how many colors they can show. It also turns text smoothing on and off.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/cpVideo.png" alt="Control Panel&#8217;s Video page" width="with the list of video modes" height="the Apply Mode button">
</div>
<div class="title">Figure 30. The Video page</div>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Available Video Modes</strong></dt>
<dd>
<p><a id="_ix723" class="ixterm"></a><a id="_ix724" class="ixterm"></a>The modes your video card offers that DVX can use, from 640x480 up, such as <code>800x600 65 thousand colors</code>. The first two numbers are the width and height of the screen in dots; the rest says how many colors the screen can show: <code>256 colors</code>, <code>32 thousand colors</code>, <code>65 thousand colors</code>, or <code>16 million colors&#43;</code>. The mode you are using now is selected when the page opens.</p>
</dd>
<dt class="hdlist1"><b class="button">Apply Mode</b></dt>
<dd>
<p><a id="_ix725" class="ixterm"></a>Switches the screen to the mode selected in the list and asks whether to keep it (see below). Double-clicking a mode does the same. Choosing the mode you are already using does nothing.</p>
</dd>
<dt class="hdlist1"><strong>Smooth the edges of text (more than 256 colors)</strong></dt>
<dd>
<p><a id="_ix726" class="ixterm"></a><a id="_ix727" class="ixterm"></a><a id="_ix728" class="ixterm"></a>Softens the jagged steps on the curves and slants of letters by drawing their edges in shades between the text color and the background, the way printed text looks. It is on unless you turn it off, and the change shows at once in every window. Smoothing needs a mode with more than 256 colors; in a 256-color mode text is drawn sharp whatever the box says. Only the fonts and sizes that come smoothed are drawn this way; the system font is always sharp.</p>
</dd>
</dl>
</div>
<div class="admonitionblock tip">
<table>
<tr>
<td class="icon">
<div class="title">Tip</div>
</td>
<td class="content">
<a id="_ix729" class="ixterm"></a>Higher resolutions fit more on the screen but make everything smaller. More colors make pictures look better but can make DVX slower on older computers, and use more memory.
</td>
</tr>
</table>
</div>
<div class="sect3">
<h4 id="cpanel-video-change"><a class="anchor" href="#cpanel-video-change"></a>7.7.1. Changing the video mode</h4>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Click the <strong>Video</strong> tab.</p>
</li>
<li>
<p>Click a mode in the <strong>Available Video Modes</strong> list and click <b class="button">Apply Mode</b>, or double-click the mode.</p>
</li>
<li>
<p><a id="_ix730" class="ixterm"></a><a id="_ix731" class="ixterm"></a>The screen switches to the new mode. A box titled <strong>Keep this mode?</strong> asks &#8220;Keep this display mode?&#8221; and counts down: &#8220;The old mode comes back in 15 seconds.&#8221;</p>
</li>
<li>
<p>To keep the new mode, click <b class="button">Keep</b> (<span class="keyseq"><kbd>Alt</kbd>+<kbd>K</kbd></span>, or just <kbd>Enter</kbd>) before the countdown ends. To go back to the old mode, click <b class="button">Revert</b> (<span class="keyseq"><kbd>Alt</kbd>+<kbd>R</kbd></span>, or <kbd>Esc</kbd>), close the box, or just wait.</p>
</li>
<li>
<p>Click <b class="button">OK</b> on Control Panel to use the new mode every time DVX starts.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>If you click <b class="button">Cancel</b> on Control Panel instead, the screen goes back to the mode it was in when you opened Control Panel.</p>
</div>
<div class="paragraph">
<p><a id="_ix732" class="ixterm"></a><b class="button">OK</b> saves the video mode only if you chose one in the list. So after DVX has started in safe video mode, clicking <b class="button">OK</b> to keep other changes does not make the safe mode the one DVX starts in. To start in the mode you are using now from then on, click it in the list, click <b class="button">Apply Mode</b>, and then click <b class="button">OK</b>.</p>
</div>
</div>
<div class="sect3">
<h4 id="cpanel-video-problems"><a class="anchor" href="#cpanel-video-problems"></a>7.7.2. If the new mode does not work</h4>
<div class="ulist">
<ul>
<li>
<p><a id="_ix733" class="ixterm"></a><a id="_ix734" class="ixterm"></a>If the screen goes blank or you cannot read it, do nothing. After 15 seconds the old mode comes back by itself.</p>
</li>
<li>
<p><a id="_ix735" class="ixterm"></a>If DVX cannot switch to the mode at all, it says &#8220;Failed to change video mode.&#8221; and the screen stays as it was. Choose another mode.</p>
</li>
<li>
<p><a id="_ix736" class="ixterm"></a>If DVX starts one day and cannot use the mode you saved (for example, after you change the video card), it starts in safe video mode, 640x480, and asks whether to use that mode from now on. You can also start DVX in safe video mode yourself by holding down a <kbd>Shift</kbd> key while it starts. See <a href="#installing-safe-start">Section 3.13</a> and <a href="#trouble-video">Section 11.3</a>.</p>
</li>
</ul>
</div>
</div>
</div>
<div class="sect2">
<h3 id="cpanel-file-types"><a class="anchor" href="#cpanel-file-types"></a>7.8. File Types page</h3>
<div class="paragraph">
<p><a id="_ix737" class="ixterm"></a><a id="_ix738" class="ixterm"></a><a id="_ix739" class="ixterm"></a><a id="_ix740" class="ixterm"></a>When you open a document, for example by double-clicking it in File Manager or Program Manager, DVX starts the program set up for its kind of file. The kind of file is its extension: the letters after the dot, such as TXT in NOTES.TXT. The File Types page shows which program opens each kind, and lets you change it.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/cpFileTypes.png" alt="Control Panel&#8217;s File Types page" width="listing each file type" height="the program that opens it">
</div>
<div class="title">Figure 31. The File Types page</div>
</div>
<div class="paragraph">
<p><a id="_ix741" class="ixterm"></a>The list under &#8220;Documents of each type open in this program:&#8221; has three columns:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Type</strong></dt>
<dd>
<p>The extension, such as TXT.</p>
</dd>
<dt class="hdlist1"><strong>Opens with</strong></dt>
<dd>
<p>The name of the program that opens it, such as Notepad.</p>
</dd>
<dt class="hdlist1"><strong>Program</strong></dt>
<dd>
<p>The program&#8217;s file, as DVX keeps it (for example <code>apps\kpunch\notepad\notepad.app</code>), followed by its arguments, if it has any, after a comma.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>Under the list are three buttons:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><b class="button">Add&#8230;&#8203;</b></dt>
<dd>
<p><a id="_ix742" class="ixterm"></a><a id="_ix743" class="ixterm"></a>(<span class="keyseq"><kbd>Alt</kbd>+<kbd>A</kbd></span>) Opens the <strong>Add File Type</strong> box to set up a new extension. If the extension is already listed, it gets the new program.</p>
</dd>
<dt class="hdlist1"><b class="button">Change&#8230;&#8203;</b></dt>
<dd>
<p><a id="_ix744" class="ixterm"></a>(<span class="keyseq"><kbd>Alt</kbd>+<kbd>C</kbd></span>) Opens the <strong>Change File Type</strong> box to pick a different program for the extension selected in the list. Double-clicking a row does the same.</p>
</dd>
<dt class="hdlist1"><b class="button">Remove</b></dt>
<dd>
<p><a id="_ix745" class="ixterm"></a>(<span class="keyseq"><kbd>Alt</kbd>+<kbd>R</kbd></span>) Forgets the extension selected in the list. The program itself is not removed.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>Your changes on this page are put into effect when you click <b class="button">OK</b> on Control Panel. <b class="button">Cancel</b> forgets them.</p>
</div>
<div class="sect3">
<h4 id="cpanel-file-types-box"><a class="anchor" href="#cpanel-file-types-box"></a>7.8.1. The Add File Type and Change File Type boxes</h4>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Extension</strong></dt>
<dd>
<p>(<span class="keyseq"><kbd>Alt</kbd>+<kbd>E</kbd></span>) The extension, one to eight letters or digits, such as <code>TXT</code>, without the dot. Capital and small letters count as the same. This box is greyed out when you change an existing type.</p>
</dd>
<dt class="hdlist1"><strong>Program</strong></dt>
<dd>
<p>(<span class="keyseq"><kbd>Alt</kbd>+<kbd>P</kbd></span>) The program that opens this kind of file. Type it, or click <b class="button">Browse&#8230;&#8203;</b> (<span class="keyseq"><kbd>Alt</kbd>+<kbd>B</kbd></span>) beside it to choose it in a <strong>Choose Program</strong> box. That box starts in DVX&#8217;s folder of programs and offers <code>Programs (*.app)</code>, <code>DOS programs (*.exe;*.com;*.bat)</code>, and <code>All Files (*.*)</code> in its <strong>Filter</strong> list.</p>
</dd>
<dt class="hdlist1"><strong>Arguments</strong></dt>
<dd>
<p>(<span class="keyseq"><kbd>Alt</kbd>+<kbd>A</kbd></span>) Optional text that is given to the program along with the document. As the box says, &#8220;In the arguments, %1 stands for the document.&#8221; Leave it empty to just give the program the document.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p><b class="button">OK</b> (<span class="keyseq"><kbd>Alt</kbd>+<kbd>O</kbd></span>) accepts the type and <b class="button">Cancel</b> (<span class="keyseq"><kbd>Alt</kbd>+<kbd>C</kbd></span>) closes the box without changing anything.</p>
</div>
<div class="paragraph">
<p><a id="_ix746" class="ixterm"></a>The program can be a DOS program (a .EXE, .COM, or .BAT file). Opening a document of that type then runs the DOS program with DVX stepped aside, as described in <a href="#desktop-dos-programs">Section 5.15</a>.</p>
</div>
<div class="paragraph">
<p><a id="_ix747" class="ixterm"></a><a id="_ix748" class="ixterm"></a>If something is missing, a box titled <strong>File Types</strong> says &#8220;An extension is one to eight letters or digits, such as TXT.&#8221; or &#8220;Type the program that opens this type.&#8221;</p>
</div>
</div>
<div class="sect3">
<h4 id="cpanel-file-types-task"><a class="anchor" href="#cpanel-file-types-task"></a>7.8.2. Changing which program opens a kind of file</h4>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Click the <strong>File Types</strong> tab.</p>
</li>
<li>
<p>To change an extension that is already listed, click it and click <b class="button">Change&#8230;&#8203;</b> (or double-click it). To set up a new one, click <b class="button">Add&#8230;&#8203;</b> and type the extension in <strong>Extension</strong>.</p>
</li>
<li>
<p>Type the program in <strong>Program</strong>, or click <b class="button">Browse&#8230;&#8203;</b> and choose it.</p>
</li>
<li>
<p>If the program needs them, type its arguments in <strong>Arguments</strong>, using <code>%1</code> for the document.</p>
</li>
<li>
<p>Click <b class="button">OK</b> in the box.</p>
</li>
<li>
<p>Click <b class="button">OK</b> on Control Panel.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>To make DVX forget an extension, click it, click <b class="button">Remove</b>, and click <b class="button">OK</b> on Control Panel.</p>
</div>
</div>
<div class="sect3">
<h4 id="cpanel-file-types-shipped"><a class="anchor" href="#cpanel-file-types-shipped"></a>7.8.3. File types DVX sets up</h4>
<div class="paragraph">
<p><a id="_ix749" class="ixterm"></a>When DVX is installed, these kinds of files open in these programs:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 66.6666%;">
<col style="width: 33.3334%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Extensions</th>
<th class="tableblock halign-left valign-top">Open in</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">TXT, INI</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Notepad</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">BMP, JPG, PNG, GIF</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Image Viewer</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">BAS, DBP, FRM, CLS, CTL</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">HLP</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX Help</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DHS</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Help Editor</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DPK</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Software</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">MOD, S3M, XM, IT, MID, RMI, WAV, VOC</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Media Player</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>DVX BASIC, Help Editor, and Media Player come with optional parts of DVX (see <a href="#installing-parts">Section 3.5</a>).</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="cpanel-network"><a class="anchor" href="#cpanel-network"></a>7.9. Network page</h3>
<div class="paragraph">
<p><a id="_ix750" class="ixterm"></a><a id="_ix751" class="ixterm"></a>The Network page holds the settings DVX uses to reach other computers and the Internet through a network card, for example for Terminal&#8217;s Telnet sessions and for Software&#8217;s package server. It is there only when the Networking part of DVX is installed; otherwise it says &#8220;Networking is not installed.&#8221;</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/cpNetwork.png" alt="Control Panel&#8217;s Network page" width="with the DHCP check box" height="the address boxes">
</div>
<div class="title">Figure 32. The Network page</div>
</div>
<div class="paragraph">
<p><a id="_ix752" class="ixterm"></a>DVX uses the network card through its packet driver: a small program for your card, usually supplied with it, that is started before DVX (for an NE2000 card, for example, <code>NE2000.COM 0x60 3 0x300</code> in AUTOEXEC.BAT). Without one, DVX works as usual, but no other computer can be reached. For setting up networking from start to finish, see <a href="#net-setup">Section 4.4</a>.</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Get the address automatically (DHCP)</strong></dt>
<dd>
<p><a id="_ix753" class="ixterm"></a><a id="_ix754" class="ixterm"></a>The network gives DVX its address, subnet mask, gateway, and name servers. Most networks work this way, so this box is checked unless you clear it. While it is checked, <strong>Address</strong>, <strong>Subnet mask</strong>, and <strong>Gateway</strong> are greyed out.</p>
</dd>
<dt class="hdlist1"><strong>Address</strong></dt>
<dd>
<p><a id="_ix755" class="ixterm"></a><a id="_ix756" class="ixterm"></a>Only when the box above is cleared: this computer&#8217;s own address on the network, such as 192.168.1.10.</p>
</dd>
<dt class="hdlist1"><strong>Subnet mask</strong></dt>
<dd>
<p><a id="_ix757" class="ixterm"></a>Only when the box above is cleared: the subnet mask, usually 255.255.255.0.</p>
</dd>
<dt class="hdlist1"><strong>Gateway</strong></dt>
<dd>
<p><a id="_ix758" class="ixterm"></a>Only when the box above is cleared: the address of the router to other networks and the Internet. It may be left empty.</p>
</dd>
<dt class="hdlist1"><strong>Name server 1</strong> and <strong>Name server 2</strong></dt>
<dd>
<p><a id="_ix759" class="ixterm"></a><a id="_ix760" class="ixterm"></a>Computers that turn names such as bbs.example.org into addresses. With DHCP, leave them empty to use the ones the network gives out; if you fill them in, DVX uses them instead. With a fixed address, DVX has only the name servers you type here: leave both empty and names cannot be looked up.</p>
</dd>
<dt class="hdlist1"><strong>Computer name</strong></dt>
<dd>
<p><a id="_ix761" class="ixterm"></a><a id="_ix762" class="ixterm"></a>This computer&#8217;s name on the network. It may use letters, digits, and hyphens, must not start or end with a hyphen, and must be shorter than 64 characters. It is <code>DVX</code> unless you change it.</p>
</dd>
<dt class="hdlist1"><strong>Packet driver</strong></dt>
<dd>
<p><a id="_ix763" class="ixterm"></a><strong>Find it</strong>, the usual choice, makes DVX look for the packet driver by itself at interrupts 60h to 80h. Choose one of <strong>Interrupt 60h</strong> to <strong>Interrupt 80h</strong> only if it is not found; pick the interrupt your packet driver was started with. If <code>DVX.INI</code> names an interrupt outside 60h to 80h, the list shows it with &#8220;(cannot be used)&#8221; after it, for example &#8220;Interrupt 3Ch (cannot be used)&#8221;; choose <strong>Find it</strong> or an interrupt from the list before you click <b class="button">OK</b>.</p>
</dd>
<dt class="hdlist1"><b class="button">Status&#8230;&#8203;</b></dt>
<dd>
<p><a id="_ix764" class="ixterm"></a>Opens the <strong>Network Status</strong> window (see below), or brings it to the front.</p>
</dd>
<dt class="hdlist1"><b class="button">Restart</b></dt>
<dd>
<p><a id="_ix765" class="ixterm"></a>Restarts the network with the saved settings, for example after a packet driver has been started. Connections that are open are closed. This happens at once, even if you then click <b class="button">Cancel</b>.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>The settings on this page are saved when you click <b class="button">OK</b> on Control Panel. If they changed, the network then restarts with them, and connections that were open are closed.</p>
</div>
<div class="sect3">
<h4 id="cpanel-network-status"><a class="anchor" href="#cpanel-network-status"></a>7.9.1. The Network Status window</h4>
<div class="paragraph">
<p><a id="_ix766" class="ixterm"></a>The <strong>Network Status</strong> window shows what the network is doing, updated every second:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>What the network is doing: &#8220;Connected&#8221;, &#8220;Waiting for a DHCP server&#8221;, &#8220;Networking is not started&#8221;, or &#8220;No packet driver found: load one (for example NE2000.COM) before DVX&#8221;.</p>
</li>
<li>
<p>The address, subnet mask, and gateway in use (a <code>-</code> for one that is not set), and the name servers.</p>
</li>
<li>
<p>The network card: its packet driver&#8217;s name and its hardware address.</p>
</li>
<li>
<p>How many packets and bytes have been received and sent. &#8220;lost&#8221; counts packets that arrived while DVX was too busy to take them.</p>
</li>
</ul>
</div>
</div>
<div class="sect3">
<h4 id="cpanel-network-problems"><a class="anchor" href="#cpanel-network-problems"></a>7.9.2. Problems that stop OK</h4>
<div class="paragraph">
<p><a id="_ix767" class="ixterm"></a>If a network setting cannot work, clicking <b class="button">OK</b> shows a warning box titled <strong>Network</strong> with one of these messages, and Control Panel stays open:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>&#8220;The computer name may only use letters, digits and hyphens&#8221;</p>
</li>
<li>
<p>&#8220;The packet driver interrupt must be between 0x60 and 0x80&#8221; (the <strong>Packet driver</strong> list shows an interrupt marked &#8220;(cannot be used)&#8221;)</p>
</li>
<li>
<p>&#8220;A name server is not a valid address (like 192.168.1.1)&#8221;</p>
</li>
<li>
<p>Only when the address is not automatic: &#8220;The address is not a valid address (like 192.168.1.10)&#8221;, &#8220;The subnet mask is not valid (like 255.255.255.0)&#8221;, or &#8220;The gateway is not a valid address (like 192.168.1.1)&#8221;</p>
</li>
</ul>
</div>
</div>
<div class="sect3">
<h4 id="cpanel-network-fixed"><a class="anchor" href="#cpanel-network-fixed"></a>7.9.3. Giving the computer a fixed address</h4>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Click the <strong>Network</strong> tab and clear <strong>Get the address automatically (DHCP)</strong>.</p>
</li>
<li>
<p>Type the <strong>Address</strong> and <strong>Subnet mask</strong>, and the <strong>Gateway</strong> if your network has one.</p>
</li>
<li>
<p>Type <strong>Name server 1</strong>, and <strong>Name server 2</strong> if your network has a second one. Without a name server, names such as bbs.example.org cannot be looked up.</p>
</li>
<li>
<p>Click <b class="button">OK</b>. The network restarts with the new settings.</p>
</li>
<li>
<p>To check it, open Control Panel again, click the <strong>Network</strong> tab, and click <b class="button">Status&#8230;&#8203;</b>.</p>
</li>
</ol>
</div>
</div>
</div>
<div class="sect2">
<h3 id="cpanel-printer"><a class="anchor" href="#cpanel-printer"></a>7.10. Printer page</h3>
<div class="paragraph">
<p><a id="_ix768" class="ixterm"></a><a id="_ix769" class="ixterm"></a>The Printer page tells DVX about your printer. Every program prints to the printer set here. The page&#8217;s settings are saved when you click <b class="button">OK</b> on Control Panel.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/cpPrinter.png" alt="Control Panel&#8217;s Printer page" width="with the printer model" height="the port">
</div>
<div class="title">Figure 33. The Printer page</div>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Printer model</strong></dt>
<dd>
<p><a id="_ix770" class="ixterm"></a><a id="_ix771" class="ixterm"></a>The kind of printer you have. <strong>Text only (any printer)</strong>, the usual setting, works with any printer but prints only text. Choose one of the others if your printer is one of them or works like one; then pictures can be printed too, in shades of grey on the models without color. As the page says, &#8220;Text only works with any printer; choose your printer&#8217;s model to print pictures too.&#8221; The models are listed in the table below.</p>
</dd>
<dt class="hdlist1"><strong>Connected to</strong></dt>
<dd>
<p><a id="_ix772" class="ixterm"></a><a id="_ix773" class="ixterm"></a>The port the printer is plugged into: <strong>LPT1</strong> (the usual setting), <strong>LPT2</strong>, or <strong>LPT3</strong> for a parallel printer, or <strong>COM1</strong> to <strong>COM4</strong> for a serial printer, such as the ImageWriter II. Choose <strong>File</strong> to print into a file instead.</p>
</dd>
<dt class="hdlist1"><strong>File name</strong></dt>
<dd>
<p><a id="_ix774" class="ixterm"></a>Only when <strong>Connected to</strong> is <strong>File</strong>: the file that printouts go into. Each printout replaces it. It starts as <code>PRINTER.PRN</code>. A name without a folder, such as <code>PRINTER.PRN</code>, is in your USER folder (see <a href="#folders-user">Section B.1.2</a>), so printing to a file works even when DVX runs from a CD-ROM. Type a name, or click <b class="button">Browse&#8230;&#8203;</b> (<span class="keyseq"><kbd>Alt</kbd>+<kbd>B</kbd></span>) to choose it in a <strong>Print to File</strong> box, which starts in the folder the file is in.</p>
</dd>
<dt class="hdlist1"><strong>Speed (baud)</strong></dt>
<dd>
<p><a id="_ix775" class="ixterm"></a>Only for a serial printer (<strong>COM1</strong> to <strong>COM4</strong>): how fast the port sends: 300, 1200, 2400, 4800, 9600, 19200, or 38400. Set it to match the printer&#8217;s own setting; 9600, the usual setting, suits most.</p>
</dd>
<dt class="hdlist1"><strong>Handshake</strong></dt>
<dd>
<p>Only for a serial printer: how the printer tells the computer to wait. <strong>Hardware (DSR, Apple)</strong>, the usual setting, suits Apple&#8217;s ImageWriter cable; <strong>Hardware (CTS)</strong> a cable that wires the printer&#8217;s ready line to CTS; <strong>XON / XOFF</strong> a printer set to send those characters; and <strong>None</strong> no handshake at all.</p>
</dd>
<dt class="hdlist1"><b class="button">Page Setup&#8230;&#8203;</b></dt>
<dd>
<p><a id="_ix776" class="ixterm"></a>Opens the <strong>Page Setup</strong> dialog (see below).</p>
</dd>
</dl>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Printer model</th>
<th class="tableblock halign-left valign-top">Choose it for</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Text only (any printer)</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Any printer, when you only print text.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Epson 9-pin (ESC/P)</strong> and <strong>Epson 24-pin (ESC/P)</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">An Epson dot matrix printer with 9 or 24 pins, or one that works like it (most dot matrix printers do).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>HP LaserJet (PCL)</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">An older LaserJet, such as the LaserJet II or Plus.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>HP LaserJet III or DeskJet (300 dpi)</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Laser and ink jet printers made since about 1990. Most laser and ink jet printers work like a LaserJet. This model prints pictures sharper and faster than <strong>HP LaserJet (PCL)</strong>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Epson 9-pin color (ESC/P)</strong> and <strong>Epson 24-pin color (ESC/P)</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A dot matrix printer with a color ribbon.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>HP DeskJet 500C (color)</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A DeskJet that holds one color cartridge.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>HP DeskJet 550C and later (color)</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A DeskJet that holds a black and a color cartridge.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>PostScript</strong> and <strong>PostScript (color)</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A PostScript printer (often an Apple LaserWriter, or a printer with a PostScript option). Text prints on it too, and pages that programs draw are drawn by the printer itself, as sharp as it can print.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Apple ImageWriter II</strong> and <strong>Apple ImageWriter II (color)</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">An ImageWriter II on a serial port; the color model for one with the four-color ribbon.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix777" class="ixterm"></a>If you choose <strong>File</strong> and leave <strong>File name</strong> empty, clicking <b class="button">OK</b> shows a box titled <strong>Printer</strong>: &#8220;Type the name of the file to print to, or connect the printer to a port.&#8221;</p>
</div>
<div class="sect3">
<h4 id="cpanel-printer-page-setup"><a class="anchor" href="#cpanel-printer-page-setup"></a>7.10.1. Page Setup</h4>
<div class="paragraph">
<p><a id="_ix778" class="ixterm"></a><a id="_ix779" class="ixterm"></a><a id="_ix780" class="ixterm"></a>The <strong>Page Setup</strong> dialog sets how text is laid out on the page when it is printed. Programs that print text, such as Notepad, use it too. Its changes are saved as soon as you click <b class="button">OK</b> in the dialog, even if you then click <b class="button">Cancel</b> on Control Panel.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 33.3333%;">
<col style="width: 16.6666%;">
<col style="width: 50.0001%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Setting</th>
<th class="tableblock halign-left valign-top">At first</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Lines per page</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">0</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">How many lines fit on a sheet, from 10 to 200. 0 means the printer&#8217;s usual page length (66 lines, or 60 on the LaserJet, DeskJet, and PostScript models).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Characters per line</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">80</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">How many characters fit across a sheet, from 20 to 255.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Top margin (lines)</strong> and <strong>Bottom margin (lines)</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">3 each</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Lines at the top and bottom of each page that the document&#8217;s text stays out of, from 0 to 200. The header prints in the middle line of the top margin and the footer in the middle line of the bottom margin, so with a top margin of 0 there is no header, and with a bottom margin of 0 no footer.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Left margin</strong> and <strong>Right margin</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">5 each</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Blank characters at the left and right of each line, from 0 to 255.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Tab width</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">8</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">How far apart tab stops are, from 1 to 16 characters.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Header</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>&amp;f</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A line printed in the top margin of every page.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Footer</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Page &amp;p</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A line printed in the bottom margin of every page.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Wrap long lines (otherwise they are cut off)</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">On</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Lines too long for the page continue on the next line; when it is off, they are cut off.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>In the header and footer, these codes are replaced when the page is printed: <code>&amp;f</code> the file name, <code>&amp;p</code> the page number, <code>&amp;n</code> the number of pages, <code>&amp;d</code> the date, and <code>&amp;t</code> the time. <code>&amp;l</code>, <code>&amp;c</code>, and <code>&amp;r</code> put the text after them at the left, centre, or right. For example, the footer <code>&amp;cPage &amp;p of &amp;n</code> prints &#8220;Page 2 of 5&#8221; in the middle of the line.</p>
</div>
<div class="paragraph">
<p><a id="_ix781" class="ixterm"></a>If a setting cannot work, a box titled <strong>Page Setup</strong> says why: &#8220;Lines per page must be 0 (the printer&#8217;s usual length) or from 10 to 200.&#8221;, &#8220;Characters per line must be from 20 to 255.&#8221;, &#8220;Margins cannot be negative.&#8221;, &#8220;Tab width must be from 1 to 16.&#8221;, &#8220;The top and bottom margins leave no room for text.&#8221;, or &#8220;The left and right margins leave less than 10 characters for text.&#8221; If the settings cannot be saved, it says &#8220;The page setup could not be saved.&#8221;</p>
</div>
</div>
<div class="sect3">
<h4 id="cpanel-printer-task"><a class="anchor" href="#cpanel-printer-task"></a>7.10.2. Setting up a printer and printing a test page</h4>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Click the <strong>Printer</strong> tab.</p>
</li>
<li>
<p>Choose your printer in <strong>Printer model</strong>.</p>
</li>
<li>
<p>Choose the port it is plugged into in <strong>Connected to</strong>. For a serial printer, also set <strong>Speed (baud)</strong> and <strong>Handshake</strong> to match the printer. To print into a file, choose <strong>File</strong> and type a <strong>File name</strong>.</p>
</li>
<li>
<p>If you like, click <b class="button">Page Setup&#8230;&#8203;</b>, set the margins, header, and footer, and click <b class="button">OK</b>.</p>
</li>
<li>
<p>Click <b class="button">OK</b> on Control Panel.</p>
</li>
<li>
<p><a id="_ix782" class="ixterm"></a>To print a test page, open Notepad, type a line or two, and choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Print&#8230;&#8203;</b></span>. The <strong>Print</strong> dialog shows the model you chose (&#8220;Printer model:&#8221;) and starts with your port in <strong>Print to</strong>. Click <b class="button">Print</b>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>If the printer does not print, see <a href="#trouble-printing">Section 11.8</a>.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="cpanel-game-controllers"><a class="anchor" href="#cpanel-game-controllers"></a>7.11. Game Controllers page</h3>
<div class="paragraph">
<p><a id="_ix783" class="ixterm"></a><a id="_ix784" class="ixterm"></a><a id="_ix785" class="ixterm"></a>The Game Controllers page shows the joysticks DVX found, lets you try them out, and calibrates them so that programs, such as games, read them correctly. When no joystick is connected, the keyboard can stand in for one. Every change on this page works at once, so you can see it in the test picture.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/cpGameControllers.png" alt="Control Panel&#8217;s Game Controllers page" width="showing the keyboard joystick in the test picture" height="with the Calibrate">
</div>
<div class="title">Figure 34. The Game Controllers page</div>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Controller</strong></dt>
<dd>
<p><a id="_ix786" class="ixterm"></a><a id="_ix787" class="ixterm"></a>The joystick shown in the picture and changed by the settings below. A joystick on the game port is listed as <strong>Game port joystick 1</strong> or <strong>Game port joystick 2</strong>, or as <strong>Game port joystick (4 axes)</strong> when <strong>Game port</strong> is set to <strong>One joystick with 4 axes</strong>. The keyboard is listed as <strong>Keyboard joystick</strong>.</p>
</dd>
<dt class="hdlist1"><b class="button">Detect</b></dt>
<dd>
<p><a id="_ix788" class="ixterm"></a>Looks for joysticks again, for example after you plug one in. It works only while no program is using a joystick.</p>
</dd>
<dt class="hdlist1">The test picture</dt>
<dd>
<p><a id="_ix789" class="ixterm"></a>Follows the joystick as you use it. The dot in the square shows where the stick points. The bars show each axis (<strong>X</strong>, <strong>Y</strong>, <strong>3</strong>, and <strong>4</strong>) from one end to the other. The numbered boxes light up while their button is held down. A hat switch, if the joystick has one, shows as &#8220;Hat: centred&#8221; or &#8220;Hat: <em>n</em> degrees&#8221;. &#8220;Not connected&#8221; means the joystick stopped answering: check its cable, then click <b class="button">Detect</b>. &#8220;No game controllers found.&#8221; means DVX found none.</p>
</dd>
<dt class="hdlist1"><b class="button">Calibrate&#8230;&#8203;</b></dt>
<dd>
<p><a id="_ix790" class="ixterm"></a>Starts calibrating the joystick (see below). It is greyed out for the keyboard joystick.</p>
</dd>
<dt class="hdlist1"><b class="button">Automatic</b></dt>
<dd>
<p>Forgets the calibration, so DVX learns the stick&#8217;s range by itself again. It is greyed out for the keyboard joystick.</p>
</dd>
<dt class="hdlist1"><strong>Dead zone</strong></dt>
<dd>
<p><a id="_ix791" class="ixterm"></a><a id="_ix792" class="ixterm"></a>How far the stick can move from the middle and still count as the middle, from 0 to 50 percent. It starts at 8%. A worn stick that does not come back exactly to the middle needs a bigger dead zone.</p>
</dd>
<dt class="hdlist1"><strong>Game port</strong></dt>
<dd>
<p><a id="_ix793" class="ixterm"></a><a id="_ix794" class="ixterm"></a><strong>Two joysticks</strong>, the usual setting, for two joysticks with two buttons each. <strong>One joystick with 4 axes</strong>, for a flight stick with a throttle or rudder, which uses the whole port and all four buttons. Changing it makes DVX look for joysticks again.</p>
</dd>
<dt class="hdlist1"><strong>Keyboard</strong></dt>
<dd>
<p><a id="_ix795" class="ixterm"></a><a id="_ix796" class="ixterm"></a>When to offer the keyboard as a joystick: <strong>When no joystick is found</strong> (the usual setting), <strong>Always</strong>, or <strong>Never</strong>. Changing it makes DVX look for joysticks again.</p>
</dd>
<dt class="hdlist1"><b class="button">Keys&#8230;&#8203;</b></dt>
<dd>
<p>Chooses the keys the keyboard joystick uses (see below).</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p><a id="_ix797" class="ixterm"></a>If a program is using a joystick when you click <b class="button">Detect</b> or change <strong>Game port</strong> or <strong>Keyboard</strong>, a box titled <strong>Game Controllers</strong> says &#8220;A program is using a game controller. Close it, then click Detect again.&#8221;</p>
</div>
<div class="paragraph">
<p>A joystick on the game port works without calibrating: DVX takes where the stick rests when it is found as the middle, and learns how far it goes as you move it. For the best results, calibrate it once.</p>
</div>
<div class="sect3">
<h4 id="cpanel-game-controllers-calibrate"><a class="anchor" href="#cpanel-game-controllers-calibrate"></a>7.11.1. Calibrating a joystick</h4>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Click the <strong>Game Controllers</strong> tab and choose the joystick in <strong>Controller</strong>.</p>
</li>
<li>
<p>Click <b class="button">Calibrate&#8230;&#8203;</b>. A box titled <strong>Calibrate</strong> opens. A line in it shows the joystick&#8217;s readings as you go.</p>
</li>
<li>
<p>When it says &#8220;Let the stick rest in the middle, then click Next.&#8221;, let go of the stick and click <b class="button">Next</b>.</p>
</li>
<li>
<p><a id="_ix798" class="ixterm"></a>When it says &#8220;Move the stick round all its edges, then click Next.&#8221;, move the stick all the way round its edges, reaching every corner, and click <b class="button">Next</b>. If it did not go far enough, the box says &#8220;Move the stick further, all the way to each edge.&#8221;; do it again and click <b class="button">Next</b>.</p>
</li>
<li>
<p>When it says &#8220;Press each button to test it, then click Finish.&#8221;, press each button to see that it works, and click <b class="button">Finish</b>. The calibration is used at once.</p>
</li>
<li>
<p>Click <b class="button">OK</b> on Control Panel to keep it.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p><b class="button">Cancel</b> in the <strong>Calibrate</strong> box, at any step, leaves the old calibration as it was. In the box, <kbd>Enter</kbd> clicks <b class="button">Next</b> (or <b class="button">Finish</b>) and <kbd>Esc</kbd> clicks <b class="button">Cancel</b>.</p>
</div>
</div>
<div class="sect3">
<h4 id="cpanel-game-controllers-keyboard"><a class="anchor" href="#cpanel-game-controllers-keyboard"></a>7.11.2. Using the keyboard as a joystick</h4>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>On the <strong>Game Controllers</strong> page, set <strong>Keyboard</strong> to <strong>Always</strong>, or leave it at <strong>When no joystick is found</strong>.</p>
</li>
<li>
<p>Click <b class="button">Keys&#8230;&#8203;</b>. A box titled <strong>Keyboard Joystick</strong> opens.</p>
</li>
<li>
<p>For each of <strong>Up</strong>, <strong>Down</strong>, <strong>Left</strong>, <strong>Right</strong>, and <strong>Button 1</strong> to <strong>Button 4</strong>, choose a key in its list. You can choose the arrow keys, the left and right Ctrl, Shift, and Alt keys, Space, Enter, Tab, Backspace, Insert, Delete, Home, End, PgUp, PgDn, the keypad&#8217;s 0 to 9, A to Z, and 0 to 9. At first they are the four arrow keys, Left Ctrl, Space, Left Shift, and Z.</p>
</li>
<li>
<p>Click <b class="button">OK</b> in the box.</p>
</li>
<li>
<p>Click <b class="button">OK</b> on Control Panel.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>The keyboard joystick answers only while the program using it is the active one, so the keys you type into other programs do not move it.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="cpanel-sounds"><a class="anchor" href="#cpanel-sounds"></a>7.12. Sounds page</h3>
<div class="paragraph">
<p><a id="_ix799" class="ixterm"></a><a id="_ix800" class="ixterm"></a>The Sounds page chooses the sound DVX makes for each event, such as starting, ending, or showing a message, sets the overall volume, and says which sound hardware DVX uses and how it plays music. Without sound hardware, everything works the same, but silently.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/cpSounds.png" alt="Control Panel&#8217;s Sounds page" width="with the Events list" height="the sound for the selected event">
</div>
<div class="title">Figure 35. The Sounds page</div>
</div>
<div class="sect3">
<h4 id="cpanel-sounds-events"><a class="anchor" href="#cpanel-sounds-events"></a>7.12.1. Event sounds</h4>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Events</strong></dt>
<dd>
<p><a id="_ix801" class="ixterm"></a><a id="_ix802" class="ixterm"></a>The events DVX has a sound for. Click one to see and change its sound. They are listed in the table below.</p>
</dd>
<dt class="hdlist1"><strong>Sound</strong></dt>
<dd>
<p><a id="_ix803" class="ixterm"></a>The sound of the selected event: <strong>(None)</strong> for silence, or one of the sound files listed, by name. The list has the WAV and VOC sounds that come with DVX, those in the SOUNDS folder in your USER folder, and any file you choose with <b class="button">Browse&#8230;&#8203;</b>.</p>
</dd>
<dt class="hdlist1"><b class="button">Browse&#8230;&#8203;</b></dt>
<dd>
<p>Opens a <strong>Choose a Sound</strong> box, where you can choose any sound file (WAV or VOC) for the selected event.</p>
</dd>
<dt class="hdlist1"><b class="button">Test</b></dt>
<dd>
<p><a id="_ix804" class="ixterm"></a>Plays the sound shown, so you can hear it. If a sound cannot be played, a box titled <strong>Sounds</strong> says why.</p>
</dd>
<dt class="hdlist1"><strong>Volume</strong></dt>
<dd>
<p><a id="_ix805" class="ixterm"></a><a id="_ix806" class="ixterm"></a>How loud all sounds and music are, from 0 to 100 percent. It changes at once; <b class="button">Cancel</b> puts it back.</p>
</dd>
</dl>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Event</th>
<th class="tableblock halign-left valign-top">Sound at first</th>
<th class="tableblock halign-left valign-top">When it sounds</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Default beep</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">beep.wav</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A message without a picture, and whenever a program asks for a beep.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Start DVX</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">startup.wav</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX has started.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Exit DVX</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">exit.wav</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX is ending.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Error</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">error.wav</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A message about an error.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Warning</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">warning.wav</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A warning message.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Question</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">question.wav</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A message that asks a question.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Information</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">info.wav</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A message that tells you something.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Open window</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">(None)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A window opens (not the small windows that ask something).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Close window</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">(None)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A window closes.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>DVX also comes with winopen.wav and winclose.wav, which you can choose for <strong>Open window</strong> and <strong>Close window</strong>.</p>
</div>
<div class="paragraph">
<p>To change or turn off the sound for an event:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Click the <strong>Sounds</strong> tab and click the event in <strong>Events</strong>.</p>
</li>
<li>
<p>Choose a sound in <strong>Sound</strong>, or <strong>(None)</strong> for silence. To use another sound file, click <b class="button">Browse&#8230;&#8203;</b> and choose it.</p>
</li>
<li>
<p>Click <b class="button">Test</b> to hear it. Set <strong>Volume</strong> if you need to.</p>
</li>
<li>
<p>Click <b class="button">OK</b>. The new sounds are used from then on.</p>
</li>
</ol>
</div>
</div>
<div class="sect3">
<h4 id="cpanel-sounds-hardware"><a class="anchor" href="#cpanel-sounds-hardware"></a>7.12.2. Sound hardware and music</h4>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Sound driver</strong></dt>
<dd>
<p><a id="_ix807" class="ixterm"></a><a id="_ix808" class="ixterm"></a><a id="_ix809" class="ixterm"></a>The sound hardware DVX uses. The list has <strong>Automatic</strong>, which finds it by itself (the usual choice), and then the sound drivers that are installed:</p>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 80%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Driver</th>
<th class="tableblock halign-left valign-top">Sound hardware</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>wss</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix810" class="ixterm"></a>A Windows Sound System card.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>sb</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix811" class="ixterm"></a>A Sound Blaster.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>gus</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix812" class="ixterm"></a>A Gravis UltraSound.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>lpt</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix813" class="ixterm"></a>A small sound device plugged into the printer port: a Covox Speech Thing, a Disney Sound Source, or a Stereo-on-1.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>speaker</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix814" class="ixterm"></a>The PC speaker.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>null</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No sound at all.</p></td>
</tr>
</tbody>
</table>
</dd>
<dt class="hdlist1"><strong>MIDI music</strong></dt>
<dd>
<p><a id="_ix815" class="ixterm"></a><a id="_ix816" class="ixterm"></a>Where MIDI music plays:</p>
<div class="ulist">
<ul>
<li>
<p><strong>Automatic</strong>, the usual choice: the recorded instruments of a Gravis UltraSound or Sound Blaster AWE card when it has them, else the music chip on the sound card, else DVX&#8217;s own synthesizer, which sounds much the same as the chip.</p>
</li>
<li>
<p><strong>MIDI port (MPU-401)</strong>: an external synthesizer connected to the sound card&#8217;s MIDI port.</p>
</li>
<li>
<p><strong>FM synthesizer chip</strong>: the music chip on the sound card.</p>
</li>
<li>
<p><strong>Built-in synthesizer</strong>: DVX&#8217;s own synthesizer.</p>
</li>
<li>
<p><strong>Built-in SoundFont synthesizer</strong>: recorded instruments played by the computer itself, on any sound card. It needs more memory and a faster computer.</p>
</li>
</ul>
</div>
</dd>
<dt class="hdlist1"><strong>MIDI in</strong></dt>
<dd>
<p><a id="_ix817" class="ixterm"></a><a id="_ix818" class="ixterm"></a>Where MIDI input comes from, for programs that read a MIDI keyboard, such as Sound Recorder (see <a href="#programs-sound-recorder">Section 8.8</a>): <strong>None</strong> (the usual setting) or <strong>MIDI port</strong> (the MPU-401 port on the sound card, or one like it).</p>
</dd>
<dt class="hdlist1"><strong>Modules</strong></dt>
<dd>
<p><a id="_ix819" class="ixterm"></a><a id="_ix820" class="ixterm"></a>Where music modules (MOD, S3M, XM, and IT files) play. <strong>Wavetable synthesizer when free</strong>, the usual setting, plays them on the voices of a Gravis UltraSound or Sound Blaster AWE card when no other music is playing there and the module fits in the card&#8217;s memory, which takes the computer little time; otherwise the computer mixes them itself. <strong>Mixed in software</strong> always has the computer mix them, which takes much more of a slow computer&#8217;s time but plays every effect a module has.</p>
</dd>
<dt class="hdlist1"><strong>Instruments</strong></dt>
<dd>
<p><a id="_ix821" class="ixterm"></a><a id="_ix822" class="ixterm"></a>The instrument sounds MIDI music uses on the music chip and in the built-in synthesizer: <strong>Standard</strong> (DVX&#8217;s own set, the usual setting), or another instrument bank. DVX also comes with two other banks, whose names in the list include DMXOPL and DMXOPL3. A bank installed by an add-on is shown by the add-on&#8217;s name; one you put in the BANKS folder of your USER folder, by its file name.</p>
</dd>
<dt class="hdlist1"><strong>SoundFont</strong></dt>
<dd>
<p><a id="_ix823" class="ixterm"></a><a id="_ix824" class="ixterm"></a>The recorded instruments MIDI music uses on a Gravis UltraSound or Sound Blaster AWE card, and in the built-in SoundFont synthesizer: <strong>Standard</strong> (DVX&#8217;s General MIDI SoundFont, an add-on that Software offers; see <a href="#addons-installing">Section 10.3</a>), a SoundFont you put in the BANKS folder of your USER folder, <strong>Gravis UltraSound patches</strong> (the card&#8217;s own instruments, when its software is installed), or <strong>Sound Blaster AWE ROM instruments</strong> (the instruments built into the card, when Creative&#8217;s software is installed). Without the Standard SoundFont, the card&#8217;s own instruments are used when it has them.</p>
</dd>
<dt class="hdlist1"><b class="button">Test</b> (beside <strong>Instruments</strong> and <strong>SoundFont</strong>)</dt>
<dd>
<p><a id="_ix825" class="ixterm"></a>Plays a short tune on piano, guitar, violin, trumpet, and flute, using the instruments shown in that row, so you can hear them before you choose. You do not need to click <b class="button">OK</b> first. If the tune cannot be played, a box titled <strong>Instruments</strong> says why.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p><a id="_ix826" class="ixterm"></a><a id="_ix827" class="ixterm"></a>Under these settings, a line says which sound hardware DVX is using now (&#8220;Sound device:&#8221; followed by its name), or &#8220;Sound device: none running&#8221;. The last line is a reminder: &#8220;Sound driver and MIDI changes take effect when DVX next starts.&#8221;</p>
</div>
<div class="paragraph">
<p>A new <strong>Instruments</strong>, <strong>SoundFont</strong>, or <strong>Modules</strong> choice is used by the next music that starts after you click <b class="button">OK</b>. A new <strong>Sound driver</strong>, <strong>MIDI music</strong>, or <strong>MIDI in</strong> choice takes effect the next time DVX starts.</p>
</div>
</div>
<div class="sect3">
<h4 id="cpanel-sounds-device"><a class="anchor" href="#cpanel-sounds-device"></a>7.12.3. Choosing the sound device and MIDI music</h4>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Click the <strong>Sounds</strong> tab.</p>
</li>
<li>
<p>Choose your sound hardware in <strong>Sound driver</strong>, or leave it at <strong>Automatic</strong>.</p>
</li>
<li>
<p>Choose where MIDI music plays in <strong>MIDI music</strong>. If you have a MIDI keyboard, set <strong>MIDI in</strong> to <strong>MIDI port</strong>.</p>
</li>
<li>
<p>Click <b class="button">OK</b>.</p>
</li>
<li>
<p>Exit DVX and start it again. The <strong>Sound device</strong> line on the Sounds page then names the sound hardware in use.</p>
</li>
</ol>
</div>
</div>
<div class="sect3">
<h4 id="cpanel-sounds-instruments"><a class="anchor" href="#cpanel-sounds-instruments"></a>7.12.4. Choosing and testing instruments</h4>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Click the <strong>Sounds</strong> tab.</p>
</li>
<li>
<p>Choose an instrument bank in <strong>Instruments</strong> (for the music chip and the built-in synthesizer) or a SoundFont in <strong>SoundFont</strong> (for UltraSound and AWE cards and the built-in SoundFont synthesizer).</p>
</li>
<li>
<p>Click the <b class="button">Test</b> beside it to hear the instruments. Try others until you find the one you like.</p>
</li>
<li>
<p>Click <b class="button">OK</b>. The next music that starts uses them.</p>
</li>
</ol>
</div>
<div class="admonitionblock note">
<table>
<tr>
<td class="icon">
<div class="title">Note</div>
</td>
<td class="content">
<a id="_ix828" class="ixterm"></a><a id="_ix829" class="ixterm"></a>A few sound settings are not on this page. The mixing rate, the number of voices, what is connected to the MIDI port, and the settings of a Windows Sound System card or of a sound device on the printer port are kept in DVX.INI (see <a href="#folders-dvx-ini">Section B.2</a>). A Sound Blaster&#8217;s port, IRQ, and DMA come from the BLASTER setting in AUTOEXEC.BAT, and a Gravis UltraSound&#8217;s from the ULTRASND setting. See also <a href="#trouble-sound">Section 11.7</a>.
</td>
</tr>
</table>
</div>
</div>
</div>
<div class="sect2">
<h3 id="cpanel-elsewhere"><a class="anchor" href="#cpanel-elsewhere"></a>7.13. Settings that are not in Control Panel</h3>
<div class="paragraph">
<p><a id="_ix830" class="ixterm"></a><a id="_ix831" class="ixterm"></a>Control Panel has no page for the keyboard&#8217;s repeat rate, the date and time, or the choice of fonts. Set the date and time with the DOS <code>DATE</code> and <code>TIME</code> commands before you start DVX. The only font setting is <strong>Smooth the edges of text</strong>, on the Video page.</p>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="programs"><a class="anchor" href="#programs"></a>Chapter 8. The Standard Programs</h2>
<div class="sectionbody">
<div class="paragraph">
<p><a id="_ix832" class="ixterm"></a>DVX comes with a set of programs for everyday work: a file manager, a text editor, a clock, a picture viewer, a help viewer, and more. This chapter describes each one: what it is for, how to start it, its window, its menus and keys, and how to do the common tasks. Program Manager, Control Panel, Software, Terminal, and the Task Manager have chapters or sections of their own (see <a href="#programs-elsewhere">Section 8.2.7</a>).</p>
</div>
<div class="sect2">
<h3 id="programs-parts"><a class="anchor" href="#programs-parts"></a>8.1. Which programs you have</h3>
<div class="paragraph">
<p><a id="_ix833" class="ixterm"></a><a id="_ix834" class="ixterm"></a>Some programs are part of DVX itself and are always installed. Others come with an optional part, which you choose on Setup&#8217;s <strong>What to install</strong> page (see <a href="#installing-parts">Section 3.5</a>) or add later with Software (see <a href="#addons-parts">Section 10.9</a>). The table shows which part brings each program.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 30%;">
<col style="width: 50%;">
<col style="width: 20%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Program</th>
<th class="tableblock halign-left valign-top">What it is for</th>
<th class="tableblock halign-left valign-top">Comes with</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix835" class="ixterm"></a>File Manager</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Browse, copy, move, rename, and delete files and folders</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX (always installed)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix836" class="ixterm"></a>Notepad</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A simple text editor</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix837" class="ixterm"></a>Clock</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A digital clock with the date</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix838" class="ixterm"></a>Image Viewer</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Shows BMP, PNG, JPEG, and GIF pictures</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix839" class="ixterm"></a>DVX Help</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Shows help: the DVX user guide and each program&#8217;s own help</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix840" class="ixterm"></a>Welcome</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Introduces DVX when it starts for the first time</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix841" class="ixterm"></a>The screen savers: Blank Screen, Marquee, Mystify, and Starfield</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Cover the screen while the computer is not used</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Program Manager, Control Panel, and Software</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The desktop, the settings, and add-on software</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix842" class="ixterm"></a>Media Player</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Plays music modules, MIDI files, and WAV and VOC sounds from a list</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Media</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix843" class="ixterm"></a>Sound Recorder</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Records sound from a microphone, a line input, or a CD into WAV files, and a MIDI keyboard into MIDI files</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Media</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix844" class="ixterm"></a>Terminal</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Connects to other computers and bulletin boards by serial cable, modem, secure link, or Telnet, with file transfers</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Communications (Telnet and the secure link over a network also need Networking)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix845" class="ixterm"></a>DVX BASIC</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Write your own programs</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Icon Editor, Resource Editor, Help Editor, Package Builder, and Widget Showcase</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Tools for people who make programs, help files, and add-on packages</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Developer Tools</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix846" class="ixterm"></a><a id="_ix847" class="ixterm"></a>DVX Demo and BASIC Demo</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Show what DVX and DVX BASIC can do</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Demos</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect2">
<h3 id="programs-common"><a class="anchor" href="#programs-common"></a>8.2. What all programs share</h3>
<div class="sect3">
<h4 id="programs-common-start"><a class="anchor" href="#programs-common-start"></a>8.2.1. Starting a program</h4>
<div class="paragraph">
<p><a id="_ix848" class="ixterm"></a><a id="_ix849" class="ixterm"></a>Every installed program except Program Manager itself has an icon in Program Manager&#8217;s <strong>Installed Programs</strong> group, in alphabetical order. Double-click the icon to start the program. When you select an icon, the status bar shows a one-line description of the program. You can also start a program by opening one of its documents (see <a href="#programs-common-documents">Section 8.2.4</a>), or with Program Manager&#8217;s <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Run&#8230;&#8203;</b></span> command (see <a href="#progman-run">Section 6.7</a>).</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-common-help"><a class="anchor" href="#programs-common-help"></a>8.2.2. Help for every program</h4>
<div class="paragraph">
<p><a id="_ix850" class="ixterm"></a><a id="_ix851" class="ixterm"></a>Press <kbd>F1</kbd> for help about the program whose window is active. A program that has no help of its own opens the DVX user guide instead. If DVX Help is already open, the page appears in that window and the window comes to the front. See <a href="#desktop-help">Section 5.11</a> and <a href="#programs-help">Section 8.9</a>.</p>
</div>
<div class="paragraph">
<p><a id="_ix852" class="ixterm"></a>Most programs also have a Help menu. Its <strong>Contents</strong> item opens the program&#8217;s help, the same as <kbd>F1</kbd>. Its <strong>About</strong> item shows a small box with the program&#8217;s name, what it does, and its copyright; click <b class="button">OK</b> to close it.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-common-copies"><a class="anchor" href="#programs-common-copies"></a>8.2.3. One copy or several</h4>
<div class="paragraph">
<p><a id="_ix853" class="ixterm"></a><a id="_ix854" class="ixterm"></a>Most programs run only once at a time. If you start one of them again while it is running, DVX shows a box titled <strong>Error</strong> that says &#8220;<em>file</em> is already running.&#8221;, where <em>file</em> is the name of the program&#8217;s file. Switch to the open window instead, with <span class="keyseq"><kbd>Alt</kbd>+<kbd>Tab</kbd></span> or the Task Manager (see <a href="#desktop-task-manager">Section 5.10</a>). To open another document in Notepad or Image Viewer, use the <strong>Open</strong> command of the copy that is running. Media Player is different: a music file you open while it runs is added to its list (see <a href="#programs-media-player-start">Section 8.7.2</a>). So is Software: a package (<code>.DPK</code> file) you open while it runs is installed by the open Software (see <a href="#addons-from-file">Section 10.3.1</a>).</p>
</div>
<div class="paragraph">
<p>These programs can run several times at once, each in a window of its own: File Manager, Clock, Terminal, and DVX Help.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-common-documents"><a class="anchor" href="#programs-common-documents"></a>8.2.4. Opening documents</h4>
<div class="paragraph">
<p><a id="_ix855" class="ixterm"></a><a id="_ix856" class="ixterm"></a><a id="_ix857" class="ixterm"></a>When you double-click a document in File Manager, or open one from Program Manager, DVX starts the program set for that kind of file and opens the document in it. As DVX is installed, these are:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 60%;">
<col style="width: 40%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Files ending in</th>
<th class="tableblock halign-left valign-top">Open in</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.TXT and .INI</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Notepad</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.BMP, .JPG, .PNG, and .GIF</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Image Viewer</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.MOD, .S3M, .XM, .IT, .MID, .RMI, .WAV, and .VOC</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Media Player</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.HLP</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX Help</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.BAS, .DBP, .FRM, .CLS, and .CTL</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.DHS</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Help Editor</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.DPK</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Software</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>You can change the list on the File Types page of Control Panel (see <a href="#cpanel-file-types">Section 7.8</a>).</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-common-settings"><a class="anchor" href="#programs-common-settings"></a>8.2.5. Settings the programs remember</h4>
<div class="paragraph">
<p><a id="_ix858" class="ixterm"></a><a id="_ix859" class="ixterm"></a>A program that remembers settings keeps them in a file in its own folder inside your user folder. For example, Media Player keeps <code>PLAYER.INI</code> in <code>USER\APPS\KPUNCH\PLAYER</code> in the DVX folder. Your DVX settings, which you make in Control Panel, are kept in <code>DVX.INI</code> in the <code>USER</code> folder. See <a href="#folders-layout">Section B.1</a>. The section on each program says what it remembers.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-common-menus"><a class="anchor" href="#programs-common-menus"></a>8.2.6. Menus and keys</h4>
<div class="paragraph">
<p><a id="_ix860" class="ixterm"></a><a id="_ix861" class="ixterm"></a>Menus work the same in every program (see <a href="#desktop-menus">Section 5.4</a>). A menu item with a round mark is one choice of a group: choosing it clears the others in the group. An item with a check mark turns on or off each time you choose it. A key shown at the right of a menu item is its shortcut. Each program&#8217;s section lists its keys and says where they work.</p>
</div>
<div class="paragraph">
<p><a id="_ix862" class="ixterm"></a>A program whose window cannot be resized, such as Clock or Sound Recorder, has no maximize button.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-elsewhere"><a class="anchor" href="#programs-elsewhere"></a>8.2.7. Programs described elsewhere</h4>
<div class="ulist">
<ul>
<li>
<p><a id="_ix863" class="ixterm"></a>Program Manager, the desktop where you start programs: <a href="#programManager">Program Manager</a>.</p>
</li>
<li>
<p><a id="_ix864" class="ixterm"></a>Control Panel, for the mouse, colours, desktop, video mode, file types, network, printer, game controllers, and sounds: <a href="#controlPanel">Control Panel</a>.</p>
</li>
<li>
<p><a id="_ix865" class="ixterm"></a>Software, which installs, updates, and removes add-ons: <a href="#addons-software">Section 10.2</a>.</p>
</li>
<li>
<p>Terminal, which connects to other computers by serial cable, modem, secure link, or Telnet: <a href="#terminal">Terminal</a>.</p>
</li>
<li>
<p><a id="_ix866" class="ixterm"></a>The Task Manager, which lists the running programs (<span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Esc</kbd></span>): <a href="#desktop-task-manager">Section 5.10</a>.</p>
</li>
</ul>
</div>
</div>
</div>
<div class="sect2">
<h3 id="programs-file-manager"><a class="anchor" href="#programs-file-manager"></a>8.3. File Manager</h3>
<div class="paragraph">
<p><a id="_ix867" class="ixterm"></a><a id="_ix868" class="ixterm"></a><a id="_ix869" class="ixterm"></a>File Manager shows the files and folders on your disks and lets you open, copy, move, rename, and delete them. It is part of DVX and always installed.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/pgFileManager.png" alt="File Manager showing the DVX folder, with the drive bar, the folder tree, and the file list">
</div>
<div class="title">Figure 36. The File Manager window</div>
</div>
<div class="sect3">
<h4 id="programs-file-manager-start"><a class="anchor" href="#programs-file-manager-start"></a>8.3.1. Starting File Manager</h4>
<div class="paragraph">
<p><a id="_ix870" class="ixterm"></a>Double-click <strong>File Manager</strong> in Program Manager, or click <b class="button">Browse your files</b> in the Welcome window. File Manager opens on the current folder. A Program Manager item can name the folder to open in its arguments (see <a href="#progman-items">Section 6.4</a>). If File Manager cannot show that folder, it says so and shows the top folder of the drive DVX is on instead.</p>
</div>
<div class="paragraph">
<p><a id="_ix871" class="ixterm"></a>You can have several File Manager windows open at once, for example one on the folder you copy from and one on the folder you copy to. Choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">New Window</b></span> to open another window on the folder you are looking at, or start File Manager again from Program Manager. Each new window opens a little lower and further right for every File Manager window already open.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-file-manager-window"><a class="anchor" href="#programs-file-manager-window"></a>8.3.2. The File Manager window</h4>
<div class="paragraph">
<p>From top to bottom, the window has these parts:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 80%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Part</th>
<th class="tableblock halign-left valign-top">What it shows</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Title bar</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;File Manager -&#8221; and the folder you are looking at, for example <strong>File Manager - C:\DVX</strong>. While a filter is on, the filter follows the folder (see <a href="#programs-file-manager-filter">Section 8.3.8</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Menu bar</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The File, Edit, View, and Help menus.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix872" class="ixterm"></a>Drive bar</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">One button for each drive, such as <b class="button">A:</b> and <b class="button">C:</b>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix873" class="ixterm"></a>Path bar</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The <strong>Path</strong> box, with the folder you are looking at. Type another folder here and press <kbd>Enter</kbd> to go to it.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix874" class="ixterm"></a>Folder tree (left)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The folders from the top of the drive down to the current folder, the folders beside each one on the way, and the current folder&#8217;s own folders. Click a folder, or move to it with the arrow keys, to show what it holds.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">File list (right)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The folders and files in the current folder, in the columns Name, Size, Type, and Modified. Folders come first.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Status bar</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">On the left, how many items the folder holds (&#8220;<em>N</em> items&#8221;), or, when you have selected some, &#8220;<em>S</em> of <em>N</em> selected (<em>B</em> bytes)&#8221;. On the right, the free space on the drive: &#8220;<em>free</em> bytes free&#8221;.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix875" class="ixterm"></a>The drive bar has a button for every drive the computer has, even an empty floppy or CD-ROM drive. On a computer whose one floppy drive answers to both A: and B:, only one of the two letters is shown, usually A:. Clicking a drive button goes to that drive&#8217;s current folder, the folder DOS is set to on that drive, which is not always its top folder. If the drive has no disk in it, File Manager shows &#8220;Cannot open <em>path</em>.&#8221; and &#8220;The folder does not exist or the drive is not ready.&#8221;</p>
</div>
<div class="paragraph">
<p><a id="_ix876" class="ixterm"></a>In the file list, <strong>Size</strong> is in bytes with commas between thousands (1,234,567) and is blank for a folder. Files and disks over 2 GB, such as on a FAT32 disk, show their full size. <strong>Type</strong> says &#8220;Folder&#8221;, &#8220;Program&#8221; (a DVX program, whose name ends in .APP), the file&#8217;s ending followed by &#8220;File&#8221; (for example &#8220;TXT File&#8221; or &#8220;EXE File&#8221;), or just &#8220;File&#8221; when the name has no ending. <strong>Modified</strong> is the date and time the item last changed, as year-month-day and hours:minutes (2026-10-14 09:30). Hidden and system files are listed too.</p>
</div>
<div class="paragraph">
<p><a id="_ix877" class="ixterm"></a>The list has no &#8220;..&#8221; entry. To go up to the folder that holds this one, press <kbd>Backspace</kbd> or choose <span class="menuseq"><b class="menu">View</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Up One Level</b></span>.</p>
</div>
<div class="paragraph">
<p><a id="_ix878" class="ixterm"></a>The list starts sorted by name. Click a column heading to sort by that column, and click it again to reverse the order. You can also use the <strong>Sort by</strong> items on the View menu, and <strong>Descending</strong> to reverse. Folders always stay above the files. Drag the line between two column headings to change a column&#8217;s width, and drag the bar between the folder tree and the file list to share the width between them.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-file-manager-select"><a class="anchor" href="#programs-file-manager-select"></a>8.3.3. Choosing files</h4>
<div class="paragraph">
<p><a id="_ix879" class="ixterm"></a><a id="_ix880" class="ixterm"></a>Most commands work on the files and folders you select in the file list:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>Click an item to select it.</p>
</li>
<li>
<p>Hold <kbd>Ctrl</kbd> and click to add an item to the selection, or to take it out.</p>
</li>
<li>
<p>Hold <kbd>Shift</kbd> and click to select every item between the last one you clicked and this one.</p>
</li>
<li>
<p>Press the arrow keys to move the highlight, and <kbd>Shift</kbd> with an arrow key to select as you go. Moving without <kbd>Shift</kbd> leaves the selection as it is.</p>
</li>
<li>
<p>Press <kbd>Space</kbd> to select or unselect the highlighted item.</p>
</li>
<li>
<p>Press <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>A</kbd></span>, or choose <span class="menuseq"><b class="menu">Edit</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Select All</b></span>, to select everything.</p>
</li>
<li>
<p>Choose <span class="menuseq"><b class="menu">Edit</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Invert Selection</b></span> to select what was not selected and unselect the rest.</p>
</li>
<li>
<p>Type a letter to jump to the next item whose name starts with that letter. Typing the letter again goes on to the next one, round to the top of the list.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>When nothing is selected, a command works on the highlighted item.</p>
</div>
<div class="paragraph">
<p><a id="_ix881" class="ixterm"></a>When the folder tree has the focus, Rename, Delete, Copy, Cut, Properties, Copy To, and Move To work on the folder chosen in the tree. They do nothing on the top folder of a drive. Open does nothing while the tree has the focus.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-file-manager-open"><a class="anchor" href="#programs-file-manager-open"></a>8.3.4. Opening files and starting programs</h4>
<div class="paragraph">
<p><a id="_ix882" class="ixterm"></a><a id="_ix883" class="ixterm"></a>Double-click an item, or select it and press <kbd>Enter</kbd>, or choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Open</b></span>:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>A folder opens in the same window.</p>
</li>
<li>
<p>A DVX program (a file ending in .APP) starts.</p>
</li>
<li>
<p><a id="_ix884" class="ixterm"></a><a id="_ix885" class="ixterm"></a>A DOS program (a file ending in .EXE, .COM, or .BAT) runs with DVX stepped aside. First a box titled <strong>Run DOS Program</strong> says &#8220;Running <em>program</em> closes these programs first:&#8221;, lists the programs that are open, and asks &#8220;Each one asks about unsaved work as it closes. Continue?&#8221; File Manager itself is one of them. Click <b class="button">Yes</b> to go on. When the DOS program ends, DVX comes back with Program Manager. See <a href="#desktop-dos-programs">Section 5.15</a>.</p>
</li>
<li>
<p>Any other file opens in the program set for its kind of file (see <a href="#programs-common-documents">Section 8.2.4</a>).</p>
</li>
</ul>
</div>
<div class="paragraph">
<p><a id="_ix886" class="ixterm"></a>If no program is set for that kind of file, File Manager says &#8220;No program is set to open <em>EXT</em> files.&#8221; (or &#8220;these files&#8221; for a file with no ending) and &#8220;File types are set in the Control Panel.&#8221; Set one on Control Panel&#8217;s File Types page (see <a href="#cpanel-file-types">Section 7.8</a>). If the program cannot open the file, you see &#8220;<em>name</em> could not be opened.&#8221;</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-file-manager-copy"><a class="anchor" href="#programs-file-manager-copy"></a>8.3.5. Copying and moving files and folders</h4>
<div class="paragraph">
<p><a id="_ix887" class="ixterm"></a><a id="_ix888" class="ixterm"></a><a id="_ix889" class="ixterm"></a><a id="_ix890" class="ixterm"></a><a id="_ix891" class="ixterm"></a>There are two ways to copy or move files and folders. Folders are always copied or moved with everything in them.</p>
</div>
<div class="paragraph">
<p>To copy or move with the Copy To and Move To commands:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Select the files and folders.</p>
</li>
<li>
<p>Press <kbd>F8</kbd>, or choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Copy To&#8230;&#8203;</b></span>, to copy them. Press <kbd>F7</kbd>, or choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Move To&#8230;&#8203;</b></span>, to move them.</p>
</li>
<li>
<p>A Choose a Folder box opens on the current folder. Its title says what you are doing, for example <strong>Copy REPORT.TXT To</strong> or <strong>Move 3 Items To</strong>. Go into the folder the items should go to (see <a href="#desktop-file-dialogs">Section 5.6</a>). To put them in a new folder, type its name in the <strong>Folder name</strong> box: File Manager makes it.</p>
</li>
<li>
<p>Click <b class="button">OK</b>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>To copy or move between two File Manager windows, with the clipboard:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">New Window</b></span>, and in the new window go to the folder the items should go to.</p>
</li>
<li>
<p>In the first window, select the files and folders. Choose <span class="menuseq"><b class="menu">Edit</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Copy</b></span> (<span class="keyseq"><kbd>Ctrl</kbd>+<kbd>C</kbd></span>) to copy them, or <span class="menuseq"><b class="menu">Edit</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Cut</b></span> (<span class="keyseq"><kbd>Ctrl</kbd>+<kbd>X</kbd></span>) to move them.</p>
</li>
<li>
<p>In the second window, choose <span class="menuseq"><b class="menu">Edit</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Paste</b></span> (<span class="keyseq"><kbd>Ctrl</kbd>+<kbd>V</kbd></span>).</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>You can also paste in the same window after going to another folder. Copied files can be pasted again in other folders. After you paste files you cut, the clipboard is emptied.</p>
</div>
<div class="paragraph">
<p><a id="_ix892" class="ixterm"></a>Copy and Cut put the list of files on the DVX clipboard as text, so pasting into a text editor such as Notepad gives a first line <code>DVX-FILES COPY</code> (or <code>DVX-FILES CUT</code>) and then the full path of each file. You cannot drag files from one window or folder to another.</p>
</div>
<div class="paragraph">
<p><a id="_ix893" class="ixterm"></a>If you paste when the clipboard holds no files, a box titled <strong>Paste</strong> says &#8220;The clipboard holds no files. Use Copy or Cut in a File Manager window first.&#8221; If the folder you chose cannot be made, a box says &#8220;The folder <em>folder</em> cannot be made, or its drive is not ready.&#8221;</p>
</div>
<div class="paragraph">
<p><a id="_ix894" class="ixterm"></a>Each copy, move, or delete runs in a small window of its own, titled <strong>Copying</strong>, <strong>Moving</strong>, or <strong>Deleting</strong>, while you go on working. It shows the item being worked on, a bar that shows how far along the job is, and &#8220;<em>N</em> of <em>M</em> files&#8221;. Click <b class="button">Cancel</b>, or close the window, to stop. A file that was only partly copied is removed; everything finished before that stays done. When the job ends, File Manager shows the folder again.</p>
</div>
<div class="paragraph">
<p><a id="_ix895" class="ixterm"></a><a id="_ix896" class="ixterm"></a>If the folder you copy or move to already has a file with the same name, a box says &#8220;<em>destination</em> already exists.&#8221; and asks &#8220;Replace it with <em>source</em>?&#8221;:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 80%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Button</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">Yes</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Replace that file.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">No</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Keep the file that is there, and skip this one.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">Yes to All</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Replace this file and every other one without asking again.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">Cancel</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Stop the job.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix897" class="ixterm"></a><a id="_ix898" class="ixterm"></a>If a file cannot be read or written, for example because the disk is full or write-protected, or was taken out of the drive, a box says what went wrong, such as &#8220;Cannot read <em>path</em>.&#8221;, &#8220;Cannot write <em>path</em>.&#8221;, or &#8220;Cannot create folder <em>path</em>.&#8221;, followed by the reason. The reason is usually one of &#8220;The disk is full.&#8221;, &#8220;Access denied (the file may be read-only or in use, the disk write-protected or not ready).&#8221;, &#8220;The file or folder was not found.&#8221;, &#8220;The path is too long.&#8221;, or &#8220;A file or folder with that name already exists.&#8221; Choose <b class="button">Retry</b> to try again (for example after putting the disk back), <b class="button">Skip</b> to leave this item out and go on, or <b class="button">Cancel</b> to stop. In these boxes <kbd>Enter</kbd> presses the first button, and <kbd>Esc</kbd> or closing the box chooses <b class="button">Cancel</b>.</p>
</div>
<div class="paragraph">
<p>A folder cannot be copied or moved into itself or into one of its own folders, and a file or folder cannot be copied into the folder it is already in; File Manager tells you if you try (&#8220;<em>path</em> cannot be copied onto itself.&#8221;, &#8220;<em>path</em> cannot be copied into itself.&#8221;, or &#8220;<em>path</em> cannot be moved into itself.&#8221;).</p>
</div>
<div class="paragraph">
<p>Some details of copying and moving:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>A copy keeps the date and attributes of the original, with the Archive attribute set.</p>
</li>
<li>
<p>Moving to another folder on the same disk is quick, unless a file of the same name is there already. Moving to another disk copies the items and then removes the originals.</p>
</li>
<li>
<p>Moving an item to the folder it is already in does nothing.</p>
</li>
<li>
<p>When you skip some files while moving a folder, the folder itself is not removed.</p>
</li>
<li>
<p>If an item cannot be found, or its new path would be too long, File Manager says &#8220;<em>path</em> cannot be found, or the destination path would be too long. It is skipped.&#8221;</p>
</li>
</ul>
</div>
</div>
<div class="sect3">
<h4 id="programs-file-manager-organize"><a class="anchor" href="#programs-file-manager-organize"></a>8.3.6. Making folders, renaming, and deleting</h4>
<div class="paragraph">
<p><a id="_ix899" class="ixterm"></a><a id="_ix900" class="ixterm"></a>To make a folder:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Go to the folder that should hold the new one.</p>
</li>
<li>
<p>Choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">New Folder&#8230;&#8203;</b></span>.</p>
</li>
<li>
<p>In the <strong>New Folder</strong> box, type the name of the new folder over the suggested one. The suggestion is New Folder on a disk that takes long names and NEWFOLDR on one that does not.</p>
</li>
<li>
<p>Press <kbd>Enter</kbd>. File Manager makes the folder and selects it.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p><a id="_ix901" class="ixterm"></a><a id="_ix902" class="ixterm"></a>To rename a file or folder:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Select one file or folder.</p>
</li>
<li>
<p>Press <kbd>F2</kbd>, or choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Rename&#8230;&#8203;</b></span>.</p>
</li>
<li>
<p>In the <strong>Rename</strong> box (&#8220;New name for <em>old name</em>:&#8221;), type the new name.</p>
</li>
<li>
<p>Press <kbd>Enter</kbd>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>If more than one item is selected, File Manager says &#8220;Select one file or folder to rename.&#8221; You can rename an item just to change the capitals in its name, or to its own short 8.3 name (the name DOS shows for it, such as <code>LONGNA~1.TXT</code>), which then takes the place of its long name. A name in capitals that fits the 8.3 form is shown in small letters (see <a href="#trouble-files-lfn">Section 11.12.3</a>).</p>
</div>
<div class="paragraph">
<p><a id="_ix903" class="ixterm"></a><a id="_ix904" class="ixterm"></a><a id="_ix905" class="ixterm"></a>To delete files and folders:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Select them.</p>
</li>
<li>
<p>Press <kbd>Del</kbd>, or choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Delete</b></span>.</p>
</li>
<li>
<p>File Manager asks &#8220;Delete <em>path</em>?&#8221; (for one item) or &#8220;Delete these <em>N</em> items?&#8221;. Click <b class="button">Yes</b>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>Folders are deleted with everything in them. If a file is read-only, File Manager asks again: &#8220;<em>path</em> is read-only.&#8221; and &#8220;Delete it anyway?&#8221;, with <b class="button">Yes</b>, <b class="button">No</b>, <b class="button">Yes to All</b>, and <b class="button">Cancel</b>.</p>
</div>
<div class="admonitionblock warning">
<table>
<tr>
<td class="icon">
<div class="title">Warning</div>
</td>
<td class="content">
File Manager removes deleted files and folders from the disk at once. It does not keep them anywhere, so you cannot get them back from File Manager. Check the selection before you click <b class="button">Yes</b>.
</td>
</tr>
</table>
</div>
</div>
<div class="sect3">
<h4 id="programs-file-manager-names"><a class="anchor" href="#programs-file-manager-names"></a>8.3.7. File and folder names</h4>
<div class="paragraph">
<p><a id="_ix906" class="ixterm"></a><a id="_ix907" class="ixterm"></a>What a name may be depends on the disk:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>On a disk that takes long file names (when a long file name driver such as DOSLFN was loaded before DVX), a name can have up to 255 characters, including spaces, several dots, and the characters + , ; = [ ], for example Letter to Mom.final.txt. It cannot end with a dot or a space.</p>
</li>
<li>
<p>Otherwise names follow the DOS rules: one to eight characters, then, if you like, a dot and up to three more (for example REPORT.TXT). Spaces and + , ; = [ ] are not allowed.</p>
</li>
<li>
<p>On every disk the characters <code>" * / : &lt; &gt; ? \ |</code> and device names such as CON, PRN, or LPT1 are not allowed.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p><a id="_ix908" class="ixterm"></a>When a name is not allowed, a box titled <strong>New Folder</strong> or <strong>Rename</strong> says why: &#8220;Filename must not be empty.&#8221;, &#8220;Filename must be 255 characters or fewer.&#8221;, &#8220;That name is reserved.&#8221;, &#8220;Filename contains invalid characters.&#8221;, &#8220;Filename must not end with a dot or a space.&#8221;, &#8220;That name is a reserved device name.&#8221;, &#8220;Filename must be 1-8 characters before the extension.&#8221;, &#8220;Filename may contain only one dot.&#8221;, &#8220;Extension must be 3 characters or fewer.&#8221;, or &#8220;The name is too long for this folder.&#8221; Other problems show &#8220;Cannot create <em>name</em>.&#8221; or &#8220;Cannot rename <em>old</em> to <em>new</em>.&#8221; with the reason.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-file-manager-filter"><a class="anchor" href="#programs-file-manager-filter"></a>8.3.8. Showing only some files</h4>
<div class="paragraph">
<p><a id="_ix909" class="ixterm"></a>To list only some of the files in a folder:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Choose <span class="menuseq"><b class="menu">View</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Filter&#8230;&#8203;</b></span>.</p>
</li>
<li>
<p>In the <strong>Filter</strong> box (&#8220;Show only files matching:&#8221;), type a pattern, such as <code>*.TXT</code>. A <code>*</code> stands for any characters and a <code>?</code> for any one character; capitals do not matter. To give several patterns, separate them with semicolons, commas, or spaces, for example <code>*.TXT;*.BAT</code>.</p>
</li>
<li>
<p>Press <kbd>Enter</kbd>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>Folders are always listed. While a filter is on, the title bar shows it after the folder, for example <code>File Manager - C:\DOCS\*.TXT</code>. To show every file again, choose <span class="menuseq"><b class="menu">View</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Filter&#8230;&#8203;</b></span> and type <code>*.*</code>, or leave the box empty.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-file-manager-properties"><a class="anchor" href="#programs-file-manager-properties"></a>8.3.9. Properties and attributes</h4>
<div class="paragraph">
<p><a id="_ix910" class="ixterm"></a><a id="_ix911" class="ixterm"></a><a id="_ix912" class="ixterm"></a><a id="_ix913" class="ixterm"></a>Select one or more items and press <span class="keyseq"><kbd>Alt</kbd>+<kbd>Enter</kbd></span>, or choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Properties</b></span>. The <strong>Properties</strong> box shows:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 80%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Line</th>
<th class="tableblock halign-left valign-top">What it shows</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Name</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The item&#8217;s name, or the number of items selected.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Location</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The folder that holds the item (the first item, when several are selected).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Size</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The total size in bytes, counting everything inside folders. If some items could not be read, it says &#8220;(some items could not be read)&#8221;.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Contains</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">How many files and folders there are.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Modified</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The date and time the item last changed. This line is there only when one item is selected.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>A big folder takes a while to count. Until the count is done, the size and the numbers grow and are marked &#8220;so far&#8221;. You can change the attributes or close the box meanwhile.</p>
</div>
<div class="paragraph">
<p>The <strong>Attributes</strong> frame has four check boxes:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Read-only</strong></dt>
<dd>
<p>The file cannot be changed or deleted by programs until this is cleared.</p>
</dd>
<dt class="hdlist1"><strong>Hidden</strong></dt>
<dd>
<p>The file is left out of normal DOS directory listings. (File Manager still lists it.)</p>
</dd>
<dt class="hdlist1"><strong>System</strong></dt>
<dd>
<p>The file belongs to the operating system.</p>
</dd>
<dt class="hdlist1"><strong>Archive</strong></dt>
<dd>
<p>The file has changed since it was last backed up.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>When several items are selected, the boxes start as they are for the first one. Click <b class="button">OK</b> to give every selected item the four attributes as the boxes show them, or <b class="button">Cancel</b> (<kbd>Esc</kbd>) to leave them as they were. If some cannot be changed, a box says &#8220;The attributes of some items could not be changed.&#8221;</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-file-manager-menus"><a class="anchor" href="#programs-file-manager-menus"></a>8.3.10. File Manager menus</h4>
<div class="paragraph">
<p><a id="_ix914" class="ixterm"></a>The File Manager menus and their keys:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 12.5%;">
<col style="width: 25%;">
<col style="width: 12.5%;">
<col style="width: 50%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Menu</th>
<th class="tableblock halign-left valign-top">Item</th>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">File</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Open</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Enter</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens the highlighted item (see <a href="#programs-file-manager-open">Section 8.3.4</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">File</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">New Folder&#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Makes a folder in the current folder.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">File</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Copy To&#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F8</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Copies the selection to a folder you choose.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">File</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Move To&#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F7</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Moves the selection to a folder you choose.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">File</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Rename&#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F2</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Renames the one selected item.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">File</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Delete</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Del</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Deletes the selection, after asking.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">File</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Properties</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Alt</kbd>+<kbd>Enter</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Shows the size, date, and attributes of the selection.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">File</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">New Window</p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens another File Manager window on this folder.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">File</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Exit</p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Closes this File Manager window.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Edit</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Cut</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>X</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Puts the selection on the clipboard, to be moved.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Edit</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Copy</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>C</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Puts the selection on the clipboard, to be copied.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Edit</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Paste</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>V</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Copies or moves the files on the clipboard into the current folder.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Edit</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Select All</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>A</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Selects everything in the file list.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Edit</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Invert Selection</p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Selects what was not selected and unselects the rest.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">View</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Refresh</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F5</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Reads the folder again, to show changes made elsewhere.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">View</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Filter&#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Shows only the files that match a pattern.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">View</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Up One Level</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Backspace</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Goes to the folder that holds this one.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">View</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Sort by Name, Sort by Size, Sort by Type, Sort by Date</p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Sorts the list by that column (round mark; Name at first).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">View</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Descending</p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Reverses the order (check mark).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Help</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Contents</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F1</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens the File Manager help.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Help</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">About File Manager&#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Shows the program&#8217;s name and copyright.</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect3">
<h4 id="programs-file-manager-keys"><a class="anchor" href="#programs-file-manager-keys"></a>8.3.11. File Manager keys</h4>
<div class="paragraph">
<p><a id="_ix915" class="ixterm"></a><a id="_ix916" class="ixterm"></a>These keys work in File Manager:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 80%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Enter</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">In the file list, opens the highlighted item. In the <strong>Path</strong> box, goes to the folder typed there.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Backspace</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Goes up one folder (in the file list or the folder tree).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Del</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Deletes the selection (in the file list or the folder tree).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F2</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Rename.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F5</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Refresh.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F7</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Move To.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F8</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Copy To.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Alt</kbd>+<kbd>Enter</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Properties.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>A</kbd></span>, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>C</kbd></span>, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>X</kbd></span>, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>V</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Select all, copy, cut, and paste files, when the file list has the focus.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Space</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Selects or unselects the highlighted item.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Shift</kbd> with an arrow key</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Selects as you move.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Letters</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Typed quickly, one after another, jump to the item whose name starts with them; the same letter again jumps to the next item starting with it (see <a href="#desktop-lists">Section 5.5.3.6</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F1</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Help.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>In the <strong>Path</strong> box, <kbd>Del</kbd>, <kbd>Backspace</kbd>, and the <kbd>Ctrl</kbd> keys edit the text instead. When the folder tree has the focus, <kbd>Del</kbd>, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>C</kbd></span>, and <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>X</kbd></span> delete, copy, or cut the folder chosen in the tree, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>V</kbd></span> pastes into it, and <kbd>Backspace</kbd> goes up a level.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-file-manager-close"><a class="anchor" href="#programs-file-manager-close"></a>8.3.12. Closing File Manager</h4>
<div class="paragraph">
<p><a id="_ix917" class="ixterm"></a>Choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Exit</b></span>, or close the window. If a copy, move, or delete is still running, File Manager says &#8220;File operations are still running.&#8221; and asks &#8220;Stop them and close?&#8221; Click <b class="button">Yes</b> to stop them and close, or <b class="button">No</b> to keep the window open.</p>
</div>
<div class="paragraph">
<p>File Manager does not remember its settings: each window starts sorted by name, with no filter. If there is not enough memory to start a copy, move, or delete, File Manager says &#8220;Not enough memory to start the operation.&#8221;</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="programs-notepad"><a class="anchor" href="#programs-notepad"></a>8.4. Notepad</h3>
<div class="paragraph">
<p><a id="_ix918" class="ixterm"></a><a id="_ix919" class="ixterm"></a>Notepad is a simple text editor for notes, lists, letters, and small text files such as settings files and batch files. It is part of DVX and always installed.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/pgNotepad.png" alt="The Notepad window with an empty page">
</div>
<div class="title">Figure 37. Notepad with a new, empty page</div>
</div>
<div class="sect3">
<h4 id="programs-notepad-start"><a class="anchor" href="#programs-notepad-start"></a>8.4.1. Starting Notepad</h4>
<div class="paragraph">
<p><a id="_ix920" class="ixterm"></a>Double-click <strong>Notepad</strong> in Program Manager. To start Notepad with a file open, double-click a .TXT or .INI file in File Manager or Program Manager, or give the file&#8217;s name in the arguments of a Program Manager item (see <a href="#progman-items">Section 6.4</a>).</p>
</div>
<div class="paragraph">
<p>Only one Notepad runs at a time. While Notepad is open, opening a text file from File Manager or Program Manager shows the &#8220;already running&#8221; message (see <a href="#programs-common-copies">Section 8.2.3</a>); use <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Open&#8230;&#8203;</b></span> in Notepad instead.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-notepad-window"><a class="anchor" href="#programs-notepad-window"></a>8.4.2. The Notepad window</h4>
<div class="paragraph">
<p>The title bar shows the file&#8217;s path followed by &#8220;- Notepad&#8221;, or <strong>Untitled - Notepad</strong> for a new page. While there are changes you have not saved, an asterisk and a space come first, as in <strong>* Untitled - Notepad</strong>. Below the menu bar (File, Edit, and Help), the typing area fills the window. You can resize and maximize the window.</p>
</div>
<div class="paragraph">
<p>Notepad does not wrap lines: a long line goes on past the right edge, and the page scrolls sideways to show it. The <kbd>Tab</kbd> key puts a tab in the text, with tab stops every four characters.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-notepad-editing"><a class="anchor" href="#programs-notepad-editing"></a>8.4.3. Typing and editing</h4>
<div class="paragraph">
<p><a id="_ix921" class="ixterm"></a><a id="_ix922" class="ixterm"></a><a id="_ix923" class="ixterm"></a>These keys and mouse actions work in the typing area:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Key or action</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Arrow keys</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Move one character or one line.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Left</kbd></span>, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Right</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Move one word.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Home</kbd>, <kbd>End</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Move to the start or end of the line.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Page Up</kbd>, <kbd>Page Down</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Move one screenful.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Home</kbd></span>, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>End</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Move to the start or end of the text.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Shift</kbd> with any of these keys, or drag with the mouse</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Select text.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Double-click, triple-click</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Select a word, or a whole line.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>A</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Select all the text.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>X</kbd></span>, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>C</kbd></span>, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>V</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Cut, copy, and paste.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Z</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Undo the last change. Press it again to redo the change.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Tab</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Put a tab in the text.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Mouse wheel, scroll bars</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Move through a long text.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F1</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Help.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix924" class="ixterm"></a>The Edit menu has the same Cut, Copy, Paste, and Select All commands. The clipboard is shared by all programs, so you can copy text in Notepad and paste it into another program (see <a href="#desktop-clipboard">Section 5.7</a>).</p>
</div>
<div class="admonitionblock note">
<table>
<tr>
<td class="icon">
<div class="title">Note</div>
</td>
<td class="content">
Notepad has no Find, Replace, Word Wrap, or Font command, and no Undo item on its menus (use <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Z</kbd></span>).
</td>
</tr>
</table>
</div>
</div>
<div class="sect3">
<h4 id="programs-notepad-files"><a class="anchor" href="#programs-notepad-files"></a>8.4.4. Opening and saving files</h4>
<div class="paragraph">
<p><a id="_ix925" class="ixterm"></a><a id="_ix926" class="ixterm"></a><a id="_ix927" class="ixterm"></a>Notepad uses the Open and Save As boxes that every program shares (see <a href="#desktop-file-dialogs">Section 5.6</a>).</p>
</div>
<div class="paragraph">
<p>To write and save a new file:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Type your text.</p>
</li>
<li>
<p>Choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Save</b></span>. The first time, this works like Save As.</p>
</li>
<li>
<p>In the <strong>Save As</strong> box, go to the folder you want, type a name in the <strong>File name</strong> box, and click <b class="button">Save</b>. If you leave off the ending, the box adds the one from its <strong>Filter</strong> (.txt).</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>To open a file:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Open&#8230;&#8203;</b></span>.</p>
</li>
<li>
<p>The <strong>Open</strong> box first lists text files (<code>Text Files (*.txt)</code>). For any other file, such as an .INI or .BAT file, choose <code>All Files (*.*)</code> in the <strong>Filter</strong> box.</p>
</li>
<li>
<p>Pick the file and click <b class="button">Open</b>. If you type the name of a file that does not exist, the box says so and lets you choose again (see <a href="#desktop-file-dialogs">Section 5.6</a>): to start a new file, choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">New</b></span> instead, and give it its name when you save it.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>To save a copy under another name, choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Save As&#8230;&#8203;</b></span>. Notepad then works with the new file. To start a new, empty page, choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">New</b></span>.</p>
</div>
<div class="paragraph">
<p><a id="_ix928" class="ixterm"></a><a id="_ix929" class="ixterm"></a>When you choose New, Open&#8230;&#8203;, or Exit, or close the window, while there are changes you have not saved, a box titled <strong>Notepad</strong> asks &#8220;Save changes?&#8221;:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><b class="button">Yes</b> saves first. If the save fails or you cancel it, Notepad stays as it was.</p>
</li>
<li>
<p><b class="button">No</b> throws the changes away.</p>
</li>
<li>
<p><b class="button">Cancel</b> goes back to the text.</p>
</li>
</ul>
</div>
</div>
<div class="sect3">
<h4 id="programs-notepad-size"><a class="anchor" href="#programs-notepad-size"></a>8.4.5. File size and line ends</h4>
<div class="paragraph">
<p><a id="_ix930" class="ixterm"></a><a id="_ix931" class="ixterm"></a>A new page holds up to 65,536 characters. When you open a file, Notepad makes room for the whole file and 65,536 more characters, up to 262,144 characters in all. A file bigger than that is not opened at all: Notepad says &#8220;<em>path</em> is too big for Notepad.&#8221; and keeps the text you had.</p>
</div>
<div class="paragraph">
<p><a id="_ix932" class="ixterm"></a>Notepad reads files whose lines end either in a carriage return and a line feed (as most DOS programs write them) or in a line feed only. It saves every line with a carriage return and a line feed, as DOS text files have them, and adds a line end after the last line.</p>
</div>
<div class="paragraph">
<p><a id="_ix933" class="ixterm"></a><a id="_ix934" class="ixterm"></a>Notepad writes the whole text into a new file beside the old one first, and puts it in the old one&#8217;s place only when all of it was written. A save that fails, because the disk is full for example, leaves the file on the disk as it was. While it saves, the disk needs room for both copies. A read-only file is never replaced.</p>
</div>
<div class="paragraph">
<p><a id="_ix935" class="ixterm"></a>Notepad is made for plain text. A file that holds characters no text has (NUL characters, as in a program or a picture) is not opened: Notepad says &#8220;<em>path</em> is not a text file, so Notepad did not open it.&#8221; and keeps the text you had.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-notepad-print"><a class="anchor" href="#programs-notepad-print"></a>8.4.6. Printing from Notepad</h4>
<div class="paragraph">
<p><a id="_ix936" class="ixterm"></a><a id="_ix937" class="ixterm"></a>Before you print, make sure your printer&#8217;s model is chosen on the Printer page of Control Panel (see <a href="#cpanel-printer">Section 7.10</a>).</p>
</div>
<div class="paragraph">
<p>To print the text:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Print&#8230;&#8203;</b></span>.</p>
</li>
<li>
<p>In the <strong>Print</strong> box, check <strong>Print to</strong> and <strong>Copies</strong>, and choose the pages.</p>
</li>
<li>
<p>Click <b class="button">Print</b>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>The <strong>Print</strong> box has these settings:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 80%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Setting</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Print to</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Where the printout goes: LPT1, LPT2, LPT3, COM1, COM2, COM3, COM4, or File. It starts at the port set in <strong>Connected to</strong> on the Printer page of Control Panel; a choice made here is used for this printout only.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>File name</strong> and <b class="button">Browse&#8230;&#8203;</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">When <strong>Print to</strong> is File, the file to print to; it starts with the file name set on the Printer page of Control Panel, and is grayed for the other choices. A name without a folder, such as <code>PRINTER.PRN</code>, is in your USER folder. <b class="button">Browse&#8230;&#8203;</b> opens a box titled <strong>Print to File</strong> that lists <code>Printer Files (*.prn)</code> and starts in the folder of the file.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Copies</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">How many copies, 1 to 99.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Pages</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>All</strong> (with the number of pages), or <strong>These pages</strong> <strong>From</strong> one page <strong>to</strong> another.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Printer model</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The model chosen in Control Panel, shown as &#8220;Printer model: <em>model</em>&#8221;.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix938" class="ixterm"></a>If you choose File and leave the name empty, the box says &#8220;Type the name of the file to print to.&#8221; If the first page comes after the last one, it says &#8220;The first page to print comes after the last one.&#8221;</p>
</div>
<div class="paragraph">
<p>While Notepad prints, a small window titled <strong>Printer</strong> says &#8220;Printing <em>what</em> on <em>where</em>&#8230;&#8203;&#8221;. Click its <b class="button">Cancel</b> button to stop. If the printer has a problem, for example it is out of paper, a box asks you to choose <b class="button">Retry</b> or <b class="button">Cancel</b>. If printing fails, you see &#8220;The document could not be printed.&#8221;</p>
</div>
<div class="paragraph">
<p><a id="_ix939" class="ixterm"></a><a id="_ix940" class="ixterm"></a><span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Page Setup&#8230;&#8203;</b></span> sets how text is laid out on the paper. These settings are saved for next time, and other programs that print text use them too.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 33.3333%;">
<col style="width: 66.6667%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Setting</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Lines per page</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">How many lines fit on a sheet: 0, or 10 to 200. 0 means the printer&#8217;s usual page length.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Characters per line</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">How many characters fit across, 20 to 255.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Top margin (lines)</strong>, <strong>Bottom margin (lines)</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Blank lines at the top and bottom of each page, 0 to 200.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Left margin</strong>, <strong>Right margin</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Blank characters at the left and right, 0 to 255.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Tab width</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The space between tab stops in the printout, 1 to 16.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Header</strong>, <strong>Footer</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A line printed at the top or bottom of every page.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Wrap long lines (otherwise they are cut off)</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">When ticked, a line too long for the page goes on to the next line; when clear, the rest of it is not printed.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>The header and footer can hold these codes:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 80%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Code</th>
<th class="tableblock halign-left valign-top">What it prints</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>&amp;f</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file&#8217;s name with its path, or &#8220;Untitled&#8221; for a page not yet saved.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>&amp;p</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The page number.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>&amp;n</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The number of pages.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>&amp;d</code>, <code>&amp;t</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The date and the time.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>&amp;l</code>, <code>&amp;c</code>, <code>&amp;r</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Put what follows at the left, in the centre, or at the right.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>For example, the footer <code>&amp;cPage &amp;p of &amp;n</code> prints &#8220;Page 1 of 3&#8221; in the middle of the first page of three, and the header <code>&amp;l&amp;f&amp;rPage &amp;p</code> prints the file name at the left and the page number at the right. If the settings cannot work together, a box titled <strong>Page Setup</strong> says why, and you can change them.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-notepad-menus"><a class="anchor" href="#programs-notepad-menus"></a>8.4.7. Notepad menus</h4>
<div class="paragraph">
<p><a id="_ix941" class="ixterm"></a>None of Notepad&#8217;s menu items has a shortcut key; the editing keys work in the typing area (see <a href="#programs-notepad-editing">Section 8.4.3</a>).</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 12.5%;">
<col style="width: 25%;">
<col style="width: 62.5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Menu</th>
<th class="tableblock halign-left valign-top">Item</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">File</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">New</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Starts a new, empty page (asks to save changes first).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">File</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Open&#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens a file (asks to save changes first).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">File</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Save</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Saves to the current file; the first time, asks for a name.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">File</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Save As&#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Saves under a new name, and goes on working with the new file.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">File</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Page Setup&#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Sets how printed pages are laid out.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">File</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Print&#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Prints the text.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">File</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Exit</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Closes Notepad (asks to save changes first).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Edit</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Cut, Copy, Paste</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Cut or copy the selected text, or paste at the cursor.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Edit</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Select All</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Selects all the text.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Help</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Contents</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens the Notepad help.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Help</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">About Notepad&#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Shows the program&#8217;s name and copyright.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>Notepad remembers nothing of its own between uses. The Page Setup settings are DVX&#8217;s shared printing settings, and the <strong>Print</strong> box starts each time with the printer port set on the Printer page of Control Panel.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-notepad-messages"><a class="anchor" href="#programs-notepad-messages"></a>8.4.8. Notepad messages</h4>
<div class="paragraph">
<p><a id="_ix942" class="ixterm"></a><a id="_ix943" class="ixterm"></a>Notepad may show these messages, in boxes titled <strong>Notepad</strong>:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>&#8220;Could not open <em>path</em> (error <em>N</em>).&#8221; The file could not be read; the text you had stays.</p>
</li>
<li>
<p>&#8220;Could not save <em>path</em> (error <em>N</em>).&#8221; The file could not be written or replaced, for example because it is read-only (error 75), its folder does not exist (error 76), or the disk is full (error 61); see <a href="#trouble-files">Section 11.12</a> for the other numbers. The text stays unsaved, and the asterisk stays in the title bar. The file on the disk is left as it was: save again on another disk, or after making room.</p>
</li>
<li>
<p>&#8220;<em>path</em> is not a text file, so Notepad did not open it.&#8221; The file holds characters no text has (see <a href="#programs-notepad-size">Section 8.4.5</a>).</p>
</li>
<li>
<p>&#8220;<em>path</em> is too big for Notepad.&#8221; The file is bigger than Notepad can hold (see <a href="#programs-notepad-size">Section 8.4.5</a>).</p>
</li>
</ul>
</div>
</div>
</div>
<div class="sect2">
<h3 id="programs-clock"><a class="anchor" href="#programs-clock"></a>8.5. Clock</h3>
<div class="paragraph">
<p><a id="_ix944" class="ixterm"></a><a id="_ix945" class="ixterm"></a><a id="_ix946" class="ixterm"></a>Clock shows the time and today&#8217;s date in a small window. It is part of DVX and always installed.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/pgClock.png" alt="The Clock window showing the time and the date">
</div>
<div class="title">Figure 38. The Clock window</div>
</div>
<div class="paragraph">
<p>Double-click <strong>Clock</strong> in Program Manager. The window opens near the top right corner of the screen. The time is shown with hours from 1 to 12 and AM or PM, such as 3:07:42 PM, and the date as year-month-day, such as 2026-09-27. Both change every second.</p>
</div>
<div class="paragraph">
<p><a id="_ix947" class="ixterm"></a>You can run more than one Clock. Each new Clock opens a little lower and further left for every Clock already open; when the next one would run off the screen, it goes back to the corner.</p>
</div>
<div class="paragraph">
<p><a id="_ix948" class="ixterm"></a>The time and date come from the computer&#8217;s clock. To correct them, use the DOS <code>TIME</code> and <code>DATE</code> commands before you start DVX. Clock has no settings: there is no 24-hour display, alarm, or clock face.</p>
</div>
<div class="paragraph">
<p>The Clock window cannot be resized, so it has no maximize button. You can move it, minimize it, and close it; closing it ends that Clock. Its only menu is Help, with <strong>Contents</strong> (<kbd>F1</kbd>), which opens the Clock help, and <strong>About Clock&#8230;&#8203;</strong>, which shows the program&#8217;s name and copyright.</p>
</div>
</div>
<div class="sect2">
<h3 id="programs-image-viewer"><a class="anchor" href="#programs-image-viewer"></a>8.6. Image Viewer</h3>
<div class="paragraph">
<p><a id="_ix949" class="ixterm"></a><a id="_ix950" class="ixterm"></a>Image Viewer shows pictures saved as BMP, PNG, JPEG, or GIF files. It never changes the picture file. It is part of DVX and always installed.</p>
</div>
<div class="sect3">
<h4 id="programs-image-viewer-start"><a class="anchor" href="#programs-image-viewer-start"></a>8.6.1. Starting Image Viewer</h4>
<div class="paragraph">
<p><a id="_ix951" class="ixterm"></a>Double-click <strong>Image Viewer</strong> in Program Manager. To start it with a picture, double-click a .BMP, .JPG, .PNG, or .GIF file in File Manager or Program Manager, or give the picture&#8217;s name in the arguments of a Program Manager item (see <a href="#progman-items">Section 6.4</a>).</p>
</div>
<div class="paragraph">
<p>Only one Image Viewer runs at a time. To look at another picture while it is open, use <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Open&#8230;&#8203;</b></span> in Image Viewer.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-image-viewer-window"><a class="anchor" href="#programs-image-viewer-window"></a>8.6.2. Looking at a picture</h4>
<div class="paragraph">
<p><a id="_ix952" class="ixterm"></a>To open a picture, choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Open&#8230;&#8203;</b></span>, or double-click anywhere in the picture area. The <strong>Open Image</strong> box first lists pictures (<code>Images (*.bmp;*.png;*.jpg;*.gif)</code>); choose <code>All Files (*.*)</code> to see every file. Pick a picture and click <b class="button">Open</b>.</p>
</div>
<div class="paragraph">
<p>The picture area fills the window. The title bar shows the picture&#8217;s path followed by &#8220;- Image Viewer&#8221;. A picture that fits is shown at its real size, in the middle. A bigger picture is shrunk to fit, keeping its shape; a picture is never enlarged. To see a large picture in more detail, make the window bigger or maximize it. A GIF file shows its first picture only.</p>
</div>
<div class="paragraph">
<p>Image Viewer has no zoom, scroll, next picture, or rotate commands.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-image-viewer-print"><a class="anchor" href="#programs-image-viewer-print"></a>8.6.3. Printing a picture</h4>
<div class="paragraph">
<p><a id="_ix953" class="ixterm"></a><a id="_ix954" class="ixterm"></a>The printer model chosen on the Printer page of Control Panel must be one that prints pictures (see <a href="#cpanel-printer">Section 7.10</a>). If it prints text only, a box titled <strong>Print</strong> says &#8220;The printer model chosen in the Control Panel prints text only. To print pictures, choose your printer&#8217;s model on the Control Panel&#8217;s Printer page.&#8221;</p>
</div>
<div class="paragraph">
<p>To print the picture you are looking at:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Print&#8230;&#8203;</b></span>.</p>
</li>
<li>
<p>In the <strong>Print</strong> box, choose <strong>Print to</strong> and <strong>Copies</strong>. The box is the same as Notepad&#8217;s (see <a href="#programs-notepad-print">Section 8.4.6</a>), without the <strong>Pages</strong> frame.</p>
</li>
<li>
<p>Click <b class="button">Print</b>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>The picture is printed as large as fits on the page, keeping its shape, one page for each copy. On a colour printer model it prints in colour; on a model with black ink only, it prints in black dots whose spacing makes the shades.</p>
</div>
<div class="paragraph">
<p><a id="_ix955" class="ixterm"></a>If the printer has a problem, a box asks you to choose <b class="button">Retry</b> or <b class="button">Cancel</b>. If printing fails you may see &#8220;The picture could not be printed.&#8221;, &#8220;Not enough memory to print the picture.&#8221;, or &#8220;Cannot read the picture <em>path</em>.&#8221;</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-image-viewer-menus"><a class="anchor" href="#programs-image-viewer-menus"></a>8.6.4. Image Viewer menus and messages</h4>
<div class="paragraph">
<p><a id="_ix956" class="ixterm"></a>None of Image Viewer&#8217;s menu items has a shortcut key. Press <span class="keyseq"><kbd>Alt</kbd>+<kbd>F</kbd></span> or <span class="keyseq"><kbd>Alt</kbd>+<kbd>H</kbd></span> to open a menu from the keyboard.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 12.5%;">
<col style="width: 25%;">
<col style="width: 62.5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Menu</th>
<th class="tableblock halign-left valign-top">Item</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">File</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Open&#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens a picture.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">File</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Print&#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Prints the picture you are looking at.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">File</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Close</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Closes Image Viewer.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Help</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Contents</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens the Image Viewer help (also <kbd>F1</kbd>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Help</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">About Image Viewer&#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Shows the program&#8217;s name and copyright.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>Image Viewer may show these messages, in boxes titled <strong>Image Viewer</strong>:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>&#8220;Could not load <em>path</em>.&#8221; The picture could not be read. The window is left empty.</p>
</li>
<li>
<p>&#8220;Open a picture first.&#8221; You chose Print&#8230;&#8203; with no picture open.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>Image Viewer remembers nothing between uses.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="programs-media-player"><a class="anchor" href="#programs-media-player"></a>8.7. Media Player</h3>
<div class="paragraph">
<p><a id="_ix957" class="ixterm"></a><a id="_ix958" class="ixterm"></a><a id="_ix959" class="ixterm"></a>Media Player plays music and sounds from a list, one after another: music modules, MIDI music, and recorded sounds. It comes with the Media part.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/pgMediaPlayer.png" alt="The Media Player window with its buttons, sliders, and an empty list">
</div>
<div class="title">Figure 39. Media Player, ready to play</div>
</div>
<div class="sect3">
<h4 id="programs-media-player-formats"><a class="anchor" href="#programs-media-player-formats"></a>8.7.1. What Media Player plays</h4>
<div class="paragraph">
<p><a id="_ix960" class="ixterm"></a><a id="_ix961" class="ixterm"></a><a id="_ix962" class="ixterm"></a>Media Player plays these kinds of files:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 14.2857%;">
<col style="width: 28.5714%;">
<col style="width: 57.1429%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Kind</th>
<th class="tableblock halign-left valign-top">Files ending in</th>
<th class="tableblock halign-left valign-top">Notes</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Music modules</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">.MOD, .S3M, .XM, .IT</p></td>
<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">MIDI music</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">.MID, .RMI</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Type 0, type 1, and type 2 MIDI files (the songs in a type 2 file play one after another). A damaged track plays up to where it breaks.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Recorded sound</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">.WAV</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Uncompressed sound only: 8-bit or 16-bit, mono or stereo, 4,000 to 48,000 Hz. A file that was cut short plays what is there.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Recorded sound</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">.VOC</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">8-bit or 16-bit sound. Compressed (Creative ADPCM) VOC files are refused.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>WAV and VOC files are read from the disk as they play, so even a long recording needs little memory. Media Player does not play music CDs.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-media-player-start"><a class="anchor" href="#programs-media-player-start"></a>8.7.2. Starting Media Player</h4>
<div class="paragraph">
<p><a id="_ix963" class="ixterm"></a>Double-click <strong>Media Player</strong> in Program Manager. You can also double-click a music or sound file (one of the kinds above) in File Manager or Program Manager: Media Player starts and plays it.</p>
</div>
<div class="paragraph">
<p>Only one Media Player runs at a time. If it is already open when you open a music or sound file, the file is added to the end of its list (unless it is there already) and plays, and Media Player&#8217;s window comes to the front. So double-clicking one file after another in File Manager builds up a list.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-media-player-window"><a class="anchor" href="#programs-media-player-window"></a>8.7.3. The Media Player window</h4>
<div class="paragraph">
<p>From top to bottom:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 80%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Part</th>
<th class="tableblock halign-left valign-top">What it shows</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Title line (bold)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Nothing is playing&#8221; when no track is loaded. Otherwise the music&#8217;s own title (modules, and MIDI files that have one), or else the file&#8217;s name. The window&#8217;s title bar shows it too, followed by &#8220;- Media Player&#8221;.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Information line</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">What kind of file it is and what plays it, for example &#8220;Module (XM) - Sound device&#8221; or &#8220;MIDI music (MID) - OPL3 FM synthesizer at 388h&#8221;. After a failure it shows the reason.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Position slider</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Where the music is. Drag it to go to another place. It is grayed when nothing is loaded.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Time</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The time played and the whole length, in minutes and seconds, such as 1:23 / 4:56.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Buttons</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">Previous</b>, <b class="button">Play</b> (it says <b class="button">Pause</b> while music plays), <b class="button">Stop</b> (grayed when nothing is loaded), and <b class="button">Next</b>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Volume</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A slider from 0 to 100. It is at 100 the first time; after that, where you left it.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Track list</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The files to play, by name. Without Shuffle they play in this order.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>You can resize and maximize the window; the list grows with it. Rest the pointer on a slider to see what it does.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-media-player-play"><a class="anchor" href="#programs-media-player-play"></a>8.7.4. Playing music</h4>
<div class="paragraph">
<p><a id="_ix964" class="ixterm"></a>To play one file:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Open&#8230;&#8203;</b></span> (<span class="keyseq"><kbd>Ctrl</kbd>+<kbd>O</kbd></span>).</p>
</li>
<li>
<p>In the <strong>Open</strong> box, pick the file. The box lists music and sound files first; choose <code>All Files (*.*)</code> to see every file. It starts in the folder you used last.</p>
</li>
<li>
<p>Click <b class="button">Open</b>. The file plays at once and is added to the end of the list, unless it is there already.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>To play a track from the list, double-click it, or select it and press <kbd>Enter</kbd>.</p>
</div>
<div class="paragraph">
<p><a id="_ix965" class="ixterm"></a>The controls:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 80%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Control</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">Play</b> / <b class="button">Pause</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Plays the selected track. While music plays the button says <b class="button">Pause</b> and pauses it; click it again to go on from the same place. With nothing selected, it plays the loaded track, or else the first track to play (with Shuffle on, the first of the mixed-up order); with an empty list it does nothing.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">Stop</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Stops the music and goes back to the start of the track.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">Previous</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">More than three seconds into a track, goes back to its start; otherwise goes to the track before. On the first track it starts that track again, or, with Repeat List on, goes to the last track.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">Next</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Goes to the next track. On the last track it does nothing, unless Repeat List is on.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Position slider</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Drag it to go to another place in the track. Or click it and use the keys: the arrow keys move 1 second, <kbd>Page Up</kbd> and <kbd>Page Down</kbd> a tenth of the track, <kbd>Home</kbd> and <kbd>End</kbd> to the start or the end. The music jumps there once the slider has stood still a moment.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Volume</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Drag it to make the music quieter or louder, or click it and use the arrow keys (1 step) or <kbd>Page Up</kbd> and <kbd>Page Down</kbd> (10 steps).</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>When a track ends, the next one plays. After the last track Media Player stops, unless Repeat List is on. If the next track cannot be played (when a track ends, or when you click <b class="button">Next</b> or <b class="button">Previous</b>), Media Player tries the one after it (or, going back, the one before), until one plays or every track has been tried. Then one message names all the tracks it could not play and says why. A track you choose yourself, by double-clicking it, with <b class="button">Play</b>, or with Open&#8230;&#8203;, only gives the message.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-media-player-list"><a class="anchor" href="#programs-media-player-list"></a>8.7.5. Making a play list</h4>
<div class="paragraph">
<p><a id="_ix966" class="ixterm"></a><a id="_ix967" class="ixterm"></a>To build a list of tracks:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Add File&#8230;&#8203;</b></span> to add one file to the end of the list, or <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Add Folder&#8230;&#8203;</b></span> to add every music and sound file in a folder (not in the folders inside it), sorted by name.</p>
</li>
<li>
<p>Repeat for more files and folders. A file is listed only once: Add File and Add Folder leave out files that are in the list already, and those stay where they are.</p>
</li>
<li>
<p>To change the order, select a track and press <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Up</kbd></span> or <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Down</kbd></span> (or choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Move Up</b></span> or <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Move Down</b></span>).</p>
</li>
<li>
<p>To take a track out, select it and press <kbd>Del</kbd> (or choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Remove</b></span>). If it is the track that is loaded, the music stops, and <b class="button">Next</b> then plays the track that came after it.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p><span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Clear List</b></span> empties the list. The track that is playing goes too, so the music stops. Taking tracks out of the list never deletes the files.</p>
</div>
<div class="paragraph">
<p><a id="_ix968" class="ixterm"></a>Media Player remembers the list, the track you had selected, the volume, the Repeat and Shuffle choices, and the folder you last used. It saves them in <code>PLAYER.INI</code> in its folder in your user folder when it closes. The next time it starts, the list is there, ready to play.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-media-player-repeat"><a class="anchor" href="#programs-media-player-repeat"></a>8.7.6. Repeat and shuffle</h4>
<div class="paragraph">
<p><a id="_ix969" class="ixterm"></a><a id="_ix970" class="ixterm"></a>The Play menu has three Repeat choices, one of which is always chosen, and Shuffle, which you turn on and off:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Repeat Off</strong></dt>
<dd>
<p>Play the list once and stop. This is the choice at first.</p>
</dd>
<dt class="hdlist1"><strong>Repeat List</strong></dt>
<dd>
<p>After the last track, start the list again.</p>
</dd>
<dt class="hdlist1"><strong>Repeat Track</strong></dt>
<dd>
<p>Play the same track over and over. It takes effect at once.</p>
</dd>
<dt class="hdlist1"><strong>Shuffle</strong></dt>
<dd>
<p>Play the tracks in a mixed-up order, starting with the current track. Each track plays once before any plays again, unless you play one again yourself, and that holds when you add, move, or take out tracks too: tracks you add are mixed in among the ones still to come. When you pick a track yourself, the tracks that have not played yet still come later in the round. With Repeat List each new round has a new order.</p>
</dd>
</dl>
</div>
</div>
<div class="sect3">
<h4 id="programs-media-player-hardware"><a class="anchor" href="#programs-media-player-hardware"></a>8.7.7. Where the music plays</h4>
<div class="paragraph">
<p><a id="_ix971" class="ixterm"></a><a id="_ix972" class="ixterm"></a><a id="_ix973" class="ixterm"></a>Media Player plays through your sound card, as set on the Sounds page of Control Panel (see <a href="#cpanel-sounds">Section 7.12</a>). The end of the information line says what plays the music:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>Modules and recorded sounds play on any sound card that plays recorded sound (&#8220;Sound device&#8221;). With a Gravis UltraSound or a Sound Blaster AWE32 or AWE64, modules can play on the card&#8217;s own voices; the <strong>Modules</strong> setting on the Sounds page chooses this.</p>
</li>
<li>
<p>MIDI music plays where the <strong>MIDI music</strong> setting on the Sounds page says: on a MIDI port (an external keyboard or sound module), on the FM synthesizer chip (for example &#8220;OPL3 FM synthesizer at 388h&#8221;), on a wavetable card, or on DVX&#8217;s own built-in synthesizers (&#8220;FM software synthesizer&#8221; or &#8220;SoundFont software synthesizer&#8221;).</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>A change to the sound driver or the MIDI choice takes effect the next time DVX starts. While Sound Recorder records sound, most music cannot play: music already playing waits and goes on when the recording stops, and a new track cannot start until then (Media Player gives the reason &#8220;No sound device can play this music&#8221;). MIDI music sent to a MIDI port, and modules played on the card&#8217;s own voices, can still play.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-media-player-menus"><a class="anchor" href="#programs-media-player-menus"></a>8.7.8. Media Player menus</h4>
<div class="paragraph">
<p><a id="_ix974" class="ixterm"></a>The Media Player menus and their keys:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 12.5%;">
<col style="width: 25%;">
<col style="width: 12.5%;">
<col style="width: 50%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Menu</th>
<th class="tableblock halign-left valign-top">Item</th>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">File</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Open&#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>O</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens a file and plays it at once, adding it to the end of the list unless it is there already.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">File</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Add File&#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Adds a file to the end of the list, without playing it, unless it is there already.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">File</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Add Folder&#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Adds every music and sound file in a folder that is not in the list yet, sorted by name.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">File</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Move Up</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Up</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Moves the selected track one place up.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">File</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Move Down</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Down</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Moves the selected track one place down.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">File</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Remove</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Del</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Takes the selected track out of the list (the key works in the list).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">File</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Clear List</p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Empties the list; the music stops.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">File</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Exit</p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Closes Media Player.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Play</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Play / Pause</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>P</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Plays, pauses, or goes on.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Play</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Stop</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>S</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Stops and goes back to the start of the track.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Play</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Previous</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>B</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The start of the track, or the track before.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Play</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Next</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>F</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The next track.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Play</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Repeat Off, Repeat List, Repeat Track</p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">How the list repeats (round mark).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Play</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Shuffle</p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Plays the list in a mixed-up order (check mark).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Help</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Contents</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F1</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens the Media Player help.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Help</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">About Media Player&#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Shows the program&#8217;s name, the kinds of files it plays, and its copyright.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix975" class="ixterm"></a>Besides the keys in the table, <kbd>Enter</kbd> in the list plays the selected track, and <span class="keyseq"><kbd>Alt</kbd>+<kbd>V</kbd></span>, <span class="keyseq"><kbd>Alt</kbd>+<kbd>A</kbd></span>, <span class="keyseq"><kbd>Alt</kbd>+<kbd>S</kbd></span>, and <span class="keyseq"><kbd>Alt</kbd>+<kbd>N</kbd></span> press the <b class="button">Previous</b>, <b class="button">Play</b>, <b class="button">Stop</b>, and <b class="button">Next</b> buttons.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-media-player-messages"><a class="anchor" href="#programs-media-player-messages"></a>8.7.9. Media Player messages</h4>
<div class="paragraph">
<p><a id="_ix976" class="ixterm"></a><a id="_ix977" class="ixterm"></a>When a track cannot be loaded or played, a box titled <strong>Media Player</strong> says &#8220;Media Player cannot play <em>file</em>.&#8221; and gives the reason. When several tracks in a row cannot be played, one box names them all (the first five, then how many others, as in &#8220;Media Player cannot play <em>file</em>, <em>file</em>, and <em>n</em> other tracks.&#8221;) and gives each reason once:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Reason</th>
<th class="tableblock halign-left valign-top">What it means</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The file could not be read&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file is missing, or the disk cannot be read.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Not a music or sound file (MOD, S3M, XM, IT, MIDI, WAV, or VOC)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Media Player does not play this kind of file.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The music file is damaged or incomplete&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file is damaged or was cut short.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;No sound device can play this music&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Nothing set up on the Sounds page of Control Panel can play it. Check the settings there (see <a href="#cpanel-sounds">Section 7.12</a>). You also see this while Sound Recorder is recording sound.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The instrument bank for MIDI music is missing or damaged&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the <strong>Instruments</strong> and <strong>SoundFont</strong> settings on the Sounds page of Control Panel.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Not enough memory&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">There is not enough free memory. Close some programs and try again.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Unsupported sound format (only uncompressed 8- and 16-bit sound can be played)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The WAV or VOC file is compressed, or its sound is not 8-bit or 16-bit, mono or stereo, at 4,000 to 48,000 Hz.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>Add Folder may also say &#8220;The folder <em>folder</em> cannot be read.&#8221; or &#8220;There are no music or sound files in <em>folder</em>.&#8221;</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="programs-sound-recorder"><a class="anchor" href="#programs-sound-recorder"></a>8.8. Sound Recorder</h3>
<div class="paragraph">
<p><a id="_ix978" class="ixterm"></a><a id="_ix979" class="ixterm"></a><a id="_ix980" class="ixterm"></a>Sound Recorder records sound from your sound card&#8217;s microphone, line, or CD input, plays it back, and saves it as a WAV file, which Media Player and other programs can play. It also records what you play on a MIDI keyboard into a MIDI file. It comes with the Media part.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/pgSoundRecorder.png" alt="The Sound Recorder window with the Record, Stop, and Play buttons">
</div>
<div class="title">Figure 40. Sound Recorder, ready to record</div>
</div>
<div class="sect3">
<h4 id="programs-sound-recorder-start"><a class="anchor" href="#programs-sound-recorder-start"></a>8.8.1. Starting Sound Recorder</h4>
<div class="paragraph">
<p><a id="_ix981" class="ixterm"></a>Double-click <strong>Sound Recorder</strong> in Program Manager. No kind of file opens in Sound Recorder by double-clicking (WAV files open in Media Player); to play a file in Sound Recorder, use its <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Open&#8230;&#8203;</b></span> command. Only one Sound Recorder runs at a time.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-sound-recorder-window"><a class="anchor" href="#programs-sound-recorder-window"></a>8.8.2. The Sound Recorder window</h4>
<div class="paragraph">
<p>The window cannot be resized. From top to bottom:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 80%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Part</th>
<th class="tableblock halign-left valign-top">What it shows</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Name line (bold)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;New recording&#8221; before you record, &#8220;New recording (not saved)&#8221; after, or the name of the file you saved or opened. The title bar shows it too, followed by &#8220;- Sound Recorder&#8221;.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">State line</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Recording from the microphone&#8230;&#8203;&#8221; (or the line input, the CD, or the MIDI keyboard), &#8220;Playing&#8221;, or &#8220;Stopped&#8221;. If the sound card cannot record at all, it says &#8220;This computer&#8217;s sound card cannot record.&#8221;</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Time</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The length recorded so far, or the length of the recording, in minutes, seconds, and tenths, such as 0:12.5.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Level bar</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">How loud the sound coming in is. For a MIDI recording, how hard the last key was struck.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Buttons</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">Record</b>, <b class="button">Stop</b>, and <b class="button">Play</b>. Record is grayed while recording, or when the chosen input cannot record; Stop works only while recording or playing; Play works when there is something to play and nothing else is going on.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Format line</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">What the sound card is really recording, such as &#8220;22,050 Hz, 8-bit, mono&#8221;, or &#8220;MIDI&#8221; for a MIDI recording. It is empty for a file you opened.</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect3">
<h4 id="programs-sound-recorder-record"><a class="anchor" href="#programs-sound-recorder-record"></a>8.8.3. Recording sound</h4>
<div class="paragraph">
<p><a id="_ix982" class="ixterm"></a>To record sound:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>On the Options menu, choose the input: <strong>Microphone</strong>, <strong>Line In</strong> (a tape player, a radio, or another device plugged into the sound card), or <strong>CD Audio</strong> (a music CD in the CD-ROM drive).</p>
</li>
<li>
<p>On the Options menu, choose the quality (see below).</p>
</li>
<li>
<p>Click <b class="button">Record</b>. The time counts up, and the level bar shows how loud the sound is coming in: speak or play a little louder if it barely moves, and a little softer if it stays at the end.</p>
</li>
<li>
<p>Click <b class="button">Stop</b> when you are done.</p>
</li>
<li>
<p>Click <b class="button">Play</b> to hear it.</p>
</li>
<li>
<p>Choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Save As&#8230;&#8203;</b></span> to keep it (see <a href="#programs-sound-recorder-save">Section 8.8.5</a>).</p>
</li>
</ol>
</div>
<div class="paragraph">
<p><a id="_ix983" class="ixterm"></a>While Sound Recorder records sound, no other program can play sound on the sound card: sounds already playing wait and go on when the recording stops. Only MIDI music sent to a MIDI port, and music modules played on the card&#8217;s own voices, still play. Only one recording can be made at a time in all of DVX.</p>
</div>
<div class="paragraph">
<p>If Microphone, Line In, or CD Audio is grayed on the Options menu, your sound card does not have that input (for MIDI Keyboard, see <a href="#programs-sound-recorder-midi">Section 8.8.4</a>). If the input you used last time is not there, Sound Recorder chooses Microphone. If <b class="button">Record</b> cannot be clicked, the sound card cannot record at all.</p>
</div>
<div class="paragraph">
<p><a id="_ix984" class="ixterm"></a>The quality decides how good the recording sounds and how much disk space it takes:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 30%;">
<col style="width: 20%;">
<col style="width: 30%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Options menu item</th>
<th class="tableblock halign-left valign-top">Sounds like</th>
<th class="tableblock halign-left valign-top">Space for a minute</th>
<th class="tableblock halign-left valign-top">Format</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Telephone Quality</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A telephone call; fine for speech</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">About 470 KB</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">8,000 Hz, 8-bit, mono</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Radio Quality</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">An AM radio; good for speech and most sounds</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">About 1.3 MB</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">22,050 Hz, 8-bit, mono</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">CD Quality</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A music CD, in stereo</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">About 10 MB</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">44,100 Hz, 16-bit, stereo</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>Radio Quality is the choice at first. Your sound card records at the nearest it can to what you choose (an older card cannot record in stereo, for example); the format line shows what it records.</p>
</div>
<div class="paragraph">
<p><a id="_ix985" class="ixterm"></a>Until you save it, a recording is kept in Sound Recorder&#8217;s folder in your user folder, so that disk needs room for it. It is removed when Sound Recorder closes.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-sound-recorder-midi"><a class="anchor" href="#programs-sound-recorder-midi"></a>8.8.4. Recording a MIDI keyboard</h4>
<div class="paragraph">
<p><a id="_ix986" class="ixterm"></a><a id="_ix987" class="ixterm"></a>A MIDI keyboard (or another MIDI instrument) plugged into the sound card&#8217;s MIDI port can be recorded too:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>On the Sounds page of Control Panel, set <strong>MIDI in</strong> to the MIDI port, click <b class="button">OK</b>, and start DVX again (see <a href="#cpanel-sounds">Section 7.12</a>). Until then <strong>MIDI Keyboard</strong> is grayed on the Options menu.</p>
</li>
<li>
<p>In Sound Recorder, choose <span class="menuseq"><b class="menu">Options</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">MIDI Keyboard</b></span>.</p>
</li>
<li>
<p>Click <b class="button">Record</b> and play. What you play sounds at once on the computer&#8217;s music synthesizer, and the level bar shows how hard you strike the keys.</p>
</li>
<li>
<p>Click <b class="button">Stop</b> when you are done, and <b class="button">Play</b> to hear it again.</p>
</li>
<li>
<p>Choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Save As&#8230;&#8203;</b></span>. The recording is saved as a MIDI file (.MID), which takes very little disk space.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>The quality does not matter for a MIDI recording, and other programs can still play sounds while you record. If nothing can play the notes, the recording still goes on, silently.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-sound-recorder-save"><a class="anchor" href="#programs-sound-recorder-save"></a>8.8.5. Saving and opening recordings</h4>
<div class="paragraph">
<p><a id="_ix988" class="ixterm"></a>To save a recording, choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Save As&#8230;&#8203;</b></span> (or <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Save</b></span>, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>S</kbd></span>). In the <strong>Save As</strong> box, go to a folder and type a name. A name typed without an ending gets .wav for a sound recording or .mid for a MIDI recording. The box starts in the folder you used last. <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Save</b></span> can be chosen only for a recording you have not saved yet. <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Save As&#8230;&#8203;</b></span> can be chosen whenever there is something to play, and saves the recording, or the file you opened, under a new name.</p>
</div>
<div class="paragraph">
<p><a id="_ix989" class="ixterm"></a>If you have not saved a recording, Sound Recorder asks &#8220;Save changes?&#8221; before you record again, choose New or Open&#8230;&#8203;, or close it. If you choose New, Open&#8230;&#8203;, or Exit while it is still recording, the recording stops first and is kept, and then you are asked. <b class="button">Yes</b> opens the <strong>Save As</strong> box (if you cancel that, you stay where you were), <b class="button">No</b> throws the recording away, and <b class="button">Cancel</b> goes back.</p>
</div>
<div class="paragraph">
<p><a id="_ix990" class="ixterm"></a>To play a recording you made before, choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Open&#8230;&#8203;</b></span> (<span class="keyseq"><kbd>Ctrl</kbd>+<kbd>O</kbd></span>), pick a WAV or MIDI file, click <b class="button">Open</b>, and then click <b class="button">Play</b>. The <strong>Open</strong> box lists <code>Recordings (*.wav;*.mid)</code> first; choose <code>All Files (*.*)</code> to open a VOC or RMI file. Sound Recorder refuses other kinds of file, such as music modules. <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">New</b></span> (<span class="keyseq"><kbd>Ctrl</kbd>+<kbd>N</kbd></span>) starts over with no recording.</p>
</div>
<div class="paragraph">
<p>Sound Recorder remembers the quality, the input, and the folder you last used, in <code>RECORDER.INI</code> in its folder in your user folder.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-sound-recorder-menus"><a class="anchor" href="#programs-sound-recorder-menus"></a>8.8.6. Sound Recorder menus and keys</h4>
<div class="paragraph">
<p><a id="_ix991" class="ixterm"></a><a id="_ix992" class="ixterm"></a>The Sound Recorder menus and their keys:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 12.5%;">
<col style="width: 25%;">
<col style="width: 12.5%;">
<col style="width: 50%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Menu</th>
<th class="tableblock halign-left valign-top">Item</th>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">File</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">New</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>N</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Starts over with no recording (stops a recording and asks about an unsaved recording first).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">File</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Open&#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>O</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens a WAV or MIDI file to play (stops a recording and asks about an unsaved recording first).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">File</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Save</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>S</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Saves a recording not yet saved, asking for its name.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">File</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Save As&#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Saves the recording, or the file you opened, under a new name.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">File</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Exit</p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Stops recording or playing, asks about an unsaved recording, and closes.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Options</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Telephone Quality, Radio Quality, CD Quality</p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The recording quality (round mark).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Options</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Microphone, Line In, CD Audio, MIDI Keyboard</p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The input to record from (round mark).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Help</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Contents</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F1</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens the Sound Recorder help.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Help</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">About Sound Recorder&#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Shows the program&#8217;s name, what it does, and its copyright.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><span class="keyseq"><kbd>Alt</kbd>+<kbd>R</kbd></span>, <span class="keyseq"><kbd>Alt</kbd>+<kbd>T</kbd></span>, and <span class="keyseq"><kbd>Alt</kbd>+<kbd>P</kbd></span> press the <b class="button">Record</b>, <b class="button">Stop</b>, and <b class="button">Play</b> buttons.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-sound-recorder-messages"><a class="anchor" href="#programs-sound-recorder-messages"></a>8.8.7. Sound Recorder messages</h4>
<div class="paragraph">
<p><a id="_ix993" class="ixterm"></a><a id="_ix994" class="ixterm"></a>All are in boxes titled <strong>Sound Recorder</strong>.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 50%;">
<col style="width: 50%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Message</th>
<th class="tableblock halign-left valign-top">When</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Sound Recorder cannot record.&#8221; and a reason</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The recording could not start.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Sound Recorder cannot record from the MIDI keyboard.&#8221; and a reason</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The MIDI input could not be opened.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The recording could not be written.&#8221; and a reason</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A MIDI recording could not be written to the disk when the recording stopped.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The recording could not all be written.&#8221; and a reason</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A sound recording did not finish writing, for example because the disk is full. The recording cannot then be played or saved.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Sound Recorder cannot play this recording.&#8221; and a reason</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Playing failed.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Sound Recorder could not save <em>path</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Save As could not write the file.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Sound Recorder cannot open <em>file</em>.&#8221; and a reason</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file could not be opened. The reason &#8220;It is not a WAV or MIDI file.&#8221; means it is another kind of file.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>The reasons include &#8220;The synthesizer or sound device is being used by another program (or is recording)&#8221;, &#8220;The sound device cannot record from that input&#8221;, &#8220;No sound device could be started&#8221;, and &#8220;The file could not be written&#8221;.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="programs-help"><a class="anchor" href="#programs-help"></a>8.9. DVX Help</h3>
<div class="paragraph">
<p><a id="_ix995" class="ixterm"></a>DVX Help is the window that shows help: the DVX user guide and every program&#8217;s own help. A table of contents is on the left, the page you are reading on the right, and underlined words are links to other pages. You can look things up with Index or Search. DVX Help is part of DVX and always installed.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/pgHelp.png" alt="The DVX Help window with the table of contents on the left and a page with links on the right">
</div>
<div class="title">Figure 41. DVX Help showing the File Manager help</div>
</div>
<div class="sect3">
<h4 id="programs-help-open"><a class="anchor" href="#programs-help-open"></a>8.9.1. Opening DVX Help</h4>
<div class="paragraph">
<p><a id="_ix996" class="ixterm"></a><a id="_ix997" class="ixterm"></a>There are several ways to open DVX Help:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>Press <kbd>F1</kbd> in any program for help about that program. A program that has no help of its own opens the DVX user guide.</p>
</li>
<li>
<p>Choose <strong>Contents</strong> on a program&#8217;s Help menu.</p>
</li>
<li>
<p>To read the DVX user guide, choose <span class="menuseq"><b class="menu">Help</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">DVX Help</b></span> in Program Manager, or click <b class="button">Read the User Guide</b> in the Welcome window.</p>
</li>
<li>
<p>Double-click a help file (a file ending in .HLP) in File Manager.</p>
</li>
<li>
<p>Double-click <strong>DVX Help</strong> in Program Manager. Started this way, DVX Help shows its own help: how to use DVX Help. Its later pages, under <strong>Writing Help Files (for Developers)</strong>, are for people who write help files; you can skip them.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>If DVX Help is already open, <kbd>F1</kbd> and the Help menus show the new page in the same window and bring it to the front. Starting DVX Help from its icon, or opening a .HLP file, can open a second DVX Help window; it opens a little below and to the right of the one before, so it does not hide it.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-help-window"><a class="anchor" href="#programs-help-window"></a>8.9.2. The DVX Help window</h4>
<div class="paragraph">
<p><a id="_ix998" class="ixterm"></a>You can resize and maximize the window. Its parts are:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>The Navigate menu.</p>
</li>
<li>
<p>A toolbar with four buttons: <b class="button">&lt; Back</b>, <b class="button">Fwd &gt;</b>, <b class="button">Index</b>, and <b class="button">Search</b>. <b class="button">&lt; Back</b> and <b class="button">Fwd &gt;</b> are grayed when there is nowhere to go.</p>
</li>
<li>
<p><a id="_ix999" class="ixterm"></a>On the left, the table of contents. Click a page&#8217;s name to show it. Click the small box with a plus sign beside a name, or double-click the name, to see the pages under it.</p>
</li>
<li>
<p>On the right, the page. The text wraps to the width of the page. Pages can have headings, lists, notes and tips, tables, pictures, and links.</p>
</li>
<li>
<p>Between them, a bar you can drag to make the table of contents wider or narrower.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>The title bar shows the title of the page followed by &#8220;- DVX Help&#8221;.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-help-reading"><a class="anchor" href="#programs-help-reading"></a>8.9.3. Reading pages and following links</h4>
<div class="paragraph">
<p><a id="_ix1000" class="ixterm"></a>Links are underlined. Click a link to go to its page. From the keyboard, press <kbd>Tab</kbd> to move from link to link (and to the other parts of the window), and <kbd>Enter</kbd> or <kbd>Space</kbd> to follow the link that is selected.</p>
</div>
<div class="paragraph">
<p>To scroll the page from the keyboard, first click the page anywhere but on a link. Then <kbd>Up</kbd> and <kbd>Down</kbd> scroll a line, <kbd>Page Up</kbd> and <kbd>Page Down</kbd> a screenful, and <kbd>Home</kbd> and <kbd>End</kbd> go to the top and the bottom.</p>
</div>
<div class="paragraph">
<p>In the table of contents, <kbd>Up</kbd> and <kbd>Down</kbd> move to the entry above or below and show its page; <kbd>Right</kbd> opens a branch (or moves into it) and <kbd>Left</kbd> closes it (or moves to the branch above); <kbd>Enter</kbd> opens or closes a branch; and typing the first letters of an entry quickly jumps to it, as in any tree (see <a href="#desktop-trees">Section 5.5.3.10</a>).</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-help-back"><a class="anchor" href="#programs-help-back"></a>8.9.4. Going back and forward</h4>
<div class="paragraph">
<p><a id="_ix1001" class="ixterm"></a>Click <b class="button">&lt; Back</b> or press <span class="keyseq"><kbd>Alt</kbd>+<kbd>Left</kbd></span> to go back to the page you saw before. Click <b class="button">Fwd &gt;</b> or press <span class="keyseq"><kbd>Alt</kbd>+<kbd>Right</kbd></span> to go forward again. DVX Help remembers the last 64 pages for as long as the window is open. Showing a different help file in the same window, such as another program&#8217;s help, starts the list again.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-help-index"><a class="anchor" href="#programs-help-index"></a>8.9.5. Looking things up in the index</h4>
<div class="paragraph">
<p><a id="_ix1002" class="ixterm"></a>To look up a subject:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Click <b class="button">Index</b>, or choose <span class="menuseq"><b class="menu">Navigate</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Index&#8230;&#8203;</b></span>.</p>
</li>
<li>
<p>The <strong>Index</strong> box (&#8220;Select a topic:&#8221;) lists the help file&#8217;s index words in alphabetical order. Pick one and click <b class="button">OK</b>, or double-click it.</p>
</li>
<li>
<p>The page about it opens.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>If the help file has no index, DVX Help says &#8220;No index available.&#8221;</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-help-search"><a class="anchor" href="#programs-help-search"></a>8.9.6. Searching</h4>
<div class="paragraph">
<p><a id="_ix1003" class="ixterm"></a>To find every page that mentions some words:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Click <b class="button">Search</b>, or press <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>F</kbd></span>.</p>
</li>
<li>
<p>In the <strong>Search Help</strong> box (&#8220;Search for:&#8221;), type one or more words, separated by spaces.</p>
</li>
<li>
<p>Press <kbd>Enter</kbd>.</p>
</li>
<li>
<p>If exactly one page matches, it opens at once. If more match, the <strong>Search Results</strong> box says &#8220;<em>n</em> topics found:&#8221;; pick a page from the list and click <b class="button">OK</b> (or double-click it).</p>
</li>
</ol>
</div>
<div class="paragraph">
<p><a id="_ix1004" class="ixterm"></a>A page matches when its title or text contains all the words you typed, in any order; capitals do not matter. Parts of words work too: &#8220;scroll&#8221; also finds &#8220;ScrollPane&#8221;. Index words that contain the whole search text match as well. If none of the words you type has three letters or digits in a row, DVX Help looks only at page titles and index words. If nothing matches, DVX Help says &#8220;No matching topics found.&#8221;</p>
</div>
<div class="paragraph">
<p>If you press <kbd>F1</kbd> while the Index or Search box is open, the help about DVX Help itself is shown once the box closes.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-help-menus"><a class="anchor" href="#programs-help-menus"></a>8.9.7. DVX Help menu and keys</h4>
<div class="paragraph">
<p><a id="_ix1005" class="ixterm"></a><a id="_ix1006" class="ixterm"></a>DVX Help has one menu, Navigate. It has no Help menu: press <kbd>F1</kbd> for help about DVX Help itself. The keys work even though the menu does not show them.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 16.6666%;">
<col style="width: 16.6666%;">
<col style="width: 66.6668%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Navigate item</th>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Back</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Alt</kbd>+<kbd>Left</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Goes back to the page shown before.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Forward</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Alt</kbd>+<kbd>Right</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Goes forward again after Back.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Index&#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens the index.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Search&#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>F</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens the Search Help box.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Exit</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Esc</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Closes DVX Help.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>DVX Help cannot print pages or copy their text, and it has no bookmarks, find-in-page, or text size setting. To read another help file, open the .HLP file itself from File Manager. DVX Help remembers nothing once its window is closed.</p>
</div>
<div class="paragraph">
<p><a id="_ix1007" class="ixterm"></a>If a help file cannot be opened, DVX Help says &#8220;Could not open help file.&#8221; When it is already open, it keeps showing the file it had.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="programs-welcome"><a class="anchor" href="#programs-welcome"></a>8.10. Welcome</h3>
<div class="paragraph">
<p><a id="_ix1008" class="ixterm"></a><a id="_ix1009" class="ixterm"></a>Welcome introduces DVX when it starts for the first time. It shows what DVX can do and where to start, with tiles that start programs and a short tour. It is part of DVX and always installed.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/pgWelcome.png" alt="The Welcome window with its six tiles, the tip line, and the Don&#8217;t show this again check box">
</div>
<div class="title">Figure 42. The Welcome window</div>
</div>
<div class="sect3">
<h4 id="programs-welcome-when"><a class="anchor" href="#programs-welcome-when"></a>8.10.1. When Welcome appears</h4>
<div class="paragraph">
<p><a id="_ix1010" class="ixterm"></a>Welcome opens when the desktop is ready, after any notices DVX shows at start. The check box <strong>Don&#8217;t show this again</strong> is ticked when the window opens. When you close the window (with <b class="button">Close</b>, the Close box, or <span class="keyseq"><kbd>Alt</kbd>+<kbd>F4</kbd></span>):</p>
</div>
<div class="ulist">
<ul>
<li>
<p>If the box is ticked, DVX starts straight to the desktop from then on.</p>
</li>
<li>
<p>If you clear the box, Welcome appears again every time DVX starts.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>To see Welcome again later, double-click <strong>Welcome</strong> in Program Manager.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-welcome-window"><a class="anchor" href="#programs-welcome-window"></a>8.10.2. The Welcome window</h4>
<div class="paragraph">
<p>At the top a banner says &#8220;Welcome to DVX!&#8221; and &#8220;Your desktop for DOS. Here is where to start.&#8221; Below it are up to six tiles, each a picture and a button with a line under it. Clicking the picture does the same as clicking the button.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 22.2222%;">
<col style="width: 33.3333%;">
<col style="width: 44.4445%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Button</th>
<th class="tableblock halign-left valign-top">Line under it</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">Take the tour</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A quick look around DVX</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Shows the tour (see below).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">Make it yours</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Colors, wallpaper, and more</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Starts Control Panel.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">See it in action</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The DVX Demo shows it off</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Starts DVX Demo. This tile is shown only when the Demos part is installed.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">Write a program</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Make your own in DVX BASIC</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Starts DVX BASIC. This tile is shown only when the DVX BASIC part is installed.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">Browse your files</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">With the File Manager</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Starts File Manager.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">Read the User Guide</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Everything, explained</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens the DVX user guide in DVX Help.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>Under the tiles a tip line changes every six seconds. It goes round six tips, such as &#8220;Did you know? Press F1 in any program for help about it.&#8221; and &#8220;Did you know? Ctrl+Esc opens the Task Manager.&#8221; At the bottom are the <strong>Don&#8217;t show this again</strong> check box and the <b class="button">Close</b> button. The window cannot be resized.</p>
</div>
<div class="paragraph">
<p><a id="_ix1011" class="ixterm"></a>Hold <kbd>Alt</kbd> and press a button&#8217;s underlined letter to press it: <span class="keyseq"><kbd>Alt</kbd>+<kbd>T</kbd></span> for the tour, <span class="keyseq"><kbd>Alt</kbd>+<kbd>M</kbd></span>, <span class="keyseq"><kbd>Alt</kbd>+<kbd>S</kbd></span>, <span class="keyseq"><kbd>Alt</kbd>+<kbd>W</kbd></span>, <span class="keyseq"><kbd>Alt</kbd>+<kbd>B</kbd></span>, and <span class="keyseq"><kbd>Alt</kbd>+<kbd>U</kbd></span> for the other tiles, <span class="keyseq"><kbd>Alt</kbd>+<kbd>D</kbd></span> for the check box, and <span class="keyseq"><kbd>Alt</kbd>+<kbd>C</kbd></span> for <b class="button">Close</b>. Welcome&#8217;s one menu, Help, has <strong>Contents</strong> (<kbd>F1</kbd>) and <strong>About Welcome&#8230;&#8203;</strong>.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-welcome-tour"><a class="anchor" href="#programs-welcome-tour"></a>8.10.3. Taking the tour</h4>
<div class="paragraph">
<p><a id="_ix1012" class="ixterm"></a><a id="_ix1013" class="ixterm"></a>Click <b class="button">Take the tour</b>. The tour takes the place of the tiles. Each of its seven pages shows a picture, a title, and a few lines of text. Under the page you see &#8220;Page <em>n</em> of 7&#8221; and three buttons: <b class="button">&lt; Previous</b> (<span class="keyseq"><kbd>Alt</kbd>+<kbd>P</kbd></span>), <b class="button">Next &gt;</b> (<span class="keyseq"><kbd>Alt</kbd>+<kbd>N</kbd></span>), and <b class="button">End the tour</b> (<span class="keyseq"><kbd>Alt</kbd>+<kbd>E</kbd></span>). <b class="button">&lt; Previous</b> is grayed on the first page and <b class="button">Next &gt;</b> on the last. <b class="button">End the tour</b> brings the tiles back.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/pgWelcomeTour.png" alt="The second page of the Welcome tour, about Program Manager">
</div>
<div class="title">Figure 43. A page of the tour</div>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 12.5%;">
<col style="width: 25%;">
<col style="width: 62.5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Page</th>
<th class="tableblock halign-left valign-top">Title</th>
<th class="tableblock halign-left valign-top">What it says</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">1</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A quick tour of DVX</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX turns your DOS computer into a desktop of windows, menus, and icons.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">2</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Program Manager</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Programs live in groups; double-click an icon to start one, or type its name in Search.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">3</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Windows</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">How to move a window, change its size, switch windows with <span class="keyseq"><kbd>Alt</kbd>+<kbd>Tab</kbd></span>, and close one with <span class="keyseq"><kbd>Alt</kbd>+<kbd>F4</kbd></span>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">4</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Your files</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">File Manager shows your disks and folders; double-click a file to open it.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">5</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Make it yours</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Control Panel sets colors and themes, wallpaper, the mouse, sounds, joysticks, printers, and the screen.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">6</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Write your own programs</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">What DVX BASIC is for. When DVX BASIC is not installed, the page says it is an optional part you can add by running Setup again.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">7</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Help is always there</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Press <kbd>F1</kbd> in any program for help; DVX Help holds every guide, with an index and a search.</p></td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="sect2">
<h3 id="programs-demos"><a class="anchor" href="#programs-demos"></a>8.11. DVX Demo and BASIC Demo</h3>
<div class="paragraph">
<p><a id="_ix1014" class="ixterm"></a>The Demos part brings two programs that show what DVX can do. Neither changes your files.</p>
</div>
<div class="sect3">
<h4 id="programs-demos-dvx"><a class="anchor" href="#programs-demos-dvx"></a>8.11.1. DVX Demo</h4>
<div class="paragraph">
<p><a id="_ix1015" class="ixterm"></a>DVX Demo shows the kinds of windows and controls DVX offers. Start it from Program Manager, or click <b class="button">See it in action</b> in the Welcome window. It opens all its windows at once. Each can be moved, resized, minimized, and closed on its own; DVX Demo ends when its last window closes.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/pgDvxDemo.png" alt="Several DVX Demo windows open at once, with the ANSI Terminal window minimized at the bottom left">
</div>
<div class="title">Figure 44. DVX Demo&#8217;s windows</div>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 80%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Window</th>
<th class="tableblock halign-left valign-top">What it shows</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX Information</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A short description of DVX, with a full menu bar, shortcut keys, and a menu when you right-click.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Color Gradient</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A smooth fade of colour that fills the window.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Pattern</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A blue and white checkerboard with scroll bars that move the pattern.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Widget Demo</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A small form with text boxes (a <strong>Password</strong> box that hides the letters, and a <strong>Phone</strong> box that takes only digits), check boxes, option buttons, two lists, and <b class="button">OK</b> and <b class="button">Cancel</b>. Drag an item in the <strong>Items</strong> list to move it; select several items in the <strong>Multi</strong> list with <kbd>Ctrl</kbd> and <kbd>Shift</kbd>. <b class="button">OK</b>, or <kbd>Enter</kbd> (unless another button is highlighted), puts &#8220;Button clicked!&#8221; in the status line; <b class="button">Cancel</b>, or <kbd>Esc</kbd>, closes the window.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Advanced Widgets</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Many more controls on eleven tabs: Controls, Tree, List, Scroll, Toolbar, Media, Editor, Split, Disabled, Fonts, and Rich Text. On the Controls tab, rest the pointer on a control to see its tip. On the Editor tab you can draw with the mouse; on the Rich Text tab you can make words bold, italic, or underlined (<span class="keyseq"><kbd>Ctrl</kbd>+<kbd>B</kbd></span>, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>I</kbd></span>, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>U</kbd></span>); on the Fonts tab, <b class="button">Choose Font&#8230;&#8203;</b> opens the font box.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">ANSI Terminal</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A sample text terminal showing colours, bold, reverse, blinking, and line-drawing characters. It is not connected to anything. It starts minimized at the bottom of the screen; double-click its icon to open it. This window is there only when the Communications part is installed.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix1016" class="ixterm"></a>The DVX Information window&#8217;s menus mostly show a message saying what you chose:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>File: <strong>New</strong> (<span class="keyseq"><kbd>Ctrl</kbd>+<kbd>N</kbd></span>) shows a message. <strong>Open&#8230;&#8203;</strong> (<span class="keyseq"><kbd>Ctrl</kbd>+<kbd>O</kbd></span>) and <strong>Save</strong> (<span class="keyseq"><kbd>Ctrl</kbd>+<kbd>S</kbd></span>) open the real file boxes, titled <strong>Open File</strong> and <strong>Save As</strong>, then show the name you chose; nothing is opened or saved. <strong>Exit</strong> (<span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Q</kbd></span>) asks &#8220;Close this window?&#8221; and, if you click <b class="button">Yes</b>, closes the DVX Information window.</p>
</li>
<li>
<p>Edit: <strong>Cut</strong>, <strong>Copy</strong>, and <strong>Paste</strong> show messages.</p>
</li>
<li>
<p><a id="_ix1017" class="ixterm"></a>View: <strong>Terminal</strong> opens another ANSI Terminal window, which also starts minimized (only with Communications installed); <strong>Controls</strong> opens another Advanced Widgets window; <strong>Toolbar</strong> and <strong>Status Bar</strong> show check marks, and <strong>Small</strong>, <strong>Medium</strong>, and <strong>Large</strong> show round marks, but they change nothing else; the <strong>Zoom</strong> submenu shows messages; <strong>Debug Layout</strong> draws coloured outlines around the boxes that hold and arrange the controls in every DVX window, to show how windows are laid out (choose it again to turn it off).</p>
</li>
<li>
<p>Window: <strong>Cascade</strong>, <strong>Tile Grid</strong>, <strong>Tile Horizontal</strong>, and <strong>Tile Vertical</strong> arrange all the open windows.</p>
</li>
<li>
<p>Help: <strong>Contents</strong> (<kbd>F1</kbd>) and <strong>About&#8230;&#8203;</strong>.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>Right-clicking in the DVX Information window shows <strong>Cut</strong>, <strong>Copy</strong>, <strong>Paste</strong>, and <strong>Properties&#8230;&#8203;</strong>, which show messages. Closing the DVX Information window asks &#8220;Close this window?&#8221; first; the other windows close without asking. DVX Demo remembers nothing.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-demos-basic"><a class="anchor" href="#programs-demos-basic"></a>8.11.2. BASIC Demo</h4>
<div class="paragraph">
<p><a id="_ix1018" class="ixterm"></a>BASIC Demo, whose window is titled <strong>DVX BASIC Feature Tour</strong>, is a guided tour of what programs written in DVX BASIC can do. It is a good place to start if you are curious about writing your own programs.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/pgBasicDemo.png" alt="The DVX BASIC Feature Tour window with its fifteen buttons and the text area">
</div>
<div class="title">Figure 45. BASIC Demo</div>
</div>
<div class="paragraph">
<p>Fourteen of the fifteen buttons in the <strong>Language Demonstrations</strong> frame each run a small example and show the results in the text area below; the status line says when it is done. The buttons are Types, Math, Strings, Arrays, DATA/READ, Control Flow, UDT (records), Optional, Errors, Format, File I/O, System, INI, Dialogs, and Clear (which empties the text area). The File I/O and INI examples write a small file in BASIC Demo&#8217;s folder in your user folder and delete it when they finish. Dialogs shows several kinds of question boxes.</p>
</div>
<div class="paragraph">
<p><a id="_ix1019" class="ixterm"></a>The menus:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>File: <strong>Clear OutArea</strong> empties the text area. <strong>Save OutArea&#8230;&#8203;</strong> saves the text area to a text file you name. <strong>Exit</strong> closes BASIC Demo and every window it opened.</p>
</li>
<li>
<p><a id="_ix1020" class="ixterm"></a>Demos: <strong>Run All Text Demos</strong> runs every example that writes to the text area, including Objects (all but Dialogs). <strong>Graphics&#8230;&#8203;</strong> opens a window with a drawing (<b class="button">Draw</b> draws it again, <b class="button">Clear</b> wipes it). <strong>Dynamic Form&#8230;&#8203;</strong> opens a window built entirely by the program, with a counter. <strong>Timer&#8230;&#8203;</strong> opens a window that counts twice a second. <strong>Fonts&#8230;&#8203;</strong> opens a window with styled text, a <b class="button">Choose Font&#8230;&#8203;</b> button, and <b class="button">Bold</b>, <b class="button">Italic</b>, and <b class="button">Underline</b> buttons for a text box. <strong>Objects</strong> makes two shapes and lists them. <strong>Print Report&#8230;&#8203;</strong> prints a one-page sample sales report with a table and a bar chart; the printer model chosen on the Printer page of Control Panel must be one that prints pictures (see <a href="#cpanel-printer">Section 7.10</a>); otherwise BASIC Demo says &#8220;To print the report, choose your printer&#8217;s model on the Control Panel&#8217;s Printer page.&#8221;</p>
</li>
<li>
<p>Help: <strong>Contents</strong> (<kbd>F1</kbd>) and <strong>About&#8230;&#8203;</strong>.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>Choosing Graphics&#8230;&#8203;, Dynamic Form&#8230;&#8203;, Timer&#8230;&#8203;, or Fonts&#8230;&#8203; while that window is already open does nothing. You can resize the BASIC Demo window. It remembers nothing.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="programs-screen-savers"><a class="anchor" href="#programs-screen-savers"></a>8.12. Screen savers</h3>
<div class="paragraph">
<p><a id="_ix1021" class="ixterm"></a>A screen saver covers the screen with a moving picture, or a blank one, when you have not used the keyboard or mouse for a while. Four screen savers come with DVX and are always installed:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 80%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Name</th>
<th class="tableblock halign-left valign-top">What it shows</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1022" class="ixterm"></a>Blank Screen</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A black screen.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1023" class="ixterm"></a>Marquee</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The words &#8220;The DOS Visual eXecutive&#8221; drifting across the screen, bouncing off the edges and changing colour as they go.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1024" class="ixterm"></a>Mystify</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Two four-cornered outlines bouncing around the screen, each leaving a trail, and changing colour every few seconds.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1025" class="ixterm"></a>Starfield</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Stars flying out from the middle of the screen, as if you were moving through them; nearer stars are brighter and bigger.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix1026" class="ixterm"></a><a id="_ix1027" class="ixterm"></a>No screen saver is chosen when DVX is installed. To choose one, and how long DVX waits before starting it, use the <strong>Screen saver</strong> and <strong>Wait</strong> settings on the Desktop page of Control Panel; <b class="button">Test</b> there starts the chosen saver at once (see <a href="#cpanel-desktop">Section 7.6</a>). The screen savers have no settings of their own and no password.</p>
</div>
<div class="paragraph">
<p><a id="_ix1028" class="ixterm"></a>The screen saver starts after the chosen number of minutes with no key press or mouse movement. It does not start while a message or dialog box is waiting for an answer, or while a program, such as a game, is using the whole screen. It ends at the next key press or mouse movement. The key or click that wakes the screen goes to the screen saver, never to the program underneath, so it cannot change your work. See also <a href="#desktop-screen-saver">Section 5.12</a>.</p>
</div>
<div class="paragraph">
<p><a id="_ix1029" class="ixterm"></a>Program Manager does not list screen savers. More screen savers can come as add-ons, which Software installs (see <a href="#addons-kinds">Section 10.1</a>). You can also copy a screen saver program into a folder named <code>SAVERS</code> in your user folder; if there is no such folder, make one.</p>
</div>
</div>
<div class="sect2">
<h3 id="programs-developer"><a class="anchor" href="#programs-developer"></a>8.13. Developer tools</h3>
<div class="paragraph">
<p><a id="_ix1030" class="ixterm"></a><a id="_ix1031" class="ixterm"></a>These programs are for people who write their own programs, help files, and add-on packages. DVX BASIC comes with the DVX BASIC part; the others come with the Developer Tools part. Each runs only once at a time, and each has its own detailed help: press <kbd>F1</kbd> or choose <strong>Contents</strong> on its Help menu (in DVX BASIC, <strong>DVX BASIC Help</strong>). In the tools other than DVX BASIC, the menu items have no shortcut keys: open the menus with <kbd>Alt</kbd> and the underlined letters.</p>
</div>
<div class="sect3">
<h4 id="programs-developer-basic"><a class="anchor" href="#programs-developer-basic"></a>8.13.1. DVX BASIC</h4>
<div class="paragraph">
<p><a id="_ix1032" class="ixterm"></a>DVX BASIC is a programming environment in the style of Visual Basic 3 for writing your own DVX programs. It has a code editor, a designer where you draw your program&#8217;s windows, a project system, and a debugger. Start it from Program Manager, from the <b class="button">Write a program</b> tile in the Welcome window, or by double-clicking a project (.DBP) or a BASIC source file (.BAS, .FRM, .CLS, or .CTL) in File Manager.</p>
</div>
<div class="paragraph">
<p>DVX BASIC works in several windows: the main window along the top of the screen with the menus, toolbar, and status line; the Code window; a designer window for the form you are working on; the Project, Toolbox, and Properties windows; Output and Immediate along the bottom; and Locals, Call Stack, Watch, and Breakpoints for debugging. Some open only when needed, such as the Toolbox and Properties with a form, and Locals and Call Stack when a program pauses. The Window menu opens or brings forward any of them except the designer, which <span class="menuseq"><b class="menu">View</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Designer</b></span> (<span class="keyseq"><kbd>Shift</kbd>+<kbd>F7</kbd></span>) shows.</p>
</div>
<div class="paragraph">
<p><a id="_ix1033" class="ixterm"></a>To make a small program:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">New Project&#8230;&#8203;</b></span>, type the project&#8217;s name, click <b class="button">OK</b>, and choose where to save the project. The new project has no files yet.</p>
</li>
<li>
<p>Choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Add File&#8230;&#8203;</b></span> (<span class="keyseq"><kbd>Ctrl</kbd>+<kbd>O</kbd></span>), type a new name such as FORM1.FRM in the project&#8217;s folder, and answer <b class="button">Yes</b> when asked whether to create it. A blank form opens in the designer.</p>
</li>
<li>
<p>Click a control in the Toolbox, then click the form to place it. Change its settings in the Properties window, and double-click it to write the code that runs when it is used.</p>
</li>
<li>
<p>Press <kbd>F5</kbd> to run the program. Save with <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Save Project</b></span> and <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Save All</b></span>.</p>
</li>
<li>
<p>Choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Make Executable&#8230;&#8203;</b></span> to save the program as a .APP file that starts like any other program. A program saved in a folder below DVX&#8217;s <code>APPS</code> folder appears in Program Manager&#8217;s <strong>Installed Programs</strong> when you go back to Program Manager; one saved elsewhere can be started from File Manager or with <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Run&#8230;&#8203;</b></span> in Program Manager.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p><a id="_ix1034" class="ixterm"></a>In the code editor, <span class="menuseq"><b class="menu">Edit</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Find&#8230;&#8203;</b></span> (<span class="keyseq"><kbd>Ctrl</kbd>+<kbd>F</kbd></span>) and <span class="menuseq"><b class="menu">Edit</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Replace&#8230;&#8203;</b></span> (<span class="keyseq"><kbd>Ctrl</kbd>+<kbd>H</kbd></span>) find and replace text in a function, an object, a file, or the whole project; <kbd>F3</kbd> finds the next one. The Run menu has the debugger: <kbd>F9</kbd> sets or clears a breakpoint, <span class="keyseq"><kbd>Shift</kbd>+<kbd>F5</kbd></span> runs with breakpoints, and <kbd>F8</kbd> steps one statement at a time. <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Make Package&#8230;&#8203;</b></span> makes an add-on package of your program for others to install (see <a href="#addons-publishing">Section 10.7</a>). <span class="menuseq"><b class="menu">Help</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">DVX BASIC Help</b></span> (<kbd>F1</kbd>) opens the language reference, the guide to DVX BASIC, and the control reference.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-developer-icon"><a class="anchor" href="#programs-developer-icon"></a>8.13.2. Icon Editor</h4>
<div class="paragraph">
<p><a id="_ix1035" class="ixterm"></a><a id="_ix1036" class="ixterm"></a>Icon Editor draws small square pictures, such as program icons, one dot at a time. It comes with the Developer Tools part. Its window, which cannot be resized, has the enlarged picture on the left with a grid, and on the right a <strong>Preview</strong> at real size, the <strong>Color</strong> you draw with, and a <strong>Palette</strong> of 32 colours.</p>
</div>
<div class="paragraph">
<p>Choose the size on the Size menu (16 x 16, 24 x 24, or 32 x 32 dots; 32 x 32 at first); choosing a size starts a new, empty picture, after asking if you have unsaved changes. Click a colour in the palette, then click or drag on the grid to paint. The Tools menu chooses the Pencil, the Eraser (which paints light gray), or the Color Picker (which takes a dot&#8217;s colour, then goes back to the Pencil). <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Save&#8230;&#8203;</b></span> always asks for a name and saves a PNG picture, or a BMP picture if the name ends in .BMP. <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Open&#8230;&#8203;</b></span> opens a square BMP or PNG picture of 16, 24, or 32 dots. <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Print&#8230;&#8203;</b></span> prints the picture. There is no Undo: paint over a mistake.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-developer-help-editor"><a class="anchor" href="#programs-developer-help-editor"></a>8.13.3. Help Editor</h4>
<div class="paragraph">
<p><a id="_ix1037" class="ixterm"></a><a id="_ix1038" class="ixterm"></a>Help Editor writes help files for DVX Help. It comes with the Developer Tools part. You type the help source (a .DHS file) with commands for titles, headings, lists, and links. <span class="menuseq"><b class="menu">Build</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Compile</b></span> saves the source and makes the help file (.HLP) beside it; if there are mistakes, a <strong>Compile failed</strong> box lists them. <span class="menuseq"><b class="menu">Build</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Preview</b></span> compiles and shows the result in DVX Help. <span class="menuseq"><b class="menu">Help</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Help File Format</b></span> explains the commands. Double-click a .DHS file in File Manager to open it in Help Editor.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-developer-resource-editor"><a class="anchor" href="#programs-developer-resource-editor"></a>8.13.4. Resource Editor</h4>
<div class="paragraph">
<p><a id="_ix1039" class="ixterm"></a>Resource Editor looks at and changes the resources inside program files (.APP), control add-ons (.WGT), and libraries (.LIB): a program&#8217;s icon, name, author, description, and so on, which Program Manager shows. It comes with the Developer Tools part. Choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Open&#8230;&#8203;</b></span> and pick the file; the list shows each resource&#8217;s <strong>Name</strong>, <strong>Type</strong>, and <strong>Size</strong>. The Resource menu adds text or a file, edits text, saves a resource out to a file (<strong>Extract&#8230;&#8203;</strong>), and removes a resource. Common resource names are icon32, name, description, author, publisher, copyright, version, and helpfile.</p>
</div>
<div class="admonitionblock warning">
<table>
<tr>
<td class="icon">
<div class="title">Warning</div>
</td>
<td class="content">
Resource Editor writes every change into the file at once. There is no Save and no Undo, so work on a copy of the file. Do not change or remove resources you do not know: in programs written in DVX BASIC, the resources named MODULE, FORM0, FORM1, and so on hold the program itself.
</td>
</tr>
</table>
</div>
</div>
<div class="sect3">
<h4 id="programs-developer-package-builder"><a class="anchor" href="#programs-developer-package-builder"></a>8.13.5. Package Builder</h4>
<div class="paragraph">
<p><a id="_ix1040" class="ixterm"></a><a id="_ix1041" class="ixterm"></a>Package Builder makes packages: single .DPK files that hold something to add to DVX, such as a program, a library or control, fonts, sounds, themes, desktop pictures, screen savers, or MIDI instruments, for others to install with Software. It comes with the Developer Tools part. Its window has five pages: <strong>Package</strong> (the name, package name, version, kind, summary, and oldest DVX version it works with), <strong>Credits</strong>, <strong>Needs</strong> (other packages this one needs), <strong>Files</strong> (the folder that holds the package&#8217;s files), and <strong>Signing</strong> (the key to sign it with, or <strong>Not signed</strong>, and <b class="button">New Key&#8230;&#8203;</b> to make a key). Click <b class="button">Build Package&#8230;&#8203;</b> to make the package. <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Save</b></span> keeps your answers as a template (.INI) to open next time. See <a href="#addons-publishing">Section 10.7</a> and <a href="#addons-signatures">Section 10.8</a>.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-developer-widget-showcase"><a class="anchor" href="#programs-developer-widget-showcase"></a>8.13.6. Widget Showcase</h4>
<div class="paragraph">
<p><a id="_ix1042" class="ixterm"></a>Widget Showcase is a window with tabs (Text, Picks, Range, Lists, and About) where you can try the standard kinds of controls that DVX BASIC programs use. It comes with the Developer Tools part. Rest the pointer on a control to see what it is; the status bar at the bottom says what the last control did. Hold <kbd>Alt</kbd> and press a tab&#8217;s underlined letter to switch tabs. Nothing you do changes any files.</p>
</div>
</div>
<div class="sect3">
<h4 id="programs-developer-dos"><a class="anchor" href="#programs-developer-dos"></a>8.13.7. Tools for the DOS prompt</h4>
<div class="paragraph">
<p><a id="_ix1043" class="ixterm"></a>These programs run at the DOS prompt, not in DVX. They are in DVX&#8217;s <code>SYSTEM</code> folder.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 14.2857%;">
<col style="width: 28.5714%;">
<col style="width: 57.1429%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Program</th>
<th class="tableblock halign-left valign-top">Comes with</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">BASCOMP</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Compiles a DVX BASIC project into a program: <code>BASCOMP project.dbp [-o output.app] [-release]</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVXRES</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Developer Tools</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Lists, adds, gets, and strips the resources in a program file, like Resource Editor.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVXHLPC</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Developer Tools</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Compiles help source into a help file, like Help Editor&#8217;s Compile command.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVXPKG</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX (always installed)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Builds a package from a Package Builder template, makes signing keys, and signs, checks, shows, installs, removes, and lists packages. Type <code>DVXPKG</code> with nothing after it to see its commands.</p></td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="terminal"><a class="anchor" href="#terminal"></a>Chapter 9. Terminal</h2>
<div class="sectionbody">
<div class="paragraph">
<p><a id="_ix1044" class="ixterm"></a><a id="_ix1045" class="ixterm"></a><a id="_ix1046" class="ixterm"></a>Terminal connects your computer to bulletin board systems (BBSes) and to other computers. It reaches them through a serial port and a cable, through a modem and a phone line, or over the network with Telnet. It can also carry the connection over the secure link, which encrypts everything you send and receive. Terminal shows the other computer&#8217;s screen in color, plays the music some bulletin boards send, and sends and receives files with the XMODEM, YMODEM, and ZMODEM protocols.</p>
</div>
<div class="paragraph">
<p><a id="_ix1047" class="ixterm"></a>Terminal keeps a phone book of the places you connect to. Each entry, called a session, remembers how to connect and how the screen looks, so connecting again is a matter of picking the session from the list and clicking <b class="button">Connect</b>.</p>
</div>
<div class="sect2">
<h3 id="terminal-needs"><a class="anchor" href="#terminal-needs"></a>9.1. What you need</h3>
<div class="paragraph">
<p><a id="_ix1048" class="ixterm"></a><a id="_ix1049" class="ixterm"></a>Terminal is in the Communications part of DVX, which Setup describes as &#8220;The Terminal: modems, serial and secure links, Telnet (with Networking), and file transfers.&#8221; If Terminal is not in Program Manager&#8217;s <strong>Installed Programs</strong> group, this part was left out when DVX was installed. To add it, run Setup again from DVX&#8217;s CD or Disk 1, choose <strong>Upgrade or repair DVX</strong>, and tick <strong>Communications</strong> on the <strong>What to install</strong> page (see <a href="#installing-parts">Section 3.5</a>).</p>
</div>
<div class="paragraph">
<p><a id="_ix1050" class="ixterm"></a><a id="_ix1051" class="ixterm"></a><a id="_ix1052" class="ixterm"></a>Most of Terminal works without the Networking part. Only two things need it: Telnet, and the secure link over the network. Connecting by serial port or by modem, and the secure link over a serial cable, work without Networking. If you try to connect over the network without it, Terminal says &#8220;Telnet and the secure link over the network need Networking, which is not installed. Setup can add it.&#8221; Networking also needs a network card with its packet driver, set up as <a href="#networking">Chapter 4</a> explains.</p>
</div>
<div class="paragraph">
<p><a id="_ix1053" class="ixterm"></a><a id="_ix1054" class="ixterm"></a>What else you need depends on how you connect:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>By serial port: a free serial port (COM1, COM2, COM3, or COM4) and a cable to the other computer.</p>
</li>
<li>
<p>By modem: a modem on one of those serial ports, and a phone line.</p>
</li>
<li>
<p>By Telnet: the Networking part and a working network connection.</p>
</li>
<li>
<p>By the secure link: a computer at the other end that runs a secure-link proxy (see <a href="#terminal-secure-link">Section 9.7</a>), reached by a serial cable or over the network.</p>
</li>
</ul>
</div>
</div>
<div class="sect2">
<h3 id="terminal-starting"><a class="anchor" href="#terminal-starting"></a>9.2. Starting Terminal</h3>
<div class="paragraph">
<p><a id="_ix1055" class="ixterm"></a>To start Terminal, double-click <strong>Terminal</strong> in Program Manager&#8217;s <strong>Installed Programs</strong> group. The window opens near the upper left corner of the screen. Its title is the name of the session you used last. The first time you start Terminal, the phone book holds one session, <strong>Direct COM1</strong>, which connects straight to COM1 at 9600 bps.</p>
</div>
<div class="paragraph">
<p><a id="_ix1056" class="ixterm"></a>You can run more than one Terminal at a time, for example one for each serial port. They share one phone book: a change you make in one Terminal is kept when another saves its own (see <a href="#terminal-settings-file">Section 9.8.8</a>).</p>
</div>
<div class="paragraph">
<p>You can also start Terminal so that it connects to a Telnet address at once; see <a href="#terminal-telnet-address">Section 9.5.4</a>.</p>
</div>
</div>
<div class="sect2">
<h3 id="terminal-window"><a class="anchor" href="#terminal-window"></a>9.3. The Terminal window</h3>
<div class="paragraph">
<p><a id="_ix1057" class="ixterm"></a>The Terminal window has a menu bar at the top, the terminal screen in the middle, and a status bar at the bottom. Its title is the name of the current session. You cannot change the window&#8217;s size by dragging its border, and it has no maximize button: the window sizes itself to fit the terminal screen, which you set with <strong>Columns</strong> and <strong>Rows</strong> (see <a href="#terminal-screen-page">Section 9.4.4.5</a>).</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/tmWindow.png" alt="The Terminal window" width="titled with the session's name" height="with its menu bar and two of Terminal's notes in square brackets on the screen">
</div>
<div class="title">Figure 46. Terminal connected to a host by Telnet</div>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 25%;">
<col style="width: 75%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Part</th>
<th class="tableblock halign-left valign-top">What it shows</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Menu bar</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The <strong>File</strong>, <strong>Edit</strong>, <strong>Settings</strong>, <strong>Transfer</strong>, and <strong>Help</strong> menus (see <a href="#terminal-menus">Section 9.3.1</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Terminal screen</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1058" class="ixterm"></a>The other computer&#8217;s screen. Click it and type. The scroll bar at its right side scrolls back through lines that have scrolled off the top.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Status bar, left</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1059" class="ixterm"></a>What the connection is doing, for example &#8220;Connected to COM1 at 9600 bps&#8221;. Before you connect, it says &#8220;Not connected: choose File &gt; Phone Book&#8221;.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Status bar, right</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The line settings and the transfer protocol. For a serial port, a modem, or the secure link over a serial cable it shows the port, the speed, and the data bits, parity, and stop bits, for example <code>COM1 9600 8N1 ZMODEM</code> (8 data bits, no parity, 1 stop bit). Over the network it shows the host and port, for example <code>bbs.example.org:23 ZMODEM</code>. While Terminal captures to a file, <code>Capture</code> is added.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix1060" class="ixterm"></a>Each time the connection&#8217;s status changes, Terminal also writes it on the screen in square brackets, for example &#8220;[Connected to COM1 at 9600 bps]&#8221;. The brackets tell Terminal&#8217;s own notes apart from what the other computer sends.</p>
</div>
<div class="sect3">
<h4 id="terminal-menus"><a class="anchor" href="#terminal-menus"></a>9.3.1. Menus</h4>
<div class="paragraph">
<p><a id="_ix1061" class="ixterm"></a><a id="_ix1062" class="ixterm"></a>Some menu items are greyed when they cannot be used: most connection and transfer commands work only while you are connected, and several are not available while a file transfer runs.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<caption class="title">Table 1. File menu</caption>
<colgroup>
<col style="width: 25%;">
<col style="width: 75%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Item</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Phone Book&#8230;&#8203;</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens the phone book, where you choose, add, change, and delete sessions (see <a href="#terminal-phone-book">Section 9.4</a>). Connecting from the phone book first ends the connection you have. Not available while a file transfer runs.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Connect</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Connects with the current session. Available only when you are not connected and no file transfer runs.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Disconnect</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Ends the connection; a modem hangs up. While a modem dials, it stops the dialing. Not available while a file transfer runs.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Capture to File&#8230;&#8203;</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Starts saving everything the other computer sends to a file. Choose it again to stop. A check mark shows while Terminal captures (see <a href="#terminal-capture">Section 9.8.7</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Exit</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Closes Terminal. If you are connected or a file transfer runs, Terminal asks first.</p></td>
</tr>
</tbody>
</table>
<table class="tableblock frame-all grid-all stretch">
<caption class="title">Table 2. Edit menu</caption>
<colgroup>
<col style="width: 25%;">
<col style="width: 75%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Item</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">Edit</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Copy</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Copies the text selected on the screen to the clipboard (see <a href="#desktop-clipboard">Section 5.7</a>). Does nothing when no text is selected.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">Edit</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Paste</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Sends the text on the clipboard to the other computer, as if you typed it. Available only while you are connected and no file transfer runs.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">Edit</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Clear Screen</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Clears the screen. What was on it goes into the scrollback.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">Edit</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Send Break</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1063" class="ixterm"></a>Sends a break signal, which some systems use to interrupt what they are doing. Available only while you are connected by serial port or modem.</p></td>
</tr>
</tbody>
</table>
<table class="tableblock frame-all grid-all stretch">
<caption class="title">Table 3. Settings menu</caption>
<colgroup>
<col style="width: 25%;">
<col style="width: 75%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Item</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">Settings</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Colors</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A submenu with <strong>Standard</strong>, <strong>Green screen</strong>, <strong>Amber screen</strong>, and <strong>Black on white</strong>. A round mark shows the current session&#8217;s colors. Choosing one changes the screen at once and saves it with the session (see <a href="#terminal-colors">Section 9.8.2</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">Settings</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Session Settings&#8230;&#8203;</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens the <strong>Session Settings</strong> dialog box for the current session (see <a href="#terminal-session-settings">Section 9.4.4</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">Settings</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Local Echo</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Turns local echo on and off: with a check mark, Terminal also shows what you type (see <a href="#terminal-local-echo">Section 9.8.3</a>). Saved with the session.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">Settings</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">ANSI Music</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Turns ANSI music on and off: with a check mark, Terminal plays the music the other computer sends (see <a href="#terminal-music">Section 9.8.5</a>). Saved with the session.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">Settings</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Transfer Options&#8230;&#8203;</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens the <strong>Transfer Options</strong> dialog box (see <a href="#terminal-transfer-options">Section 9.6.7</a>).</p></td>
</tr>
</tbody>
</table>
<table class="tableblock frame-all grid-all stretch">
<caption class="title">Table 4. Transfer menu</caption>
<colgroup>
<col style="width: 25%;">
<col style="width: 75%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Item</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">Transfer</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Send Files&#8230;&#8203;</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Sends files with the protocol that has the round mark (see <a href="#terminal-sending">Section 9.6.1</a>). Available only while you are connected and no file transfer runs.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">Transfer</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Receive Files&#8230;&#8203;</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Receives files with the protocol that has the round mark (see <a href="#terminal-receiving">Section 9.6.2</a>). Available only while you are connected and no file transfer runs.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>XMODEM</strong>, <strong>XMODEM-1K</strong>, <strong>YMODEM</strong>, <strong>ZMODEM</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The protocol to use for file transfers. The one you choose gets a round mark. Terminal remembers it for all sessions. At first it is <strong>ZMODEM</strong>.</p></td>
</tr>
</tbody>
</table>
<table class="tableblock frame-all grid-all stretch">
<caption class="title">Table 5. Help menu</caption>
<colgroup>
<col style="width: 25%;">
<col style="width: 75%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Item</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">Help</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Contents</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens Terminal&#8217;s help in DVX Help. <kbd>F1</kbd> does the same (see <a href="#desktop-help">Section 5.11</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">Help</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">About Terminal&#8230;&#8203;</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Shows Terminal&#8217;s name, what it does, and its copyright.</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect3">
<h4 id="terminal-screen"><a class="anchor" href="#terminal-screen"></a>9.3.2. Using the terminal screen</h4>
<div class="paragraph">
<p><a id="_ix1064" class="ixterm"></a>Click the screen and type. While you are connected, the keys you press go to the other computer, including <kbd>Ctrl</kbd> combinations, <kbd>Tab</kbd>, <kbd>Esc</kbd>, <kbd>Backspace</kbd>, and <kbd>Enter</kbd> (while a file transfer runs, <kbd>Esc</kbd> cancels it instead). The arrow keys, <kbd>Home</kbd>, <kbd>End</kbd>, <kbd>PgUp</kbd>, <kbd>PgDn</kbd>, and <kbd>Del</kbd> are sent as the ANSI key codes that bulletin boards understand. When you are not connected, or while a file transfer runs, what you type is ignored.</p>
</div>
<div class="paragraph">
<p><a id="_ix1065" class="ixterm"></a>A few keys never reach the other computer. The function keys and <kbd>Ins</kbd> are not sent, and neither are letters with accents and other characters outside the plain US character set. DVX keeps <kbd>F1</kbd>, <kbd>F10</kbd>, <kbd>Alt</kbd> with a letter, <span class="keyseq"><kbd>Alt</kbd>+<kbd>Tab</kbd></span>, <span class="keyseq"><kbd>Alt</kbd>+<kbd>F4</kbd></span>, <span class="keyseq"><kbd>Alt</kbd>+<kbd>Space</kbd></span>, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Esc</kbd></span>, and <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>F12</kbd></span> for itself, so these work in Terminal as they do everywhere else.</p>
</div>
<div class="paragraph">
<p><a id="_ix1066" class="ixterm"></a><a id="_ix1067" class="ixterm"></a>To copy text from the screen, drag across it with the mouse. Double-clicking selects a word, and triple-clicking selects a line. Then choose <span class="menuseq"><b class="menu">Edit</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Copy</b></span> or press <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>C</kbd></span>. Without a selection, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>C</kbd></span> goes to the other computer as usual. Spaces at the ends of lines are left out, and one copy holds at most about 4 KB of text.</p>
</div>
<div class="paragraph">
<p><a id="_ix1068" class="ixterm"></a>To send text from the clipboard to the other computer, choose <span class="menuseq"><b class="menu">Edit</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Paste</b></span> or press <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>V</kbd></span>. Terminal sends it as if you typed it, with each line end sent as <kbd>Enter</kbd>.</p>
</div>
<div class="paragraph">
<p><a id="_ix1069" class="ixterm"></a>To look back at lines that have scrolled off the top, use the scroll bar, the mouse wheel, or <span class="keyseq"><kbd>Shift</kbd>+<kbd>PgUp</kbd></span> and <span class="keyseq"><kbd>Shift</kbd>+<kbd>PgDn</kbd></span>. Typing or pasting takes you back to the live screen. See <a href="#terminal-scrollback">Section 9.8.6</a>.</p>
</div>
</div>
<div class="sect3">
<h4 id="terminal-keys"><a class="anchor" href="#terminal-keys"></a>9.3.3. Keys in Terminal</h4>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F1</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens Terminal&#8217;s help.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Alt</kbd>+<kbd>F</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens the <strong>File</strong> menu.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Alt</kbd>+<kbd>E</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens the <strong>Edit</strong> menu.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Alt</kbd>+<kbd>S</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens the <strong>Settings</strong> menu.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Alt</kbd>+<kbd>T</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens the <strong>Transfer</strong> menu.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Alt</kbd>+<kbd>H</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens the <strong>Help</strong> menu.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>C</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">With text selected on the screen, copies it. Without a selection, it is sent to the other computer.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>V</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Sends the text on the clipboard to the other computer.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Shift</kbd>+<kbd>PgUp</kbd></span>, <span class="keyseq"><kbd>Shift</kbd>+<kbd>PgDn</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Pages back and forward through the scrollback.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Enter</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">In the <strong>Phone Book</strong>, <strong>Session Settings</strong>, <strong>Secure Link Passphrase</strong>, and <strong>Transfer Options</strong> dialog boxes, presses the default button (<b class="button">Connect</b> or <b class="button">OK</b>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Esc</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">In the same dialog boxes, presses <b class="button">Cancel</b>. While a file transfer runs, in the <strong>File Transfer</strong> window or in the Terminal window, cancels the transfer; after the transfer, in the <strong>File Transfer</strong> window, closes it.</p></td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="sect2">
<h3 id="terminal-phone-book"><a class="anchor" href="#terminal-phone-book"></a>9.4. The Phone Book</h3>
<div class="paragraph">
<p><a id="_ix1070" class="ixterm"></a><a id="_ix1071" class="ixterm"></a><a id="_ix1072" class="ixterm"></a>The phone book is Terminal&#8217;s list of saved sessions. A session holds everything about one place you connect to: its name, how to connect, the modem, secure link, and network settings, and how the screen looks. The phone book holds up to 32 sessions. The first time you start Terminal it holds one, <strong>Direct COM1</strong>.</p>
</div>
<div class="paragraph">
<p>To open the phone book, choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Phone Book&#8230;&#8203;</b></span>. The <strong>Phone Book</strong> dialog box lists every session by name, with the current session selected. Every change you make in it is saved at once.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 25%;">
<col style="width: 75%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Button</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">New&#8230;&#8203;</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Adds a session (see <a href="#terminal-adding-session">Section 9.4.1</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">Edit&#8230;&#8203;</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Changes the selected session (see <a href="#terminal-changing-session">Section 9.4.2</a>). If it is the session in the Terminal window, the window takes the changes too.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">Delete</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Removes the selected session, after asking (see <a href="#terminal-deleting-session">Section 9.4.3</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">Connect</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Makes the selected session the current one and connects with it. If you are connected, Terminal ends that connection first. Double-clicking a session, or pressing <kbd>Enter</kbd>, does the same.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">Cancel</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Closes the phone book without connecting. <kbd>Esc</kbd> does the same.</p></td>
</tr>
</tbody>
</table>
<div class="sect3">
<h4 id="terminal-adding-session"><a class="anchor" href="#terminal-adding-session"></a>9.4.1. Adding a session</h4>
<div class="paragraph">
<p><a id="_ix1073" class="ixterm"></a>To add a session:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Phone Book&#8230;&#8203;</b></span>.</p>
</li>
<li>
<p>Click <b class="button">New&#8230;&#8203;</b>. The <strong>New Session</strong> dialog box opens. The new session is named <strong>New session</strong> and starts with the settings for a direct serial connection on COM1.</p>
</li>
<li>
<p>Type a name in <strong>Name</strong>.</p>
</li>
<li>
<p>Choose how to connect in <strong>Connect with</strong>, and fill in the pages that this way of connecting uses (see <a href="#terminal-session-settings">Section 9.4.4</a>).</p>
</li>
<li>
<p>Click <b class="button">OK</b>. The session is added at the end of the list and selected.</p>
</li>
<li>
<p>To connect now, click <b class="button">Connect</b>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p><a id="_ix1074" class="ixterm"></a>If the phone book already holds 32 sessions, Terminal says &#8220;The phone book is full. Delete an entry first.&#8221;</p>
</div>
</div>
<div class="sect3">
<h4 id="terminal-changing-session"><a class="anchor" href="#terminal-changing-session"></a>9.4.2. Changing a session</h4>
<div class="paragraph">
<p><a id="_ix1075" class="ixterm"></a>To change the session that is open in the Terminal window, choose <span class="menuseq"><b class="menu">Settings</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Session Settings&#8230;&#8203;</b></span>, make your changes, and click <b class="button">OK</b>. Changes to how the screen looks take effect at once. Changes to the connection take effect the next time you connect; if you are connected, a note on the screen says &#8220;[New connection settings take effect the next time you connect]&#8221;.</p>
</div>
<div class="paragraph">
<p>To change another session in the phone book:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Phone Book&#8230;&#8203;</b></span>.</p>
</li>
<li>
<p>Select the session and click <b class="button">Edit&#8230;&#8203;</b>.</p>
</li>
<li>
<p>Make your changes in the <strong>Edit Session</strong> dialog box and click <b class="button">OK</b>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>If you change the session that is open in the Terminal window this way, the window takes the changes too, as with <span class="menuseq"><b class="menu">Settings</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Session Settings&#8230;&#8203;</b></span>, whether you then click <b class="button">Connect</b> or <b class="button">Cancel</b>.</p>
</div>
</div>
<div class="sect3">
<h4 id="terminal-deleting-session"><a class="anchor" href="#terminal-deleting-session"></a>9.4.3. Deleting a session</h4>
<div class="paragraph">
<p><a id="_ix1076" class="ixterm"></a>To delete a session:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Phone Book&#8230;&#8203;</b></span>.</p>
</li>
<li>
<p>Select the session and click <b class="button">Delete</b>.</p>
</li>
<li>
<p>Terminal asks &#8220;Delete "<em>name</em>" from the phone book?&#8221; Click <b class="button">Yes</b>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>The phone book always keeps at least one session: when only one is left, <b class="button">Delete</b> does nothing.</p>
</div>
<div class="paragraph">
<p>You can delete the session that is open in the Terminal window. The window keeps it, connected or not, until you choose another session, but changes you make to it are no longer saved.</p>
</div>
</div>
<div class="sect3">
<h4 id="terminal-session-settings"><a class="anchor" href="#terminal-session-settings"></a>9.4.4. Session settings</h4>
<div class="paragraph">
<p><a id="_ix1077" class="ixterm"></a><a id="_ix1078" class="ixterm"></a>One dialog box holds all of a session&#8217;s settings. It is titled <strong>Session Settings</strong> when you open it from the <strong>Settings</strong> menu, and <strong>New Session</strong> or <strong>Edit Session</strong> when you open it from the phone book. Its settings are on five pages: <strong>Connection</strong>, <strong>Modem</strong>, <strong>Secure Link</strong>, <strong>Network</strong>, and <strong>Screen</strong>. Click a page&#8217;s tab to see it. Click <b class="button">OK</b> to keep your changes, or <b class="button">Cancel</b> to leave the session as it was. When you click <b class="button">OK</b>, a value outside its allowed range is brought into range, and an empty <strong>Name</strong> becomes <strong>Direct COM1</strong>.</p>
</div>
<div class="paragraph">
<p>Every page can be filled in whatever way you connect, but Terminal uses only the settings for the way you chose in <strong>Connect with</strong>:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 25%;">
<col style="width: 75%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Connect with</th>
<th class="tableblock halign-left valign-top">Settings Terminal uses</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Serial port</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The <strong>Connection</strong> page.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Modem</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The <strong>Connection</strong> page and the <strong>Modem</strong> page.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Secure link</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Over a serial cable: the <strong>Connection</strong> page and the <strong>Secure Link</strong> page. Over the network: the <strong>Secure Link</strong> page and the <strong>Network</strong> page.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Telnet</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The <strong>Network</strong> page.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>Every session also uses its <strong>Name</strong> and the <strong>Screen</strong> page.</p>
</div>
<div class="sect4">
<h5 id="terminal-connection-page"><a class="anchor" href="#terminal-connection-page"></a>The Connection page</h5>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Name</strong></dt>
<dd>
<p><a id="_ix1079" class="ixterm"></a>The session&#8217;s name, up to 31 characters. It is shown in the phone book and in the Terminal window&#8217;s title.</p>
</dd>
<dt class="hdlist1"><strong>Connect with</strong></dt>
<dd>
<p>How to connect: <strong>Serial port</strong> (a cable to the other computer), <strong>Modem</strong> (dials a phone number), <strong>Secure link</strong> (the encrypted link to a secure-link proxy; see <a href="#terminal-secure-link">Section 9.7</a>), or <strong>Telnet</strong> (over the network; it needs Networking). A new session starts with <strong>Serial port</strong>.</p>
</dd>
<dt class="hdlist1"><strong>Port</strong></dt>
<dd>
<p><a id="_ix1080" class="ixterm"></a>The serial port: <strong>COM1</strong>, <strong>COM2</strong>, <strong>COM3</strong>, or <strong>COM4</strong>. Used for a serial port, a modem, and the secure link over a serial cable. At first <strong>COM1</strong>.</p>
</dd>
<dt class="hdlist1"><strong>Speed (bps)</strong></dt>
<dd>
<p><a id="_ix1081" class="ixterm"></a>The speed in bits per second: 300, 1200, 2400, 4800, 9600, 19200, 38400, 57600, or 115200. Both sides must use the same speed. At first 9600.</p>
</dd>
<dt class="hdlist1"><strong>Data bits</strong></dt>
<dd>
<p>5, 6, 7, or 8. Almost always 8, which is the default.</p>
</dd>
<dt class="hdlist1"><strong>Parity</strong></dt>
<dd>
<p><strong>None</strong>, <strong>Even</strong>, <strong>Odd</strong>, <strong>Mark</strong>, or <strong>Space</strong>. Almost always <strong>None</strong>, which is the default.</p>
</dd>
<dt class="hdlist1"><strong>Stop bits</strong></dt>
<dd>
<p>1 or 2. Almost always 1, which is the default.</p>
</dd>
<dt class="hdlist1"><strong>Flow control</strong></dt>
<dd>
<p><a id="_ix1082" class="ixterm"></a><a id="_ix1083" class="ixterm"></a>How each side tells the other to pause: <strong>None</strong> (the default), <strong>XON/XOFF</strong>, or <strong>RTS/CTS</strong>. RTS/CTS is best when the cable and the other side support it, especially at high speeds and for file transfers. A secure link over a COM port cannot use XON/XOFF (see <a href="#terminal-secure-session">Section 9.7.2</a>).</p>
</dd>
</dl>
</div>
</div>
<div class="sect4">
<h5 id="terminal-modem-page"><a class="anchor" href="#terminal-modem-page"></a>The Modem page</h5>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Setup command</strong></dt>
<dd>
<p><a id="_ix1084" class="ixterm"></a>Sent to the modem before dialing, up to 63 characters. At first <code>ATZ</code>. Leave it empty to send nothing and dial at once.</p>
</dd>
<dt class="hdlist1"><strong>Dial command</strong></dt>
<dd>
<p><a id="_ix1085" class="ixterm"></a>Put in front of the phone number, up to 15 characters: usually <code>ATDT</code> for tone dialing (the default) or <code>ATDP</code> for pulse dialing.</p>
</dd>
<dt class="hdlist1"><strong>Phone number</strong></dt>
<dd>
<p>The number to dial, up to 47 characters. Leave it empty to type modem commands yourself (see <a href="#terminal-modem">Section 9.5.2</a>).</p>
</dd>
<dt class="hdlist1"><strong>Redial tries</strong></dt>
<dd>
<p><a id="_ix1086" class="ixterm"></a>How many more times to dial when the line is busy, nobody answers, or there is no carrier: 0 to 99. At first 3.</p>
</dd>
<dt class="hdlist1"><strong>Redial wait (s)</strong></dt>
<dd>
<p>How many seconds to wait before dialing again: 1 to 300. At first 30.</p>
</dd>
</dl>
</div>
</div>
<div class="sect4">
<h5 id="terminal-secure-link-page"><a class="anchor" href="#terminal-secure-link-page"></a>The Secure Link page</h5>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Passphrase</strong></dt>
<dd>
<p><a id="_ix1087" class="ixterm"></a>The secret you share with the secure-link proxy at the other end, up to 63 characters. It shows as mask characters while you type. Use the same passphrase as the other end, or leave it empty when the other end uses none. Terminal saves it scrambled (see <a href="#terminal-passphrases">Section 9.7.1</a>).</p>
</dd>
<dt class="hdlist1"><strong>Ask for the passphrase when connecting (never save it)</strong></dt>
<dd>
<p>Terminal asks for the passphrase each time you connect and never saves it. When the dialog box opens with this ticked, the <strong>Passphrase</strong> box is empty, and clicking <b class="button">OK</b> with it ticked removes any passphrase saved with the session.</p>
</dd>
<dt class="hdlist1"><strong>Connect over the network (the host and port on the Network page)</strong></dt>
<dd>
<p>The secure link goes over the network, to the host and port on the <strong>Network</strong> page, instead of through the serial port. This needs the Networking part.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>The page reminds you: &#8220;Use the same passphrase as the host, or none on both sides.&#8221;</p>
</div>
</div>
<div class="sect4">
<h5 id="terminal-network-page"><a class="anchor" href="#terminal-network-page"></a>The Network page</h5>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Host name</strong></dt>
<dd>
<p><a id="_ix1088" class="ixterm"></a>The computer to connect to over the network, up to 63 characters: a name such as <code>bbs.example.org</code>, or an address such as <code>192.168.1.20</code>.</p>
</dd>
<dt class="hdlist1"><strong>Port</strong></dt>
<dd>
<p><a id="_ix1089" class="ixterm"></a>Its port number, 1 to 65535. Usually 23 for Telnet, which is the default. A secure-link proxy usually listens on 2323.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>Telnet uses these settings, and so does the secure link when <strong>Connect over the network (the host and port on the Network page)</strong> is ticked on the <strong>Secure Link</strong> page.</p>
</div>
</div>
<div class="sect4">
<h5 id="terminal-screen-page"><a class="anchor" href="#terminal-screen-page"></a>The Screen page</h5>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Columns</strong></dt>
<dd>
<p><a id="_ix1090" class="ixterm"></a>The width of the terminal screen: 40 to 132 columns. At first 80.</p>
</dd>
<dt class="hdlist1"><strong>Rows</strong></dt>
<dd>
<p>The height of the terminal screen: 10 to 60 rows. At first 25. A screen of 80 columns by 25 rows suits most bulletin boards. When you change <strong>Columns</strong> or <strong>Rows</strong>, the screen is rebuilt at once: the screen and the scrollback start empty, and the window changes size to fit.</p>
</dd>
<dt class="hdlist1"><strong>Scrollback lines</strong></dt>
<dd>
<p>How many lines that have scrolled off the top you can scroll back to: 100 to 10,000. At first 1,000 (see <a href="#terminal-scrollback">Section 9.8.6</a>).</p>
</dd>
<dt class="hdlist1"><strong>Colors</strong></dt>
<dd>
<p><strong>Standard</strong>, <strong>Green screen</strong>, <strong>Amber screen</strong>, or <strong>Black on white</strong>, the same as <span class="menuseq"><b class="menu">Settings</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Colors</b></span> (see <a href="#terminal-colors">Section 9.8.2</a>).</p>
</dd>
<dt class="hdlist1"><strong>Answerback</strong></dt>
<dd>
<p>The text Terminal sends when the other computer asks who you are, up to 31 characters. Leave it empty to send nothing (see <a href="#terminal-answerback">Section 9.8.4</a>).</p>
</dd>
<dt class="hdlist1"><strong>Local echo (show what you type)</strong></dt>
<dd>
<p>The same as <span class="menuseq"><b class="menu">Settings</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Local Echo</b></span>. Off at first (see <a href="#terminal-local-echo">Section 9.8.3</a>).</p>
</dd>
<dt class="hdlist1"><strong>Play ANSI music the other side sends</strong></dt>
<dd>
<p>The same as <span class="menuseq"><b class="menu">Settings</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">ANSI Music</b></span>. On at first (see <a href="#terminal-music">Section 9.8.5</a>).</p>
</dd>
</dl>
</div>
</div>
</div>
</div>
<div class="sect2">
<h3 id="terminal-connecting"><a class="anchor" href="#terminal-connecting"></a>9.5. Connecting and disconnecting</h3>
<div class="paragraph">
<p><a id="_ix1091" class="ixterm"></a>To connect, choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Phone Book&#8230;&#8203;</b></span>, select a session, and click <b class="button">Connect</b>. To connect again with the session that is already in the window, choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Connect</b></span>. The status bar, and the notes in square brackets on the screen, show what is happening. Connecting never holds up DVX: while a modem dials or a secure link is set up, you can use the menus and other programs. <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Connect</b></span> stays greyed until the connection ends.</p>
</div>
<div class="sect3">
<h4 id="terminal-serial"><a class="anchor" href="#terminal-serial"></a>9.5.1. Connecting by serial port</h4>
<div class="paragraph">
<p><a id="_ix1092" class="ixterm"></a><a id="_ix1093" class="ixterm"></a>Use a serial connection for a cable straight to another computer. To set one up:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Phone Book&#8230;&#8203;</b></span> and click <b class="button">New&#8230;&#8203;</b>.</p>
</li>
<li>
<p>Type a <strong>Name</strong>, and choose <strong>Serial port</strong> in <strong>Connect with</strong>.</p>
</li>
<li>
<p>In <strong>Port</strong>, choose the serial port the cable is plugged into.</p>
</li>
<li>
<p>Set <strong>Speed (bps)</strong>, <strong>Data bits</strong>, <strong>Parity</strong>, and <strong>Stop bits</strong> to the same values as the other computer.</p>
</li>
<li>
<p>If the cable and the other computer support it, choose <strong>RTS/CTS</strong> in <strong>Flow control</strong>.</p>
</li>
<li>
<p>Click <b class="button">OK</b>, then <b class="button">Connect</b>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p><a id="_ix1094" class="ixterm"></a>The port opens at once, and the status bar says, for example, &#8220;Connected to COM1 at 9600 bps&#8221;. From then on, what you type goes to the other computer, and what it sends appears on the screen. If the screen fills with random characters, the speed, data bits, parity, or stop bits do not match the other side.</p>
</div>
<div class="paragraph">
<p>If the port cannot be opened, or stops working, Terminal says why:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Message</th>
<th class="tableblock halign-left valign-top">What it means</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1095" class="ixterm"></a>&#8220;COM<em>n</em> could not be opened: there is no serial port there&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The computer has no serial port at that address. Choose another <strong>Port</strong> in the session&#8217;s settings.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1096" class="ixterm"></a>&#8220;COM<em>n</em> could not be opened: it is already in use&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Another program, or another Terminal window, is using that port. Close it first.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1097" class="ixterm"></a>&#8220;COM<em>n</em> could not be opened: its interrupt could not be found&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX could not find the interrupt (IRQ) the port uses.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1098" class="ixterm"></a>&#8220;COM<em>n</em> could not be opened: a setting is not supported&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The port cannot use one of the session&#8217;s line settings.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1099" class="ixterm"></a>&#8220;COM<em>n</em> could not be opened: it did not respond&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The port did not respond.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1100" class="ixterm"></a>&#8220;COM<em>n</em> stopped working&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The port failed while you were connected.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>See also <a href="#trouble-serial">Section 11.10</a>.</p>
</div>
</div>
<div class="sect3">
<h4 id="terminal-modem"><a class="anchor" href="#terminal-modem"></a>9.5.2. Dialing with a modem</h4>
<div class="paragraph">
<p><a id="_ix1101" class="ixterm"></a><a id="_ix1102" class="ixterm"></a>To call a bulletin board or another computer with a modem:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Phone Book&#8230;&#8203;</b></span> and click <b class="button">New&#8230;&#8203;</b>.</p>
</li>
<li>
<p>Type a <strong>Name</strong>, and choose <strong>Modem</strong> in <strong>Connect with</strong>.</p>
</li>
<li>
<p>In <strong>Port</strong>, choose the serial port the modem is on, and choose a <strong>Speed (bps)</strong>.</p>
</li>
<li>
<p>On the <strong>Modem</strong> page, type the <strong>Phone number</strong>. If your modem needs it, change <strong>Setup command</strong>, <strong>Dial command</strong>, <strong>Redial tries</strong>, or <strong>Redial wait (s)</strong>.</p>
</li>
<li>
<p>Click <b class="button">OK</b>, then <b class="button">Connect</b>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>Watch the status bar while Terminal calls:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Terminal sends the setup command to the modem (&#8220;Setting up the modem on COM1&#8221;) and waits up to 5 seconds for the modem to answer OK.</p>
</li>
<li>
<p>It dials, for example &#8220;Dialing 555-0100 (try 1 of 4)&#8221;. The last number is the number of redial tries plus one. Terminal waits up to a minute for the call to go through.</p>
</li>
<li>
<p>If the line is busy, nobody answers, or there is no carrier, Terminal waits the redial time and dials again. The status bar says, for example, &#8220;The line is busy: dialing again in 30 seconds&#8221; (or &#8220;No answer: &#8230;&#8203;&#8221; or &#8220;No carrier: &#8230;&#8203;&#8221;). After the last try, the connection ends with that reason.</p>
</li>
<li>
<p><a id="_ix1103" class="ixterm"></a>When the call goes through, the status bar shows the modem&#8217;s own message, for example &#8220;Connected (CONNECT 14400)&#8221;.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p><a id="_ix1104" class="ixterm"></a><a id="_ix1105" class="ixterm"></a>Everything the modem says (OK, CONNECT, BUSY, and so on) also appears on the screen. To stop dialing, or to hang up, choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Disconnect</b></span>; the status bar then says &#8220;Hung up&#8221;. If the other end hangs up, Terminal says &#8220;Carrier lost: the call ended&#8221;.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Message</th>
<th class="tableblock halign-left valign-top">What to do</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1106" class="ixterm"></a>&#8220;The modem on COM<em>n</em> did not answer&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The modem did not answer the setup command within 5 seconds. Check that the modem is on and connected to the chosen port, and that the setup command is right.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1107" class="ixterm"></a>&#8220;The modem refused the setup command <em>command</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The modem answered ERROR to the setup command. Check <strong>Setup command</strong> on the <strong>Modem</strong> page.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1108" class="ixterm"></a>&#8220;No dial tone: check the phone line&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Terminal stops at once. Check that the phone line is plugged into the modem.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1109" class="ixterm"></a>&#8220;The modem refused the dial command&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The modem answered ERROR when Terminal dialed. Check <strong>Dial command</strong> and <strong>Phone number</strong> on the <strong>Modem</strong> page.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix1110" class="ixterm"></a>To type commands to the modem yourself, leave <strong>Phone number</strong> empty. When you connect, Terminal opens the port, sends the setup command, and says &#8220;Modem ready on COM1: type AT commands&#8221;. Then type a command such as <code>ATDT5550100</code> and press <kbd>Enter</kbd>.</p>
</div>
</div>
<div class="sect3">
<h4 id="terminal-telnet"><a class="anchor" href="#terminal-telnet"></a>9.5.3. Connecting by Telnet</h4>
<div class="paragraph">
<p><a id="_ix1111" class="ixterm"></a><a id="_ix1112" class="ixterm"></a>Telnet connects to a bulletin board or another computer over the network. It needs the Networking part and a working network connection (see <a href="#net-setup">Section 4.4</a>). To set up a Telnet session:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Phone Book&#8230;&#8203;</b></span> and click <b class="button">New&#8230;&#8203;</b>.</p>
</li>
<li>
<p>Type a <strong>Name</strong>, and choose <strong>Telnet</strong> in <strong>Connect with</strong>.</p>
</li>
<li>
<p>On the <strong>Network</strong> page, type the <strong>Host name</strong> and set <strong>Port</strong> (usually 23).</p>
</li>
<li>
<p>Click <b class="button">OK</b>, then <b class="button">Connect</b>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p><a id="_ix1113" class="ixterm"></a>The status bar says &#8220;Connecting to <em>host</em> port <em>n</em>&#8221; and then &#8220;Connected to <em>host</em> port <em>n</em>&#8221;. Terminal gives up if the other computer does not answer within 30 seconds. Terminal tells the other computer that it is an ANSI terminal and how many columns and rows the screen has, and tells it again whenever you change the size. If every letter you type appears twice, turn off <span class="menuseq"><b class="menu">Settings</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Local Echo</b></span>.</p>
</div>
<div class="paragraph">
<p><a id="_ix1114" class="ixterm"></a>When the other computer ends the session, Terminal says so, for example &#8220;[bbs.example.org closed the connection]&#8221;.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Message</th>
<th class="tableblock halign-left valign-top">What to do</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1115" class="ixterm"></a>&#8220;Enter the host name on the Network page of Session Settings first.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The session has no host name. Type one on the <strong>Network</strong> page.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1116" class="ixterm"></a>&#8220;The host <em>host</em> was not found&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the host name, and that a name server is set up on the Network page of Control Panel (see <a href="#cpanel-network">Section 7.9</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1117" class="ixterm"></a>&#8220;<em>host</em> refused the connection on port <em>n</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The computer is there, but nothing answers on that port. Check the port number.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1118" class="ixterm"></a>&#8220;<em>host</em> did not answer&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the address, and that the network is working (Control Panel&#8217;s Network page, <b class="button">Status&#8230;&#8203;</b>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1119" class="ixterm"></a>&#8220;<em>host</em> cannot be reached: check the network settings&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX has no network address yet, or no gateway to that network. See the Network page of Control Panel.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1120" class="ixterm"></a>&#8220;The connection to <em>host</em> failed&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The connection could not be made.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1121" class="ixterm"></a>&#8220;The connection to <em>host</em> was lost&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The connection broke while you were connected.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>See also <a href="#trouble-network">Section 11.9</a>.</p>
</div>
</div>
<div class="sect3">
<h4 id="terminal-telnet-address"><a class="anchor" href="#terminal-telnet-address"></a>9.5.4. Starting Terminal with a Telnet address</h4>
<div class="paragraph">
<p><a id="_ix1122" class="ixterm"></a><a id="_ix1123" class="ixterm"></a>You can start Terminal with a Telnet address, such as <code>telnet://bbs.example.org</code>, or <code>telnet://bbs.example.org:2323</code> for a port other than 23. Terminal then makes that host&#8217;s session the current one, adding a Telnet session named after the host if the phone book has none, and connects at once. A session matches when it is a Telnet session with the same host name and port.</p>
</div>
<div class="paragraph">
<p>To start Terminal this way, give the address as an argument: type Terminal&#8217;s program file followed by the address in Program Manager&#8217;s <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Run&#8230;&#8203;</b></span> box, for example <code>C:\DVX\APPS\KPUNCH\TERMINAL\TERMINAL.APP telnet://bbs.example.org</code>, or put the address in the <strong>Arguments</strong> box of a Program Manager item that starts Terminal (see <a href="#progman-run">Section 6.7</a> and <a href="#progman-items">Section 6.4</a>). If the phone book is full and has no session for that address, Terminal starts without connecting.</p>
</div>
</div>
<div class="sect3">
<h4 id="terminal-disconnecting"><a class="anchor" href="#terminal-disconnecting"></a>9.5.5. Disconnecting and closing Terminal</h4>
<div class="paragraph">
<p><a id="_ix1124" class="ixterm"></a>To end a connection, choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Disconnect</b></span>. The status bar says &#8220;Disconnected&#8221;, or &#8220;Hung up&#8221; for a modem. <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Disconnect</b></span> also stops a modem that is dialing and a secure link that is being set up. It is not available while a file transfer runs: cancel the transfer first (see <a href="#terminal-cancel">Section 9.6.5</a>). If the connection breaks during a transfer, the transfer is cancelled.</p>
</div>
<div class="paragraph">
<p><a id="_ix1125" class="ixterm"></a>To close Terminal, choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Exit</b></span> or close its window. If you are connected (or still connecting), Terminal says &#8220;You are connected.&#8221; and asks &#8220;Disconnect and close?&#8221; If a file transfer runs, it says &#8220;A file transfer is running.&#8221; and asks &#8220;Cancel it and close?&#8221; Click <b class="button">Yes</b> to close, or <b class="button">No</b> to keep Terminal open.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="terminal-transfers"><a class="anchor" href="#terminal-transfers"></a>9.6. Sending and receiving files</h3>
<div class="paragraph">
<p><a id="_ix1126" class="ixterm"></a><a id="_ix1127" class="ixterm"></a><a id="_ix1128" class="ixterm"></a><a id="_ix1129" class="ixterm"></a>Terminal sends files to the other computer (uploading) and receives files from it (downloading). Both sides must use the same file transfer protocol, the set of rules the two computers follow while a file moves. Terminal knows four:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 80%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Protocol</th>
<th class="tableblock halign-left valign-top">Notes</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1130" class="ixterm"></a><strong>XMODEM</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">One file at a time, in 128-byte blocks. Works almost everywhere. You choose the name for a received file, and the file is padded to a whole block, so it can come out slightly longer than the original.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1131" class="ixterm"></a><strong>XMODEM-1K</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">XMODEM with 1024-byte blocks, so it is faster. When a block fails three times, Terminal sends it again as 128-byte blocks.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1132" class="ixterm"></a><strong>YMODEM</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Several files at once, with their names and exact sizes. Received files go into the download folder.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1133" class="ixterm"></a><strong>ZMODEM</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The best choice when the other side has it: fast, several files at once, recovers quickly from line noise, can continue an interrupted download, and can start a download by itself.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix1134" class="ixterm"></a>To choose the protocol, choose it on the <strong>Transfer</strong> menu; it gets a round mark, and the right side of the status bar shows it. Terminal remembers your choice for all sessions. At first it is <strong>ZMODEM</strong>.</p>
</div>
<div class="sect3">
<h4 id="terminal-sending"><a class="anchor" href="#terminal-sending"></a>9.6.1. Sending files</h4>
<div class="paragraph">
<p><a id="_ix1135" class="ixterm"></a>To send (upload) files:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Choose the protocol on the <strong>Transfer</strong> menu.</p>
</li>
<li>
<p>Start the receive on the other computer first. On a bulletin board this is usually a menu choice.</p>
</li>
<li>
<p>Choose <span class="menuseq"><b class="menu">Transfer</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Send Files&#8230;&#8203;</b></span>.</p>
</li>
<li>
<p>In the <strong>Send File</strong> dialog box, choose the file and click <b class="button">Open</b> (see <a href="#desktop-file-dialogs">Section 5.6</a>).</p>
</li>
<li>
<p>With YMODEM or ZMODEM, Terminal asks &#8220;Add another file to send in the same batch?&#8221; Click <b class="button">Yes</b> to choose another file in the <strong>Add Another File</strong> dialog box, or <b class="button">No</b> to start sending. One batch holds up to 16 files.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>The <strong>File Transfer</strong> window shows how the transfer is going (see <a href="#terminal-transfer-window">Section 9.6.4</a>). Terminal waits up to a minute for the other computer to start receiving. If it does not, the transfer ends with &#8220;The receiver did not start&#8221;. The other computer gets your file&#8217;s long name where the protocol has room for it.</p>
</div>
</div>
<div class="sect3">
<h4 id="terminal-receiving"><a class="anchor" href="#terminal-receiving"></a>9.6.2. Receiving files</h4>
<div class="paragraph">
<p><a id="_ix1136" class="ixterm"></a>To receive (download) files:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Choose the protocol on the <strong>Transfer</strong> menu.</p>
</li>
<li>
<p>Start the send on the other computer.</p>
</li>
<li>
<p>Choose <span class="menuseq"><b class="menu">Transfer</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Receive Files&#8230;&#8203;</b></span>.</p>
</li>
<li>
<p>With XMODEM or XMODEM-1K, the <strong>Receive File As</strong> dialog box asks for a name. It starts in the download folder. Type a name and click <b class="button">Save</b>. YMODEM and ZMODEM need no name: they save the files under the names the sender gives, in the download folder.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>If the other computer does not start sending within about a minute, the transfer ends with &#8220;The sender did not start&#8221;.</p>
</div>
<div class="paragraph">
<p><a id="_ix1137" class="ixterm"></a><a id="_ix1138" class="ixterm"></a>The download folder is the DOWNLOAD folder in your user folder, for example <code>C:\DVX\USER\DOWNLOAD</code>, unless you choose another one in Transfer Options (see <a href="#terminal-transfer-options">Section 9.6.7</a> and <a href="#folders-layout">Section B.1</a>). Terminal makes the folder when it needs it. If it cannot, the screen shows &#8220;[The download folder <em>folder</em> could not be created.]&#8221;</p>
</div>
<div class="paragraph">
<p><a id="_ix1139" class="ixterm"></a>ZMODEM downloads usually start by themselves. While <strong>Start ZMODEM downloads automatically</strong> is ticked in Transfer Options, as it is at first, Terminal starts receiving into the download folder as soon as the other computer starts a ZMODEM send. You do not need to choose anything, whichever protocol has the round mark.</p>
</div>
</div>
<div class="sect3">
<h4 id="terminal-file-names"><a class="anchor" href="#terminal-file-names"></a>9.6.3. Names of received files</h4>
<div class="paragraph">
<p><a id="_ix1140" class="ixterm"></a><a id="_ix1141" class="ixterm"></a>With YMODEM and ZMODEM the sender gives each file&#8217;s name, and Terminal makes it safe for your disk:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>Folder names in the sender&#8217;s name are dropped.</p>
</li>
<li>
<p>When the download folder&#8217;s disk takes long file names, files keep the names the sender gives. A character that a file name cannot hold becomes <code>_</code>.</p>
</li>
<li>
<p>Otherwise names are changed to fit DOS: they are shortened to eight characters and a three-letter extension, made upper case, and spaces are dropped. Other characters a DOS name cannot hold become <code>_</code>.</p>
</li>
<li>
<p>A file that arrives with no name is saved as <code>RECEIVED</code>. A name that DOS keeps for a device, such as <code>CON</code>, gets a <code>_</code> in front.</p>
</li>
</ul>
</div>
</div>
<div class="sect3">
<h4 id="terminal-transfer-window"><a class="anchor" href="#terminal-transfer-window"></a>9.6.4. The File Transfer window</h4>
<div class="paragraph">
<p><a id="_ix1142" class="ixterm"></a><a id="_ix1143" class="ixterm"></a>When a transfer starts, the <strong>File Transfer</strong> window opens in the middle of the screen. From top to bottom it shows:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>Which way the files go and how, for example &#8220;Sending with ZMODEM&#8221; or &#8220;Receiving with YMODEM&#8221;.</p>
</li>
<li>
<p>Which file is moving, for example &#8220;File 2 of 3: <em>name</em>&#8221;, or &#8220;File 1: (waiting for the other side)&#8221; before the first file starts.</p>
</li>
<li>
<p>A bar for the current file, with &#8220;<em>x</em> of <em>y</em> bytes&#8221; (or &#8220;<em>x</em> bytes&#8221; when the size is not known). When Terminal continues an interrupted download, &#8220;(continued from <em>z</em>)&#8221; is added after it.</p>
</li>
<li>
<p>A bar for the whole batch, with &#8220;All files: <em>x</em> of <em>y</em> bytes&#8221;.</p>
</li>
<li>
<p>While the transfer runs, &#8220;Retries: <em>n</em>&#8221;: how many times a damaged block had to be sent again. When the transfer ends, the result instead, for example &#8220;Transfer complete&#8221;.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>The Terminal window stays usable while a transfer runs, but what you type is not sent. While a transfer runs, these menu items are not available: <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Phone Book&#8230;&#8203;</b></span>, <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Connect</b></span>, <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Disconnect</b></span>, <span class="menuseq"><b class="menu">Edit</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Paste</b></span>, <span class="menuseq"><b class="menu">Edit</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Send Break</b></span>, <span class="menuseq"><b class="menu">Transfer</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Send Files&#8230;&#8203;</b></span>, and <span class="menuseq"><b class="menu">Transfer</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Receive Files&#8230;&#8203;</b></span>.</p>
</div>
<div class="paragraph">
<p>When the transfer ends, the window shows the result and its <b class="button">Cancel</b> button becomes <b class="button">Close</b>. Click <b class="button">Close</b>, or press <kbd>Esc</kbd>, to put the window away. The result also appears on the terminal screen, for example &#8220;[Download: Transfer complete]&#8221; or &#8220;[Upload: Cancelled]&#8221;.</p>
</div>
</div>
<div class="sect3">
<h4 id="terminal-cancel"><a class="anchor" href="#terminal-cancel"></a>9.6.5. Cancelling a transfer</h4>
<div class="paragraph">
<p><a id="_ix1144" class="ixterm"></a>To stop a transfer, click <b class="button">Cancel</b> in the <strong>File Transfer</strong> window, click the window&#8217;s close box, or press <kbd>Esc</kbd> in the <strong>File Transfer</strong> window or in the Terminal window. Terminal stops the transfer, tells the other side, and shows &#8220;Cancelled&#8221;.</p>
</div>
<div class="paragraph">
<p>A cancelled or failed ZMODEM download keeps the part that arrived, so you can continue it later (see <a href="#terminal-file-exists">Section 9.6.6</a>). XMODEM and YMODEM remove a file that did not arrive completely.</p>
</div>
</div>
<div class="sect3">
<h4 id="terminal-file-exists"><a class="anchor" href="#terminal-file-exists"></a>9.6.6. When a file already exists</h4>
<div class="paragraph">
<p><a id="_ix1145" class="ixterm"></a>When a YMODEM or ZMODEM download would replace a file that is already in the download folder, Terminal does what <strong>If a file exists</strong> in Transfer Options says. With <strong>Ask me</strong>, as it is at first, the <strong>File Transfer</strong> window asks &#8220;<em>name</em> already exists (<em>n</em> bytes). What should happen to it?&#8221; and shows four buttons:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 25%;">
<col style="width: 75%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Button</th>
<th class="tableblock halign-left valign-top">What happens</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">Continue it</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1146" class="ixterm"></a>Continues an interrupted download: only the missing part is sent. This works only with ZMODEM, and only when your copy is shorter than the sender&#8217;s file; otherwise the button is greyed.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">Keep both</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The new file is saved under a new name, with <code>~1</code> (up to <code>~99</code>) added to the name, for example <code>README~1.TXT</code>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">Replace</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The old file is replaced.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">Skip</b></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file is not saved. ZMODEM skips it; YMODEM receives it and throws it away.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>To continue an interrupted ZMODEM download, start the same download again on the other computer, and click <b class="button">Continue it</b> when Terminal asks. If <strong>If a file exists</strong> is set to <strong>Continue a partial download</strong>, Terminal continues it without asking.</p>
</div>
<div class="paragraph">
<p>With XMODEM and XMODEM-1K you choose the file name yourself, and <strong>If a file exists</strong> does not apply. If the file you choose already exists, the <strong>Receive File As</strong> dialog box asks &#8220;<em>name</em> already exists. Do you want to replace it?&#8221; Click <b class="button">Yes</b> to replace it, or <b class="button">No</b> to choose another name.</p>
</div>
</div>
<div class="sect3">
<h4 id="terminal-transfer-options"><a class="anchor" href="#terminal-transfer-options"></a>9.6.7. Transfer options</h4>
<div class="paragraph">
<p><a id="_ix1147" class="ixterm"></a><a id="_ix1148" class="ixterm"></a>Choose <span class="menuseq"><b class="menu">Settings</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Transfer Options&#8230;&#8203;</b></span> to open the <strong>Transfer Options</strong> dialog box. Its settings apply to all sessions. Click <b class="button">OK</b> to keep your changes, or <b class="button">Cancel</b> to leave them as they were.</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Download folder</strong></dt>
<dd>
<p>Where YMODEM and ZMODEM downloads go, and where the <strong>Receive File As</strong> box starts for XMODEM. Type the folder, or click <b class="button">Browse&#8230;&#8203;</b> to choose it in the <strong>Download Folder</strong> dialog box. Terminal makes the folder when it needs it. Leave the box empty to use the DOWNLOAD folder in your user folder.</p>
</dd>
<dt class="hdlist1"><strong>If a file exists</strong></dt>
<dd>
<p>What a YMODEM or ZMODEM download does when a file of the same name is already there: <strong>Ask me</strong> (the default), <strong>Keep both (rename the new)</strong>, <strong>Continue a partial download</strong>, <strong>Replace the old file</strong>, or <strong>Skip the file</strong> (see <a href="#terminal-file-exists">Section 9.6.6</a>). With <strong>Continue a partial download</strong>, a file that cannot be continued is kept as with <strong>Keep both (rename the new)</strong>.</p>
</dd>
<dt class="hdlist1"><strong>Start ZMODEM downloads automatically</strong></dt>
<dd>
<p>Terminal starts receiving as soon as the other side starts a ZMODEM send. On at first.</p>
</dd>
<dt class="hdlist1"><strong>Ask the other side to continue interrupted uploads (ZMODEM)</strong></dt>
<dd>
<p>When you send a file again after an upload was interrupted, the other side continues its partial copy instead of starting again. Off at first. Leave it off unless you are sending the same file again.</p>
</dd>
<dt class="hdlist1"><strong>Escape all control characters (for links that lose them)</strong></dt>
<dd>
<p>For ZMODEM over connections that lose or change control characters. Transfers are slower, so turn it on only when transfers keep failing. Off at first.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p><a id="_ix1149" class="ixterm"></a>On a serial port or modem without flow control, ZMODEM downloads ask the sender to pause every 2 KB so that nothing is lost. Use RTS/CTS flow control for full speed.</p>
</div>
</div>
<div class="sect3">
<h4 id="terminal-transfer-messages"><a class="anchor" href="#terminal-transfer-messages"></a>9.6.8. Transfer results and messages</h4>
<div class="paragraph">
<p><a id="_ix1150" class="ixterm"></a>The <strong>File Transfer</strong> window, and the note on the screen, end with one of these results:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Result</th>
<th class="tableblock halign-left valign-top">What it means</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1151" class="ixterm"></a>&#8220;Transfer complete&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Every file arrived.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Transfer complete (the end was not confirmed)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Every block arrived, but the other side did not confirm the end of the transfer.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1152" class="ixterm"></a>&#8220;Cancelled&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">You cancelled the transfer, or the connection ended while it ran.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cancelled by the sender&#8221;, &#8220;Cancelled by the receiver&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The other side cancelled the transfer.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The receiver ended the transfer&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The other side ended a ZMODEM upload.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1153" class="ixterm"></a>&#8220;The receiver did not start&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The other computer did not start receiving within a minute. Start the receive on the other computer before, or right after, you choose <span class="menuseq"><b class="menu">Transfer</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Send Files&#8230;&#8203;</b></span>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1154" class="ixterm"></a>&#8220;The sender did not start&#8221;, &#8220;The sender stopped&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The other computer did not start sending within about a minute, or (with ZMODEM) did not send the next file of a batch.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1155" class="ixterm"></a>&#8220;Too many errors&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A block still did not get through after 10 retries (Terminal waits up to 10 seconds for each answer). Use RTS/CTS flow control, a lower speed, or XMODEM-1K. For ZMODEM, try <strong>Escape all control characters (for links that lose them)</strong>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Lost block sequence&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A block went missing, and the transfer stopped.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot open <em>file</em>&#8221;, &#8220;Cannot read the file&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file to send could not be opened or read.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot create the file&#8221;, &#8220;Cannot write the file&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A received file could not be created or written, for example because the disk is full or cannot be written to.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1156" class="ixterm"></a>&#8220;A file larger than 2 GB cannot be transferred&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Files larger than 2 GB cannot be sent or received.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix1157" class="ixterm"></a>If a transfer cannot begin, a message box titled <strong>File Transfer</strong> says why, for example &#8220;Cannot open <em>file</em>&#8221;. If DVX cannot start another transfer at the moment, it says &#8220;No file transfer can be started now.&#8221;</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="terminal-secure-link"><a class="anchor" href="#terminal-secure-link"></a>9.7. The secure link</h3>
<div class="paragraph">
<p><a id="_ix1158" class="ixterm"></a><a id="_ix1159" class="ixterm"></a><a id="_ix1160" class="ixterm"></a>The secure link encrypts everything that passes between your computer and the other end of the connection, so that someone listening in on the cable or the network cannot read it. At the other end, a program called a secure-link proxy takes the encrypted connection and connects you on to the bulletin board.</p>
</div>
<div class="paragraph">
<p>The secure link works only with a secure-link proxy at the other end, not with an ordinary bulletin board. The proxy runs on another computer, which you reach either by a serial cable or over the network (the network needs the Networking part). Whoever runs that computer can tell you what to set: the speed and other line settings for a cable, or the host name and port for the network, and the passphrase, if it uses one.</p>
</div>
<div class="paragraph">
<p><a id="_ix1161" class="ixterm"></a><a id="_ix1162" class="ixterm"></a>The proxy, called secproxy, comes with the DVX SDK (<code>sdk.zip</code>, in its <code>bin</code> folder) and runs on a Linux computer. The SDK&#8217;s <code>secproxy.md</code> tells how to start it for a serial cable or for the network, and how to give it a passphrase.</p>
</div>
<div class="sect3">
<h4 id="terminal-passphrases"><a class="anchor" href="#terminal-passphrases"></a>9.7.1. Passphrases</h4>
<div class="paragraph">
<p><a id="_ix1163" class="ixterm"></a><a id="_ix1164" class="ixterm"></a>A passphrase is a secret that both ends know. The link is encrypted whether or not you use one. With the same passphrase on both sides, the link is also checked: Terminal makes sure the other end knows the passphrase, so nobody in between can pretend to be the proxy. Use exactly the same passphrase as the proxy, or none on both sides.</p>
</div>
<div class="paragraph">
<p>You can keep the passphrase with the session, or have Terminal ask for it each time:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>A passphrase typed in <strong>Passphrase</strong> on the <strong>Secure Link</strong> page is saved with the session, scrambled so that it cannot be read at a glance. Someone who copies Terminal&#8217;s settings file and knows how DVX scrambles it can still read it.</p>
</li>
<li>
<p><a id="_ix1165" class="ixterm"></a>With <strong>Ask for the passphrase when connecting (never save it)</strong> ticked, Terminal never saves the passphrase. Each time you connect, the <strong>Secure Link Passphrase</strong> dialog box asks for it. Type it in <strong>Passphrase for the secure link</strong> and click <b class="button">Connect</b>, or press <kbd>Esc</kbd> to cancel without connecting.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>If other people use your computer, choose to be asked. A passphrase you type when asked is used only while Terminal sets up the link, and then forgotten.</p>
</div>
</div>
<div class="sect3">
<h4 id="terminal-secure-session"><a class="anchor" href="#terminal-secure-session"></a>9.7.2. Setting up a secure link session</h4>
<div class="paragraph">
<p><a id="_ix1166" class="ixterm"></a>To set up a session for the secure link:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Phone Book&#8230;&#8203;</b></span> and click <b class="button">New&#8230;&#8203;</b>.</p>
</li>
<li>
<p>Type a <strong>Name</strong>, and choose <strong>Secure link</strong> in <strong>Connect with</strong>.</p>
</li>
<li>
<p><a id="_ix1167" class="ixterm"></a><a id="_ix1168" class="ixterm"></a>For a serial cable, choose the <strong>Port</strong> the cable is on, and set <strong>Speed (bps)</strong> and <strong>Flow control</strong> (<strong>None</strong> or <strong>RTS/CTS</strong>) to match the other end. Leave <strong>Data bits</strong>, <strong>Parity</strong>, and <strong>Stop bits</strong> at 8, <strong>None</strong>, and 1, which is what the secure-link proxy uses. The secure link cannot use <strong>XON/XOFF</strong>, because it sends those characters as part of its data: with <strong>XON/XOFF</strong> chosen, <b class="button">OK</b> says &#8220;A secure link over a COM port cannot use XON/XOFF flow control. Choose None or RTS/CTS.&#8221; and the dialog box stays open.</p>
</li>
<li>
<p>For the network instead, tick <strong>Connect over the network (the host and port on the Network page)</strong> on the <strong>Secure Link</strong> page. Then, on the <strong>Network</strong> page, type the proxy&#8217;s <strong>Host name</strong> and set <strong>Port</strong> to the proxy&#8217;s port, usually 2323. (<strong>Port</strong> starts at 23, so change it.)</p>
</li>
<li>
<p>On the <strong>Secure Link</strong> page, type the <strong>Passphrase</strong>, or tick <strong>Ask for the passphrase when connecting (never save it)</strong>. If the proxy uses no passphrase, leave the box empty.</p>
</li>
<li>
<p>Click <b class="button">OK</b>, then <b class="button">Connect</b>.</p>
</li>
</ol>
</div>
</div>
<div class="sect3">
<h4 id="terminal-secure-connecting"><a class="anchor" href="#terminal-secure-connecting"></a>9.7.3. What you see when you connect</h4>
<div class="paragraph">
<p><a id="_ix1169" class="ixterm"></a>Over a serial cable the status bar says &#8220;Setting up the secure link on COM1&#8221;. Over the network it says &#8220;Connecting to <em>host</em> port <em>n</em> for the secure link&#8221; and then &#8220;Setting up the secure link with <em>host</em>&#8221;. When the link is ready, it says &#8220;Secure link established&#8221;, or &#8220;Secure link established (passphrase checked)&#8221; when both ends use the same passphrase.</p>
</div>
<div class="paragraph">
<p>Then press <kbd>Enter</kbd>. The proxy answers &#8220;SecLink proxy ready.&#8221; and connects you to the bulletin board.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/tmSecureLink.png" alt="Terminal&#8217;s screen with the notes Setting up the secure link on COM2 and Secure link established (passphrase checked)" width="followed by SecLink proxy ready.">
</div>
<div class="title">Figure 47. The secure link established, with the passphrase checked</div>
</div>
<div class="paragraph">
<p>From then on, you use Terminal as with any other connection. <span class="menuseq"><b class="menu">Edit</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Send Break</b></span> is not available over the secure link.</p>
</div>
</div>
<div class="sect3">
<h4 id="terminal-secure-problems"><a class="anchor" href="#terminal-secure-problems"></a>9.7.4. When the secure link does not connect</h4>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Message</th>
<th class="tableblock halign-left valign-top">What it means</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1170" class="ixterm"></a><a id="_ix1171" class="ixterm"></a>&#8220;The passphrase does not match the host&#8217;s&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The two ends use different passphrases, and the connection ends. Use exactly the same passphrase as the proxy, or none on both sides.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1172" class="ixterm"></a>&#8220;The host did not answer the secure link&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The other end did not answer within 30 seconds. Check that the secure-link proxy is running, and, over a cable, that the speed and flow control match and the line uses 8 data bits, no parity, and 1 stop bit.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The secure link could not be set up&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The link could not be set up for another reason.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;COM<em>n</em> could not be opened for the secure link&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The serial port could not be opened. Check <strong>Port</strong> on the <strong>Connection</strong> page.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The secure link cannot use XON/XOFF flow control: choose None or RTS/CTS&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The session uses <strong>XON/XOFF</strong> over a COM port, which the secure link cannot use. This happens only when the setting was made outside Session Settings, for example by editing Terminal&#8217;s settings file. Choose <strong>None</strong> or <strong>RTS/CTS</strong> in <strong>Flow control</strong>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Out of memory for the secure link&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">There was not enough memory to set up the link. Close some programs and try again.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1173" class="ixterm"></a>&#8220;The secure link was lost&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The link broke after it was established.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>Over the network, the messages about the host in <a href="#terminal-telnet">Section 9.5.3</a>, such as &#8220;<em>host</em> refused the connection on port <em>n</em>&#8221;, can also appear.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="terminal-settings"><a class="anchor" href="#terminal-settings"></a>9.8. Terminal settings</h3>
<div class="paragraph">
<p><a id="_ix1174" class="ixterm"></a>This section explains how Terminal shows the other computer&#8217;s screen, and the settings that change it. Most of them belong to a session and are on the <strong>Screen</strong> page of the session&#8217;s settings (see <a href="#terminal-screen-page">Section 9.4.4.5</a>); the most used ones are also on the <strong>Settings</strong> menu.</p>
</div>
<div class="sect3">
<h4 id="terminal-emulation"><a class="anchor" href="#terminal-emulation"></a>9.8.1. Terminal emulation</h4>
<div class="paragraph">
<p><a id="_ix1175" class="ixterm"></a><a id="_ix1176" class="ixterm"></a>Terminal works as an ANSI terminal, the kind bulletin boards expect. It understands the ANSI codes for moving the cursor, clearing the screen or a line, scrolling part of the screen (for example under a status line that stays put), the 16 text colors, blinking text, and ANSI music. It shows the PC character set, so the line-drawing characters bulletin boards use for boxes and menus look as intended. There is no other emulation to choose.</p>
</div>
<div class="paragraph">
<p>When the other computer asks what kind of terminal it is talking to, where the cursor is, or how big the screen is, Terminal answers by itself. Over Telnet it also tells the other computer that it is an ANSI terminal, and how many columns and rows the screen has.</p>
</div>
</div>
<div class="sect3">
<h4 id="terminal-colors"><a class="anchor" href="#terminal-colors"></a>9.8.2. Colors</h4>
<div class="paragraph">
<p><a id="_ix1177" class="ixterm"></a>To change the screen&#8217;s colors, choose one on the <span class="menuseq"><b class="menu">Settings</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Colors</b></span> submenu, or in <strong>Colors</strong> on the <strong>Screen</strong> page:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Standard</strong></dt>
<dd>
<p>The usual ANSI colors.</p>
</dd>
<dt class="hdlist1"><strong>Green screen</strong></dt>
<dd>
<p>Shades of green, like an old green monitor.</p>
</dd>
<dt class="hdlist1"><strong>Amber screen</strong></dt>
<dd>
<p>Shades of amber, like an old amber monitor.</p>
</dd>
<dt class="hdlist1"><strong>Black on white</strong></dt>
<dd>
<p>Black text on a white background, with the colors darkened so they show up on white.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>The colors belong to the session and change at once.</p>
</div>
</div>
<div class="sect3">
<h4 id="terminal-local-echo"><a class="anchor" href="#terminal-local-echo"></a>9.8.3. Local echo</h4>
<div class="paragraph">
<p><a id="_ix1178" class="ixterm"></a><a id="_ix1179" class="ixterm"></a>Many computers send back each character you type, so that it appears on your screen; some do not. With local echo on, Terminal shows what you type itself, with <kbd>Enter</kbd> as a new line. Turn it on with <span class="menuseq"><b class="menu">Settings</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Local Echo</b></span> if nothing appears when you type; turn it off if every letter appears twice. Local echo belongs to the session and is off at first.</p>
</div>
</div>
<div class="sect3">
<h4 id="terminal-answerback"><a class="anchor" href="#terminal-answerback"></a>9.8.4. Answerback</h4>
<div class="paragraph">
<p><a id="_ix1180" class="ixterm"></a><a id="_ix1181" class="ixterm"></a>Some systems ask a terminal to identify itself by sending a special character, Ctrl+E (called ENQ). Terminal answers with the text in <strong>Answerback</strong> on the <strong>Screen</strong> page, and does not show the character. When <strong>Answerback</strong> is empty, Terminal sends nothing.</p>
</div>
</div>
<div class="sect3">
<h4 id="terminal-music"><a class="anchor" href="#terminal-music"></a>9.8.5. ANSI music and the bell</h4>
<div class="paragraph">
<p><a id="_ix1182" class="ixterm"></a><a id="_ix1183" class="ixterm"></a><a id="_ix1184" class="ixterm"></a><a id="_ix1185" class="ixterm"></a>Some bulletin boards play tunes on their menus and welcome screens. This is called ANSI music. Terminal plays it through your sound card, or through the PC speaker when there is no sound card (see <a href="#cpanel-sounds">Section 7.12</a> for choosing the sound hardware). While a tune plays, the screen waits for it to end before it shows more, as the bulletin board intended; only a tune the bulletin board sends as background music plays while the screen goes on. A mistake in a tune is ignored.</p>
</div>
<div class="paragraph">
<p>To turn ANSI music off or on, choose <span class="menuseq"><b class="menu">Settings</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">ANSI Music</b></span>, or use <strong>Play ANSI music the other side sends</strong> on the <strong>Screen</strong> page. It belongs to the session and is on at first. Turning it off also stops a tune that is playing.</p>
</div>
<div class="paragraph">
<p><a id="_ix1186" class="ixterm"></a><a id="_ix1187" class="ixterm"></a>When the other computer rings the bell (by sending the character Ctrl+G), Terminal beeps, at most once every half second.</p>
</div>
</div>
<div class="sect3">
<h4 id="terminal-scrollback"><a class="anchor" href="#terminal-scrollback"></a>9.8.6. Scrollback</h4>
<div class="paragraph">
<p><a id="_ix1188" class="ixterm"></a><a id="_ix1189" class="ixterm"></a>Lines that scroll off the top of the screen are kept in the scrollback, up to the number in <strong>Scrollback lines</strong> on the <strong>Screen</strong> page (1,000 at first, and up to 10,000). To look back, use the scroll bar at the right side of the screen, the mouse wheel, or <span class="keyseq"><kbd>Shift</kbd>+<kbd>PgUp</kbd></span> and <span class="keyseq"><kbd>Shift</kbd>+<kbd>PgDn</kbd></span>. Typing or pasting takes you back to the live screen.</p>
</div>
<div class="paragraph">
<p><span class="menuseq"><b class="menu">Edit</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Clear Screen</b></span>, and a bulletin board that clears the screen, move the old screen into the scrollback. Lines that scroll inside part of the screen, such as under a status line that stays put, are not kept. Changing <strong>Columns</strong> or <strong>Rows</strong> empties the scrollback.</p>
</div>
</div>
<div class="sect3">
<h4 id="terminal-capture"><a class="anchor" href="#terminal-capture"></a>9.8.7. Capturing to a file</h4>
<div class="paragraph">
<p><a id="_ix1190" class="ixterm"></a><a id="_ix1191" class="ixterm"></a>To save everything the other computer sends in a file:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Capture to File&#8230;&#8203;</b></span>.</p>
</li>
<li>
<p>In the <strong>Capture to File</strong> dialog box, choose a folder, type a file name, and click <b class="button">Save</b> (see <a href="#desktop-file-dialogs">Section 5.6</a>).</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>Terminal adds everything it receives to the end of the file, exactly as it arrives, including the codes for colors and cursor movement. A check mark shows next to <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Capture to File&#8230;&#8203;</b></span>, the right side of the status bar shows <code>Capture</code>, and the screen shows &#8220;[Capturing to <em>file</em>]&#8221;. To stop, choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Capture to File&#8230;&#8203;</b></span> again; the screen shows &#8220;[Capture stopped]&#8221;. The files you send or receive in a file transfer are not captured.</p>
</div>
<div class="paragraph">
<p><a id="_ix1192" class="ixterm"></a>If you choose a file that already exists, the dialog box asks &#8220;<em>name</em> already exists. Do you want to replace it?&#8221; Click <b class="button">Yes</b> to go on: Terminal adds the new text at the end of the file and keeps what was there. If the file cannot be opened, Terminal says &#8220;The capture file could not be opened.&#8221;</p>
</div>
</div>
<div class="sect3">
<h4 id="terminal-settings-file"><a class="anchor" href="#terminal-settings-file"></a>9.8.8. Where Terminal keeps its settings</h4>
<div class="paragraph">
<p><a id="_ix1193" class="ixterm"></a><a id="_ix1194" class="ixterm"></a>Terminal keeps the phone book (every session with all its settings), the session you used last, the protocol, and the transfer options in the file <code>TERMINAL.INI</code>, in Terminal&#8217;s folder in your user folder: <code>USER\APPS\KPUNCH\TERMINAL</code> (see <a href="#folders-layout">Section B.1</a>). It saves the file at once whenever you change a session, a color, local echo, ANSI music, the protocol, or a transfer option. A passphrase is saved scrambled, and never when the session asks for it at each connect.</p>
</div>
<div class="paragraph">
<p><a id="_ix1195" class="ixterm"></a>When more than one Terminal is running, they share this file. Each time a Terminal saves, it reads the file again first and changes only what you changed in that Terminal, so the other Terminals' changes are kept, even to the same session. The phone book shows the other Terminals' changes each time you open it. A session that another Terminal renames or deletes is no longer the window&#8217;s session: the window keeps its settings, but its changes are not saved until you choose a session again.</p>
</div>
<div class="paragraph">
<p><a id="_ix1196" class="ixterm"></a>If Terminal cannot save the file, the screen shows &#8220;[The phone book could not be saved]&#8221;.</p>
</div>
<div class="paragraph">
<p><a id="_ix1197" class="ixterm"></a><a id="_ix1198" class="ixterm"></a>If the file is there but cannot be read (it is damaged, or its disk failed), Terminal starts with the usual session, <strong>Direct COM1</strong>, and says &#8220;The phone book <em>file</em> cannot be read. Terminal goes on, but does not save changes to the phone book, so the sessions in the file are not lost.&#8221; It then never saves over the file, so you can still restore it from a backup. Delete the file, or put a good copy in its place, and start Terminal again.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="terminal-problems"><a class="anchor" href="#terminal-problems"></a>9.9. When something goes wrong in Terminal</h3>
<div class="paragraph">
<p><a id="_ix1199" class="ixterm"></a><a id="_ix1200" class="ixterm"></a>The messages for each way of connecting are listed in <a href="#terminal-serial">Section 9.5.1</a>, <a href="#terminal-modem">Section 9.5.2</a>, <a href="#terminal-telnet">Section 9.5.3</a>, and <a href="#terminal-secure-problems">Section 9.7.4</a>; the file transfer results are in <a href="#terminal-transfer-messages">Section 9.6.8</a>. These problems come up most often:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">What you see</th>
<th class="tableblock halign-left valign-top">What to try</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">The screen shows random characters.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The speed, data bits, parity, or stop bits do not match the other side. Change them on the <strong>Connection</strong> page.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Nothing appears when you type.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Turn on <span class="menuseq"><b class="menu">Settings</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Local Echo</b></span>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Every letter appears twice.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Turn off <span class="menuseq"><b class="menu">Settings</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Local Echo</b></span>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Telnet and the secure link over the network need Networking, which is not installed. Setup can add it.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Run Setup and add the Networking part (see <a href="#installing-parts">Section 3.5</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Transfers stop with &#8220;Too many errors&#8221;.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Use RTS/CTS flow control, a lower speed, or XMODEM-1K. For ZMODEM, try <strong>Escape all control characters (for links that lose them)</strong>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The receiver did not start&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Start the receive on the other computer before, or right after, you choose <span class="menuseq"><b class="menu">Transfer</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Send Files&#8230;&#8203;</b></span>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The passphrase does not match the host&#8217;s&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Use exactly the same passphrase as the secure-link proxy, or none on both sides.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>See also <a href="#trouble-serial">Section 11.10</a> and <a href="#trouble-network">Section 11.9</a>.</p>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="addons"><a class="anchor" href="#addons"></a>Chapter 10. Managing Add-ons</h2>
<div class="sectionbody">
<div class="paragraph">
<p><a id="_ix1201" class="ixterm"></a><a id="_ix1202" class="ixterm"></a>An add-on is anything you add to DVX after it is installed: a program, a library or widget that other programs use, fonts, sounds, themes, desktop pictures, screen savers, help files, or MIDI instruments. You add, update, and remove add-ons with the Software program. This chapter explains what add-ons are, how to install them from a file or from the package server over the network, how to keep them and DVX itself up to date, how to publish your own, how DVX checks who made them, and how to add or remove the optional parts of DVX after Setup.</p>
</div>
<div class="sect2">
<h3 id="addons-kinds"><a class="anchor" href="#addons-kinds"></a>10.1. Add-ons and packages</h3>
<div class="paragraph">
<p><a id="_ix1203" class="ixterm"></a><a id="_ix1204" class="ixterm"></a><a id="_ix1205" class="ixterm"></a>Every add-on comes as a package: one file whose name ends in <code>.DPK</code>. A package holds the add-on&#8217;s files, a list of those files with the size and a fingerprint of each, and a description of the package: its name, version, and kind, who published and wrote it, and which other packages it needs. DVX checks every file against that list as it unpacks the package.</p>
</div>
<div class="paragraph">
<p><a id="_ix1206" class="ixterm"></a>DVX itself, its base fonts, and its optional parts are packages too. That is why Software lists them beside your add-ons, and why the package server can keep them up to date.</p>
</div>
<div class="sect3">
<h4 id="addons-kinds-list"><a class="anchor" href="#addons-kinds-list"></a>10.1.1. Kinds of packages</h4>
<div class="paragraph">
<p><a id="_ix1207" class="ixterm"></a><a id="_ix1208" class="ixterm"></a>Each package is of one kind. Software shows the kind, in these words, in its <strong>Kind</strong> column and in a package&#8217;s details:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 80%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Kind</th>
<th class="tableblock halign-left valign-top">What the package holds</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>app</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1209" class="ixterm"></a>A program. It appears in Program Manager&#8217;s Installed Programs group.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>library</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A library: something other programs use to do their work. It works from the next time DVX starts.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>widget</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A widget: a kind of control that other programs use in their windows. It works from the next time DVX starts.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>font</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1210" class="ixterm"></a>Fonts.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>bank</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1211" class="ixterm"></a>MIDI instruments.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>theme</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1212" class="ixterm"></a>Themes.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>wallpaper</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1213" class="ixterm"></a>Desktop pictures.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>sound</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1214" class="ixterm"></a>Sounds.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>saver</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1215" class="ixterm"></a>A screen saver.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>help</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A help file.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>bundle</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1216" class="ixterm"></a><a id="_ix1217" class="ixterm"></a>No files of its own: a bundle stands for a set of other packages. Each optional part of DVX is a bundle (see <a href="#addons-parts">Section 10.9</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>system</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX itself. Only DVX&#8217;s own package has this kind.</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect3">
<h4 id="addons-names"><a class="anchor" href="#addons-names"></a>10.1.2. Names, package names, and versions</h4>
<div class="paragraph">
<p><a id="_ix1218" class="ixterm"></a><a id="_ix1219" class="ixterm"></a><a id="_ix1220" class="ixterm"></a>Three things identify a package:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Name</strong></dt>
<dd>
<p>The name people see, such as Chess.</p>
</dd>
<dt class="hdlist1"><strong>Package name</strong></dt>
<dd>
<p>Who made the package and what it is, with a dot between, such as <code>acme.chess</code>. Each part is 1 to 8 lower-case letters, digits, or underscores (<code>_</code>). Two packages with the same package name are the same package. Software shows the package name in its <strong>Package</strong> column, which tells apart two packages that have the same name.</p>
</dd>
<dt class="hdlist1"><strong>Version</strong></dt>
<dd>
<p>Numbers with dots between them, such as 1.0.0. A higher version is a newer one.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p><a id="_ix1221" class="ixterm"></a>Package names that start with <code>kpunch.</code> belong to DVX&#8217;s own packages, such as <code>kpunch.dvx</code> (DVX itself) and <code>kpunch.basefont</code> (DVX Fonts, the base set of fonts). Only packages signed with DVX&#8217;s own key may use such a name (see <a href="#addons-signatures">Section 10.8</a>).</p>
</div>
<div class="paragraph">
<p><a id="_ix1222" class="ixterm"></a>A package can need other packages, each at an oldest version that will do. Software installs what a package needs along with it, and removes a package only together with the packages that need it.</p>
</div>
<div class="paragraph">
<p>DVX itself is listed as a package named DVX, with the summary &#8220;The DVX desktop and its programs.&#8221;, the publisher Kangaroo Punch Studios, and the licence MIT. The base fonts are the package DVX Fonts, with the summary &#8220;DejaVu Sans, Sans Mono, and Serif in every style, in sizes for the screen and for printing.&#8221;</p>
</div>
</div>
<div class="sect3">
<h4 id="addons-where"><a class="anchor" href="#addons-where"></a>10.1.3. Where add-ons are installed</h4>
<div class="paragraph">
<p><a id="_ix1223" class="ixterm"></a><a id="_ix1224" class="ixterm"></a>Add-ons are installed into the DVX folder (for example <code>C:\DVX</code>), never into your user folder. So an add-on is installed for everyone: every user folder used with that DVX folder sees it. There is no way to install a package for one user only.</p>
</div>
<div class="paragraph">
<p>Each kind goes into its own folder in the DVX folder, named from the package name. For a package named <code>acme.chess</code>, the files go here:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 80%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Kind</th>
<th class="tableblock halign-left valign-top">Folder in the DVX folder</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>app</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>APPS\ACME\CHESS</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>library</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>LIBS\ACME\CHESS</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>widget</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>WIDGETS\ACME\CHESS</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>help</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>APPS\ACME\CHESS</code>, or beside a library or widget with the same package name</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>font</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>SHARED\FONTS\ACME</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>bank</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>SHARED\BANKS\ACME</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>theme</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>SHARED\THEMES\ACME</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>wallpaper</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>SHARED\WPAPER\ACME</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>sound</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>SHARED\SOUNDS\ACME</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>saver</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>SHARED\SAVERS\ACME</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>bundle</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">None: a bundle has no files of its own.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>system</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Anywhere in the DVX folder except the user folder.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix1225" class="ixterm"></a>Any kind except a bundle may also put files in DVX&#8217;s <code>SYSTEM</code> folder, for example a program for the DOS prompt, but not in its <code>KEYS</code> or <code>PACKAGES</code> folders. A package can never replace a file that belongs to another package: Software refuses such a package before it installs anything. DVX keeps a record of each installed package in <code>SYSTEM\PACKAGES</code>.</p>
</div>
<div class="paragraph">
<p><a id="_ix1226" class="ixterm"></a>The <code>SHARED</code> folder holds the fonts, sounds, themes, desktop pictures, MIDI instruments, and screen savers that every program can use. Only packages put files there. Your own fonts, sounds, themes, desktop pictures, and screen savers go in the folders of the same names in your user folder instead. Those are not packages, and Software does not list them. See <a href="#folders-layout">Section B.1</a> for the folders of DVX.</p>
</div>
<div class="paragraph">
<p><a id="_ix1227" class="ixterm"></a><a id="_ix1228" class="ixterm"></a>A few things about add-ons are kept for each user folder:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>The publisher keys you chose to trust, in the <code>KEYS</code> folder in your user folder (see <a href="#addons-trust-key">Section 10.8.4</a>).</p>
</li>
<li>
<p>The package server&#8217;s settings and your account there, in <code>DVX.INI</code> in your user folder (see <a href="#addons-server-window">Section 10.6.1</a>).</p>
</li>
<li>
<p>Packages being downloaded from the package server, in the <code>DOWNLOAD</code> folder in your user folder.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>Your user folder is the <code>USER</code> folder in the DVX folder, unless the DVXUSER environment variable names another folder.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="addons-software"><a class="anchor" href="#addons-software"></a>10.2. The Software program</h3>
<div class="paragraph">
<p><a id="_ix1229" class="ixterm"></a><a id="_ix1230" class="ixterm"></a><a id="_ix1231" class="ixterm"></a>Software installs, shows, updates, and removes packages. It is part of DVX itself, so it is always installed. To start it, open Program Manager&#8217;s Installed Programs group and double-click Software. Opening a <code>.DPK</code> file also starts Software (see <a href="#addons-from-file">Section 10.3.1</a>).</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/adInstalled.png" alt="Software&#8217;s Installed page, listing DVX, DVX Fonts, More Fonts, and the optional parts of DVX">
</div>
<div class="title">Figure 48. The Software window, showing its Installed page</div>
</div>
<div class="paragraph">
<p>The window has a menu bar, four pages on tabs (<strong>Installed</strong>, <strong>Available</strong>, <strong>Updates</strong>, and <strong>Published</strong>), and a status bar along the bottom. You can resize the window. The Available, Updates, and Published pages work with the package server over the network, so they need the Networking part of DVX (see <a href="#addons-offline">Section 10.2.8</a>).</p>
</div>
<div class="sect3">
<h4 id="addons-menus"><a class="anchor" href="#addons-menus"></a>10.2.1. Software&#8217;s menus</h4>
<div class="paragraph">
<p><a id="_ix1232" class="ixterm"></a>The menus hold these commands:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 28.5714%;">
<col style="width: 71.4286%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Command</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Install from File&#8230;&#8203;</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Installs a package from a <code>.DPK</code> file (see <a href="#addons-from-file">Section 10.3.1</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Publish a Package&#8230;&#8203;</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Sends a package you made to the package server (see <a href="#addons-publishing">Section 10.7</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Trust a Publisher&#8217;s Key&#8230;&#8203;</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Makes DVX trust the packages a publisher signs (see <a href="#addons-trust-key">Section 10.8.4</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Package Server&#8230;&#8203;</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens the <strong>Package Server</strong> window: the server Software uses, and your account there (see <a href="#addons-server-window">Section 10.6.1</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Exit</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Closes Software.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">Package</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Details&#8230;&#8203;</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Shows everything about the chosen package (see <a href="#addons-details">Section 10.2.7</a>). On the Published page, it says how the chosen version&#8217;s review went.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">Package</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Remove&#8230;&#8203;</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Removes the chosen package (see <a href="#addons-removing">Section 10.4</a>). On any other page, it first switches to the Installed page without removing anything; choose the package there and choose the command again.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">Package</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Install</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Installs the package chosen on the Available page (see <a href="#addons-from-server">Section 10.3.2</a>). On any other page, it first switches to the Available page.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">Package</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Check for Updates</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Switches to the Updates page and asks the package server what is newer (see <a href="#addons-updates">Section 10.5</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">Package</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Update All</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Installs everything on the Updates page. If you are on another page, or the updates have not been checked yet, it switches to the Updates page and checks first; choose it again to install.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">Help</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Contents</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens Software&#8217;s help in DVX Help.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">Help</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">About Software&#8230;&#8203;</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Shows what Software does and its copyright.</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect3">
<h4 id="addons-installed-page"><a class="anchor" href="#addons-installed-page"></a>10.2.2. The Installed page</h4>
<div class="paragraph">
<p><a id="_ix1233" class="ixterm"></a>The <strong>Installed</strong> page lists every installed package, DVX itself included. Its columns are:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Name</strong></dt>
<dd>
<p>The package&#8217;s name.</p>
</dd>
<dt class="hdlist1"><strong>Version</strong></dt>
<dd>
<p>The version installed.</p>
</dd>
<dt class="hdlist1"><strong>Kind</strong></dt>
<dd>
<p>What the package holds (see <a href="#addons-kinds-list">Section 10.1.1</a>).</p>
</dd>
<dt class="hdlist1"><strong>Summary</strong></dt>
<dd>
<p>A short description.</p>
</dd>
<dt class="hdlist1"><strong>Package</strong></dt>
<dd>
<p>The package name, such as <code>acme.chess</code>.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>The buttons <b class="button">Details&#8230;&#8203;</b>, <b class="button">Remove&#8230;&#8203;</b>, and <b class="button">Install from File&#8230;&#8203;</b> do the same as the menu commands of those names.</p>
</div>
<div class="paragraph">
<p><a id="_ix1234" class="ixterm"></a>A bundle, such as each optional part of DVX, shows as one row. The packages it holds that were installed only for it are not listed separately; the bundle&#8217;s details name them. A package that you installed on its own is listed even when a bundle also holds it.</p>
</div>
<div class="paragraph">
<p>The status bar shows how many packages are listed, for example &#8220;10 packages installed&#8221;.</p>
</div>
</div>
<div class="sect3">
<h4 id="addons-available-page"><a class="anchor" href="#addons-available-page"></a>10.2.3. The Available page</h4>
<div class="paragraph">
<p><a id="_ix1235" class="ixterm"></a><a id="_ix1236" class="ixterm"></a>The <strong>Available</strong> page lists every package the package server offers, at the newest version it has. Software reads this list from the server the first time you show the page; <b class="button">Refresh</b> reads it again. While it reads, a window titled <strong>Reading the package list</strong> shows its progress.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/adAvailable.png" alt="Software&#8217;s Available page, with the Find box, the Refresh button, and three packages from the package server">
</div>
<div class="title">Figure 49. The Available page, listing what the package server offers</div>
</div>
<div class="paragraph">
<p>Its columns are:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Name</strong></dt>
<dd>
<p>The package&#8217;s name.</p>
</dd>
<dt class="hdlist1"><strong>Version</strong></dt>
<dd>
<p>The version the server offers.</p>
</dd>
<dt class="hdlist1"><strong>Kind</strong></dt>
<dd>
<p>What the package holds.</p>
</dd>
<dt class="hdlist1"><strong>Summary</strong></dt>
<dd>
<p>A short description.</p>
</dd>
<dt class="hdlist1"><strong>Installed</strong></dt>
<dd>
<p>The version you have. It is empty when you do not have the package.</p>
</dd>
<dt class="hdlist1"><strong>Package</strong></dt>
<dd>
<p>The package name.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p><a id="_ix1237" class="ixterm"></a><a id="_ix1238" class="ixterm"></a>To shorten the list, type in the <strong>Find</strong> box. Only the packages whose name, summary, or package name contains what you typed stay in the list; capital and small letters count as the same. Empty the box to see the whole list again.</p>
</div>
<div class="paragraph">
<p><b class="button">Details&#8230;&#8203;</b> shows what the server says about the chosen package (see <a href="#addons-details">Section 10.2.7</a>). <b class="button">Install</b> fetches the chosen package and installs it (see <a href="#addons-from-server">Section 10.3.2</a>).</p>
</div>
<div class="paragraph">
<p>The status bar shows how many packages the server offers and the server&#8217;s address: &#8220;<em>n</em> packages on <em>address</em>&#8221;, for example with the address <code><a href="http://packages.dvxgui.com" class="bare">http://packages.dvxgui.com</a></code>. When the server cannot be reached, the status bar says &#8220;The package server could not be reached.&#8221; and a message gives the reason (see <a href="#addons-server-messages">Section 10.6.3</a>).</p>
</div>
</div>
<div class="sect3">
<h4 id="addons-updates-page"><a class="anchor" href="#addons-updates-page"></a>10.2.4. The Updates page</h4>
<div class="paragraph">
<p><a id="_ix1239" class="ixterm"></a>The <strong>Updates</strong> page lists what the package server has that is newer than the packages you have, DVX itself included (see <a href="#addons-updates">Section 10.5</a> for using it). A line above the list says how many updates there are. The list&#8217;s columns are:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Name</strong></dt>
<dd>
<p>The package&#8217;s name.</p>
</dd>
<dt class="hdlist1"><strong>Installed</strong></dt>
<dd>
<p>The version you have.</p>
</dd>
<dt class="hdlist1"><strong>New</strong></dt>
<dd>
<p>The newer version on the server.</p>
</dd>
<dt class="hdlist1"><strong>Kind</strong></dt>
<dd>
<p>What the package holds.</p>
</dd>
<dt class="hdlist1"><strong>Summary</strong></dt>
<dd>
<p>A short description.</p>
</dd>
<dt class="hdlist1"><strong>Package</strong></dt>
<dd>
<p>The package name.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p><b class="button">Check for Updates</b> asks the server again, and <b class="button">Update All</b> installs everything listed.</p>
</div>
</div>
<div class="sect3">
<h4 id="addons-published-page"><a class="anchor" href="#addons-published-page"></a>10.2.5. The Published page</h4>
<div class="paragraph">
<p><a id="_ix1240" class="ixterm"></a>The <strong>Published</strong> page lists every version of every package you have sent to the package server, and how its review went (see <a href="#addons-publishing">Section 10.7</a>). The line above the list says &#8220;<em>n</em> versions published by <em>email</em>&#8221;, with the email of your account. Without an account, it says &#8220;Give your account on the package server in File &gt; Package Server to see what you have published.&#8221; The list&#8217;s columns are:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Name</strong></dt>
<dd>
<p>The package&#8217;s name.</p>
</dd>
<dt class="hdlist1"><strong>Version</strong></dt>
<dd>
<p>The version you sent.</p>
</dd>
<dt class="hdlist1"><strong>State</strong></dt>
<dd>
<p>&#8220;Waiting for review&#8221; (the server&#8217;s operator has not looked at it yet), &#8220;Published&#8221; (it is offered to everyone), &#8220;Turned down&#8221; (it was not accepted; the <strong>Note</strong> gives the reviewer&#8217;s reason), or &#8220;Withdrawn&#8221; (it was taken off the server&#8217;s list).</p>
</dd>
<dt class="hdlist1"><strong>Note</strong></dt>
<dd>
<p>The reviewer&#8217;s note, if any.</p>
</dd>
<dt class="hdlist1"><strong>Package</strong></dt>
<dd>
<p>The package name.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>Software reads this list from the server the first time you show the page; <b class="button">Refresh</b> asks again. <b class="button">Publish a Package&#8230;&#8203;</b> is the same as <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Publish a Package&#8230;&#8203;</b></span>.</p>
</div>
</div>
<div class="sect3">
<h4 id="addons-choosing"><a class="anchor" href="#addons-choosing"></a>10.2.6. Choosing a package and sorting the lists</h4>
<div class="paragraph">
<p><a id="_ix1241" class="ixterm"></a><a id="_ix1242" class="ixterm"></a>Every list starts with its first row chosen. Click a row to choose another package; Details, Install, and Remove act on the chosen one. Double-clicking a row is the same as choosing Details. Click a column heading to sort the list by that column.</p>
</div>
<div class="paragraph">
<p><a id="_ix1243" class="ixterm"></a>If no package is chosen, for example because the list is empty, Software says &#8220;Choose a package in the list first.&#8221;</p>
</div>
</div>
<div class="sect3">
<h4 id="addons-details"><a class="anchor" href="#addons-details"></a>10.2.7. The Details window</h4>
<div class="paragraph">
<p><a id="_ix1244" class="ixterm"></a><a id="_ix1245" class="ixterm"></a>To see everything about a package, choose it and choose <b class="button">Details&#8230;&#8203;</b> (or <span class="menuseq"><b class="menu">Package</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Details&#8230;&#8203;</b></span>), or double-click it. The window&#8217;s title is the package&#8217;s name. Its upper list has the columns <strong>What</strong> and <strong>Value</strong>, with these rows:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 80%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">What</th>
<th class="tableblock halign-left valign-top">Value</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Name</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package&#8217;s name.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Version</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Its version.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Kind</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">What it holds (see <a href="#addons-kinds-list">Section 10.1.1</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Summary</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A short description.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Publisher</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Who publishes it.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Author</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Who made it.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Licence</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The terms under which you may use it.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Web site</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A web site for the package, if any.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Signed by</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Who signed it (see below).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Needs</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The packages it needs, by package name, each with the oldest version that will do, such as &#8220;kpunch.dvx 1.0.0 or later&#8221;, separated by commas. For a bundle, these are the packages it holds.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Needed by</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">For an installed package: the names of the installed packages that need it.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Size</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">For a package on the server: the size of its file, in bytes.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Package</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Its package name.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix1246" class="ixterm"></a>For an installed package, <strong>Signed by</strong> gives the name of the trusted key that signed it, such as &#8220;DVX Repository&#8221; for DVX&#8217;s own key. It says &#8220;key <em>id</em>&#8221; when the key that signed it is no longer trusted, and &#8220;nobody&#8221; when the package is not signed. <a id="_ix1247" class="ixterm"></a>A package signed with a key you did not trust when you installed it shows &#8220;a key you did not trust when it was installed (not checked)&#8221;: DVX could not check that signature. A package whose signature by a key you trust does not fit it shows &#8220;a key you trusted, but its signature did not fit: the package was changed after it was signed&#8221;. <a id="_ix1248" class="ixterm"></a>For DVX itself, DVX Fonts, and the parts of DVX that Setup installed, it says &#8220;not checked: Setup installed it from the DVX disks&#8221;: Setup copied them from the DVX disks and checked no signature. Once one of them is updated from the package server, it names DVX&#8217;s key. For a package on the Available or Updates page, <strong>Signed by</strong> says &#8220;checked when it is installed&#8221;: DVX checks the signature once it has fetched the package.</p>
</div>
<div class="paragraph">
<p>Below, <strong>Files</strong> lists every file the package put in DVX, with its size. Each file is named from the DVX folder, for example <code>APPS\ACME\CHESS\CHESS.APP</code>. For a package on the server, this list is empty: its files are known only once it is fetched.</p>
</div>
<div class="paragraph">
<p><b class="button">Close</b> (or <kbd>Enter</kbd> or <kbd>Esc</kbd>) closes the window.</p>
</div>
<div class="paragraph">
<p>On the Published page, Details shows a message instead of this window: &#8220;<em>Name</em> <em>Version</em>: <em>State</em>.&#8221;, followed by the reviewer&#8217;s note when there is one.</p>
</div>
</div>
<div class="sect3">
<h4 id="addons-offline"><a class="anchor" href="#addons-offline"></a>10.2.8. Software without the Networking part</h4>
<div class="paragraph">
<p><a id="_ix1249" class="ixterm"></a><a id="_ix1250" class="ixterm"></a>Without the Networking part of DVX, Software still installs packages from files, shows their details, and removes them; only the package server is out of reach. These are then unavailable: <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Publish a Package&#8230;&#8203;</b></span>, <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Package Server&#8230;&#8203;</b></span>, <span class="menuseq"><b class="menu">Package</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Install</b></span>, <span class="menuseq"><b class="menu">Package</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Check for Updates</b></span>, <span class="menuseq"><b class="menu">Package</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Update All</b></span>, the <strong>Find</strong> box, and the buttons on the Available, Updates, and Published pages.</p>
</div>
<div class="paragraph">
<p><a id="_ix1251" class="ixterm"></a>The three server pages say &#8220;The package server needs DVX&#8217;s Networking part. To add it, run Setup from DVX&#8217;s CD or Disk 1 and choose Upgrade or repair.&#8221; On the Available page this is in the status bar; on the Updates and Published pages it is above the list. See <a href="#addons-parts-add">Section 10.9.1</a>.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="addons-installing"><a class="anchor" href="#addons-installing"></a>10.3. Installing add-ons</h3>
<div class="paragraph">
<p><a id="_ix1252" class="ixterm"></a><a id="_ix1253" class="ixterm"></a><a id="_ix1254" class="ixterm"></a>You can install a package from a <code>.DPK</code> file (on a floppy disk, a CD, or your hard disk) or from the package server. Either way, Software first shows what it is about to do in the <strong>Install Software</strong> window, and installs only when you choose <b class="button">Install</b>.</p>
</div>
<div class="sect3">
<h4 id="addons-from-file"><a class="anchor" href="#addons-from-file"></a>10.3.1. Installing from a file</h4>
<div class="paragraph">
<p><a id="_ix1255" class="ixterm"></a><a id="_ix1256" class="ixterm"></a>To install a package from a file:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>In Software, choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Install from File&#8230;&#8203;</b></span>, or the <b class="button">Install from File&#8230;&#8203;</b> button on the Installed page.</p>
</li>
<li>
<p>In the <strong>Install from File</strong> dialog box, find the package&#8217;s <code>.DPK</code> file and open it. The dialog lists <code>Packages (*.dpk)</code>; choose <code>All Files (*.*)</code> to see every file.</p>
</li>
<li>
<p>Software reads the package. A small window titled <strong>Reading</strong> shows how far it has got.</p>
</li>
<li>
<p>The <strong>Install Software</strong> window shows what will be installed (see <a href="#addons-plan">Section 10.3.4</a>). Read it, then choose <b class="button">Install</b>, or <b class="button">Cancel</b> to install nothing.</p>
</li>
<li>
<p>A window titled <strong>Installing</strong> shows the progress. When it is done, Software says what was installed (see <a href="#addons-install-done">Section 10.3.7</a>).</p>
</li>
</ol>
</div>
<div class="paragraph">
<p><a id="_ix1257" class="ixterm"></a><a id="_ix1258" class="ixterm"></a>You can also open a <code>.DPK</code> file directly: double-click it in File Manager, type its full name in Program Manager&#8217;s <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Run&#8230;&#8203;</b></span>, or make a Program Manager item whose program is the <code>.DPK</code> file. DVX starts Software, which reads the package and shows the <strong>Install Software</strong> window at once. If Software is already open, its window comes to the front and it takes the package the same way. When Software is busy (a question or another window of its own is open, or it is installing), it takes the package once it is done; if you open several packages meanwhile, it takes the last one.</p>
</div>
<div class="paragraph">
<p><a id="_ix1259" class="ixterm"></a>When a package needs other packages, keep them in the same folder. Software reads every other <code>.DPK</code> file in the folder of the one you chose, and installs from them whatever the chosen package needs that you do not have in a version that will do. The other files are used only for that, and one that cannot be read is skipped.</p>
</div>
<div class="paragraph">
<p><a id="_ix1260" class="ixterm"></a><a id="_ix1261" class="ixterm"></a>A package&#8217;s signature can be inside the package, or in a separate file with the same name ending in <code>.SIG</code> beside it. When you copy a package that has a <code>.SIG</code> file, copy the <code>.SIG</code> file with it, or DVX cannot tell who signed the package.</p>
</div>
</div>
<div class="sect3">
<h4 id="addons-from-server"><a class="anchor" href="#addons-from-server"></a>10.3.2. Installing from the package server</h4>
<div class="paragraph">
<p><a id="_ix1262" class="ixterm"></a><a id="_ix1263" class="ixterm"></a>To install a package that the package server offers (this needs the Networking part and a working network connection; see <a href="#net-setup">Section 4.4</a>):</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>In Software, click the <strong>Available</strong> tab. The first time, Software reads the list from the package server.</p>
</li>
<li>
<p>Find the package. To shorten the list, type part of its name in the <strong>Find</strong> box.</p>
</li>
<li>
<p>Choose the package, then choose <b class="button">Install</b> (or <span class="menuseq"><b class="menu">Package</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Install</b></span>).</p>
</li>
<li>
<p>Software fetches the package, with any packages it needs that you do not have in a version that will do. A window titled <strong>Fetching</strong> names the package it is on and shows how far it has got.</p>
</li>
<li>
<p>Software reads what it fetched and shows the <strong>Install Software</strong> window. From here on, installing is exactly as from a file.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>Install fetches the version the Available page lists, which is the newest the server has. For a package you have in an older version, that is an upgrade.</p>
</div>
<div class="paragraph">
<p><a id="_ix1264" class="ixterm"></a>Software fetches packages into the <code>DOWNLOAD</code> folder in your user folder, and deletes them once they are installed. If you choose <b class="button">Cancel</b> in the <strong>Install Software</strong> window, or the install does not finish, they are kept: when you choose <b class="button">Install</b> again, Software checks the packages it kept rather than downloading them again, as long as the server still offers the same versions. Each fetch also clears out the packages an earlier fetch left there. A download that was stopped or cut off part way is kept, and goes on from where it stopped the next time.</p>
</div>
<div class="paragraph">
<p>Each package fetched must be exactly the size and have exactly the fingerprint the server listed for it. If it does not, it is thrown away and the fetch fails. Its signature is fetched with it: a package from the package server is installed only when it is signed with DVX&#8217;s own key (see <a href="#addons-update-rule">Section 10.8.3</a>).</p>
</div>
<div class="paragraph">
<p>If what was fetched cannot be read, Software says &#8220;<em>Name</em> cannot be installed: what was fetched cannot be read.&#8221; Other problems are given as &#8220;<em>Name</em> cannot be installed: <em>reason</em>&#8221;, or as one of the server messages in <a href="#addons-server-messages">Section 10.6.3</a>.</p>
</div>
</div>
<div class="sect3">
<h4 id="addons-cd"><a class="anchor" href="#addons-cd"></a>10.3.3. The add-ons on the DVX CD</h4>
<div class="paragraph">
<p><a id="_ix1265" class="ixterm"></a><a id="_ix1266" class="ixterm"></a><a id="_ix1267" class="ixterm"></a><a id="_ix1268" class="ixterm"></a><a id="_ix1269" class="ixterm"></a>The DVX CD has two add-ons in its <code>ADDONS</code> folder. Setup offers them in its <strong>Add-ons to install</strong> list, each with a box to tick (see <a href="#installing-addons-cd">Section 3.6</a>):</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>More Fonts</strong> (<code>MOREFONT.DPK</code>)</dt>
<dd>
<p>&#8220;More typefaces for documents, programs, and games: condensed DejaVu, Arimo, Tinos, Cousine, display faces, and pixel fonts.&#8221; Setup shows it as 8 MB.</p>
</dd>
<dt class="hdlist1"><strong>DVX General MIDI</strong> (<code>DVXGM.DPK</code>)</dt>
<dd>
<p>&#8220;General MIDI instruments for MIDI music on wavetable sound cards (Gravis UltraSound, Sound Blaster AWE32 and AWE64).&#8221; Setup shows it as 4 MB. It is the <strong>Standard</strong> SoundFont on the Control Panel&#8217;s Sounds page (see <a href="#cpanel-sounds">Section 7.12</a>); without it, the sound card&#8217;s own instruments are used when it has them. (The FM instrument banks DMXOPL and DMXOPL3 are part of DVX itself, not add-ons.)</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>Once installed, both are ordinary packages: Software lists them and can remove them. To add one after Setup, choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Install from File&#8230;&#8203;</b></span> in Software and open it from the <code>ADDONS</code> folder on the CD, or install it from the Available page when the package server offers it. The DVX floppy disks have no add-ons.</p>
</div>
<div class="paragraph">
<p>Each comes with a <code>.SIG</code> file beside it (<code>MOREFONT.SIG</code> and <code>DVXGM.SIG</code>) that holds DVX&#8217;s signature. Their package names start with <code>kpunch.</code>, so they install only with that signature: if you copy one, copy its <code>.SIG</code> file with it, or Software refuses the package with &#8220;<em>Name</em> says it is part of DVX, but it is not signed by DVX&#8217;s key.&#8221;</p>
</div>
<div class="paragraph">
<p><a id="_ix1270" class="ixterm"></a>Setup installs the base fonts, the package DVX Fonts, unless you choose <strong>None</strong> for the fonts (see <a href="#installing-fonts">Section 3.4</a>). Software lists it and offers updates to it. If you chose None, you can add DVX Fonts later from the package server in Software (when the server offers it), or by running Setup again.</p>
</div>
</div>
<div class="sect3">
<h4 id="addons-plan"><a class="anchor" href="#addons-plan"></a>10.3.4. The Install Software window</h4>
<div class="paragraph">
<p><a id="_ix1271" class="ixterm"></a><a id="_ix1272" class="ixterm"></a>Before anything is installed, the <strong>Install Software</strong> window says &#8220;This is what will be installed:&#8221; and lists the packages in the order they will be installed, the packages that others need first.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/adPlan.png" alt="The Install Software window listing two packages, with notes below the list">
</div>
<div class="title">Figure 50. The Install Software window, with notes about a needed package and unsigned packages</div>
</div>
<div class="paragraph">
<p>The list&#8217;s columns are:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Name</strong></dt>
<dd>
<p>The package&#8217;s name.</p>
</dd>
<dt class="hdlist1"><strong>Version</strong></dt>
<dd>
<p>The version to be installed.</p>
</dd>
<dt class="hdlist1"><strong>Action</strong></dt>
<dd>
<p>&#8220;New&#8221; (you do not have the package yet), &#8220;Upgrade&#8221; (a newer version of one you have), or &#8220;Reinstall&#8221; (the same version you have, installed again, which repairs it).</p>
</dd>
<dt class="hdlist1"><strong>Signed</strong></dt>
<dd>
<p>&#8220;By DVX&#8221; (signed with DVX&#8217;s own key), &#8220;Trusted&#8221; (signed with a publisher&#8217;s key you chose to trust), or &#8220;No&#8221; (see <a href="#addons-signatures">Section 10.8</a>).</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>Below the list are notes, each on its own line when it applies:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>&#8220;Installed with it, because it needs them: <em>names</em>.&#8221; These packages are installed too, because the one you chose needs them.</p>
</li>
<li>
<p><a id="_ix1273" class="ixterm"></a>&#8220;Not signed by a publisher DVX trusts: <em>names</em>. Install them only if you trust where they came from.&#8221; The first words are in bold. See <a href="#addons-unsigned">Section 10.8.2</a>.</p>
</li>
<li>
<p>&#8220;These add-ons stop working with the new DVX until they are updated: <em>names</em>.&#8221; This appears only when DVX itself is updated (see <a href="#addons-updates-dvx">Section 10.5.1</a>).</p>
</li>
<li>
<p>&#8220;DVX itself is updated: the new version runs from the next time DVX starts.&#8221; Or, when a library or widget is installed: &#8220;Libraries and widgets work from the next time DVX starts.&#8221;</p>
</li>
<li>
<p>&#8220;It takes <em>n</em> bytes of disk space.&#8221; Or, when the disk does not have enough room: &#8220;There is not enough room on the disk: it needs <em>n</em> bytes and <em>m</em> are free. Make room on the disk, then install again.&#8221; <b class="button">Install</b> is then unavailable.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>Choose <b class="button">Install</b> (or press <kbd>Enter</kbd>) to install, or <b class="button">Cancel</b> (or press <kbd>Esc</kbd>, or click the close box) to install nothing.</p>
</div>
</div>
<div class="sect3">
<h4 id="addons-disk-space"><a class="anchor" href="#addons-disk-space"></a>10.3.5. Disk space</h4>
<div class="paragraph">
<p><a id="_ix1274" class="ixterm"></a><a id="_ix1275" class="ixterm"></a>The last note in the <strong>Install Software</strong> window says how much disk space the packages take. When the disk does not have enough room free, the note says so and <b class="button">Install</b> is unavailable. The room needed can be more than the packages take in the end: each package&#8217;s files are all unpacked before the files of the version it replaces are removed. Make room first, for example by deleting files you no longer need or by removing add-ons you do not use (see <a href="#addons-removing">Section 10.4</a>), then install again. An install that runs out of room all the same (for example because a program filled the disk meanwhile) stops with &#8220;Installing did not finish. <em>Name</em>: There is not enough room on the disk: <em>Name</em> needs <em>n</em> KB and <em>m</em> KB are free.&#8221;</p>
</div>
</div>
<div class="sect3">
<h4 id="addons-progress"><a class="anchor" href="#addons-progress"></a>10.3.6. Progress and Cancel</h4>
<div class="paragraph">
<p><a id="_ix1276" class="ixterm"></a><a id="_ix1277" class="ixterm"></a>While Software works, a small window shows a progress bar. Its title, and the start of the line above the bar, say what Software is doing: <strong>Reading</strong>, <strong>Installing</strong>, <strong>Removing</strong>, <strong>Fetching</strong>, <strong>Publishing</strong>, <strong>Reading the package list</strong>, <strong>Checking for updates</strong>, or <strong>Reading your packages</strong>. The line also names the package or file Software is on.</p>
</div>
<div class="paragraph">
<p>To stop, choose <b class="button">Cancel</b> (or press <kbd>Esc</kbd>, or click the window&#8217;s close box):</p>
</div>
<div class="ulist">
<ul>
<li>
<p>Installing or removing stops after the package Software is on. A package that was still being unpacked is left exactly as it was before; one whose files were already in place is finished first. Packages done before stay installed (or removed). No message follows: the Installed page shows what is installed. When you choose <b class="button">Cancel</b> during the last package and it is finished, there was nothing left to stop, so Software says it is done, as usual.</p>
</li>
<li>
<p>A job on the package server stops at once, without a message. A download stopped part way is kept, and goes on from there the next time.</p>
</li>
</ul>
</div>
</div>
<div class="sect3">
<h4 id="addons-install-done"><a class="anchor" href="#addons-install-done"></a>10.3.7. When the install is done</h4>
<div class="paragraph">
<p><a id="_ix1278" class="ixterm"></a><a id="_ix1279" class="ixterm"></a>When everything is installed, Software says one of these:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>&#8220;Installed: <em>names</em>.&#8221;</p>
</li>
<li>
<p>&#8220;Installed: <em>names</em>. Libraries and widgets work from the next time DVX starts.&#8221; A library or widget was installed.</p>
</li>
<li>
<p>&#8220;Installed: <em>names</em>. Restart DVX to start using the new version of DVX.&#8221; DVX itself was updated.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>DVX does not restart by itself. When the message asks for it, exit DVX (see <a href="#desktop-exit">Section 5.16</a>) and start it again.</p>
</div>
<div class="paragraph">
<p><a id="_ix1280" class="ixterm"></a><a id="_ix1281" class="ixterm"></a><a id="_ix1282" class="ixterm"></a>An upgrade removes the files the old version had that the new one does not, the way removing a package does (see <a href="#addons-removing">Section 10.4</a>). A file among them that changed after it was installed, such as a data file you edited, is left. After the message that the package is installed, Software lists such files: &#8220;These files changed since they were installed, so they were left:&#8221;, the files, and &#8220;Delete them too?&#8221; <b class="button">Yes</b> deletes them; <b class="button">No</b> leaves them where they are. A file that cannot be deleted is left too, and Software says &#8220;These files could not be deleted, so they were left:&#8221;, the files, and &#8220;A program may be using them, or the disk may be write-protected.&#8221; These messages also follow an install that did not finish, for the packages it upgraded before it stopped.</p>
</div>
<div class="paragraph">
<p><a id="_ix1283" class="ixterm"></a>New programs appear in Program Manager&#8217;s Installed Programs group. New fonts, sounds, themes, desktop pictures, and MIDI instruments appear in the lists where you choose them. MIDI instruments that an add-on installs are listed by the add-on&#8217;s name on the Control Panel&#8217;s Sounds page, except DVX General MIDI, which is listed there as <strong>Standard</strong>.</p>
</div>
<div class="paragraph">
<p>The next time DVX starts after programs or parts were added or removed, the bar on DVX&#8217;s title screen may fill a second time while the help is brought up to date.</p>
</div>
</div>
<div class="sect3">
<h4 id="addons-install-messages"><a class="anchor" href="#addons-install-messages"></a>10.3.8. When a package cannot be installed</h4>
<div class="paragraph">
<p><a id="_ix1284" class="ixterm"></a><a id="_ix1285" class="ixterm"></a><a id="_ix1286" class="ixterm"></a>If Software cannot read the package file, it says &#8220;<em>file</em> cannot be installed: <em>reason</em>&#8221;. If it can read the package but cannot install it, it says &#8220;<em>Name</em> cannot be installed. <em>reason</em>&#8221;. If something goes wrong while installing, it says &#8220;Installing did not finish. <em>Name</em>: <em>reason</em>&#8221;. The reasons, and what to do:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 50%;">
<col style="width: 50%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Reason</th>
<th class="tableblock halign-left valign-top">What it means and what to do</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>Name</em> needs <em>package name</em> <em>version</em> or later, which is not here.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1287" class="ixterm"></a>The package needs another package, at that version or later, that you do not have, and it is not in the same folder (or on the package server). Get that package, put it in the same folder, and install again.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>Name</em> needs <em>package name</em> <em>version</em> or later, but an older one is being installed.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A package installed at the same time is older than this one needs. Get a newer version of it.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>Name</em> needs DVX <em>version</em> or later (this is DVX <em>version</em>).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1288" class="ixterm"></a>The package was made for a newer DVX. Update DVX (see <a href="#addons-updates-dvx">Section 10.5.1</a>), or get a version of the package made for yours.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>Name</em> was made for a different version of DVX.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1289" class="ixterm"></a>Get a version of the package made for your DVX (see <a href="#addons-other-version">Section 10.10.2</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;This package needs a newer DVX (its manifest is format <em>n</em>).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package was made for a newer DVX. Update DVX first.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;A newer version of <em>Name</em> (<em>version</em>) is installed.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1290" class="ixterm"></a>You already have a newer version. DVX never installs an older version over a newer one. If you really want the older one, remove the newer one first.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>Name</em> is not signed by the publisher of the installed version.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1291" class="ixterm"></a>An update must be signed by whoever signed the version you have, or by DVX (see <a href="#addons-update-rule">Section 10.8.3</a>). Get the update from the publisher of the version you have.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>Name</em> says it is part of DVX, but it is not signed by DVX&#8217;s key.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1292" class="ixterm"></a>Its package name starts with <code>kpunch.</code>, but DVX&#8217;s signature is missing or does not fit. Copy the package&#8217;s <code>.SIG</code> file with it, or get the package again from the DVX CD or the package server.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>Name</em> is from the package server, but it is not signed. DVX installs a package from the package server only when DVX&#8217;s key signed it.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1293" class="ixterm"></a>The package server gave a package without DVX&#8217;s signature. DVX does not install it (see <a href="#addons-update-rule">Section 10.8.3</a>). Tell whoever runs the server.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>Name</em> is from the package server, but it is signed by another key, not by DVX&#8217;s. DVX installs a package from the package server only when DVX&#8217;s key signed it.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1294" class="ixterm"></a>The package carries a signature, but not DVX&#8217;s, even if it is a publisher&#8217;s key you trust. Tell whoever runs the server, or get the package from its publisher as a file.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>Name</em> is from the package server, but its signature by DVX&#8217;s key does not fit it: it was changed or damaged on the way.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1295" class="ixterm"></a>The package was changed after DVX&#8217;s key signed it. Try again; if it keeps happening, something between you and the server changes what you download.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>Name</em> has the file <em>file</em>, which belongs to <em>Other</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package would replace a file of another package you have. Remove the other package first if you no longer need it, or do without this one.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>Name</em> and <em>Other</em> both have the file <em>file</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Two of the packages being installed have the same file, so they cannot be installed together.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>Name</em> and <em>Other</em> need each other.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Each package needs the other, which DVX cannot install. Tell the publisher.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Two versions of <em>Name</em> are asked for.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Two different versions of the same package were to be installed at once. Install only one of them.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;There is not enough room on the disk: <em>Name</em> needs <em>n</em> KB and <em>m</em> KB are free.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Make room on the disk (see <a href="#addons-disk-space">Section 10.3.5</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;There is not enough memory.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1296" class="ixterm"></a>Close other programs and try again.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot read <em>path</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file cannot be read. Check the disk, or copy the file again.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>path</em> is not a DVX package (it does not start with PACKAGE.INI).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file is not a DVX package.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The signature of <em>path</em> cannot be read.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The signature inside the package is damaged. Get a fresh copy of the package.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em> is not the file the manifest lists (it was changed or damaged).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1297" class="ixterm"></a>A file in the package does not match the package&#8217;s own list of its files: it was changed or damaged. That package is left as it was before. Get a fresh copy of the package.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot write <em>file</em> (is the disk full?).&#8221; or &#8220;Cannot write <em>file</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX could not write a file into the DVX folder. Check that the disk has room and is not write-protected.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot make the folder <em>folder</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX could not make a folder in the DVX folder. Check that the disk has room and is not write-protected.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>path</em> cannot be installed: another job is running.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Software is already busy. Wait for the progress window to close, then try again.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>Name</em> cannot be installed now.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Software could not start installing. Try again.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>Other reasons that mention the manifest (the package&#8217;s own description of itself), a line number, or a file &#8220;in the package&#8221; mean that the package was not made correctly or is damaged: get a fresh copy, or tell its publisher. If putting the new files in place fails, DVX puts every file back as it was before, and the reason names the file.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="addons-removing"><a class="anchor" href="#addons-removing"></a>10.4. Removing add-ons</h3>
<div class="paragraph">
<p><a id="_ix1298" class="ixterm"></a><a id="_ix1299" class="ixterm"></a><a id="_ix1300" class="ixterm"></a>To remove an add-on:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>In Software, click the <strong>Installed</strong> tab.</p>
</li>
<li>
<p>Choose the package.</p>
</li>
<li>
<p>Choose <b class="button">Remove&#8230;&#8203;</b> (or <span class="menuseq"><b class="menu">Package</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Remove&#8230;&#8203;</b></span>).</p>
</li>
<li>
<p>Answer Software&#8217;s questions (see below).</p>
</li>
<li>
<p>A window titled <strong>Removing</strong> shows the progress. When it is done, the list is shown again without the package. There is no separate message.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p><a id="_ix1301" class="ixterm"></a>First, Software asks whether to remove the package. When no other installed package needs it, the question is &#8220;Remove <em>Name</em>?&#8221; When other installed packages need it, Software names them: &#8220;These need <em>Name</em> and are removed with it:&#8221;, their names, and &#8220;Remove them all?&#8221; Either way, <b class="button">Yes</b> goes ahead and <b class="button">No</b> removes nothing.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/adRemoveNeeds.png" alt="A question box: These need Base Theme and are removed with it: Space Theme. Remove them all? With Yes and No buttons">
</div>
<div class="title">Figure 51. Software asking about the packages that need the one being removed</div>
</div>
<div class="paragraph">
<p><a id="_ix1302" class="ixterm"></a>Next, if some packages were installed only because the ones being removed needed them (you did not choose them yourself, and nothing else needs them), Software offers them: &#8220;These were installed for <em>Name</em> and nothing else needs them:&#8221;, their names, and &#8220;Remove them too?&#8221; <b class="button">Yes</b> removes them as well; <b class="button">No</b> keeps them. This is how removing a part of DVX removes its programs and libraries (see <a href="#addons-parts-remove">Section 10.9.2</a>).</p>
</div>
<div class="paragraph">
<p><a id="_ix1303" class="ixterm"></a>Files that changed after they were installed, such as a data file you edited, are not deleted. Once the package is removed, Software lists them: &#8220;These files changed since they were installed, so they were left:&#8221;, the files (named from the DVX folder, such as <code>APPS\ACME\CHESS\CHESS.APP</code>), and &#8220;Delete them too?&#8221; <b class="button">Yes</b> deletes them; <b class="button">No</b> leaves them where they are.</p>
</div>
<div class="paragraph">
<p><a id="_ix1304" class="ixterm"></a>A file that cannot be deleted, for example because a program is using it or the disk is write-protected, is left in place too. Software then says &#8220;These files could not be deleted, so they were left:&#8221;, the files, and &#8220;A program may be using them, or the disk may be write-protected.&#8221; The same message names a changed file that <b class="button">Yes</b> to &#8220;Delete them too?&#8221; could not delete. Close the program, or make the disk writable, and delete the files with File Manager.</p>
</div>
<div class="paragraph">
<p>A file that another package also has is left in place. Folders the package made are removed when they end up empty.</p>
</div>
<div class="paragraph">
<p><a id="_ix1305" class="ixterm"></a>You cannot remove DVX itself with Software: it says &#8220;DVX itself is removed with Setup.&#8221; See <a href="#installing-remove">Section 3.9</a>.</p>
</div>
<div class="paragraph">
<p>If removing cannot start, Software says &#8220;<em>Name</em> cannot be removed now.&#8221; If it does not finish (other than after <b class="button">Cancel</b>), Software says &#8220;Removing did not finish. <em>reason</em>&#8221;, where the reason is, for example, one of these:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>&#8220;<em>Name</em>: <em>package name</em> is not installed.&#8221; The package was already gone.</p>
</li>
<li>
<p>&#8220;<em>Name</em>: Cannot remove <em>path</em>.&#8221; DVX could not delete the package&#8217;s record in the <code>SYSTEM\PACKAGES</code> folder. Check that the disk is not write-protected.</p>
</li>
</ul>
</div>
</div>
<div class="sect2">
<h3 id="addons-updates"><a class="anchor" href="#addons-updates"></a>10.5. Keeping DVX and your add-ons up to date</h3>
<div class="paragraph">
<p><a id="_ix1306" class="ixterm"></a><a id="_ix1307" class="ixterm"></a><a id="_ix1308" class="ixterm"></a><a id="_ix1309" class="ixterm"></a>The <strong>Updates</strong> page asks the package server what it has that is newer than the packages you have, DVX itself included. It needs the Networking part and a working network connection.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/adUpdates.png" alt="Software&#8217;s Updates page, saying 2 updates are ready to install, listing DVX and one add-on">
</div>
<div class="title">Figure 52. The Updates page, with an update of DVX itself at the top</div>
</div>
<div class="paragraph">
<p>To update everything:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>In Software, click the <strong>Updates</strong> tab. The first time you show the page after starting Software, it asks the server; a window titled <strong>Checking for updates</strong> shows the progress. (Software does not check by itself when it starts.)</p>
</li>
<li>
<p>Read the line above the list: &#8220;Everything is up to date.&#8221;, or &#8220;<em>n</em> updates are ready to install.&#8221; (or &#8220;1 update is ready to install.&#8221;).</p>
</li>
<li>
<p>Choose <b class="button">Update All</b> (or <span class="menuseq"><b class="menu">Package</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Update All</b></span>). Software fetches everything listed, with anything those packages need, and shows the <strong>Install Software</strong> window.</p>
</li>
<li>
<p>Choose <b class="button">Install</b>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>When DVX itself is listed, it is at the top. <b class="button">Check for Updates</b> (or <span class="menuseq"><b class="menu">Package</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Check for Updates</b></span>) asks the server again. With nothing listed, <b class="button">Update All</b> just says &#8220;Everything is up to date.&#8221; If the server cannot be reached, the line above the list says &#8220;The package server could not be reached.&#8221; and a message gives the reason.</p>
</div>
<div class="paragraph">
<p><a id="_ix1310" class="ixterm"></a>There is no button to update just one package on this page. To update one, find it on the Available page and choose <b class="button">Install</b>: the Available page offers the newest version, so installing it upgrades the one you have.</p>
</div>
<div class="paragraph">
<p>In messages about Update All, the updates are named by the package&#8217;s name when there is one update, and as &#8220;The updates&#8221; when there are several, for example &#8220;The updates cannot be installed: <em>reason</em>&#8221;.</p>
</div>
<div class="paragraph">
<p>An update must be signed by the same publisher as the version you have, or by DVX (see <a href="#addons-update-rule">Section 10.8.3</a>).</p>
</div>
<div class="sect3">
<h4 id="addons-updates-dvx"><a class="anchor" href="#addons-updates-dvx"></a>10.5.1. Updating DVX itself</h4>
<div class="paragraph">
<p><a id="_ix1311" class="ixterm"></a><a id="_ix1312" class="ixterm"></a>DVX itself is a package (named DVX, package name <code>kpunch.dvx</code>), so a newer DVX on the package server is offered on the Updates page, at the top of the list. DVX Fonts and the parts of DVX you have are offered there too when the server has newer versions.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/adUpdatePlan.png" alt="The Install Software window listing DVX and an add-on as upgrades signed By DVX, with the note that DVX itself is updated">
</div>
<div class="title">Figure 53. The Install Software window when DVX itself is updated</div>
</div>
<div class="paragraph">
<p><a id="_ix1313" class="ixterm"></a>When the update includes DVX itself, the <strong>Install Software</strong> window says &#8220;DVX itself is updated: the new version runs from the next time DVX starts.&#8221; If some of your add-ons were made for the DVX you have and will stop working with the new one, the window names them before anything is installed: &#8220;These add-ons stop working with the new DVX until they are updated: <em>names</em>.&#8221; Update them too, or choose <b class="button">Cancel</b> and keep the DVX you have.</p>
</div>
<div class="paragraph">
<p>After the install, Software says &#8220;Installed: <em>names</em>. Restart DVX to start using the new version of DVX.&#8221; Exit DVX and start it again.</p>
</div>
<div class="paragraph">
<p>You can also update DVX from a newer DVX CD or set of floppy disks, with Setup&#8217;s <strong>Upgrade or repair DVX</strong> (see <a href="#installing-upgrade">Section 3.8</a>).</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="addons-server"><a class="anchor" href="#addons-server"></a>10.6. The package server</h3>
<div class="paragraph">
<p><a id="_ix1314" class="ixterm"></a><a id="_ix1315" class="ixterm"></a>The package server is a web server on the network that offers DVX packages. Software uses it for its Available, Updates, and Published pages. DVX&#8217;s own package server is <code>packages.dvxgui.com</code>, on port 80; you can choose another one in the <strong>Package Server</strong> window. What a server offers is up to whoever runs it.</p>
</div>
<div class="paragraph">
<p>To reach a package server, DVX needs the Networking part and a working network connection: a network card, its packet driver, and the settings on the Control Panel&#8217;s Network page (see <a href="#net-setup">Section 4.4</a> and <a href="#cpanel-network">Section 7.9</a>). Without the Networking part, Software still installs packages from files (see <a href="#addons-offline">Section 10.2.8</a>).</p>
</div>
<div class="sect3">
<h4 id="addons-server-window"><a class="anchor" href="#addons-server-window"></a>10.6.1. The Package Server window</h4>
<div class="paragraph">
<p><a id="_ix1316" class="ixterm"></a><a id="_ix1317" class="ixterm"></a><a id="_ix1318" class="ixterm"></a>To choose the package server, or to give your account there, choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Package Server&#8230;&#8203;</b></span> in Software. The window says &#8220;The package server Software gets packages from (leave both empty for DVX&#8217;s own):&#8221; and has these boxes:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Address</strong></dt>
<dd>
<p>The server&#8217;s name, such as <code>packages.dvxgui.com</code>. You can also type it as <code>http://packages.dvxgui.com/</code>; Software takes the name from it. <a id="_ix1319" class="ixterm"></a>DVX reaches package servers over plain web connections only, without encryption, so an address that starts with <code>https://</code> is refused: Software says &#8220;DVX reaches package servers over plain http only (it has no encryption). Type the address without https://.&#8221;</p>
</dd>
<dt class="hdlist1"><strong>Port</strong></dt>
<dd>
<p>The server&#8217;s port, a number from 1 to 65535. Port 80 is the usual one.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>Below, the window says &#8220;Your account there, to publish packages (leave it empty if you have none):&#8221; and has:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Email</strong></dt>
<dd>
<p><a id="_ix1320" class="ixterm"></a>The email address you registered with on the server.</p>
</dd>
<dt class="hdlist1"><strong>Password</strong></dt>
<dd>
<p>The account&#8217;s password. Each letter shows as a mask character.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p><a id="_ix1321" class="ixterm"></a>The boxes are not empty when the window opens: they show the settings in use. Until you change them, they show DVX&#8217;s own server, <code>packages.dvxgui.com</code>, and port 80. To go back to DVX&#8217;s own server later, empty both the <strong>Address</strong> and the <strong>Port</strong> box and choose <b class="button">OK</b>. When you choose <b class="button">OK</b> with DVX&#8217;s own server (empty, or typed as <code>packages.dvxgui.com</code>) and port 80, Software keeps both settings empty in <code>DVX.INI</code>, so that if DVX&#8217;s own server ever moves, a newer DVX&#8217;s address for it is used.</p>
</div>
<div class="paragraph">
<p>Choose <b class="button">OK</b> to save the settings, or <b class="button">Cancel</b> to leave them as they were. After a change, the Available, Updates, and Published pages are emptied, and read again from the new server when you show them.</p>
</div>
<div class="paragraph">
<p><a id="_ix1322" class="ixterm"></a>If the port is not a number from 1 to 65535, Software says &#8220;The port is a number from 1 to 65535, or empty for the usual one.&#8221; Correct it, or empty the box. If the settings cannot be saved, Software says &#8220;The package server cannot be saved in DVX&#8217;s settings.&#8221;</p>
</div>
<div class="paragraph">
<p><a id="_ix1323" class="ixterm"></a>The settings are kept in <code>DVX.INI</code> in your user folder, in the <code>[packages]</code> section (as <code>server</code>, <code>port</code>, <code>user</code>, and <code>password</code>), so each user folder has its own (see <a href="#folders-dvx-ini">Section B.2</a>).</p>
</div>
<div class="paragraph">
<p><a id="_ix1324" class="ixterm"></a>You need the account only to publish packages; getting and updating packages needs no account. Software keeps the password scrambled, so it cannot be read at a glance. Scrambled is not locked: someone who has the settings file and knows how DVX scrambles it can still read the password, so give it only on a computer you trust. A password typed into <code>DVX.INI</code> by hand is used as it is, and scrambled the next time Software saves the settings.</p>
</div>
</div>
<div class="sect3">
<h4 id="addons-server-how"><a class="anchor" href="#addons-server-how"></a>10.6.2. How Software uses the package server</h4>
<div class="paragraph">
<p><a id="_ix1325" class="ixterm"></a>DVX talks to the package server over plain web connections (<code>http://</code>), not secure ones. That is why DVX never trusts the server itself, only the signatures on the packages: every package from the package server must be signed with DVX&#8217;s own key. A package that was changed on the way over the network no longer fits that signature, so Software refuses to install it (see <a href="#addons-update-rule">Section 10.8.3</a>).</p>
</div>
<div class="ulist">
<ul>
<li>
<p><strong>The catalogue.</strong> For the Available page, Software reads the list of every package the server offers, at its newest version. It reads it the first time you show the page, and again when you choose <b class="button">Refresh</b>.</p>
</li>
<li>
<p><strong>The updates.</strong> For the Updates page, Software tells the server which packages and versions you have, and the server answers with what it has that is newer. Software asks the first time you show the page, and again when you choose <b class="button">Check for Updates</b>.</p>
</li>
<li>
<p><strong>Fetching.</strong> When you install from the Available or Updates page, Software downloads the packages, checks each one&#8217;s size and fingerprint against the server&#8217;s list, and fetches its signature with it (see <a href="#addons-from-server">Section 10.3.2</a>).</p>
</li>
<li>
<p><strong>Your packages.</strong> With your account, Software sends packages you publish and reads the list of what you have published (see <a href="#addons-publishing">Section 10.7</a>).</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>Each of these jobs shows the progress window; <b class="button">Cancel</b> stops it at once.</p>
</div>
<div class="paragraph">
<p>DVX&#8217;s own parts and add-ons can be published on a package server too, so that their newer versions are offered as updates, and parts you do not have can be offered on the Available page.</p>
</div>
</div>
<div class="sect3">
<h4 id="addons-server-messages"><a class="anchor" href="#addons-server-messages"></a>10.6.3. Messages from the package server</h4>
<div class="paragraph">
<p><a id="_ix1326" class="ixterm"></a><a id="_ix1327" class="ixterm"></a><a id="_ix1328" class="ixterm"></a>When a job on the package server fails, Software shows one of these messages:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 50%;">
<col style="width: 50%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Message</th>
<th class="tableblock halign-left valign-top">What it means and what to do</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The package server cannot be reached: <em>reason</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1329" class="ixterm"></a>DVX could not talk to the server. The reason comes from the network, for example &#8220;Cannot find <em>host</em> on the network.&#8221;, &#8220;Cannot connect to <em>host</em>: <em>why</em>.&#8221;, &#8220;<em>host</em> did not answer in time (<em>n</em> seconds).&#8221;, &#8220;<em>host</em> closed the connection without answering.&#8221;, or &#8220;Lost the connection to <em>host</em>: <em>why</em>.&#8221; Check the address in the <strong>Package Server</strong> window and the network connection (see <a href="#trouble-network">Section 11.9</a>), then try again.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>what</em>: the package server answered <em>code</em> (<em>reason</em>).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The server refused a request, and gives its reason in brackets when it has one. <em>what</em> says which request: &#8220;its catalogue&#8221;, &#8220;the updates&#8221;, a package&#8217;s name, &#8220;a signature&#8221;, &#8220;Signing in&#8221;, the file being published, or &#8220;The list of your packages&#8221;.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The package server does not know that email and password.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1330" class="ixterm"></a>Check the <strong>Email</strong> and <strong>Password</strong> in the <strong>Package Server</strong> window.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The package server gave no session when signing in.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Signing in to the server did not complete. Try again later.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;No account is set for the package server.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Give your account in the <strong>Package Server</strong> window.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The package server&#8217;s answer cannot be read: <em>why</em>&#8221;, &#8220;The package server&#8217;s answer has no list of packages.&#8221;, or &#8220;The package server&#8217;s list of your packages cannot be read.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The server&#8217;s answer was not what DVX expected. Check that the address in the <strong>Package Server</strong> window is a DVX package server.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>package name</em> is not offered by the package server.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The server no longer offers that package. Choose <b class="button">Refresh</b> on the Available page.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>Name</em> cannot be installed: the package server has no signature of it by DVX&#8217;s key.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1331" class="ixterm"></a>The server lists the package without DVX&#8217;s signature, so Software does not fetch it: DVX would not install it (see <a href="#addons-update-rule">Section 10.8.3</a>). Tell whoever runs the server.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Packages cannot be fetched: the path of the DOWNLOAD folder in your user folder is too long.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Your user folder&#8217;s path is too long to hold its <code>DOWNLOAD</code> folder. Use a user folder nearer the top of the drive (see <a href="#trouble-files-dvxuser">Section 11.12.7</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>Name</em> was damaged on the way. Try again.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package fetched did not match what the server listed. Try again.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The download of <em>Name</em> cannot be read.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The downloaded file cannot be read. Try again.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>Name</em> cannot be saved in <em>folder</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The download cannot be saved in the <code>DOWNLOAD</code> folder in your user folder. Check that the disk has room.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em> cannot be read.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package file you chose to publish cannot be read.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The package server&#8217;s address is too long.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Shorten the address in the <strong>Package Server</strong> window.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;There is not enough memory.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Close other programs and try again.</p></td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="sect2">
<h3 id="addons-publishing"><a class="anchor" href="#addons-publishing"></a>10.7. Publishing your own packages</h3>
<div class="paragraph">
<p><a id="_ix1332" class="ixterm"></a><a id="_ix1333" class="ixterm"></a><a id="_ix1334" class="ixterm"></a>You can offer a package you made to every DVX user through the package server. Making the package is the job of Package Builder (in the Developer Tools part) or of DVX BASIC&#8217;s <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Make Package&#8230;&#8203;</b></span> (see <a href="#programs-developer">Section 8.13</a>). Software sends the finished package to the server; Package Builder has no publish command of its own.</p>
</div>
<div class="paragraph">
<p><a id="_ix1335" class="ixterm"></a>First you need an account on the package server: register on the server&#8217;s web site, and open the link it sends to your email. Then give the account to Software:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>In Software, choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Package Server&#8230;&#8203;</b></span>.</p>
</li>
<li>
<p>Type your <strong>Email</strong> and <strong>Password</strong>, and choose <b class="button">OK</b>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>To publish a package:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>In Software, choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Publish a Package&#8230;&#8203;</b></span>, or the <b class="button">Publish a Package&#8230;&#8203;</b> button on the Published page.</p>
</li>
<li>
<p>In the <strong>Publish a Package</strong> dialog box, open the package&#8217;s <code>.DPK</code> file.</p>
</li>
<li>
<p>Software reads the package, then sends it to the server. A window titled <strong>Publishing</strong> shows the progress.</p>
</li>
<li>
<p>When the server has taken it, Software says &#8220;<em>Name</em> <em>Version</em> is on the package server, waiting for its review. The Published page shows how the review goes.&#8221; and shows the Published page.</p>
</li>
</ol>
</div>
<div class="imageblock">
<div class="content">
<img src="images/adPublished.png" alt="A message: Moon Theme 1.0.0 is on the package server, waiting for its review. The Published page shows how the review goes.">
</div>
<div class="title">Figure 54. The message after publishing a package</div>
</div>
<div class="paragraph">
<p><a id="_ix1336" class="ixterm"></a>The server checks the package as DVX would before installing it, and holds it for review. Once the server&#8217;s operator approves it, it is listed on everyone&#8217;s Available page, and offered on the Updates page to those who have an older version. Watch the <strong>State</strong> column on the Published page (see <a href="#addons-published-page">Section 10.2.5</a>): &#8220;Waiting for review&#8221;, &#8220;Published&#8221;, &#8220;Turned down&#8221; (the <strong>Note</strong> says why), or &#8220;Withdrawn&#8221;.</p>
</div>
<div class="paragraph">
<p><a id="_ix1337" class="ixterm"></a>If you have not given an account, Software says &#8220;To publish a package, give your account on the package server in File &gt; Package Server first.&#8221; If Software cannot read the package, it says &#8220;<em>file</em> cannot be published: <em>reason</em>&#8221;, with the same reasons as for installing (see <a href="#addons-install-messages">Section 10.3.8</a>). A wrong email or password gives &#8220;The package server does not know that email and password.&#8221;</p>
</div>
<div class="paragraph">
<p>When the server refuses a package, Software says &#8220;<em>file</em>: the package server answered <em>code</em> (<em>reason</em>).&#8221;, where <em>code</em> is a number and the reason comes from the server. A package that fails the server&#8217;s check gets the reason the check gives. DVX&#8217;s own server also keeps these rules, with the reasons shown:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>A package name belongs to the account that first published it, so publish its later versions from the same account. Otherwise: &#8220;<em>package name</em> belongs to another account&#8221;.</p>
</li>
<li>
<p>A version you have already uploaded cannot be uploaded again: &#8220;<em>package name</em> <em>version</em> has been uploaded already: give the new one a higher version&#8221;. Give each new version a higher version number, since only a newer version is offered as an update.</p>
</li>
<li>
<p>Package names that start with <code>kpunch.</code> are DVX&#8217;s own, and only the server&#8217;s operator uploads them: &#8220;<em>package name</em> is one of DVX&#8217;s own packages: only the operator uploads those&#8221;.</p>
</li>
</ul>
</div>
</div>
<div class="sect2">
<h3 id="addons-signatures"><a class="anchor" href="#addons-signatures"></a>10.8. Signatures and trusted publishers</h3>
<div class="paragraph">
<p><a id="_ix1338" class="ixterm"></a><a id="_ix1339" class="ixterm"></a><a id="_ix1340" class="ixterm"></a>A publisher can sign a package with a key, a little like a seal on a letter: if the package is changed after it was signed, the seal no longer fits. A signature tells you who signed the package, and that nobody has changed it since.</p>
</div>
<div class="paragraph">
<p><a id="_ix1341" class="ixterm"></a>A key is two files: <code>NAME.KEY</code>, which the publisher gives out, and <code>NAME.SEC</code>, the secret one they sign with and keep to themselves. You only ever need the <code>.KEY</code> file.</p>
</div>
<div class="paragraph">
<p>DVX trusts packages signed with:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><a id="_ix1342" class="ixterm"></a><strong>DVX&#8217;s own key</strong>, named DVX Repository. It comes with DVX as <code>SYSTEM\KEYS\KPUNCH.KEY</code> in the DVX folder, and always stays trusted. On DVX&#8217;s own package server, every approved version is signed with this key, so packages from it show as &#8220;By DVX&#8221;. DVX installs a package from any package server only when it is signed with this key.</p>
</li>
<li>
<p><strong>The keys of publishers you chose to trust</strong>, kept in the <code>KEYS</code> folder in your user folder (see <a href="#addons-trust-key">Section 10.8.4</a>). Another user folder used with the same DVX does not trust them.</p>
</li>
</ul>
</div>
<div class="sect3">
<h4 id="addons-signed-column"><a class="anchor" href="#addons-signed-column"></a>10.8.1. What the Signed column means</h4>
<div class="paragraph">
<p><a id="_ix1343" class="ixterm"></a>The <strong>Signed</strong> column of the <strong>Install Software</strong> window shows how far DVX trusts each package:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 80%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Signed</th>
<th class="tableblock halign-left valign-top">Meaning</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>By DVX</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Signed with DVX&#8217;s own key.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Trusted</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Signed with the key of a publisher you chose to trust.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>No</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Not signed, signed with a key you do not trust, or the signature does not fit because the package was changed after it was signed. DVX shows all three the same way.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>A package from the package server is never shown as &#8220;No&#8221;: unless DVX&#8217;s own key signed it, Software refuses it before the window opens (see <a href="#addons-update-rule">Section 10.8.3</a>).</p>
</div>
<div class="paragraph">
<p>After a package is installed, the <strong>Signed by</strong> row of its details names the trusted key that signed it (see <a href="#addons-details">Section 10.2.7</a>). A package signed with a key you do not trust shows &#8220;a key you did not trust when it was installed (not checked)&#8221; there instead, and one whose signature does not fit shows &#8220;a key you trusted, but its signature did not fit: the package was changed after it was signed&#8221;. An unsigned package shows &#8220;nobody&#8221;.</p>
</div>
</div>
<div class="sect3">
<h4 id="addons-unsigned"><a class="anchor" href="#addons-unsigned"></a>10.8.2. Unsigned packages</h4>
<div class="paragraph">
<p><a id="_ix1344" class="ixterm"></a><a id="_ix1345" class="ixterm"></a>A package from a file that is marked &#8220;No&#8221; can still be installed. The <strong>Install Software</strong> window warns you first: &#8220;Not signed by a publisher DVX trusts: <em>names</em>. Install them only if you trust where they came from.&#8221; Choose <b class="button">Install</b> only if you trust where the package came from; otherwise choose <b class="button">Cancel</b>.</p>
</div>
<div class="paragraph">
<p>Whatever the signature, every file is checked against the package&#8217;s own list as it is unpacked. A changed or damaged file stops the install with &#8220;<em>file</em> is not the file the manifest lists (it was changed or damaged).&#8221;</p>
</div>
</div>
<div class="sect3">
<h4 id="addons-update-rule"><a class="anchor" href="#addons-update-rule"></a>10.8.3. Rules DVX always keeps</h4>
<div class="paragraph">
<p><a id="_ix1346" class="ixterm"></a><a id="_ix1347" class="ixterm"></a>DVX refuses a package, whatever you answer, in these cases:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>A package whose package name starts with <code>kpunch.</code> must be signed with DVX&#8217;s own key. Otherwise: &#8220;<em>Name</em> says it is part of DVX, but it is not signed by DVX&#8217;s key.&#8221;</p>
</li>
<li>
<p><a id="_ix1348" class="ixterm"></a><a id="_ix1349" class="ixterm"></a>A package from the package server must be signed with DVX&#8217;s own key, whoever published it and whatever the server says about it: a key you trust is not enough. Otherwise Software says why: &#8220;<em>Name</em> is from the package server, but it is not signed. DVX installs a package from the package server only when DVX&#8217;s key signed it.&#8221;, &#8220;<em>Name</em> is from the package server, but it is signed by another key, not by DVX&#8217;s. DVX installs a package from the package server only when DVX&#8217;s key signed it.&#8221;, or &#8220;<em>Name</em> is from the package server, but its signature by DVX&#8217;s key does not fit it: it was changed or damaged on the way.&#8221; A package the server lists without DVX&#8217;s signature is not even fetched: &#8220;<em>Name</em> cannot be installed: the package server has no signature of it by DVX&#8217;s key.&#8221; Packages you install from a file, and the add-ons Setup installs from the CD, keep the rules for files.</p>
</li>
<li>
<p>An update of a package you have must be signed by whoever signed the version you have (with a key you trust), or with DVX&#8217;s own key. That way nobody else can replace a package with one of their own. Otherwise: &#8220;<em>Name</em> is not signed by the publisher of the installed version.&#8221; A package you installed without a trusted signature can be updated by any package of the same package name.</p>
</li>
</ul>
</div>
</div>
<div class="sect3">
<h4 id="addons-trust-key"><a class="anchor" href="#addons-trust-key"></a>10.8.4. Trusting a publisher&#8217;s key</h4>
<div class="paragraph">
<p><a id="_ix1350" class="ixterm"></a><a id="_ix1351" class="ixterm"></a><a id="_ix1352" class="ixterm"></a>To trust the packages a publisher signs:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Get the publisher&#8217;s key file (its name ends in <code>.KEY</code>) from them.</p>
</li>
<li>
<p>In Software, choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Trust a Publisher&#8217;s Key&#8230;&#8203;</b></span>.</p>
</li>
<li>
<p>In the <strong>Trust a Publisher&#8217;s Key</strong> dialog box, open the key file. The dialog lists <code>Publisher Keys (*.key)</code>; choose <code>All Files (*.*)</code> to see every file.</p>
</li>
<li>
<p>Software copies the key into the <code>KEYS</code> folder in your user folder and says &#8220;Packages signed with this key are trusted from now on.&#8221;</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>Software does not ask before it trusts the key, so open only a key you got from the publisher.</p>
</div>
<div class="paragraph">
<p><a id="_ix1353" class="ixterm"></a>If the key cannot be trusted, Software says &#8220;The key cannot be trusted: <em>reason</em>&#8221;, where the reason is one of these:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>&#8220;Cannot read <em>path</em>.&#8221; The file cannot be read.</p>
</li>
<li>
<p>&#8220;This is not a [key] file (or it lacks part of one).&#8221; The file is not a key file, or part of it is missing.</p>
</li>
<li>
<p>&#8220;The key&#8217;s id is not its public key&#8217;s.&#8221;, &#8220;Line <em>n</em> is not a [section] or a key = value line.&#8221;, &#8220;Line <em>n</em>: <em>field</em> is given twice.&#8221;, or &#8220;Line <em>n</em>: <em>field</em> must be <em>count</em> hex digits.&#8221; The key file was changed or damaged. Get it again from the publisher.</p>
</li>
<li>
<p>&#8220;Cannot copy the key to <em>folder</em>.&#8221; The <code>KEYS</code> folder in your user folder cannot be written to. Check that the disk has room and is not write-protected.</p>
</li>
<li>
<p>&#8220;The path of the KEYS folder is too long.&#8221; Your user folder&#8217;s path is too long. Use a shorter one.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p><a id="_ix1354" class="ixterm"></a>If you make your own key with Package Builder&#8217;s <b class="button">New Key&#8230;&#8203;</b> button, it is saved in your <code>KEYS</code> folder to start with, so the DVX you made it on trusts it too.</p>
</div>
</div>
<div class="sect3">
<h4 id="addons-untrust-key"><a class="anchor" href="#addons-untrust-key"></a>10.8.5. Removing a trusted key</h4>
<div class="paragraph">
<p><a id="_ix1355" class="ixterm"></a><a id="_ix1356" class="ixterm"></a>Software has no command to stop trusting a key. DVX trusts every <code>.KEY</code> file in the <code>KEYS</code> folder in your user folder, so to stop trusting a publisher, delete their key file from that folder, for example <code>C:\DVX\USER\KEYS\ACME.KEY</code>, with File Manager (see <a href="#programs-file-manager">Section 8.3</a>).</p>
</div>
<div class="paragraph">
<p>DVX&#8217;s own key, <code>KPUNCH.KEY</code> in the <code>SYSTEM\KEYS</code> folder of the DVX folder, is not one of yours. DVX needs it to install its own packages and their updates, so leave it where it is.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="addons-parts"><a class="anchor" href="#addons-parts"></a>10.9. The optional parts of DVX</h3>
<div class="paragraph">
<p><a id="_ix1357" class="ixterm"></a><a id="_ix1358" class="ixterm"></a><a id="_ix1359" class="ixterm"></a>DVX comes in parts. The desktop and the everyday programs (Program Manager, File Manager, Notepad, Clock, the Image Viewer, DVX Help, Control Panel, and Software) are always installed. Each of the seven optional parts is a bundle package: Setup installs the ones you tick, and Software lists each one as a single row of kind <code>bundle</code>. A part you leave out takes no disk space and leaves more memory for your programs. No part needs another part.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 22.2222%;">
<col style="width: 22.2222%;">
<col style="width: 55.5556%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Part</th>
<th class="tableblock halign-left valign-top">Package name</th>
<th class="tableblock halign-left valign-top">What it holds</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>kpunch.basic</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Write your own programs: the BASIC editor, compiler, and debugger, with its guides.&#8221; Holds the DVX BASIC IDE and the BASIC Compiler (with BASCOMP for the DOS prompt).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Databases</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>kpunch.data</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;SQLite databases for BASIC programs, with the Data control and the DBGrid that show them.&#8221; Holds SQLite, the Data Control, and DBGrid.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Networking</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>kpunch.net</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Network cards (with their DOS packet driver), the web, and the package server.&#8221; Holds Network, HTTP, and Package Server.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Communications</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>kpunch.comm</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The Terminal: modems, serial and secure links, Telnet (with Networking), and file transfers.&#8221; Holds Terminal, the Terminal Control, Connections, Secure Link, and File Transfer.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Media</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>kpunch.media</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The Media Player and the Sound Recorder.&#8221;</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Developer Tools</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>kpunch.devtools</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The Icon, Resource, and Help Editors, Package Builder, and Widget Showcase, with DVXRES and DVXHLPC for the DOS prompt.&#8221;</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Demos</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>kpunch.demos</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The DVX Demo and the BASIC Demo.&#8221;</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix1360" class="ixterm"></a>To see what a part holds, choose it on Software&#8217;s Installed page and choose <b class="button">Details&#8230;&#8203;</b>: its <strong>Needs</strong> row lists the packages in it, by package name. Those packages are not listed separately on the Installed page.</p>
</div>
<div class="sect3">
<h4 id="addons-parts-add"><a class="anchor" href="#addons-parts-add"></a>10.9.1. Adding a part after Setup</h4>
<div class="paragraph">
<p><a id="_ix1361" class="ixterm"></a><a id="_ix1362" class="ixterm"></a>To add a part you left out:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Run Setup from the DVX CD or Disk 1 of the floppy disks. Tick <strong>I accept the licence</strong>, choose <b class="button">Next &gt;</b>, and choose <b class="button">Upgrade or repair DVX</b>.</p>
</li>
<li>
<p>Choose the folder DVX is in, and choose <b class="button">Next &gt;</b>.</p>
</li>
<li>
<p>On the next page, under &#8220;Parts of DVX to have (an unticked one is removed):&#8221;, tick the part you want. Leave the parts you have ticked.</p>
</li>
<li>
<p>Choose <b class="button">Upgrade</b>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>See <a href="#installing-upgrade">Section 3.8</a> for the whole of Setup.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/adSetupParts.png" alt="Setup&#8217;s page with the fonts to install, the parts of DVX to have, and the add-ons to install, each with a box to tick">
</div>
<div class="title">Figure 55. Setup&#8217;s page of fonts, parts, and add-ons, when upgrading</div>
</div>
<div class="paragraph">
<p><a id="_ix1363" class="ixterm"></a>The Networking part can only be added with Setup: Software needs Networking to reach the package server, and the parts are not on the CD as separate package files. Once you have Networking, a package server that offers DVX&#8217;s parts can offer the ones you do not have on the Available page; install them as any other package.</p>
</div>
</div>
<div class="sect3">
<h4 id="addons-parts-remove"><a class="anchor" href="#addons-parts-remove"></a>10.9.2. Removing a part</h4>
<div class="paragraph">
<p><a id="_ix1364" class="ixterm"></a>To remove a part with Software:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>On the Installed page, choose the part (its kind is <code>bundle</code>).</p>
</li>
<li>
<p>Choose <b class="button">Remove&#8230;&#8203;</b> and answer <b class="button">Yes</b> to &#8220;Remove <em>part</em>?&#8221;</p>
</li>
<li>
<p>Software asks &#8220;These were installed for <em>part</em> and nothing else needs them:&#8221;, lists the part&#8217;s programs and libraries, and asks &#8220;Remove them too?&#8221; Answer <b class="button">Yes</b> to remove them. If you answer <b class="button">No</b>, only the part&#8217;s own row goes, and its programs stay installed, each listed on its own on the Installed page.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>You can also remove a part with Setup: run it, choose <strong>Upgrade or repair DVX</strong>, and untick the part. A part that other software in the DVX folder needs is kept, and Setup says &#8220;Other software in <em>folder</em> needs these parts, so Setup keeps them: <em>parts</em>.&#8221; If Setup is cancelled while removing, it says &#8220;Setup was cancelled: <em>part</em> is not all removed. Software (in Program Manager) can remove it.&#8221;</p>
</div>
</div>
<div class="sect3">
<h4 id="addons-parts-networking"><a class="anchor" href="#addons-parts-networking"></a>10.9.3. What needs Networking</h4>
<div class="paragraph">
<p><a id="_ix1365" class="ixterm"></a><a id="_ix1366" class="ixterm"></a>Only these need the Networking part:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>Software&#8217;s package server: the Available, Updates, and Published pages, the <strong>Package Server</strong> window, and publishing. Without Networking, Software installs packages from files only (see <a href="#addons-offline">Section 10.2.8</a>).</p>
</li>
<li>
<p>Terminal&#8217;s Telnet and the secure link over a network. Without Networking, Terminal says &#8220;Telnet and the secure link over the network need Networking, which is not installed. Setup can add it.&#8221; (see <a href="#terminal-connecting">Section 9.5</a>).</p>
</li>
<li>
<p>The Control Panel&#8217;s Network page, which otherwise shows &#8220;Networking is not installed.&#8221; (see <a href="#cpanel-network">Section 7.9</a>).</p>
</li>
<li>
<p>DVX BASIC programs that use the network.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>The Communications part does not need Networking. Without it, Terminal still works over modems and serial ports, with file transfers and the secure link over a serial line.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="addons-trouble"><a class="anchor" href="#addons-trouble"></a>10.10. When an add-on causes trouble</h3>
<div class="paragraph">
<p><a id="_ix1367" class="ixterm"></a><a id="_ix1368" class="ixterm"></a>DVX loads the libraries and widgets that add-ons installed as it starts. This section explains what happens when one of them cannot be loaded, and how to start DVX without them. See also <a href="#trouble-addons">Section 11.11</a>.</p>
</div>
<div class="sect3">
<h4 id="addons-left-out"><a class="anchor" href="#addons-left-out"></a>10.10.1. Add-ons left out at start-up</h4>
<div class="paragraph">
<p><a id="_ix1369" class="ixterm"></a><a id="_ix1370" class="ixterm"></a>If DVX cannot load an add-on&#8217;s library or widget, it starts without it. Once the desktop is up, a message titled <strong>Add-ons</strong> lists each one it left out, as &#8220;<em>file</em> was not loaded: <em>why</em>.&#8221;, and ends with &#8220;The Software program can reinstall or remove an add-on.&#8221; The rest of DVX works as usual. The reasons, and what to do:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 50%;">
<col style="width: 50%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Why</th>
<th class="tableblock halign-left valign-top">What to do</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;its file is damaged, or it needs something this DVX does not have&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Reinstall the add-on with Software, or get a version made for your DVX.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;it needs <em>name</em>, which is not installed&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Install the package it needs, or reinstall the add-on together with what it needs.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;it needs <em>file</em>, which was not loaded&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Something else it needs was left out too. Deal with that one first.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;it was made for a different version of DVX&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">See <a href="#addons-other-version">Section 10.10.2</a>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em> has the same name&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The add-on has a file with the same name as another library or widget, of DVX&#8217;s own or of another add-on. Remove the add-on, or the other add-on.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;it needs files that in turn need it or each other, so none of them can be loaded&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The add-on and the libraries or widgets it needs need each other, so none of them can be loaded first. Remove the add-on, or tell its publisher.</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect3">
<h4 id="addons-other-version"><a class="anchor" href="#addons-other-version"></a>10.10.2. Add-ons made for another version of DVX</h4>
<div class="paragraph">
<p><a id="_ix1371" class="ixterm"></a><a id="_ix1372" class="ixterm"></a>Packages of programs, libraries, widgets, and screen savers are made for a particular version of DVX; fonts, sounds, and other files are not. Software will not install an add-on made for another version: it says &#8220;<em>Name</em> was made for a different version of DVX.&#8221; or &#8220;<em>Name</em> needs DVX <em>version</em> or later (this is DVX <em>version</em>).&#8221; When you update DVX itself, the <strong>Install Software</strong> window names the add-ons you have that stop working with the new DVX (see <a href="#addons-updates-dvx">Section 10.5.1</a>).</p>
</div>
<div class="paragraph">
<p>If a library or widget made for another version of DVX is installed anyway, for example because you updated DVX but not the add-on, DVX does not stop. It starts without that add-on and says so in the <strong>Add-ons</strong> message, with the reason &#8220;it was made for a different version of DVX&#8221;. Update the add-on on Software&#8217;s Updates page, install a version made for your DVX, or remove it.</p>
</div>
</div>
<div class="sect3">
<h4 id="addons-safe-start"><a class="anchor" href="#addons-safe-start"></a>10.10.3. Starting without add-ons</h4>
<div class="paragraph">
<p><a id="_ix1373" class="ixterm"></a><a id="_ix1374" class="ixterm"></a>If DVX does not start at all after you installed something, start it without its add-on libraries and widgets:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Start DVX while holding down a <kbd>Shift</kbd> key, from when you press <kbd>Enter</kbd> until the desktop appears. Or type <code>DVX /SAFE</code> at the DOS prompt.</p>
</li>
<li>
<p>DVX starts in safe video mode, without any add-on libraries or widgets. It asks whether to use the safe video mode from now on; answer <b class="button">No</b> to keep your usual screen mode (see <a href="#installing-safe-start">Section 3.13</a>).</p>
</li>
<li>
<p>Once the desktop is up, a message titled <strong>Add-ons</strong> says &#8220;DVX was started in safe mode, so no add-on libraries or widgets were loaded.&#8221; (It appears only when there were add-ons to leave out.)</p>
</li>
<li>
<p>Start Software and remove the add-on that causes the trouble (see <a href="#addons-removing">Section 10.4</a>).</p>
</li>
<li>
<p>Exit DVX and start it the usual way.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p><a id="_ix1375" class="ixterm"></a>Software notes each package it installs, removes, or publishes in DVX&#8217;s log file, which can help you find out what was installed last (see <a href="#folders-log">Section B.6</a>).</p>
</div>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="troubleshooting"><a class="anchor" href="#troubleshooting"></a>Chapter 11. Troubleshooting</h2>
<div class="sectionbody">
<div class="paragraph">
<p><a id="_ix1376" class="ixterm"></a><a id="_ix1377" class="ixterm"></a>This chapter helps when something goes wrong: DVX does not start, the screen or the mouse does not work, there is no sound, nothing prints, the network cannot be reached, a program stops responding, or a message appears that you do not understand.</p>
</div>
<div class="paragraph">
<p>The chapter is arranged by what you see. Find the section that matches your problem and work through its steps in order; the first steps are the ones most likely to help. Each problem gives the exact message DVX shows, what it means, what usually causes it, and what to do.</p>
</div>
<div class="paragraph">
<p><a id="_ix1378" class="ixterm"></a>If you have a message on the screen, the quickest way in is the alphabetical list of messages at the end of the chapter, <a href="#trouble-messages">Section 11.17</a>. Every message explained here is listed there, with a link to the place that explains it.</p>
</div>
<div class="sect2">
<h3 id="trouble-first-steps"><a class="anchor" href="#trouble-first-steps"></a>11.1. First steps for any problem</h3>
<div class="paragraph">
<p>Whatever the problem, these steps help you find out what is wrong and get DVX working again.</p>
</div>
<div class="sect3">
<h4 id="trouble-first-message"><a class="anchor" href="#trouble-first-message"></a>11.1.1. Read the message</h4>
<div class="paragraph">
<p><a id="_ix1379" class="ixterm"></a><a id="_ix1380" class="ixterm"></a><a id="_ix1381" class="ixterm"></a>When DVX or a program has a problem, it usually says so in a message box. Read the whole message before you click a button: most messages say what went wrong and what to do about it. If you need to look the message up, write down its exact words first.</p>
</div>
<div class="paragraph">
<p>Message boxes have a picture at the left that tells you what kind of message it is:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 25%;">
<col style="width: 75%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Picture</th>
<th class="tableblock halign-left valign-top">Kind of message</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">An X in a circle</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">An error: something could not be done. The box has an <b class="button">OK</b> button. When the program gives no title of its own, the title is <strong>Error</strong>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">An exclamation mark in a triangle</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A warning: something needs your attention, such as a printer that is out of paper.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">A question mark in a circle</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A question: the buttons are the answers, such as <b class="button">Yes</b> and <b class="button">No</b>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">The letter i in a circle</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Information: something you should know. The title is <strong>Information</strong> unless the program gives its own.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix1382" class="ixterm"></a><a id="_ix1383" class="ixterm"></a>In every message box, <kbd>Enter</kbd> presses the first button and <kbd>Esc</kbd> presses the last one. Closing the box without choosing a button counts as <b class="button">Cancel</b>.</p>
</div>
<div class="paragraph">
<p><a id="_ix1384" class="ixterm"></a><a id="_ix1385" class="ixterm"></a>Many DVX programs, and many programs you install, are written in DVX BASIC. When such a program gives its message box no title, the title is the program&#8217;s name, as Program Manager shows it, and a box with only an <b class="button">OK</b> button may have no picture. (The Resource Editor reports its problems in its status line instead.)</p>
</div>
<div class="paragraph">
<p><a id="_ix1386" class="ixterm"></a>Some problems stop DVX before the desktop appears. The message is then printed as plain text on the DOS screen, and DVX returns to the DOS prompt. DVX switches the screen back to text so you can read it. The log file usually records the same problem (see <a href="#trouble-log">Section 11.16</a>).</p>
</div>
<div class="paragraph">
<p><a id="_ix1387" class="ixterm"></a>In this chapter, a part of a message that changes, such as a file name, is shown in <em>italics</em>. A message that the box shows on several lines is shown here as one line.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-first-safe"><a class="anchor" href="#trouble-first-safe"></a>11.1.2. Try a safe start</h4>
<div class="paragraph">
<p><a id="_ix1388" class="ixterm"></a><a id="_ix1389" class="ixterm"></a>If DVX does not start, or starts with a screen you cannot read, start it in safe start: hold down a <kbd>Shift</kbd> key while DVX starts, or type <code>DVX /SAFE</code> at the DOS prompt. DVX then starts in safe video mode (640x480), which every video card can show, and leaves out the libraries and widgets that add-on packages installed. See <a href="#trouble-safe-start">Section 11.2.8</a>.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-first-log"><a class="anchor" href="#trouble-first-log"></a>11.1.3. Look in the log file</h4>
<div class="paragraph">
<p><a id="_ix1390" class="ixterm"></a>DVX writes a record of what it does, and of what goes wrong, to the file <code>DVX.LOG</code> in your USER folder (usually <code>C:\DVX\USER\DVX.LOG</code>; System Information says where). It is the place to look when something fails without a message, such as a sound card that stays silent. DVX empties the file each time it starts, so copy it before you start DVX again. See <a href="#trouble-log">Section 11.16</a>.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-first-defaults"><a class="anchor" href="#trouble-first-defaults"></a>11.1.4. Go back to the default settings</h4>
<div class="paragraph">
<p><a id="_ix1391" class="ixterm"></a><a id="_ix1392" class="ixterm"></a>A setting that does not suit your computer, such as a screen mode the monitor cannot show, can be undone by going back to the settings DVX came with. Most of DVX&#8217;s settings are in <code>DVX.INI</code> in your USER folder: delete that file and DVX makes a fresh copy the next time it starts. See <a href="#trouble-settings">Section 11.15</a> for this and the other settings files.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-first-stuck"><a class="anchor" href="#trouble-first-stuck"></a>11.1.5. End a program that is stuck</h4>
<div class="paragraph">
<p><a id="_ix1393" class="ixterm"></a><a id="_ix1394" class="ixterm"></a>If a program stops reacting to the mouse and the keyboard, press <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Esc</kbd></span> to open the Task Manager, select the program, and click <b class="button">End Task</b>. The other programs keep running. See <a href="#trouble-programs-hang">Section 11.13.3</a>.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-first-needs"><a class="anchor" href="#trouble-first-needs"></a>11.1.6. Check what DVX needs</h4>
<div class="paragraph">
<p><a id="_ix1395" class="ixterm"></a><a id="_ix1396" class="ixterm"></a>Many problems come from something the computer does not have, or a driver that is not loaded. DVX needs:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>An 80486DX processor or newer, that is, a 486 with a math coprocessor (486DX, DX2, DX4, or any Pentium). A 486SX needs a 487 coprocessor. DVX does not run on a 386.</p>
</li>
<li>
<p>DOS 5.0 or later, such as MS-DOS or FreeDOS.</p>
</li>
<li>
<p>A video card with a VESA video BIOS and a mode of at least 640x480 with 256 colors or more. Many older cards need their VESA driver loaded first (see <a href="#trouble-start-vesa">Section 11.2.2</a>).</p>
</li>
<li>
<p>4 MB of extended memory; 8 MB or more is recommended.</p>
</li>
<li>
<p>A two-button mouse with its DOS mouse driver loaded before DVX starts.</p>
</li>
<li>
<p>About 14 MB of free disk space for all of DVX (10 MB without its optional parts), 8 MB more for the base set of fonts, and more for add-ons.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>See <a href="#req-computer">Section 2.2</a> and <a href="#req-video">Section 2.3</a> for the details.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-first-sysinfo"><a class="anchor" href="#trouble-first-sysinfo"></a>11.1.7. Find out about your computer</h4>
<div class="paragraph">
<p><a id="_ix1397" class="ixterm"></a><a id="_ix1398" class="ixterm"></a>DVX can show what it found in your computer. In Program Manager, choose <span class="menuseq"><b class="menu">Help</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">System Information&#8230;&#8203;</b></span> to open the <strong>System Information</strong> window. It lists the processor, the memory, the DOS version, the TEMP folder, the video card and its memory, how DVX reaches the video memory, the mouse and its wheel, and the drives, as they are when you open the window: the free memory and disk space are those of that moment. At the end it says where the log file is (see <a href="#trouble-log-where">Section 11.16.1</a>). If DVX could not gather anything, a box says &#8220;No system information available.&#8221;</p>
</div>
<div class="paragraph">
<p>Some lines in it answer common questions:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Line</th>
<th class="tableblock halign-left valign-top">What it tells you</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Mouse: Not detected</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1399" class="ixterm"></a>No DOS mouse driver was loaded when DVX started. See <a href="#trouble-mouse">Section 11.4</a>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Mouse: Detected (<em>n</em> buttons)</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The mouse driver is loaded, and the mouse has <em>n</em> buttons.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Wheel: Yes (CuteMouse Wheel API)</code> or <code>Wheel: No</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Whether the mouse driver can report the scroll wheel.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Video memory access: linear</code> or <code>Video memory access: banked, <em>n</em> KB window</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">How DVX draws on the screen. Banked access works but is slower (see <a href="#trouble-start-banked">Section 11.2.3</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Largest free block</code>, <code>Total physical</code>, <code>Free physical</code>, and <code>Paging file</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">How much memory the computer has, and how much is free.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>DVX also writes the same information into the log file each time it starts, between the lines <code>=== System Information ===</code> and <code>=== End System Information ===</code>.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-first-dos-files"><a class="anchor" href="#trouble-first-dos-files"></a>11.1.8. Change AUTOEXEC.BAT or CONFIG.SYS</h4>
<div class="paragraph">
<p><a id="_ix1400" class="ixterm"></a><a id="_ix1401" class="ixterm"></a>Many remedies in this chapter ask you to add a line to <code>AUTOEXEC.BAT</code> (for example to load a mouse driver or a VESA driver, or to set <code>BLASTER</code> for a Sound Blaster) or to change <code>CONFIG.SYS</code> (for memory). Both are plain text files in the main folder of the drive the computer starts from, usually <code>C:\</code>. DOS reads them each time the computer starts. To change one:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Leave DVX, so you are at the DOS prompt.</p>
</li>
<li>
<p>Keep a copy of the file as it is, so you can go back to it. For example, type <code>COPY C:\AUTOEXEC.BAT C:\AUTOEXEC.BAK</code> and press <kbd>Enter</kbd>.</p>
</li>
<li>
<p>Open the file in a text editor, for example by typing <code>EDIT C:\AUTOEXEC.BAT</code>.</p>
</li>
<li>
<p>Add or change the line. In <code>AUTOEXEC.BAT</code>, put lines that load drivers or set values such as <code>BLASTER</code> before the line that starts DVX, if there is one.</p>
</li>
<li>
<p>Save the file and leave the editor.</p>
</li>
<li>
<p>Restart the computer, so that DOS reads the file again. Then start DVX.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>A value set with the <code>SET</code> command, such as <code>SET BLASTER=A220 I5 D1 H5</code>, can also be typed at the DOS prompt before you start DVX, to try it out. It lasts until the computer is restarted.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="trouble-start"><a class="anchor" href="#trouble-start"></a>11.2. DVX will not start</h3>
<div class="paragraph">
<p><a id="_ix1402" class="ixterm"></a><a id="_ix1403" class="ixterm"></a>This section covers the problems that can happen from the moment you type <code>DVX</code> until the Program Manager appears: the messages DVX prints on the DOS screen, the video card, damaged or mismatched files, memory, safe start, and add-ons that cannot be loaded.</p>
</div>
<div class="sect3">
<h4 id="trouble-start-normal"><a class="anchor" href="#trouble-start-normal"></a>11.2.1. What a normal start looks like</h4>
<div class="paragraph">
<p><a id="_ix1404" class="ixterm"></a>It helps to know what DVX does when all is well:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>DVX changes to the folder it is installed in, so you can start it from any folder by typing its full name, for example <code>C:\DVX\DVX</code>.</p>
</li>
<li>
<p>A title screen appears, with a bar that fills from left to right while DVX loads. <a id="_ix1405" class="ixterm"></a>The bar can fill a second time: DVX is then rebuilding its help files, because libraries or widgets were added or removed since the last start. This takes a little longer, once.</p>
</li>
<li>
<p>The screen changes to the desktop, and the Program Manager opens.</p>
</li>
<li>
<p>Any messages from the start appear: the <strong>Safe Video Mode</strong> question (before the Program Manager opens), a note that DVX runs from a disk it cannot write to, and the <strong>Add-ons</strong> box. The Welcome window opens after them the first time you start DVX.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p><a id="_ix1406" class="ixterm"></a><a id="_ix1407" class="ixterm"></a>Pressing <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>C</kbd></span> or <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Break</kbd></span> does not stop DVX.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-start-vesa"><a class="anchor" href="#trouble-start-vesa"></a>11.2.2. DVX says the video card has no usable mode</h4>
<div class="paragraph">
<p><a id="_ix1408" class="ixterm"></a><a id="_ix1409" class="ixterm"></a><a id="_ix1410" class="ixterm"></a><a id="_ix1411" class="ixterm"></a><a id="_ix1412" class="ixterm"></a>DVX draws its desktop in a graphics mode it gets from the video card&#8217;s VESA video BIOS. When it cannot get one, DVX prints this and returns to DOS:</p>
</div>
<div class="paragraph">
<p>&#8220;DVX could not start: the video card offered no usable graphics mode. DVX needs a VESA video BIOS with a mode of at least 640x480 at 256 colors or more. Many older cards need their VESA driver loaded first: UniVBE (Scitech Display Doctor) works with most cards, and some cards came with their own, such as S3VBE20 for S3 cards and M64VBE for ATI Mach64 cards. The details are in DVX.LOG in the USER folder.&#8221;</p>
</div>
<div class="paragraph">
<p>One or more lines starting with <code>VBE:</code> come before it and say why. DVX first tries the screen mode it is set to use, then safe video mode (640x480), so you may see a line twice.</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><a id="_ix1413" class="ixterm"></a>&#8220;VBE: No VESA BIOS extension (VBE) found&#8221;</dt>
<dd>
<p>The video card has no VESA video BIOS, or its VESA driver is not loaded. Load the driver as described below.</p>
</dd>
<dt class="hdlist1"><a id="_ix1414" class="ixterm"></a>&#8220;VBE: No suitable mode found for <em>width</em>x<em>height</em> (VBE <em>version</em>)&#8221;</dt>
<dd>
<p>The card offers no mode at least as large as <em>width</em> by <em>height</em> with 256 colors or more. <em>version</em> is the VESA version the card reports, such as 1.2 or 2.0. If you see it only for the mode DVX is set to use, DVX goes on in safe video mode and asks about it (see <a href="#trouble-video-safe">Section 11.3.2</a>). If you see it for 640x480 too, load the card&#8217;s VESA driver.</p>
</dd>
<dt class="hdlist1"><a id="_ix1415" class="ixterm"></a>&#8220;VBE: Could not use mode 0x<em>number</em> (<em>width</em>x<em>height</em> at <em>bits</em> bpp)&#8221;</dt>
<dd>
<p>The card listed the mode but refused to set it, or DVX could not reach the card&#8217;s video memory. <em>number</em> is the card&#8217;s own number for the mode, and <em>bits</em> is the number of bits per dot (8, 15, 16, or 32). Load or update the VESA driver, or choose another mode.</p>
</dd>
<dt class="hdlist1"><a id="_ix1416" class="ixterm"></a><a id="_ix1417" class="ixterm"></a>&#8220;VBE: Failed to allocate <em>n</em> byte backbuffer&#8221; or &#8220;VBE: Failed to allocate palette&#8221;</dt>
<dd>
<p>There is not enough memory for the screen mode. DVX keeps a copy of the whole screen in memory, and a large mode with many colors needs a lot: 1024x768 with 16 million colors needs about 3 MB. Free memory (see <a href="#trouble-start-memory">Section 11.2.6</a>), or use a smaller mode with fewer colors.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>To load the VESA driver:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Find the VESA driver for your video card. UniVBE (Scitech Display Doctor) works with most cards. Some cards came with their own, such as S3VBE20 for S3 cards and M64VBE for ATI Mach64 cards.</p>
</li>
<li>
<p>Add a line that runs the driver to <code>AUTOEXEC.BAT</code>, before the line that starts DVX (see <a href="#trouble-first-dos-files">Section 11.1.8</a>). To try it first, type the driver&#8217;s name at the DOS prompt and press <kbd>Enter</kbd>.</p>
</li>
<li>
<p>Start DVX again.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p><a id="_ix1418" class="ixterm"></a>DVX uses modes with 256 colors (8 bits per dot), 32 thousand colors (15 bits), 65 thousand colors (16 bits), and 16 million colors (32 bits). It does not use 24-bit modes, so a card whose only modes with 16 million colors are 24-bit is used with 256 or 65 thousand colors instead.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-start-banked"><a class="anchor" href="#trouble-start-banked"></a>11.2.3. The screen works, but it is slow (older video cards)</h4>
<div class="paragraph">
<p><a id="_ix1419" class="ixterm"></a><a id="_ix1420" class="ixterm"></a><a id="_ix1421" class="ixterm"></a>An older video card, such as one whose VESA BIOS is version 1.x, may not let DVX reach all of its video memory at once. DVX then draws through a small window into the video memory (usually 64 KB). Everything works, but the screen updates more slowly.</p>
</div>
<div class="paragraph">
<p>You can see which way DVX uses: System Information shows <code>Video memory access: banked, <em>n</em> KB window</code> instead of <code>Video memory access: linear</code>, and in the log file the line starting <code>Video:</code> says <code>banked</code> instead of <code>linear frame buffer</code>.</p>
</div>
<div class="paragraph">
<p>To speed it up:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Load a VESA driver such as UniVBE. It often gives older cards direct (linear) access to their memory.</p>
</li>
<li>
<p>Use fewer colors or a smaller resolution (see <a href="#trouble-video-choose">Section 11.3.3</a>). More colors and higher resolutions mean more to draw.</p>
</li>
</ol>
</div>
</div>
<div class="sect3">
<h4 id="trouble-start-damaged"><a class="anchor" href="#trouble-start-damaged"></a>11.2.4. DVX says a file could not be loaded</h4>
<div class="paragraph">
<p><a id="_ix1422" class="ixterm"></a><a id="_ix1423" class="ixterm"></a><a id="_ix1424" class="ixterm"></a>When one of DVX&#8217;s own files is damaged, missing something it needs, or left over from another version of DVX, DVX prints this and returns to DOS:</p>
</div>
<div class="paragraph">
<p>&#8220;FATAL: <em>file</em> could not be loaded: <em>reason</em>. Run Setup and choose Upgrade or repair to fix DVX.&#8221;</p>
</div>
<div class="paragraph">
<p><em>file</em> is the file&#8217;s place in the DVX folder, such as a file in <code>LIBS\KPUNCH</code> or <code>WIDGETS\KPUNCH</code>. <em>reason</em> is one of these:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Reason</th>
<th class="tableblock halign-left valign-top">What it means</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;its file is damaged, or it needs something this DVX does not have&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file cannot be read, or it was made for a DVX with something this one lacks.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;it was made for a different version of DVX&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file is from an older or newer DVX, for example after an upgrade that did not finish, or files copied by hand.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;it needs <em>name</em>, which is not installed&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Another file it needs is missing.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;it needs <em>name</em>, which was not loaded&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Another file it needs could not be loaded either. Look for that file&#8217;s own line.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;it needs files that in turn need it or each other, so none of them can be loaded&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Some of DVX&#8217;s files each need another to be loaded first, which happens when files from different versions of DVX are mixed. The log file has a <code>FAILED:</code> line for each of them.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix1425" class="ixterm"></a>&#8220;No modules loaded from LIBS\ or WIDGETS\&#8221; means DVX found none of its files. <code>DVX.EXE</code> was copied somewhere else on its own, or the <code>LIBS</code> and <code>WIDGETS</code> folders beside it were deleted. Start the <code>DVX.EXE</code> in the folder where DVX is installed.</p>
</div>
<div class="paragraph">
<p>DVX can also return to DOS with no message at all, when the part of DVX that runs the desktop is missing. The log file then ends with a line starting <code>ERROR:</code>, or with <code>Failed to initialize task system</code>.</p>
</div>
<div class="paragraph">
<p>For all of these, repair DVX:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Start Setup from the DVX CD or from Disk 1 of the DVX floppy disks (the copy of Setup in the DVX folder can only remove DVX).</p>
</li>
<li>
<p>Choose <strong>Upgrade or repair DVX</strong>, with the folder DVX is in.</p>
</li>
<li>
<p>Leave <strong>Start over: also remove my settings and saved files</strong> unticked, so your settings and saved files in the USER folder are kept.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>See <a href="#installing-upgrade">Section 3.8</a>.</p>
</div>
<div class="admonitionblock note">
<table>
<tr>
<td class="icon">
<div class="title">Note</div>
</td>
<td class="content">
Only DVX&#8217;s own files stop DVX this way. A library or widget that an add-on package installed is left out instead, and DVX tells you about it once the desktop is up (see <a href="#trouble-start-addons">Section 11.2.9</a>).
</td>
</tr>
</table>
</div>
</div>
<div class="sect3">
<h4 id="trouble-start-desktop"><a class="anchor" href="#trouble-start-desktop"></a>11.2.5. DVX starts, then closes: the Program Manager cannot be loaded</h4>
<div class="paragraph">
<p><a id="_ix1426" class="ixterm"></a><a id="_ix1427" class="ixterm"></a><a id="_ix1428" class="ixterm"></a>If the desktop appears with a box titled <strong>Error</strong> that says &#8220;Failed to load <em>file</em>: <em>reason</em>&#8221;, and DVX returns to DOS when you click <b class="button">OK</b>, DVX could not start the Program Manager. <em>file</em> is the program&#8217;s file, such as <code>progman.app</code>; the second line is a short technical reason.</p>
</div>
<div class="paragraph">
<p>The causes are a wrong <code>desktop</code> line in the <code>[shell]</code> section of <code>DVX.INI</code>, or a damaged Program Manager. To fix it:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Open <code>DVX.INI</code> in your USER folder in a text editor (for example <code>EDIT C:\DVX\USER\DVX.INI</code>).</p>
</li>
<li>
<p>In the <code>[shell]</code> section, the line should read <code>desktop = apps/kpunch/progman/progman.app</code>. Correct it, or delete the line so that DVX uses the Program Manager.</p>
</li>
<li>
<p>If the line was right, run Setup and choose <strong>Upgrade or repair DVX</strong>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>You can also delete <code>DVX.INI</code> from the USER folder to go back to all the settings DVX came with (see <a href="#trouble-settings">Section 11.15</a>).</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-start-memory"><a class="anchor" href="#trouble-start-memory"></a>11.2.6. Memory messages before the title screen</h4>
<div class="paragraph">
<p><a id="_ix1429" class="ixterm"></a><a id="_ix1430" class="ixterm"></a><a id="_ix1431" class="ixterm"></a><a id="_ix1432" class="ixterm"></a><a id="_ix1433" class="ixterm"></a><code>DVX.EXE</code> has a small memory helper built into it, which prepares the computer&#8217;s memory before DVX itself starts. You need no separate program for it. If it cannot do its job, it prints a message on the DOS screen. Most of these messages appear before the title screen, and DVX does not start; the ones about the swap file can also appear later:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Message</th>
<th class="tableblock halign-left valign-top">What it means and what to do</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1434" class="ixterm"></a>&#8220;80386 required.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The processor is far too old. DVX needs an 80486DX or newer; there is nothing to change.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1435" class="ixterm"></a>A message starting &#8220;Load error:&#8221; with &#8220;no DOS memory&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Not enough conventional memory (the first 640 KB) is free. Free some, as described below.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1436" class="ixterm"></a>A message starting &#8220;Load error:&#8221; with &#8220;no DPMI memory&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Not enough extended memory is free. Check that <code>HIMEM.SYS</code> (or another extended memory manager) is loaded in <code>CONFIG.SYS</code>, and that a RAM disk or disk cache is not taking all the extended memory.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1437" class="ixterm"></a>A message starting &#8220;Load error:&#8221; with &#8220;not EXE&#8221; or &#8220;not COFF (Check for viruses)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>DVX.EXE</code> is damaged. Repair DVX with Setup (see <a href="#trouble-start-damaged">Section 11.2.4</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1438" class="ixterm"></a>&#8220;Protected mode not accessible.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Another program already controls the processor in a way DVX cannot share, such as a multitasker or another program that runs in protected mode. Start DVX from plain DOS, without that program.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1439" class="ixterm"></a>&#8220;Error: Using XMS switched CPU into V86 mode.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The memory manager (such as EMM386) is set to AUTO mode. Remove the <code>AUTO</code> option from its line in <code>CONFIG.SYS</code>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1440" class="ixterm"></a>&#8220;Error: could not allocate page table memory&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Less than 16 KB of conventional memory is free. Free some, as described below.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1441" class="ixterm"></a>&#8220;Warning: cannot open swap file c:\cwsdpmi.swp&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The helper could not make its swap file on drive C:, where it moves memory out to disk when memory runs short. Check that drive C: has free space and can be written to; DOS may also have run out of file handles (the <code>FILES=</code> line in <code>CONFIG.SYS</code> sets how many).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1442" class="ixterm"></a>&#8220;No swap space!&#8221; or &#8220;Swap disk full!&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The helper ran out of room to move memory out to disk. Free disk space on drive C:, add memory, or run fewer programs in DVX.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>To free memory for DVX:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Make sure <code>CONFIG.SYS</code> loads <code>HIMEM.SYS</code> or another extended memory manager.</p>
</li>
<li>
<p>If <code>CONFIG.SYS</code> loads <code>EMM386</code> (or a similar memory manager), make sure its line does not use the <code>AUTO</code> option.</p>
</li>
<li>
<p>Load drivers and resident programs into upper memory where you can: <code>DEVICEHIGH</code> instead of <code>DEVICE</code> in <code>CONFIG.SYS</code>, and <code>LOADHIGH</code> (or <code>LH</code>) in front of programs in <code>AUTOEXEC.BAT</code>.</p>
</li>
<li>
<p>Leave out drivers and resident programs you do not need while using DVX.</p>
</li>
<li>
<p>If you use a RAM disk or a disk cache, make it smaller, so it leaves extended memory for DVX.</p>
</li>
<li>
<p>Restart the computer, and type <code>MEM</code> at the DOS prompt to see how much memory is free.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p><a id="_ix1443" class="ixterm"></a>Some parts of DVX need conventional memory as they start: a sound card needs some for its sound buffer, and a network card about 26 KB for its packets. If those report a shortage in the log file, the same steps help.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-start-crash"><a class="anchor" href="#trouble-start-crash"></a>11.2.7. DVX stops while starting</h4>
<div class="paragraph">
<p><a id="_ix1444" class="ixterm"></a><a id="_ix1445" class="ixterm"></a><a id="_ix1446" class="ixterm"></a>If something goes wrong inside DVX itself while it starts, DVX returns to DOS and prints:</p>
</div>
<div class="paragraph">
<p>&#8220;DVX stopped while starting: something went wrong inside DVX itself. Start DVX again with a safe start: hold down a Shift key while it starts, or type DVX /SAFE. If DVX still stops, run Setup and choose Upgrade or repair to fix DVX.&#8221;</p>
</div>
<div class="paragraph">
<p><a id="_ix1447" class="ixterm"></a>On the next line, &#8220;The details are in <em>file</em>.&#8221; names the log file, unless DVX could not write one.</p>
</div>
<div class="paragraph">
<p>A program that crashes while DVX starts, such as one in Program Manager&#8217;s Startup group, does not stop DVX: DVX ends that program with the <strong>Application Error</strong> message (see <a href="#trouble-programs-crash">Section 11.13.4</a>) and goes on starting.</p>
</div>
<div class="paragraph">
<p>If DVX stops this way, or the screen shows lines of technical text and numbers (it may begin &#8220;Exiting due to signal&#8221;), or the computer stops responding:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Restart the computer if it does not respond.</p>
</li>
<li>
<p>Before you start DVX again, copy the log file <code>DVX.LOG</code> from the USER folder to another name, so its record of the problem is kept (see <a href="#trouble-log">Section 11.16</a>). Look for a line <code>=== CRASH ===</code> in it.</p>
</li>
<li>
<p>Start DVX in safe start (see <a href="#trouble-safe-start">Section 11.2.8</a>). If that works, the cause is the screen mode or an add-on: see the next section.</p>
</li>
<li>
<p>If DVX still fails, repair it with Setup (see <a href="#trouble-start-damaged">Section 11.2.4</a>), and send the log file with a problem report.</p>
</li>
</ol>
</div>
</div>
<div class="sect3">
<h4 id="trouble-safe-start"><a class="anchor" href="#trouble-safe-start"></a>11.2.8. Safe start</h4>
<div class="paragraph">
<p><a id="_ix1448" class="ixterm"></a><a id="_ix1449" class="ixterm"></a><a id="_ix1450" class="ixterm"></a><a id="_ix1451" class="ixterm"></a>A safe start is the way to start DVX when it will not start normally, or when the screen cannot be read. To make one, do either of these:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>Hold down either <kbd>Shift</kbd> key while DVX starts, from the moment you press <kbd>Enter</kbd> after <code>DVX</code> until the desktop appears.</p>
</li>
<li>
<p>Type <code>DVX /SAFE</code> at the DOS prompt and press <kbd>Enter</kbd>. (Upper or lower case does not matter.)</p>
</li>
</ul>
</div>
<div class="paragraph">
<p><a id="_ix1452" class="ixterm"></a><a id="_ix1453" class="ixterm"></a>In a safe start, DVX:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>Starts the screen in safe video mode: 640x480 with 65 thousand colors, or the nearest mode the video card has. It then asks whether to keep that mode (see <a href="#trouble-video-safe">Section 11.3.2</a>).</p>
</li>
<li>
<p>Leaves out every library and widget that an add-on package installed, in case one of them is what stops DVX from starting. DVX&#8217;s own files load as usual. If there were any add-ons to leave out, a box titled <strong>Add-ons</strong> says &#8220;DVX was started in safe mode, so no add-on libraries or widgets were loaded.&#8221;</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>The programs in Program Manager&#8217;s Startup group still start in a safe start.</p>
</div>
<div class="paragraph">
<p>To use your add-ons again, start DVX the usual way. If DVX then fails again, the cause is an add-on: start in safe start once more and remove the add-on with Software (see <a href="#addons-removing">Section 10.4</a>). If it is the screen mode, answer <b class="button">Yes</b> to the Safe Video Mode question.</p>
</div>
<div class="paragraph">
<p><a id="_ix1454" class="ixterm"></a>If a program in the Startup group causes trouble every time DVX starts, delete its icon from the Startup group (the program itself stays installed). See <a href="#progman-groups">Section 6.3</a>.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-start-addons"><a class="anchor" href="#trouble-start-addons"></a>11.2.9. DVX says add-ons were not loaded</h4>
<div class="paragraph">
<p><a id="_ix1455" class="ixterm"></a><a id="_ix1456" class="ixterm"></a><a id="_ix1457" class="ixterm"></a>When a library or widget that an add-on package installed cannot be loaded, DVX starts without it. Once the desktop is up, a box titled <strong>Add-ons</strong> lists each file it left out, as &#8220;<em>file</em> was not loaded: <em>reason</em>.&#8221;, and ends with &#8220;The Software program can reinstall or remove an add-on.&#8221; The rest of DVX works as usual.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<caption class="title">Table 6. The Add-ons box shows every file DVX left out, and why</caption>
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Reason</th>
<th class="tableblock halign-left valign-top">What it means</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;its file is damaged, or it needs something this DVX does not have&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file cannot be read, or it was made for a newer DVX.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;it was made for a different version of DVX&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The add-on is for an older or newer DVX.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;it needs <em>name</em>, which is not installed&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">It needs another package that is not installed.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;it needs <em>name</em>, which was not loaded&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">It needs another file that could not be loaded either.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>other file</em> has the same name&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Another add-on, or DVX itself, has a file of the same name, so both cannot be loaded.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;it needs files that in turn need it or each other, so none of them can be loaded&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The add-on&#8217;s files each need another to be loaded first; the package is badly made.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>If the list is very long, it ends with <code>&#8230;&#8203;</code>.</p>
</div>
<div class="paragraph">
<p>What to do:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Open Software (in Program Manager&#8217;s Installed Programs group).</p>
</li>
<li>
<p>Install a version of the add-on made for this DVX, or install the package it needs, or remove the add-on. See <a href="#addons-installing">Section 10.3</a> and <a href="#addons-removing">Section 10.4</a>.</p>
</li>
<li>
<p>Start DVX again.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p><a id="_ix1458" class="ixterm"></a><a id="_ix1459" class="ixterm"></a>You can also remove a package without starting DVX, with the program <code>DVXPKG</code> in the <code>SYSTEM</code> folder:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>At the DOS prompt, change to the DVX folder, for example <code>CD C:\DVX</code>.</p>
</li>
<li>
<p>Type <code>SYSTEM\DVXPKG list</code> to list the installed packages. Each has a name such as <code>acme.chess</code> (who made it, then what it is).</p>
</li>
<li>
<p>Type <code>SYSTEM\DVXPKG remove</code> followed by the package&#8217;s name, for example <code>SYSTEM\DVXPKG remove acme.chess</code>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>If other packages need it, <code>DVXPKG</code> removes nothing and says &#8220;dvxpkg: nothing removed: needed by <em>packages</em> (-f removes them too)&#8221;. Remove those first, or add <code>-f</code> after the name (<code>SYSTEM\DVXPKG remove acme.chess -f</code>) to remove them all. A file you changed since the package was installed is kept, with the note &#8220;kept <em>file</em> (changed since it was installed)&#8221;; with <code>-f</code> it is deleted too. A file that cannot be deleted, for example because the disk is write-protected, is left, with the note &#8220;left <em>file</em> (it could not be deleted)&#8221;. If the package is not installed, <code>DVXPKG</code> says &#8220;dvxpkg: <em>name</em> is not installed&#8221;. <code>DVXPKG</code> cannot remove DVX itself.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-start-switches"><a class="anchor" href="#trouble-start-switches"></a>11.2.10. Starting DVX with switches</h4>
<div class="paragraph">
<p><a id="_ix1460" class="ixterm"></a><a id="_ix1461" class="ixterm"></a>You can add these to the <code>DVX</code> command at the DOS prompt (upper or lower case does not matter):</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 25%;">
<col style="width: 75%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Switch</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>/SAFE</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A safe start (see <a href="#trouble-safe-start">Section 11.2.8</a>). The same as holding down <kbd>Shift</kbd>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>/RUN=<em>program</em></code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Starts the program, or opens the document in its program, once the desktop is up, for example <code>DVX /RUN=APPS\KPUNCH\NOTEPAD\NOTEPAD.APP</code>. If it is not found, you see the same messages as when a program cannot be started (see <a href="#trouble-programs-start">Section 11.13.1</a>).</p></td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="sect2">
<h3 id="trouble-video"><a class="anchor" href="#trouble-video"></a>11.3. The screen is wrong</h3>
<div class="paragraph">
<p><a id="_ix1462" class="ixterm"></a><a id="_ix1463" class="ixterm"></a><a id="_ix1464" class="ixterm"></a>This section covers a screen that is blank or cannot be read, the <strong>Safe Video Mode</strong> question, choosing another screen mode, and other screen problems once DVX is running. If DVX does not start at all because of the video card, see <a href="#trouble-start-vesa">Section 11.2.2</a>.</p>
</div>
<div class="sect3">
<h4 id="trouble-video-blank"><a class="anchor" href="#trouble-video-blank"></a>11.3.1. The screen is blank or cannot be read after DVX starts</h4>
<div class="paragraph">
<p><a id="_ix1465" class="ixterm"></a><a id="_ix1466" class="ixterm"></a><a id="_ix1467" class="ixterm"></a>DVX starts in the screen mode it is set to use. If the video card can set that mode but the monitor cannot show it, the screen stays blank or scrambled: DVX cannot tell that the monitor shows nothing. This can happen after you connect another monitor, or copy <code>DVX.INI</code> from another computer. To fix it:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Restart DVX in safe start: hold down a <kbd>Shift</kbd> key while DVX starts, or type <code>DVX /SAFE</code> (see <a href="#trouble-safe-start">Section 11.2.8</a>).</p>
</li>
<li>
<p>DVX starts in safe video mode, 640x480, and asks whether to use it from now on. Click <b class="button">Yes</b>.</p>
</li>
<li>
<p>Later, choose a mode the monitor can show in Control Panel (see <a href="#trouble-video-choose">Section 11.3.3</a>).</p>
</li>
</ol>
</div>
<div class="paragraph">
<p><a id="_ix1468" class="ixterm"></a>You can also set the mode by hand: open <code>DVX.INI</code> in your USER folder in a text editor and change the <code>width</code>, <code>height</code>, and <code>bpp</code> lines in the <code>[video]</code> section, for example to <code>640</code>, <code>480</code>, and <code>16</code> (see <a href="#trouble-video-ini">Section 11.3.4</a>).</p>
</div>
<div class="paragraph">
<p>If the screen went wrong right after you chose a new mode in Control Panel, do nothing: after 15 seconds DVX puts the old mode back (see <a href="#trouble-video-choose">Section 11.3.3</a>).</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-video-safe"><a class="anchor" href="#trouble-video-safe"></a>11.3.2. The Safe Video Mode question</h4>
<div class="paragraph">
<p><a id="_ix1469" class="ixterm"></a><a id="_ix1470" class="ixterm"></a><a id="_ix1471" class="ixterm"></a><a id="_ix1472" class="ixterm"></a>Safe video mode is 640x480 with 65 thousand colors, or the nearest mode the video card has. DVX starts in it in two cases, and asks in a box titled <strong>Safe Video Mode</strong> whether to keep it. The question appears before the Program Manager opens.</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/trSafeVideo.png" alt="The Safe Video Mode box" width="saying that the screen mode DVX is set to use does not work on this computer" height="with Yes and No buttons">
</div>
<div class="title">Figure 56. The Safe Video Mode question after the saved screen mode did not work</div>
</div>
<div class="paragraph">
<p><a id="_ix1473" class="ixterm"></a>When the mode DVX is set to use does not work, the box says:</p>
</div>
<div class="paragraph">
<p>&#8220;The screen mode DVX is set to use (<em>width</em>x<em>height</em>, <em>bits</em>-bit color) does not work on this computer, so DVX started in safe video mode (<em>width</em>x<em>height</em>, <em>bits</em>-bit color). Use this mode from now on?&#8221;</p>
</div>
<div class="paragraph">
<p>The first mode is the one DVX is set to use; the second is the safe mode it started in. Common causes are a new video card, a <code>DVX.INI</code> copied from another computer, a VESA driver that offered the mode but is not loaded this time, not enough memory for the mode, and going back to the default settings (the <code>DVX.INI</code> that comes with DVX asks for 1024x768 with 65 thousand colors).</p>
</div>
<div class="paragraph">
<p><a id="_ix1474" class="ixterm"></a>When you asked for a safe start, the box says:</p>
</div>
<div class="paragraph">
<p>&#8220;DVX started in safe video mode (<em>width</em>x<em>height</em>, <em>bits</em>-bit color) as you asked. Use this mode from now on instead of <em>width</em>x<em>height</em>, <em>bits</em>-bit color?&#8221;</p>
</div>
<div class="paragraph">
<p>In both cases:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><b class="button">Yes</b> saves safe video mode as the mode to use from now on.</p>
</li>
<li>
<p><b class="button">No</b> changes nothing, so DVX tries its usual mode again the next time it starts. Choose <b class="button">No</b> when you know the cause and can fix it, for example by loading the VESA driver again.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p><a id="_ix1475" class="ixterm"></a>Control Panel does not save safe video mode for you either: its <b class="button">OK</b> saves the screen mode only when you choose one on its <strong>Video</strong> page (see <a href="#cpanel-video-change">Section 7.7.1</a>).</p>
</div>
<div class="paragraph">
<p><a id="_ix1476" class="ixterm"></a>If DVX cannot save your answer, a box says &#8220;The screen mode could not be saved. Change it in the Control Panel instead.&#8221; DVX could not write <code>DVX.INI</code>: the disk of the USER folder is full or cannot be written to, or <code>DVX.INI</code> exists but cannot be read, in which case DVX does not overwrite it. Make room on the disk or make the USER folder writable, then choose the mode in Control Panel.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-video-choose"><a class="anchor" href="#trouble-video-choose"></a>11.3.3. Choosing another screen mode</h4>
<div class="paragraph">
<p><a id="_ix1477" class="ixterm"></a><a id="_ix1478" class="ixterm"></a><a id="_ix1479" class="ixterm"></a><a id="_ix1480" class="ixterm"></a>The <strong>Video</strong> page of Control Panel lists every mode DVX can use on your video card, such as <code>640x480 65 thousand colors</code> and <code>1024x768 16 million colors</code>. To change the mode:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Open Control Panel (in Program Manager&#8217;s Installed Programs group) and click the <strong>Video</strong> tab.</p>
</li>
<li>
<p>Click a mode in the list, then click <b class="button">Apply Mode</b>.</p>
</li>
<li>
<p>The screen changes, and a window titled <strong>Keep this mode?</strong> asks &#8220;Keep this display mode?&#8221; with &#8220;The old mode comes back in <em>n</em> seconds.&#8221; counting down from 15.</p>
</li>
<li>
<p>If the screen looks right, click <b class="button">Keep</b>. If it does not, click <b class="button">Revert</b>, or just wait: when the count reaches 0 the old mode comes back.</p>
</li>
<li>
<p>Click <b class="button">OK</b> in Control Panel. Only then does DVX use the new mode the next time it starts.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>See <a href="#cpanel-video">Section 7.7</a> for the whole page.</p>
</div>
<div class="paragraph">
<p><a id="_ix1481" class="ixterm"></a>If a box titled <strong>Error</strong> says &#8220;Failed to change video mode.&#8221;, DVX could not set the mode you chose, and it keeps (or puts back) the old one. The card refused the mode, there is not enough memory for it, or a program is using the whole screen. Choose another mode, or close programs to free memory. When the card refused the mode, the log file has a line starting <code>VBE:</code> that says more.</p>
</div>
<div class="paragraph">
<p>Some things to know when choosing:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><a id="_ix1482" class="ixterm"></a>More colors and higher resolutions use more memory and can be slower on older computers. If memory is short, a smaller mode with fewer colors frees some.</p>
</li>
<li>
<p><a id="_ix1483" class="ixterm"></a><a id="_ix1484" class="ixterm"></a>Smooth (anti-aliased) text needs a mode with more than 256 colors. In a 256-color mode, text is drawn with sharp edges whatever the setting.</p>
</li>
</ul>
</div>
</div>
<div class="sect3">
<h4 id="trouble-video-ini"><a class="anchor" href="#trouble-video-ini"></a>11.3.4. Setting the screen mode in DVX.INI</h4>
<div class="paragraph">
<p><a id="_ix1485" class="ixterm"></a><a id="_ix1486" class="ixterm"></a>The screen mode DVX starts in is kept in the <code>[video]</code> section of <code>DVX.INI</code> in your USER folder:</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlight"><code class="language-ini" data-lang="ini">[video]
width = 1024
height = 768
bpp = 16</code></pre>
</div>
</div>
<div class="paragraph">
<p><code>width</code> and <code>height</code> are the resolution. <code>bpp</code> is the number of colors: <code>8</code> for 256 colors, <code>15</code> for 32 thousand, <code>16</code> for 65 thousand, and <code>32</code> for 16 million. DVX does not use 24-bit modes; with <code>bpp = 24</code> it picks another number of colors.</p>
</div>
<div class="paragraph">
<p>DVX picks a mode at least as large as the one asked for. It takes the number of colors asked for if the card has it at that size or larger, otherwise 65 thousand colors (or the nearest the card has), and the exact size when there is one. Without the three lines, DVX starts in 640x480 with 65 thousand colors.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-video-other"><a class="anchor" href="#trouble-video-other"></a>11.3.5. Other screen problems</h4>
<div class="dlist">
<dl>
<dt class="hdlist1"><a id="_ix1487" class="ixterm"></a><a id="_ix1488" class="ixterm"></a>A window is lost off the screen or behind others</dt>
<dd>
<p>A window cannot be dragged completely off the screen; part of it always stays in view. Press <span class="keyseq"><kbd>Alt</kbd>+<kbd>Tab</kbd></span> until the window comes to the front, or choose <span class="menuseq"><b class="menu">Window</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Cascade</b></span> in Program Manager to bring every window into view.</p>
</dd>
<dt class="hdlist1"><a id="_ix1489" class="ixterm"></a>The screen mode changed after you deleted DVX.INI</dt>
<dd>
<p>The <code>DVX.INI</code> that comes with DVX asks for 1024x768 with 65 thousand colors. Setup writes the mode it ran in when it installs DVX, so deleting your <code>DVX.INI</code> brings back the 1024x768 request, and possibly the <strong>Safe Video Mode</strong> question. Choose your mode again in Control Panel.</p>
</dd>
<dt class="hdlist1"><a id="_ix1490" class="ixterm"></a>A program that uses the whole screen does not appear</dt>
<dd>
<p>When a program, such as a game, asks for a whole-screen mode the video card does not have, DVX shows the desktop again. The log file has the line <code>Video: no <em>width</em>x<em>height</em> full-screen mode</code>. If DVX cannot set the desktop&#8217;s own mode again afterwards, the log file has <code>Video: the desktop mode could not be set again</code>; restart DVX.</p>
</dd>
<dt class="hdlist1"><a id="_ix1491" class="ixterm"></a><a id="_ix1492" class="ixterm"></a><a id="_ix1493" class="ixterm"></a>A screenshot cannot be taken or saved</dt>
<dd>
<p><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>F12</kbd></span> saves a picture of the whole screen and <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>F12</kbd></span> a picture of the inside of the active window, without its title bar, frame, and menu bar (also <strong>Screenshot&#8230;&#8203;</strong> and <strong>Window Shot&#8230;&#8203;</strong> on each window&#8217;s menu). A box titled <strong>Save Screenshot</strong> or <strong>Save Window Screenshot</strong> may say &#8220;Not enough memory to capture the image.&#8221; (close programs, or use a smaller screen mode) or &#8220;The image could not be saved.&#8221; (the disk is full or cannot be written: save it somewhere else, with a name ending in <code>.png</code> or <code>.bmp</code>).</p>
</dd>
</dl>
</div>
</div>
<div class="sect3">
<h4 id="trouble-video-desktop"><a class="anchor" href="#trouble-video-desktop"></a>11.3.6. Colors, themes, and the desktop picture</h4>
<div class="paragraph">
<p><a id="_ix1494" class="ixterm"></a><a id="_ix1495" class="ixterm"></a><a id="_ix1496" class="ixterm"></a><a id="_ix1497" class="ixterm"></a>Control Panel&#8217;s <strong>Colors</strong> and <strong>Desktop</strong> pages can show these messages, in boxes titled <strong>Error</strong>:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><a id="_ix1498" class="ixterm"></a>&#8220;Could not load wallpaper image.&#8221;</dt>
<dd>
<p>The picture you chose for the desktop is not a BMP, JPEG, PNG, or GIF picture, is damaged, or needs more memory than is free. The desktop stays as it was. Choose another picture, or close programs to free memory. If a picture you chose earlier goes missing, the desktop shows its plain color, and the log file says <code>Preferences: failed to load the wallpaper</code>.</p>
</dd>
<dt class="hdlist1"><a id="_ix1499" class="ixterm"></a>&#8220;Could not save the theme file.&#8221;</dt>
<dd>
<p><b class="button">Save As&#8230;&#8203;</b> on the Colors page could not write the theme file (it goes into the <code>THEMES</code> folder in USER unless you choose another folder): the disk is full or cannot be written to.</p>
</dd>
<dt class="hdlist1">&#8220;Theme file name is too long.&#8221;</dt>
<dd>
<p>Choose a shorter name for the theme.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>A theme file that cannot be read changes nothing when you apply or load it, and no message appears. Choose another theme.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="trouble-mouse"><a class="anchor" href="#trouble-mouse"></a>11.4. The mouse does not work</h3>
<div class="paragraph">
<p><a id="_ix1500" class="ixterm"></a><a id="_ix1501" class="ixterm"></a>DVX uses the DOS mouse driver that is loaded before it starts. It has no mouse driver of its own.</p>
</div>
<div class="sect3">
<h4 id="trouble-mouse-still"><a class="anchor" href="#trouble-mouse-still"></a>11.4.1. The pointer does not move</h4>
<div class="paragraph">
<p><a id="_ix1502" class="ixterm"></a><a id="_ix1503" class="ixterm"></a><a id="_ix1504" class="ixterm"></a><a id="_ix1505" class="ixterm"></a>If no mouse driver is loaded, DVX starts with a pointer that does not move, and gives no message. System Information (in Program Manager&#8217;s Help menu) then shows <code>Mouse: Not detected</code>. To fix it:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Leave DVX. Without a mouse, press <span class="keyseq"><kbd>Alt</kbd>+<kbd>F4</kbd></span> in Program Manager, then <kbd>Enter</kbd> to answer <b class="button">Yes</b>.</p>
</li>
<li>
<p>Load your mouse driver: type its name at the DOS prompt (for example <code>MOUSE</code> or <code>CTMOUSE</code>, depending on the driver your mouse came with).</p>
</li>
<li>
<p>Start DVX again. If the pointer moves now, add the line that loads the mouse driver to <code>AUTOEXEC.BAT</code>, before the line that starts DVX, so it is loaded every time (see <a href="#trouble-first-dos-files">Section 11.1.8</a>).</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>Until the mouse works, you can do everything with the keyboard (see <a href="#trouble-keyboard-nomouse">Section 11.5.3</a>).</p>
</div>
<div class="paragraph">
<p><a id="_ix1506" class="ixterm"></a>If the pointer stopped moving while DVX was running, and the whole screen is frozen so that the keyboard does nothing either, DVX cannot recover. Restart the computer. If only one program stopped responding, see <a href="#trouble-programs-hang">Section 11.13.3</a>.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-mouse-wheel"><a class="anchor" href="#trouble-mouse-wheel"></a>11.4.2. The scroll wheel does nothing</h4>
<div class="paragraph">
<p><a id="_ix1507" class="ixterm"></a><a id="_ix1508" class="ixterm"></a>The scroll wheel works only with a mouse driver that reports it the way CuteMouse does. System Information shows <code>Wheel: Yes (CuteMouse Wheel API)</code> when it works and <code>Wheel: No</code> when it does not. To use the wheel, load a driver that supports it, such as CuteMouse (<code>CTMOUSE</code>). Everything else works without a wheel.</p>
</div>
<div class="paragraph">
<p>If the wheel scrolls the wrong way or too far, change <strong>Scroll Wheel</strong> and <strong>Scroll Speed</strong> on Control Panel&#8217;s Mouse page (see <a href="#cpanel-mouse">Section 7.4</a>). The wheel scrolls the active window, not the window under the pointer.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-mouse-control"><a class="anchor" href="#trouble-mouse-control"></a>11.4.3. The pointer is hard to control, or double-clicks do not work</h4>
<div class="paragraph">
<p><a id="_ix1509" class="ixterm"></a><a id="_ix1510" class="ixterm"></a><a id="_ix1511" class="ixterm"></a><a id="_ix1512" class="ixterm"></a>These are set on Control Panel&#8217;s Mouse page (see <a href="#cpanel-mouse">Section 7.4</a>):</p>
</div>
<div class="ulist">
<ul>
<li>
<p>If the pointer jumps or is hard to place, set <strong>Acceleration</strong> to <strong>Off</strong>, then adjust <strong>Cursor Speed</strong>.</p>
</li>
<li>
<p>If DVX does not see your double-clicks, move <strong>Double-Click Speed</strong> toward <strong>Slow</strong>, and test it on the <b class="button">Test Area</b> button.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>The same settings are kept in the <code>[mouse]</code> section of <code>DVX.INI</code>: <code>speed</code>, <code>acceleration</code>, <code>doubleclick</code>, <code>wheel</code>, and <code>wheelspeed</code>. Deleting a line returns that setting to its default.</p>
</div>
<div class="paragraph">
<p><a id="_ix1513" class="ixterm"></a>DVX needs only the left and right buttons, so a two-button mouse is fine. A middle button, if there is one, is passed to programs that use it.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="trouble-keyboard"><a class="anchor" href="#trouble-keyboard"></a>11.5. The keyboard does not work as expected</h3>
<div class="paragraph">
<p><a id="_ix1514" class="ixterm"></a><a id="_ix1515" class="ixterm"></a>DVX reads the keyboard through the computer&#8217;s BIOS, as DOS does.</p>
</div>
<div class="sect3">
<h4 id="trouble-keyboard-layout"><a class="anchor" href="#trouble-keyboard-layout"></a>11.5.1. Keys type the wrong characters</h4>
<div class="paragraph">
<p><a id="_ix1516" class="ixterm"></a><a id="_ix1517" class="ixterm"></a><a id="_ix1518" class="ixterm"></a>If the keys type the characters of another country&#8217;s keyboard, load your DOS keyboard layout program (<code>KEYB</code> with your country&#8217;s code) before you start DVX, for example from <code>AUTOEXEC.BAT</code>. DVX uses the layout DOS has when it starts.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-keyboard-other"><a class="anchor" href="#trouble-keyboard-other"></a>11.5.2. Other keyboard questions</h4>
<div class="dlist">
<dl>
<dt class="hdlist1"><a id="_ix1519" class="ixterm"></a><a id="_ix1520" class="ixterm"></a><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>C</kbd></span> and <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Break</kbd></span> do nothing</dt>
<dd>
<p>DVX ignores them, so they cannot stop DVX by accident. To stop a program, use the Task Manager (see <a href="#trouble-programs-hang">Section 11.13.3</a>).</p>
</dd>
<dt class="hdlist1"><a id="_ix1521" class="ixterm"></a>A game does not notice keys held down</dt>
<dd>
<p>Some programs, mostly games, read which keys are held down. If DVX could not set this up, the log file has <code>Platform: could not lock the keyboard handler; no raw keys</code> or <code>Platform: could not lock the keyboard state; no raw keys</code>. Typing still works everywhere, but such programs do not get the keys held down.</p>
</dd>
<dt class="hdlist1"><a id="_ix1522" class="ixterm"></a>A keyboard joystick does not answer</dt>
<dd>
<p>Keys that stand in for a joystick (set on Control Panel&#8217;s Game Controllers page) only work while the program using them is the active window.</p>
</dd>
</dl>
</div>
</div>
<div class="sect3">
<h4 id="trouble-keyboard-nomouse"><a class="anchor" href="#trouble-keyboard-nomouse"></a>11.5.3. Using DVX without a mouse</h4>
<div class="paragraph">
<p><a id="_ix1523" class="ixterm"></a><a id="_ix1524" class="ixterm"></a>Everything in DVX can be done with the keyboard, which helps while the mouse does not work:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 25%;">
<col style="width: 75%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Tab</kbd>, <span class="keyseq"><kbd>Shift</kbd>+<kbd>Tab</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Moves to the next or previous button, box, or list in a window.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Enter</kbd>, <kbd>Space</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Presses the highlighted button.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F10</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens the menu bar of the active window.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Alt</kbd> and a letter</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens the menu, or presses the button, whose underlined letter you typed.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Alt</kbd>+<kbd>Space</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens the window menu, whose <strong>Move</strong> and <strong>Size</strong> items move and resize the window with the arrow keys.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Alt</kbd>+<kbd>Tab</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Switches to the next window.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Alt</kbd>+<kbd>F4</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Closes the active window. In Program Manager, it asks whether to exit DVX.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Esc</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens the Task Manager.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F1</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens help.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>See <a href="#desktop-mouse-keyboard">Section 5.2</a> for more.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="trouble-joystick"><a class="anchor" href="#trouble-joystick"></a>11.6. Game controllers do not work</h3>
<div class="paragraph">
<p><a id="_ix1525" class="ixterm"></a><a id="_ix1526" class="ixterm"></a><a id="_ix1527" class="ixterm"></a>Joysticks and game pads are set up on Control Panel&#8217;s <strong>Game Controllers</strong> page (see <a href="#cpanel-game-controllers">Section 7.11</a>). What it may show:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><a id="_ix1528" class="ixterm"></a>&#8220;No game controllers found.&#8221;</dt>
<dd>
<p>Shown in the test picture. No joystick is plugged into the game port, the computer has no game port, or <strong>Keyboard</strong> is set to <strong>Never</strong>. Plug the joystick in and click <b class="button">Detect</b>. To use keys as a joystick when none is plugged in, set <strong>Keyboard</strong> to <strong>When no joystick is found</strong>.</p>
</dd>
<dt class="hdlist1"><a id="_ix1529" class="ixterm"></a>&#8220;Not connected&#8221;</dt>
<dd>
<p>The joystick stopped answering. Check its cable, then click <b class="button">Detect</b>.</p>
</dd>
<dt class="hdlist1"><a id="_ix1530" class="ixterm"></a>&#8220;A program is using a game controller. Close it, then click Detect again.&#8221;</dt>
<dd>
<p>A box titled <strong>Game Controllers</strong> shows this after <b class="button">Detect</b>, or after you change <strong>Game port</strong> or <strong>Keyboard</strong>, while another program has a joystick open. Close that program and try again.</p>
</dd>
<dt class="hdlist1"><a id="_ix1531" class="ixterm"></a>&#8220;Move the stick further, all the way to each edge.&#8221;</dt>
<dd>
<p>During calibration, the stick did not travel far enough. Move it round all its edges, then click <b class="button">Next</b>.</p>
</dd>
<dt class="hdlist1"><a id="_ix1532" class="ixterm"></a>&#8220;Game controller support is not installed.&#8221;</dt>
<dd>
<p>The only text on the page: a part of DVX is missing. Repair DVX with Setup (see <a href="#trouble-start-damaged">Section 11.2.4</a>).</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>The log file has a line <code>Joystick: <em>n</em> device(s) found</code> each time DVX looks for joysticks, with a line for each one found. Calibrations and the keyboard joystick&#8217;s keys are kept in the <code>[joystick]</code> section of <code>DVX.INI</code>; deleting a calibration line (a device&#8217;s name, such as <code>gameport0</code>, followed by <code>.axis</code> and a number) makes that axis find its range by itself again.</p>
</div>
</div>
<div class="sect2">
<h3 id="trouble-sound"><a class="anchor" href="#trouble-sound"></a>11.7. There is no sound</h3>
<div class="paragraph">
<p><a id="_ix1533" class="ixterm"></a><a id="_ix1534" class="ixterm"></a><a id="_ix1535" class="ixterm"></a>This section covers sound cards, desktop sounds, MIDI music and instruments, recording, and the Media Player. Without any sound hardware, DVX and its programs work the same, silently.</p>
</div>
<div class="sect3">
<h4 id="trouble-sound-detect"><a class="anchor" href="#trouble-sound-detect"></a>11.7.1. How DVX finds the sound card</h4>
<div class="paragraph">
<p><a id="_ix1536" class="ixterm"></a><a id="_ix1537" class="ixterm"></a><a id="_ix1538" class="ixterm"></a>The first time a sound plays (usually the start-up sound, as DVX starts), DVX tries the sound driver named by the <code>driver</code> key in the <code>[audio]</code> section of <code>DVX.INI</code> (Control Panel&#8217;s <strong>Sound driver</strong>), if one is chosen. If that one is not found or does not start, or if <strong>Sound driver</strong> is <strong>Automatic</strong>, DVX tries the others in this order and uses the first that finds its hardware:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Windows Sound System (<code>wss</code>).</p>
</li>
<li>
<p>Sound Blaster and compatible cards (<code>sb</code>).</p>
</li>
<li>
<p>Gravis UltraSound (<code>gus</code>).</p>
</li>
<li>
<p>A sound device on the printer port (<code>lpt</code>).</p>
</li>
<li>
<p>The PC speaker (<code>speaker</code>).</p>
</li>
<li>
<p>No sound (<code>null</code>), which always works, so every program runs, silently.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>The music chips (an FM synthesizer, a MIDI port, or the wavetable synthesizer of a Gravis UltraSound or Sound Blaster AWE) are found beside the sound device. When a Sound Blaster and a Gravis UltraSound are both in the computer, the Sound Blaster plays recorded sound and the UltraSound plays music.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-sound-none"><a class="anchor" href="#trouble-sound-none"></a>11.7.2. Nothing is heard</h4>
<div class="paragraph">
<p><a id="_ix1539" class="ixterm"></a><a id="_ix1540" class="ixterm"></a><a id="_ix1541" class="ixterm"></a>Work through these steps:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Open Control Panel and click the <strong>Sounds</strong> tab. Near the bottom, the line &#8220;Sound device: <em>device</em>&#8221; names the sound hardware DVX is using:</p>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">What it says</th>
<th class="tableblock halign-left valign-top">What it means</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">A card, such as <code>Sound Blaster 16 (DSP 4.05) at 220h</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX found that card and uses it. Check the volume (step 4).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>PC speaker (tones)</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX found no sound card, only the PC speaker. It plays tones and beeps, not recorded sounds.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>No sound device</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX found no sound hardware and runs silently.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>none running</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No sound driver started, or no program has used sound since DVX started.</p></td>
</tr>
</tbody>
</table>
</li>
<li>
<p>If your card was not found, give DVX its settings: the <code>BLASTER</code> line for a Sound Blaster (see <a href="#trouble-sound-blaster">Section 11.7.3</a>), the <code>ULTRASND</code> line for a Gravis UltraSound (see <a href="#trouble-sound-gus">Section 11.7.4</a>), or the port, IRQ, and DMA of a Windows Sound System card (see <a href="#trouble-sound-wss">Section 11.7.5</a>).</p>
</li>
<li>
<p>If DVX picked the wrong device, choose yours in the <strong>Sound driver</strong> list, click <b class="button">OK</b>, and restart DVX. <a id="_ix1542" class="ixterm"></a>As the page says, &#8220;Sound driver and MIDI changes take effect when DVX next starts.&#8221;</p>
</li>
<li>
<p>Check the <strong>Volume</strong> slider on the Sounds page, and the volume knob or mixer of the card and the speakers.</p>
</li>
<li>
<p>Click an event in the <strong>Events</strong> list, then click <b class="button">Test</b> beside its <strong>Sound</strong>. If it fails, a box titled <strong>Sounds</strong> gives the reason (see <a href="#trouble-sound-messages">Section 11.7.14</a>).</p>
</li>
<li>
<p>If there is still no sound, look in the log file for lines starting <code>Audio:</code> (see <a href="#trouble-sound-log">Section 11.7.15</a>).</p>
</li>
</ol>
</div>
<div class="paragraph">
<p><a id="_ix1543" class="ixterm"></a>If the Sounds page shows only &#8220;Sound is not installed.&#8221;, a part of DVX is missing. Repair DVX with Setup (see <a href="#trouble-start-damaged">Section 11.2.4</a>).</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-sound-blaster"><a class="anchor" href="#trouble-sound-blaster"></a>11.7.3. Sound Blaster cards and the BLASTER setting</h4>
<div class="paragraph">
<p><a id="_ix1544" class="ixterm"></a><a id="_ix1545" class="ixterm"></a><a id="_ix1546" class="ixterm"></a>DVX finds a Sound Blaster through the <code>BLASTER</code> setting in <code>AUTOEXEC.BAT</code>, for example:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>SET BLASTER=A220 I5 D1 H5</pre>
</div>
</div>
<div class="paragraph">
<p><code>A</code> is the card&#8217;s port, <code>I</code> its interrupt (IRQ), <code>D</code> its 8-bit DMA channel, and <code>H</code> its 16-bit DMA channel. A Sound Blaster AWE adds the port of its music chip, for example <code>E620</code>. The card&#8217;s manual or its setup program gives the right numbers. Without <code>BLASTER</code>, DVX can find only a Sound Blaster 16, at port 220h or 240h; older cards need the line.</p>
</div>
<div class="paragraph">
<p>What the log file says about a Sound Blaster:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Log line</th>
<th class="tableblock halign-left valign-top">What it means</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Audio: sb: DSP <em>version</em> at <em>port</em>h, IRQ <em>n</em>, DMA <em>n</em>, mode <em>n</em></code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The card was found and works.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Audio: sb: no Sound Blaster found (BLASTER set)</code> or <code>(BLASTER not set)</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No card answered. Check that the card is in, and that <code>BLASTER</code> is set with the right port; older cards need it.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Audio: sb: the DSP at <em>port</em>h gave no version</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Something at that port did not answer like a Sound Blaster. Check the <code>A</code> value.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Audio: sb: IRQ or DMA channel unknown or unusable (set BLASTER, e.g. A220 I5 D1 H5)</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Set the <code>I</code> and <code>D</code> values in <code>BLASTER</code>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Audio: sb: no interrupt from the card on IRQ <em>n</em> (check BLASTER)</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The <code>I</code> value does not match the card. DVX then tries the next kind of sound device.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Audio: sb: no conventional memory for the DMA buffer</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Free some conventional memory (see <a href="#trouble-start-memory">Section 11.2.6</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Audio: awe: no sample memory at the EMU8000 at <em>port</em>h</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The AWE&#8217;s music chip has no memory of its own, so it is not used for music.</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect3">
<h4 id="trouble-sound-gus"><a class="anchor" href="#trouble-sound-gus"></a>11.7.4. Gravis UltraSound and the ULTRASND setting</h4>
<div class="paragraph">
<p><a id="_ix1547" class="ixterm"></a><a id="_ix1548" class="ixterm"></a><a id="_ix1549" class="ixterm"></a><a id="_ix1550" class="ixterm"></a>A Gravis UltraSound needs the <code>ULTRASND</code> setting in <code>AUTOEXEC.BAT</code> to play recorded sound, for example:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>SET ULTRASND=220,1,1,11,5</pre>
</div>
</div>
<div class="paragraph">
<p>The card&#8217;s manual or setup program gives the numbers: the card&#8217;s port, DMA channels, and interrupts. DVX can find the UltraSound&#8217;s music synthesizer without it, but not its recorded sound. The <code>ULTRADIR</code> setting, also written by the card&#8217;s setup, names the folder of the card&#8217;s software, where DVX finds the UltraSound&#8217;s own instruments.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Log line</th>
<th class="tableblock halign-left valign-top">What it means</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Audio: gus: ULTRASND is not set (for example SET ULTRASND=220,1,1,11,5)</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Add the <code>ULTRASND</code> line.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Audio: gus: no UltraSound at <em>port</em>h</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The port in <code>ULTRASND</code> is wrong.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Audio: gus: ULTRASND&#8217;s IRQ <em>n</em> or DMA <em>n</em> cannot be used</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Correct the IRQ or DMA numbers in <code>ULTRASND</code>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Audio: gus: no interrupt from the card on IRQ <em>n</em> (check ULTRASND)</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The IRQ in <code>ULTRASND</code> does not match the card.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Audio: gus: no DMA transfer into the card finished on DMA <em>n</em> (check ULTRASND)</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The DMA channel in <code>ULTRASND</code> does not match the card.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Audio: gus: no conventional memory for the DMA buffer</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Free some conventional memory (see <a href="#trouble-start-memory">Section 11.2.6</a>).</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect3">
<h4 id="trouble-sound-wss"><a class="anchor" href="#trouble-sound-wss"></a>11.7.5. Windows Sound System cards</h4>
<div class="paragraph">
<p><a id="_ix1551" class="ixterm"></a>DVX looks for a Windows Sound System card at ports 530h, 604h, E80h, and F40h, on interrupt 7 and DMA channel 1. If yours uses another interrupt or DMA channel, or to name its port, set these keys in the <code>[audio]</code> section of <code>DVX.INI</code>:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><code>wssPort</code>: the port, in hexadecimal, such as <code>530</code> or <code>E80</code>. DVX then looks only there.</p>
</li>
<li>
<p><code>wssIrq</code>: the interrupt, <code>7</code>, <code>9</code>, <code>10</code>, or <code>11</code> (7 if not set).</p>
</li>
<li>
<p><code>wssDma</code>: the DMA channel, <code>0</code>, <code>1</code>, or <code>3</code> (1 if not set).</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>A Plug and Play card that is set up by its own program must be set to the interrupt and DMA channel that <code>DVX.INI</code> names. <code>Audio: wss: no conventional memory for the DMA buffer</code> in the log file means conventional memory is short (see <a href="#trouble-start-memory">Section 11.2.6</a>). The log file says <code>Audio: wss: IRQ <em>n</em> / DMA <em>n</em> cannot be used (wssIrq 7, 9, 10 or 11; wssDma 0, 1 or 3)</code> for values DVX cannot use, and <code>Audio: wss: no interrupt from the codec on IRQ <em>n</em> (set wssIrq)</code> when the card is on another interrupt.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-sound-lpt"><a class="anchor" href="#trouble-sound-lpt"></a>11.7.6. Printer-port sound devices and the PC speaker</h4>
<div class="paragraph">
<p><a id="_ix1552" class="ixterm"></a><a id="_ix1553" class="ixterm"></a><a id="_ix1554" class="ixterm"></a><a id="_ix1555" class="ixterm"></a>A Disney Sound Source or a Stereo-on-1 on the printer port is found by itself. A Covox Speech Thing must be named: set <code>lptDac = covox</code> in the <code>[audio]</code> section of <code>DVX.INI</code>, and <code>lptPort</code> to its port if it is not on LPT1.</p>
</div>
<div class="paragraph">
<p>With only the PC speaker, DVX plays tones and beeps but not recorded sounds, such as the desktop sounds. To hear recorded sounds on the speaker, set <code>speakerPcm = true</code> in the <code>[audio]</code> section; this takes much of the computer&#8217;s time.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-sound-quality"><a class="anchor" href="#trouble-sound-quality"></a>11.7.7. Sounds stop, stutter, or are cut off</h4>
<div class="dlist">
<dl>
<dt class="hdlist1"><a id="_ix1556" class="ixterm"></a><a id="_ix1557" class="ixterm"></a>A sound does not play while many others play</dt>
<dd>
<p>DVX mixes up to 16 sounds at once (the <code>voices</code> key in <code>[audio]</code>, from 1 to 32). When another starts, the quietest sound playing stops to make room. If the new one would be the quietest, it does not play, with the reason &#8220;Too many sounds are playing&#8221;.</p>
</dd>
<dt class="hdlist1">Sound or music modules stutter on a slow computer</dt>
<dd>
<p>Mixing takes the computer&#8217;s time. In the <code>[audio]</code> section of <code>DVX.INI</code>, lower <code>rate</code> (for example to <code>11025</code>) or <code>voices</code>, or set <code>bits = 8</code> and <code>channels = 1</code>. On the Sounds page, <strong>Modules</strong> set to <strong>Wavetable synthesizer when free</strong> lets a Gravis UltraSound or Sound Blaster AWE play modules on its own voices.</p>
</dd>
<dt class="hdlist1">Sound stops after a DOS program or a pause</dt>
<dd>
<p><a id="_ix1558" class="ixterm"></a>DVX lets go of the sound card while a DOS program runs, and closes the sound output after 10 seconds of silence, opening it again for the next sound. Both are normal. If the card does not come back, the log file has <code>Audio: driver '<em>name</em>' could not open the output again</code>, <code>Audio: driver '<em>name</em>' could not start playing again</code>, or <code>Audio: synth driver '<em>name</em>' could not open again</code>: restart DVX.</p>
</dd>
<dt class="hdlist1">Sounds are held back while recording</dt>
<dd>
<p>A sound card either records or plays. While a recording runs, other programs' sounds and the desktop sounds are held or skipped until it stops.</p>
</dd>
</dl>
</div>
</div>
<div class="sect3">
<h4 id="trouble-sound-events"><a class="anchor" href="#trouble-sound-events"></a>11.7.8. Desktop sounds</h4>
<div class="paragraph">
<p><a id="_ix1559" class="ixterm"></a><a id="_ix1560" class="ixterm"></a>DVX plays a sound for events such as starting, exiting, and message boxes. Each is chosen in the <strong>Events</strong> list on the Sounds page and kept in the <code>[sounds]</code> section of <code>DVX.INI</code>. An event set to <strong>(None)</strong> (an empty line in <code>[sounds]</code>) is silent; the window events are silent unless you choose sounds for them.</p>
</div>
<div class="paragraph">
<p><a id="_ix1561" class="ixterm"></a>If <b class="button">Test</b> fails, a box titled <strong>Sounds</strong> gives the reason (see <a href="#trouble-sound-messages">Section 11.7.14</a>): the sound file is missing or damaged, it is not a WAV or VOC file, no sound device runs (most often, &#8220;No sound device could be started&#8221;), or the card is busy recording. Choose another sound, or check the card&#8217;s settings. A desktop sound that fails while DVX runs is only noted in the log file, as <code>Audio: desktop sound <em>file</em>: <em>reason</em></code>.</p>
</div>
<div class="paragraph">
<p>If no sound device could be started at all, the desktop sounds stay silent: DVX does not try again at every event.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-sound-midi"><a class="anchor" href="#trouble-sound-midi"></a>11.7.9. MIDI music</h4>
<div class="paragraph">
<p><a id="_ix1562" class="ixterm"></a><a id="_ix1563" class="ixterm"></a><a id="_ix1564" class="ixterm"></a>The <strong>MIDI music</strong> setting on the Sounds page (the <code>midi</code> key in <code>[audio]</code>) says where MIDI music plays:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 33.3333%;">
<col style="width: 16.6666%;">
<col style="width: 50.0001%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Choice</th>
<th class="tableblock halign-left valign-top">In DVX.INI</th>
<th class="tableblock halign-left valign-top">Where MIDI music plays</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Automatic</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>auto</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">On a Gravis UltraSound&#8217;s or Sound Blaster AWE&#8217;s recorded instruments when they can be loaded, else on the card&#8217;s FM synthesizer chip, else on DVX&#8217;s own synthesizer.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>MIDI port (MPU-401)</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>mpu401</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">On an external synthesizer or sound module connected to the MIDI port.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>FM synthesizer chip</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>fm</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">On the sound card&#8217;s FM chip.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Built-in synthesizer</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>software</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">On DVX&#8217;s own FM synthesizer, mixed by the computer.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Built-in SoundFont synthesizer</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>softwave</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">On a SoundFont played by the computer.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>Changes to <strong>MIDI music</strong> take effect when DVX next starts. <a id="_ix1565" class="ixterm"></a>To see where a MIDI file actually plays, open it in the Media Player: the line under the title names the kind of file and the output, for example <code>MIDI music (MID) - OPL3 FM synthesizer at 388h</code>. The output is the FM chip (as in that example), the MIDI port (such as <code>MPU-401 MIDI port at 330h (gm)</code>), a wavetable card (such as <code>Gravis UltraSound wavetable at 220h (28 voices, 1024 KB)</code> or <code>Sound Blaster AWE EMU8000 at 620h (512 KB)</code>), <code>FM software synthesizer</code> or <code>SoundFont software synthesizer</code> (DVX&#8217;s own synthesizers), or <code>Sound device</code> (music the computer mixes, and WAV and VOC files).</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-sound-midi-instruments"><a class="anchor" href="#trouble-sound-midi-instruments"></a>11.7.10. MIDI music plays on the wrong instruments, or sounds like the FM chip</h4>
<div class="paragraph">
<p><a id="_ix1566" class="ixterm"></a><a id="_ix1567" class="ixterm"></a><a id="_ix1568" class="ixterm"></a><a id="_ix1569" class="ixterm"></a>To play MIDI music on a Gravis UltraSound&#8217;s or Sound Blaster AWE&#8217;s recorded instruments, DVX needs a set of instruments (a SoundFont). DVX&#8217;s own is the <strong>DVX General MIDI</strong> add-on, which is on the DVX CD and on the package server. Without it, DVX uses the UltraSound&#8217;s own instruments when <code>ULTRADIR</code> names the folder of its software, or the AWE&#8217;s built-in instruments when the <code>SOUND</code> setting names Creative&#8217;s software folder (the cards' setup programs put these lines in <code>AUTOEXEC.BAT</code>). Otherwise MIDI music plays on the FM chip, and the log file says <code>Music: SoundFont <em>name</em>: <em>reason</em>; MIDI music plays on the FM synthesizer</code>.</p>
</div>
<div class="paragraph">
<p>To fix it:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Install DVX General MIDI with Software: <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Install from File&#8230;&#8203;</b></span> and open it from the <code>ADDONS</code> folder of the DVX CD, or install it from the package server (see <a href="#addons-installing">Section 10.3</a>).</p>
</li>
<li>
<p>Or choose another SoundFont in the <strong>SoundFont</strong> list on the Sounds page.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p><a id="_ix1570" class="ixterm"></a>If the card has too little memory for the instruments, some notes play on the FM chip instead, and the log file has lines starting <code>Music:</code> that say samples do not fit in the synthesizer&#8217;s memory. Close other programs that play music, or choose a smaller SoundFont.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-sound-midi-external"><a class="anchor" href="#trouble-sound-midi-external"></a>11.7.11. MIDI music to an external synthesizer is silent</h4>
<div class="paragraph">
<p><a id="_ix1571" class="ixterm"></a><a id="_ix1572" class="ixterm"></a><a id="_ix1573" class="ixterm"></a>DVX plays MIDI music on the MIDI port only when it was found when DVX started and no other music is using it. Otherwise the music plays on the FM chip or DVX&#8217;s own synthesizer, with no message. To use the port:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>On the Sounds page, set <strong>MIDI music</strong> to <strong>MIDI port (MPU-401)</strong>, click <b class="button">OK</b>, and restart DVX.</p>
</li>
<li>
<p>If the port is not at 330h, set <code>mpuPort</code> in the <code>[audio]</code> section of <code>DVX.INI</code> to its address (in hexadecimal, for example <code>300</code>).</p>
</li>
<li>
<p>For a Roland MT-32, set <code>mpuMode = mt32</code> in <code>[audio]</code>. (<code>gm</code>, the default, is for a General MIDI synthesizer; <code>raw</code> sends the music unchanged.) This setting is not in Control Panel.</p>
</li>
<li>
<p>Check that the synthesizer is switched on and that the MIDI cable is in the right sockets.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>If the port was not found, the log file has <code>Audio: synth driver 'mpu401' found no device</code>. (That line also appears, harmlessly, whenever neither <strong>MIDI music</strong> nor <strong>MIDI in</strong> is set to the MIDI port.)</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-sound-banks"><a class="anchor" href="#trouble-sound-banks"></a>11.7.12. Instruments and SoundFont test messages</h4>
<div class="paragraph">
<p><a id="_ix1574" class="ixterm"></a><a id="_ix1575" class="ixterm"></a>The <strong>Instruments</strong> row of the Sounds page chooses the instrument bank for FM music, and the <strong>SoundFont</strong> row the recorded instruments. <strong>Standard</strong> is DVX&#8217;s own. A bank an add-on installed is shown by the add-on&#8217;s name; one of your own in <code>USER\BANKS</code> by its file name; the UltraSound&#8217;s and the AWE&#8217;s own appear on the <strong>SoundFont</strong> row as <strong>Gravis UltraSound patches</strong> and <strong>Sound Blaster AWE ROM instruments</strong> when they are found.</p>
</div>
<div class="paragraph">
<p>If <b class="button">Test</b> beside one of them fails, a box titled <strong>Instruments</strong> gives the reason, most often &#8220;The instrument bank for MIDI music is missing or damaged&#8221;: the chosen file is missing or damaged, or, on the SoundFont row, <strong>Standard</strong> is chosen but the DVX General MIDI add-on is not installed. &#8220;No sound device can play this music&#8221; means no sound device runs. Install the add-on or choose another bank.</p>
</div>
<div class="paragraph">
<p>Log lines about banks:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><code>Music: the MIDI bank <em>name</em> is missing or damaged; using the standard one</code>: the bank chosen is gone, so DVX uses its own.</p>
</li>
<li>
<p><code>Music: no usable MIDI instrument bank</code>: DVX&#8217;s own bank is missing, so MIDI music can play only on a MIDI port. Repair DVX with Setup.</p>
</li>
<li>
<p><code>Music: the patch <em>file</em> is damaged; left out</code>: one of the UltraSound&#8217;s instrument files could not be read.</p>
</li>
</ul>
</div>
</div>
<div class="sect3">
<h4 id="trouble-sound-modules"><a class="anchor" href="#trouble-sound-modules"></a>11.7.13. Music modules (MOD, S3M, XM, and IT files)</h4>
<div class="paragraph">
<p><a id="_ix1576" class="ixterm"></a><a id="_ix1577" class="ixterm"></a>The <strong>Modules</strong> setting on the Sounds page says where music modules play. With <strong>Wavetable synthesizer when free</strong>, they play on a Gravis UltraSound&#8217;s or Sound Blaster AWE&#8217;s own voices when no other music uses them and the module fits; otherwise, and with <strong>Mixed in software</strong>, the computer mixes them, which takes much of a slow computer&#8217;s time. See <a href="#trouble-sound-quality">Section 11.7.7</a> if they stutter.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-sound-messages"><a class="anchor" href="#trouble-sound-messages"></a>11.7.14. Sound and music messages</h4>
<div class="paragraph">
<p><a id="_ix1578" class="ixterm"></a><a id="_ix1579" class="ixterm"></a>These reasons appear inside other messages: the Sounds page&#8217;s <b class="button">Test</b>, the Media Player, the Sound Recorder, and BASIC programs that play sound.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Reason</th>
<th class="tableblock halign-left valign-top">What it means</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1580" class="ixterm"></a>&#8220;No sound device could be started&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No sound hardware is working. See <a href="#trouble-sound-none">Section 11.7.2</a>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;No sound device can play this music&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No sound device runs that can play this kind of music.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The file could not be read&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file is missing, or its disk cannot be read.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Not a WAV or VOC sound file&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file is not a sound file DVX can play.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Not a music or sound file (MOD, S3M, XM, IT, MIDI, WAV, or VOC)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file is not one of the kinds of music or sound DVX plays.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Unsupported sound format (only uncompressed 8- and 16-bit sound can be played)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The sound file is compressed, or in an unusual form. Convert it to uncompressed sound with another program.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The sound file is damaged or incomplete&#8221;, &#8220;The music file is damaged or incomplete&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file is damaged, or was not copied completely.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1581" class="ixterm"></a>&#8220;Too many sounds are playing&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The most sounds DVX mixes at once are already playing, and this one was the quietest.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1582" class="ixterm"></a>&#8220;The synthesizer or sound device is being used by another program (or is recording)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Another program has it, or the Sound Recorder is recording. Stop the other program first.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;There is no such synthesizer&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No FM chip was found, or (for a MIDI keyboard) <strong>MIDI in</strong> is not set to <strong>MIDI port</strong>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;There is not enough synthesizer memory&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The wavetable card&#8217;s memory is full.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The instrument bank for MIDI music is missing or damaged&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">See <a href="#trouble-sound-banks">Section 11.7.12</a>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The music string has a mistake in it&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A tune given to a program as text (such as a BASIC program&#8217;s PLAY) has a mistake.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The sound device cannot record from that input&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The card has no such input (for example a line input on an early Sound Blaster).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The file could not be written&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The disk is full or cannot be written to.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Not enough memory&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Close programs to free memory.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;No such sound is playing&#8221;, &#8220;Invalid argument&#8221;, &#8220;Unknown error&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A program asked for something that cannot be done. Report it to the program&#8217;s author.</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect3">
<h4 id="trouble-sound-log"><a class="anchor" href="#trouble-sound-log"></a>11.7.15. Sound lines in the log file</h4>
<div class="paragraph">
<p><a id="_ix1583" class="ixterm"></a><a id="_ix1584" class="ixterm"></a>Lines starting <code>Audio:</code> and <code>Music:</code> in the log file say what DVX found and what went wrong. These are the general ones; the card lines are listed with each card above.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Log line</th>
<th class="tableblock halign-left valign-top">What it means</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Audio: using '<em>driver</em>': <em>device</em>, <em>rate</em> Hz, &#8230;&#8203;</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The sound device DVX plays on. Normal.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Audio: using '<em>driver</em>': <em>device</em></code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A music synthesizer DVX found. Normal.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Audio: driver '<em>name</em>' found no device</code>, <code>Audio: synth driver '<em>name</em>' found no device</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">That kind of hardware is not in the computer. Normal for every kind you do not have.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Audio: sound driver '<em>name</em>' not found; detecting</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The driver named in <code>[audio]</code> <code>driver</code> is not installed, usually a typing mistake. DVX looks for the others.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Audio: sound driver '<em>name</em>' did not start; detecting</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The driver named in <code>[audio]</code> <code>driver</code> did not find its card. DVX looks for the others.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Audio: no sound driver could be started</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Nothing started, not even silent sound. Repair DVX with Setup and check the card&#8217;s settings.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Audio: driver '<em>name</em>' reported an unusable format</code>, <code>Audio: driver '<em>name</em>' could not start playing</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The card could not play in the form DVX asked for. Try other <code>rate</code>, <code>bits</code>, or <code>channels</code> values, or another driver.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Audio: could not pin the mixer in memory</code>, <code>Audio: could not pin the synthesizer code in memory</code>, <code>Music: could not pin the music player in memory</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Not enough memory. Close programs, use a smaller screen mode, and restart DVX.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Audio: output closed after 10 s of silence</code>, <code>Audio: output opened again</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Normal.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Audio: sound device let go for a DOS program</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Normal while a DOS program runs.</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect3">
<h4 id="trouble-sound-recording"><a class="anchor" href="#trouble-sound-recording"></a>11.7.16. Recording sound</h4>
<div class="paragraph">
<p><a id="_ix1585" class="ixterm"></a><a id="_ix1586" class="ixterm"></a><a id="_ix1587" class="ixterm"></a>The Sound Recorder records with a Sound Blaster, a Windows Sound System card, or a Gravis UltraSound. The PC speaker and printer-port devices cannot record. Before the Sound Blaster Pro, a Sound Blaster records only from the microphone; the Pro and the 16 also from the line input and the CD. An UltraSound records from the microphone and the line input. Inputs the card does not have are greyed out, and <strong>MIDI Keyboard</strong> is greyed out unless <strong>MIDI in</strong> on the Sounds page is set to <strong>MIDI port</strong>. Only one program in DVX can record at a time.</p>
</div>
<div class="paragraph">
<p>Until you save it, a recording is kept in the file <code>RECORDING.WAV</code> (or <code>RECORDING.MID</code>) in the Sound Recorder&#8217;s own folder in the USER folder, and it is deleted when the program closes. Save it to keep it.</p>
</div>
<div class="paragraph">
<p>The Sound Recorder&#8217;s messages are in boxes titled <strong>Sound Recorder</strong>. Many have a second part, after a blank line, that gives the reason (see <a href="#trouble-sound-messages">Section 11.7.14</a>):</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><a id="_ix1588" class="ixterm"></a>&#8220;This computer&#8217;s sound card cannot record.&#8221; under the buttons</dt>
<dd>
<p>There is no card that can record, or the card was not found. Set up a Sound Blaster, Windows Sound System card, or Gravis UltraSound (see <a href="#trouble-sound-none">Section 11.7.2</a>).</p>
</dd>
<dt class="hdlist1"><a id="_ix1589" class="ixterm"></a>&#8220;Sound Recorder cannot record.&#8221;</dt>
<dd>
<p>Recording could not start. The reason says why: another program is recording, the card has no such input, or the USER folder&#8217;s disk is full or cannot be written to. With a MIDI recording, all eight MIDI recordings may be in use, or memory is short.</p>
</dd>
<dt class="hdlist1">&#8220;Sound Recorder cannot record from the MIDI keyboard.&#8221;</dt>
<dd>
<p><strong>MIDI in</strong> is not set to <strong>MIDI port</strong> (&#8220;There is no such synthesizer&#8221;), or another program reads the MIDI keyboard. On the Sounds page, set <strong>MIDI in</strong> to <strong>MIDI port</strong>, click <b class="button">OK</b>, and restart DVX.</p>
</dd>
<dt class="hdlist1">&#8220;The recording could not be written.&#8221;</dt>
<dd>
<p>A MIDI recording could not be saved to <code>RECORDING.MID</code>: the disk is full or cannot be written to.</p>
</dd>
<dt class="hdlist1">&#8220;The recording could not all be written.&#8221;</dt>
<dd>
<p>The disk filled up during the recording. The part recorded before that is kept.</p>
</dd>
<dt class="hdlist1">&#8220;Sound Recorder cannot play this recording.&#8221;</dt>
<dd>
<p>The reason says why.</p>
</dd>
<dt class="hdlist1">&#8220;Sound Recorder could not save <em>file</em>.&#8221;</dt>
<dd>
<p>Saving failed: the disk is full or cannot be written to (such as a CD-ROM), the folder does not exist, or a file of that name is read-only. A file of that name on the disk is left as it was. Save it somewhere else.</p>
</dd>
<dt class="hdlist1">&#8220;Sound Recorder cannot open <em>file</em>.&#8221;</dt>
<dd>
<p>The file could not be opened; the reason says why, or says &#8220;It is not a WAV or MIDI file.&#8221;</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p><a id="_ix1590" class="ixterm"></a>The log file says more when recording fails: <code>Audio: the sound device did not start recording</code>; <code>Audio: sb: no 8-bit DMA channel to record on (set BLASTER D)</code> (add the <code>D</code> value to <code>BLASTER</code>); <code>Audio: sb: no conventional memory for the recording&#8217;s DMA buffer</code> or the same for <code>gus</code> and <code>wss</code> (free conventional memory); and <code>Audio: gus: no interrupt from the card while recording on IRQ <em>n</em>, DMA <em>n</em> (check ULTRASND)</code>.</p>
</div>
<div class="paragraph">
<p>If parts of a recording are missing, the log file line <code>Audio: recording ended: <em>n</em> frames, <em>n</em> lost</code> shows whether the computer was too busy to keep up. Close other programs while recording.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-sound-player"><a class="anchor" href="#trouble-sound-player"></a>11.7.17. Media Player</h4>
<div class="paragraph">
<p><a id="_ix1591" class="ixterm"></a><a id="_ix1592" class="ixterm"></a>The Media Player&#8217;s messages are in boxes titled <strong>Media Player</strong>:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1">&#8220;Media Player cannot play <em>file</em>.&#8221;</dt>
<dd>
<p>The file could not be loaded or started. The reason after it (also shown on the line under the title) says why, for example that the file is not a music or sound file, that it is damaged, that it is a compressed WAV file, that no sound device can play it, that the Sound Recorder is recording, or that the instrument bank is missing (see <a href="#trouble-sound-messages">Section 11.7.14</a>). When the list comes to such a track, the Media Player goes on to the next track that plays; if several in a row cannot be played, one message names them all, as in &#8220;Media Player cannot play <em>file</em>, <em>file</em>, and <em>n</em> other tracks.&#8221;, and gives each reason once.</p>
</dd>
<dt class="hdlist1"><a id="_ix1593" class="ixterm"></a>&#8220;The folder <em>folder</em> cannot be read.&#8221;</dt>
<dd>
<p>After <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Add Folder&#8230;&#8203;</b></span>: the drive is empty, the disk was taken out, or the folder does not exist.</p>
</dd>
<dt class="hdlist1"><a id="_ix1594" class="ixterm"></a>&#8220;There are no music or sound files in <em>folder</em>.&#8221;</dt>
<dd>
<p>The Media Player adds only MOD, S3M, XM, IT, MID, RMI, WAV, and VOC files.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>&#8220;Nothing is playing&#8221; where the track&#8217;s title goes is normal when nothing is loaded. The Media Player keeps its settings and its list in <code>PLAYER.INI</code> in its own folder in the USER folder.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-sound-ini"><a class="anchor" href="#trouble-sound-ini"></a>11.7.18. Sound settings in DVX.INI</h4>
<div class="paragraph">
<p><a id="_ix1595" class="ixterm"></a><a id="_ix1596" class="ixterm"></a>The <code>[audio]</code> section of <code>DVX.INI</code> holds the sound settings. Control Panel&#8217;s Sounds page sets the first ones; the others can only be set in the file. Deleting a line returns that setting to its default. See <a href="#folders-dvx-ini">Section B.2</a> for the whole file.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 16.6666%;">
<col style="width: 33.3333%;">
<col style="width: 50.0001%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">Values (default)</th>
<th class="tableblock halign-left valign-top">What it sets</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>driver</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>auto</code>, <code>wss</code>, <code>sb</code>, <code>gus</code>, <code>lpt</code>, <code>speaker</code>, <code>null</code> (<code>auto</code>)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The sound driver tried first. Takes effect at the next start.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>volume</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">0 to 100 (100)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The volume, in percent.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>midi</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>auto</code>, <code>mpu401</code>, <code>fm</code>, <code>software</code>, <code>softwave</code> (<code>auto</code>)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Where MIDI music plays. Next start.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>midiIn</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>none</code>, <code>mpu401</code> (<code>none</code>)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Where a MIDI keyboard is read from. Next start.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>modules</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>wavetable</code>, <code>software</code> (<code>wavetable</code>)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Where music modules play.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>midiBank</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A bank&#8217;s name or path (not set: DVX&#8217;s own)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The instrument bank for FM music.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>soundFont</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A SoundFont&#8217;s name or path, or the path of an UltraSound&#8217;s <code>ULTRASND.INI</code> (not set: the DVX General MIDI add-on&#8217;s)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The recorded instruments for MIDI music.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>rate</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">4000 to 48000 (22050)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The mixing rate in Hz. Lower takes less of the computer&#8217;s time.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>bits</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>0</code>, <code>8</code>, <code>16</code> (<code>0</code>, the best the card can do)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Sound quality.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>channels</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>0</code>, <code>1</code>, <code>2</code> (<code>0</code>, the best the card can do)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Mono (1) or stereo (2).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>voices</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">1 to 32 (16)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">How many sounds are mixed at once.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>speakerPcm</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code>, <code>false</code> (<code>false</code>)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Recorded sound on the PC speaker (takes much time).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>fmTones</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code>, <code>false</code> (<code>true</code>)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Tones on the FM chip when there is one.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>mpuMode</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>gm</code>, <code>mt32</code>, <code>raw</code> (<code>gm</code>)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">What is on the MIDI port.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>mpuPort</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">hexadecimal (<code>330</code>)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The MIDI port&#8217;s address.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>oplPort</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">hexadecimal (<code>388</code>)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The FM chip&#8217;s address.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>gusVoices</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">14 to 32 (28)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Voices on a Gravis UltraSound; fewer play at a higher rate.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>wssPort</code>, <code>wssIrq</code>, <code>wssDma</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">See <a href="#trouble-sound-wss">Section 11.7.5</a></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A Windows Sound System card.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>lptDac</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>auto</code>, <code>covox</code>, <code>disney</code>, <code>stereo</code> (<code>auto</code>)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The printer-port sound device. A Covox must be named.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>lptPort</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">hexadecimal (LPT1)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Its port.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix1597" class="ixterm"></a>These settings in <code>AUTOEXEC.BAT</code> matter too: <code>BLASTER</code> (Sound Blaster and AWE), <code>ULTRASND</code> (Gravis UltraSound), <code>ULTRADIR</code> (the UltraSound&#8217;s software folder, with its instruments), and <code>SOUND</code> (Creative&#8217;s software folder, with the AWE&#8217;s instruments).</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="trouble-printing"><a class="anchor" href="#trouble-printing"></a>11.8. Nothing prints</h3>
<div class="paragraph">
<p><a id="_ix1598" class="ixterm"></a><a id="_ix1599" class="ixterm"></a><a id="_ix1600" class="ixterm"></a>DVX sends printouts straight to the printer port, a serial port, or a file, as set on Control Panel&#8217;s <strong>Printer</strong> page (see <a href="#cpanel-printer">Section 7.10</a>). Unless you change it, DVX prints to LPT1 with the model <strong>Text only (any printer)</strong>, which prints text but not pictures.</p>
</div>
<div class="sect3">
<h4 id="trouble-printing-settings"><a class="anchor" href="#trouble-printing-settings"></a>11.8.1. Check the printer settings first</h4>
<div class="paragraph">
<p><a id="_ix1601" class="ixterm"></a><a id="_ix1602" class="ixterm"></a>Open Control Panel and click the <strong>Printer</strong> tab, then check:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><strong>Connected to</strong></dt>
<dd>
<p><a id="_ix1603" class="ixterm"></a>The port the printer&#8217;s cable is plugged into: LPT1, LPT2, LPT3, COM1 to COM4 (a serial printer), or File. DVX can use a port only if the computer&#8217;s BIOS lists it.</p>
</dd>
<dt class="hdlist1"><strong>Printer model</strong></dt>
<dd>
<p><a id="_ix1604" class="ixterm"></a>Your printer&#8217;s model, or one it can imitate. <strong>Text only (any printer)</strong> works with every printer but prints only text. The others print pictures too, the color ones in color: <strong>Epson 9-pin (ESC/P)</strong>, <strong>Epson 24-pin (ESC/P)</strong>, <strong>HP LaserJet (PCL)</strong>, <strong>HP LaserJet III or DeskJet (300 dpi)</strong>, <strong>Epson 9-pin color (ESC/P)</strong>, <strong>Epson 24-pin color (ESC/P)</strong>, <strong>HP DeskJet 500C (color)</strong>, <strong>HP DeskJet 550C and later (color)</strong>, <strong>PostScript</strong>, <strong>PostScript (color)</strong>, <strong>Apple ImageWriter II</strong>, and <strong>Apple ImageWriter II (color)</strong>.</p>
</dd>
<dt class="hdlist1"><strong>Speed (baud)</strong> and <strong>Handshake</strong></dt>
<dd>
<p><a id="_ix1605" class="ixterm"></a>For a serial printer only. They must match the printer&#8217;s own switches or settings. DVX sends 8 data bits, no parity, and 1 stop bit, at 300 to 38400 baud. <strong>Handshake</strong> is how the printer holds the computer back while it catches up: <strong>None</strong>, <strong>XON / XOFF</strong>, <strong>Hardware (CTS)</strong>, or <strong>Hardware (DSR, Apple)</strong> (as Apple&#8217;s ImageWriter cable is wired).</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p><a id="_ix1606" class="ixterm"></a>While a printout goes out, a window titled <strong>Printer</strong> says &#8220;Printing <em>document</em> on <em>port</em>&#8230;&#8203;&#8221; with a <b class="button">Cancel</b> button (<kbd>Esc</kbd> presses it too). For a short printout it may not appear at all. If you end a program with <b class="button">End Task</b> while it prints, the rest of its printout is not sent, and DVX does not wait for the printer or ask about it.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-printing-retry"><a class="anchor" href="#trouble-printing-retry"></a>11.8.2. The printer has a problem</h4>
<div class="paragraph">
<p><a id="_ix1607" class="ixterm"></a><a id="_ix1608" class="ixterm"></a><a id="_ix1609" class="ixterm"></a><a id="_ix1610" class="ixterm"></a><a id="_ix1611" class="ixterm"></a>When the printer stops taking what DVX sends, a box titled <strong>Printer</strong> says what is wrong, with <b class="button">Retry</b> and <b class="button">Cancel</b> buttons. Fix the problem and click <b class="button">Retry</b> to go on, or click <b class="button">Cancel</b> to stop the printout. <em>port</em> is the port, such as LPT1, or the file&#8217;s name.</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1">&#8220;The printer on <em>port</em> is out of paper. Load paper, then choose Retry.&#8221;</dt>
<dd>
<p>Load paper.</p>
</dd>
<dt class="hdlist1">&#8220;The printer on <em>port</em> is off line or switched off. Switch it on and put it on line, then choose Retry.&#8221;</dt>
<dd>
<p>The printer is off, its ON LINE (or SELECT) light is off, its cable is loose, or nothing is connected to that port.</p>
</dd>
<dt class="hdlist1">&#8220;The printer on <em>port</em> reports an error. Check that it is switched on, connected and has paper, then choose Retry.&#8221;</dt>
<dd>
<p>The printer signals a fault. For a serial printer, this also means the serial port failed.</p>
</dd>
<dt class="hdlist1">&#8220;The printer on <em>port</em> is not responding. Check that it is switched on and connected, then choose Retry.&#8221;</dt>
<dd>
<p>The printer took nothing for 10 seconds: it is jammed or busy, the cable is unplugged, or, for a serial printer, <strong>Speed (baud)</strong> or <strong>Handshake</strong> does not match the printer (or the cable is wired for another handshake).</p>
</dd>
<dt class="hdlist1"><a id="_ix1612" class="ixterm"></a>&#8220;Could not write to the file <em>file</em>. The disk may be full. Make room, then choose Retry.&#8221;</dt>
<dd>
<p>When printing to a file: the disk is full. Delete files to make room, or click <b class="button">Cancel</b> and print to another disk.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>Each of these is also written to the log file, after <code>Print:</code>.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-printing-start"><a class="anchor" href="#trouble-printing-start"></a>11.8.3. The printout stops before it starts</h4>
<div class="paragraph">
<p><a id="_ix1613" class="ixterm"></a><a id="_ix1614" class="ixterm"></a>These come in a box titled <strong>Print</strong>, and nothing is printed:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1">&#8220;This computer has no port <em>port</em>.&#8221;</dt>
<dd>
<p>The computer&#8217;s BIOS does not list that port: there is no such card, or the port is turned off in the computer&#8217;s setup. Choose the port the printer is on.</p>
</dd>
<dt class="hdlist1"><a id="_ix1615" class="ixterm"></a>&#8220;The port <em>port</em> cannot be opened. Another program may be using it.&#8221;</dt>
<dd>
<p>A serial port that another program, such as Terminal, has open. Close that program or its connection, or use another port.</p>
</dd>
<dt class="hdlist1"><a id="_ix1616" class="ixterm"></a>&#8220;Cannot create the file <em>file</em>.&#8221;</dt>
<dd>
<p>Printing to a file, the file could not be made: its folder does not exist, the disk cannot be written to, or the name is not allowed. (<em>file</em> is <code>(no name)</code> when no name was given; for a name without a folder it shows the USER folder too, such as <code>USER\PRINTER.PRN</code>.) See <a href="#trouble-printing-file">Section 11.8.6</a>.</p>
</dd>
<dt class="hdlist1"><a id="_ix1617" class="ixterm"></a>&#8220;Not enough memory to print.&#8221;, &#8220;Not enough memory to print the picture.&#8221;, or &#8220;Not enough memory to print the window.&#8221;</dt>
<dd>
<p>Close programs to free memory, then print again.</p>
</dd>
<dt class="hdlist1">&#8220;Cannot read the picture <em>file</em>.&#8221;</dt>
<dd>
<p>The picture to print is missing or cannot be read.</p>
</dd>
<dt class="hdlist1">&#8220;The document could not be printed.&#8221; or &#8220;The picture could not be printed.&#8221;</dt>
<dd>
<p>The printout failed part way. Check the printer and print again.</p>
</dd>
</dl>
</div>
</div>
<div class="sect3">
<h4 id="trouble-printing-pictures"><a class="anchor" href="#trouble-printing-pictures"></a>11.8.4. Pictures do not print</h4>
<div class="paragraph">
<p><a id="_ix1618" class="ixterm"></a><a id="_ix1619" class="ixterm"></a><a id="_ix1620" class="ixterm"></a>When a program prints a picture, a window, or a page it draws, and the printer model is <strong>Text only (any printer)</strong>, a box titled <strong>Print</strong> says:</p>
</div>
<div class="paragraph">
<p>&#8220;The printer model chosen in the Control Panel prints text only. To print pictures, choose your printer&#8217;s model on the Control Panel&#8217;s Printer page.&#8221;</p>
</div>
<div class="paragraph">
<p>Choose your printer&#8217;s model on the Printer page (see <a href="#trouble-printing-settings">Section 11.8.1</a>), click <b class="button">OK</b>, and print again. The Printer page reminds you: &#8220;Text only works with any printer; choose your printer&#8217;s model to print pictures too.&#8221;</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-printing-driver"><a class="anchor" href="#trouble-printing-driver"></a>11.8.5. The printer driver is missing</h4>
<div class="paragraph">
<p><a id="_ix1621" class="ixterm"></a><a id="_ix1622" class="ixterm"></a><a id="_ix1623" class="ixterm"></a>With <strong>PostScript</strong> or <strong>PostScript (color)</strong> chosen on the Printer page, DVX prints through a file of its own, the PostScript printer driver. If that file is missing, nothing at all is printed, text or pictures, and a box titled <strong>Print</strong> says:</p>
</div>
<div class="paragraph">
<p>&#8220;The printer driver for <em>model</em> is missing, so DVX cannot print on that printer. To put it back, run Setup and choose Upgrade or repair DVX.&#8221;</p>
</div>
<div class="paragraph">
<p><em>model</em> is <strong>PostScript</strong> or <strong>PostScript (color)</strong>. The log file also has the line <code>Print: the PostScript driver is missing from libs\kpunch\print\drivers</code>. Run Setup and choose <strong>Upgrade or repair DVX</strong> (see <a href="#installing-upgrade">Section 3.8</a>). Until then you can print text with <strong>Text only (any printer)</strong> if the printer can print plain text.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-printing-file"><a class="anchor" href="#trouble-printing-file"></a>11.8.6. Printing to a file</h4>
<div class="paragraph">
<p><a id="_ix1624" class="ixterm"></a><a id="_ix1625" class="ixterm"></a>With <strong>Connected to</strong> set to <strong>File</strong>, DVX writes the printout into a file instead of sending it to a printer. Unless you change <strong>File name</strong>, the file is <code>PRINTER.PRN</code> in your USER folder (for example <code>C:\DVX\USER\PRINTER.PRN</code>): a name without a folder always goes there, so printing to a file works wherever your settings are kept, also when DVX runs from a CD-ROM. To put the file elsewhere, type a full name, such as <code>C:\PRINTOUT.PRN</code>.</p>
</div>
<div class="ulist">
<ul>
<li>
<p>When nothing can be saved at all (DVX runs from a disk it cannot write to and there is no TEMP folder; see <a href="#folders-read-only">Section B.1.4</a>), printing to a name without a folder fails with &#8220;Cannot create the file USER\PRINTER.PRN.&#8221; (with your file&#8217;s name). Type a full name on a disk that can be written to, such as <code>C:\PRINTOUT.PRN</code>.</p>
</li>
<li>
<p><a id="_ix1626" class="ixterm"></a>If <strong>File name</strong> is empty, Control Panel&#8217;s <b class="button">OK</b> shows &#8220;Type the name of the file to print to, or connect the printer to a port.&#8221; in a box titled <strong>Printer</strong>, and Control Panel stays open. In the Print dialog, choosing to print to <strong>File</strong> with no file name gives &#8220;Type the name of the file to print to.&#8221;</p>
</li>
</ul>
</div>
</div>
<div class="sect3">
<h4 id="trouble-printing-dialog"><a class="anchor" href="#trouble-printing-dialog"></a>11.8.7. Print dialog and Page Setup messages</h4>
<div class="paragraph">
<p><a id="_ix1627" class="ixterm"></a><a id="_ix1628" class="ixterm"></a><a id="_ix1629" class="ixterm"></a>The Print dialog shows the model chosen in Control Panel at the bottom, as <code>Printer model: <em>model</em></code>. Its messages come in a box titled <strong>Print</strong>:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>&#8220;The first page to print comes after the last one.&#8221;: the <strong>From</strong> page is after the <strong>To</strong> page.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>Page Setup checks what you type and explains anything it cannot use, in a box titled <strong>Page Setup</strong>:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>&#8220;Lines per page must be 0 (the printer&#8217;s usual length) or from 10 to 200.&#8221;</p>
</li>
<li>
<p>&#8220;Characters per line must be from 20 to 255.&#8221;</p>
</li>
<li>
<p>&#8220;Margins cannot be negative.&#8221;</p>
</li>
<li>
<p>&#8220;Tab width must be from 1 to 16.&#8221;</p>
</li>
<li>
<p>&#8220;The top and bottom margins leave no room for text.&#8221;</p>
</li>
<li>
<p>&#8220;The left and right margins leave less than 10 characters for text.&#8221;</p>
</li>
<li>
<p><a id="_ix1630" class="ixterm"></a>&#8220;The page setup could not be saved.&#8221;: <code>DVX.INI</code> could not be written, because the disk of the USER folder is full or cannot be written to, or <code>DVX.INI</code> exists but cannot be read.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>Page Setup&#8217;s changes are saved when you click <b class="button">OK</b> in the <strong>Page Setup</strong> dialog, even if you then cancel Control Panel. If the page setup in <code>DVX.INI</code> cannot be used (for example after editing it by hand), DVX uses the default page setup instead.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-printing-programs"><a class="anchor" href="#trouble-printing-programs"></a>11.8.8. Printing from particular programs</h4>
<div class="dlist">
<dl>
<dt class="hdlist1"><a id="_ix1631" class="ixterm"></a><a id="_ix1632" class="ixterm"></a><a id="_ix1633" class="ixterm"></a>Icon Editor</dt>
<dd>
<p><a id="_ix1634" class="ixterm"></a>&#8220;Could not prepare the icon for printing.&#8221; The Icon Editor prints through a scratch copy of the icon, <code>PRINTICO.BMP</code>, in the TEMP folder (or in its own folder in USER when there is no TEMP folder). Neither could be written to. Set <code>TEMP</code> to a folder on a disk with free space (see <a href="#trouble-files-temp">Section 11.12.8</a>).</p>
</dd>
<dt class="hdlist1">BASIC Demo</dt>
<dd>
<p>&#8220;To print the report, choose your printer&#8217;s model on the Control Panel&#8217;s Printer page.&#8221; The printer model is <strong>Text only (any printer)</strong>.</p>
</dd>
<dt class="hdlist1">Programs written in DVX BASIC</dt>
<dd>
<p>These can stop with a <strong>BASIC Runtime Error</strong> box (see <a href="#trouble-programs-basic">Section 11.14</a>) about printing, as listed below. When a BASIC program is ended from the Task Manager, anything it had drawn or written for the printer and not yet printed is thrown away, not printed.</p>
<div class="ulist">
<ul>
<li>
<p><a id="_ix1635" class="ixterm"></a>&#8220;Printing is not installed&#8221;, with &#8220;The Printer object needs the printing library (print.lib).&#8221;: a part of DVX is missing. Repair DVX with Setup.</p>
</li>
<li>
<p>&#8220;The printer prints text only&#8221;, with &#8220;The printer model chosen in the Control Panel prints text only. To print with the Printer object, choose your printer&#8217;s model on the Control Panel&#8217;s Printer page.&#8221;: choose your model on the Printer page.</p>
</li>
<li>
<p>&#8220;The printer driver is missing&#8221;, with &#8220;The printer driver for <em>model</em> is missing, so DVX cannot print on that printer. To put it back, run Setup and choose Upgrade or repair DVX.&#8221;: see <a href="#trouble-printing-driver">Section 11.8.5</a>.</p>
</li>
<li>
<p>&#8220;Out of memory&#8221;, with &#8220;There is not enough memory for the Printer.&#8221; or &#8220;There is not enough memory for the Printer&#8217;s page.&#8221;: close programs.</p>
</li>
<li>
<p>Error 68, &#8220;Device unavailable&#8221;: the printer port could not be opened, or printing is not installed. The log file has a line starting <code>Print:</code> that says why.</p>
</li>
<li>
<p>Error 75, &#8220;Cannot create the printer spool file&#8221;: printing to LPT1 or PRN needs a scratch file, and none could be made. Check that <code>TEMP</code> names a folder with free space.</p>
</li>
</ul>
</div>
</dd>
</dl>
</div>
<div class="paragraph">
<p><a id="_ix1636" class="ixterm"></a>If the Printer page shows only &#8220;Printing is not installed.&#8221;, a part of DVX is missing. Repair DVX with Setup.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-printing-ini"><a class="anchor" href="#trouble-printing-ini"></a>11.8.9. Printer settings in DVX.INI</h4>
<div class="paragraph">
<p><a id="_ix1637" class="ixterm"></a><a id="_ix1638" class="ixterm"></a>The <code>[printer]</code> section of <code>DVX.INI</code> keeps the Printer page&#8217;s and Page Setup&#8217;s settings: <code>port</code> (<code>LPT1</code>), <code>file</code> (<code>PRINTER.PRN</code>), <code>model</code> (<code>text</code>), <code>linesPerPage</code> (<code>0</code>, the printer&#8217;s usual length: 66 lines, 60 on a laser printer), <code>columns</code> (<code>80</code>), <code>marginTop</code>, <code>marginBottom</code> (<code>3</code>), <code>marginLeft</code>, <code>marginRight</code> (<code>5</code>), <code>tabWidth</code> (<code>8</code>), <code>wrap</code> (<code>true</code>), <code>header</code> (<code>&amp;f</code>), <code>footer</code> (<code>Page &amp;p</code>), <code>baud</code> (<code>9600</code>), and <code>handshake</code> (<code>dtrdsr</code>; the others are <code>none</code>, <code>xonxoff</code>, and <code>rtscts</code>). The values in brackets are the ones DVX comes with. A <code>baud</code> value DVX does not offer counts as 9600. See <a href="#folders-dvx-ini">Section B.2</a>.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="trouble-network"><a class="anchor" href="#trouble-network"></a>11.9. The network does not work</h3>
<div class="paragraph">
<p><a id="_ix1639" class="ixterm"></a><a id="_ix1640" class="ixterm"></a>This section covers the network card, getting an address, finding computers by name, and reaching servers. Networking is an optional part of DVX. Terminal works over serial ports and modems without it; only Telnet, the secure link over the network, and Software&#8217;s package server need it.</p>
</div>
<div class="sect3">
<h4 id="trouble-network-basics"><a class="anchor" href="#trouble-network-basics"></a>11.9.1. How DVX uses the network</h4>
<div class="paragraph">
<p><a id="_ix1641" class="ixterm"></a><a id="_ix1642" class="ixterm"></a><a id="_ix1643" class="ixterm"></a>Knowing how DVX uses the network helps you find what is wrong:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>DVX reaches the network card through the card&#8217;s DOS packet driver, which must be loaded before DVX starts, usually from <code>AUTOEXEC.BAT</code>. For an NE2000 card, for example, the line is <code>NE2000.COM 0x60 3 0x300</code>. See <a href="#net-driver">Section 4.3</a>.</p>
</li>
<li>
<p>DVX looks for the packet driver on software interrupts 60h to 80h, or only on the one set as <strong>Packet driver</strong> on Control Panel&#8217;s Network page. It needs a packet driver for Ethernet.</p>
</li>
<li>
<p><a id="_ix1644" class="ixterm"></a>The network starts the first time a program uses it (to connect, or to look up a name), not when DVX starts. The <b class="button">Restart</b> button on Control Panel&#8217;s Network page also starts it.</p>
</li>
<li>
<p>Right after the network starts, it asks the network&#8217;s DHCP server for an address. Programs wait up to 20 seconds for one before they try to connect.</p>
</li>
<li>
<p><a id="_ix1645" class="ixterm"></a>While DVX runs a DOS program, the network is stopped and open connections end. When a program ends, the connections it left open are closed.</p>
</li>
</ul>
</div>
</div>
<div class="sect3">
<h4 id="trouble-network-status"><a class="anchor" href="#trouble-network-status"></a>11.9.2. The Network Status window</h4>
<div class="paragraph">
<p><a id="_ix1646" class="ixterm"></a><a id="_ix1647" class="ixterm"></a><a id="_ix1648" class="ixterm"></a>To see what the network is doing, open Control Panel, click the <strong>Network</strong> tab, and click <b class="button">Status&#8230;&#8203;</b>: the <strong>Network Status</strong> window opens. It shows, and updates every second:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>The state of the network (one of the messages below).</p>
</li>
<li>
<p><code>Address</code>, <code>mask</code>, and <code>gateway</code>: the address the computer has, or <code>-</code> when it has none.</p>
</li>
<li>
<p><code>Name servers</code>: the computers it asks to find names, or <code>-</code> when it has none.</p>
</li>
<li>
<p><code>Card</code>: the packet driver&#8217;s name and the card&#8217;s hardware address.</p>
</li>
<li>
<p>How many packets were received and sent.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>The window can stay open after you close Control Panel. The state line is one of these:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">State</th>
<th class="tableblock halign-left valign-top">What it means</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1649" class="ixterm"></a>&#8220;Networking is not started&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No program has used the network yet. See <a href="#trouble-network-notstarted">Section 11.9.6</a>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1650" class="ixterm"></a>&#8220;No packet driver found: load one (for example NE2000.COM) before DVX&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX found no packet driver. See <a href="#trouble-network-driver">Section 11.9.4</a>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1651" class="ixterm"></a>&#8220;Waiting for a DHCP server&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The network runs but has no address yet. See <a href="#trouble-network-dhcp">Section 11.9.5</a>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1652" class="ixterm"></a>&#8220;Connected&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The network has an address and is ready.</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect3">
<h4 id="trouble-network-notinstalled"><a class="anchor" href="#trouble-network-notinstalled"></a>11.9.3. Networking is not installed</h4>
<div class="paragraph">
<p><a id="_ix1653" class="ixterm"></a><a id="_ix1654" class="ixterm"></a>If Control Panel&#8217;s Network page shows only &#8220;Networking is not installed.&#8221;, the Networking part of DVX was not installed. Terminal then says &#8220;Telnet and the secure link over the network need Networking, which is not installed. Setup can add it.&#8221;, and Software&#8217;s server pages say &#8220;The package server needs DVX&#8217;s Networking part. To add it, run Setup from DVX&#8217;s CD or Disk 1 and choose Upgrade or repair.&#8221; To add it:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Run Setup from the DVX CD or Disk 1, and choose <strong>Upgrade or repair DVX</strong> with the folder DVX is in.</p>
</li>
<li>
<p>On the page that lists the parts of DVX (<strong>Parts of DVX to have</strong>), tick <strong>Networking</strong>, and go on.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>See <a href="#installing-parts">Section 3.5</a>.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-network-driver"><a class="anchor" href="#trouble-network-driver"></a>11.9.4. No packet driver found</h4>
<div class="paragraph">
<p><a id="_ix1655" class="ixterm"></a><a id="_ix1656" class="ixterm"></a>When the Network Status window says &#8220;No packet driver found: load one (for example NE2000.COM) before DVX&#8221;, DVX found no packet driver, so only this computer itself (the address 127.0.0.1) can be reached. To fix it:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Load your network card&#8217;s packet driver before DVX: add its line to <code>AUTOEXEC.BAT</code> (see <a href="#trouble-first-dos-files">Section 11.1.8</a>), or type it at the DOS prompt before you start DVX. The packet driver comes with the card, or from the card maker; its line gives the software interrupt (such as <code>0x60</code>) and the card&#8217;s IRQ and port.</p>
</li>
<li>
<p>If you loaded the driver after DVX started, click <b class="button">Restart</b> on Control Panel&#8217;s Network page, so DVX looks again.</p>
</li>
<li>
<p>Set <strong>Packet driver</strong> on the Network page to <strong>Find it</strong>, unless you know the interrupt. If it names an interrupt, DVX looks only there.</p>
</li>
<li>
<p>Use an interrupt from 60h to 80h for the packet driver; DVX does not look elsewhere.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>The log file says more, in lines starting <code>dvxnet:</code>:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Log line</th>
<th class="tableblock halign-left valign-top">What it means</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>dvxnet: packet driver "<em>name</em>" at INT <em>nn</em>h</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The packet driver was found. Normal.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>dvxnet: no packet driver found; only local (127.0.0.1) connections work</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No packet driver was found where DVX looked.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>dvxnet: the packet driver at INT <em>nn</em>h is not an Ethernet driver</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The driver is for another kind of network. Use the card&#8217;s Ethernet packet driver.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>dvxnet: no conventional memory for the packet buffers</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX needs about 26 KB of conventional memory for the network card. Free some (see <a href="#trouble-start-memory">Section 11.2.6</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>dvxnet: the packet driver refused to deliver IP or ARP frames</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Another program already takes the network&#8217;s traffic from the packet driver, such as a resident network program. Do not load other programs that use the packet driver with DVX, and load the packet driver again.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>dvxnet: the packet driver did not give its hardware address</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The driver or the card did not answer. Check the driver&#8217;s settings (interrupt, IRQ, and port) against the card, and try the card&#8217;s own setup or test program.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>dvxnet: could not lock the packet receiver in memory</code>, <code>dvxnet: no real-mode callback is available for the packet receiver</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX could not set up its connection to the network card. Restart the computer; if it happens again, send the log file with a problem report.</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect3">
<h4 id="trouble-network-dhcp"><a class="anchor" href="#trouble-network-dhcp"></a>11.9.5. Waiting for a DHCP server</h4>
<div class="paragraph">
<p><a id="_ix1657" class="ixterm"></a><a id="_ix1658" class="ixterm"></a><a id="_ix1659" class="ixterm"></a>&#8220;Waiting for a DHCP server&#8221; means the network runs but no DHCP server has given the computer an address. The cable may be unplugged, the card may not be connected to the network, or the network may have no DHCP server (on such a network every computer has a fixed address).</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Check the cable and the network.</p>
</li>
<li>
<p>On a network without a DHCP server, untick <strong>Get the address automatically (DHCP)</strong> on Control Panel&#8217;s Network page, and type the <strong>Address</strong>, <strong>Subnet mask</strong>, and <strong>Gateway</strong> the network&#8217;s owner gives you. Click <b class="button">OK</b>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>If the log file has <code>dvxnet: DHCP could not start</code>, the network could not begin asking for an address. Click <b class="button">Restart</b> on the Network page, or restart DVX. When an address arrives, the log file says <code>dvxnet: address <em>address</em></code>.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-network-notstarted"><a class="anchor" href="#trouble-network-notstarted"></a>11.9.6. Networking is not started</h4>
<div class="paragraph">
<p>&#8220;Networking is not started&#8221; is normal until a program uses the network. Click <b class="button">Restart</b> on the Network page to start it now.</p>
</div>
<div class="paragraph">
<p>If it stays that way, the fixed address settings in <code>DVX.INI</code> may be wrong. (Control Panel checks them, but a hand-edited <code>DVX.INI</code> is not checked.) The network then refuses to start, and every connection fails; Terminal even says that a host given by its number was not found. Check <strong>Address</strong>, <strong>Subnet mask</strong>, and <strong>Gateway</strong> on the Network page, or tick <strong>Get the address automatically (DHCP)</strong>.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-network-settings"><a class="anchor" href="#trouble-network-settings"></a>11.9.7. Control Panel will not accept the network settings</h4>
<div class="paragraph">
<p><a id="_ix1660" class="ixterm"></a><a id="_ix1661" class="ixterm"></a>When you click <b class="button">OK</b> in Control Panel, it checks the Network page. If a setting cannot work, a box titled <strong>Network</strong> says what is wrong, and nothing is saved until you fix it:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Message</th>
<th class="tableblock halign-left valign-top">What to do</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The computer name may only use letters, digits and hyphens&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Computer name</strong> is empty, has a space or another character, starts or ends with a hyphen, or is 64 characters or longer. Use letters, digits, and hyphens only, such as <code>DVX</code>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The packet driver interrupt must be between 0x60 and 0x80&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>DVX.INI</code> names an interrupt outside 60h to 80h. Choose <strong>Find it</strong> or an interrupt in the list.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;A name server is not a valid address (like 192.168.1.1)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Name server 1</strong> or <strong>Name server 2</strong> is not four numbers with dots between them. A name such as <code>dns.example.org</code> is not accepted there. Type the number, or leave it empty to use the network&#8217;s own.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The address is not a valid address (like 192.168.1.10)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DHCP is off, and <strong>Address</strong> is empty or not four numbers from 0 to 255 with dots between them.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The subnet mask is not valid (like 255.255.255.0)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DHCP is off, and <strong>Subnet mask</strong> is empty, not an address, <code>0.0.0.0</code>, or not a proper mask.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The gateway is not a valid address (like 192.168.1.1)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DHCP is off, and <strong>Gateway</strong> is filled in but is not an address. It may be left empty.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>After <b class="button">OK</b>, if the settings changed, the network restarts with them, and connections that were open are closed. <b class="button">Restart</b> uses the saved settings, not changes you have not yet saved with <b class="button">OK</b>.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-network-dns"><a class="anchor" href="#trouble-network-dns"></a>11.9.8. A computer&#8217;s name cannot be found</h4>
<div class="paragraph">
<p><a id="_ix1662" class="ixterm"></a><a id="_ix1663" class="ixterm"></a><a id="_ix1664" class="ixterm"></a><a id="_ix1665" class="ixterm"></a>Terminal says &#8220;The host <em>name</em> was not found&#8221;, Software says &#8220;The package server cannot be reached: Cannot find <em>name</em> on the network.&#8221;, and a DVX BASIC program may say &#8220;That name could not be found (check the name and the network settings)&#8221;, when a name could not be turned into an address. The causes are:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>The name is misspelled or does not exist.</p>
</li>
<li>
<p>There is no name server: the network gave none and none is set, or there is no packet driver.</p>
</li>
<li>
<p>The name server did not answer within 30 seconds.</p>
</li>
<li>
<p>The network gave no address within 20 seconds.</p>
</li>
<li>
<p>The network cannot start because its fixed settings are wrong (see <a href="#trouble-network-notstarted">Section 11.9.6</a>).</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>What to do:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Check the name.</p>
</li>
<li>
<p>Open the Network Status window. If it says <code>Name servers -</code>, there is none: type a name server&#8217;s address as <strong>Name server 1</strong> on the Network page (your network&#8217;s owner or provider gives it).</p>
</li>
<li>
<p>Try the computer&#8217;s number (such as <code>192.168.1.20</code>) instead of its name.</p>
</li>
</ol>
</div>
</div>
<div class="sect3">
<h4 id="trouble-network-reach"><a class="anchor" href="#trouble-network-reach"></a>11.9.9. A server cannot be reached</h4>
<div class="paragraph">
<p><a id="_ix1666" class="ixterm"></a><a id="_ix1667" class="ixterm"></a><a id="_ix1668" class="ixterm"></a>When Terminal connects over the network (Telnet, or the secure link with <strong>Connect over the network</strong> ticked), it shows how the connection goes in its status bar and on the screen. These end the connection:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Message</th>
<th class="tableblock halign-left valign-top">What it means and what to do</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1669" class="ixterm"></a>&#8220;<em>host</em> refused the connection on port <em>port</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The computer is there, but nothing answers on that port: the port number is wrong (23 for Telnet; a secure-link proxy usually 2323), or the server program is not running.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1670" class="ixterm"></a>&#8220;<em>host</em> did not answer&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No answer within 30 seconds: the address is wrong, the computer is off or not on the network, or something in between drops the connection. Check that the network works in the Network Status window.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1671" class="ixterm"></a>&#8220;<em>host</em> cannot be reached: check the network settings&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX has no way to the computer: it has no address yet, no <strong>Gateway</strong> is set for a computer on another network, there is no packet driver, or the network is stopped. Check the Network page and the Network Status window.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The connection to <em>host</em> failed&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Some other network failure, such as too many connections open. Close other network programs or connections, and connect again. Restart DVX if it keeps happening.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>host</em> closed the connection&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The other computer ended the session, as a bulletin board does when you log off.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1672" class="ixterm"></a>&#8220;The connection to <em>host</em> was lost&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The connection broke. Connect again, and check the network.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Networking is not installed&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The Networking part of DVX is not installed (see <a href="#trouble-network-notinstalled">Section 11.9.3</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;No host name is set&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A program connected without a host name.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>Normal progress messages are &#8220;Connecting to <em>host</em> port <em>port</em>&#8221;, &#8220;Connected to <em>host</em> port <em>port</em>&#8221;, and &#8220;Disconnected&#8221; after you disconnect. For the package server, see <a href="#trouble-addons-server">Section 11.11.16</a>.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-network-basic"><a class="anchor" href="#trouble-network-basic"></a>11.9.10. Network messages in BASIC programs</h4>
<div class="paragraph">
<p><a id="_ix1673" class="ixterm"></a>Programs written in DVX BASIC that use the network may show these texts. They mean what they say; the ones most often seen are:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>&#8220;The other computer refused the connection&#8221;, &#8220;The other computer did not answer in time&#8221; (a BASIC program waits 20 seconds), &#8220;The other computer broke off the connection&#8221;, and &#8220;The connection was given up&#8221;.</p>
</li>
<li>
<p>&#8220;That network cannot be reached (check the network settings)&#8221;: DVX found no way to the computer. Check the network settings (see <a href="#trouble-network-reach">Section 11.9.9</a>).</p>
</li>
<li>
<p>&#8220;The network is not running&#8221;, &#8220;Out of network memory&#8221;, and &#8220;Too many connections are open&#8221;.</p>
</li>
<li>
<p>Others: &#8220;No error&#8221;, &#8220;Nothing to do yet (try again later)&#8221;, &#8220;The connection is still being made&#8221;, &#8220;Not connected&#8221;, &#8220;Already connected&#8221;, &#8220;The connection is closed for sending&#8221;, &#8220;That port is already in use&#8221;, &#8220;That address is not this computer&#8217;s&#8221;, &#8220;Not an open connection&#8221;, &#8220;The message is too long&#8221;, &#8220;Sending to everyone needs SO_BROADCAST&#8221;, and &#8220;The network operation failed&#8221;.</p>
</li>
<li>
<p><a id="_ix1674" class="ixterm"></a>When looking up names: &#8220;That name could not be found (check the name and the network settings)&#8221; (the name is misspelled or does not exist, or there is no name server: see <a href="#trouble-network-dns">Section 11.9.8</a>), &#8220;The name server did not answer in time&#8221;, and &#8220;The name could not be looked up&#8221;.</p>
</li>
<li>
<p>When opening a connection: &#8220;Bad connection settings&#8221;, &#8220;The port could not be opened&#8221;, &#8220;Networking is not installed&#8221;, and &#8220;The connection could not be opened&#8221;.</p>
</li>
</ul>
</div>
</div>
<div class="sect3">
<h4 id="trouble-network-ini"><a class="anchor" href="#trouble-network-ini"></a>11.9.11. Network settings in DVX.INI</h4>
<div class="paragraph">
<p><a id="_ix1675" class="ixterm"></a><a id="_ix1676" class="ixterm"></a>The Network page keeps its settings in the <code>[network]</code> section of <code>DVX.INI</code> (see <a href="#folders-dvx-ini">Section B.2</a>):</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 25%;">
<col style="width: 75%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">What it sets</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>dhcp</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code> (the default) gets the address, mask, gateway, and name servers from a DHCP server; <code>false</code> uses the values below.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>address</code>, <code>netmask</code>, <code>gateway</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The fixed address, subnet mask, and gateway, used only when <code>dhcp = false</code>. <code>gateway</code> may be empty.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>dns1</code>, <code>dns2</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Name servers, as numbers. Empty uses the DHCP server&#8217;s. When set, they are used instead of the DHCP server&#8217;s.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>hostname</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">This computer&#8217;s name on the network: letters, digits, and hyphens (<code>DVX</code> unless you change it).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>vector</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>auto</code> (search 60h to 80h), or the packet driver&#8217;s interrupt, written with <code>0x</code> in front, such as <code>0x60</code>. Without <code>0x</code>, the number is read as decimal.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>Wrong fixed settings typed into the file by hand keep the network from starting at all.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="trouble-serial"><a class="anchor" href="#trouble-serial"></a>11.10. Serial ports, modems, and Terminal</h3>
<div class="paragraph">
<p><a id="_ix1677" class="ixterm"></a><a id="_ix1678" class="ixterm"></a><a id="_ix1679" class="ixterm"></a><a id="_ix1680" class="ixterm"></a>This section covers Terminal&#8217;s connections over a serial port, a modem, and the secure link, and its file transfers. For Telnet and other connections over the network, see <a href="#trouble-network-reach">Section 11.9.9</a>.</p>
</div>
<div class="sect3">
<h4 id="trouble-serial-status"><a class="anchor" href="#trouble-serial-status"></a>11.10.1. Where Terminal shows what happens</h4>
<div class="paragraph">
<p><a id="_ix1681" class="ixterm"></a>Terminal reports each step of a connection, and each problem, in three places: at the left of its status bar, on the terminal screen in square brackets (for example <code>[Connected to COM1 at 9600 bps]</code>), and in the log file as a line starting <code>Terminal:</code>. The messages in this section appear in all three. A problem ends the connection; choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Connect</b></span> to try again.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-serial-port"><a class="anchor" href="#trouble-serial-port"></a>11.10.2. A COM port cannot be opened</h4>
<div class="paragraph">
<p><a id="_ix1682" class="ixterm"></a><a id="_ix1683" class="ixterm"></a>&#8220;COM<em>n</em> could not be opened: <em>reason</em>&#8221; means Terminal could not use the serial port chosen under <strong>Port</strong> on the <strong>Connection</strong> page of the Session Settings (<span class="menuseq"><b class="menu">Settings</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Session Settings&#8230;&#8203;</b></span>). The reason is one of these:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Reason</th>
<th class="tableblock halign-left valign-top">What to do</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;there is no serial port there&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The computer&#8217;s BIOS lists no port with that number, or nothing answers at its address. Choose another port. Check that the port is turned on in the computer&#8217;s setup, and, for an add-in card, its jumpers.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;it is already in use&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Another DVX program, such as another Terminal window, has that port open. Close it first.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;its interrupt could not be found&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Rare. Check the port&#8217;s IRQ: COM1 and COM3 normally use IRQ 4, COM2 and COM4 IRQ 3.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;a setting is not supported&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The speed, data bits, parity, stop bits, or flow control cannot be used on that port. Choose another setting.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;it did not respond&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Any other failure, such as too little memory. Close programs and try again.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>DVX takes each COM port&#8217;s address from the computer&#8217;s BIOS and finds its interrupt by itself; there are no serial port settings in <code>DVX.INI</code>.</p>
</div>
<div class="paragraph">
<p>&#8220;COM<em>n</em> could not be opened for the secure link&#8221; is the same problem for a secure link over a COM port. &#8220;Connected to COM<em>n</em> at <em>speed</em> bps&#8221; means the port is open. &#8220;COM<em>n</em> stopped working&#8221; means the port stopped delivering data; choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Disconnect</b></span>, then connect again.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-serial-garbage"><a class="anchor" href="#trouble-serial-garbage"></a>11.10.3. Garbage, nothing, or doubled letters on the screen</h4>
<div class="dlist">
<dl>
<dt class="hdlist1"><a id="_ix1684" class="ixterm"></a><a id="_ix1685" class="ixterm"></a><a id="_ix1686" class="ixterm"></a>Random characters appear</dt>
<dd>
<p>The <strong>Speed (bps)</strong>, <strong>Data bits</strong>, <strong>Parity</strong>, or <strong>Stop bits</strong> on the <strong>Connection</strong> page do not match the other side. Both sides must use the same settings.</p>
</dd>
<dt class="hdlist1">Nothing appears when you type</dt>
<dd>
<p>Turn on <span class="menuseq"><b class="menu">Settings</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Local Echo</b></span>.</p>
</dd>
<dt class="hdlist1">Every letter appears twice</dt>
<dd>
<p>Turn off <span class="menuseq"><b class="menu">Settings</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Local Echo</b></span>. It is off unless you turn it on.</p>
</dd>
<dt class="hdlist1">Characters are lost at high speed, or transfers fail</dt>
<dd>
<p>Set <strong>Flow control</strong> to <strong>RTS/CTS</strong> when the cable and the other side support it. Without flow control, ZMODEM downloads ask the sender to pause every 2 KB.</p>
</dd>
<dt class="hdlist1"><span class="menuseq"><b class="menu">Edit</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Send Break</b></span> does nothing</dt>
<dd>
<p>It works only on serial port and modem connections.</p>
</dd>
</dl>
</div>
</div>
<div class="sect3">
<h4 id="trouble-serial-modem"><a class="anchor" href="#trouble-serial-modem"></a>11.10.4. Modems</h4>
<div class="paragraph">
<p><a id="_ix1687" class="ixterm"></a><a id="_ix1688" class="ixterm"></a><a id="_ix1689" class="ixterm"></a>Terminal sends the <strong>Setup command</strong> from the <strong>Modem</strong> page, dials, and waits for the modem&#8217;s answers (such as OK, CONNECT, BUSY, NO CARRIER, NO ANSWER, NO DIALTONE, and ERROR). Everything the modem says also appears on the screen. Its messages:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Message</th>
<th class="tableblock halign-left valign-top">What it means and what to do</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Setting up the modem on COM<em>n</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Normal: the setup command was sent.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The modem on COM<em>n</em> did not answer&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No OK within 5 seconds of the setup command: the modem is off, not on that port, or its cable is loose; the speed or the setup command is wrong; or the modem answers with numbers instead of words. To test it, leave <strong>Phone number</strong> empty, connect, and type <code>AT</code> and <kbd>Enter</kbd> yourself. A setup command such as <code>ATZ</code> (the default) usually makes it answer in words again.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The modem refused the setup command <em>command</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The modem answered ERROR. Correct <strong>Setup command</strong>, or leave it empty to send none.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Dialing <em>number</em> (try <em>n</em> of <em>n</em>)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Normal.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Connected (<em>modem&#8217;s message</em>)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Connected, for example <code>Connected (CONNECT 14400)</code>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1690" class="ixterm"></a>&#8220;The line is busy: dialing again in <em>n</em> seconds&#8221;, &#8220;No carrier: dialing again in <em>n</em> seconds&#8221;, &#8220;No answer: dialing again in <em>n</em> seconds&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The call did not connect; Terminal dials again. After the last try, the reason alone ends the connection: &#8220;The line is busy&#8221;, &#8220;No carrier&#8221;, or &#8220;No answer&#8221;. Try later, or raise <strong>Redial tries</strong> (0 to 99) or <strong>Redial wait (s)</strong> (1 to 300 seconds) on the <strong>Modem</strong> page. &#8220;No answer&#8221; also means the modem gave no result within 60 seconds of dialing.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1691" class="ixterm"></a>&#8220;No dial tone: check the phone line&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The modem heard no dial tone. Plug in the phone line, and check it with a telephone.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The modem refused the dial command&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The modem answered ERROR to the <strong>Dial command</strong> and number. Check the dial command (usually <code>ATDT</code> for tone or <code>ATDP</code> for pulse dialing) and the number&#8217;s characters.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1692" class="ixterm"></a>&#8220;Carrier lost: the call ended&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The call dropped after it connected.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Modem ready on COM<em>n</em>: type AT commands&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Normal when <strong>Phone number</strong> is empty: type commands to the modem yourself.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Hung up&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Normal after <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Disconnect</b></span>.</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect3">
<h4 id="trouble-serial-secure"><a class="anchor" href="#trouble-serial-secure"></a>11.10.5. The secure link</h4>
<div class="paragraph">
<p><a id="_ix1693" class="ixterm"></a><a id="_ix1694" class="ixterm"></a><a id="_ix1695" class="ixterm"></a>The secure link encrypts everything between Terminal and the secure-link proxy program on the other computer, over a COM port or, with <strong>Connect over the network</strong> ticked, over the network (see <a href="#terminal-secure-link">Section 9.7</a>). Its messages:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Message</th>
<th class="tableblock halign-left valign-top">What it means and what to do</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Setting up the secure link on COM<em>n</em>&#8221;, &#8220;Connecting to <em>host</em> port <em>port</em> for the secure link&#8221;, &#8220;Setting up the secure link with <em>host</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Normal progress. Over the network, the network messages can appear at this step too (see <a href="#trouble-network-reach">Section 11.9.9</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Secure link established&#8221; or &#8220;Secure link established (passphrase checked)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">It worked. Press <kbd>Enter</kbd>; the proxy says <code>SecLink proxy ready.</code> and then connects to the bulletin board.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The passphrase does not match the host&#8217;s&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The two passphrases differ, or only one side has one. Use exactly the same passphrase as the proxy, or none on both sides.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The host did not answer the secure link&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The other side said nothing within 30 seconds: the proxy is not running, or the port, the cable, the speed, or the flow control is wrong. Check that the proxy is running, that the speeds and flow control (<strong>None</strong> or <strong>RTS/CTS</strong>) match, and that the line uses 8 data bits, no parity, and 1 stop bit.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1696" class="ixterm"></a>&#8220;The secure link cannot use XON/XOFF flow control: choose None or RTS/CTS&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The session uses <strong>XON/XOFF</strong> flow control over a COM port, which the secure link cannot use (it sends those characters as part of its data). Session Settings does not accept it, so the setting was made another way, such as by editing Terminal&#8217;s settings file. Choose <strong>None</strong> or <strong>RTS/CTS</strong> in <strong>Flow control</strong>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The secure link could not be set up&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Any other failure: the proxy is from another version, the line dropped, or the line sends back everything it receives. Use matching versions of DVX and the proxy, and check the cable or modem.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The secure link was lost&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No answer from the other side for 30 seconds, or the line or network connection closed. Connect again, and check the cable or network.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Out of memory for the secure link&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Close programs, and connect again.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>With <strong>Ask for the passphrase when connecting (never save it)</strong> ticked, a window titled <strong>Secure Link Passphrase</strong> asks &#8220;Passphrase for the secure link:&#8221;; <b class="button">Cancel</b> does not connect. A passphrase typed on the <strong>Secure Link</strong> page is saved, scrambled, in Terminal&#8217;s settings file.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-serial-terminal"><a class="anchor" href="#trouble-serial-terminal"></a>11.10.6. Terminal&#8217;s messages</h4>
<div class="paragraph">
<p><a id="_ix1697" class="ixterm"></a>Terminal&#8217;s boxes are titled <strong>Terminal</strong> unless noted:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><a id="_ix1698" class="ixterm"></a>&#8220;Telnet and the secure link over the network need Networking, which is not installed. Setup can add it.&#8221;</dt>
<dd>
<p>Add the Networking part with Setup (see <a href="#trouble-network-notinstalled">Section 11.9.3</a>). Serial and modem connections work without it.</p>
</dd>
<dt class="hdlist1"><a id="_ix1699" class="ixterm"></a>&#8220;Enter the host name on the Network page of Session Settings first.&#8221;</dt>
<dd>
<p>Choose <span class="menuseq"><b class="menu">Settings</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Session Settings&#8230;&#8203;</b></span>, click the <strong>Network</strong> tab, and type the <strong>Host name</strong>.</p>
</dd>
<dt class="hdlist1"><a id="_ix1700" class="ixterm"></a>&#8220;A secure link over a COM port cannot use XON/XOFF flow control. Choose None or RTS/CTS.&#8221;</dt>
<dd>
<p>You clicked <b class="button">OK</b> in Session Settings with <strong>Secure link</strong> in <strong>Connect with</strong>, <strong>Connect over the network</strong> not ticked, and <strong>XON/XOFF</strong> in <strong>Flow control</strong>. The secure link sends the XON and XOFF characters as part of its data, so it cannot use them for flow control. Choose <strong>None</strong> or <strong>RTS/CTS</strong> (matching the proxy), and click <b class="button">OK</b> again.</p>
</dd>
<dt class="hdlist1">&#8220;A file transfer is running. Cancel it and close?&#8221;</dt>
<dd>
<p>You are closing Terminal during a transfer. <b class="button">No</b> keeps it open.</p>
</dd>
<dt class="hdlist1">&#8220;You are connected. Disconnect and close?&#8221;</dt>
<dd>
<p>You are closing Terminal while connected, dialing, or connecting. <b class="button">No</b> keeps it open.</p>
</dd>
<dt class="hdlist1"><a id="_ix1701" class="ixterm"></a>&#8220;The capture file could not be opened.&#8221;</dt>
<dd>
<p>After <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Capture to File&#8230;&#8203;</b></span>: the file cannot be written, because the disk is a CD-ROM, write-protected, or full, or the folder does not exist. Choose a file on a disk you can write to, such as in your USER folder.</p>
</dd>
<dt class="hdlist1"><a id="_ix1702" class="ixterm"></a>&#8220;No file transfer can be started now.&#8221; (title <strong>File Transfer</strong>)</dt>
<dd>
<p>Too many transfers are running (in other programs too), memory is short, or the connection is not open. Wait for or cancel other transfers, close programs, or connect first.</p>
</dd>
<dt class="hdlist1">&#8220;Add another file to send in the same batch?&#8221; (title <strong>Send Files</strong>)</dt>
<dd>
<p>With YMODEM and ZMODEM, you can send several files at once. <b class="button">No</b> starts sending.</p>
</dd>
<dt class="hdlist1">&#8220;Delete "<em>name</em>" from the phone book?&#8221; (title <strong>Phone Book</strong>)</dt>
<dd>
<p><b class="button">Yes</b> deletes the session. The last session cannot be deleted.</p>
</dd>
<dt class="hdlist1"><a id="_ix1703" class="ixterm"></a>&#8220;The phone book is full. Delete an entry first.&#8221; (title <strong>Phone Book</strong>)</dt>
<dd>
<p>The phone book holds 32 sessions.</p>
</dd>
<dt class="hdlist1"><a id="_ix1704" class="ixterm"></a>&#8220;The phone book <em>file</em> cannot be read. Terminal goes on, but does not save changes to the phone book, so the sessions in the file are not lost.&#8221;</dt>
<dd>
<p>Terminal&#8217;s settings file, <code>TERMINAL.INI</code> in <code>USER\APPS\KPUNCH\TERMINAL</code>, is there but cannot be read: it is damaged, or its disk failed. Terminal starts with the usual session and does not save over the file, so you can restore it from a backup. Delete the file to start a new phone book, or put a good copy in its place, and start Terminal again.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>Terminal also writes notes on its screen in square brackets:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><a id="_ix1705" class="ixterm"></a><code>[The phone book could not be saved]</code>: Terminal&#8217;s settings file could not be written, because the disk is full or cannot be written to. Make room, or keep the USER folder on a disk that can be written to (see <a href="#trouble-files-dvxuser">Section 11.12.7</a>).</p>
</li>
<li>
<p><code>[The download folder <em>folder</em> could not be created.]</code>: when receiving with YMODEM or ZMODEM. The folder is on a disk that cannot be written to, its drive does not exist, or the name is not valid. Choose another <strong>Download folder</strong> in <span class="menuseq"><b class="menu">Settings</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Transfer Options&#8230;&#8203;</b></span>; left empty, it is the <code>DOWNLOAD</code> folder in USER.</p>
</li>
<li>
<p><code>[New connection settings take effect the next time you connect]</code>: after you change Session Settings while connected.</p>
</li>
<li>
<p><code>[Capturing to <em>file</em>]</code> and <code>[Capture stopped]</code>: normal.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>If Terminal opens and closes at once, the log file has <code>Terminal: no connection available</code>: memory is short. Close programs and start Terminal again. If Terminal is started with a <code>telnet://</code> address (for example from a link) while its phone book is full, it opens without connecting, and the log file has <code>Terminal: the phone book is full; <em>address</em> was not opened</code>: delete a session and try again.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-serial-transfers"><a class="anchor" href="#trouble-serial-transfers"></a>11.10.7. File transfers</h4>
<div class="paragraph">
<p><a id="_ix1706" class="ixterm"></a><a id="_ix1707" class="ixterm"></a><a id="_ix1708" class="ixterm"></a><a id="_ix1709" class="ixterm"></a><a id="_ix1710" class="ixterm"></a>When a transfer ends, the <strong>File Transfer</strong> window shows the result, Terminal writes it on its screen as <code>[Upload: <em>result</em>]</code> or <code>[Download: <em>result</em>]</code>, and the log file gets it too:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Result</th>
<th class="tableblock halign-left valign-top">What it means and what to do</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Transfer complete&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">It worked.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Transfer complete (the end was not confirmed)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Every block arrived, but the other side never confirmed the end. The file should be complete.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cancelled&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">You clicked <b class="button">Cancel</b> or pressed <kbd>Esc</kbd>, or closed the window or Terminal.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cancelled by the sender&#8221;, &#8220;Cancelled by the receiver&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The other side cancelled.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1711" class="ixterm"></a>&#8220;The receiver did not start&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">You sent, but the other side never started receiving (about 60 seconds), or it uses another protocol. Start the receive on the other computer before (or right after) you choose <span class="menuseq"><b class="menu">Transfer</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Send Files&#8230;&#8203;</b></span>, with the same protocol.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1712" class="ixterm"></a>&#8220;The sender did not start&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">You chose <span class="menuseq"><b class="menu">Transfer</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Receive Files&#8230;&#8203;</b></span>, but the other side never started sending. Start the send on the other computer first, with the same protocol.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The sender stopped&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A ZMODEM batch stopped before the next file came.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1713" class="ixterm"></a>&#8220;Too many errors&#8221;, &#8220;Lost block sequence&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The same block failed 10 times, or the blocks lost step: line noise, characters lost for lack of flow control, a speed that is too high, or a link that changes control characters. Use <strong>RTS/CTS</strong> flow control, a lower speed, or XMODEM-1K; for ZMODEM, tick <strong>Escape all control characters (for links that lose them)</strong> in Transfer Options.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The receiver ended the transfer&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The ZMODEM receiver stopped, for example because its disk is full.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot open <em>file</em>&#8221;, &#8220;Cannot read the file&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A file to send does not exist, or cannot be read (a damaged disk, or the disk was taken out).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1714" class="ixterm"></a>&#8220;Cannot create the file&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A file being received could not be made: the download folder is on a disk that cannot be written to (a CD-ROM or a write-protected floppy), the disk is full, or the folder does not exist. Choose another <strong>Download folder</strong> in Transfer Options, or make room.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot write the file&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Writing a received file failed part way: the disk is full or write-protected. Make room and receive again; a ZMODEM download can be continued, while XMODEM and YMODEM remove the incomplete file.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;A file larger than 2 GB cannot be transferred&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file is too large.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;No file to send&#8221;, &#8220;Bad transfer parameters&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A program started a transfer wrongly. Report it to its author.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix1715" class="ixterm"></a>When a file being received already exists, the <strong>File Transfer</strong> window asks &#8220;<em>file</em> already exists (<em>size</em> bytes). What should happen to it?&#8221;, with <b class="button">Continue it</b> (only when ZMODEM can continue it), <b class="button">Keep both</b> (the new file gets <code>~1</code> to <code>~99</code> added to its name, such as <code>README~1.TXT</code>), <b class="button">Replace</b>, and <b class="button">Skip</b>.</p>
</div>
<div class="paragraph">
<p>On a disk without long file names, received names are shortened to 8.3 form, and characters DOS does not allow are replaced. Folder names in the sender&#8217;s file name are ignored; a name with nothing usable in it becomes <code>RECEIVED</code>. Typing is ignored while a transfer runs.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-serial-ini"><a class="anchor" href="#trouble-serial-ini"></a>11.10.8. Terminal&#8217;s settings file</h4>
<div class="paragraph">
<p><a id="_ix1716" class="ixterm"></a><a id="_ix1717" class="ixterm"></a>Terminal keeps its phone book and all its settings in <code>TERMINAL.INI</code>, in its own folder in USER (<code>USER\APPS\KPUNCH\TERMINAL\TERMINAL.INI</code>). Values out of range are put back into range when Terminal reads them. Several Terminals running at once share the file: each reads it again before it saves and changes only what was changed in it, so one Terminal does not undo another&#8217;s changes. Deleting the file gives one session, <strong>Direct COM1</strong>: a serial port on COM1 at 9600 bps, 8 data bits, no parity, 1 stop bit, no flow control, local echo off, and ANSI music on, with ZMODEM transfers into <code>USER\DOWNLOAD</code>. Your other sessions are lost, so keep a copy of the file first.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="trouble-addons"><a class="anchor" href="#trouble-addons"></a>11.11. Setup, add-ons, and Software</h3>
<div class="paragraph">
<p><a id="_ix1718" class="ixterm"></a><a id="_ix1719" class="ixterm"></a><a id="_ix1720" class="ixterm"></a><a id="_ix1721" class="ixterm"></a><a id="_ix1722" class="ixterm"></a>This section covers Setup (installing, upgrading, repairing, and removing DVX) and the Software program (installing and removing add-on packages, the package server, and signatures). Setup&#8217;s boxes are titled <strong>DVX Setup</strong>, and Software&#8217;s are titled <strong>Software</strong>.</p>
</div>
<div class="sect3">
<h4 id="trouble-addons-setup-start"><a class="anchor" href="#trouble-addons-setup-start"></a>11.11.1. Setup will not start</h4>
<div class="paragraph">
<p><a id="_ix1723" class="ixterm"></a>These are printed at the DOS prompt, and Setup ends:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><a id="_ix1724" class="ixterm"></a>&#8220;DVX Setup: there is no DVX package (or it is damaged) beside <em>file</em>, and DVX is not installed in its folder.&#8221;</dt>
<dd>
<p>Setup found nothing to install. <em>file</em> is Setup&#8217;s own name, such as <code>a:\setup.exe</code>. <code>SETUP.EXE</code> was copied without the files that go with it, the floppy in the drive is not Disk 1, the CD or Disk 1 is damaged, or you started the copy of Setup in the DVX folder with <code>/AUTO=</code> (that copy can only remove DVX). Run <code>SETUP</code> from the DVX CD, or from Disk 1 of the floppy disks with Disk 1 in the drive. Make a new copy of a damaged disk.</p>
</dd>
<dt class="hdlist1"><a id="_ix1725" class="ixterm"></a>&#8220;DVX Setup needs a video card with a VESA video BIOS and a 640x480 mode at 256 colors or more; many older cards need their VESA driver loaded first, such as UniVBE (see README.TXT).&#8221;</dt>
<dd>
<p>Load the video card&#8217;s VESA driver, then run Setup again (see <a href="#trouble-start-vesa">Section 11.2.2</a>).</p>
</dd>
<dt class="hdlist1">&#8220;DVX Setup: /FONTS= takes NONE or BASE.&#8221;</dt>
<dd>
<p>Use <code>/FONTS=NONE</code> or <code>/FONTS=BASE</code>, or leave the switch out.</p>
</dd>
<dt class="hdlist1"><a id="_ix1726" class="ixterm"></a>&#8220;There is not enough memory to run Setup.&#8221; (in a box, when Setup starts to install)</dt>
<dd>
<p>Free memory (see <a href="#trouble-start-memory">Section 11.2.6</a>) and run Setup again.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p><a id="_ix1727" class="ixterm"></a>If Setup opens with the note &#8220;To install or upgrade DVX, run SETUP from its CD or Disk 1.&#8221;, you started the copy of Setup in the DVX folder. It can only remove DVX from its own folder. To install, upgrade, or repair, run <code>SETUP</code> from the CD or Disk 1.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-addons-setup-folder"><a class="anchor" href="#trouble-addons-setup-folder"></a>11.11.2. Choosing the folder</h4>
<div class="paragraph">
<p><a id="_ix1728" class="ixterm"></a>Setup checks the folder you type before it goes on:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>&#8220;Type the folder to install DVX in.&#8221;: the box is empty.</p>
</li>
<li>
<p>&#8220;Type the whole path of the folder, starting with the drive, for example C:\DVX.&#8221;: the folder does not start with a drive letter.</p>
</li>
<li>
<p>&#8220;Setup is reading DVX from <em>folder</em>. Choose a folder that is not this one and not inside it.&#8221;: you chose the CD or floppy drive Setup runs from. Choose a folder on the hard disk.</p>
</li>
<li>
<p><a id="_ix1729" class="ixterm"></a>&#8220;DVX is not installed in <em>folder</em>. To put DVX there, choose Back, then Install DVX.&#8221;: you chose <strong>Upgrade or repair DVX</strong> for a folder without DVX. Check the folder, or go back and choose <strong>Install DVX</strong>.</p>
</li>
<li>
<p><a id="_ix1730" class="ixterm"></a>&#8220;DVX is already installed in <em>folder</em>. Upgrade or repair it instead, keeping your settings and saved files?&#8221;: you chose <strong>Install DVX</strong> for a folder that has DVX. <b class="button">Yes</b> upgrades it, keeping your settings; <b class="button">No</b> lets you choose another folder.</p>
</li>
</ul>
</div>
</div>
<div class="sect3">
<h4 id="trouble-addons-setup-space"><a class="anchor" href="#trouble-addons-setup-space"></a>11.11.3. Not enough disk space, or the folder cannot be made</h4>
<div class="paragraph">
<p><a id="_ix1731" class="ixterm"></a><a id="_ix1732" class="ixterm"></a><a id="_ix1733" class="ixterm"></a>&#8220;There is not enough free space for DVX on that disk. DVX needs about <em>n</em> bytes; <em>n</em> bytes are free.&#8221; appears after you choose what to install. On an upgrade, only what the folder does not have yet counts, and the add-ons you chose are included. The page of what to install shows &#8220;DVX needs about <em>n</em> MB of disk space.&#8221; as you choose. To make it fit:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Free space on that disk.</p>
</li>
<li>
<p>Choose fewer parts, or <strong>None</strong> for the fonts, or untick add-ons.</p>
</li>
<li>
<p>Or install DVX on another drive.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p><a id="_ix1734" class="ixterm"></a>&#8220;Setup could not create the folder <em>folder</em>.&#8221; means the drive is write-protected or full, the name is not a valid DOS name, or the drive does not exist. Choose another folder or drive.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-addons-setup-disks"><a class="anchor" href="#trouble-addons-setup-disks"></a>11.11.4. Floppy disk questions</h4>
<div class="paragraph">
<p><a id="_ix1735" class="ixterm"></a><a id="_ix1736" class="ixterm"></a>When installing from floppy disks, Setup asks for each disk in turn, in a box with <b class="button">OK</b> and <b class="button">Cancel</b> (<b class="button">Cancel</b> stops Setup):</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/trWrongDisk.png" alt="A DVX Setup box saying &quot;This is not Disk 2. Please insert Disk 2 of 6 in drive A: and choose OK.&quot;">
</div>
<div class="title">Figure 57. Setup asks for the right disk</div>
</div>
<div class="ulist">
<ul>
<li>
<p>&#8220;Please insert Disk <em>n</em> of <em>n</em> in <em>drive</em> and choose OK.&#8221;: insert that disk and click <b class="button">OK</b>.</p>
</li>
<li>
<p><a id="_ix1737" class="ixterm"></a>&#8220;This is not Disk <em>n</em>. Please insert Disk <em>n</em> of <em>n</em> in <em>drive</em> and choose OK.&#8221;: a disk of the same set, but the wrong one, is in the drive.</p>
</li>
<li>
<p><a id="_ix1738" class="ixterm"></a>&#8220;The disk in <em>drive</em> belongs to a different set of DVX disks. Please insert Disk <em>n</em> of <em>n</em> of this set and choose OK.&#8221;: the disk is from another copy or version of DVX&#8217;s floppy disks. Use the disks of one set only, all made at the same time.</p>
</li>
<li>
<p><a id="_ix1739" class="ixterm"></a>&#8220;The disk in <em>drive</em> cannot be read. Please insert Disk <em>n</em> of <em>n</em> and choose OK.&#8221;: the disk is damaged. Clean or replace it, or make it again from the disk images.</p>
</li>
</ul>
</div>
</div>
<div class="sect3">
<h4 id="trouble-addons-setup-unpack"><a class="anchor" href="#trouble-addons-setup-unpack"></a>11.11.5. Setup stops while unpacking</h4>
<div class="paragraph">
<p><a id="_ix1740" class="ixterm"></a><a id="_ix1741" class="ixterm"></a>If Setup cannot finish unpacking, it shows the reason in a box. A new installation that fails is removed again; an upgrade that fails is left as it is, so run <strong>Upgrade or repair DVX</strong> again once the problem is fixed.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Message</th>
<th class="tableblock halign-left valign-top">What it means</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Setup could not write <em>file</em>. The disk may be full.&#8221;, &#8220;Setup could not write <em>file</em>. The disk may be full or write-protected.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The disk is full or write-protected, or a file is in use.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The path of <em>file</em> is too long.&#8221;, &#8220;The folder <em>folder</em> is too long.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The folder you chose is too deep. Choose a shorter one, such as <code>C:\DVX</code>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Setup could not read the DVX package in <em>folder</em>.&#8221;, &#8220;Setup could not read the DVX package on disk <em>n</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The CD was taken out, or the disk cannot be read.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The DVX package ends too early (disk <em>n</em>).&#8221;, &#8220;The DVX package is incomplete: <em>n</em> of <em>n</em> files.&#8221;, &#8220;The DVX package is damaged (disk <em>n</em>).&#8221;, &#8220;The file <em>file</em> in the DVX package is damaged (disk <em>n</em>).&#8221;, &#8220;The DVX package uses a form Setup cannot read (disk <em>n</em>).&#8221;, &#8220;The DVX package holds a name Setup does not accept: <em>name</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The CD or a floppy disk is damaged, was not copied completely, or disks from different sets were mixed. Make the disks or the CD again from a good copy.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix1742" class="ixterm"></a>If you click <b class="button">Cancel</b> while Setup unpacks, it says &#8220;Setup was cancelled. Nothing was installed in <em>folder</em>.&#8221; for a new installation, or &#8220;Setup was cancelled. DVX in <em>folder</em> is incomplete now; run Setup again to repair it.&#8221; for an upgrade. Run <strong>Upgrade or repair DVX</strong> for the same folder to finish it.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-addons-setup-parts"><a class="anchor" href="#trouble-addons-setup-parts"></a>11.11.6. Parts and add-ons in Setup</h4>
<div class="paragraph">
<p><a id="_ix1743" class="ixterm"></a><a id="_ix1744" class="ixterm"></a><a id="_ix1745" class="ixterm"></a>Ticking a part also ticks the parts it needs; unticking one also unticks the parts that need it. On an upgrade, an unticked part is removed, unless an installed add-on needs it:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><a id="_ix1746" class="ixterm"></a>&#8220;Other software in <em>folder</em> needs these parts, so Setup keeps them: <em>parts</em>.&#8221;: nothing is wrong. To remove the part, first remove the add-on that needs it with Software.</p>
</li>
<li>
<p>&#8220;<em>name</em> could not be installed: <em>reason</em>&#8221; or &#8220;<em>name</em> could not be removed: <em>reason</em>&#8221;: an add-on or a part could not be installed or removed (the reasons are those of Software, below). DVX itself is installed, and Setup goes on with the others. Install or remove it later with Software; the add-ons are in the <code>ADDONS</code> folder of the CD.</p>
</li>
<li>
<p>&#8220;Setup was cancelled: <em>name</em> and the add-ons after it are not as you chose. Software (in Program Manager) can install and remove them.&#8221; and &#8220;Setup was cancelled: <em>name</em> is not all removed. Software (in Program Manager) can remove it.&#8221;: use Software to finish.</p>
</li>
<li>
<p>&#8220;There is not enough memory to install the add-ons.&#8221; and &#8220;There is not enough memory to remove the parts left out.&#8221;: free memory and run Setup again.</p>
</li>
<li>
<p><a id="_ix1747" class="ixterm"></a>&#8220;These files in <em>folder</em> changed since they were installed, so Setup left them:&#8221;, the files, and &#8220;Delete them too?&#8221;: removing a part or an add-on, or upgrading an add-on, does not delete files that changed after they were installed, such as data you edited, as in Software (see <a href="#trouble-addons-remove">Section 11.11.15</a>). <b class="button">Yes</b> deletes them; <b class="button">No</b> leaves them where they are. When Setup runs with <code>/AUTO</code>, it does not ask, and the files stay.</p>
</li>
<li>
<p><a id="_ix1748" class="ixterm"></a>&#8220;These files in <em>folder</em> could not be deleted, so Setup left them:&#8221;, the files, and &#8220;A program may be using them, or the disk may be write-protected.&#8221;: some files of a part or an add-on Setup removed (or, after <b class="button">Yes</b> above, some of the changed files) could not be deleted. The part or add-on itself is removed. Make the disk writable, and delete the files with File Manager.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>An add-on file in the CD&#8217;s <code>ADDONS</code> folder that cannot be read, or is not signed, is not offered. The floppy disks have no add-ons; get them from the package server in Software.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-addons-setup-after"><a class="anchor" href="#trouble-addons-setup-after"></a>11.11.7. After installing: settings and AUTOEXEC.BAT</h4>
<div class="dlist">
<dl>
<dt class="hdlist1"><a id="_ix1749" class="ixterm"></a><a id="_ix1750" class="ixterm"></a><a id="_ix1751" class="ixterm"></a>&#8220;DVX was installed, but the settings file in <em>folder</em> could not be written.&#8221;</dt>
<dd>
<p>Setup could not write <code>DVX.INI</code> in the USER folder, where it saves the screen mode it ran in. DVX can still be started, with its default settings. Check that the disk can be written to, and run <strong>Upgrade or repair DVX</strong> to try again.</p>
</dd>
<dt class="hdlist1">&#8220;Your old settings and saved files in <em>folder</em> could not all be removed.&#8221;</dt>
<dd>
<p>An upgrade with <strong>Start over</strong> ticked could not delete all of the USER folder. Delete it by hand.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>When <strong>Start DVX when the computer starts (AUTOEXEC.BAT)</strong> is ticked, Setup asks before it adds the line that starts DVX to <code>AUTOEXEC.BAT</code>: &#8220;Setup will add this line to the end of <em>file</em>, so DVX starts when the computer starts: <em>line</em> The file as it is now is saved as <em>backup</em> first. Add the line?&#8221; It keeps a copy of the file as <code>AUTOEXEC.DVX</code>. When there is no <code>AUTOEXEC.BAT</code> yet, there is nothing to copy, and Setup asks &#8220;There is no <em>file</em> yet. Setup will make one with this line, so DVX starts when the computer starts: <em>line</em> Add the line?&#8221; instead. To undo it, delete the line from <code>AUTOEXEC.BAT</code>, or copy <code>AUTOEXEC.DVX</code> back over <code>AUTOEXEC.BAT</code>. If it fails, a box gives the reason: &#8220;The path <em>file</em> is too long.&#8221;, &#8220;Could not make the backup copy <em>file</em>, so <em>file</em> was not changed.&#8221;, &#8220;Could not write <em>file</em> (is the disk full or write-protected?).&#8221;, or &#8220;There is not enough memory to change <em>file</em>.&#8221;</p>
</div>
<div class="paragraph">
<p>If you tick <strong>Start DVX now</strong> on the last page, DVX starts while Setup is still in memory. If DVX then says memory is short, exit DVX and start it from the DOS prompt instead.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-addons-setup-remove"><a class="anchor" href="#trouble-addons-setup-remove"></a>11.11.8. Removing DVX</h4>
<div class="dlist">
<dl>
<dt class="hdlist1"><a id="_ix1752" class="ixterm"></a><a id="_ix1753" class="ixterm"></a>&#8220;DVX is not installed in <em>folder</em> (or it was not installed by this Setup).&#8221;</dt>
<dd>
<p>The folder has no list of the files Setup installed (<code>SETUP.LST</code>), or it is not a full path. A DVX copied by hand must be deleted by hand. &#8220;<em>folder</em> has no list of installed files (SETUP.LST), so Setup does not know what to remove.&#8221; means the same.</p>
</dd>
<dt class="hdlist1">&#8220;<em>n</em> file(s) in <em>folder</em> could not be removed. Close any program using them and choose Remove DVX again.&#8221;</dt>
<dd>
<p>Some files are read-only, in use, or on a write-protected disk. Fix that and choose <strong>Remove DVX</strong> in Setup again (the list of files is kept, so it can finish).</p>
</dd>
<dt class="hdlist1">&#8220;DVX was removed from <em>folder</em>.&#8221;</dt>
<dd>
<p>Done. Files you added yourself stay, and the USER folder goes only if you ticked <strong>Also remove my settings and saved files (the USER folder)</strong>.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>If <code>AUTOEXEC.BAT</code> has the exact line that starts DVX, Setup offers to remove it, keeping a copy as <code>AUTOEXEC.DVX</code>: &#8220;<em>file</em> starts DVX with the line <em>line</em> Remove that line? (The file as it is now is saved as AUTOEXEC.DVX first.)&#8221; A line you changed by hand (for example with a switch added) is not recognized: remove it yourself.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-addons-setup-log"><a class="anchor" href="#trouble-addons-setup-log"></a>11.11.9. Keeping a record of Setup</h4>
<div class="paragraph">
<p><a id="_ix1754" class="ixterm"></a><a id="_ix1755" class="ixterm"></a>Setup keeps no log file unless you ask. To keep one for a problem report, start it with <code>SETUP /LOG=C:\SETUP.LOG</code>. When you install with <code>SETUP /AUTO=C:\DVX</code> (without questions), Setup shows no error boxes, only writing the errors to the log, so add <code>/LOG=</code> to see them; it ends with exit code 0 when DVX was installed and 1 when it was not. See <a href="#installing-setup">Section 3.3</a>.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-addons-software"><a class="anchor" href="#trouble-addons-software"></a>11.11.10. Software will not start, or its server pages are off</h4>
<div class="dlist">
<dl>
<dt class="hdlist1"><a id="_ix1756" class="ixterm"></a><a id="_ix1757" class="ixterm"></a>&#8220;There is not enough memory to start Software.&#8221;</dt>
<dd>
<p>Close other programs and try again.</p>
</dd>
<dt class="hdlist1"><a id="_ix1758" class="ixterm"></a>&#8220;The package server needs DVX&#8217;s Networking part. To add it, run Setup from DVX&#8217;s CD or Disk 1 and choose Upgrade or repair.&#8221;</dt>
<dd>
<p>Shown as the status line of the Available, Updates, and Published pages, whose buttons are then off. Installing from a file still works. To use the package server, add Networking (see <a href="#trouble-network-notinstalled">Section 11.9.3</a>).</p>
</dd>
</dl>
</div>
</div>
<div class="sect3">
<h4 id="trouble-addons-read"><a class="anchor" href="#trouble-addons-read"></a>11.11.11. A package cannot be read</h4>
<div class="paragraph">
<p><a id="_ix1759" class="ixterm"></a><a id="_ix1760" class="ixterm"></a>&#8220;<em>file</em> cannot be installed: <em>reason</em>&#8221; means Software could not read the package file you chose. The reason is one of these:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Reason</th>
<th class="tableblock halign-left valign-top">What it means</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot read <em>file</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file is missing, cannot be read, or is not a package at all.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em> is not a DVX package (it does not start with PACKAGE.INI).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">It is some other kind of file.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The manifest of <em>file</em> cannot be read: it is damaged.&#8221; (or &#8220;&#8230;&#8203;: it cannot be read.&#8221;, &#8220;&#8230;&#8203;: it uses a form DVX cannot read.&#8221;, &#8220;&#8230;&#8203;: a part of it could not be kept (the disk is full, or memory is short).&#8221;)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package is damaged, or the disk is full, or memory is short.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The signature of <em>file</em> cannot be read.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Its signature is damaged.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;This package needs a newer DVX (its manifest is format <em>n</em>).&#8221;, &#8220;Line <em>n</em>: <em>kind</em> is not a kind of package.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package was made for a newer DVX. Update DVX first (Software&#8217;s Updates page).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The manifest has no format number: it is not a DVX package manifest.&#8221;, &#8220;The manifest needs an id, a name, a version, and a kind.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">It is not a proper DVX package.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The path <em>file</em> is too long.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package&#8217;s folder is too deep. Move it to a shorter folder.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>Other reasons, such as &#8220;The id <em>id</em> is not vendor.name (each part 1 to 8 of a-z, 0-9, and _).&#8221;, &#8220;The package holds no files.&#8221;, &#8220;<em>name</em> is listed twice.&#8221;, &#8220;The package depends on itself.&#8221;, or one starting &#8220;Line <em>n</em>&#8221;, mean the package was made wrongly: tell whoever made it. In every case, get a fresh copy of the package and check that it is a DVX <code>.DPK</code> file.</p>
</div>
<div class="paragraph">
<p><a id="_ix1761" class="ixterm"></a>&#8220;<em>file</em> cannot be installed: another job is running.&#8221; means another install, removal, or download is under way. Wait for it to finish.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-addons-plan"><a class="anchor" href="#trouble-addons-plan"></a>11.11.12. The Install Software window</h4>
<div class="paragraph">
<p><a id="_ix1762" class="ixterm"></a><a id="_ix1763" class="ixterm"></a><a id="_ix1764" class="ixterm"></a>Before it installs anything, Software shows a window titled <strong>Install Software</strong>: &#8220;This is what will be installed:&#8221;, with each package&#8217;s <strong>Name</strong>, <strong>Version</strong>, <strong>Action</strong> (<strong>New</strong>, <strong>Upgrade</strong>, or <strong>Reinstall</strong>, which repairs it), and <strong>Signed</strong> (<strong>By DVX</strong>, <strong>Trusted</strong>, or <strong>No</strong>). Notes under the list may say:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>&#8220;Installed with it, because it needs them: <em>names</em>.&#8221;: other packages come along. Nothing is wrong.</p>
</li>
<li>
<p><a id="_ix1765" class="ixterm"></a>&#8220;Not signed by a publisher DVX trusts: <em>names</em>. Install them only if you trust where they came from.&#8221;: the package is not signed, is signed with a key you have not chosen to trust, or was changed since it was signed. Install it only if you trust its source. To trust a publisher, see <a href="#trouble-addons-keys">Section 11.11.18</a>. (A package from the package server is never in this note: unless DVX&#8217;s own key signed it, Software refuses it; see <a href="#trouble-addons-refused">Section 11.11.13</a>.)</p>
</li>
<li>
<p>&#8220;These add-ons stop working with the new DVX until they are updated: <em>names</em>.&#8221;: you are updating DVX itself, and these add-ons were made for the old one. Update them too, or keep the DVX you have. Until they are updated, DVX leaves them out when it starts (see <a href="#trouble-start-addons">Section 11.2.9</a>).</p>
</li>
<li>
<p>&#8220;DVX itself is updated: the new version runs from the next time DVX starts.&#8221; and &#8220;Libraries and widgets work from the next time DVX starts.&#8221;: restart DVX after installing.</p>
</li>
<li>
<p><a id="_ix1766" class="ixterm"></a>&#8220;It takes <em>n</em> bytes of disk space.&#8221;: how much room the packages need. When the disk has less room than installing needs, the note says &#8220;There is not enough room on the disk: it needs <em>n</em> bytes and <em>n</em> are free. Make room on the disk, then install again.&#8221; instead, and <b class="button">Install</b> is unavailable: make room, then install again. Installing can need more room than the packages take in the end, because each package&#8217;s files are all unpacked before the old version&#8217;s files go.</p>
</li>
</ul>
</div>
</div>
<div class="sect3">
<h4 id="trouble-addons-refused"><a class="anchor" href="#trouble-addons-refused"></a>11.11.13. A package &#8220;cannot be installed&#8221;</h4>
<div class="paragraph">
<p><a id="_ix1767" class="ixterm"></a><a id="_ix1768" class="ixterm"></a>&#8220;<em>name</em> cannot be installed. <em>reason</em>&#8221; means Software read the package but will not install it. The reason is one of these:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Reason</th>
<th class="tableblock halign-left valign-top">What to do</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> needs <em>package</em> <em>version</em> or later, which is not here.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A package it needs is not installed and not in the same folder (or not on the server). Put that package&#8217;s <code>.DPK</code> file in the same folder and install again, or install it first.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> needs <em>package</em> <em>version</em> or later, but an older one is being installed.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Get a newer version of the package it needs.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> needs DVX <em>version</em> or later (this is DVX <em>version</em>).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Update DVX first (Software&#8217;s Updates page).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> was made for a different version of DVX.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Get the version of the add-on made for this DVX.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;A newer version of <em>name</em> (<em>version</em>) is installed.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Going back to an older version is refused. Remove the newer one first if you really want the older one.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1769" class="ixterm"></a>&#8220;<em>name</em> is not signed by the publisher of the installed version.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The installed version was signed by a publisher you trust, and this one is not signed by the same publisher. This keeps someone else from replacing a package. Get the update from the original publisher. If you are sure, remove the installed version first, then install.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1770" class="ixterm"></a>&#8220;<em>name</em> says it is part of DVX, but it is not signed by DVX&#8217;s key.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Packages whose names start with <code>kpunch.</code> must be signed by DVX&#8217;s own key. Do not install it.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1771" class="ixterm"></a><a id="_ix1772" class="ixterm"></a>&#8220;<em>name</em> is from the package server, but it is not signed. DVX installs a package from the package server only when DVX&#8217;s key signed it.&#8221;, &#8220;<em>name</em> is from the package server, but it is signed by another key, not by DVX&#8217;s. DVX installs a package from the package server only when DVX&#8217;s key signed it.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Every package from the package server must be signed by DVX&#8217;s own key, whoever published it; a publisher&#8217;s key you trust is not enough. Tell whoever runs the server. Packages from files are not affected.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> is from the package server, but its signature by DVX&#8217;s key does not fit it: it was changed or damaged on the way.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package was changed after DVX&#8217;s key signed it. Try again; if it keeps happening, something on the network changes what you download.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> has the file <em>file</em>, which belongs to <em>package</em>.&#8221;, &#8220;<em>name</em> and <em>package</em> both have the file <em>file</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Two packages would own the same file. Remove the other package first, or ask the maker.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> and <em>package</em> need each other.&#8221;, &#8220;Two versions of <em>name</em> are asked for.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The packages are badly made. Ask the maker.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> is not one of the packages read.&#8221;, &#8220;There is not enough memory.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Rare. Close programs and try again.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>&#8220;<em>name</em> cannot be installed now.&#8221; means another job started meanwhile; try again.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-addons-stopped"><a class="anchor" href="#trouble-addons-stopped"></a>11.11.14. Installing or removing stops part way</h4>
<div class="paragraph">
<p><a id="_ix1773" class="ixterm"></a><a id="_ix1774" class="ixterm"></a>&#8220;Installing did not finish. <em>reason</em>&#8221; or &#8220;Removing did not finish. <em>reason</em>&#8221; appears after the progress window closes. The reason starts with the package&#8217;s name. After <b class="button">Cancel</b> there is no message: Software stops after the package it is working on, and the Installed page shows what is installed. A package only partly unpacked is left out completely, and when replacing files fails, every file already replaced is put back, so the old version keeps working.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Reason</th>
<th class="tableblock halign-left valign-top">What to do</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1775" class="ixterm"></a>&#8220;There is not enough room on the disk: <em>name</em> needs <em>n</em> KB and <em>n</em> KB are free.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Every new file is unpacked before the old ones go, so an upgrade needs room for the whole package. Free space on the drive DVX is on.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot write <em>file</em> (is the disk full?).&#8221;, &#8220;Cannot write <em>file</em>.&#8221;, &#8220;Cannot make the folder <em>folder</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The disk is full or cannot be written to.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot read <em>file</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package file went away, for example the floppy or CD was taken out. Put it back and try again.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em> is not the file the manifest lists (it was changed or damaged).&#8221;, &#8220;<em>file</em>: it is damaged.&#8221;, &#8220;The package: it is damaged.&#8221;, &#8220;<em>file</em> is in the manifest but not in the package.&#8221;, &#8220;<em>file</em> is in the package but not in its manifest.&#8221;, &#8220;<em>file</em> is in the package twice.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package is damaged or was changed. Get a fresh copy.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The path of <em>file</em> is too long.&#8221;, &#8220;<em>file</em> is a folder.&#8221;, &#8220;<em>name</em> has too many files.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package cannot be placed in this DVX folder. Ask its maker.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot move <em>file</em> aside.&#8221;, &#8220;Cannot put <em>file</em> in place.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A file could not be replaced. Check that the disk can be written to, and try again after closing the program that uses the file.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> is not installed.&#8221;, &#8220;Cannot remove <em>file</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">When removing: the package is already gone, or its record could not be removed.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;There is not enough memory.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Close programs and try again.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>When it works, Software says &#8220;Installed: <em>names</em>.&#8221;, adding &#8220;Restart DVX to start using the new version of DVX.&#8221; or &#8220;Libraries and widgets work from the next time DVX starts.&#8221; when that applies. New programs appear in Program Manager&#8217;s Installed Programs group.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-addons-remove"><a class="anchor" href="#trouble-addons-remove"></a>11.11.15. Removing a package</h4>
<div class="dlist">
<dl>
<dt class="hdlist1"><a id="_ix1776" class="ixterm"></a><a id="_ix1777" class="ixterm"></a>&#8220;DVX itself is removed with Setup.&#8221;</dt>
<dd>
<p>Software cannot remove DVX itself; use Setup&#8217;s <strong>Remove DVX</strong>.</p>
</dd>
<dt class="hdlist1">&#8220;These need <em>name</em> and are removed with it: &#8230;&#8203; Remove them all?&#8221;</dt>
<dd>
<p>Other packages need this one. <b class="button">No</b> removes nothing.</p>
</dd>
<dt class="hdlist1">&#8220;These were installed for <em>name</em> and nothing else needs them: &#8230;&#8203; Remove them too?&#8221;</dt>
<dd>
<p>Packages that came with it. <b class="button">Yes</b> removes them too.</p>
</dd>
<dt class="hdlist1">&#8220;These files changed since they were installed, so they were left: &#8230;&#8203; Delete them too?&#8221;</dt>
<dd>
<p>Files you (or a program) changed, such as data you edited, are kept unless you click <b class="button">Yes</b>. Software asks this after an upgrade too, for the files the old version had that the new one does not.</p>
</dd>
<dt class="hdlist1"><a id="_ix1778" class="ixterm"></a>&#8220;These files could not be deleted, so they were left: &#8230;&#8203; A program may be using them, or the disk may be write-protected.&#8221;</dt>
<dd>
<p>Some of the package&#8217;s files could not be deleted (or, after <b class="button">Yes</b> above, some of the changed files): a program is using them, or the disk cannot be written to. The package itself is removed (or, after an upgrade, the new version is installed). Close the program, or make the disk writable, and delete the files with File Manager.</p>
</dd>
<dt class="hdlist1">&#8220;<em>name</em> cannot be removed now.&#8221;</dt>
<dd>
<p>Another job is running; try again when it is done.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>A part of DVX removed with Software comes back with Setup&#8217;s <strong>Upgrade or repair DVX</strong>.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-addons-server"><a class="anchor" href="#trouble-addons-server"></a>11.11.16. The package server cannot be reached</h4>
<div class="paragraph">
<p><a id="_ix1779" class="ixterm"></a><a id="_ix1780" class="ixterm"></a><a id="_ix1781" class="ixterm"></a>When Software cannot read the package server&#8217;s list, its updates, or your packages, the page&#8217;s status line says &#8220;The package server could not be reached.&#8221;, after a box that gives the real reason (no box when you clicked <b class="button">Cancel</b>). The box says &#8220;The package server cannot be reached: <em>reason</em>&#8221;, with one of these reasons:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Reason</th>
<th class="tableblock halign-left valign-top">What to do</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot find <em>host</em> on the network.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No network, no address from the network yet, no name server, or a mistyped server name. See <a href="#trouble-network-driver">Section 11.9.4</a> and <a href="#trouble-network-dns">Section 11.9.8</a>, and check the address in the Package Server window (<span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Package Server&#8230;&#8203;</b></span>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot connect to <em>host</em>: the server refused the connection.&#8221;, &#8220;&#8230;&#8203;: the connection timed out.&#8221;, &#8220;&#8230;&#8203;: the network cannot reach it.&#8221;, &#8220;&#8230;&#8203;: the server broke off the connection.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The port is wrong, the server is down, or there is no way to it (check <strong>Gateway</strong>). Try later, and check the address and port.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>host</em> did not answer in time (<em>n</em> seconds).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The server did not answer within 30 seconds. Try later.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>host</em> did not answer in HTTP.&#8221;, &#8220;The package server&#8217;s answer cannot be read: <em>reason</em>&#8221;, &#8220;The package server&#8217;s answer has no list of packages.&#8221;, &#8220;The package server&#8217;s list of your packages cannot be read.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Something that is not a DVX package server answered: the address or the port is wrong.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>host</em> closed the connection without answering.&#8221;, &#8220;<em>host</em> closed the connection before the whole reply came.&#8221;, &#8220;Lost the connection to <em>host</em>: <em>reason</em>.&#8221;, &#8220;Cannot send to <em>host</em>: <em>reason</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The connection broke. Try again.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>address</em> needs encryption, which DVX does not have: use an http:// address.&#8221;, &#8220;<em>host</em> sent the request to <em>address</em>, which is not an http:// address.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX cannot use <code>https://</code> addresses. Use an <code>http://</code> address.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>address</em> is not an http:// address.&#8221;, &#8220;<em>address</em> does not name a computer.&#8221;, &#8220;<em>address</em> has a port that is not a number from 1 to 65535.&#8221;, &#8220;The address is too long.&#8221;, &#8220;The package server&#8217;s address is too long.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Correct the address in the Package Server window (<span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Package Server&#8230;&#8203;</b></span>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>host</em> sent the request elsewhere too many times.&#8221;, &#8220;The server sent a chunk of the reply in a form HTTP does not have.&#8221;, &#8220;The server&#8217;s reply has a head too long to read.&#8221;, &#8220;The reply is too big to keep in memory: save it to a file.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The server&#8217;s answer is not usable. Try later, or check the address.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>what</em>: the package server answered <em>number</em>.&#8221; (sometimes with the server&#8217;s own message in brackets)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The server reported a problem, such as 404 (not found) or 500 (server error), or it is some other web server. Try later, and check the address.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>package</em> is not offered by the package server.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The server does not have that package.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> cannot be installed: the package server has no signature of it by DVX&#8217;s key.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The server lists the package without DVX&#8217;s signature, so Software does not fetch it: DVX would not install it. Tell whoever runs the server.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Packages cannot be fetched: the path of the DOWNLOAD folder in your user folder is too long.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The path of the USER folder is too long to hold its <code>DOWNLOAD</code> folder (for example a deep folder named by <code>DVXUSER</code>). Set <code>DVXUSER</code> to a folder nearer the top of the drive, such as <code>C:\MYDVX</code> (see <a href="#trouble-files-dvxuser">Section 11.12.7</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> was damaged on the way. Try again.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The download did not arrive intact, so it was deleted. Try again.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The download of <em>name</em> cannot be read.&#8221;, &#8220;<em>name</em> cannot be saved in <em>folder</em>.&#8221;, &#8220;Cannot write <em>file</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The download could not be kept: the USER folder&#8217;s disk is full or cannot be written to.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;There is not enough memory.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Close programs and try again.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix1782" class="ixterm"></a>In the Package Server window (<span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Package Server&#8230;&#8203;</b></span>), an address that starts with <code>https://</code> is refused with &#8220;DVX reaches package servers over plain http only (it has no encryption). Type the address without https://.&#8221;</p>
</div>
<div class="paragraph">
<p><a id="_ix1783" class="ixterm"></a>When all is well, the status lines say &#8220;<em>n</em> packages on <em>address</em>&#8221; (the Available page), &#8220;<em>n</em> updates are ready to install.&#8221; or &#8220;Everything is up to date.&#8221; (the Updates page). &#8220;Choose a package in the list first.&#8221; means you clicked a button with no package selected.</p>
</div>
<div class="paragraph">
<p>After a download, reading it can fail with &#8220;<em>name</em> cannot be installed: <em>reason</em>&#8221; (see <a href="#trouble-addons-read">Section 11.11.11</a>) or &#8220;<em>name</em> cannot be installed: what was fetched cannot be read.&#8221; Try again.</p>
</div>
<div class="paragraph">
<p><a id="_ix1784" class="ixterm"></a>Packages fetched from the server go into the <code>DOWNLOAD</code> folder in USER and are deleted after they are installed. A download that did not finish is kept there and continued next time; deleting the folder only makes the next download start from the beginning.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-addons-server-window"><a class="anchor" href="#trouble-addons-server-window"></a>11.11.17. The Package Server window</h4>
<div class="paragraph">
<p><a id="_ix1785" class="ixterm"></a><a id="_ix1786" class="ixterm"></a><a id="_ix1787" class="ixterm"></a><span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Package Server&#8230;&#8203;</b></span> in Software sets the server Software uses, and your account there for publishing. When nothing is set, it shows DVX&#8217;s own server, <code>packages.dvxgui.com</code>, port 80.</p>
</div>
<div class="ulist">
<ul>
<li>
<p>&#8220;The port is a number from 1 to 65535, or empty for the usual one.&#8221;: correct the <strong>Port</strong>.</p>
</li>
<li>
<p><a id="_ix1788" class="ixterm"></a>&#8220;The package server cannot be saved in DVX&#8217;s settings.&#8221;: <code>DVX.INI</code> cannot be read or written (a disk that cannot be written to, or a full disk; see <a href="#trouble-files-readonly-dvx">Section 11.12.6</a>).</p>
</li>
<li>
<p>To go back to DVX&#8217;s own server, clear <strong>Address</strong> and <strong>Port</strong> and click <b class="button">OK</b>.</p>
</li>
<li>
<p>To forget your account, clear <strong>Email</strong> and <strong>Password</strong>.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>These settings are kept in the <code>[packages]</code> section of <code>DVX.INI</code>: <code>server</code>, <code>port</code>, <code>user</code>, and <code>password</code> (saved scrambled).</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-addons-keys"><a class="anchor" href="#trouble-addons-keys"></a>11.11.18. Signatures and trusted keys</h4>
<div class="paragraph">
<p><a id="_ix1789" class="ixterm"></a><a id="_ix1790" class="ixterm"></a><a id="_ix1791" class="ixterm"></a><a id="_ix1792" class="ixterm"></a>To trust a publisher, get their key file (ending in <code>.KEY</code>) and choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Trust a Publisher&#8217;s Key&#8230;&#8203;</b></span> in Software. &#8220;Packages signed with this key are trusted from now on.&#8221; means it worked. &#8220;The key cannot be trusted: <em>reason</em>&#8221; means it did not:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>&#8220;Cannot read <em>file</em>.&#8221;: the file is missing or cannot be read.</p>
</li>
<li>
<p>&#8220;This is not a [key] file (or it lacks part of one).&#8221;: often a secret key (<code>.SEC</code>) or another file was chosen instead of the publisher&#8217;s <code>.KEY</code>.</p>
</li>
<li>
<p>&#8220;Line <em>n</em> is not a [section] or a key = value line.&#8221;, &#8220;Line <em>n</em>: <em>name</em> is given twice.&#8221;, &#8220;Line <em>n</em>: <em>name</em> must be <em>n</em> hex digits.&#8221;, or &#8220;The key&#8217;s id is not its public key&#8217;s.&#8221;: the key file is damaged or was changed. Get it again from the publisher.</p>
</li>
<li>
<p>&#8220;The path of the KEYS folder is too long.&#8221;: the path of the USER folder is too long.</p>
</li>
<li>
<p>&#8220;Cannot copy the key to <em>folder</em>.&#8221;: the USER folder cannot be written to.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p><a id="_ix1793" class="ixterm"></a>A package&#8217;s <strong>Details</strong> window shows who signed it in the <strong>Signed by</strong> row: the key owner&#8217;s name for a key DVX trusts, <code>key <em>id</em></code> for a key that signed it but is no longer trusted, <code>nobody</code> for an unsigned package, <code>a key you did not trust when it was installed (not checked)</code> for a package signed with a key you had not chosen to trust, <code>a key you trusted, but its signature did not fit: the package was changed after it was signed</code> for a package changed after a trusted key signed it, <code>not checked: Setup installed it from the DVX disks</code> for DVX itself and the other packages Setup copied from the DVX disks, or <code>checked when it is installed</code> for a package still on the server.</p>
</div>
<div class="paragraph">
<p>The keys you trust are kept in the <code>KEYS</code> folder in USER. A damaged or wrong file in a <code>KEYS</code> folder is ignored, with the log file line <code>Packages: <em>file</em> is not a key: <em>reason</em></code>. Software has no command to stop trusting a key: delete the publisher&#8217;s <code>.KEY</code> file from <code>USER\KEYS</code>. DVX&#8217;s own key, in <code>SYSTEM\KEYS</code>, is always trusted.</p>
</div>
<div class="admonitionblock warning">
<table>
<tr>
<td class="icon">
<div class="title">Warning</div>
</td>
<td class="content">
The <code>KEYS</code> folder in USER also holds your own secret keys (<code>.SEC</code> files) if you made any in Package Builder. Do not delete them: without your secret key, you can no longer sign updates of your packages, and people who have your signed packages cannot install your updates.
</td>
</tr>
</table>
</div>
</div>
<div class="sect3">
<h4 id="trouble-addons-publish"><a class="anchor" href="#trouble-addons-publish"></a>11.11.19. Publishing packages</h4>
<div class="dlist">
<dl>
<dt class="hdlist1"><a id="_ix1794" class="ixterm"></a><a id="_ix1795" class="ixterm"></a>&#8220;To publish a package, give your account on the package server in File &gt; Package Server first.&#8221;</dt>
<dd>
<p>Type your <strong>Email</strong> and <strong>Password</strong> in the Package Server window (<span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Package Server&#8230;&#8203;</b></span>).</p>
</dd>
<dt class="hdlist1">&#8220;<em>file</em> cannot be published: <em>reason</em>&#8221;</dt>
<dd>
<p>The package file cannot be read; the reasons are those in <a href="#trouble-addons-read">Section 11.11.11</a>.</p>
</dd>
<dt class="hdlist1"><a id="_ix1796" class="ixterm"></a>&#8220;The package server does not know that email and password.&#8221;</dt>
<dd>
<p>Check them in the Package Server window (<span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Package Server&#8230;&#8203;</b></span>). The account must have been confirmed with the link the server sent by email.</p>
</dd>
<dt class="hdlist1">&#8220;The package server gave no session when signing in.&#8221;, &#8220;No account is set for the package server.&#8221;, &#8220;Signing in: the package server answered <em>number</em> (&#8230;&#8203;).&#8221;</dt>
<dd>
<p>Signing in failed. Check the account, and try later.</p>
</dd>
<dt class="hdlist1">&#8220;<em>file</em>: the package server answered <em>number</em> (<em>message</em>).&#8221;</dt>
<dd>
<p>The server refused the package, for example because the package&#8217;s name belongs to another account, or its version is not higher than the last one. The server&#8217;s message says why.</p>
</dd>
<dt class="hdlist1">&#8220;<em>name</em> <em>version</em> is on the package server, waiting for its review. The Published page shows how the review goes.&#8221;</dt>
<dd>
<p>It worked. The <strong>Published</strong> page shows each version as <strong>Waiting for review</strong>, <strong>Published</strong>, <strong>Turned down</strong> (with the reviewer&#8217;s note), or <strong>Withdrawn</strong>.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>The Published page says &#8220;Give your account on the package server in File &gt; Package Server to see what you have published.&#8221; until you set your account.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-addons-builder"><a class="anchor" href="#trouble-addons-builder"></a>11.11.20. Package Builder</h4>
<div class="paragraph">
<p><a id="_ix1797" class="ixterm"></a>Package Builder&#8217;s boxes are titled <strong>Package Builder</strong>. Its messages explain themselves:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>&#8220;Give the package a name.&#8221;</p>
</li>
<li>
<p>&#8220;The package name must be two parts with a dot between them, such as acme.chess: who made it, then what it is, each 1 to 8 lower-case letters, digits, or _.&#8221;</p>
</li>
<li>
<p>&#8220;The version must be numbers with dots between them, such as 1.0.0.&#8221; and &#8220;<em>text</em> is not a version (such as 1.0.0).&#8221;</p>
</li>
<li>
<p>&#8220;The oldest DVX must be a version such as <em>version</em>, or left empty.&#8221;</p>
</li>
<li>
<p>&#8220;There are no other installed packages to choose from: a package can need only packages installed in this DVX.&#8221;</p>
</li>
<li>
<p>&#8220;Choose a package in the list first.&#8221;</p>
</li>
<li>
<p>&#8220;The files cannot be read. <em>reason</em>&#8221;: a file or folder of the package cannot be read, for example &#8220;Cannot read the folder <em>folder</em>.&#8221;</p>
</li>
<li>
<p>&#8220;The package cannot be built: <em>file</em> cannot be written.&#8221; and &#8220;The package cannot be built. <em>reason</em>&#8221;: the disk is full or cannot be written to, or a file is too big for a package or not allowed where it goes (such as &#8220;This <em>kind</em> package may not put a file at <em>place</em>.&#8221;). The reasons include &#8220;Cannot read <em>file</em>.&#8221;, &#8220;<em>file</em> is too big for a package.&#8221;, &#8220;Cannot create <em>file</em>.&#8221;, &#8220;Cannot write <em>file</em>.&#8221;, &#8220;Cannot add <em>file</em> to <em>package</em>.&#8221;, and &#8220;Row <em>n</em> of the files has no TAB between the name and the file.&#8221;</p>
</li>
<li>
<p>&#8220;The package is built: <em>file</em>&#8221;: it worked.</p>
</li>
<li>
<p>&#8220;The folder <em>folder</em> cannot be made. <em>reason</em>&#8221; and &#8220;The key cannot be made. <em>reason</em>&#8221; (for example &#8220;There is nothing random enough to make a key from.&#8221;): your key could not be made in <code>USER\KEYS</code>.</p>
</li>
<li>
<p>&#8220;Your key is made. Give <em>file</em> to the people who install your packages: it tells DVX that they are yours. Keep <em>file</em> private: anyone who has it can sign packages as you.&#8221;: keep the <code>.SEC</code> file safe (see the warning in <a href="#trouble-addons-keys">Section 11.11.18</a>).</p>
</li>
<li>
<p>&#8220;<em>file</em> is not a secret key. <em>reason</em>&#8221;: the file chosen for <strong>Other Key</strong> is not a <code>.SEC</code> file.</p>
</li>
<li>
<p>&#8220;<em>file</em> cannot be read.&#8221;, &#8220;<em>file</em> cannot be written.&#8221;: a template file cannot be opened or saved.</p>
</li>
<li>
<p>&#8220;There is not enough memory to start Package Builder.&#8221;: close programs.</p>
</li>
</ul>
</div>
</div>
</div>
<div class="sect2">
<h3 id="trouble-files"><a class="anchor" href="#trouble-files"></a>11.12. Files, disks, and folders</h3>
<div class="paragraph">
<p><a id="_ix1798" class="ixterm"></a><a id="_ix1799" class="ixterm"></a><a id="_ix1800" class="ixterm"></a>This section covers the file dialogs, file names, long names and big disks, disks DVX cannot write to, the TEMP and USER folders, and the file messages of File Manager and the other programs.</p>
</div>
<div class="sect3">
<h4 id="trouble-files-dialogs"><a class="anchor" href="#trouble-files-dialogs"></a>11.12.1. Messages in the Open, Save As, and Choose a Folder dialogs</h4>
<div class="paragraph">
<p><a id="_ix1801" class="ixterm"></a><a id="_ix1802" class="ixterm"></a>Every program uses the same <strong>Open</strong>, <strong>Save As</strong>, and <strong>Choose a Folder</strong> dialogs (see <a href="#desktop-file-dialogs">Section 5.6</a>), so their messages are the same everywhere.</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><a id="_ix1803" class="ixterm"></a>&#8220;<em>file</em> already exists. Do you want to replace it?&#8221; (title <strong>Confirm Save</strong>)</dt>
<dd>
<p>You chose <b class="button">OK</b> in a Save dialog, and a file of that name is already in the folder. <b class="button">Yes</b> replaces it; <b class="button">No</b> goes back to the dialog so you can type another name.</p>
</dd>
<dt class="hdlist1"><a id="_ix1804" class="ixterm"></a><a id="_ix1805" class="ixterm"></a>&#8220;<em>file</em> does not exist. Check the file name and try again.&#8221; (title <strong>File Not Found</strong>)</dt>
<dd>
<p>You typed a name in an Open dialog that is not an existing file: often a typing mistake, or the wrong folder. Click <b class="button">OK</b>: the dialog stays open, so you can correct the name or go to the right folder. An Open dialog opens only files that are there: to start a new file, choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">New</b></span> in the program, and save the new file with <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Save As&#8230;&#8203;</b></span> when you are done.</p>
</dd>
<dt class="hdlist1"><a id="_ix1806" class="ixterm"></a>&#8220;<em>file</em> does not exist. Do you want to create it?&#8221; (title <strong>Confirm Create</strong>)</dt>
<dd>
<p>Only in a program that makes new files from its Open dialog, such as DVX BASIC with <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Add File&#8230;&#8203;</b></span>: the name you typed is not an existing file. <b class="button">Yes</b> gives the name to the program, which makes a new file of that name; <b class="button">No</b> goes back to the dialog.</p>
</dd>
<dt class="hdlist1"><a id="_ix1807" class="ixterm"></a>&#8220;The folder does not exist.&#8221; (title <strong>Invalid Path</strong>)</dt>
<dd>
<p>The name you typed includes a folder or drive (such as <code>A:\LETTERS\JUNE.TXT</code>) that cannot be opened: the folder is mistyped or not made yet, or the drive is empty. Correct it, or go to an existing folder first. The Open and Save dialogs cannot make folders; the Choose a Folder dialog can. (Pressing <kbd>Enter</kbd> in the dialog&#8217;s path box on a folder that does not exist does nothing at all.)</p>
</dd>
<dt class="hdlist1"><a id="_ix1808" class="ixterm"></a>&#8220;Drive <em>drive</em> is not ready.&#8221; (title <strong>Drive Not Ready</strong>)</dt>
<dd>
<p>You chose a drive in the drive list that cannot be read: there is no disk or CD in it, the disk is not formatted, or the drive door is open. The list goes back to the drive shown before. Put the disk in and choose the drive again.</p>
<div class="imageblock">
<div class="content">
<img src="images/trDriveNotReady.png" alt="The Drive Not Ready box" width="saying "Drive A: is not ready."">
</div>
<div class="title">Figure 58. A file dialog&#8217;s message for an empty drive</div>
</div>
</dd>
<dt class="hdlist1"><a id="_ix1809" class="ixterm"></a>&#8220;<em>path</em> is a file, not a folder.&#8221; (title <strong>Invalid Folder</strong>)</dt>
<dd>
<p>In a Choose a Folder dialog (for example for Copy To, Move To, Setup&#8217;s folder, or a Browse button), you chose a file. Choose a folder. A folder you type that does not exist yet is accepted: the program makes it.</p>
</dd>
<dt class="hdlist1"><a id="_ix1810" class="ixterm"></a>&#8220;The path is too long.&#8221; (title <strong>Invalid Filename</strong> or <strong>Invalid Folder</strong>)</dt>
<dd>
<p>The folder and name together are longer than DVX can handle. Use a shorter name, or a folder nearer the top of the drive.</p>
</dd>
<dt class="hdlist1"><a id="_ix1811" class="ixterm"></a>A file saved without an extension gets one</dt>
<dd>
<p>In a Save dialog, a name typed without a dot gets the first extension of the filter chosen in <strong>Filter</strong>, such as <code>.txt</code> for <strong>Text Files (*.txt)</strong>. To save a file with no extension, choose <strong>All Files (*.*)</strong> first.</p>
</dd>
<dt class="hdlist1"><a id="_ix1812" class="ixterm"></a>A folder with very many files shows only some, or none</dt>
<dd>
<p>Memory ran out while reading the list. The log file has <code>Dialog: out of memory reading directory listing</code> or <code>Dialog: failed to allocate listItems</code>. Close programs to free memory, or choose a filter that shows fewer files.</p>
</dd>
</dl>
</div>
</div>
<div class="sect3">
<h4 id="trouble-files-names"><a class="anchor" href="#trouble-files-names"></a>11.12.2. File names that are not allowed</h4>
<div class="paragraph">
<p><a id="_ix1813" class="ixterm"></a><a id="_ix1814" class="ixterm"></a><a id="_ix1815" class="ixterm"></a>When a name breaks the rules of the disk it goes on, a box titled <strong>Invalid Filename</strong> (or <strong>Invalid Folder</strong>, <strong>New Folder</strong>, or <strong>Rename</strong>) says why. The rules depend on the disk: long names are allowed only where a long file name driver is running (see <a href="#trouble-files-lfn">Section 11.12.3</a>); elsewhere names follow the DOS 8.3 rules.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Message</th>
<th class="tableblock halign-left valign-top">What it means</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Filename must not be empty.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No name was typed.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Filename must be 1-8 characters before the extension.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">(8.3 disks) The part before the dot is empty or too long.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Extension must be 3 characters or fewer.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">(8.3 disks) The part after the dot is too long.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Filename may contain only one dot.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">(8.3 disks) A name such as <code>MY.OLD.TXT</code>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Filename contains invalid characters.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">On an 8.3 disk: a space, or one of <code>" * + , / : ; &lt; = &gt; ? [ \ ] |</code>, or a character DOS does not allow. With long names: one of <code>" * / : &lt; &gt; ? \ |</code> or a control character.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;That name is a reserved device name.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The name is one DOS uses for a device, such as <code>CON</code>, <code>PRN</code>, <code>AUX</code>, <code>NUL</code>, <code>CLOCK$</code>, <code>COM1</code> to <code>COM9</code>, or <code>LPT1</code> to <code>LPT9</code>, with or without an extension.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Filename must be 255 characters or fewer.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">(Long names) The name is too long.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;That name is reserved.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">(Long names) The name is <code>.</code> or <code>..</code>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Filename must not end with a dot or a space.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">(Long names) Remove the dot or space at the end.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The name is too long for this folder.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The folder and the name together are too long.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>Type a shorter or plainer name, such as <code>REPORT.TXT</code>.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-files-lfn"><a class="anchor" href="#trouble-files-lfn"></a>11.12.3. Long file names</h4>
<div class="paragraph">
<p><a id="_ix1816" class="ixterm"></a><a id="_ix1817" class="ixterm"></a><a id="_ix1818" class="ixterm"></a><a id="_ix1819" class="ixterm"></a>DVX uses long file names on a drive only when a long file name driver covers it, such as DOSLFN loaded before DVX. Without one, every name follows the DOS 8.3 rules, and long names already on the disk show in their short form, such as <code>LETTER~1.TXT</code>.</p>
</div>
<div class="paragraph">
<p>If long names do not appear although the driver is loaded, check <code>AUTOEXEC.BAT</code> for the line <code>SET LFN=N</code>, which turns long names off.</p>
</div>
<div class="paragraph">
<p>On a disk with long names, names keep their capital and small letters, except a name in capitals that fits the short 8.3 form, which is shown in small letters, as every name is on other disks. A new folder in File Manager is called <code>New Folder</code> on a disk with long names and <code>NEWFOLDR</code> on others.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-files-bigdisk"><a class="anchor" href="#trouble-files-bigdisk"></a>11.12.4. Big disks and big files</h4>
<div class="dlist">
<dl>
<dt class="hdlist1"><a id="_ix1820" class="ixterm"></a><a id="_ix1821" class="ixterm"></a><a id="_ix1822" class="ixterm"></a>Drives larger than 2 GB</dt>
<dd>
<p>DVX asks DOS for a drive&#8217;s free space in the way that works on large FAT32 drives. On DOS versions that cannot answer that way, a large drive may show only about 2 GB free even when it has more.</p>
</dd>
<dt class="hdlist1">Files larger than 2 GB</dt>
<dd>
<p>File Manager shows the full size of files up to 4 GB less one byte, the largest a FAT32 drive holds. Terminal cannot transfer files larger than 2 GB, and a DVX BASIC program that asks for a file&#8217;s length or a position past 2 GB stops with error 6, &#8220;Overflow&#8221;.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p><a id="_ix1823" class="ixterm"></a>DVX accepts <code>/</code> in place of <code>\</code> wherever you type a path, and shows <code>\</code>.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-files-readonly"><a class="anchor" href="#trouble-files-readonly"></a>11.12.5. Read-only disks, CD-ROMs, and empty drives</h4>
<div class="paragraph">
<p><a id="_ix1824" class="ixterm"></a><a id="_ix1825" class="ixterm"></a><a id="_ix1826" class="ixterm"></a><a id="_ix1827" class="ixterm"></a><a id="_ix1828" class="ixterm"></a>DVX never stops at the DOS question &#8220;Abort, Retry, Fail?&#8221;. When a program reads an empty floppy or CD-ROM drive, or writes to a write-protected disk, a CD-ROM, or a read-only file, that one action simply fails, and the program says it could not read or write. Put the disk in, or save somewhere else, and try again. (While a DOS program runs from DVX, DOS&#8217;s own question can appear again. It can also appear if DVX could not set up this protection when it started; the log file then says <code>Platform: no DOS memory for the critical-error handler</code> or <code>Platform: could not install the critical-error handler</code>.)</p>
</div>
<div class="paragraph">
<p>What the failure looks like in each place:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 33.3333%;">
<col style="width: 66.6667%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Where</th>
<th class="tableblock halign-left valign-top">What it says</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">File Manager (copy, move, delete, new folder, rename)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Access denied (the file may be read-only or in use, the disk write-protected or not ready).&#8221; inside its message; for an empty drive, &#8220;The drive is not ready.&#8221;</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Notepad, Help Editor, BASIC Demo</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Could not save <em>file</em> (error 75).&#8221; for a read-only file or a disk that cannot be written; other numbers for other causes (see <a href="#trouble-files-notepad">Section 11.12.11</a>). The file on the disk is left as it was.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Icon Editor</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Could not save <em>file</em>.&#8221;</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">A DVX BASIC program saving its settings</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Run-time error 75, &#8220;Cannot write INI file&#8221;. The old file is left as it was.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">A database on a CD-ROM or write-protected disk</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">It opens for reading only; a change fails with &#8220;attempt to write a readonly database&#8221;.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix1829" class="ixterm"></a>To fix it, save to a folder on the hard disk (such as your USER folder), remove the floppy&#8217;s write protection, or clear the file&#8217;s <strong>Read-only</strong> attribute in File Manager (<span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Properties</b></span>). A copied file keeps the attributes of the original, so a copy of a read-only file is read-only too; clear the attribute the same way before changing it.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-files-readonly-dvx"><a class="anchor" href="#trouble-files-readonly-dvx"></a>11.12.6. DVX runs from a disk it cannot write to</h4>
<div class="paragraph">
<p><a id="_ix1830" class="ixterm"></a><a id="_ix1831" class="ixterm"></a><a id="_ix1832" class="ixterm"></a><a id="_ix1833" class="ixterm"></a><a id="_ix1834" class="ixterm"></a>DVX can run straight from a CD-ROM or a write-protected disk, but it needs somewhere to keep your settings, its log file, and your files. Once the desktop is up, a box titled <strong>Information</strong> tells you which way it went.</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1">&#8220;DVX is running from a disk it cannot write to, such as a CD-ROM, so your settings are kept in the TEMP folder. To keep them somewhere else, set DVXUSER to a folder on your hard disk before starting DVX.&#8221;</dt>
<dd>
<p>DVX uses a folder called <code>DVXUSER</code> inside the folder that the <code>TEMP</code> (or <code>TMP</code>) setting names, in place of the USER folder. Everything works, and is kept there. The first time, it starts as a copy of the USER folder on the disk DVX runs from (all of it but its log: <code>DVX.INI</code>, the file types, Program Manager&#8217;s groups and the other programs' settings, and your own files, such as fonts, themes, sounds, and wallpapers), so you get the same settings and files as without a TEMP folder. Later starts keep what is in <code>TEMP\DVXUSER</code>.</p>
</dd>
<dt class="hdlist1">&#8220;DVX cannot save anything: it is running from a disk it cannot write to, such as a CD-ROM, and there is no TEMP folder. Settings you change are kept until you exit DVX. To keep them, set DVXUSER to a folder on your hard disk before starting DVX, or install DVX with SETUP.&#8221;</dt>
<dd>
<p>There is no <code>TEMP</code> setting either (or its folder cannot be written to). Settings you change last only until you exit DVX, and there is no log file: DVX keeps the latest part of the log in memory, and System Information shows it (see <a href="#trouble-log">Section 11.16</a>).</p>
</dd>
<dt class="hdlist1"><a id="_ix1835" class="ixterm"></a>&#8220;Your changes cannot be saved to disk, so they last only until you exit DVX. To keep them, set DVXUSER to a folder DVX can write to before starting DVX.&#8221;</dt>
<dd>
<p>When nothing can be saved, the first change you save after DVX has started, for example with <b class="button">OK</b> in Control Panel or in Page Setup, brings this reminder that the change lasts only until you exit DVX. It comes only once each time DVX runs.</p>
</dd>
<dt class="hdlist1"><a id="_ix1836" class="ixterm"></a><a id="_ix1837" class="ixterm"></a>&#8220;DVX cannot write to <em>folder</em>, the folder DVXUSER names, so your settings are kept in the TEMP folder. To keep them somewhere else, set DVXUSER to a folder DVX can write to before starting DVX.&#8221;</dt>
<dd>
<p>The <code>DVXUSER</code> setting names a folder DVX cannot write to, such as one on a write-protected disk or a network drive you may only read. DVX uses <code>DVXUSER</code> in the TEMP folder instead, as above. Correct <code>DVXUSER</code>, or make the folder writable.</p>
</dd>
<dt class="hdlist1">&#8220;DVX cannot save anything: it cannot write to <em>folder</em>, the folder DVXUSER names, and there is no TEMP folder. Settings you change are kept until you exit DVX. To keep them, set DVXUSER to a folder DVX can write to before starting DVX.&#8221;</dt>
<dd>
<p>The same, with no <code>TEMP</code> folder either: settings you change last only until you exit DVX.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>To keep your settings and files on the hard disk, do one of these:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Install DVX on the hard disk with Setup (see <a href="#installing-setup">Section 3.3</a>).</p>
</li>
<li>
<p>Or set <code>DVXUSER</code> to a folder on the hard disk: add a line such as <code>SET DVXUSER=C:\MYDVX</code> to <code>AUTOEXEC.BAT</code> (see <a href="#trouble-first-dos-files">Section 11.1.8</a>). DVX makes the folder if it does not exist.</p>
</li>
<li>
<p>Or, at least, set <code>TEMP</code> to an existing folder on the hard disk, such as <code>SET TEMP=C:\TEMP</code>.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>On such a disk, DVX uses its help files as they are, without rebuilding them.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-files-dvxuser"><a class="anchor" href="#trouble-files-dvxuser"></a>11.12.7. The USER folder and DVXUSER</h4>
<div class="paragraph">
<p><a id="_ix1838" class="ixterm"></a><a id="_ix1839" class="ixterm"></a><a id="_ix1840" class="ixterm"></a>DVX keeps everything that is yours in one folder, the USER folder: <code>USER</code> inside the DVX folder, or the folder that the <code>DVXUSER</code> setting names. DVX makes it if it is missing. It holds <code>DVX.INI</code> (DVX&#8217;s settings), <code>ASSOC.INI</code> (your changes to the file types), <code>DVX.LOG</code> (the log file), <code>PROGRAMS.CAC</code>, <code>SECLINK.RND</code>, your own <code>FONTS</code>, <code>SOUNDS</code>, <code>THEMES</code>, <code>WPAPER</code>, <code>BANKS</code>, and <code>SAVERS</code> folders, <code>KEYS</code> (publishers' keys you trust), <code>APPS</code> (each program&#8217;s settings and files, in a folder of its own), and <code>DOWNLOAD</code> (downloads). See <a href="#folders-layout">Section B.1</a>.</p>
</div>
<div class="ulist">
<ul>
<li>
<p>The DVX folder itself is only read while DVX runs, and an upgrade never changes the USER folder. The USER folder is the one folder to back up.</p>
</li>
<li>
<p>If <code>DVXUSER</code> names a folder that cannot be written to, DVX uses <code>DVXUSER</code> in the TEMP folder instead, as on a CD-ROM (see <a href="#trouble-files-readonly-dvx">Section 11.12.6</a>).</p>
</li>
<li>
<p>Setup&#8217;s <strong>Start over</strong> and <strong>Also remove my settings and saved files (the USER folder)</strong> delete the folder <code>DVXUSER</code> names when it is set, but only if that folder holds a <code>DVX.INI</code>.</p>
</li>
</ul>
</div>
</div>
<div class="sect3">
<h4 id="trouble-files-temp"><a class="anchor" href="#trouble-files-temp"></a>11.12.8. The TEMP folder</h4>
<div class="paragraph">
<p><a id="_ix1841" class="ixterm"></a><a id="_ix1842" class="ixterm"></a><a id="_ix1843" class="ixterm"></a>DVX uses the folder that the <code>TEMP</code> (or <code>TMP</code>) setting names for scratch files. Set it in <code>AUTOEXEC.BAT</code> to an existing folder on a disk with free space, for example <code>SET TEMP=C:\TEMP</code>. Without it, or when it cannot be written to:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><a id="_ix1844" class="ixterm"></a>&#8220;Failed to create instance copy of <em>file</em>.&#8221;: a program that can run more than once needs a scratch copy for its second copy, in the TEMP folder (or the USER folder when there is no TEMP folder), and it could not be written: the disk is full or write-protected.</p>
</li>
<li>
<p>The Icon Editor cannot print: &#8220;Could not prepare the icon for printing.&#8221;</p>
</li>
<li>
<p>A DVX BASIC program cannot print to a printer port: error 75, &#8220;Cannot create the printer spool file&#8221;.</p>
</li>
<li>
<p>On a disk DVX cannot write to, settings cannot be kept (see <a href="#trouble-files-readonly-dvx">Section 11.12.6</a>).</p>
</li>
</ul>
</div>
</div>
<div class="sect3">
<h4 id="trouble-files-full"><a class="anchor" href="#trouble-files-full"></a>11.12.9. Saving onto a full disk</h4>
<div class="paragraph">
<p><a id="_ix1845" class="ixterm"></a><a id="_ix1846" class="ixterm"></a><a id="_ix1847" class="ixterm"></a>Before you save a large file, check that the disk has room: File Manager shows the free space of the drive at the bottom of its window. Keep enough free space on the disk you save to.</p>
</div>
<div class="paragraph">
<p><a id="_ix1848" class="ixterm"></a><a id="_ix1849" class="ixterm"></a>When Control Panel cannot save your settings, because the disk of the USER folder is full or write-protected, a box titled <strong>Control Panel</strong> says &#8220;The settings could not be saved: the disk may be full or write-protected. Control Panel stays open: click its OK to try again, or Cancel to undo the changes.&#8221; Nothing is saved, and the settings you tried out stay in use until you click <b class="button">Cancel</b> or exit DVX. Make room on the disk, or make the USER folder writable, and click <b class="button">OK</b> again. <a id="_ix1850" class="ixterm"></a>If only the file types cannot be saved, the box says &#8220;The file types could not be saved: the disk may be full or write-protected.&#8221;; your other settings are saved. See <a href="#cpanel-ok">Section 7.3.1</a>.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-files-filemgr"><a class="anchor" href="#trouble-files-filemgr"></a>11.12.10. File Manager</h4>
<div class="paragraph">
<p><a id="_ix1851" class="ixterm"></a><a id="_ix1852" class="ixterm"></a>File Manager&#8217;s boxes are titled <strong>File Manager</strong> unless noted.</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><a id="_ix1853" class="ixterm"></a>&#8220;Cannot open <em>folder</em>. The folder does not exist or the drive is not ready.&#8221;</dt>
<dd>
<p>After clicking a drive button, typing a path in <strong>Path</strong>, or opening a folder: there is no disk in the drive, the folder was removed or renamed, or the path is mistyped. Insert the disk, or correct the path. (If the folder File Manager is showing disappears, <span class="menuseq"><b class="menu">View</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Refresh</b></span> moves up to the folder above it.) The free space at the bottom is blank when it cannot be read.</p>
</dd>
</dl>
</div>
<div class="sect4">
<h5 id="starting-a-copy-move-or-delete"><a class="anchor" href="#starting-a-copy-move-or-delete"></a>Starting a copy, move, or delete</h5>
<div class="dlist">
<dl>
<dt class="hdlist1">&#8220;Not enough memory to start the operation.&#8221;</dt>
<dd>
<p>Close programs and try again.</p>
</dd>
<dt class="hdlist1">&#8220;<em>file</em> cannot be found, or the destination path would be too long. It is skipped.&#8221;</dt>
<dd>
<p>One selected item was removed meanwhile, or the folder you copy to plus the item&#8217;s name is too long. The other items are still done. Refresh the window and select again, or copy to a folder with a shorter path.</p>
</dd>
<dt class="hdlist1">&#8220;The folder <em>folder</em> cannot be made, or its drive is not ready.&#8221; (title <strong>Copy</strong> or <strong>Move</strong>)</dt>
<dd>
<p>The folder you typed for <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Copy To&#8230;&#8203;</b></span> or <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Move To&#8230;&#8203;</b></span> is on an empty drive or a write-protected disk, or its name is not valid. Choose an existing folder, or a valid name on a disk you can write to.</p>
</dd>
<dt class="hdlist1"><a id="_ix1854" class="ixterm"></a>&#8220;The clipboard holds no files. Use Copy or Cut in a File Manager window first.&#8221; (title <strong>Paste</strong>)</dt>
<dd>
<p>Select files, choose <span class="menuseq"><b class="menu">Edit</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Copy</b></span> or <span class="menuseq"><b class="menu">Edit</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Cut</b></span>, then <span class="menuseq"><b class="menu">Edit</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Paste</b></span>. A cut can be pasted only once.</p>
</dd>
<dt class="hdlist1">&#8220;Delete <em>file</em>?&#8221; or &#8220;Delete these <em>n</em> items?&#8221; (title <strong>Confirm Delete</strong>)</dt>
<dd>
<p><b class="button">Yes</b> deletes them.</p>
</dd>
</dl>
</div>
</div>
<div class="sect4">
<h5 id="questions-while-a-copy-move-or-delete-runs"><a class="anchor" href="#questions-while-a-copy-move-or-delete-runs"></a>Questions while a copy, move, or delete runs</h5>
<div class="paragraph">
<p><a id="_ix1855" class="ixterm"></a>While File Manager works, a window titled <strong>Copying</strong>, <strong>Moving</strong>, or <strong>Deleting</strong> shows its progress. Clicking <b class="button">Cancel</b> there stops it: a file copied part way is removed, and what is finished stays done.</p>
</div>
<div class="paragraph">
<p>Questions with <b class="button">Yes</b>, <b class="button">No</b>, <b class="button">Yes to All</b>, and <b class="button">Cancel</b>:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><a id="_ix1856" class="ixterm"></a>&#8220;<em>file</em> already exists. Replace it with <em>file</em>?&#8221;: <b class="button">Yes</b> replaces this file, <b class="button">No</b> skips it, <b class="button">Yes to All</b> replaces it and every later one, <b class="button">Cancel</b> stops.</p>
</li>
<li>
<p><a id="_ix1857" class="ixterm"></a>&#8220;<em>file</em> is read-only. Delete it anyway?&#8221;: the same buttons; <b class="button">Yes to All</b> covers every read-only file in this delete.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>Problems with <b class="button">Retry</b>, <b class="button">Skip</b>, and <b class="button">Cancel</b>. <b class="button">Retry</b> tries again (for example after putting the disk back), <b class="button">Skip</b> leaves this item out and goes on, and <b class="button">Cancel</b> stops. A folder whose contents were skipped is kept by a move or delete.</p>
</div>
<div class="ulist">
<ul>
<li>
<p>&#8220;Cannot read <em>file</em>.&#8221;, &#8220;Cannot write <em>file</em>.&#8221;, &#8220;Cannot delete <em>file</em>.&#8221;, &#8220;Cannot create folder <em>folder</em>.&#8221;, each followed by a reason (below). A file written part way is removed.</p>
</li>
<li>
<p>&#8220;<em>file</em> was copied but cannot be removed.&#8221;, with a reason: a move copied the file but could not delete the original (a read-only disk, or a file in use). The original stays.</p>
</li>
<li>
<p>&#8220;Cannot replace <em>file</em>: a folder with that name exists.&#8221;</p>
</li>
<li>
<p>&#8220;<em>file</em> cannot be copied onto itself.&#8221;: you copied a file into the folder it is already in. (A move to the same place does nothing.)</p>
</li>
<li>
<p>&#8220;<em>folder</em> cannot be moved into itself.&#8221; or &#8220;<em>folder</em> cannot be copied into itself.&#8221;: you chose the folder itself, or one inside it, as the destination.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p><a id="_ix1858" class="ixterm"></a><a id="_ix1859" class="ixterm"></a>The reason is one of these:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>&#8220;The disk is full.&#8221;: make room, or use another disk.</p>
</li>
<li>
<p>&#8220;Access denied (the file may be read-only or in use, the disk write-protected or not ready).&#8221;: clear the <strong>Read-only</strong> attribute, close the program using the file, remove the write protection, or insert the disk.</p>
</li>
<li>
<p>&#8220;The drive is not ready.&#8221;: the drive has no disk in it. Put the disk in, or use another drive.</p>
</li>
<li>
<p>&#8220;The file or folder was not found.&#8221;: it was removed meanwhile, or the disk was changed.</p>
</li>
<li>
<p>&#8220;The path is too long.&#8221;: use a shorter destination.</p>
</li>
<li>
<p>&#8220;A file or folder with that name already exists.&#8221;</p>
</li>
<li>
<p>Otherwise, the system&#8217;s own description of the error.</p>
<div class="dlist">
<dl>
<dt class="hdlist1">&#8220;File operations are still running. Stop them and close?&#8221;</dt>
<dd>
<p>You closed File Manager&#8217;s window while a copy, move, or delete runs. <b class="button">Yes</b> stops them; <b class="button">No</b> keeps the window open.</p>
</dd>
</dl>
</div>
</li>
</ul>
</div>
</div>
<div class="sect4">
<h5 id="new-folder-rename-opening-and-properties"><a class="anchor" href="#new-folder-rename-opening-and-properties"></a>New Folder, Rename, opening, and Properties</h5>
<div class="ulist">
<ul>
<li>
<p>&#8220;Cannot create <em>folder</em>.&#8221; (title <strong>New Folder</strong>) and &#8220;Cannot rename <em>file</em> to <em>name</em>.&#8221; (title <strong>Rename</strong>), each with a reason as above. &#8220;A file or folder with that name already exists.&#8221; means the new name is taken. A name that breaks the rules gives one of the messages in <a href="#trouble-files-names">Section 11.12.2</a>.</p>
</li>
<li>
<p>&#8220;Select one file or folder to rename.&#8221; (title <strong>Rename</strong>): several items are selected.</p>
</li>
<li>
<p><a id="_ix1860" class="ixterm"></a>&#8220;No program is set to open <em>ext</em> files. File types are set in the Control Panel.&#8221;: no program is set for that kind of file (<em>ext</em> is its extension, such as <code>TXT</code>, or the word <code>these</code> for a file without one). Choose one on Control Panel&#8217;s File Types page (see <a href="#cpanel-file-types">Section 7.8</a>).</p>
</li>
<li>
<p>&#8220;<em>file</em> could not be opened.&#8221;: the program set for that kind of file could not be started, for example because it was removed. Check the File Types page, or reinstall the program.</p>
</li>
<li>
<p>&#8220;The attributes of some items could not be changed.&#8221; (title <strong>Properties</strong>): the disk cannot be written to (a CD-ROM or write-protected floppy), or an item was removed meanwhile. Copy the files to a hard disk first.</p>
</li>
<li>
<p>In Properties, a size followed by &#8220;(some items could not be read)&#8221; means part of the selection could not be read.</p>
</li>
</ul>
</div>
</div>
</div>
<div class="sect3">
<h4 id="trouble-files-notepad"><a class="anchor" href="#trouble-files-notepad"></a>11.12.11. Notepad</h4>
<div class="paragraph">
<p><a id="_ix1861" class="ixterm"></a><a id="_ix1862" class="ixterm"></a>Notepad&#8217;s boxes are titled <strong>Notepad</strong>:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><a id="_ix1863" class="ixterm"></a>&#8220;Could not open <em>file</em> (error <em>n</em>).&#8221;</dt>
<dd>
<p>Error 53: the file does not exist. Error 76: its folder does not exist. Error 71: the drive is empty or not ready. Error 57: the disk failed. Error 70: another program is using the file. (To start a new file, see <a href="#trouble-files-dialogs">Section 11.12.1</a>.) The text already in Notepad stays. Check the name and the disk.</p>
</dd>
<dt class="hdlist1"><a id="_ix1864" class="ixterm"></a><a id="_ix1865" class="ixterm"></a><a id="_ix1866" class="ixterm"></a>&#8220;Could not save <em>file</em> (error <em>n</em>).&#8221;</dt>
<dd>
<p>Error 75: the file is read-only, or the disk cannot take the file (a CD-ROM, a write-protected floppy, or a floppy disk whose main folder is full). Error 76: the folder does not exist. Error 61: the disk is full. Error 71: the drive is not ready (no disk in it). Error 57: the disk could not be written: it failed. Error 70: another program is using the file. Notepad writes the text into a new file beside the old one first and puts it in the old one&#8217;s place only when all of it was written, so the file on the disk is left as it was (while saving, the disk needs room for both). Use <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Save As&#8230;&#8203;</b></span> to save to a disk or folder you can write to (or make room on the disk first), or clear the file&#8217;s <strong>Read-only</strong> attribute. The text stays unsaved, and the title keeps its <code>*</code>.</p>
</dd>
<dt class="hdlist1"><a id="_ix1867" class="ixterm"></a>&#8220;<em>file</em> is not a text file, so Notepad did not open it.&#8221;</dt>
<dd>
<p>The file holds NUL characters, which no text has: it is a program, a picture, or another kind of data, which Notepad cannot keep whole. The text already in Notepad stays.</p>
</dd>
<dt class="hdlist1"><a id="_ix1868" class="ixterm"></a>&#8220;<em>file</em> is too big for Notepad.&#8221;</dt>
<dd>
<p>Notepad holds files up to 262,144 characters (256 KB), and less when memory is short. The file is not opened. Edit large files with another editor, such as a DOS editor run from DVX.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>When you close Notepad, or choose New or Open, with unsaved changes, it asks &#8220;Save changes?&#8221; (<b class="button">Yes</b> saves, <b class="button">No</b> throws the changes away, <b class="button">Cancel</b> goes back).</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-files-programs"><a class="anchor" href="#trouble-files-programs"></a>11.12.12. Other programs' file messages</h4>
<div class="dlist">
<dl>
<dt class="hdlist1"><a id="_ix1869" class="ixterm"></a><a id="_ix1870" class="ixterm"></a><a id="_ix1871" class="ixterm"></a><a id="_ix1872" class="ixterm"></a><a id="_ix1873" class="ixterm"></a>Image Viewer</dt>
<dd>
<p>Its boxes are titled <strong>Image Viewer</strong>. <a id="_ix1874" class="ixterm"></a>&#8220;Could not load <em>file</em>.&#8221;: the file is not a BMP, PNG, JPEG, or GIF picture the viewer can read, it is damaged, or there is not enough memory for a large picture. The window is left empty. Open another file, convert the picture, or close programs. &#8220;Open a picture first.&#8221;: you chose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Print&#8230;&#8203;</b></span> with no picture shown.</p>
</dd>
<dt class="hdlist1">Icon Editor</dt>
<dd>
<p>Its boxes are titled <strong>Icon Editor</strong>. &#8220;Could not load <em>file</em>.&#8221;: not a picture it can read; the icon you had stays. &#8220;Icons must be 16 x 16, 24 x 24, or 32 x 32 pixels.&#8221;: the picture you opened is not one of those square sizes. &#8220;Could not save <em>file</em>.&#8221;: the disk is full or write-protected, the file is read-only, or the folder is wrong; a file of that name on the disk is left as it was. &#8220;Could not prepare the icon for printing.&#8221;: see <a href="#trouble-files-temp">Section 11.12.8</a>. Its questions &#8220;Unsaved changes will be lost. Change size?&#8221;, &#8220;Unsaved changes. Start new icon?&#8221;, and &#8220;Unsaved changes. Open another file?&#8221; warn before your changes are thrown away.</p>
</dd>
<dt class="hdlist1">Resource Editor</dt>
<dd>
<p>It shows its messages in its status line. &#8220;No file loaded.&#8221;: open a file first. &#8220;<em>file</em> - <em>n</em> resource(s)&#8221;: a file with no resources, or one it cannot read as one, shows 0. &#8220;Failed to add resource.&#8221;, &#8220;Failed to update resource.&#8221;, &#8220;Failed to extract resource.&#8221;, &#8220;Failed to remove resource.&#8221;: the file is read-only or on a disk that cannot be written to, the disk is full, or the file to add cannot be read. A file an extraction could not write is left as it was. Work on a copy on a disk you can write to. &#8220;Only text resources can be edited inline.&#8221;: an icon or other resource cannot be edited as text. It asks &#8220;Remove resource '<em>name</em>'?&#8221; before removing one.</p>
</dd>
<dt class="hdlist1">Help Editor</dt>
<dd>
<p>Its boxes are titled <strong>Help Editor</strong>. &#8220;Could not open <em>file</em> (error <em>n</em>).&#8221;, &#8220;Could not save <em>file</em> (error <em>n</em>).&#8221;, &#8220;<em>file</em> is not a text file, so the Help Editor did not open it.&#8221;, and &#8220;<em>file</em> is too big for the Help Editor.&#8221; mean the same as in Notepad; after a failed save it does not close or start another file. Its status line shows &#8220;Compiling&#8230;&#8203;&#8221;, then &#8220;Compiled: <em>file</em>.hlp&#8221; or &#8220;Compile failed!&#8221; (with the help compiler&#8217;s errors in a box titled <strong>Compile failed</strong>), &#8220;Not compiled: the source could not be saved.&#8221;, or &#8220;Save cancelled.&#8221; <a id="_ix1875" class="ixterm"></a>&#8220;The help compiler is not available, or no input or output file was given.&#8221; means the help compiler is missing: it is part of Developer Tools, which you add by running Setup again (see <a href="#installing-parts">Section 3.5</a>).</p>
</dd>
<dt class="hdlist1">BASIC Demo</dt>
<dd>
<p>Its boxes are titled <strong>BASIC Demo</strong>. &#8220;Could not save <em>file</em> (error <em>n</em>).&#8221; as in Notepad, and &#8220;To print the report, choose your printer&#8217;s model on the Control Panel&#8217;s Printer page.&#8221; (see <a href="#trouble-printing-pictures">Section 11.8.4</a>).</p>
</dd>
<dt class="hdlist1">DVX Demo</dt>
<dd>
<p>Its boxes, such as &#8220;Close this window?&#8221; and &#8220;A new document would be created here.&#8221;, demonstrate DVX&#8217;s dialogs; they are not errors.</p>
</dd>
</dl>
</div>
</div>
<div class="sect3">
<h4 id="trouble-files-fonts"><a class="anchor" href="#trouble-files-fonts"></a>11.12.13. Fonts</h4>
<div class="paragraph">
<p><a id="_ix1876" class="ixterm"></a><a id="_ix1877" class="ixterm"></a><a id="_ix1878" class="ixterm"></a>DVX&#8217;s fonts are in the <code>FONTS</code> folder in <code>SHARED</code>, and your own in the <code>FONTS</code> folder in USER (a file of yours with the same name is used instead of DVX&#8217;s). When a program asks for a font that is not installed, or whose file cannot be used, it shows its text in DVX&#8217;s own <strong>System</strong> font instead, with no message. A size the font lacks is replaced by the nearest size it has.</p>
</div>
<div class="paragraph">
<p>A font file that cannot be used is left out, and the log file says why, in a line starting <code>Fonts:</code>, such as <code>Fonts: <em>file</em> is damaged.</code> A font whose file stops working after DVX has started gives a line such as <code>Fonts: <em>file</em> cannot be read. Drawing <em>family</em> with the system font.</code> The reasons are &#8220;cannot be opened&#8221;, &#8220;cannot be read&#8221;, &#8220;is not a DVX font file of this version&#8221;, &#8220;is damaged&#8221;, &#8220;has no such size&#8221;, &#8220;has glyphs that do not match its bitmaps&#8221;, and &#8220;has a text too big for the memory left&#8221;. Other <code>Fonts:</code> lines say a file was skipped because it uses the System font&#8217;s name, repeats a style, lacks a size, or there was no memory for it.</p>
</div>
<div class="paragraph">
<p>To fix it, install the fonts again (the base set with Setup, or as <strong>DVX Fonts</strong> from the package server in Software; other fonts with Software), or remove a damaged <code>.DFN</code> file from the <code>FONTS</code> folder in USER.</p>
</div>
<div class="paragraph">
<p>The <strong>Licence&#8230;&#8203;</strong> button of the Font dialog shows each font&#8217;s licence. For the System font, a box titled <strong>Font Licence</strong> says &#8220;The System font is DVX&#8217;s own: it comes with DVX, under DVX&#8217;s licence.&#8221; <a id="_ix1879" class="ixterm"></a>For a font whose file cannot be read, it says &#8220;The licence of the font <em>family</em> cannot be read. The log file says why.&#8221;: install the font again.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-files-help"><a class="anchor" href="#trouble-files-help"></a>11.12.14. Help files</h4>
<div class="paragraph">
<p><a id="_ix1880" class="ixterm"></a><a id="_ix1881" class="ixterm"></a><a id="_ix1882" class="ixterm"></a>The DVX Help window&#8217;s boxes are titled <strong>DVX Help</strong>:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1">&#8220;Could not open help file.&#8221;</dt>
<dd>
<p>The help file is missing, cannot be read, is damaged, or was made for another version of DVX. When DVX Help is starting, it then closes; when it is already open, the file already shown stays. Reinstall the program or part the help belongs to; for DVX&#8217;s own guide, run Setup and choose <strong>Upgrade or repair DVX</strong>. A program with no help of its own opens DVX&#8217;s guide on <kbd>F1</kbd>.</p>
</dd>
<dt class="hdlist1">&#8220;No index available.&#8221;</dt>
<dd>
<p>The help file has no index.</p>
</dd>
<dt class="hdlist1">&#8220;No matching topics found.&#8221; (title <strong>Search Help</strong>)</dt>
<dd>
<p>No page has the words you searched for.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>DVX rebuilds help files only when libraries or widgets are added or removed. If a help file fails to rebuild, the log file has a line starting <code>helpRecompile: FAILED</code>; DVX tries again at the next start, up to three starts in all.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-files-databases"><a class="anchor" href="#trouble-files-databases"></a>11.12.15. Databases</h4>
<div class="paragraph">
<p><a id="_ix1883" class="ixterm"></a>Programs written in DVX BASIC that keep their data in a database show the database&#8217;s own messages in their own boxes:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>&#8220;unable to open database file (<em>reason</em>)&#8221;: the file or its folder is missing, or the disk is not ready.</p>
</li>
<li>
<p>&#8220;attempt to write a readonly database&#8221;: the database is on a CD-ROM or a write-protected disk, or is a read-only file. Copy it to a hard disk and clear its <strong>Read-only</strong> attribute.</p>
</li>
<li>
<p>&#8220;database is locked&#8221;: another program in DVX is using the database. Wait for it to finish, or close it, and try again. Do not share a database file with a program outside DVX.</p>
</li>
<li>
<p>&#8220;A statement is still running on this database&#8221;, &#8220;Out of memory&#8221;, and &#8220;interrupted&#8221; (the program stopped a long search, and its changes were undone).</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>A database&#8217;s journal file has the same name with the extension <code>.NAL</code> (<code>DATA.DB</code> uses <code>DATA.NAL</code>). Keep it beside the database. Two databases whose names differ only in their extension share it, so keep them in different folders. Programs that use databases need the Databases part of DVX; without it they stop with error 453 (see <a href="#trouble-programs-basic-missing">Section 11.14.3</a>).</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="trouble-programs"><a class="anchor" href="#trouble-programs"></a>11.13. A program does not work</h3>
<div class="paragraph">
<p><a id="_ix1884" class="ixterm"></a><a id="_ix1885" class="ixterm"></a>This section covers programs that will not start, that stop responding, or that crash; exiting DVX; DOS programs; screen savers; and Program Manager&#8217;s messages. The error boxes of programs written in DVX BASIC are in <a href="#trouble-programs-basic">Section 11.14</a>.</p>
</div>
<div class="sect3">
<h4 id="trouble-programs-start"><a class="anchor" href="#trouble-programs-start"></a>11.13.1. A program will not start</h4>
<div class="dlist">
<dl>
<dt class="hdlist1"><a id="_ix1886" class="ixterm"></a><a id="_ix1887" class="ixterm"></a>&#8220;<em>name</em> is already running.&#8221; (title <strong>Error</strong>)</dt>
<dd>
<p>Most programs can be open only once, and this one is open already: perhaps minimized to an icon, or behind other windows. Press <span class="keyseq"><kbd>Alt</kbd>+<kbd>Tab</kbd></span> until it comes to the front, or press <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Esc</kbd></span> and use <b class="button">Switch To</b> in the Task Manager. (When DVX runs from a disk it cannot write to and there is no TEMP folder, every program can be open only once.) A program that opens documents, such as Media Player, takes the new document instead, without a message.</p>
</dd>
<dt class="hdlist1">&#8220;Failed to create instance copy of <em>file</em>.&#8221;</dt>
<dd>
<p>A second copy of a program needs a scratch copy in the TEMP folder, and it could not be written. See <a href="#trouble-files-temp">Section 11.12.8</a>.</p>
</dd>
<dt class="hdlist1"><a id="_ix1888" class="ixterm"></a>&#8220;Failed to load <em>file</em>: <em>reason</em>&#8221;</dt>
<dd>
<p>The program&#8217;s file is damaged, or it needs a library that is not installed or could not be loaded. (A program file that is not there at all gives &#8220;Cannot find <em>path</em>.&#8221; instead.) The second line is a short technical reason; the log file may also have a line with <code>FAILED:</code> for the library. Reinstall the program with Software, install what it needs, or run Setup and choose <strong>Upgrade or repair DVX</strong> for DVX&#8217;s own programs.</p>
</dd>
<dt class="hdlist1">&#8220;<em>file</em>: missing appDescriptor&#8221; or &#8220;<em>file</em>: missing appMain&#8221;</dt>
<dd>
<p>The file is not a DVX program, or it is damaged. Reinstall it.</p>
</dd>
<dt class="hdlist1"><a id="_ix1889" class="ixterm"></a>&#8220;This program was built for a different version of DVX and cannot run.&#8221;</dt>
<dd>
<p>The program was made for an older or newer DVX. Get a copy made for your version of DVX.</p>
</dd>
<dt class="hdlist1"><a id="_ix1890" class="ixterm"></a><a id="_ix1891" class="ixterm"></a>&#8220;Out of memory: cannot allocate an application slot.&#8221; or &#8220;Failed to create task for application.&#8221;</dt>
<dd>
<p>There is not enough memory to start another program. Close programs you are not using (see <a href="#trouble-programs-memory">Section 11.13.2</a>).</p>
</dd>
<dt class="hdlist1"><a id="_ix1892" class="ixterm"></a>&#8220;Cannot find <em>path</em>.&#8221; (title <strong>Run</strong>)</dt>
<dd>
<p>The program or document typed in <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Run&#8230;&#8203;</b></span> or in the Task Manager&#8217;s <strong>Run</strong> box, set in a Program Manager item, named by the <code>welcome</code> line of <code>DVX.INI</code>, or given with <code>/RUN=</code> does not exist, or is a folder. Correct the name, or the item&#8217;s <strong>Program</strong> box. In <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Run&#8230;&#8203;</b></span>, put a name with spaces in double quotes.</p>
</dd>
<dt class="hdlist1"><a id="_ix1893" class="ixterm"></a>&#8220;No program is set up to open <em>file</em>. Choose one on the File Types page of the Control Panel.&#8221; (title <strong>Run</strong>)</dt>
<dd>
<p>No program is set for that kind of document. Choose one on Control Panel&#8217;s File Types page (see <a href="#cpanel-file-types">Section 7.8</a>).</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p><a id="_ix1894" class="ixterm"></a><a id="_ix1895" class="ixterm"></a>On the File Types page, a box titled <strong>File Types</strong> may say &#8220;An extension is one to eight letters or digits, such as TXT.&#8221; (type the extension without the dot) or &#8220;Type the program that opens this type.&#8221; (the program box is empty). If your changes to the file types do not last, the log file may say <code>Assoc: cannot save the file types (<em>file</em>)</code>: the USER folder cannot be written to. To put every file type back as DVX had it, see <a href="#trouble-settings">Section 11.15</a>.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-programs-memory"><a class="anchor" href="#trouble-programs-memory"></a>11.13.2. Running low on memory</h4>
<div class="paragraph">
<p><a id="_ix1896" class="ixterm"></a><a id="_ix1897" class="ixterm"></a><a id="_ix1898" class="ixterm"></a>Each running program uses memory. When DVX or a program says memory is short:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Close programs you are not using.</p>
</li>
<li>
<p>Check memory in the Task Manager (<span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Esc</kbd></span>): it shows each program&#8217;s memory, and at the bottom <code>Applications: <em>n</em> Memory: <em>used</em>/<em>total</em> MB</code>. System Information (in Program Manager&#8217;s Help menu) shows the computer&#8217;s memory as it is when you open it.</p>
</li>
<li>
<p>Use a smaller screen mode or fewer colors, which frees memory (see <a href="#trouble-video-choose">Section 11.3.3</a>).</p>
</li>
<li>
<p>Free more memory for DVX before it starts (see <a href="#trouble-start-memory">Section 11.2.6</a>).</p>
</li>
</ol>
</div>
</div>
<div class="sect3">
<h4 id="trouble-programs-hang"><a class="anchor" href="#trouble-programs-hang"></a>11.13.3. A program stops responding</h4>
<div class="paragraph">
<p><a id="_ix1899" class="ixterm"></a><a id="_ix1900" class="ixterm"></a><a id="_ix1901" class="ixterm"></a><a id="_ix1902" class="ixterm"></a><a id="_ix1903" class="ixterm"></a>A program that has been busy for 5 seconds or more without coming back to DVX counts as not responding. (A program that is only waiting for you to answer one of its own message boxes does not count.) Its windows stop reacting, but the rest of DVX keeps working. To end it:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Press <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Esc</kbd></span>. The Task Manager opens, from any program.</p>
</li>
<li>
<p>Find the program in the list. Its <strong>Status</strong> column says <code>Not responding</code> instead of <code>Running</code> (the list is checked again every second).</p>
</li>
<li>
<p>Select it and click <b class="button">End Task</b>.</p>
</li>
</ol>
</div>
<div class="imageblock">
<div class="content">
<img src="images/trTaskManager.png" alt="The Task Manager window" width="listing Program Manager and Notepad with their memory and status" height="and the Switch To">
</div>
<div class="title">Figure 59. The Task Manager, with each program&#8217;s memory and status</div>
</div>
<div class="admonitionblock warning">
<table>
<tr>
<td class="icon">
<div class="title">Warning</div>
</td>
<td class="content">
<b class="button">End Task</b> ends the program at once. It does not ask first (except for Program Manager, below), and the program cannot save, so unsaved work in it is lost. The other programs keep running.
</td>
</tr>
</table>
</div>
<div class="paragraph">
<p>When you end a program written in DVX BASIC this way, its windows close at once, and anything it had drawn for the printer is thrown away, not printed.</p>
</div>
<div class="paragraph">
<p><a id="_ix1904" class="ixterm"></a><a id="_ix1905" class="ixterm"></a>Ending Program Manager ends DVX, so End Task asks &#8220;Are you sure you want to exit DVX?&#8221; first, as <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Exit DVX</b></span> does. <b class="button">No</b> keeps everything running. <b class="button">Yes</b> closes the other programs as when you exit DVX, each asking about its unsaved work (see <a href="#trouble-programs-exit">Section 11.13.5</a>). A Program Manager that is not responding is ended at once, and DVX then exits the same way.</p>
</div>
<div class="paragraph">
<p><a id="_ix1906" class="ixterm"></a>If the whole screen is frozen and even the mouse pointer does not move, DVX cannot recover. Restart the computer.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-programs-crash"><a class="anchor" href="#trouble-programs-crash"></a>11.13.4. A program crashes</h4>
<div class="paragraph">
<p><a id="_ix1907" class="ixterm"></a><a id="_ix1908" class="ixterm"></a><a id="_ix1909" class="ixterm"></a>When a program makes a serious mistake, DVX stops it and shows a box titled <strong>Application Error</strong>:</p>
</div>
<div class="paragraph">
<p>&#8220;'<em>name</em>' has caused a fault and will be terminated.&#8221;</p>
</div>
<div class="paragraph">
<p>Click <b class="button">OK</b>. The program is ended, and its unsaved work is lost; the rest of DVX and your other programs keep running. Start the program again.</p>
</div>
<div class="paragraph">
<p>If it keeps happening, report it to the program&#8217;s author with the log file: copy <code>DVX.LOG</code> from the USER folder before you start DVX again (DVX empties it at each start). It has a section starting <code>=== CRASH ===</code> that names the program and gives details its author needs (see <a href="#trouble-log">Section 11.16</a>).</p>
</div>
<div class="paragraph">
<p>A program can also end itself suddenly, with no box at all; the log file then has a line such as <code>Shell: '<em>name</em>' called exit (status <em>n</em>); ending it</code>.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-programs-exit"><a class="anchor" href="#trouble-programs-exit"></a>11.13.5. DVX will not exit</h4>
<div class="paragraph">
<p><a id="_ix1910" class="ixterm"></a><a id="_ix1911" class="ixterm"></a><a id="_ix1912" class="ixterm"></a><span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Exit DVX</b></span> in Program Manager (or closing Program Manager&#8217;s window) asks &#8220;Are you sure you want to exit DVX?&#8221; in a box titled <strong>Exit DVX</strong>. When you click <b class="button">Yes</b>, DVX asks each running program to close its windows, the way you would. A program with unsaved work asks whether to save it:</p>
</div>
<div class="imageblock">
<div class="content">
<img src="images/trSaveChanges.png" alt="Notepad&#8217;s box asking &quot;Save changes?&quot; with Yes" width="No" height="and Cancel buttons">
</div>
<div class="title">Figure 60. A program asks about unsaved work as DVX exits</div>
</div>
<div class="ulist">
<ul>
<li>
<p><b class="button">Yes</b> saves and closes, <b class="button">No</b> closes without saving.</p>
</li>
<li>
<p><b class="button">Cancel</b> stops the exit: DVX keeps running. Programs already closed stay closed. Save or close that program, then choose <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Exit DVX</b></span> again.</p>
</li>
<li>
<p>If a dialog box is open, DVX brings it to the front and does not exit. Finish with the dialog, then exit again.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p><a id="_ix1913" class="ixterm"></a>If a program does nothing for 5 seconds after being asked to close, a box titled <strong>Exit DVX</strong> asks &#8220;'<em>name</em>' is not responding to the request to close. End it and continue exiting DVX?&#8221; <b class="button">Yes</b> ends it (its unsaved work is lost) and goes on exiting; <b class="button">No</b> keeps DVX running. The same question, &#8220;'<em>name</em>' is not responding to the request to close. End it?&#8221;, comes in a box titled <strong>Close Program</strong> when DVX closes programs before running a DOS program.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-programs-dos"><a class="anchor" href="#trouble-programs-dos"></a>11.13.6. DOS programs</h4>
<div class="paragraph">
<p><a id="_ix1914" class="ixterm"></a><a id="_ix1915" class="ixterm"></a>DVX runs DOS programs (files ending in <code>.EXE</code>, <code>.COM</code>, or <code>.BAT</code>) from Program Manager, <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Run&#8230;&#8203;</b></span>, or File Manager. Before one runs, DVX closes the other programs, and asks first in a box titled <strong>Run DOS Program</strong>:</p>
</div>
<div class="paragraph">
<p>&#8220;Running <em>file</em> closes these programs first: <em>programs</em> Each one asks about unsaved work as it closes. Continue?&#8221;</p>
</div>
<div class="paragraph">
<p><b class="button">No</b> keeps everything as it is, and the DOS program does not run. <b class="button">Cancel</b> in any program&#8217;s save question also stops the DOS program from running; the programs closed before it stay closed. See <a href="#desktop-dos-programs">Section 5.15</a>.</p>
</div>
<div class="paragraph">
<p>Other messages, in boxes titled <strong>Run DOS Program</strong>:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1">&#8220;Cannot find <em>path</em>.&#8221;</dt>
<dd>
<p>A DOS program named with its folder does not exist. Correct the item&#8217;s <strong>Program</strong> box. (A program named without a folder is looked for by DOS on its PATH; if DOS does not find it, DOS prints its own message on the text screen.)</p>
</dd>
<dt class="hdlist1"><a id="_ix1916" class="ixterm"></a>&#8220;DVX could not run <em>file</em>. <em>reason</em>&#8221;</dt>
<dd>
<p>The reason is the system&#8217;s own, for example &#8220;Argument list too long (E2BIG)&#8221; (the program&#8217;s name and arguments together are longer than the 126 characters DOS allows: shorten the arguments), &#8220;No such file or directory (ENOENT)&#8221; (the item&#8217;s <strong>Working folder</strong> does not exist: correct it), or &#8220;Not enough memory (ENOMEM)&#8221;.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>DVX stays in memory while a DOS program runs, so a program that needs a lot of memory may not start; its own "not enough memory" message then appears on the DOS screen. To read what a DOS program prints before DVX comes back, tick <strong>Wait for a key when a DOS program ends</strong> in the item&#8217;s properties: DVX then shows &#8220;Press any key to return to DVX.&#8221; Run a program that needs much memory from DOS, after leaving DVX.</p>
</div>
<div class="paragraph">
<p>While a DOS program runs, DOS&#8217;s own <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Break</kbd></span> and its &#8220;Abort, Retry, Fail?&#8221; question work as usual; DVX restores its own afterwards. The network is stopped and the sound card is let go while it runs.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-programs-savers"><a class="anchor" href="#trouble-programs-savers"></a>11.13.7. Screen savers</h4>
<div class="paragraph">
<p><a id="_ix1917" class="ixterm"></a><a id="_ix1918" class="ixterm"></a>The screen saver is chosen, with its <strong>Wait</strong> (1 to 60 minutes, 10 unless you change it), on Control Panel&#8217;s Desktop page (see <a href="#cpanel-desktop">Section 7.6</a>). There is none until you choose one. DVX comes with <strong>Blank Screen</strong>, <strong>Marquee</strong>, <strong>Mystify</strong>, and <strong>Starfield</strong>.</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1">The screen saver does not start</dt>
<dd>
<p>It does not start while a message box or dialog box is open, or while a program uses the whole screen. Check that one is chosen.</p>
</dd>
<dt class="hdlist1">A screen saver is missing or does not work</dt>
<dd>
<p>DVX shows no message (nobody is there to read it) and tries again after the next wait. The log file says <code>Shell: screen saver <em>name</em> not found</code> or <code>Shell: screen saver <em>name</em> did not start</code>. Choose another screen saver, or <strong>(None)</strong>.</p>
</dd>
<dt class="hdlist1">The key you pressed to end it did nothing in your program</dt>
<dd>
<p>The key or mouse movement that ends the screen saver goes to the screen saver, not to the program underneath. A screen saver still there 3 seconds after being asked to close is ended.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>Screen savers are kept in the <code>SAVERS</code> folder in <code>SHARED</code> and in your own <code>SAVERS</code> folder in USER. Program Manager does not list them.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-programs-progman"><a class="anchor" href="#trouble-programs-progman"></a>11.13.8. Program Manager messages</h4>
<div class="paragraph">
<p><a id="_ix1919" class="ixterm"></a><a id="_ix1920" class="ixterm"></a>Program Manager&#8217;s messages:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>&#8220;That group is full.&#8221;: a group holds at most 256 items. Use another group.</p>
</li>
<li>
<p>&#8220;A group needs a name no other group has.&#8221;: choose another name.</p>
</li>
<li>
<p>&#8220;There is no room for another group: Program Manager holds up to 64 groups of your own. Delete a group to make room for a new one.&#8221; (title <strong>New Group</strong>): you have 64 groups of your own already. Delete a group you no longer need first.</p>
</li>
<li>
<p>&#8220;There is no other group. Make one with File &gt; New Group first.&#8221;: you chose Move or Copy (or New Item) with only one group.</p>
</li>
<li>
<p>&#8220;Type the program or document this item opens.&#8221; (title <strong>Properties</strong>): the <strong>Program</strong> box is empty.</p>
</li>
<li>
<p>&#8220;A shortcut key is Ctrl with Alt or Shift, and a letter, a digit, F1 to F12, or one of Backspace, Del, Down, End, Enter, Esc, Home, Ins, Left, PgDn, PgUp, Right, Space, Tab, and Up, for example Ctrl+Alt+P.&#8221; (title <strong>Properties</strong>): the shortcut typed is not allowed.</p>
</li>
<li>
<p>&#8220;<em>keys</em> cannot be a shortcut key: it <em>does</em>.&#8221; (title <strong>Properties</strong>): DVX itself uses those keys, for example <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>F4</kbd></span> (it closes the active window), so they could never start the item. Choose other keys (see <a href="#progman-shortcut-keys">Section 6.4.4</a>).</p>
</li>
<li>
<p>&#8220;<em>keys</em> is already the shortcut for "<em>item</em>".&#8221;: each shortcut can belong to one item only.</p>
</li>
<li>
<p>&#8220;"<em>item</em>" no longer has its shortcut key <em>keys</em>. <em>reason</em> Choose another one in the item&#8217;s Properties.&#8221; (title <strong>Program Manager</strong>, when Program Manager starts): the item&#8217;s shortcut key, kept in <code>PROGMAN.INI</code>, is not allowed (any more), for example because DVX now keeps those keys for itself; the reason is one of the two shortcut key messages above. The item keeps everything else, and the key is removed from the file, so the message comes only once. Give the item another shortcut key in its Properties (see <a href="#progman-shortcut-keys">Section 6.4.4</a>).</p>
</li>
<li>
<p>&#8220;Delete "<em>item</em>" from the group "<em>group</em>"? The program itself is not removed.&#8221; and &#8220;Delete the group "<em>group</em>" and its <em>n</em> item(s)? The programs themselves are not removed.&#8221;: deleting icons never uninstalls the programs.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p><a id="_ix1921" class="ixterm"></a>Program Manager keeps its groups, items, and options in <code>PROGMAN.INI</code>, in its folder in USER (<code>USER\APPS\KPUNCH\PROGMAN</code>). If it cannot save the file, it says so only in the log file: <code>Progman: cannot save <em>file</em></code>. Deleting the file gives the default, empty Main and Startup groups at the next start (see <a href="#trouble-settings">Section 11.15</a>).</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="trouble-programs-basic"><a class="anchor" href="#trouble-programs-basic"></a>11.14. Error messages from DVX BASIC programs</h3>
<div class="paragraph">
<p><a id="_ix1922" class="ixterm"></a><a id="_ix1923" class="ixterm"></a><a id="_ix1924" class="ixterm"></a><a id="_ix1925" class="ixterm"></a>Many programs in DVX are written in DVX BASIC, among them File Manager, Notepad, Clock, Terminal, and Welcome, as are many programs you install. When such a program meets an error it does not handle itself, DVX stops it and shows a box titled <strong>BASIC Runtime Error</strong>, with two parts: a summary line, then the details.</p>
</div>
<div class="sect3">
<h4 id="trouble-programs-basic-box"><a class="anchor" href="#trouble-programs-basic-box"></a>11.14.1. The BASIC Runtime Error box</h4>
<div class="paragraph">
<p>For an error in the program&#8217;s code, the summary is &#8220;Runtime error <em>number</em> at PC <em>n</em>&#8221; (or &#8220;Runtime error <em>number</em> on line <em>line</em>&#8221; in a program built with line numbers), and the details give the error&#8217;s text. For example: &#8220;Runtime error 53 at PC 1234&#8221;, then &#8220;File not found&#8221;. The <code>PC</code> number is a place in the program that means something only to its author. &#8220;Runtime error&#8221; with &#8220;Unknown error&#8221; means the error has no text.</p>
</div>
<div class="paragraph">
<p>For an error found in a form or one of its controls, the summary names the problem (for example &#8220;Read of unknown control&#8221;), and the details name the form, the control, and the property.</p>
</div>
<div class="paragraph">
<p>When you click <b class="button">OK</b>, the program&#8217;s windows close and it ends; its unsaved work is lost. DVX and your other programs keep running. Only one box is shown, even if several things went wrong.</p>
</div>
<div class="paragraph">
<p>What to do:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Write down the number and the text, and click <b class="button">OK</b>.</p>
</li>
<li>
<p>Start the program again.</p>
</li>
<li>
<p>If the error is about files (numbers 52 to 76), check the disk, folder, or file it was using: it may be missing, read-only, or full.</p>
</li>
<li>
<p>If it is about memory (error 7 or 14), close other programs.</p>
</li>
<li>
<p>If it keeps happening, report it to the program&#8217;s author, with the whole text of the box and the log file. The log file has the error as <code>BASIC RUNTIME ERROR: <em>summary</em></code>, followed by the details.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>A program that handles its own errors shows its own messages instead, as Notepad does.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-programs-basic-start"><a class="anchor" href="#trouble-programs-basic-start"></a>11.14.2. A BASIC program that cannot start</h4>
<div class="paragraph">
<p>These come in a box titled <strong>Error</strong>, and the program does not start:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>&#8220;No compiled module found in this application.&#8221; or &#8220;MODULE resource not found.&#8221;: the program&#8217;s file is damaged or incomplete. Reinstall it.</p>
</li>
<li>
<p>&#8220;MODULE resource failed to deserialize.&#8221;: the program was made for a different version of DVX BASIC, or its file is damaged. Get a copy made for this version of DVX, or reinstall it.</p>
</li>
<li>
<p>&#8220;Out of memory creating the BASIC runtime.&#8221;, &#8220;Out of memory creating the form runtime.&#8221;, &#8220;Out of memory loading program&#8221;: close programs.</p>
</li>
<li>
<p>&#8220;Program needs <em>n</em> global variables; the limit is <em>n</em>&#8221;: the program is too large for this DVX BASIC. Only its author can fix it.</p>
</li>
<li>
<p>&#8220;No program loaded&#8221;: the program could not be loaded. Reinstall it.</p>
</li>
</ul>
</div>
</div>
<div class="sect3">
<h4 id="trouble-programs-basic-missing"><a class="anchor" href="#trouble-programs-basic-missing"></a>11.14.3. A part of DVX the program needs is missing</h4>
<div class="paragraph">
<p><a id="_ix1926" class="ixterm"></a><a id="_ix1927" class="ixterm"></a>&#8220;Runtime error 453 at PC <em>n</em>&#8221; with &#8220;External function not found: <em>name</em>&#8221; appears the first time the program uses a library that is not installed or cannot be loaded. Most often a part of DVX the program needs, such as Networking or Databases, was not installed, or an add-on was removed or is damaged. Add the part with Setup (see <a href="#installing-parts">Section 3.5</a>), or install the add-on with Software. The program&#8217;s own help should say what it needs.</p>
</div>
<div class="paragraph">
<p>&#8220;Printing is not installed&#8221; with &#8220;The Printer object needs the printing library (print.lib).&#8221; means DVX&#8217;s printing support is missing: repair DVX with Setup.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-programs-basic-long"><a class="anchor" href="#trouble-programs-basic-long"></a>11.14.4. Code that ran too long</h4>
<div class="paragraph">
<p>Error 18, &#8220;The code ran too long without returning and was stopped&#8221;, and error 5, &#8220;A control&#8217;s code cannot wait (SLEEP, FRAMEWAIT, or SHELL)&#8221;, come from controls written in DVX BASIC that do something they may not. Both are mistakes in the program or the control: report them to its author.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-programs-basic-errors"><a class="anchor" href="#trouble-programs-basic-errors"></a>11.14.5. Error numbers</h4>
<div class="paragraph">
<p><a id="_ix1928" class="ixterm"></a><a id="_ix1929" class="ixterm"></a>These are the error numbers a DVX BASIC program can stop with, and their usual texts. A program can also give its own text with a number.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 14.2857%;">
<col style="width: 42.8571%;">
<col style="width: 42.8572%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">No.</th>
<th class="tableblock halign-left valign-top">Text</th>
<th class="tableblock halign-left valign-top">What it usually means</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">1</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;NEXT without FOR&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">3</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;RETURN without GOSUB&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">4</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Out of DATA&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">5</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Illegal function call&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A value given to a command is not allowed: a mistake in the program, or in what you typed.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">6</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Overflow&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A number is too big. Also a file larger than 2 GB.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">7</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Out of memory&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Memory ran out. Close programs.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">9</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Subscript out of range&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">10</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;This array is fixed or temporarily locked&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">11</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Division by zero&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program, or in what you typed.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">13</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Type mismatch&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program, or in what you typed.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">14</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Out of string space&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Memory for text ran out. Close programs.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">18</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;User interrupt occurred&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The code was stopped for running too long.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">20</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;RESUME without error&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">26</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;FOR loop nesting too deep&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">28</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Out of stack space&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Too many calls inside calls: a mistake in the program.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">51</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Internal error&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The program&#8217;s file is damaged, or a mistake in DVX BASIC. Reinstall the program.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">52</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Bad file number&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">53</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;File not found&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file is missing (its folder is there).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">54</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Bad file mode&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">57</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Device I/O error&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A disk or printer failed, a disk could not be read, or a disk refused what was being written into a file (it is write-protected).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">58</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;File already exists&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The name is taken.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">59</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Bad record length&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program or its data.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">61</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Disk full&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The disk filled up while a file was being written, and the file is cut short. Make room on the disk, or save on another one.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">62</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Input past end of file&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The program read on past the end of a file: a mistake in the program, or a file that is shorter than it should be.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">63</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Bad record number&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program or its data.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">64</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Bad file name&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program, or a file name that is too long or not allowed.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">67</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Too many files&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Too many files are open at once.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">68</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Device unavailable&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A printer, port, or sound device is not there or cannot be opened.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">70</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Permission denied&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Another program is using the file.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">71</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Disk not ready&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The drive has no disk in it, such as an empty floppy or CD-ROM drive. Put the disk in, or use another drive.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">74</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Can&#8217;t rename with different drive&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A file cannot be renamed onto another drive. Copy it there, then delete the old one.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">75</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Path/File access error&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A file or folder cannot be made, removed, renamed, or written: the file is read-only, the name is a folder&#8217;s, the disk cannot be written (a CD-ROM or a write-protected floppy), or its main folder is full.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">76</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Path not found&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The folder (or the drive) does not exist.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">91</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Object variable not set&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">92</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;For loop not initialized&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">93</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Invalid pattern string&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program, or in a pattern you typed.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">94</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Invalid use of Null&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program, or empty data.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">424</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Object required&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">438</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Object doesn&#8217;t support this property or method&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">446</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Object doesn&#8217;t support named arguments&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">448</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Named argument not found&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">449</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Argument not optional&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">450</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Wrong number of arguments or invalid property assignment&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">451</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Object not a collection&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">453</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;External function not found: <em>name</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A part of DVX or an add-on is missing (see <a href="#trouble-programs-basic-missing">Section 11.14.3</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">457</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;This key is already associated with an element of this collection&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">481</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Invalid picture&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file is not a picture DVX can read.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Others</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;User-defined error&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Any other number, often one the program gave itself. Ask its author.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>Some errors use a more exact text:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>75: &#8220;Path/File access error&#8221; (a folder could not be made or removed, or a file could not be opened, deleted, or copied over), &#8220;Cannot write INI file&#8221; (a settings file could not be saved), and &#8220;Cannot create the printer spool file&#8221; (see <a href="#trouble-files-temp">Section 11.12.8</a>).</p>
</li>
<li>
<p>76: &#8220;Path not found&#8221; (changing to a folder that does not exist, or a file in one).</p>
</li>
<li>
<p>57: &#8220;Device I/O error&#8221; (writing a file failed for a reason other than a full disk, a disk could not be read or written, or the printer output failed).</p>
</li>
<li>
<p>68: &#8220;Device unavailable&#8221; (for example a printer port that cannot be opened).</p>
</li>
<li>
<p>67: &#8220;Too many files open&#8221;.</p>
</li>
<li>
<p>52: &#8220;Bad file number or file not open&#8221; and &#8220;Bad file channel number&#8221;.</p>
</li>
<li>
<p>7: &#8220;Out of memory allocating array&#8221;, &#8220;Out of memory allocating TYPE&#8221;, and &#8220;Out of memory&#8221;.</p>
</li>
<li>
<p>5: &#8220;Illegal function call (a mistake in the PLAY string)&#8221; and &#8220;Too many arguments in external call&#8221;, among others.</p>
</li>
<li>
<p>1, 9, 13, 51, 59, and 63: other mistakes in the program, such as &#8220;Invalid field index&#8221;, &#8220;Not a TYPE instance&#8221;, &#8220;NEXT variable mismatch&#8221;, &#8220;Record longer than LEN&#8221;, and &#8220;Bad record number&#8221;.</p>
</li>
</ul>
</div>
</div>
<div class="sect3">
<h4 id="trouble-programs-basic-forms"><a class="anchor" href="#trouble-programs-basic-forms"></a>11.14.6. Form and control errors you can act on</h4>
<div class="paragraph">
<p>Most form and control errors are mistakes in the program, which only its author can fix. These you can do something about:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Summary and details</th>
<th class="tableblock halign-left valign-top">What to do</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Out of memory&#8221; with &#8220;There is not enough memory for the picture.&#8221;, &#8220;&#8230;&#8203; for the Printer.&#8221;, &#8220;&#8230;&#8203; for the Printer&#8217;s page.&#8221;, &#8220;&#8230;&#8203; for the font <em>name</em>.&#8221;, &#8220;&#8230;&#8203; for the font.&#8221;, &#8220;Could not allocate <em>n</em> form-level variables.&#8221;, or &#8220;Out of memory marshalling arguments for external function '<em>name</em>'.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Close programs, or use fewer colors or a smaller screen mode.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Icon not loaded&#8221; or &#8220;Picture not loaded&#8221; with &#8220;&#8230;&#8203; There is not enough memory for the picture.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Close programs.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Icon not loaded&#8221; with &#8220;Icon takes a picture file DVX can read (.bmp, .png, .gif &#8230;&#8203;).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The program&#8217;s icon file is missing or damaged. Reinstall the program.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The printer prints text only&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Choose your printer&#8217;s model on Control Panel&#8217;s Printer page (see <a href="#trouble-printing-pictures">Section 11.8.4</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Printing is not installed&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Repair DVX with Setup.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Screenshot not saved&#8221; with &#8220;SaveScreenshot needs a form with a window and a file it can write (BMP when the name ends in .bmp, PNG otherwise).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Often a read-only or full disk.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>Other summaries mean a mistake in the program (or in a control it uses). Report them to its author with the log file: &#8220;Bad control&#8221;, &#8220;UserControl has no such method&#8221;, &#8220;UserControl has no such property&#8221;, &#8220;UserControl property cannot be set&#8221;, &#8220;Control cannot be registered&#8221;, &#8220;No such control&#8221;, &#8220;Cannot move the control&#8221;, &#8220;Illegal function call&#8221;, &#8220;No drawing area&#8221;, &#8220;PaintPicture needs a picture, x, and y&#8221;, &#8220;PaintPicture has no picture&#8221;, &#8220;Invalid property value&#8221;, &#8220;Printer has no such property&#8221;, &#8220;Printer has no such method&#8221;, &#8220;Property is read-only&#8221;, &#8220;Picture has no methods&#8221;, &#8220;Method call on unknown control&#8221;, &#8220;Method call on control with no widget&#8221;, &#8220;CreateControl: not a loaded form&#8221;, &#8220;CreateControl: unknown control type&#8221;, &#8220;CreateControl: invalid parent&#8221;, &#8220;CreateControl: form has no parent widget&#8221;, &#8220;CreateControl: widget creation failed&#8221;, &#8220;Read of unknown control&#8221;, &#8220;Unknown menu property&#8221;, &#8220;Property read on control with no widget&#8221;, &#8220;Property not found on control&#8221;, &#8220;Hide on unknown form&#8221;, &#8220;Hide on form with no window&#8221;, &#8220;Unknown shortcut key&#8221;, &#8220;Show on unknown form&#8221;, &#8220;Show on form with no window&#8221;, &#8220;ScrollToControl needs a control inside a ScrollPane&#8221;, &#8220;Invalid Drag action&#8221;, &#8220;Menu name already used&#8221;, &#8220;Not a menu of the menu bar&#8221;, &#8220;A submenu cannot be removed&#8221;, &#8220;Method not found on control&#8221;, &#8220;Too many arguments&#8221;, &#8220;Clipboard method not supported&#8221;, &#8220;Form property not available&#8221;, &#8220;Object has no default property&#8221;, &#8220;Unknown widget type in form&#8221;, &#8220;Bad property value in form&#8221;, &#8220;Unknown form property&#8221;, &#8220;A submenu cannot be hidden&#8221;, &#8220;Unknown Picture property&#8221;, &#8220;Picture from LoadPictureData not shown&#8221;, &#8220;Unknown Screen method&#8221;, &#8220;Invalid Arrange value&#8221;, &#8220;Unknown Screen property&#8221;, &#8220;Screen property cannot be set&#8221;, &#8220;Bad enum value for property&#8221;, &#8220;Invalid MousePointer&#8221;, &#8220;Clipboard has no properties&#8221;, &#8220;Picture properties are read-only&#8221;, &#8220;Assignment to unknown control&#8221;, &#8220;Property set on control with no widget&#8221;, and &#8220;Invalid WindowState&#8221;.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="trouble-settings"><a class="anchor" href="#trouble-settings"></a>11.15. Going back to the default settings</h3>
<div class="paragraph">
<p><a id="_ix1930" class="ixterm"></a><a id="_ix1931" class="ixterm"></a><a id="_ix1932" class="ixterm"></a><a id="_ix1933" class="ixterm"></a>All your settings are kept in your USER folder (<code>USER</code> in the DVX folder, or the folder <code>DVXUSER</code> names; see <a href="#trouble-files-dvxuser">Section 11.12.7</a>). The settings DVX came with are in the <code>SYSTEM</code> folder and are never changed. So you can always go back to them by deleting a file from the USER folder. Find the kind of setting in this table:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 28.5714%;">
<col style="width: 28.5714%;">
<col style="width: 42.8572%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">To go back to the defaults for</th>
<th class="tableblock halign-left valign-top">Delete, in the USER folder</th>
<th class="tableblock halign-left valign-top">What happens</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">All of DVX&#8217;s settings: the screen mode, mouse, colors, wallpaper, screen saver, network, printer, sound, desktop sounds, game controllers, and package server</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>DVX.INI</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">At the next start, DVX copies the <code>DVX.INI</code> it came with into the USER folder. The screen mode goes back to 1024x768 with 65 thousand colors (which may bring the <strong>Safe Video Mode</strong> question), and the Welcome window shows again.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">One setting in <code>DVX.INI</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">That setting&#8217;s line in <code>DVX.INI</code> (edit it with a text editor)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The setting goes back to DVX&#8217;s built-in default.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Which program opens each kind of file</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>ASSOC.INI</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">It holds only your changes to the file types; without it, every file type goes back to DVX&#8217;s defaults.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Program Manager&#8217;s groups, items, and options</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>APPS\KPUNCH\PROGMAN\PROGMAN.INI</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The default, empty Main and Startup groups come back. The programs themselves stay installed.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Any one program&#8217;s settings</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">That program&#8217;s folder, <code>APPS\<em>maker</em>\<em>program</em></code> (for example <code>APPS\KPUNCH\TERMINAL</code> for Terminal)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The program starts with its defaults. Files it saved in that folder are lost too, so look before you delete.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Program Manager&#8217;s remembered names and icons</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>PROGRAMS.CAC</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Harmless: DVX makes it again. Do this when a program shows an old name or icon after it was changed.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">The secure link&#8217;s random seed</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>SECLINK.RND</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX writes a new one when it exits.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">The publishers you trust</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Their <code>.KEY</code> files in <code>KEYS</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Packages they signed are no longer trusted. Do not delete your own <code>.SEC</code> files (see <a href="#trouble-addons-keys">Section 11.11.18</a>).</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>To delete <code>DVX.INI</code>:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Exit DVX.</p>
</li>
<li>
<p>At the DOS prompt, keep a copy, in case you want a setting from it later: <code>COPY C:\DVX\USER\DVX.INI C:\DVX\USER\DVX.OLD</code> (use your DVX folder in place of <code>C:\DVX</code>).</p>
</li>
<li>
<p>Delete it: <code>DEL C:\DVX\USER\DVX.INI</code>.</p>
</li>
<li>
<p>Start DVX. If the <strong>Safe Video Mode</strong> question appears, answer <b class="button">Yes</b>, then choose your screen mode in Control Panel (see <a href="#trouble-video-choose">Section 11.3.3</a>).</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>Some things to know:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><a id="_ix1934" class="ixterm"></a>A <code>DVX.INI</code> that exists but cannot be read is never overwritten, so changes to your settings are not saved while it is there. If settings you change do not last, delete the file as above.</p>
</li>
<li>
<p>You may see <code>DVX.$IN</code> or <code>DVX.~IN</code> beside <code>DVX.INI</code>. They are copies DVX makes while it saves the file. If a save was interrupted (for example by a power cut) and <code>DVX.INI</code> is missing, rename <code>DVX.~IN</code> to <code>DVX.INI</code> before you start DVX, or DVX starts with the settings it came with.</p>
</li>
<li>
<p><a id="_ix1935" class="ixterm"></a>The Welcome window is started by the <code>welcome</code> line in the <code>[shell]</code> section of <code>DVX.INI</code>. Ticking <strong>Don&#8217;t show this again</strong> removes the line. To have it at every start again, add the line <code>welcome = apps/kpunch/welcome/welcome.app</code> to the <code>[shell]</code> section.</p>
</li>
<li>
<p><code>DVX.INI</code> is described in full in <a href="#folders-dvx-ini">Section B.2</a>. Each section of this chapter lists the keys for its subject: <code>[video]</code> in <a href="#trouble-video-ini">Section 11.3.4</a>, <code>[mouse]</code> in <a href="#trouble-mouse-control">Section 11.4.3</a>, <code>[audio]</code> in <a href="#trouble-sound-ini">Section 11.7.18</a>, <code>[printer]</code> in <a href="#trouble-printing-ini">Section 11.8.9</a>, <code>[network]</code> in <a href="#trouble-network-ini">Section 11.9.11</a>, and <code>[packages]</code> in <a href="#trouble-addons-server-window">Section 11.11.17</a>.</p>
</li>
<li>
<p><a id="_ix1936" class="ixterm"></a>The USER folder is the one folder to back up. An upgrade never changes it.</p>
</li>
</ul>
</div>
</div>
<div class="sect2">
<h3 id="trouble-log"><a class="anchor" href="#trouble-log"></a>11.16. The log file</h3>
<div class="paragraph">
<p><a id="_ix1937" class="ixterm"></a><a id="_ix1938" class="ixterm"></a><a id="_ix1939" class="ixterm"></a>DVX writes a record of what it does, and of what goes wrong, to the file <code>DVX.LOG</code> in your USER folder. It is plain text, one line for each thing. When something fails without a message, or you want to report a problem, the log file is where to look. See also <a href="#folders-log">Section B.6</a>.</p>
</div>
<div class="sect3">
<h4 id="trouble-log-where"><a class="anchor" href="#trouble-log-where"></a>11.16.1. Where it is</h4>
<div class="paragraph">
<p><a id="_ix1940" class="ixterm"></a>The log file is in the USER folder:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>Usually <code>C:\DVX\USER\DVX.LOG</code> (in the folder you installed DVX in).</p>
</li>
<li>
<p>In the folder <code>DVXUSER</code> names, when that is set.</p>
</li>
<li>
<p>In <code>DVXUSER\DVX.LOG</code> inside the TEMP folder, when DVX runs from a disk it cannot write to.</p>
</li>
<li>
<p>Nowhere, when DVX runs from a disk it cannot write to and there is no TEMP folder. DVX then keeps the latest part of the log in memory, until it exits.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p><a id="_ix1941" class="ixterm"></a><a id="_ix1942" class="ixterm"></a>System Information (<span class="menuseq"><b class="menu">Help</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">System Information&#8230;&#8203;</b></span> in Program Manager) says where the log file is, on its last lines, under <code>=== Log ===</code>: &#8220;Log file:&#8221; and the file&#8217;s full name. When there is no log file, it shows the latest lines of the log that DVX keeps in memory there instead, after the line &#8220;DVX cannot write its log to a disk, so it keeps the latest lines here:&#8221;. Scroll to the end of the window to read them.</p>
</div>
</div>
<div class="sect3">
<h4 id="trouble-log-keep"><a class="anchor" href="#trouble-log-keep"></a>11.16.2. Keep it before you start DVX again</h4>
<div class="paragraph">
<p><a id="_ix1943" class="ixterm"></a>IMPORTANT: DVX empties the log file each time it starts. After a problem, copy the log file before you start DVX again, or its record of the problem is lost.</p>
</div>
<div class="paragraph">
<p><a id="_ix1944" class="ixterm"></a>The log file never grows past 512 KB: when it does, DVX removes its oldest lines, keeping the newest 256 KB at most, and the file then begins with the line &#8220;Log: older lines were removed when the log passed 524288 bytes&#8221;.</p>
</div>
<div class="paragraph">
<p>To copy it and read it:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Exit DVX (or restart the computer, if it is stuck).</p>
</li>
<li>
<p>At the DOS prompt, copy the log to another name, for example <code>COPY C:\DVX\USER\DVX.LOG C:\DVXLOG.TXT</code>.</p>
</li>
<li>
<p>Read the copy with a text editor, for example <code>EDIT C:\DVXLOG.TXT</code>, or later in Notepad.</p>
</li>
</ol>
</div>
</div>
<div class="sect3">
<h4 id="trouble-log-read"><a class="anchor" href="#trouble-log-read"></a>11.16.3. What to look for</h4>
<div class="paragraph">
<p><a id="_ix1945" class="ixterm"></a>Most lines are normal. These are the ones that tell you what happened:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Line</th>
<th class="tableblock halign-left valign-top">What it tells you</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>DVX Loader starting...</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The first line: DVX started.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Loader: user folder <em>folder</em></code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Which USER folder DVX uses. Other <code>Loader:</code> lines here say when DVX&#8217;s disk, or the folder <code>DVXUSER</code> names, cannot be written to.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Lines containing <code>FAILED:</code>, <code>dlopen:</code>, or <code>ABI:</code>, and lines starting <code>FATAL:</code> or <code>ERROR:</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A file of DVX&#8217;s, or of an add-on, could not be loaded (see <a href="#trouble-start-damaged">Section 11.2.4</a> and <a href="#trouble-start-addons">Section 11.2.9</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Safe start: not loading <em>file</em></code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">An add-on file left out by a safe start.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Lines starting <code>helpRecompile:</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX rebuilding its help files; <code>helpRecompile: FAILED</code> means one did not rebuild.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Preferences: video <em>width</em>x<em>height</em> <em>bits</em>bpp</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The screen mode DVX was set to use.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Lines starting <code>VBE:</code> or <code>Video:</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The video card and the screen mode (see <a href="#trouble-start-vesa">Section 11.2.2</a>). <code>Available video modes:</code> lists every mode DVX found, and <code>Selected:</code> the one it chose.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>=== System Information ===</code> to <code>=== End System Information ===</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The same as System Information: processor, memory, DOS version, TEMP folder, video card, mouse, and drives.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Lines starting <code>Preferences:</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The settings DVX applied. <code>Preferences: failed to load the wallpaper</code> means the desktop picture is missing or cannot be read; the desktop shows its plain color instead.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Lines starting <code>Drivers:</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Sound, network, and other hardware drivers: <code>Drivers: <em>file</em> did not load: <em>reason</em></code>, <code>Drivers: <em>file</em> is not a driver for this version of DVX</code>, and <code>Drivers: another driver named '<em>name</em>' in <em>folder</em> is not used</code>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Lines starting <code>Audio:</code>, <code>Music:</code>, <code>Print:</code>, <code>Joystick:</code>, <code>dvxnet:</code>, <code>Terminal:</code>, <code>Fonts:</code>, or <code>Software:</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">What happened with sound, music, printing, joysticks, the network, Terminal, fonts, and add-ons (see those sections of this chapter).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>DVX Shell ready.</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The desktop came up.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Shell: DVX crashed while starting; stopping</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX itself failed before the desktop was up (see <a href="#trouble-start-crash">Section 11.2.7</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>=== CRASH ===</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A program (or DVX) crashed. The lines after it name the program and give details for its author.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>BASIC RUNTIME ERROR:</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A DVX BASIC program stopped with an error; the details follow.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>DVX Shell shutting down...</code> and <code>DVX Shell exited.</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A normal exit. A log that ends before <code>DVX Shell exited.</code> means DVX stopped abnormally.</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect3">
<h4 id="trouble-log-report"><a class="anchor" href="#trouble-log-report"></a>11.16.4. Sending it with a problem report</h4>
<div class="paragraph">
<p><a id="_ix1946" class="ixterm"></a><a id="_ix1947" class="ixterm"></a><a id="_ix1948" class="ixterm"></a>When you report a problem with DVX or with a program to its author:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Copy the log file right after the problem, before you start DVX again (see <a href="#trouble-log-keep">Section 11.16.2</a>).</p>
</li>
<li>
<p>Write down the exact words of any message, including its title.</p>
</li>
<li>
<p>Say what you were doing when it happened, and whether it happens every time.</p>
</li>
<li>
<p>Send the copy of the log file with your report. Its System Information section describes your computer, and after a crash its <code>=== CRASH ===</code> section gives the details the author needs.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>For a problem with Setup, start Setup with <code>SETUP /LOG=C:\SETUP.LOG</code> and send that file too (see <a href="#trouble-addons-setup-log">Section 11.11.9</a>).</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="trouble-messages"><a class="anchor" href="#trouble-messages"></a>11.17. Messages, A to Z</h3>
<div class="paragraph">
<p><a id="_ix1949" class="ixterm"></a><a id="_ix1950" class="ixterm"></a>This list gives every message explained in this chapter, in alphabetical order, with what it means and the section that explains it. A message that begins with a part that changes, such as a file name, is listed under the words that follow that part: &#8220;<em>name</em> is already running.&#8221; is under I. Lines that DVX writes only to its log file are explained in <a href="#trouble-log">Section 11.16</a> and in the section for each subject.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 45.4545%;">
<col style="width: 36.3636%;">
<col style="width: 18.1819%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Message</th>
<th class="tableblock halign-left valign-top">What it means</th>
<th class="tableblock halign-left valign-top">See</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;80386 required.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The processor is far too old for DVX.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-start-memory">Section 11.2.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;A control&#8217;s code cannot wait (SLEEP, FRAMEWAIT, or SHELL)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in a control. Report it to the author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-long">Section 11.14.4</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;A file larger than 2 GB cannot be transferred&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Terminal cannot transfer files larger than 2 GB.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-transfers">Section 11.10.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;A file or folder with that name already exists.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The name is taken.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-filemgr">Section 11.12.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;A file transfer is running. Cancel it and close?&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Closing Terminal would cancel a transfer.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-terminal">Section 11.10.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;A group needs a name no other group has.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The group name is taken.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-progman">Section 11.13.8</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;A name server is not a valid address (like 192.168.1.1)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A name server is not given as four numbers.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-settings">Section 11.9.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;A new document would be created here.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A DVX Demo example, not an error.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-programs">Section 11.12.12</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;A newer version of <em>name</em> (<em>version</em>) is installed.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A newer version is installed already.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-refused">Section 11.11.13</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;A program is using a game controller. Close it, then click Detect again.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Close the program using the joystick, then click Detect.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-joystick">Section 11.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;A secure link over a COM port cannot use XON/XOFF flow control. Choose None or RTS/CTS.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The secure link cannot use XON/XOFF over a COM port.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-terminal">Section 11.10.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;a setting is not supported&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The reason a COM port could not be opened: a setting cannot be used.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-port">Section 11.10.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;A shortcut key is Ctrl with Alt or Shift, and a letter, a digit, F1 to F12, or one of Backspace, Del, Down, End, Enter, Esc, Home, Ins, Left, PgDn, PgUp, Right, Space, Tab, and Up, for example Ctrl+Alt+P.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The shortcut key typed is not allowed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-progman">Section 11.13.8</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;A statement is still running on this database&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A database message from a program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-databases">Section 11.12.15</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;A submenu cannot be hidden&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;A submenu cannot be removed&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Abort, Retry, Fail?&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DOS&#8217;s own question; DVX never stops at it.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-readonly">Section 11.12.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Access denied (the file may be read-only or in use, the disk write-protected or not ready).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file is read-only or in use, or the disk cannot be written to.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-filemgr">Section 11.12.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Add another file to send in the same batch?&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">YMODEM and ZMODEM can send several files.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-terminal">Section 11.10.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Already connected&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A network message shown by a DVX BASIC program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-basic">Section 11.9.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em> already exists (<em>size</em> bytes). What should happen to it?&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A file being received is already there.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-transfers">Section 11.10.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em> already exists. Do you want to replace it?&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Saving would replace a file.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-dialogs">Section 11.12.1</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em> already exists. Replace it with <em>file</em>?&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A file of that name is already there.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-filemgr">Section 11.12.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;An extension is one to eight letters or digits, such as TXT.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Type the extension without the dot.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-start">Section 11.13.1</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> and <em>package</em> both have the file <em>file</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Two packages would own the same file.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-refused">Section 11.11.13</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> and <em>package</em> need each other.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The packages are badly made.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-refused">Section 11.11.13</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Are you sure you want to exit DVX?&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX asks before exiting.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-exit">Section 11.13.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Argument list too long (E2BIG)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The DOS program&#8217;s arguments are too long.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-dos">Section 11.13.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Argument not optional&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 449. A mistake in the program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Assignment to unknown control&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;attempt to write a readonly database&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The database is on a disk that cannot be written to.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-databases">Section 11.12.15</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Bad connection settings&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A network message shown by a DVX BASIC program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-basic">Section 11.9.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Bad control&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Bad enum value for property&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Bad file channel number&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 52. A mistake in the program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Bad file mode&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 54. A mistake in the program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Bad file name&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 64. A mistake in the program, or a file name that is not allowed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Bad file number&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 52. A mistake in the program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Bad file number or file not open&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 52. A mistake in the program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Bad property value in form&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Bad record length&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 59. A mistake in the program or its data.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Bad record number&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 63. A mistake in the program or its data.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Bad transfer parameters&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A program started a transfer wrongly.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-transfers">Section 11.10.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cancelled&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The transfer was cancelled.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-transfers">Section 11.10.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cancelled by the receiver&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The other side cancelled the transfer.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-transfers">Section 11.10.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cancelled by the sender&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The other side cancelled the transfer.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-transfers">Section 11.10.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Can&#8217;t rename with different drive&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 74. A file cannot be renamed onto another drive.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot add <em>file</em> to <em>package</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A file could not be added to the package.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-builder">Section 11.11.20</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>keys</em> cannot be a shortcut key: it <em>does</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX itself uses those keys. Choose others.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-progman">Section 11.13.8</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>folder</em> cannot be copied into itself.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A folder cannot go inside itself.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-filemgr">Section 11.12.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em> cannot be copied onto itself.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file is already in that folder.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-filemgr">Section 11.12.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em> cannot be found, or the destination path would be too long. It is skipped.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">One item is skipped.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-filemgr">Section 11.12.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em> cannot be installed: <em>reason</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Software cannot read the package file.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-read">Section 11.11.11</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> cannot be installed. <em>reason</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Software will not install the package; the reason says why.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-refused">Section 11.11.13</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em> cannot be installed: another job is running.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Wait for the job under way to finish.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-read">Section 11.11.11</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> cannot be installed now.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Another job started meanwhile. Try again.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-refused">Section 11.11.13</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> cannot be installed: the package server has no signature of it by DVX&#8217;s key.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The server has no signature of the package by DVX&#8217;s key.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> cannot be installed: what was fetched cannot be read.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The download cannot be read. Try again.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>folder</em> cannot be moved into itself.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A folder cannot go inside itself.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-filemgr">Section 11.12.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em> cannot be published: <em>reason</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package file cannot be read.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-publish">Section 11.11.19</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>host</em> cannot be reached: check the network settings&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX has no way to the computer.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-reach">Section 11.9.9</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em> cannot be read.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A file cannot be read.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-builder">Section 11.11.20</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> cannot be removed now.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Another job is running. Try again.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-remove">Section 11.11.15</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> cannot be saved in <em>folder</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The download could not be kept: the disk is full or cannot be written to.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em> cannot be written.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A file cannot be written.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-builder">Section 11.11.20</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot connect to <em>host</em>: the server refused the connection.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The connection to the package server failed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot copy the key to <em>folder</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The USER folder cannot be written to.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-keys">Section 11.11.18</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot create <em>file</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A file cannot be made: the disk is full or cannot be written to.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-builder">Section 11.11.20</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot create <em>folder</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A new folder cannot be made; the reason follows.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-filemgr">Section 11.12.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot create folder <em>folder</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A folder cannot be made; the reason follows.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-filemgr">Section 11.12.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot create the file&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A received file cannot be made.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-transfers">Section 11.10.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot create the file <em>file</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file to print into cannot be made.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-start">Section 11.8.3</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot create the file USER\PRINTER.PRN.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Nothing can be saved (a read-only disk and no TEMP folder); print to a file on another disk.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-file">Section 11.8.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot create the printer spool file&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No scratch file could be made for printing. Check TEMP.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-temp">Section 11.12.8</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot delete <em>file</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A file cannot be deleted; the reason follows.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-filemgr">Section 11.12.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot find <em>path</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The program or document does not exist.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-start">Section 11.13.1</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot find <em>host</em> on the network.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package server&#8217;s name could not be found.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot make the folder <em>folder</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The disk is full or cannot be written to.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-stopped">Section 11.11.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot move <em>file</em> aside.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A file could not be replaced.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-stopped">Section 11.11.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot move the control&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot open <em>file</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A file to send cannot be opened.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-transfers">Section 11.10.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot open <em>folder</em>. The folder does not exist or the drive is not ready.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The folder or drive cannot be opened.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-filemgr">Section 11.12.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot put <em>file</em> in place.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A file could not be replaced.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-stopped">Section 11.11.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot read <em>file</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A file cannot be read: missing, damaged, or not a package.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-read">Section 11.11.11</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot read the file&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A file being sent cannot be read.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-transfers">Section 11.10.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot read the folder <em>folder</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A folder of the package cannot be read.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-builder">Section 11.11.20</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot read the picture <em>file</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The picture to print cannot be read.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-start">Section 11.8.3</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot remove <em>file</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package&#8217;s record could not be removed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-stopped">Section 11.11.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot rename <em>file</em> to <em>name</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The item cannot be renamed; the reason follows.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-filemgr">Section 11.12.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot replace <em>file</em>: a folder with that name exists.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A folder has the name the file would get.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-filemgr">Section 11.12.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot send to <em>host</em>: <em>reason</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The connection broke. Try again.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot write <em>file</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The disk is full or cannot be written to.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-stopped">Section 11.11.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot write INI file&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A program&#8217;s settings file cannot be saved.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot write <em>file</em> (is the disk full?).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The disk is full or cannot be written to.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-stopped">Section 11.11.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Cannot write the file&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Writing a received file failed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-transfers">Section 11.10.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Carrier lost: the call ended&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The call dropped.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-modem">Section 11.10.4</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Characters per line must be from 20 to 255.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Page Setup cannot use the number of characters.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-dialog">Section 11.8.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Choose a package in the list first.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No package is selected.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Clipboard has no properties&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Clipboard method not supported&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Close this window?&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The DVX Demo asks before closing.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-programs">Section 11.12.12</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>host</em> closed the connection&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The other computer ended the session.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-reach">Section 11.9.9</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>host</em> closed the connection before the whole reply came.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The connection broke. Try again.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>host</em> closed the connection without answering.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The connection broke. Try again.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;COM<em>n</em> could not be opened: <em>reason</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The serial port cannot be used; the reason says why.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-port">Section 11.10.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;COM<em>n</em> could not be opened for the secure link&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The serial port cannot be used for the secure link.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-port">Section 11.10.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;COM<em>n</em> stopped working&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The port stopped delivering data. Connect again.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-port">Section 11.10.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Compile failed!&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The help file has mistakes.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-programs">Section 11.12.12</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Compiled: <em>file</em>.hlp&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Normal: the help file was made.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-programs">Section 11.12.12</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Compiling&#8230;&#8203;&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Normal: the help file is being made.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-programs">Section 11.12.12</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Connected&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The network is ready.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-status">Section 11.9.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Connected (<em>modem&#8217;s message</em>)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Normal: the call connected.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-modem">Section 11.10.4</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Connected to COM<em>n</em> at <em>speed</em> bps&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Normal: the serial port is open.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-port">Section 11.10.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Connected to <em>host</em> port <em>port</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Normal: Terminal is connected.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-reach">Section 11.9.9</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Connecting to <em>host</em> port <em>port</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Normal: Terminal is connecting.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-reach">Section 11.9.9</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Connecting to <em>host</em> port <em>port</em> for the secure link&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Normal: the secure link is connecting.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-secure">Section 11.10.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Control cannot be registered&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Could not allocate <em>n</em> form-level variables.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Memory ran out. Close programs.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> could not be installed: <em>reason</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Setup could not install an add-on.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-parts">Section 11.11.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em> could not be opened.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The program for that kind of file cannot be started.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-filemgr">Section 11.12.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> could not be removed: <em>reason</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Setup could not remove an add-on or part.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-parts">Section 11.11.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Could not load <em>file</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The picture cannot be read.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-programs">Section 11.12.12</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Could not load wallpaper image.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The desktop picture is not a picture DVX can read, or memory is short.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-video-desktop">Section 11.3.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Could not make the backup copy <em>file</em>, so <em>file</em> was not changed.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">AUTOEXEC.BAT could not be backed up, so it was not changed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-after">Section 11.11.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Could not open <em>file</em> (error <em>n</em>).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file cannot be opened.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-notepad">Section 11.12.11</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Could not open help file.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The help file is missing or damaged.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-help">Section 11.12.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Could not prepare the icon for printing.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The Icon Editor&#8217;s scratch file cannot be written.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-programs">Section 11.8.8</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Could not save <em>file</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The Icon Editor cannot write the file.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-programs">Section 11.12.12</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Could not save <em>file</em> (error <em>n</em>).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file cannot be written.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-notepad">Section 11.12.11</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Could not save <em>file</em> (error 75).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file is read-only, or the disk cannot be written.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-readonly">Section 11.12.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Could not save the theme file.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The theme could not be written into your THEMES folder.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-video-desktop">Section 11.3.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Could not write <em>file</em> (is the disk full or write-protected?).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">AUTOEXEC.BAT could not be written.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-after">Section 11.11.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Could not write to the file <em>file</em>. The disk may be full. Make room, then choose Retry.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Printing to a file: the disk is full.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-retry">Section 11.8.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;CreateControl: form has no parent widget&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;CreateControl: invalid parent&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;CreateControl: not a loaded form&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;CreateControl: unknown control type&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;CreateControl: widget creation failed&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;database is locked&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Another program is using the database.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-databases">Section 11.12.15</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Delete <em>file</em>?&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">File Manager asks before deleting.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-filemgr">Section 11.12.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Delete "<em>item</em>" from the group "<em>group</em>"? The program itself is not removed.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Program Manager asks before deleting an icon.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-progman">Section 11.13.8</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Delete "<em>name</em>" from the phone book?&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Terminal asks before deleting a session.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-terminal">Section 11.10.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Delete the group "<em>group</em>" and its <em>n</em> item(s)? The programs themselves are not removed.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Program Manager asks before deleting a group.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-progman">Section 11.13.8</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Delete these <em>n</em> items?&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">File Manager asks before deleting.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-filemgr">Section 11.12.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Device I/O error&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 57. A disk or printer failed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Device unavailable&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A printer, port, or sound device is not there or cannot be opened.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Dialing <em>number</em> (try <em>n</em> of <em>n</em>)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Normal: Terminal is dialing.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-modem">Section 11.10.4</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>host</em> did not answer&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No answer within 30 seconds.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-reach">Section 11.9.9</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>host</em> did not answer in HTTP.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The address or port is not a package server.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>host</em> did not answer in time (<em>n</em> seconds).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The server did not answer within 30 seconds.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Disconnected&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Normal: the connection was closed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-reach">Section 11.9.9</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Disk full&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 61. The disk filled up while a file was being written.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Disk not ready&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 71. The drive has no disk in it.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Division by zero&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 11. A mistake in the program, or in what you typed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em> does not exist. Check the file name and try again.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file typed in an Open dialog does not exist.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-dialogs">Section 11.12.1</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em> does not exist. Do you want to create it?&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file typed in a program&#8217;s Open dialog does not exist; the program can make it.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-dialogs">Section 11.12.1</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>address</em> does not name a computer.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Correct the package server&#8217;s address.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Drive <em>drive</em> is not ready.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The drive has no disk in it.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-dialogs">Section 11.12.1</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;DVX cannot save anything: it cannot write to <em>folder</em>, the folder DVXUSER names, and there is no TEMP folder. Settings you change are kept until you exit DVX. To keep them, set DVXUSER to a folder DVX can write to before starting DVX.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The folder DVXUSER names cannot be written to, and there is no TEMP folder.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-readonly-dvx">Section 11.12.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;DVX cannot save anything: it is running from a disk it cannot write to, such as a CD-ROM, and there is no TEMP folder. Settings you change are kept until you exit DVX. To keep them, set DVXUSER to a folder on your hard disk before starting DVX, or install DVX with SETUP.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX runs from a disk it cannot write to, and there is no TEMP folder.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-readonly-dvx">Section 11.12.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;DVX cannot write to <em>folder</em>, the folder DVXUSER names, so your settings are kept in the TEMP folder. To keep them somewhere else, set DVXUSER to a folder DVX can write to before starting DVX.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX keeps your settings in the TEMP folder.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-readonly-dvx">Section 11.12.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;DVX could not run <em>file</em>. <em>reason</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The DOS program could not be started.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-dos">Section 11.13.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;DVX could not start: the video card offered no usable graphics mode. DVX needs a VESA video BIOS with a mode of at least 640x480 at 256 colors or more. Many older cards need their VESA driver loaded first: UniVBE (Scitech Display Doctor) works with most cards, and some cards came with their own, such as S3VBE20 for S3 cards and M64VBE for ATI Mach64 cards. The details are in DVX.LOG in the USER folder.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX found no screen mode it can use. Load the video card&#8217;s VESA driver.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-start-vesa">Section 11.2.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;DVX is already installed in <em>folder</em>. Upgrade or repair it instead, keeping your settings and saved files?&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Setup offers to upgrade instead.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-folder">Section 11.11.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;DVX is not installed in <em>folder</em> (or it was not installed by this Setup).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Setup has no list of DVX&#8217;s files in that folder.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-remove">Section 11.11.8</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;DVX is not installed in <em>folder</em>. To put DVX there, choose Back, then Install DVX.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">There is no DVX to upgrade in that folder.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-folder">Section 11.11.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;DVX is running from a disk it cannot write to, such as a CD-ROM, so your settings are kept in the TEMP folder. To keep them somewhere else, set DVXUSER to a folder on your hard disk before starting DVX.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX keeps your settings in the TEMP folder.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-readonly-dvx">Section 11.12.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;DVX itself is removed with Setup.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Software cannot remove DVX itself.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-remove">Section 11.11.15</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;DVX itself is updated: the new version runs from the next time DVX starts.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Restart DVX after installing.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-plan">Section 11.11.12</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;DVX needs about <em>n</em> MB of disk space.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Setup shows the space needed as you choose.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-space">Section 11.11.3</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;DVX reaches package servers over plain http only (it has no encryption). Type the address without https://.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">An https:// address was typed for the package server.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;DVX Setup: /FONTS= takes NONE or BASE.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The /FONTS= switch takes NONE or BASE.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-start">Section 11.11.1</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;DVX Setup needs a video card with a VESA video BIOS and a 640x480 mode at 256 colors or more; many older cards need their VESA driver loaded first, such as UniVBE (see README.TXT).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The video card has no usable VESA mode for Setup.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-start">Section 11.11.1</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;DVX Setup: there is no DVX package (or it is damaged) beside <em>file</em>, and DVX is not installed in its folder.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Setup found nothing to install beside it.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-start">Section 11.11.1</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;DVX started in safe video mode (<em>width</em>x<em>height</em>, <em>bits</em>-bit color) as you asked. Use this mode from now on instead of <em>width</em>x<em>height</em>, <em>bits</em>-bit color?&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A safe start uses safe video mode; DVX asks whether to keep it.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-video-safe">Section 11.3.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;DVX stopped while starting: something went wrong inside DVX itself. Start DVX again with a safe start: hold down a Shift key while it starts, or type DVX /SAFE. If DVX still stops, run Setup and choose Upgrade or repair to fix DVX.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX itself failed before the desktop was up.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-start-crash">Section 11.2.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;DVX was installed, but the settings file in <em>folder</em> could not be written.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Setup could not write DVX.INI.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-after">Section 11.11.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;DVX was removed from <em>folder</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Setup removed DVX.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-remove">Section 11.11.8</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;DVX was started in safe mode, so no add-on libraries or widgets were loaded.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A safe start left out the add-ons' libraries and widgets.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-safe-start">Section 11.2.8</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;dvxpkg: <em>name</em> is not installed&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVXPKG cannot remove a package that is not installed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-start-addons">Section 11.2.9</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;dvxpkg: nothing removed: needed by <em>packages</em> (-f removes them too)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVXPKG did not remove a package that others need.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-start-addons">Section 11.2.9</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Enter the host name on the Network page of Session Settings first.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The session has no host name.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-terminal">Section 11.10.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Error: could not allocate page table memory&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Less than 16 KB of conventional memory is free.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-start-memory">Section 11.2.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Error: Using XMS switched CPU into V86 mode.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The memory manager is in AUTO mode. Remove AUTO from its line in CONFIG.SYS.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-start-memory">Section 11.2.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Everything is up to date.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Normal: there are no updates.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Exiting due to signal&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX stopped with a technical report.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-start-crash">Section 11.2.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Extension must be 3 characters or fewer.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The name breaks the file name rules of the disk.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-names">Section 11.12.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;External function not found: <em>name</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A part of DVX or an add-on the program needs is missing.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-missing">Section 11.14.3</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Failed to add resource.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file cannot be changed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-programs">Section 11.12.12</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Failed to change video mode.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The video card could not set the mode chosen in Control Panel.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-video-choose">Section 11.3.3</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Failed to create instance copy of <em>file</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A second copy of a program cannot get its scratch file.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-temp">Section 11.12.8</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Failed to create task for application.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Memory is short. Close programs.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-start">Section 11.13.1</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Failed to extract resource.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The resource cannot be written out.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-programs">Section 11.12.12</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Failed to load <em>file</em>: <em>reason</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A program, or the Program Manager, could not be loaded.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-start">Section 11.13.1</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Failed to remove resource.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file cannot be changed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-programs">Section 11.12.12</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Failed to update resource.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file cannot be changed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-programs">Section 11.12.12</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;FATAL: <em>file</em> could not be loaded: <em>reason</em>. Run Setup and choose Upgrade or repair to fix DVX.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">One of DVX&#8217;s own files is damaged or from another version. Repair DVX with Setup.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-start-damaged">Section 11.2.4</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;File already exists&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 58. The name is taken.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;File not found&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 53. The file is missing.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;File operations are still running. Stop them and close?&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Closing File Manager would stop a copy, move, or delete.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-filemgr">Section 11.12.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Filename contains invalid characters.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The name breaks the file name rules of the disk.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-names">Section 11.12.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Filename may contain only one dot.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The name breaks the file name rules of the disk.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-names">Section 11.12.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Filename must be 1-8 characters before the extension.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The name breaks the file name rules of the disk.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-names">Section 11.12.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Filename must be 255 characters or fewer.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The name breaks the file name rules of the disk.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-names">Section 11.12.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Filename must not be empty.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The name breaks the file name rules of the disk.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-names">Section 11.12.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Filename must not end with a dot or a space.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The name breaks the file name rules of the disk.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-names">Section 11.12.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>n</em> file(s) in <em>folder</em> could not be removed. Close any program using them and choose Remove DVX again.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Some files could not be removed. Choose Remove DVX again.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-remove">Section 11.11.8</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;FOR loop nesting too deep&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 26. A mistake in the program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;&#8230;&#8203; for the font.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Memory ran out. Close programs.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;&#8230;&#8203; for the font <em>name</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Memory ran out. Close programs.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;&#8230;&#8203; for the Printer.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Memory ran out. Close programs.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;&#8230;&#8203; for the Printer&#8217;s page.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Memory ran out. Close programs.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Form property not available&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Game controller support is not installed.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A part of DVX is missing. Repair DVX with Setup.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-joystick">Section 11.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Give the package a name.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Package Builder needs a package name.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-builder">Section 11.11.20</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Give your account on the package server in File &gt; Package Server to see what you have published.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Set your account to see what you published.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-publish">Section 11.11.19</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>address</em> has a port that is not a number from 1 to 65535.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Correct the package server&#8217;s port.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;'<em>name</em>' has caused a fault and will be terminated.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The program crashed and was ended.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-crash">Section 11.13.4</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>folder</em> has no list of installed files (SETUP.LST), so Setup does not know what to remove.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Setup has no list of DVX&#8217;s files in that folder.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-remove">Section 11.11.8</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> has the file <em>file</em>, which belongs to <em>package</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Two packages would own the same file.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-refused">Section 11.11.13</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>other file</em> has the same name&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The reason an add-on was left out: two files have the same name.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-start-addons">Section 11.2.9</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> has too many files.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package is too large to install.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-stopped">Section 11.11.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Hide on form with no window&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Hide on unknown form&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Hung up&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Normal: the modem hung up.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-modem">Section 11.10.4</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Icon not loaded&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The program&#8217;s icon could not be loaded: memory is short, or its icon file is missing or damaged.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Icon takes a picture file DVX can read (.bmp, .png, .gif &#8230;&#8203;).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The program&#8217;s icon file is missing or damaged. Reinstall the program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Icons must be 16 x 16, 24 x 24, or 32 x 32 pixels.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The picture is not an icon size.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-programs">Section 11.12.12</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Illegal function call&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 5. A value given to a command is not allowed: a mistake in the program, or in what you typed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Illegal function call (a mistake in the PLAY string)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 5. A value given to a command is not allowed: a mistake in the program, or in what you typed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Installed: <em>names</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The install worked.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-stopped">Section 11.11.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Installed with it, because it needs them: <em>names</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Packages it needs are installed with it.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-plan">Section 11.11.12</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Installing did not finish. <em>reason</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The install stopped; the reason says why.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-stopped">Section 11.11.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Internal error&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 51. The program&#8217;s file is damaged. Reinstall the program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;interrupted&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A long database search was stopped.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-databases">Section 11.12.15</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Invalid argument&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A program asked for something that cannot be done.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-messages">Section 11.7.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Invalid Arrange value&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Invalid Drag action&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Invalid field index&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Invalid MousePointer&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Invalid pattern string&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 93. A mistake in the program, or in a pattern you typed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Invalid picture&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 481. The file is not a picture DVX can read.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Invalid property value&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Invalid use of Null&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 94. A mistake in the program, or empty data.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Invalid WindowState&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>path</em> is a file, not a folder.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Choose a folder, not a file.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-dialogs">Section 11.12.1</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em> is a folder.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A folder is where the package puts a file.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-stopped">Section 11.11.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> is already running.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The program is open already.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-start">Section 11.13.1</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>keys</em> is already the shortcut for "<em>item</em>".&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Another item has that shortcut.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-progman">Section 11.13.8</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> is from the package server, but it is not signed. DVX installs a package from the package server only when DVX&#8217;s key signed it.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX installs from the package server only what DVX&#8217;s key signed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-refused">Section 11.11.13</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> is from the package server, but it is signed by another key, not by DVX&#8217;s. DVX installs a package from the package server only when DVX&#8217;s key signed it.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX installs from the package server only what DVX&#8217;s key signed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-refused">Section 11.11.13</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> is from the package server, but its signature by DVX&#8217;s key does not fit it: it was changed or damaged on the way.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package was changed after it was signed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-refused">Section 11.11.13</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em> is in the manifest but not in the package.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package is damaged or was changed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-stopped">Section 11.11.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em> is in the package but not in its manifest.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package is damaged or was changed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-stopped">Section 11.11.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em> is in the package twice.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package is damaged or was changed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-stopped">Section 11.11.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> is listed twice.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package was made wrongly. Tell its maker.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-read">Section 11.11.11</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em> is not a DVX package (it does not start with PACKAGE.INI).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file is not a DVX package.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-read">Section 11.11.11</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em> is not a secret key. <em>reason</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file chosen is not a secret key.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-builder">Section 11.11.20</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em> is not a text file, so Notepad did not open it.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file holds NUL characters, which no text has.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-notepad">Section 11.12.11</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em> is not a text file, so the Help Editor did not open it.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file holds NUL characters, which no text has.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-programs">Section 11.12.12</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>text</em> is not a version (such as 1.0.0).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The version is not in the form 1.0.0.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-builder">Section 11.11.20</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>address</em> is not an http:// address.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Correct the package server&#8217;s address.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> is not installed.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package is already gone.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-stopped">Section 11.11.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>package</em> is not offered by the package server.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The server does not have that package.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> is not one of the packages read.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Rare. Try again.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-refused">Section 11.11.13</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;'<em>name</em>' is not responding to the request to close. End it?&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A program did not close before a DOS program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-exit">Section 11.13.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;'<em>name</em>' is not responding to the request to close. End it and continue exiting DVX?&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A program did not close when DVX exited.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-exit">Section 11.13.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> is not signed by the publisher of the installed version.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The update is not from the same publisher.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-refused">Section 11.11.13</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em> is not the file the manifest lists (it was changed or damaged).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package is damaged or was changed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-stopped">Section 11.11.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> <em>version</em> is on the package server, waiting for its review. The Published page shows how the review goes.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package was published and waits for review.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-publish">Section 11.11.19</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em> is read-only. Delete it anyway?&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file is read-only.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-filemgr">Section 11.12.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em> is too big for a package.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A file is too large for a package.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-builder">Section 11.11.20</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em> is too big for Notepad.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Notepad holds files up to 256 KB.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-notepad">Section 11.12.11</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em> is too big for the Help Editor.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The Help Editor holds files up to 256 KB.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-programs">Section 11.12.12</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;it did not respond&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The reason a COM port could not be opened: any other failure.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-port">Section 11.10.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;it is already in use&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The reason a COM port could not be opened: another program has it.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-port">Section 11.10.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em>: it is damaged.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package is damaged.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-stopped">Section 11.11.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;It is not a WAV or MIDI file.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The Sound Recorder opens only WAV and MIDI files.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-recording">Section 11.7.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;it needs <em>name</em>, which is not installed&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The reason a file could not be loaded: a file it needs is missing.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-start-damaged">Section 11.2.4</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;it needs <em>name</em>, which was not loaded&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The reason a file could not be loaded: a file it needs failed too.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-start-damaged">Section 11.2.4</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;it needs files that in turn need it or each other, so none of them can be loaded&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The reason a file could not be loaded: files that each need another first.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-start-damaged">Section 11.2.4</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;It takes <em>n</em> bytes of disk space.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The space the package needs.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-plan">Section 11.11.12</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;it was made for a different version of DVX&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The reason a file could not be loaded: it belongs to another version of DVX.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-start-damaged">Section 11.2.4</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;its file is damaged, or it needs something this DVX does not have&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The reason a file could not be loaded: it is damaged or needs a newer DVX.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-start-damaged">Section 11.2.4</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;its interrupt could not be found&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The reason a COM port could not be opened: its IRQ was not found.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-port">Section 11.10.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Keep this display mode?&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Control Panel asks whether to keep the new screen mode.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-video-choose">Section 11.3.3</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;kept <em>file</em> (changed since it was installed)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVXPKG kept a file you changed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-start-addons">Section 11.2.9</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;left <em>file</em> (it could not be deleted)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVXPKG could not delete a file.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-start-addons">Section 11.2.9</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Libraries and widgets work from the next time DVX starts.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Restart DVX after installing.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-plan">Section 11.11.12</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Line <em>n</em>: <em>name</em> is given twice.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The key file is damaged.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-keys">Section 11.11.18</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Line <em>n</em>: <em>kind</em> is not a kind of package.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package is for a newer DVX.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-read">Section 11.11.11</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Line <em>n</em> is not a [section] or a key = value line.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The key file is damaged.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-keys">Section 11.11.18</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Line <em>n</em>: <em>name</em> must be <em>n</em> hex digits.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The key file is damaged.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-keys">Section 11.11.18</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Lines per page must be 0 (the printer&#8217;s usual length) or from 10 to 200.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Page Setup cannot use the number of lines.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-dialog">Section 11.8.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Load error:&#8221; with &#8220;no DOS memory&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Not enough conventional memory is free to start DVX.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-start-memory">Section 11.2.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Load error:&#8221; with &#8220;no DPMI memory&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Not enough extended memory is free to start DVX.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-start-memory">Section 11.2.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Load error:&#8221; with &#8220;not EXE&#8221; or &#8220;not COFF (Check for viruses)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX.EXE is damaged. Repair DVX with Setup.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-start-memory">Section 11.2.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Lost block sequence&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The two sides lost step during a transfer.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-transfers">Section 11.10.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Lost the connection to <em>host</em>: <em>reason</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The connection broke. Try again.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Margins cannot be negative.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Page Setup cannot use the margins.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-dialog">Section 11.8.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Media Player cannot play <em>file</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file cannot be played; the reason follows.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-player">Section 11.7.17</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Media Player cannot play <em>file</em>, <em>file</em>, and <em>n</em> other tracks.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Several tracks in a row cannot be played; the reasons follow.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-player">Section 11.7.17</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Menu name already used&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Method call on control with no widget&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Method call on unknown control&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Method not found on control&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em>: missing appDescriptor&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file is not a DVX program, or it is damaged.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-start">Section 11.13.1</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em>: missing appMain&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file is not a DVX program, or it is damaged.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-start">Section 11.13.1</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Modem ready on COM<em>n</em>: type AT commands&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Normal: type commands to the modem.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-modem">Section 11.10.4</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;MODULE resource failed to deserialize.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The program is for another version of DVX, or damaged.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-start">Section 11.14.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;MODULE resource not found.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The program&#8217;s file is damaged. Reinstall it.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-start">Section 11.14.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Move the stick further, all the way to each edge.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Calibration needs the stick moved to each edge.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-joystick">Section 11.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Named argument not found&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 448. A mistake in the program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> needs DVX <em>version</em> or later (this is DVX <em>version</em>).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Update DVX first.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-refused">Section 11.11.13</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>address</em> needs encryption, which DVX does not have: use an http:// address.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX cannot use https:// addresses.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> needs <em>package</em> <em>version</em> or later, but an older one is being installed.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">It needs a newer version of another package.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-refused">Section 11.11.13</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> needs <em>package</em> <em>version</em> or later, which is not here.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A package it needs is missing.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-refused">Section 11.11.13</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Networking is not installed.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The Networking part of DVX is not installed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-notinstalled">Section 11.9.3</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Networking is not installed&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The Networking part of DVX is not installed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-reach">Section 11.9.9</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Networking is not started&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No program has used the network yet.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-notstarted">Section 11.9.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;NEXT variable mismatch&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;NEXT without FOR&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 1. A mistake in the program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;No account is set for the package server.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Set your account in File &gt; Package Server.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-publish">Section 11.11.19</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;No answer&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Nobody answered at the last try.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-modem">Section 11.10.4</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;No answer: dialing again in <em>n</em> seconds&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Nobody answered; Terminal dials again.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-modem">Section 11.10.4</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;No carrier&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The call did not connect at the last try.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-modem">Section 11.10.4</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;No carrier: dialing again in <em>n</em> seconds&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The call did not connect; Terminal dials again.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-modem">Section 11.10.4</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;No compiled module found in this application.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The program&#8217;s file is damaged. Reinstall it.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-start">Section 11.14.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;No dial tone: check the phone line&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The modem heard no dial tone.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-modem">Section 11.10.4</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;No drawing area&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;No error&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A network message shown by a DVX BASIC program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-basic">Section 11.9.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;No file loaded.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Open a file first.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-programs">Section 11.12.12</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;No file to send&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A program started a transfer wrongly.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-transfers">Section 11.10.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;No file transfer can be started now.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Too many transfers, too little memory, or no connection.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-terminal">Section 11.10.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;No game controllers found.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No joystick was found.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-joystick">Section 11.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;No host name is set&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A connection was opened without a host name.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-reach">Section 11.9.9</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;No index available.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The help file has no index.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-help">Section 11.12.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;"<em>item</em>" no longer has its shortcut key <em>keys</em>. <em>reason</em> Choose another one in the item&#8217;s Properties.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">An item&#8217;s shortcut key is not allowed; it was removed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-progman">Section 11.13.8</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;No matching topics found.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No page has the words searched for.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-help">Section 11.12.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;No modules loaded from LIBS\ or WIDGETS\&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX.EXE was started away from its LIBS and WIDGETS folders.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-start-damaged">Section 11.2.4</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;No packet driver found: load one (for example NE2000.COM) before DVX&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX found no packet driver for the network card.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-driver">Section 11.9.4</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;No program is set to open <em>ext</em> files. File types are set in the Control Panel.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No program is set for that kind of file.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-filemgr">Section 11.12.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;No program is set up to open <em>file</em>. Choose one on the File Types page of the Control Panel.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No program is set for that kind of document.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-start">Section 11.13.1</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;No program loaded&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The program could not be loaded. Reinstall it.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-start">Section 11.14.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;No sound device can play this music&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No sound device that can play this music is running.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-messages">Section 11.7.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;No sound device could be started&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No sound hardware is working.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-messages">Section 11.7.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;No such control&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;No such file or directory (ENOENT)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The DOS program&#8217;s working folder does not exist.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-dos">Section 11.13.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;No such sound is playing&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A program asked for something that cannot be done.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-messages">Section 11.7.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;No swap space!&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The memory helper ran out of room on disk for memory.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-start-memory">Section 11.2.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;No system information available.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX could not gather any information about the computer.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-first-sysinfo">Section 11.1.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Not a menu of the menu bar&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Not a music or sound file (MOD, S3M, XM, IT, MIDI, WAV, or VOC)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file is not music or sound DVX can play.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-messages">Section 11.7.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Not a TYPE instance&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Not a WAV or VOC sound file&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file is not a sound file DVX can play.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-messages">Section 11.7.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Not an open connection&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A network message shown by a DVX BASIC program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-basic">Section 11.9.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Not compiled: the source could not be saved.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The help source cannot be written.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-programs">Section 11.12.12</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Not connected&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The joystick stopped answering.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-joystick">Section 11.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Not enough memory&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Memory is short. Close programs.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-messages">Section 11.7.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Not enough memory (ENOMEM)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Not enough memory for the DOS program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-dos">Section 11.13.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Not enough memory to capture the image.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Not enough memory for a screenshot.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-video-other">Section 11.3.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Not enough memory to print.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Memory is short. Close programs.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-start">Section 11.8.3</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Not enough memory to print the picture.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Memory is short. Close programs.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-start">Section 11.8.3</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Not enough memory to print the window.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Memory is short. Close programs.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-start">Section 11.8.3</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Not enough memory to start the operation.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Memory is short. Close programs.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-filemgr">Section 11.12.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Not responding&#8221; (in the Task Manager)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The program has been busy for 5 seconds or more.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-hang">Section 11.13.3</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Not signed by a publisher DVX trusts: <em>names</em>. Install them only if you trust where they came from.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Install only if you trust where the package came from.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-plan">Section 11.11.12</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Nothing is playing&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Normal: the Media Player has nothing loaded.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-player">Section 11.7.17</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Nothing to do yet (try again later)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A network message shown by a DVX BASIC program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-basic">Section 11.9.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Object doesn&#8217;t support named arguments&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 446. A mistake in the program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Object doesn&#8217;t support this property or method&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 438. A mistake in the program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Object has no default property&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Object not a collection&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 451. A mistake in the program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Object required&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 424. A mistake in the program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Object variable not set&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 91. A mistake in the program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Only text resources can be edited inline.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Only text can be edited this way.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-programs">Section 11.12.12</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Open a picture first.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Nothing to print.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-programs">Section 11.12.12</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Other software in <em>folder</em> needs these parts, so Setup keeps them: <em>parts</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Setup keeps parts that add-ons need.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-parts">Section 11.11.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Out of DATA&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 4. A mistake in the program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Out of memory&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Memory ran out. Close programs.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Out of memory allocating array&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Memory ran out. Close programs.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Out of memory allocating TYPE&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Memory ran out. Close programs.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Out of memory: cannot allocate an application slot.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Memory is short. Close programs.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-start">Section 11.13.1</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Out of memory creating the BASIC runtime.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Memory is short. Close programs.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-start">Section 11.14.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Out of memory creating the form runtime.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Memory is short. Close programs.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-start">Section 11.14.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Out of memory for the secure link&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Memory is short. Close programs.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-secure">Section 11.10.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Out of memory loading program&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Memory is short. Close programs.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-start">Section 11.14.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Out of memory marshalling arguments for external function '<em>name</em>'.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Memory ran out. Close programs.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Out of network memory&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A network message shown by a DVX BASIC program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-basic">Section 11.9.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Out of stack space&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 28. Too many calls inside calls: a mistake in the program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Out of string space&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 14. Memory for text ran out. Close programs.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Overflow&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A number is too big, or a file is larger than 2 GB.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>n</em> packages on <em>address</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Normal: the packages the server offers.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Packages cannot be fetched: the path of the DOWNLOAD folder in your user folder is too long.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The USER folder&#8217;s path is too long.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Packages signed with this key are trusted from now on.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The publisher&#8217;s key is now trusted.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-keys">Section 11.11.18</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;PaintPicture has no picture&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;PaintPicture needs a picture, x, and y&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Passphrase for the secure link:&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Terminal asks for the secure link&#8217;s passphrase.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-secure">Section 11.10.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Path not found&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 76. The folder does not exist.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Path/File access error&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 75. A file or folder cannot be made, removed, renamed, or written: the file is read-only, or the disk cannot be written or its main folder is full.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Permission denied&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 70. Another program is using the file.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Picture from LoadPictureData not shown&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Picture has no methods&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Picture not loaded&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Memory ran out. Close programs.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Picture properties are read-only&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Please insert Disk <em>n</em> of <em>n</em> in <em>drive</em> and choose OK.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Setup needs the next floppy disk.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-disks">Section 11.11.4</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Press any key to return to DVX.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The DOS program ended.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-dos">Section 11.13.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Printer has no such method&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Printer has no such property&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Printing is not installed.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A part of DVX is missing. Repair DVX with Setup.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-programs">Section 11.8.8</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Printing is not installed&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A part of DVX is missing. Repair DVX with Setup.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-programs">Section 11.8.8</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Printing <em>document</em> on <em>port</em>&#8230;&#8203;&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Normal: a printout is going out.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-settings">Section 11.8.1</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Program needs <em>n</em> global variables; the limit is <em>n</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The program is too large. Ask its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-start">Section 11.14.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Property is read-only&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Property not found on control&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Property read on control with no widget&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Property set on control with no widget&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Protected mode not accessible.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Another program holds the processor&#8217;s protected mode. Start DVX from plain DOS.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-start-memory">Section 11.2.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Read of unknown control&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Record longer than LEN&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program or its data. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>host</em> refused the connection on port <em>port</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Nothing answers on that port.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-reach">Section 11.9.9</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Remove resource '<em>name</em>'?&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The Resource Editor asks before removing.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-programs">Section 11.12.12</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Removing did not finish. <em>reason</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The removal stopped; the reason says why.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-stopped">Section 11.11.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em> - <em>n</em> resource(s)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The resources in the file.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-programs">Section 11.12.12</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Restart DVX to start using the new version of DVX.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX itself was updated. Restart DVX.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-stopped">Section 11.11.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;RESUME without error&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 20. A mistake in the program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;RETURN without GOSUB&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 3. A mistake in the program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Row <em>n</em> of the files has no TAB between the name and the file.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A row of the file list is wrong.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-builder">Section 11.11.20</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Running <em>file</em> closes these programs first: <em>programs</em> Each one asks about unsaved work as it closes. Continue?&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX closes other programs before running a DOS program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-dos">Section 11.13.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Runtime error&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A DVX BASIC error with no text.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-box">Section 11.14.1</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Runtime error <em>number</em> at PC <em>n</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A DVX BASIC program stopped with an error.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-box">Section 11.14.1</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Runtime error <em>number</em> on line <em>line</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A DVX BASIC program stopped with an error.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-box">Section 11.14.1</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Save cancelled.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The save was cancelled.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-programs">Section 11.12.12</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Save changes?&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The program has unsaved work.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-notepad">Section 11.12.11</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;SaveScreenshot needs a form with a window and a file it can write (BMP when the name ends in .bmp, PNG otherwise).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The screenshot could not be saved: often a read-only or full disk.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> says it is part of DVX, but it is not signed by DVX&#8217;s key.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A package claiming to be DVX&#8217;s is not signed by DVX. Do not install it.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-refused">Section 11.11.13</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Screen property cannot be set&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Screenshot not saved&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The screenshot could not be saved: often a read-only or full disk.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;ScrollToControl needs a control inside a ScrollPane&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Secure link established&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Normal: the secure link works. Press Enter.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-secure">Section 11.10.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Secure link established (passphrase checked)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Normal: the secure link works. Press Enter.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-secure">Section 11.10.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Select one file or folder to rename.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Several items are selected.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-filemgr">Section 11.12.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Sending to everyone needs SO_BROADCAST&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A network message shown by a DVX BASIC program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-basic">Section 11.9.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>host</em> sent the request elsewhere too many times.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The server&#8217;s answer is not usable.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>host</em> sent the request to <em>address</em>, which is not an http:// address.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The server sends DVX to an address it cannot use.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Setting up the modem on COM<em>n</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Normal: the modem&#8217;s setup command was sent.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-modem">Section 11.10.4</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Setting up the secure link on COM<em>n</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Normal: the secure link is starting.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-secure">Section 11.10.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Setting up the secure link with <em>host</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Normal: the secure link is starting.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-secure">Section 11.10.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Setup could not create the folder <em>folder</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The folder cannot be made on that drive.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-space">Section 11.11.3</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Setup could not read the DVX package in <em>folder</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The CD or floppy disk cannot be read.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-unpack">Section 11.11.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Setup could not read the DVX package on disk <em>n</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The CD or floppy disk cannot be read.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-unpack">Section 11.11.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Setup could not write <em>file</em>. The disk may be full.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The disk is full.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-unpack">Section 11.11.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Setup could not write <em>file</em>. The disk may be full or write-protected.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The disk is full or write-protected.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-unpack">Section 11.11.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Setup is reading DVX from <em>folder</em>. Choose a folder that is not this one and not inside it.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Choose a folder that is not on the CD or floppy.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-folder">Section 11.11.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Setup was cancelled: <em>name</em> and the add-ons after it are not as you chose. Software (in Program Manager) can install and remove them.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Use Software to finish installing the add-ons.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-parts">Section 11.11.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Setup was cancelled. DVX in <em>folder</em> is incomplete now; run Setup again to repair it.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">An upgrade was cancelled. Run Setup again to repair it.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-unpack">Section 11.11.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Setup was cancelled: <em>name</em> is not all removed. Software (in Program Manager) can remove it.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Use Software to finish removing it.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-parts">Section 11.11.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Setup was cancelled. Nothing was installed in <em>folder</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A new installation was cancelled; nothing was installed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-unpack">Section 11.11.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Setup will add this line to the end of <em>file</em>, so DVX starts when the computer starts: <em>line</em> The file as it is now is saved as <em>backup</em> first. Add the line?&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Setup asks before changing AUTOEXEC.BAT.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-after">Section 11.11.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Show on form with no window&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Show on unknown form&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Signing in: the package server answered <em>number</em> (&#8230;&#8203;).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Signing in failed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-publish">Section 11.11.19</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;(some items could not be read)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Part of the selection could not be read.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-filemgr">Section 11.12.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Sound device: <em>device</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The sound hardware DVX is using, shown on the Sounds page.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-none">Section 11.7.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Sound driver and MIDI changes take effect when DVX next starts.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Restart DVX after changing these settings.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-none">Section 11.7.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Sound is not installed.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A part of DVX is missing. Repair DVX with Setup.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-none">Section 11.7.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Sound Recorder cannot open <em>file</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file cannot be opened; the reason follows.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-recording">Section 11.7.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Sound Recorder cannot play this recording.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The recording cannot be played; the reason follows.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-recording">Section 11.7.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Sound Recorder cannot record.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Recording could not start; the reason follows.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-recording">Section 11.7.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Sound Recorder cannot record from the MIDI keyboard.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">MIDI in is not the MIDI port, or another program reads it.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-recording">Section 11.7.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Sound Recorder could not save <em>file</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The recording could not be saved there.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-recording">Section 11.7.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em> starts DVX with the line <em>line</em> Remove that line? (The file as it is now is saved as AUTOEXEC.DVX first.)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Setup offers to remove DVX&#8217;s line from AUTOEXEC.BAT.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-remove">Section 11.11.8</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Subscript out of range&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 9. A mistake in the program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Swap disk full!&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Drive C: is full: the memory helper cannot move memory out to disk.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-start-memory">Section 11.2.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Tab width must be from 1 to 16.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Page Setup cannot use the tab width.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-dialog">Section 11.8.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Telnet and the secure link over the network need Networking, which is not installed. Setup can add it.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The Networking part of DVX is not installed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-terminal">Section 11.10.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Text only works with any printer; choose your printer&#8217;s model to print pictures too.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The Printer page&#8217;s reminder that Text only does not print pictures.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-pictures">Section 11.8.4</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;That address is not this computer&#8217;s&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A network message shown by a DVX BASIC program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-basic">Section 11.9.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;That group is full.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A group holds 256 items.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-progman">Section 11.13.8</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;That name could not be found (check the name and the network settings)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A network message shown by a DVX BASIC program: a name lookup failed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-basic">Section 11.9.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;That name is a reserved device name.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The name breaks the file name rules of the disk.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-names">Section 11.12.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;That name is reserved.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The name breaks the file name rules of the disk.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-names">Section 11.12.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;That network cannot be reached (check the network settings)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A network message shown by a DVX BASIC program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-basic">Section 11.9.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;That port is already in use&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A network message shown by a DVX BASIC program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-basic">Section 11.9.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The address is not a valid address (like 192.168.1.10)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The fixed address is missing or not valid.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-settings">Section 11.9.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The address is too long.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Correct the package server&#8217;s address.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The attributes of some items could not be changed.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The disk cannot be written to, or an item is gone.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-filemgr">Section 11.12.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The capture file could not be opened.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The capture file cannot be written.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-terminal">Section 11.10.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The clipboard holds no files. Use Copy or Cut in a File Manager window first.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Copy or cut files first.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-filemgr">Section 11.12.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The code ran too long without returning and was stopped&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A control&#8217;s code ran too long. Report it to the author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-long">Section 11.14.4</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The computer name may only use letters, digits and hyphens&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The Computer name has a character that is not allowed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-settings">Section 11.9.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The connection could not be opened&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A network message shown by a DVX BASIC program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-basic">Section 11.9.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The connection is closed for sending&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A network message shown by a DVX BASIC program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-basic">Section 11.9.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The connection is still being made&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A network message shown by a DVX BASIC program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-basic">Section 11.9.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The connection to <em>host</em> failed&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A network failure, such as too many connections.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-reach">Section 11.9.9</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The connection to <em>host</em> was lost&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The connection broke.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-reach">Section 11.9.9</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The connection was given up&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A network message shown by a DVX BASIC program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-basic">Section 11.9.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The details are in <em>file</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Where the log file is, after &#8220;DVX stopped while starting&#8221;.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-start-crash">Section 11.2.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The disk in <em>drive</em> belongs to a different set of DVX disks. Please insert Disk <em>n</em> of <em>n</em> of this set and choose OK.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A disk from another set of DVX disks is in the drive.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-disks">Section 11.11.4</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The disk in <em>drive</em> cannot be read. Please insert Disk <em>n</em> of <em>n</em> and choose OK.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The floppy disk is damaged.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-disks">Section 11.11.4</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The disk is full.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Make room, or use another disk.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-filemgr">Section 11.12.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The document could not be printed.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The printout failed part way.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-start">Section 11.8.3</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The download of <em>name</em> cannot be read.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The download could not be kept.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The drive is not ready.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The drive has no disk in it.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-filemgr">Section 11.12.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The DVX package ends too early (disk <em>n</em>).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The CD or a floppy disk is damaged.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-unpack">Section 11.11.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The DVX package holds a name Setup does not accept: <em>name</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The CD or a floppy disk is damaged.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-unpack">Section 11.11.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The DVX package is damaged (disk <em>n</em>).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The CD or a floppy disk is damaged.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-unpack">Section 11.11.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The DVX package is incomplete: <em>n</em> of <em>n</em> files.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The CD or the floppy disks are damaged or incomplete.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-unpack">Section 11.11.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The DVX package uses a form Setup cannot read (disk <em>n</em>).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The CD or a floppy disk is damaged.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-unpack">Section 11.11.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The file could not be read&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file is missing, or its disk cannot be read.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-messages">Section 11.7.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The file could not be written&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The disk is full or cannot be written to.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-messages">Section 11.7.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The file <em>file</em> in the DVX package is damaged (disk <em>n</em>).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The CD or a floppy disk is damaged.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-unpack">Section 11.11.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The file or folder was not found.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">It was removed, or the disk was changed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-filemgr">Section 11.12.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The file types could not be saved: the disk may be full or write-protected.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Control Panel could not save the File Types changes.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-full">Section 11.12.9</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The files cannot be read. <em>reason</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A file or folder of the package cannot be read.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-builder">Section 11.11.20</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The first page to print comes after the last one.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The From page is after the To page.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-dialog">Section 11.8.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The folder <em>folder</em> cannot be made. <em>reason</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Your key&#8217;s folder cannot be made.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-builder">Section 11.11.20</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The folder <em>folder</em> cannot be made, or its drive is not ready.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The destination folder cannot be made.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-filemgr">Section 11.12.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The folder <em>folder</em> cannot be read.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The folder added to the Media Player cannot be read.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-player">Section 11.7.17</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The folder does not exist.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The folder or drive typed cannot be opened.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-dialogs">Section 11.12.1</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The folder <em>folder</em> is too long.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The folder is too deep. Choose a shorter one.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-unpack">Section 11.11.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The gateway is not a valid address (like 192.168.1.1)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The gateway is not an address.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-settings">Section 11.9.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The help compiler is not available, or no input or output file was given.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Developer Tools is not installed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-programs">Section 11.12.12</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The host did not answer the secure link&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The proxy did not answer within 30 seconds.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-secure">Section 11.10.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The host <em>name</em> was not found&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The computer&#8217;s name could not be found.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-dns">Section 11.9.8</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The id <em>id</em> is not vendor.name (each part 1 to 8 of a-z, 0-9, and _).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package was made wrongly. Tell its maker.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-read">Section 11.11.11</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The image could not be saved.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The screenshot could not be written to the disk.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-video-other">Section 11.3.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The instrument bank for MIDI music is missing or damaged&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The instruments for MIDI music cannot be found.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-banks">Section 11.7.12</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The key cannot be made. <em>reason</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Your key could not be made.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-builder">Section 11.11.20</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The key cannot be trusted: <em>reason</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The key file cannot be used; the reason says why.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-keys">Section 11.11.18</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The key&#8217;s id is not its public key&#8217;s.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The key file is damaged or was changed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-keys">Section 11.11.18</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The left and right margins leave less than 10 characters for text.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Page Setup&#8217;s margins are too large.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-dialog">Section 11.8.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The licence of the font <em>family</em> cannot be read. The log file says why.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The font&#8217;s file cannot be read. Install the font again.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-fonts">Section 11.12.13</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The line is busy&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The number was busy at the last try.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-modem">Section 11.10.4</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The line is busy: dialing again in <em>n</em> seconds&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The number was busy; Terminal dials again.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-modem">Section 11.10.4</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The manifest has no format number: it is not a DVX package manifest.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file is not a proper DVX package.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-read">Section 11.11.11</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The manifest needs an id, a name, a version, and a kind.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file is not a proper DVX package.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-read">Section 11.11.11</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The manifest of <em>file</em> cannot be read: it is damaged.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package is damaged, the disk is full, or memory is short.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-read">Section 11.11.11</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The message is too long&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A network message shown by a DVX BASIC program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-basic">Section 11.9.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The modem on COM<em>n</em> did not answer&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The modem did not answer its setup command.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-modem">Section 11.10.4</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The modem refused the dial command&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The modem answered ERROR to the dial command.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-modem">Section 11.10.4</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The modem refused the setup command <em>command</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The modem answered ERROR to the setup command.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-modem">Section 11.10.4</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The music file is damaged or incomplete&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The music file is damaged.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-messages">Section 11.7.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The music string has a mistake in it&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A tune given to a program as text has a mistake.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-messages">Section 11.7.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The name could not be looked up&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A network message shown by a DVX BASIC program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-basic">Section 11.9.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The name is too long for this folder.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The name breaks the file name rules of the disk.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-names">Section 11.12.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The name server did not answer in time&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A network message shown by a DVX BASIC program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-basic">Section 11.9.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The network is not running&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A network message shown by a DVX BASIC program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-basic">Section 11.9.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The network operation failed&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A network message shown by a DVX BASIC program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-basic">Section 11.9.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The old mode comes back in <em>n</em> seconds.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The new screen mode is undone unless you click Keep.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-video-choose">Section 11.3.3</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The oldest DVX must be a version such as <em>version</em>, or left empty.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The oldest DVX is not a version number.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-builder">Section 11.11.20</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The other computer broke off the connection&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A network message shown by a DVX BASIC program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-basic">Section 11.9.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The other computer did not answer in time&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A network message shown by a DVX BASIC program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-basic">Section 11.9.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The other computer refused the connection&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A network message shown by a DVX BASIC program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-basic">Section 11.9.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The package cannot be built. <em>reason</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package cannot be built; the reason says why.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-builder">Section 11.11.20</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The package cannot be built: <em>file</em> cannot be written.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The disk is full or cannot be written to.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-builder">Section 11.11.20</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The package depends on itself.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package was made wrongly. Tell its maker.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-read">Section 11.11.11</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The package holds no files.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package was made wrongly. Tell its maker.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-read">Section 11.11.11</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The package is built: <em>file</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package was built.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-builder">Section 11.11.20</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The package: it is damaged.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package is damaged.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-stopped">Section 11.11.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The package name must be two parts with a dot between them, such as acme.chess: who made it, then what it is, each 1 to 8 lower-case letters, digits, or _.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package name is not in the form maker.name.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-builder">Section 11.11.20</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em>: the package server answered <em>number</em> (<em>message</em>).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The server refused the package; its message says why.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-publish">Section 11.11.19</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>what</em>: the package server answered <em>number</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The server reported a problem.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The package server cannot be reached: <em>reason</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Software could not read the package server; the reason says why.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The package server cannot be reached: Cannot find <em>name</em> on the network.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package server&#8217;s name could not be found.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-dns">Section 11.9.8</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The package server cannot be saved in DVX&#8217;s settings.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX.INI cannot be written.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server-window">Section 11.11.17</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The package server could not be reached.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Software could not read the package server.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The package server does not know that email and password.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check your email and password.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-publish">Section 11.11.19</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The package server gave no session when signing in.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Signing in failed. Try later.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-publish">Section 11.11.19</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The package server needs DVX&#8217;s Networking part. To add it, run Setup from DVX&#8217;s CD or Disk 1 and choose Upgrade or repair.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The Networking part of DVX is not installed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-software">Section 11.11.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The package server&#8217;s address is too long.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Correct the package server&#8217;s address.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The package server&#8217;s answer cannot be read: <em>reason</em>&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The address is not a DVX package server.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The package server&#8217;s answer has no list of packages.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The address is not a DVX package server.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The package server&#8217;s list of your packages cannot be read.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The address is not a DVX package server.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The packet driver interrupt must be between 0x60 and 0x80&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The packet driver interrupt in DVX.INI is outside 60h to 80h.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-settings">Section 11.9.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The page setup could not be saved.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX.INI could not be written.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-dialog">Section 11.8.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The passphrase does not match the host&#8217;s&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The two passphrases differ.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-secure">Section 11.10.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The path <em>file</em> is too long.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">AUTOEXEC.BAT could not be changed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-after">Section 11.11.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The path is too long.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The folder and name together are too long.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-dialogs">Section 11.12.1</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The path of <em>file</em> is too long.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The folder is too deep. Choose a shorter one.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-unpack">Section 11.11.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The path of the KEYS folder is too long.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The path of the USER folder is too long.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-keys">Section 11.11.18</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The phone book <em>file</em> cannot be read. Terminal goes on, but does not save changes to the phone book, so the sessions in the file are not lost.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Terminal&#8217;s settings file is damaged or its disk failed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-terminal">Section 11.10.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The phone book is full. Delete an entry first.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The phone book holds 32 sessions.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-terminal">Section 11.10.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The picture could not be printed.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The printout failed part way.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-start">Section 11.8.3</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The port <em>port</em> cannot be opened. Another program may be using it.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Another program is using the serial port.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-start">Section 11.8.3</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The port could not be opened&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A network message shown by a DVX BASIC program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-basic">Section 11.9.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The port is a number from 1 to 65535, or empty for the usual one.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Correct the package server&#8217;s port.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server-window">Section 11.11.17</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The printer driver for <em>model</em> is missing, so DVX cannot print on that printer. To put it back, run Setup and choose Upgrade or repair DVX.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The PostScript printer driver file is missing. Repair DVX with Setup.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-driver">Section 11.8.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The printer driver is missing&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The PostScript printer driver file is missing (a DVX BASIC program).</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-programs">Section 11.8.8</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The printer model chosen in the Control Panel prints text only. To print pictures, choose your printer&#8217;s model on the Control Panel&#8217;s Printer page.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The printer model is Text only. Choose your printer&#8217;s model.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-pictures">Section 11.8.4</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The printer model chosen in the Control Panel prints text only. To print with the Printer object, choose your printer&#8217;s model on the Control Panel&#8217;s Printer page.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The printer model is Text only. Choose your printer&#8217;s model.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-programs">Section 11.8.8</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The Printer object needs the printing library (print.lib).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A part of DVX is missing. Repair DVX with Setup.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-programs">Section 11.8.8</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The printer on <em>port</em> is not responding. Check that it is switched on and connected, then choose Retry.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The printer took nothing for 10 seconds.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-retry">Section 11.8.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The printer on <em>port</em> is off line or switched off. Switch it on and put it on line, then choose Retry.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The printer is off, off line, or not connected.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-retry">Section 11.8.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The printer on <em>port</em> is out of paper. Load paper, then choose Retry.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Load paper, then click Retry.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-retry">Section 11.8.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The printer on <em>port</em> reports an error. Check that it is switched on, connected and has paper, then choose Retry.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The printer signals a fault.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-retry">Section 11.8.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The printer prints text only&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The printer model is Text only. Choose your printer&#8217;s model.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-programs">Section 11.8.8</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The receiver did not start&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The other side never started receiving.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-transfers">Section 11.10.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The receiver ended the transfer&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The other side stopped the transfer.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-transfers">Section 11.10.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The recording could not all be written.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The disk filled up during the recording.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-recording">Section 11.7.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The recording could not be written.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The MIDI recording could not be saved; the disk is full or cannot be written to.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-recording">Section 11.7.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The reply is too big to keep in memory: save it to a file.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The server&#8217;s answer is not usable.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The screen mode could not be saved. Change it in the Control Panel instead.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX.INI could not be written.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-video-safe">Section 11.3.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The screen mode DVX is set to use (<em>width</em>x<em>height</em>, <em>bits</em>-bit color) does not work on this computer, so DVX started in safe video mode (<em>width</em>x<em>height</em>, <em>bits</em>-bit color). Use this mode from now on?&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The saved screen mode does not work, so DVX started in safe video mode.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-video-safe">Section 11.3.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The secure link cannot use XON/XOFF flow control: choose None or RTS/CTS&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The session is set to XON/XOFF, which the secure link cannot use.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-secure">Section 11.10.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The secure link could not be set up&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The secure link failed to start.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-secure">Section 11.10.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The secure link was lost&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The other side stopped answering.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-secure">Section 11.10.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The sender did not start&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The other side never started sending.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-transfers">Section 11.10.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The sender stopped&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A ZMODEM batch stopped early.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-transfers">Section 11.10.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The server sent a chunk of the reply in a form HTTP does not have.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The server&#8217;s answer is not usable.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The server&#8217;s reply has a head too long to read.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The server&#8217;s answer is not usable.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The settings could not be saved: the disk may be full or write-protected. Control Panel stays open: click its OK to try again, or Cancel to undo the changes.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Control Panel could not write DVX.INI.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-full">Section 11.12.9</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The signature of <em>file</em> cannot be read.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package&#8217;s signature is damaged.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-read">Section 11.11.11</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The Software program can reinstall or remove an add-on.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The end of the Add-ons box: use Software to fix the add-ons listed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-start-addons">Section 11.2.9</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The sound device cannot record from that input&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The sound card has no such input.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-messages">Section 11.7.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The sound file is damaged or incomplete&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The sound file is damaged.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-messages">Section 11.7.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The subnet mask is not valid (like 255.255.255.0)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The subnet mask is missing or not valid.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-settings">Section 11.9.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The synthesizer or sound device is being used by another program (or is recording)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Another program, or a recording, has the sound card.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-messages">Section 11.7.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The System font is DVX&#8217;s own: it comes with DVX, under DVX&#8217;s licence.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The System font&#8217;s licence.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-fonts">Section 11.12.13</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The top and bottom margins leave no room for text.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Page Setup&#8217;s margins are too large.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-dialog">Section 11.8.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;The version must be numbers with dots between them, such as 1.0.0.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The version is not in the form 1.0.0.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-builder">Section 11.11.20</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Theme file name is too long.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Choose a shorter name for the theme.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-video-desktop">Section 11.3.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;There are no music or sound files in <em>folder</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The folder has no files the Media Player plays.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-player">Section 11.7.17</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;There are no other installed packages to choose from: a package can need only packages installed in this DVX.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A package can need only installed packages.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-builder">Section 11.11.20</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;There is no <em>file</em> yet. Setup will make one with this line, so DVX starts when the computer starts: <em>line</em> Add the line?&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Setup asks before making AUTOEXEC.BAT.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-after">Section 11.11.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;There is no other group. Make one with File &gt; New Group first.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Make another group first.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-progman">Section 11.13.8</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;There is no room for another group: Program Manager holds up to 64 groups of your own. Delete a group to make room for a new one.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">You have 64 groups already. Delete one first.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-progman">Section 11.13.8</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;there is no serial port there&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The reason a COM port could not be opened: it does not exist.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-port">Section 11.10.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;There is no such synthesizer&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No FM chip was found, or MIDI in is not the MIDI port.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-messages">Section 11.7.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;There is not enough free space for DVX on that disk. DVX needs about <em>n</em> bytes; <em>n</em> bytes are free.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The disk is too full for what you chose.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-space">Section 11.11.3</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;There is not enough memory.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Memory is short. Close programs.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-stopped">Section 11.11.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;&#8230;&#8203; There is not enough memory for the picture.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Memory ran out. Close programs.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;There is not enough memory for the picture.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Memory ran out. Close programs.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;There is not enough memory for the Printer.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Memory is short. Close programs.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-programs">Section 11.8.8</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;There is not enough memory for the Printer&#8217;s page.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Memory is short. Close programs.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-programs">Section 11.8.8</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;There is not enough memory to change <em>file</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">AUTOEXEC.BAT could not be changed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-after">Section 11.11.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;There is not enough memory to install the add-ons.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Free memory and run Setup again.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-parts">Section 11.11.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;There is not enough memory to remove the parts left out.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Free memory and run Setup again.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-parts">Section 11.11.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;There is not enough memory to run Setup.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Free memory and run Setup again.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-start">Section 11.11.1</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;There is not enough memory to start Package Builder.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Memory is short. Close programs.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-builder">Section 11.11.20</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;There is not enough memory to start Software.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Memory is short. Close programs.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-software">Section 11.11.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;There is not enough room on the disk: it needs <em>n</em> bytes and <em>n</em> are free. Make room on the disk, then install again.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Install is off until there is room.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-plan">Section 11.11.12</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;There is not enough room on the disk: <em>name</em> needs <em>n</em> KB and <em>n</em> KB are free.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Free space on the drive DVX is on.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-stopped">Section 11.11.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;There is not enough synthesizer memory&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The wavetable card&#8217;s memory is full.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-messages">Section 11.7.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;There is nothing random enough to make a key from.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Your key could not be made.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-builder">Section 11.11.20</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;These add-ons stop working with the new DVX until they are updated: <em>names</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Update these add-ons too, or keep your DVX.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-plan">Section 11.11.12</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;These files changed since they were installed, so they were left: &#8230;&#8203; Delete them too?&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Files you changed are kept unless you say so.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-remove">Section 11.11.15</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;These files could not be deleted, so they were left: &#8230;&#8203; A program may be using them, or the disk may be write-protected.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Some files could not be deleted.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-remove">Section 11.11.15</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;These files in <em>folder</em> changed since they were installed, so Setup left them:&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Files you changed are kept unless you say so.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-parts">Section 11.11.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;These files in <em>folder</em> could not be deleted, so Setup left them:&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Some files could not be deleted.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-parts">Section 11.11.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;These need <em>name</em> and are removed with it: &#8230;&#8203; Remove them all?&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Other packages need the one you remove.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-remove">Section 11.11.15</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;These were installed for <em>name</em> and nothing else needs them: &#8230;&#8203; Remove them too?&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Packages that came with it can go too.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-remove">Section 11.11.15</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;This array is fixed or temporarily locked&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 10. A mistake in the program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;This computer has no port <em>port</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The printer port chosen does not exist.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-start">Section 11.8.3</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;This computer&#8217;s sound card cannot record.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">There is no sound card that can record.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-recording">Section 11.7.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;This is not a [key] file (or it lacks part of one).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file chosen is not a publisher&#8217;s key.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-keys">Section 11.11.18</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;This is not Disk <em>n</em>. Please insert Disk <em>n</em> of <em>n</em> in <em>drive</em> and choose OK.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The wrong disk of the set is in the drive.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-disks">Section 11.11.4</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;This key is already associated with an element of this collection&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 457. A mistake in the program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;This <em>kind</em> package may not put a file at <em>place</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A file is not allowed where it goes.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-builder">Section 11.11.20</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;This package needs a newer DVX (its manifest is format <em>n</em>).&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Update DVX before installing this package.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-read">Section 11.11.11</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;This program was built for a different version of DVX and cannot run.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The program is for another version of DVX.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-start">Section 11.13.1</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;To install or upgrade DVX, run SETUP from its CD or Disk 1.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">This copy of Setup can only remove DVX.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-start">Section 11.11.1</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;To print the report, choose your printer&#8217;s model on the Control Panel&#8217;s Printer page.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The BASIC Demo needs a printer model that prints pictures.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-programs">Section 11.8.8</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;To publish a package, give your account on the package server in File &gt; Package Server first.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Set your account in File &gt; Package Server first.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-publish">Section 11.11.19</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Too many arguments&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Too many arguments in external call&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 5. A value given to a command is not allowed: a mistake in the program, or in what you typed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Too many connections are open&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A network message shown by a DVX BASIC program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-basic">Section 11.9.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Too many errors&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A transfer block failed 10 times.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-transfers">Section 11.10.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Too many files&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 67. Too many files are open at once.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Too many files open&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 67. Too many files are open at once.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Too many sounds are playing&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The most sounds DVX mixes at once are already playing.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-messages">Section 11.7.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Transfer complete&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The transfer worked.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-transfers">Section 11.10.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Transfer complete (the end was not confirmed)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file should be complete.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-transfers">Section 11.10.7</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Two versions of <em>name</em> are asked for.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The packages are badly made.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-refused">Section 11.11.13</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Type mismatch&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 13. A mistake in the program, or in what you typed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Type the folder to install DVX in.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Setup&#8217;s folder box is empty.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-folder">Section 11.11.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Type the name of the file to print to.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Printing to a file needs a file name.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-file">Section 11.8.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Type the name of the file to print to, or connect the printer to a port.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Printing to a file needs a file name.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-printing-file">Section 11.8.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Type the program or document this item opens.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The Program box is empty.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-progman">Section 11.13.8</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Type the program that opens this type.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The program box is empty.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-start">Section 11.13.1</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Type the whole path of the folder, starting with the drive, for example C:\DVX.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The folder must start with a drive letter.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-folder">Section 11.11.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;unable to open database file (<em>reason</em>)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The database file or its folder is missing.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-databases">Section 11.12.15</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Unknown error&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A sound or music error with no description.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-messages">Section 11.7.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Unknown form property&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Unknown menu property&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Unknown Picture property&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Unknown Screen method&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Unknown Screen property&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Unknown shortcut key&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Unknown widget type in form&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Unsaved changes. Open another file?&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The Icon Editor warns before losing changes.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-programs">Section 11.12.12</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Unsaved changes. Start new icon?&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The Icon Editor warns before losing changes.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-programs">Section 11.12.12</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Unsaved changes will be lost. Change size?&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The Icon Editor warns before losing changes.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-programs">Section 11.12.12</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Unsupported sound format (only uncompressed 8- and 16-bit sound can be played)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The sound file is compressed or in an unusual form.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-sound-messages">Section 11.7.14</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>n</em> updates are ready to install.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Normal: updates are waiting.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;User interrupt occurred&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 18. The code was stopped for running too long.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;UserControl has no such method&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;UserControl has no such property&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;UserControl property cannot be set&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A mistake in the program. Report it to its author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-forms">Section 11.14.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;User-defined error&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A DVX BASIC error number with no text of its own. Ask the program&#8217;s author.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;VBE: Could not use mode 0x<em>number</em> (<em>width</em>x<em>height</em> at <em>bits</em> bpp)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The video card refused the screen mode.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-start-vesa">Section 11.2.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;VBE: Failed to allocate <em>n</em> byte backbuffer&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Not enough memory for the screen mode.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-start-vesa">Section 11.2.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;VBE: Failed to allocate palette&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Not enough memory for the screen mode.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-start-vesa">Section 11.2.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;VBE: No suitable mode found for <em>width</em>x<em>height</em> (VBE <em>version</em>)&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The video card has no mode as large as the one DVX asked for.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-start-vesa">Section 11.2.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;VBE: No VESA BIOS extension (VBE) found&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The video card has no VESA BIOS, or its VESA driver is not loaded.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-start-vesa">Section 11.2.2</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Waiting for a DHCP server&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The network has no address yet.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-network-dhcp">Section 11.9.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Warning: cannot open swap file c:\cwsdpmi.swp&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The memory helper cannot make its swap file on drive C:.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-start-memory">Section 11.2.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em> was copied but cannot be removed.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A move could not delete the original.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-filemgr">Section 11.12.10</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> was damaged on the way. Try again.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The download arrived damaged. Try again.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-server">Section 11.11.16</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>name</em> was made for a different version of DVX.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Get the version made for this DVX.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-refused">Section 11.11.13</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;<em>file</em> was not loaded: <em>reason</em>.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">An add-on&#8217;s library or widget was left out at start.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-start-addons">Section 11.2.9</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Wrong number of arguments or invalid property assignment&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC error 450. A mistake in the program.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-programs-basic-errors">Section 11.14.5</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;You are connected. Disconnect and close?&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Closing Terminal would end the connection.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-serial-terminal">Section 11.10.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Your changes cannot be saved to disk, so they last only until you exit DVX. To keep them, set DVXUSER to a folder DVX can write to before starting DVX.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Nothing can be saved: a change lasts only until you exit DVX.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-files-readonly-dvx">Section 11.12.6</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Your key is made. Give <em>file</em> to the people who install your packages: it tells DVX that they are yours. Keep <em>file</em> private: anyone who has it can sign packages as you.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Keep your secret key file safe.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-builder">Section 11.11.20</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Your old settings and saved files in <em>folder</em> could not all be removed.&#8221;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Setup could not delete all of the USER folder.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#trouble-addons-setup-after">Section 11.11.7</a></p></td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div class="sect1">
<h2 id="keyboard"><a class="anchor" href="#keyboard"></a>Appendix A: Keyboard Shortcuts</h2>
<div class="sectionbody">
<div class="paragraph">
<p><a id="_ix1951" class="ixterm"></a>This appendix gathers the keyboard shortcuts from the rest of this guide in one place. Each table is the same one you find in the section it comes from, which tells you more about the keys.</p>
</div>
<div class="sect2">
<h3 id="keys-global"><a class="anchor" href="#keys-global"></a>A.1. Keys that work in every program</h3>
<div class="paragraph">
<p>These keys work whichever program is in front. See <a href="#desktop-keys">Section 5.9</a>.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 28.5714%;">
<col style="width: 71.4286%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1952" class="ixterm"></a><span class="keyseq"><kbd>Alt</kbd>+<kbd>Tab</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Switch to the next window: the active window goes to the back. Minimized windows are skipped. Does nothing while a dialog box is open.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1953" class="ixterm"></a><span class="keyseq"><kbd>Shift</kbd>+<kbd>Alt</kbd>+<kbd>Tab</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Switch the other way: the window at the back comes to the front.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1954" class="ixterm"></a><span class="keyseq"><kbd>Alt</kbd>+<kbd>F4</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Close the active window. While a dialog box is open, close only the dialog box.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1955" class="ixterm"></a><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Esc</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Open the Task Manager, or bring it to the front (see <a href="#desktop-task-manager">Section 5.10</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1956" class="ixterm"></a><kbd>F1</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Open help for the program you are using (see <a href="#desktop-help">Section 5.11</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F10</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Open the first menu of the active window, or close the open menu.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1957" class="ixterm"></a><span class="keyseq"><kbd>Alt</kbd>+<kbd>Space</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Open or close the window menu of the active window.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Alt</kbd> + a letter</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Open the menu whose underlined letter you typed; otherwise move to, or press, the control with that underlined letter.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Tab</kbd>, <span class="keyseq"><kbd>Shift</kbd>+<kbd>Tab</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Move to the next or previous control.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Enter</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Press the highlighted button, or the main button of a dialog box or of a window that has one (such as Control Panel&#8217;s <b class="button">OK</b>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Esc</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Close a menu or a drop-down list, or press <b class="button">Cancel</b> in a dialog box or a window that has one (such as Control Panel).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>F12</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Save a picture of the whole screen (see <a href="#desktop-screenshots">Section 5.8</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>F12</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Save a picture of the inside of the active window.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Shortcut keys of Program Manager items</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Start that item, whichever window is in front (see <a href="#progman-shortcut-keys">Section 6.4.4</a>).</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect2">
<h3 id="keys-menus"><a class="anchor" href="#keys-menus"></a>A.2. Menus</h3>
<div class="paragraph">
<p>See <a href="#desktop-menus-keyboard">Section 5.4.2</a>.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 28.5714%;">
<col style="width: 71.4286%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Up</kbd>, <kbd>Down</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Move the highlight to the previous or next command. The highlight wraps around from the bottom to the top and skips the lines between groups.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Right</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens the submenu of the highlighted command; otherwise opens the next menu on the menu bar.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Left</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Closes the open submenu; otherwise opens the previous menu on the menu bar.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Enter</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Chooses the highlighted command, or opens its submenu. With nothing highlighted, closes the menu.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">A letter</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Chooses the command with that underlined letter (you do not need <kbd>Alt</kbd> in an open menu). If no command has that letter, opens the menu on the menu bar that has it.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Esc</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Closes the open submenu, or the menu.</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect2">
<h3 id="keys-text"><a class="anchor" href="#keys-text"></a>A.3. Typing and editing text</h3>
<div class="paragraph">
<p>These keys work in every box you type in. See <a href="#desktop-text-boxes">Section 5.5.3.4</a>.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 28.5714%;">
<col style="width: 71.4286%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Left</kbd>, <kbd>Right</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Move one character.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Left</kbd></span>, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Right</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Move one word.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Home</kbd>, <kbd>End</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Go to the start or end of the line.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Up</kbd>, <kbd>Down</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">In a box of several lines: move one line.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Page Up</kbd>, <kbd>Page Down</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">In a box of several lines: move one boxful of lines.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Home</kbd></span>, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>End</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">In a box of several lines: go to the start or end of the text.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Shift</kbd> with a moving key</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Select text as you move.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Backspace</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Delete the character before the cursor, or the selected text.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Del</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Delete the character at the cursor, or the selected text.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Enter</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">In a box of several lines: start a new line.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>A</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Select all the text.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>X</kbd></span>, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>C</kbd></span>, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>V</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Cut, copy, and paste (see <a href="#desktop-clipboard">Section 5.7</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Z</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1958" class="ixterm"></a>Undo the last change. Press it again to redo the change. Only the last change can be undone.</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect2">
<h3 id="keys-clipboard"><a class="anchor" href="#keys-clipboard"></a>A.4. Cut, copy, and paste</h3>
<div class="paragraph">
<p>See <a href="#desktop-clipboard">Section 5.7</a>.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">Command</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1959" class="ixterm"></a><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>X</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Cut</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Removes the selected text and puts it on the clipboard.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1960" class="ixterm"></a><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>C</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Copy</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Puts a copy of the selected text on the clipboard.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1961" class="ixterm"></a><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>V</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Paste</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Puts the clipboard&#8217;s text where the cursor is. If text is selected, the pasted text replaces it.</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect2">
<h3 id="keys-progman"><a class="anchor" href="#keys-progman"></a>A.5. Program Manager</h3>
<div class="paragraph">
<p>See <a href="#progman-keys">Section 6.11</a>.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 28.5714%;">
<col style="width: 71.4286%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Tab</kbd>, <span class="keyseq"><kbd>Shift</kbd>+<kbd>Tab</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Move between the Groups list, the Search box, and the icon area.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Alt</kbd>+<kbd>G</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Go to the Groups list.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Alt</kbd>+<kbd>S</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Go to the Search box.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Arrow keys, <kbd>Home</kbd>, <kbd>End</kbd>, <kbd>Page Up</kbd>, <kbd>Page Down</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Move between the icons.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">A letter or digit</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Go to the next icon whose name starts with it (in the icon area).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Enter</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Start the selected item (in the icon area).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Del</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Delete the selected item (in the icon area).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F2</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Rename the selected item (in the icon area).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Alt</kbd>+<kbd>Enter</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Properties of the selected item.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F5</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Look for programs that were installed or removed.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F7</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Move the selected item to another group.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F8</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Copy the selected item to a group.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F1</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Open Program Manager&#8217;s help.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Esc</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Open the Task Manager.</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect2">
<h3 id="keys-cpanel"><a class="anchor" href="#keys-cpanel"></a>A.6. Control Panel</h3>
<div class="paragraph">
<p>See <a href="#cpanel-keyboard">Section 7.2.1</a>.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 25%;">
<col style="width: 75%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F1</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens Control Panel&#8217;s help.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Alt</kbd>+<kbd>H</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens the <strong>Help</strong> menu.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Tab</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Moves to the next setting or button. <kbd>Space</kbd> or <kbd>Enter</kbd> presses the button that is highlighted.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Enter</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Presses <b class="button">OK</b>, as in a dialog box (see <a href="#desktop-dialog-boxes">Section 5.5.1</a>), when no button is highlighted. On a list, such as the list of video modes, it presses <b class="button">OK</b> too: to use the item, double-click it or click its button.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Esc</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Presses <b class="button">Cancel</b>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Left</kbd> and <kbd>Right</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">When the row of tabs is highlighted: shows the page of the previous or next tab (after the last tab comes the first).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Home</kbd> and <kbd>End</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">When the row of tabs is highlighted: shows the first or last page.</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect2">
<h3 id="keys-file-manager"><a class="anchor" href="#keys-file-manager"></a>A.7. File Manager</h3>
<div class="paragraph">
<p>See <a href="#programs-file-manager-keys">Section 8.3.11</a>.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 80%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Enter</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">In the file list, opens the highlighted item. In the <strong>Path</strong> box, goes to the folder typed there.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Backspace</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Goes up one folder (in the file list or the folder tree).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Del</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Deletes the selection (in the file list or the folder tree).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F2</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Rename.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F5</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Refresh.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F7</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Move To.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F8</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Copy To.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Alt</kbd>+<kbd>Enter</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Properties.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>A</kbd></span>, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>C</kbd></span>, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>X</kbd></span>, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>V</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Select all, copy, cut, and paste files, when the file list has the focus.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Space</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Selects or unselects the highlighted item.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Shift</kbd> with an arrow key</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Selects as you move.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Letters</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Typed quickly, one after another, jump to the item whose name starts with them; the same letter again jumps to the next item starting with it (see <a href="#desktop-lists">Section 5.5.3.6</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F1</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Help.</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect2">
<h3 id="keys-notepad"><a class="anchor" href="#keys-notepad"></a>A.8. Notepad</h3>
<div class="paragraph">
<p>See <a href="#programs-notepad-editing">Section 8.4.3</a>.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Key or action</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Arrow keys</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Move one character or one line.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Left</kbd></span>, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Right</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Move one word.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Home</kbd>, <kbd>End</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Move to the start or end of the line.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Page Up</kbd>, <kbd>Page Down</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Move one screenful.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Home</kbd></span>, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>End</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Move to the start or end of the text.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Shift</kbd> with any of these keys, or drag with the mouse</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Select text.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Double-click, triple-click</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Select a word, or a whole line.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>A</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Select all the text.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>X</kbd></span>, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>C</kbd></span>, <span class="keyseq"><kbd>Ctrl</kbd>+<kbd>V</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Cut, copy, and paste.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>Z</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Undo the last change. Press it again to redo the change.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Tab</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Put a tab in the text.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Mouse wheel, scroll bars</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Move through a long text.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F1</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Help.</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect2">
<h3 id="keys-terminal"><a class="anchor" href="#keys-terminal"></a>A.9. Terminal</h3>
<div class="paragraph">
<p>See <a href="#terminal-keys">Section 9.3.3</a>.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 40%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>F1</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens Terminal&#8217;s help.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Alt</kbd>+<kbd>F</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens the <strong>File</strong> menu.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Alt</kbd>+<kbd>E</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens the <strong>Edit</strong> menu.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Alt</kbd>+<kbd>S</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens the <strong>Settings</strong> menu.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Alt</kbd>+<kbd>T</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens the <strong>Transfer</strong> menu.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Alt</kbd>+<kbd>H</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Opens the <strong>Help</strong> menu.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>C</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">With text selected on the screen, copies it. Without a selection, it is sent to the other computer.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Ctrl</kbd>+<kbd>V</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Sends the text on the clipboard to the other computer.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="keyseq"><kbd>Shift</kbd>+<kbd>PgUp</kbd></span>, <span class="keyseq"><kbd>Shift</kbd>+<kbd>PgDn</kbd></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Pages back and forward through the scrollback.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Enter</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">In the <strong>Phone Book</strong>, <strong>Session Settings</strong>, <strong>Secure Link Passphrase</strong>, and <strong>Transfer Options</strong> dialog boxes, presses the default button (<b class="button">Connect</b> or <b class="button">OK</b>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><kbd>Esc</kbd></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">In the same dialog boxes, presses <b class="button">Cancel</b>. While a file transfer runs, in the <strong>File Transfer</strong> window or in the Terminal window, cancels the transfer; after the transfer, in the <strong>File Transfer</strong> window, closes it.</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect2">
<h3 id="keys-more"><a class="anchor" href="#keys-more"></a>A.10. Other programs</h3>
<div class="paragraph">
<p>These programs list their keys beside their menus:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>Media Player: <a href="#programs-media-player-menus">Section 8.7.8</a></p>
</li>
<li>
<p>Sound Recorder: <a href="#programs-sound-recorder-menus">Section 8.8.6</a></p>
</li>
<li>
<p>DVX Help: <a href="#programs-help-menus">Section 8.9.7</a></p>
</li>
<li>
<p>Image Viewer: <a href="#programs-image-viewer-menus">Section 8.6.4</a></p>
</li>
<li>
<p>Dialog boxes and the controls in them: <a href="#desktop-dialogs">Section 5.5</a></p>
</li>
<li>
<p>Moving and sizing a window with the keyboard: <a href="#desktop-keyboard-move">Section 5.3.9.1</a></p>
</li>
</ul>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="folders"><a class="anchor" href="#folders"></a>Appendix B: DVX Folders and Settings Files</h2>
<div class="sectionbody">
<div class="paragraph">
<p><a id="_ix1962" class="ixterm"></a><a id="_ix1963" class="ixterm"></a>This appendix describes the folders DVX is installed in, the files in which DVX and its programs keep their settings, and DVX&#8217;s log file. You do not need it to use DVX: Control Panel (see <a href="#controlPanel">Chapter 7</a>) and each program&#8217;s own menus change almost every setting. Read it when you want to back up your settings, keep them somewhere else, change a setting that Control Panel does not offer, go back to the settings DVX came with, or send the log with a problem report.</p>
</div>
<div class="paragraph">
<p>In this appendix, <code>C:\DVX</code> stands for the folder you installed DVX in. If you chose another folder in Setup, use that one instead.</p>
</div>
<div class="sect2">
<h3 id="folders-layout"><a class="anchor" href="#folders-layout"></a>B.1. The DVX folders</h3>
<div class="paragraph">
<p><a id="_ix1964" class="ixterm"></a><a id="_ix1965" class="ixterm"></a>DVX keeps its own files and yours apart. Everything that comes with DVX is in the DVX folder and the folders inside it. Everything that changes while you use DVX, such as your settings, your own fonts and pictures, and the files programs save, is in one folder: the USER folder. To back up everything you have set up, you copy that one folder.</p>
</div>
<div class="sect3">
<h4 id="folders-dvx-folder"><a class="anchor" href="#folders-dvx-folder"></a>B.1.1. The DVX folder</h4>
<div class="paragraph">
<p><a id="_ix1966" class="ixterm"></a>The DVX folder holds these files and folders:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 22.2222%;">
<col style="width: 77.7778%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">File or folder</th>
<th class="tableblock halign-left valign-top">What it holds</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>DVX.EXE</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1967" class="ixterm"></a>DVX itself. This is what you run to start DVX.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>SETUP.EXE</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A copy of Setup, which can remove DVX (see <a href="#installing-remove">Section 3.9</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>SETUP.LST</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1968" class="ixterm"></a>Setup&#8217;s list of the files it installed. Setup uses it to recognise a folder that holds DVX and to remove DVX. Do not delete it.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>SYSTEM</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1969" class="ixterm"></a><a id="_ix1970" class="ixterm"></a>The copies of <code>DVX.INI</code> and <code>ASSOC.INI</code> that come with DVX: DVX makes your own <code>DVX.INI</code> from the first, and adds your file type changes to the second (see <a href="#folders-dvx-ini">Section B.2</a> and <a href="#folders-assoc">Section B.3</a>). DVX&#8217;s tools for the DOS prompt: <code>DVXPKG.EXE</code> (packages), and, with the optional parts that include them, <code>BASCOMP.EXE</code> (DVX BASIC), <code>DVXRES.EXE</code>, and <code>DVXHLPC.EXE</code> (Developer Tools); see <a href="#programs-developer">Section 8.13</a>. The <code>KEYS</code> folder, with the key that proves a package comes from DVX&#8217;s own publisher (see <a href="#addons-signatures">Section 10.8</a>). The <code>PACKAGES</code> folder, with a record of every package that is installed and the files it put there. The picture DVX shows while it starts, <code>SPLASH.RAW</code>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>LIBS</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1971" class="ixterm"></a><a id="_ix1972" class="ixterm"></a>The libraries: parts of DVX that programs share, such as sound, printing, and networking. DVX&#8217;s own are in <code>LIBS\KPUNCH</code>; those an add-on installs are in a folder named after its publisher.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>WIDGETS</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1973" class="ixterm"></a><a id="_ix1974" class="ixterm"></a>The controls that windows are made of, such as buttons, lists, and text boxes. DVX&#8217;s own are in <code>WIDGETS\KPUNCH</code>; those an add-on installs are in a folder named after its publisher.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>APPS</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1975" class="ixterm"></a><a id="_ix1976" class="ixterm"></a>The programs, each in its own folder with its help file and the files it needs. DVX&#8217;s own are in <code>APPS\KPUNCH</code>, for example Notepad in <code>APPS\KPUNCH\NOTEPAD</code>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>SHARED</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1977" class="ixterm"></a><a id="_ix1978" class="ixterm"></a>Files that every program can use, in one folder for each kind (see the next table). Only packages put files here: DVX&#8217;s own files, and those of the add-ons you install.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>USER</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1979" class="ixterm"></a>Your settings and files (see <a href="#folders-user">Section B.1.2</a>). It may be somewhere else if you set DVXUSER (see <a href="#folders-dvxuser">Section B.1.3</a>).</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>The folders inside <code>SHARED</code> are:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 22.2222%;">
<col style="width: 77.7778%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Folder</th>
<th class="tableblock halign-left valign-top">What it holds</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>FONTS</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1980" class="ixterm"></a>Fonts (files ending in <code>.DFN</code>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>SOUNDS</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1981" class="ixterm"></a>Sounds (WAV and VOC files) for the events on Control Panel&#8217;s Sounds page. DVX comes with <code>beep.wav</code>, <code>error.wav</code>, <code>exit.wav</code>, <code>info.wav</code>, <code>question.wav</code>, <code>startup.wav</code>, <code>warning.wav</code>, <code>winclose.wav</code>, and <code>winopen.wav</code>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>THEMES</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1982" class="ixterm"></a>Color themes (files ending in <code>.THM</code>). DVX comes with <code>cde.thm</code>, <code>geos.thm</code>, <code>hotdog.thm</code>, and <code>win31.thm</code>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>WPAPER</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1983" class="ixterm"></a>Desktop pictures (wallpaper). DVX comes with <code>blueglow.jpg</code>, <code>swoop.jpg</code>, and <code>triangle.jpg</code>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>BANKS</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1984" class="ixterm"></a>Instrument banks (OP2 files) and SoundFonts (SF2 and SBK files) for MIDI music. DVX comes with the banks <code>DMXOPL.OP2</code> and <code>DMXOPL3.OP2</code>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>SAVERS</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1985" class="ixterm"></a>Screen savers. DVX comes with <code>blank.app</code> (Blank Screen), <code>marquee.app</code> (Marquee), <code>mystify.app</code> (Mystify), and <code>starfld.app</code> (Starfield).</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix1986" class="ixterm"></a>Files that an add-on installs in these folders go in a folder named after the add-on&#8217;s publisher, for example <code>SHARED\BANKS\KPUNCH</code>. A setting can name such a file as the publisher&#8217;s folder and the file name, for example <code>KPUNCH\DVXGM.SF2</code>.</p>
</div>
<div class="paragraph">
<p><a id="_ix1987" class="ixterm"></a>The folders other than <code>USER</code> are DVX itself. They change when you install, upgrade, or remove DVX or an add-on, and DVX brings the help files in <code>APPS</code> up to date after libraries or controls are added or removed (see <a href="#folders-ini-help">Section B.2.18</a>). An upgrade writes every one of DVX&#8217;s files again, so do not change DVX&#8217;s own files, and put your own fonts, sounds, themes, pictures, instrument banks, and screen savers in the USER folder instead.</p>
</div>
</div>
<div class="sect3">
<h4 id="folders-user"><a class="anchor" href="#folders-user"></a>B.1.2. The USER folder</h4>
<div class="paragraph">
<p><a id="_ix1988" class="ixterm"></a><a id="_ix1989" class="ixterm"></a>The USER folder is <code>C:\DVX\USER</code>, unless you set DVXUSER to name another folder (see <a href="#folders-dvxuser">Section B.1.3</a>). DVX makes it when it is missing. It holds:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 22.2222%;">
<col style="width: 77.7778%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">File or folder</th>
<th class="tableblock halign-left valign-top">What it holds</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>DVX.INI</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1990" class="ixterm"></a>Your DVX settings: the screen mode, the mouse, the colors, the wallpaper, the network, the printer, the sounds, and more. See <a href="#folders-dvx-ini">Section B.2</a>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>ASSOC.INI</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1991" class="ixterm"></a>Your changes to which program opens each kind of file. It is there only after you have changed a file type. See <a href="#folders-assoc">Section B.3</a>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>DVX.LOG</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1992" class="ixterm"></a><a id="_ix1993" class="ixterm"></a>The log file: a record of what DVX did since it last started. See <a href="#folders-log">Section B.6</a>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>PROGRAMS.CAC</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1994" class="ixterm"></a>DVX&#8217;s memory of each program&#8217;s name, description, and icon, so that it need not read every program again at each start. See <a href="#folders-programs-cac">Section B.4.2</a>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>SECLINK.RND</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1995" class="ixterm"></a>A store of random numbers that secure connections use, kept from one session to the next.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>APPS</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1996" class="ixterm"></a><a id="_ix1997" class="ixterm"></a>A folder for each program that keeps settings or files, such as Program Manager&#8217;s groups and Terminal&#8217;s phone book. See <a href="#folders-other">Section B.4</a>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>DOWNLOAD</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1998" class="ixterm"></a>Packages that Software is fetching from the package server, and the files Terminal receives, unless you choose another download folder in Terminal. Software and Terminal make the folder when they need it.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>KEYS</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix1999" class="ixterm"></a>The keys of the publishers you chose to trust, and your own keys made in Package Builder. See <a href="#folders-keys">Section B.4.7</a>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>FONTS</code>, <code>SOUNDS</code>, <code>THEMES</code>, <code>WPAPER</code>, <code>BANKS</code>, <code>SAVERS</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Your own files of each kind (see below).</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>You may also see temporary files in it for a moment; see <a href="#folders-temporary">Section B.4.10</a>.</p>
</div>
<div class="sect4">
<h5 id="folders-own-files"><a class="anchor" href="#folders-own-files"></a>Your own fonts, sounds, themes, pictures, banks, and screen savers</h5>
<div class="paragraph">
<p><a id="_ix2000" class="ixterm"></a><a id="_ix2001" class="ixterm"></a><a id="_ix2002" class="ixterm"></a><a id="_ix2003" class="ixterm"></a><a id="_ix2004" class="ixterm"></a><a id="_ix2005" class="ixterm"></a>To use your own files of these kinds, copy them into a folder of the same name in your USER folder. Make the folder first if it is not there; only <code>THEMES</code> is made for you, the first time you save a theme in Control Panel. DVX looks in your folder first and then in <code>SHARED</code>, and Control Panel&#8217;s lists show the files of both.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 40%;">
<col style="width: 40%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Folder in USER</th>
<th class="tableblock halign-left valign-top">Put in it</th>
<th class="tableblock halign-left valign-top">Where you choose them</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>FONTS</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Fonts (<code>.DFN</code> files). A font of yours with the same family and style as one DVX has is used instead of DVX&#8217;s.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Every program that lets you choose a font.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>SOUNDS</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">WAV and VOC sounds.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Control Panel, Sounds page (<a href="#cpanel-sounds">Section 7.12</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>THEMES</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Color themes (<code>.THM</code> files).</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Control Panel, Colors page (<a href="#cpanel-colors">Section 7.5</a>). <b class="button">Save As&#8230;&#8203;</b> there saves into this folder.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>WPAPER</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Pictures (BMP, JPEG, PNG, and GIF).</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Control Panel, Desktop page (<a href="#cpanel-desktop">Section 7.6</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>BANKS</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Instrument banks (<code>.OP2</code>) and SoundFonts (<code>.SF2</code> and <code>.SBK</code>).</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Control Panel, Sounds page, <strong>Instruments</strong> and <strong>SoundFont</strong> (<a href="#cpanel-sounds">Section 7.12</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>SAVERS</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Screen savers.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Control Panel, Desktop page, <strong>Screen saver</strong> (<a href="#cpanel-desktop">Section 7.6</a>).</p></td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="sect3">
<h4 id="folders-dvxuser"><a class="anchor" href="#folders-dvxuser"></a>B.1.3. Keeping the USER folder somewhere else: DVXUSER</h4>
<div class="paragraph">
<p><a id="_ix2006" class="ixterm"></a><a id="_ix2007" class="ixterm"></a><a id="_ix2008" class="ixterm"></a>DVX normally uses the USER folder inside the DVX folder. To keep your settings and files somewhere else, for example on another disk, or in a separate folder for each person who uses the computer, set the DOS setting DVXUSER to that folder before you start DVX. Put a line like this in <code>AUTOEXEC.BAT</code>:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>SET DVXUSER=D:\MYDVX</pre>
</div>
</div>
<div class="ulist">
<ul>
<li>
<p>DVX uses the folder exactly as you typed it. A folder typed with neither a drive nor a leading backslash is taken from the DVX folder: <code>SET DVXUSER=ANNA</code> means <code>C:\DVX\ANNA</code>.</p>
</li>
<li>
<p>DVX makes the folder, and any folders above it, when they are missing. The first time, it puts a fresh <code>DVX.INI</code> in it (see <a href="#folders-dvx-ini-where">Section B.2.1</a>).</p>
</li>
<li>
<p><a id="_ix2009" class="ixterm"></a><a id="_ix2010" class="ixterm"></a>Setup uses DVXUSER too. When it is set, Setup puts a new installation&#8217;s settings there instead of in <code>C:\DVX\USER</code>; and when you ask Setup to remove your settings (when you remove DVX, or upgrade with <strong>Start over</strong>), it removes that folder, but only if it holds a <code>DVX.INI</code>.</p>
</li>
<li>
<p>If the folder cannot be made or written, DVX does what it does on a disk it cannot write to (see <a href="#folders-read-only">Section B.1.4</a>).</p>
</li>
</ul>
</div>
<div class="paragraph">
<p><a id="_ix2011" class="ixterm"></a><a id="_ix2012" class="ixterm"></a>To give each person their own settings, make a small batch file for each one instead of setting DVXUSER in <code>AUTOEXEC.BAT</code>. For example, <code>ANNA.BAT</code>:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>@ECHO OFF
SET DVXUSER=C:\DVXUSERS\ANNA
C:\DVX\DVX.EXE</pre>
</div>
</div>
<div class="paragraph">
<p>Each person then starts DVX with their own batch file and gets their own settings, Program Manager groups, log file, and saved files.</p>
</div>
</div>
<div class="sect3">
<h4 id="folders-read-only"><a class="anchor" href="#folders-read-only"></a>B.1.4. Running DVX from a disk it cannot write to</h4>
<div class="paragraph">
<p><a id="_ix2013" class="ixterm"></a><a id="_ix2014" class="ixterm"></a><a id="_ix2015" class="ixterm"></a><a id="_ix2016" class="ixterm"></a><a id="_ix2017" class="ixterm"></a>A copy of an installed DVX folder can be run from a disk that DVX cannot write to, such as a CD-ROM you made or a write-protected disk. (The DVX CD itself cannot be run; it holds only Setup and the files it installs.) DVX then cannot use its USER folder:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><a id="_ix2018" class="ixterm"></a>If there is a TEMP folder, DVX keeps your settings and files in a folder named <code>DVXUSER</code> inside it, for example <code>C:\TEMP\DVXUSER</code>, and says once, after the desktop appears: &#8220;DVX is running from a disk it cannot write to, such as a CD-ROM, so your settings are kept in the TEMP folder. To keep them somewhere else, set DVXUSER to a folder on your hard disk before starting DVX.&#8221; The TEMP folder is the one the DOS setting TEMP names (for example <code>SET TEMP=C:\TEMP</code> in <code>AUTOEXEC.BAT</code>), or TMP when TEMP is not set. The first time (when there is no <code>DVX.INI</code> in <code>TEMP\DVXUSER</code> yet), DVX copies there every file of the USER folder on that disk except its <code>DVX.LOG</code>: <code>DVX.INI</code>, the file types (<code>ASSOC.INI</code>), each program&#8217;s settings in <code>USER\APPS</code>, such as Program Manager&#8217;s groups, and your own files, such as fonts, themes, sounds, and wallpapers. So DVX starts with the same settings and files as it does without a TEMP folder. Without a <code>DVX.INI</code> in that USER folder, the one there starts as a copy of <code>SYSTEM\DVX.INI</code>. Later starts copy nothing again: your changes in <code>TEMP\DVXUSER</code> stay.</p>
</li>
<li>
<p><a id="_ix2019" class="ixterm"></a>If there is no TEMP folder either, DVX says: &#8220;DVX cannot save anything: it is running from a disk it cannot write to, such as a CD-ROM, and there is no TEMP folder. Settings you change are kept until you exit DVX. To keep them, set DVXUSER to a folder on your hard disk before starting DVX, or install DVX with SETUP.&#8221; Settings you change then last only until you exit DVX. DVX makes no copy of the settings that come with it: it uses the settings already in the USER folder on that disk (or in the folder DVXUSER names), if there are any, without saving changes to them, and without a <code>DVX.INI</code> there it starts with its built-in settings (640 x 480, no Welcome window, and no desktop sounds). There is no log file (see <a href="#folders-log">Section B.6</a>). <a id="_ix2020" class="ixterm"></a>The first change you save after the desktop is up brings a reminder, once each time DVX runs: &#8220;Your changes cannot be saved to disk, so they last only until you exit DVX. To keep them, set DVXUSER to a folder DVX can write to before starting DVX.&#8221;</p>
</li>
</ul>
</div>
<div class="paragraph">
<p><a id="_ix2021" class="ixterm"></a><a id="_ix2022" class="ixterm"></a>The same happens when DVXUSER names a folder DVX cannot write to, and the messages then name that folder: &#8220;DVX cannot write to <em>folder</em>, the folder DVXUSER names, so your settings are kept in the TEMP folder. To keep them somewhere else, set DVXUSER to a folder DVX can write to before starting DVX.&#8221;, or, without a TEMP folder, &#8220;DVX cannot save anything: it cannot write to <em>folder</em>, the folder DVXUSER names, and there is no TEMP folder. Settings you change are kept until you exit DVX. To keep them, set DVXUSER to a folder DVX can write to before starting DVX.&#8221;</p>
</div>
<div class="paragraph">
<p>On such a disk DVX also uses the help files as they are, without bringing them up to date.</p>
</div>
<div class="paragraph">
<p>To keep your settings on your hard disk, set DVXUSER to a folder there (see <a href="#folders-dvxuser">Section B.1.3</a>), or install DVX with Setup.</p>
</div>
</div>
<div class="sect3">
<h4 id="folders-backup"><a class="anchor" href="#folders-backup"></a>B.1.5. Backing up your settings and files</h4>
<div class="paragraph">
<p><a id="_ix2023" class="ixterm"></a><a id="_ix2024" class="ixterm"></a>Everything you have set up in DVX is in the USER folder, so to back it up, copy that folder. Do it with DVX not running, so that no file is being saved while you copy:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Exit DVX.</p>
</li>
<li>
<p>At the DOS prompt, make a folder for the copy and copy the USER folder into it, with all its folders. For example, to copy it to drive D:</p>
<div class="listingblock">
<div class="content">
<pre>MD D:\DVXBACK
XCOPY C:\DVX\USER D:\DVXBACK /S /E</pre>
</div>
</div>
<div class="paragraph">
<p>If you set DVXUSER, copy the folder it names instead.</p>
</div>
</li>
</ol>
</div>
<div class="paragraph">
<p><a id="_ix2025" class="ixterm"></a>To put the copy back later, exit DVX and copy it the other way:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>XCOPY D:\DVXBACK C:\DVX\USER /S /E</pre>
</div>
</div>
<div class="paragraph">
<p><a id="_ix2026" class="ixterm"></a>You can move your settings to another computer the same way. If that computer&#8217;s video card has no mode as large as the screen mode you saved, DVX starts there in safe video mode and asks whether to use that mode from now on (see <a href="#installing-safe-start">Section 3.13</a>).</p>
</div>
<div class="admonitionblock tip">
<table>
<tr>
<td class="icon">
<div class="title">Tip</div>
</td>
<td class="content">
<a id="_ix2027" class="ixterm"></a>Setup never changes the USER folder when it upgrades DVX, unless you tick <strong>Start over</strong>, and it removes the USER folder only when you ask it to (see <a href="#installing-upgrade">Section 3.8</a> and <a href="#installing-remove">Section 3.9</a>). A backup is still worth having before you do either.
</td>
</tr>
</table>
</div>
</div>
</div>
<div class="sect2">
<h3 id="folders-dvx-ini"><a class="anchor" href="#folders-dvx-ini"></a>B.2. DVX.INI, the settings file</h3>
<div class="paragraph">
<p><a id="_ix2028" class="ixterm"></a><a id="_ix2029" class="ixterm"></a><code>DVX.INI</code> holds DVX&#8217;s own settings: almost everything you set in Control Panel, the package server you use in Software, whether the Welcome window appears, and some sound and game controller settings that are not in Control Panel. It is a plain text file, which you can read and change with any text editor.</p>
</div>
<div class="sect3">
<h4 id="folders-dvx-ini-where"><a class="anchor" href="#folders-dvx-ini-where"></a>B.2.1. Where DVX.INI is and how it is made</h4>
<div class="paragraph">
<p><a id="_ix2030" class="ixterm"></a><a id="_ix2031" class="ixterm"></a>DVX reads and saves only the <code>DVX.INI</code> in your USER folder: <code>C:\DVX\USER\DVX.INI</code>, or the one in the folder DVXUSER names, or the one in <code>TEMP\DVXUSER</code> on a disk DVX cannot write to (see <a href="#folders-layout">Section B.1</a>). The first time DVX uses <code>TEMP\DVXUSER</code>, it copies there the <code>DVX.INI</code> of the USER folder it cannot write to, if that has one, with every other file of that folder but its log (see <a href="#folders-read-only">Section B.1.4</a>).</p>
</div>
<div class="paragraph">
<p><a id="_ix2032" class="ixterm"></a><a id="_ix2033" class="ixterm"></a>The copy in the <code>SYSTEM</code> folder, <code>C:\DVX\SYSTEM\DVX.INI</code>, is the one that comes with DVX. It has comments that explain most settings. DVX never changes it and never reads it for settings: each time DVX starts and finds no <code>DVX.INI</code> in your USER folder, it copies the one from <code>SYSTEM</code> there, comments and all. So deleting your <code>DVX.INI</code> gives you the settings DVX came with at the next start (see <a href="#folders-defaults">Section B.5</a>). Changing <code>SYSTEM\DVX.INI</code> has no effect until such a copy is made, and an upgrade replaces that file.</p>
</div>
<div class="paragraph">
<p><a id="_ix2034" class="ixterm"></a><a id="_ix2035" class="ixterm"></a>Setup makes the first copy when it installs DVX (or when you upgrade with <strong>Start over</strong>), and then writes into it the screen mode Setup itself ran in: 640 x 480 with 65 thousand colors, or, on a card without that mode, the mode DVX chose instead (see <a href="#folders-ini-video">Section B.2.5</a>). So a new installation starts in that mode, not in the 1024 x 768 that <code>SYSTEM\DVX.INI</code> asks for.</p>
</div>
<div class="paragraph">
<p>When nothing can be saved at all (no writable USER folder and no TEMP folder), DVX makes no copy of <code>SYSTEM\DVX.INI</code>: it reads the <code>DVX.INI</code> already in the USER folder, if there is one, and otherwise every setting takes its built-in default, given in the tables below, not the value in <code>SYSTEM\DVX.INI</code>.</p>
</div>
</div>
<div class="sect3">
<h4 id="folders-dvx-ini-editing"><a class="anchor" href="#folders-dvx-ini-editing"></a>B.2.2. Changing DVX.INI by hand</h4>
<div class="paragraph">
<p><a id="_ix2036" class="ixterm"></a><a id="_ix2037" class="ixterm"></a>Most settings are easier and safer to change in Control Panel. Change <code>DVX.INI</code> by hand only for a setting Control Panel does not have, or to fix a setting that stops DVX from working. The safest way is with DVX not running:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Exit DVX.</p>
</li>
<li>
<p><a id="_ix2038" class="ixterm"></a>Make a copy of the file, so you can go back to it:</p>
<div class="listingblock">
<div class="content">
<pre>COPY C:\DVX\USER\DVX.INI C:\DVX\USER\DVXINI.BAK</pre>
</div>
</div>
</li>
<li>
<p>Open the file in a text editor, for example DOS&#8217;s EDIT:</p>
<div class="listingblock">
<div class="content">
<pre>EDIT C:\DVX\USER\DVX.INI</pre>
</div>
</div>
</li>
<li>
<p>Find the section (the line in square brackets, such as <code>[mouse]</code>) and change the value after the <code>=</code> on the key&#8217;s line. To add a key that is not there, type it on a new line under its section&#8217;s line. To add a section that is not there, type its line at the end of the file, with its keys under it.</p>
</li>
<li>
<p>Save the file and leave the editor.</p>
</li>
<li>
<p>Start DVX.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p><a id="_ix2039" class="ixterm"></a><a id="_ix2040" class="ixterm"></a>You can also edit <code>DVX.INI</code> while DVX is running, in Notepad (see <a href="#programs-notepad">Section 8.4</a>). Keep these points in mind:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>Most sections are read only when DVX starts, so most changes take effect the next time DVX starts. The table below says when each section is read.</p>
</li>
<li>
<p>Control Panel saves only the settings you change in it, so the keys you edit by hand stay as you wrote them, even if Control Panel was open while you edited, unless you then change the same setting in Control Panel. Until DVX restarts, Control Panel shows the mouse, colors, wallpaper, screen saver, text smoothing, and screen mode DVX is using, not what you typed.</p>
</li>
</ul>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 28.5714%;">
<col style="width: 71.4286%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Section</th>
<th class="tableblock halign-left valign-top">A change by hand takes effect</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[video]</code>, <code>[mouse]</code>, <code>[shell]</code>, <code>[colors]</code>, <code>[desktop]</code>, <code>[fonts]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The next time DVX starts.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[network]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The next time DVX starts. (The network starts the first time a program uses it and keeps running until you exit DVX.)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[packages]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The next time Software starts.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[printer]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">At the next printout. DVX reads this section each time you print, open the <strong>Print</strong> dialog, or open <strong>Page Setup</strong>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[audio]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Mostly the next time DVX starts; a few keys at the next piece of music. See <a href="#folders-ini-audio">Section B.2.11</a>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[sounds]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The next time DVX starts.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[joystick]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The next time DVX starts. (DVX reads it the first time a program or Control Panel uses a game controller.)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[help]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Do not change it. See <a href="#folders-ini-help">Section B.2.18</a>.</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect3">
<h4 id="folders-dvx-ini-format"><a class="anchor" href="#folders-dvx-ini-format"></a>B.2.3. How DVX reads and saves the file</h4>
<div class="paragraph">
<p><a id="_ix2041" class="ixterm"></a><a id="_ix2042" class="ixterm"></a>These rules apply to <code>DVX.INI</code> and to every other settings file DVX and its programs use (<code>ASSOC.INI</code>, theme files, and the programs' own settings files):</p>
</div>
<div class="ulist">
<ul>
<li>
<p>A line with a name in square brackets, such as <code>[mouse]</code>, starts a section. The settings after it, up to the next section&#8217;s line, belong to it.</p>
</li>
<li>
<p>A setting is a line <code>key = value</code>. Spaces around the key and the value do not matter.</p>
</li>
<li>
<p><a id="_ix2043" class="ixterm"></a>A line that starts with <code>;</code> or <code>#</code> is a comment, which DVX ignores. A comment must have the whole line to itself: text after a value on the same line is part of the value, so <code>speed = 8 ; faster</code> does not work as you might expect. Blank lines are ignored.</p>
</li>
<li>
<p>Section and key names can be typed in capital or small letters: <code>[MOUSE]</code> and <code>[mouse]</code> are the same, and so are <code>doubleClick</code> and <code>doubleclick</code>. If a key appears twice in a section, DVX uses the first one.</p>
</li>
<li>
<p><a id="_ix2044" class="ixterm"></a>For a setting that is on or off, write <code>true</code>, <code>yes</code>, or <code>1</code> for on, and <code>false</code>, <code>no</code>, or <code>0</code> for off, in capital or small letters.</p>
</li>
<li>
<p>For a number, write the number in decimal, unless the tables below say otherwise. Text after it is ignored, so <code>9600 baud</code> reads as 9600.</p>
</li>
<li>
<p>For a setting with a list of choices, write one of the words the tables below give, in capital or small letters.</p>
</li>
<li>
<p><a id="_ix2045" class="ixterm"></a>A value DVX does not understand counts as missing. A missing setting takes its built-in default, given in the tables below, and every other setting works as usual. Where a value is understood but out of range, the tables say what DVX does with it.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p><a id="_ix2046" class="ixterm"></a>When DVX or Control Panel saves the file, it changes only the lines of the settings that changed, and keeps everything else as it was: your comments, keys DVX does not know, and your spacing. A changed setting is written as <code>key = value</code>. A new setting goes after the last setting of its section, and a new section is added at the end of the file. Program Manager, Terminal, Media Player, and Sound Recorder are different: each writes its own settings file whole every time it saves, so comments and keys it does not know are not kept in that file.</p>
</div>
<div class="paragraph">
<p><a id="_ix2047" class="ixterm"></a>DVX saves a settings file in a way that cannot leave it half written: it writes the new file under another name first, and puts it in place only when it is complete. If the disk is full, the old file stays as it was. While it saves, you may see the files <code>DVX.$IN</code> and <code>DVX.~IN</code> beside <code>DVX.INI</code> for a moment; see <a href="#folders-temporary">Section B.4.10</a>.</p>
</div>
<div class="paragraph">
<p><a id="_ix2048" class="ixterm"></a>If <code>DVX.INI</code> is there but cannot be read, for example because of a disk error, DVX uses its built-in settings, and never saves over the file, so your settings are not replaced by defaults. Settings you change are then not saved until the file can be read again, or you delete it.</p>
</div>
</div>
<div class="sect3">
<h4 id="folders-dvx-ini-sections"><a class="anchor" href="#folders-dvx-ini-sections"></a>B.2.4. The sections of DVX.INI</h4>
<div class="paragraph">
<p><a id="_ix2049" class="ixterm"></a>The <code>DVX.INI</code> that comes with DVX has the sections <code>[video]</code>, <code>[mouse]</code>, <code>[shell]</code>, <code>[network]</code>, <code>[packages]</code>, <code>[printer]</code>, <code>[audio]</code>, and <code>[sounds]</code>, in that order, each with a comment above it. Control Panel and DVX add the other sections when they first save them.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 15.3846%;">
<col style="width: 30.7692%;">
<col style="width: 23.0769%;">
<col style="width: 30.7693%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Section</th>
<th class="tableblock halign-left valign-top">What it holds</th>
<th class="tableblock halign-left valign-top">In the file DVX comes with</th>
<th class="tableblock halign-left valign-top">Set by</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#folders-ini-video"><code>[video]</code></a></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The screen mode.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Yes</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Control Panel, Video page; Setup; the safe video mode question.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#folders-ini-mouse"><code>[mouse]</code></a></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The mouse.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Yes</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Control Panel, Mouse page.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#folders-ini-shell"><code>[shell]</code></a></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The desktop program and the Welcome window.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Yes</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The Welcome window.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#folders-ini-network"><code>[network]</code></a></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The network.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Yes</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Control Panel, Network page.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#folders-ini-packages"><code>[packages]</code></a></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The package server.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Yes</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Software, Package Server window.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#folders-ini-printer"><code>[printer]</code></a></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The printer and the page setup.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Yes</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Control Panel, Printer page; the Page Setup dialog.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#folders-ini-audio"><code>[audio]</code></a></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The sound hardware and music.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Yes</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Control Panel, Sounds page; some keys only by hand.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#folders-ini-sounds"><code>[sounds]</code></a></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The sound for each event.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Yes</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Control Panel, Sounds page.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#folders-ini-colors"><code>[colors]</code></a></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The screen colors.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No; added the first time you click <b class="button">OK</b> in Control Panel</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Control Panel, Colors page.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#folders-ini-desktop"><code>[desktop]</code></a></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The wallpaper and the screen saver.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No; added the first time you click <b class="button">OK</b> in Control Panel</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Control Panel, Desktop page.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#folders-ini-fonts"><code>[fonts]</code></a></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Text smoothing.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No; added the first time you click <b class="button">OK</b> in Control Panel</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Control Panel, Video page.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#folders-ini-joystick"><code>[joystick]</code></a></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Game controllers.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No; added when Control Panel saves it</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Control Panel, Game Controllers page; some keys only by hand.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#folders-ini-help"><code>[help]</code></a></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX&#8217;s own notes about its help files.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No; added by DVX when it starts</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX itself. Do not change it.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>In the tables that follow, <strong>Default</strong> is the value DVX uses when the key is missing or its value is not understood, which is not always the value in the file DVX comes with; where they differ, the table says so.</p>
</div>
</div>
<div class="sect3">
<h4 id="folders-ini-video"><a class="anchor" href="#folders-ini-video"></a>B.2.5. The <code>[video]</code> section: screen mode</h4>
<div class="paragraph">
<p><a id="_ix2050" class="ixterm"></a><a id="_ix2051" class="ixterm"></a>The screen mode DVX uses. <strong>When a change takes effect:</strong> a change by hand, the next time DVX starts; Control Panel changes the mode at once.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 15.3846%;">
<col style="width: 46.1538%;">
<col style="width: 15.3846%;">
<col style="width: 23.077%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">Values</th>
<th class="tableblock halign-left valign-top">Default</th>
<th class="tableblock halign-left valign-top">Set by</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>width</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2052" class="ixterm"></a>The width of the screen in dots (pixels), such as <code>640</code>, <code>800</code>, or <code>1024</code>. The file DVX comes with has <code>1024</code>.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>640</code></p></td>
<td class="tableblock halign-left valign-top" rowspan="3"><p class="tableblock">Control Panel, Video page, <strong>Available Video Modes</strong> (<a href="#cpanel-video">Section 7.7</a>), when you choose a mode there and click <b class="button">OK</b>; the safe video mode question when DVX starts; Setup.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>height</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2053" class="ixterm"></a>The height of the screen in dots, such as <code>480</code>, <code>600</code>, or <code>768</code>. The file DVX comes with has <code>768</code>.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>480</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>bpp</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2054" class="ixterm"></a><a id="_ix2055" class="ixterm"></a>How many colors, as bits per dot: <code>8</code> (256 colors), <code>15</code> (32 thousand), <code>16</code> (65 thousand), or <code>32</code> (16 million).</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>16</code></p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix2056" class="ixterm"></a>DVX chooses among the modes your video card offers:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>It never uses a mode smaller than <code>width</code> and <code>height</code>.</p>
</li>
<li>
<p>When the card has the number of colors <code>bpp</code> asks for at exactly that size, DVX uses that mode. When it has that number of colors only at a larger size, DVX uses the larger mode, with one exception: with <code>bpp = 8</code>, a mode of exactly that size with 65 thousand colors is used instead (and one with 32 thousand colors may be, depending on the card).</p>
</li>
<li>
<p>Otherwise, and for any other number, DVX chooses among the modes the card has, preferring 65 thousand colors, then 32 thousand, 16 million, and 256, and preferring the exact size to a larger one. DVX never uses the card&#8217;s 24-bit modes, so <code>bpp = 24</code> gets one of the others.</p>
</li>
<li>
<p><a id="_ix2057" class="ixterm"></a>If the card has no mode as large as <code>width</code> and <code>height</code>, or the mode does not work, DVX starts in safe video mode (640 x 480) and asks whether to use that mode from now on. <b class="button">Yes</b> writes the safe mode into this section; <b class="button">No</b> leaves it, so DVX tries the saved mode again at the next start. See <a href="#installing-safe-start">Section 3.13</a>.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>Control Panel&#8217;s list of modes offers only 640 x 480 and larger.</p>
</div>
</div>
<div class="sect3">
<h4 id="folders-ini-mouse"><a class="anchor" href="#folders-ini-mouse"></a>B.2.6. The <code>[mouse]</code> section</h4>
<div class="paragraph">
<p><a id="_ix2058" class="ixterm"></a><a id="_ix2059" class="ixterm"></a>How the mouse works. <strong>When a change takes effect:</strong> a change by hand, the next time DVX starts; Control Panel&#8217;s changes at once. All five keys are set on Control Panel&#8217;s Mouse page (<a href="#cpanel-mouse">Section 7.4</a>).</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 15.3846%;">
<col style="width: 46.1538%;">
<col style="width: 15.3846%;">
<col style="width: 23.077%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">Values</th>
<th class="tableblock halign-left valign-top">Default</th>
<th class="tableblock halign-left valign-top">Set by</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>wheel</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2060" class="ixterm"></a><code>normal</code>, or <code>reversed</code> to make the scroll wheel scroll the other way.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>normal</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Scroll Wheel</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>wheelspeed</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2061" class="ixterm"></a>How many lines one notch of the wheel scrolls, from 1 to 10. A smaller number counts as 1, a larger one as 10.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>3</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Scroll Speed</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>doubleclick</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2062" class="ixterm"></a>The most time, in milliseconds (thousandths of a second), between the two clicks of a double-click. Control Panel&#8217;s slider offers 200 to 900; DVX uses whatever number is written here.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>500</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Double-Click Speed</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>acceleration</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2063" class="ixterm"></a><code>off</code>, <code>low</code>, <code>medium</code>, or <code>high</code>: how much farther the pointer travels when you move the mouse quickly.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>medium</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Acceleration</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>speed</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2064" class="ixterm"></a><a id="_ix2065" class="ixterm"></a>How far you must move the mouse to move the pointer: a smaller number makes the pointer faster. DVX hands the number to the mouse driver as it is; <code>0</code> or less leaves the mouse driver&#8217;s own setting. Control Panel&#8217;s slider runs the other way: the number it shows is 34 minus this one, so its 2 to 32 covers speeds 32 to 2, and the slider&#8217;s 26 is a speed of 8.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>8</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Cursor Speed</strong></p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>The scroll wheel settings need a mouse driver that supports a wheel (see <a href="#cpanel-mouse">Section 7.4</a>).</p>
</div>
</div>
<div class="sect3">
<h4 id="folders-ini-shell"><a class="anchor" href="#folders-ini-shell"></a>B.2.7. The <code>[shell]</code> section: the desktop and the Welcome window</h4>
<div class="paragraph">
<p><a id="_ix2066" class="ixterm"></a>What DVX starts when it starts. <strong>When a change takes effect:</strong> the next time DVX starts. Control Panel has no setting for these keys.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 15.3846%;">
<col style="width: 46.1538%;">
<col style="width: 15.3846%;">
<col style="width: 23.077%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">Values</th>
<th class="tableblock halign-left valign-top">Default</th>
<th class="tableblock halign-left valign-top">Set by</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>desktop</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2067" class="ixterm"></a>The program DVX opens as its desktop, as a path from the DVX folder: <code>apps/kpunch/progman/progman.app</code>, Program Manager. <strong>Do not change it</strong> (see below).</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Program Manager</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No program DVX comes with.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>welcome</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2068" class="ixterm"></a><a id="_ix2069" class="ixterm"></a>A program DVX starts each time, once the desktop is up. It can be followed by what to give the program, and it can also name a document (which opens in its program) or a DOS program. Empty: nothing is started. The file DVX comes with has <code>apps/kpunch/welcome/welcome.app</code>, the Welcome window.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">None</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The Welcome window (<a href="#programs-welcome">Section 8.10</a>).</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix2070" class="ixterm"></a><a id="_ix2071" class="ixterm"></a>The <code>desktop</code> key names Program Manager, which is DVX&#8217;s desktop: closing it exits DVX. If the key names a file that is missing or is not a DVX program, DVX shows an error message, such as &#8220;Failed to load <em>name</em>:&#8221; followed by the reason, and then ends. To fix it, edit <code>DVX.INI</code> at the DOS prompt and delete the <code>desktop</code> line, or put it back as <code>desktop = apps/kpunch/progman/progman.app</code>.</p>
</div>
<div class="paragraph">
<p><a id="_ix2072" class="ixterm"></a>The Welcome window changes the <code>welcome</code> key when you close it: with <strong>Don&#8217;t show this again</strong> ticked, it removes the key, so Welcome does not appear again; with the box cleared, it writes its own path, so it appears at every start. The box is ticked when the window opens, so closing Welcome without touching the box stops it from appearing. To see Welcome again, start it from Program Manager&#8217;s <strong>Installed Programs</strong> group.</p>
</div>
</div>
<div class="sect3">
<h4 id="folders-ini-network"><a class="anchor" href="#folders-ini-network"></a>B.2.8. The <code>[network]</code> section</h4>
<div class="paragraph">
<p><a id="_ix2073" class="ixterm"></a><a id="_ix2074" class="ixterm"></a>The network settings, used when the Networking part of DVX is installed (see <a href="#net-setup">Section 4.4</a>). <strong>When a change takes effect:</strong> a change by hand, the next time DVX starts; when you click <b class="button">OK</b> in Control Panel after changing the Network page, the network restarts at once with the new settings. All the keys are set on Control Panel&#8217;s Network page (<a href="#cpanel-network">Section 7.9</a>).</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 15.3846%;">
<col style="width: 46.1538%;">
<col style="width: 15.3846%;">
<col style="width: 23.077%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">Values</th>
<th class="tableblock halign-left valign-top">Default</th>
<th class="tableblock halign-left valign-top">Set by</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>dhcp</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2075" class="ixterm"></a><code>true</code>: a DHCP server on the network gives DVX its address, subnet mask, gateway, and name servers, and <code>address</code>, <code>netmask</code>, and <code>gateway</code> are not used. <code>false</code>: DVX uses those three.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Get the address automatically (DHCP)</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>address</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2076" class="ixterm"></a>This computer&#8217;s address on the network, such as <code>192.168.1.10</code>. Used only when <code>dhcp</code> is <code>false</code>.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Empty</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Address</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>netmask</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2077" class="ixterm"></a>The subnet mask, such as <code>255.255.255.0</code>. Used only when <code>dhcp</code> is <code>false</code>.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Empty</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Subnet mask</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>gateway</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2078" class="ixterm"></a>The address of the router to other networks and the Internet. Used only when <code>dhcp</code> is <code>false</code>. It may be empty; then only the local network can be reached.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Empty</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Gateway</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>dns1</code>, <code>dns2</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2079" class="ixterm"></a><a id="_ix2080" class="ixterm"></a>The addresses of up to two name servers. With DHCP, a name server written here is used in place of the one the DHCP server gives, and an empty one leaves the DHCP server&#8217;s. Without DHCP and with both empty, names such as <code>bbs.example.org</code> cannot be looked up. A value that is not an address is ignored.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Empty</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Name server 1</strong>, <strong>Name server 2</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>hostname</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2081" class="ixterm"></a><a id="_ix2082" class="ixterm"></a>This computer&#8217;s name, which DVX gives the DHCP server: letters, digits, and hyphens, not starting or ending with a hyphen, at most 63 characters (a longer name is cut short). If the key is there but empty, the name is empty.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>DVX</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Computer name</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>vector</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2083" class="ixterm"></a><a id="_ix2084" class="ixterm"></a><code>auto</code>: DVX looks for the packet driver at interrupts 0x60 to 0x80. Or the one interrupt your packet driver uses, from <code>0x60</code> to <code>0x80</code>. Always write it with <code>0x</code> in front: without it the number is read as decimal, so <code>60</code> is not <code>0x60</code>. A value that is not a number counts as <code>auto</code>. With a number outside 0x60 to 0x80, DVX finds no packet driver, and the log says so; Control Panel&#8217;s <strong>Packet driver</strong> list shows the number with &#8220;(cannot be used)&#8221; after it.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>auto</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Packet driver</strong></p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix2085" class="ixterm"></a>When <code>dhcp</code> is <code>false</code> and <code>address</code> or <code>netmask</code> is not a valid address (or <code>gateway</code> is neither empty nor a valid address), the network does not start at all, so no program can use it. Control Panel checks these values, and <code>vector</code> too: if one typed into <code>DVX.INI</code> by hand is not valid, clicking <b class="button">OK</b> in Control Panel shows a warning box titled <strong>Network</strong>, even if you changed another page, until you correct it on the Network page (see <a href="#cpanel-network">Section 7.9</a>). When Control Panel saves a value you changed, it writes it in its own way, for example the interrupt as <code>0x60</code>; values you did not change stay as you wrote them.</p>
</div>
</div>
<div class="sect3">
<h4 id="folders-ini-packages"><a class="anchor" href="#folders-ini-packages"></a>B.2.9. The <code>[packages]</code> section: the package server</h4>
<div class="paragraph">
<p><a id="_ix2086" class="ixterm"></a><a id="_ix2087" class="ixterm"></a>The package server Software gets packages and updates from, and your account there for publishing packages (see <a href="#addons-server">Section 10.6</a>). <strong>When a change takes effect:</strong> a change by hand, the next time Software starts. All four keys are set in Software&#8217;s <strong>Package Server</strong> window (<span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Package Server&#8230;&#8203;</b></span>), and saved together when you click <b class="button">OK</b> there.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 15.3846%;">
<col style="width: 46.1538%;">
<col style="width: 15.3846%;">
<col style="width: 23.077%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">Values</th>
<th class="tableblock halign-left valign-top">Default</th>
<th class="tableblock halign-left valign-top">Set by</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>server</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2088" class="ixterm"></a>The server&#8217;s name, such as <code>packages.dvxgui.com</code>, at most 127 characters. A <code>http://</code> in front and slashes at the end are removed. When the key is missing or empty, Software uses DVX&#8217;s own package server, <code>packages.dvxgui.com</code>. When you choose DVX&#8217;s own server in the <strong>Package Server</strong> window, Software saves this key empty, so that if DVX&#8217;s own server ever moves, a newer DVX&#8217;s address for it is used. A server written with <code>https://</code> in front cannot be reached: DVX has no encryption.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX&#8217;s own server</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Address</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>port</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2089" class="ixterm"></a>The server&#8217;s port, from 1 to 65535. A key that is missing, empty, not a number, or out of range means 80, so a server of your own without a port uses 80. Software saves port 80 as empty.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>80</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Port</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>user</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2090" class="ixterm"></a>The email address of your account on the server, needed only to publish packages. At most 127 characters.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Empty (no account)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Email</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>password</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2091" class="ixterm"></a><a id="_ix2092" class="ixterm"></a>The account&#8217;s password, at most 127 characters. Software saves it scrambled, as a <code>*</code> followed by digits and letters that change at every save. Scrambled is not locked: anyone with DVX can read it back. A password you type here by hand is used as it is, and scrambled the next time Software saves the settings. (A password typed by hand that is a <code>*</code> followed by an even number, eight or more, of the digits 0 to 9 and the letters A to F (in capital or small letters) looks like a scrambled one, and does not work.)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Empty</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Password</strong></p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect3">
<h4 id="folders-ini-printer"><a class="anchor" href="#folders-ini-printer"></a>B.2.10. The <code>[printer]</code> section</h4>
<div class="paragraph">
<p><a id="_ix2093" class="ixterm"></a><a id="_ix2094" class="ixterm"></a>The printer every program prints to, and the page setup for printing text. <strong>When a change takes effect:</strong> at the next printout; DVX reads this section each time you print, open the <strong>Print</strong> dialog, or open <strong>Page Setup</strong>, so no restart is needed.</p>
</div>
<div class="paragraph">
<p>The first five keys are set on Control Panel&#8217;s Printer page (<a href="#cpanel-printer">Section 7.10</a>). The others are the page setup, set in the <strong>Page Setup</strong> dialog, which you open with <b class="button">Page Setup&#8230;&#8203;</b> on the Printer page or with <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Page Setup&#8230;&#8203;</b></span> in Notepad; its <b class="button">OK</b> saves them at once. The <strong>Print to</strong> and <strong>File name</strong> you choose in a <strong>Print</strong> dialog are for that one printout only, and are not saved.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 15.3846%;">
<col style="width: 46.1538%;">
<col style="width: 15.3846%;">
<col style="width: 23.077%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">Values</th>
<th class="tableblock halign-left valign-top">Default</th>
<th class="tableblock halign-left valign-top">Set by</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>port</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2095" class="ixterm"></a><a id="_ix2096" class="ixterm"></a>Where the printer is connected: <code>LPT1</code>, <code>LPT2</code>, <code>LPT3</code>, <code>COM1</code>, <code>COM2</code>, <code>COM3</code>, <code>COM4</code>, or <code>FILE</code> to print into a file.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>LPT1</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Connected to</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>file</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2097" class="ixterm"></a><a id="_ix2098" class="ixterm"></a>The file printouts go into when <code>port</code> is <code>FILE</code>, at most 259 characters. A name without a folder is in your USER folder (so <code>PRINTER.PRN</code> is <code>C:\DVX\USER\PRINTER.PRN</code>); give a whole path, such as <code>C:\PRINTOUT.PRN</code>, to put it elsewhere. Each printout replaces the file.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>PRINTER.PRN</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>File name</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>model</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2099" class="ixterm"></a><a id="_ix2100" class="ixterm"></a>The kind of printer, one of the words in the next table.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>text</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Printer model</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>baud</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2101" class="ixterm"></a><a id="_ix2102" class="ixterm"></a>A serial printer&#8217;s speed: exactly <code>300</code>, <code>1200</code>, <code>2400</code>, <code>4800</code>, <code>9600</code>, <code>19200</code>, or <code>38400</code>. Any other number counts as 9600. The port always sends 8 data bits, no parity, and 1 stop bit.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>9600</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Speed (baud)</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>handshake</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2103" class="ixterm"></a>How a serial printer tells the computer to wait: <code>none</code>, <code>xonxoff</code> (XON / XOFF characters), <code>rtscts</code> (the printer&#8217;s ready line wired to CTS), or <code>dtrdsr</code> (wired to DSR, as Apple&#8217;s ImageWriter cable does).</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>dtrdsr</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Handshake</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>linesPerPage</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2104" class="ixterm"></a>How many lines fit on a sheet: <code>0</code>, or 10 to 200. <code>0</code> means the printer&#8217;s usual page length: 66 lines for <code>text</code>, the Epsons, and the ImageWriters, and 60 for the LaserJets, the DeskJets, and PostScript.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>0</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Lines per page</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>columns</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2105" class="ixterm"></a>How many characters fit across a sheet, from 20 to 255.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>80</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Characters per line</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>marginTop</code>, <code>marginBottom</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2106" class="ixterm"></a>Blank lines at the top and the bottom of each page. The header prints in the middle line of the top margin, the footer in the middle line of the bottom margin; with a margin of 0 there is none.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>3</code> each</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Top margin (lines)</strong>, <strong>Bottom margin (lines)</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>marginLeft</code>, <code>marginRight</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Blank characters at the left and the right of each line.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>5</code> each</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Left margin</strong>, <strong>Right margin</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>tabWidth</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2107" class="ixterm"></a>How far apart tab stops are, from 1 to 16 characters.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>8</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Tab width</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>wrap</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2108" class="ixterm"></a><code>true</code> continues a line that is too long on the next line, breaking it between words; <code>false</code> cuts it off at the right margin.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Wrap long lines (otherwise they are cut off)</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>header</code>, <code>footer</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2109" class="ixterm"></a><a id="_ix2110" class="ixterm"></a>The line printed at the top and the bottom of each page, with the codes in the table below, at most 79 characters. If the key is there but empty, there is no header (or footer).</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>header</code>: <code>&amp;f</code><br>
<code>footer</code>: <code>Page &amp;p</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Header</strong>, <strong>Footer</strong></p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix2111" class="ixterm"></a>If the file a printout goes into cannot be made, the printout stops with &#8220;Cannot create the file <em>name</em>.&#8221; If <code>port</code> is <code>FILE</code> and <code>file</code> is empty, the <strong>Print</strong> dialog asks for a name.</p>
</div>
<div class="paragraph">
<p><a id="_ix2112" class="ixterm"></a>The page setup is checked as a whole. If any of these is not true, DVX ignores every page setup key, from <code>linesPerPage</code> to <code>footer</code> (including <code>wrap</code>, <code>header</code>, and <code>footer</code>), and uses all their defaults:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><code>linesPerPage</code> is 0 or from 10 to 200.</p>
</li>
<li>
<p><code>columns</code> is from 20 to 255.</p>
</li>
<li>
<p>No margin is less than 0.</p>
</li>
<li>
<p><code>tabWidth</code> is from 1 to 16.</p>
</li>
<li>
<p>The top and bottom margins leave at least 1 line for text (with <code>linesPerPage</code> 0, on a 60-line page).</p>
</li>
<li>
<p>The left and right margins leave at least 10 characters for text.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>The <strong>Page Setup</strong> dialog does not let you save such a setup: it says what is wrong.</p>
</div>
<div class="paragraph">
<p><a id="_ix2113" class="ixterm"></a>The printer models:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 33.3333%;">
<col style="width: 66.6667%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top"><code>model</code></th>
<th class="tableblock halign-left valign-top">Control Panel&#8217;s name</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>text</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Text only (any printer)</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>epson9</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Epson 9-pin (ESC/P)</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>epson24</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Epson 24-pin (ESC/P)</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>laserjet</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>HP LaserJet (PCL)</strong> (prints pictures at 150 dots per inch)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>laserjet300</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>HP LaserJet III or DeskJet (300 dpi)</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>epson9color</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Epson 9-pin color (ESC/P)</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>epson24color</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Epson 24-pin color (ESC/P)</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>deskjet500c</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>HP DeskJet 500C (color)</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>deskjetcolor</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>HP DeskJet 550C and later (color)</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>postscript</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>PostScript</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>postscriptcolor</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>PostScript (color)</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>imagewriter</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Apple ImageWriter II</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>imagewritercolor</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Apple ImageWriter II (color)</strong></p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix2114" class="ixterm"></a>The codes in <code>header</code> and <code>footer</code> are replaced when the page is printed. They must be typed in small letters; any other code, including <code>&amp;F</code> in capitals, prints as it is typed.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 16.6666%;">
<col style="width: 83.3334%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Code</th>
<th class="tableblock halign-left valign-top">Is replaced by</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>&amp;f</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file name.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>&amp;p</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The page number.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>&amp;n</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The number of pages.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>&amp;d</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The date, as YYYY-MM-DD.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>&amp;t</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The time, as HH:MM.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>&amp;l</code>, <code>&amp;c</code>, <code>&amp;r</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Nothing; the text after it goes at the left, the centre, or the right of the line. Text before any of these three is centred.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>&amp;&amp;</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">One <code>&amp;</code>.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>A header or footer too long for the space between the margins is cut short.</p>
</div>
</div>
<div class="sect3">
<h4 id="folders-ini-audio"><a class="anchor" href="#folders-ini-audio"></a>B.2.11. The <code>[audio]</code> section: sound hardware and music</h4>
<div class="paragraph">
<p><a id="_ix2115" class="ixterm"></a><a id="_ix2116" class="ixterm"></a>The sound hardware DVX uses and how it plays music. Control Panel&#8217;s Sounds page (<a href="#cpanel-sounds">Section 7.12</a>) sets <code>driver</code>, <code>volume</code>, <code>midi</code>, <code>midiIn</code>, <code>modules</code>, <code>midiBank</code>, and <code>soundFont</code>, and saves them when you click <b class="button">OK</b>. The other keys can only be changed here.</p>
</div>
<div class="paragraph">
<p><a id="_ix2117" class="ixterm"></a><strong>When a change takes effect:</strong> DVX starts the sound hardware for its first sound, normally the start-up sound, and while the event sounds are on it keeps the hardware running until you exit DVX. So a change to most of these keys may not take effect until the next time DVX starts. A few are read again each time a piece of music starts, as the table says. To be sure a change is used, exit DVX and start it again.</p>
</div>
<div class="paragraph">
<p><a id="_ix2118" class="ixterm"></a>The keys for ports (<code>oplPort</code>, <code>mpuPort</code>, <code>wssPort</code>, and <code>lptPort</code>) take hexadecimal numbers, the way sound card ports are usually written: <code>220</code>, <code>0x220</code>, and <code>220h</code> all mean port 220h. A port key with nothing after the <code>=</code>, or with something that is not a port number, counts as not set: the table gives what DVX then uses.</p>
</div>
<div class="paragraph">
<p><a id="_ix2119" class="ixterm"></a>The keys marked &#8220;optional&#8221; are not in the file DVX comes with. Add one under <code>[audio]</code> only when you need it.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 15.3846%;">
<col style="width: 46.1538%;">
<col style="width: 23.0769%;">
<col style="width: 15.3847%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">Values</th>
<th class="tableblock halign-left valign-top">Default</th>
<th class="tableblock halign-left valign-top">Set by</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>driver</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2120" class="ixterm"></a><a id="_ix2121" class="ixterm"></a>The sound hardware. <code>auto</code> finds it, trying <code>wss</code>, <code>sb</code>, <code>gus</code>, <code>lpt</code>, and <code>speaker</code> in that order; the PC speaker always works, so <code>auto</code> always finds something. Or name one: <code>wss</code> (Windows Sound System), <code>sb</code> (Sound Blaster), <code>gus</code> (Gravis UltraSound), <code>lpt</code> (a sound device on the printer port), <code>speaker</code> (the PC speaker), or <code>null</code> (no sound). If the one named is not installed or does not start, DVX notes it in the log and tries the others, as for <code>auto</code>.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>auto</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Sound driver</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>rate</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2122" class="ixterm"></a>The mixing rate in Hz, from 4000 to 48000; a smaller number counts as 4000, a larger one as 48000. The hardware uses the nearest rate it can, which can be far from this: a printer-port device at most 11,048 Hz (a Disney Sound Source always 7,000 Hz), the PC speaker 22,096 Hz for sampled sound or 11,025 Hz for tones only, and a Gravis UltraSound at most its own rate (see <code>gusVoices</code>).</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>22050</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">By hand only</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>bits</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2123" class="ixterm"></a><code>0</code> (the best the hardware can do), <code>8</code>, or <code>16</code>. Any other number counts as 0. Hardware that cannot play 16 bits plays 8, as the printer-port devices and the PC speaker do. <code>8</code> saves work on a slow computer.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>0</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">By hand only</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>channels</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2124" class="ixterm"></a><code>0</code> (the best the hardware can do), <code>1</code> (mono), or <code>2</code> (stereo). Any other number counts as 0.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>0</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">By hand only</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>voices</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2125" class="ixterm"></a>How many sounds can play at once, from 1 to 32; a number outside counts as the nearest end. When all are playing, a new sound stops the quietest one only if the new one is louder; otherwise the new sound is not played. Music never stops another sound.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>16</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">By hand only</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>volume</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2126" class="ixterm"></a><a id="_ix2127" class="ixterm"></a>The volume of all sound and music, in percent, from 0 to 100; a number outside counts as the nearest end.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>100</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Volume</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>speakerPcm</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2128" class="ixterm"></a><a id="_ix2129" class="ixterm"></a>Only for the PC speaker. <code>true</code> plays sampled sound on it, which takes a lot of the computer&#8217;s time. <code>false</code> plays only tones; sampled sounds and noise are not heard.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>false</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">By hand only</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>fmTones</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2130" class="ixterm"></a><code>true</code> plays square and triangle tones on a free voice of the sound card&#8217;s FM music chip when it has one. <code>false</code> always has the computer make them.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">By hand only</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>midi</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2131" class="ixterm"></a>Where MIDI music plays: <code>auto</code>, <code>mpu401</code>, <code>fm</code>, <code>software</code>, or <code>softwave</code> (see the next table). Read again at each piece of MIDI music, but a change to <code>mpu401</code> needs a restart of DVX.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>auto</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>MIDI music</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>midiIn</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2132" class="ixterm"></a>Where MIDI input from a MIDI keyboard comes from: <code>none</code> or <code>mpu401</code> (see the next table).</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>none</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>MIDI in</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>modules</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2133" class="ixterm"></a>Where music modules (MOD, S3M, XM, and IT files) play: <code>wavetable</code> or <code>software</code> (see the next table). Read again for each module that starts.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>wavetable</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Modules</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>mpuMode</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2134" class="ixterm"></a>What is connected to the MIDI port: <code>gm</code>, <code>mt32</code>, or <code>raw</code> (see the next table). Read again at each piece of music on the MIDI port.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>gm</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">By hand only</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>oplPort</code> (optional)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2135" class="ixterm"></a>The FM music chip&#8217;s port address, in hexadecimal. Only this port is tried. At a wrong port no chip is found, and tones and MIDI music are then made by the computer. When it is not set, or empty, DVX uses 388.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>388</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">By hand only</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>mpuPort</code> (optional)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2136" class="ixterm"></a>The MIDI port&#8217;s address, in hexadecimal. Used only when <code>midi</code> or <code>midiIn</code> is <code>mpu401</code>. When it is not set, or empty, DVX uses 330.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>330</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">By hand only</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>midiBank</code> (optional)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2137" class="ixterm"></a><a id="_ix2138" class="ixterm"></a>The instrument bank (an OP2 file) for MIDI music on the FM chip and in the built-in synthesizer: the name of a file in your <code>USER\BANKS</code> folder or in <code>SHARED\BANKS</code> (yours is looked for first), an add-on&#8217;s bank as its publisher&#8217;s folder and the file name, or a path from the DVX folder. If the file is missing or damaged, DVX uses its standard bank and notes it in the log. Read again at each piece of MIDI music.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX&#8217;s standard bank</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Instruments</strong> (<strong>Standard</strong> removes the key)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>soundFont</code> (optional)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2139" class="ixterm"></a><a id="_ix2140" class="ixterm"></a>The recorded instruments for MIDI music on a Gravis UltraSound, a Sound Blaster AWE, and the built-in SoundFont synthesizer: a SoundFont (<code>.SF2</code> or <code>.SBK</code>), named as for <code>midiBank</code>; or the path of a Gravis UltraSound&#8217;s <code>ULTRASND.INI</code> (its patches); or an AWE&#8217;s own instrument file. If the SoundFont named is missing or damaged, MIDI music plays on the FM chip or in the built-in synthesizer instead. When the key is missing or empty, DVX uses <code>KPUNCH\DVXGM.SF2</code>, its General MIDI SoundFont add-on, and without that add-on the UltraSound&#8217;s patches or the AWE&#8217;s instruments (see <a href="#folders-blaster">Section B.2.12</a>). Read again at each piece of MIDI music.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX&#8217;s General MIDI SoundFont</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>SoundFont</strong> (<strong>Standard</strong> removes the key)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>gusVoices</code> (optional)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2141" class="ixterm"></a><a id="_ix2142" class="ixterm"></a>How many voices a Gravis UltraSound runs, from 14 to 32; a number from 0 to 13 counts as 14, and one above 32 (or below 0) as 32. Fewer voices give a higher output rate: 617,400 divided by the voices, so 22,050 Hz at 28.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>28</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">By hand only</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>wssPort</code> (optional)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2143" class="ixterm"></a><a id="_ix2144" class="ixterm"></a>The port of a Windows Sound System card, in hexadecimal. When it is set, only that port is tried, and if no card is there DVX tries the next kind of sound hardware. When it is not set, or empty, DVX tries ports 530, 604, E80, and F40, in that order.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Looked for</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">By hand only</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>wssIrq</code> (optional)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2145" class="ixterm"></a>The Windows Sound System card&#8217;s IRQ: <code>7</code>, <code>9</code>, <code>10</code>, or <code>11</code>. With any other number, DVX notes it in the log and tries the next kind of sound hardware.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>7</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">By hand only</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>wssDma</code> (optional)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2146" class="ixterm"></a>The Windows Sound System card&#8217;s DMA channel: <code>0</code>, <code>1</code>, or <code>3</code>. Any other number: as for <code>wssIrq</code>.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>1</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">By hand only</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>lptDac</code> (optional)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2147" class="ixterm"></a><a id="_ix2148" class="ixterm"></a>The sound device on the printer port: <code>auto</code> looks for a Disney Sound Source, then a Stereo-on-1, and otherwise leaves the port alone for a printer; <code>covox</code> (a Covox Speech Thing, which cannot be found and must be named), <code>disney</code>, or <code>stereo</code> uses that device without looking. Any other word: DVX tries the next kind of sound hardware.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>auto</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">By hand only</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>lptPort</code> (optional)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2149" class="ixterm"></a>The printer port&#8217;s address, in hexadecimal. When it is not set, or empty, DVX uses LPT1 as the computer lists it.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">LPT1</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">By hand only</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix2150" class="ixterm"></a>The choices for MIDI music, MIDI input, modules, and the MIDI port:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 14.2857%;">
<col style="width: 14.2857%;">
<col style="width: 28.5714%;">
<col style="width: 42.8572%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">Value</th>
<th class="tableblock halign-left valign-top">Control Panel&#8217;s name</th>
<th class="tableblock halign-left valign-top">What it does</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>midi</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>auto</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Automatic</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Plays on the recorded instruments of a Gravis UltraSound or Sound Blaster AWE when they can be loaded there; else on the FM chip when it is free; else in the built-in synthesizer.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>midi</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>mpu401</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>MIDI port (MPU-401)</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Plays on an external synthesizer connected to the MIDI port. If the port was not found when DVX started, or is busy, the music plays as for <code>auto</code>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>midi</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>fm</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>FM synthesizer chip</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Plays on the FM chip; without one, in the built-in synthesizer.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>midi</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>software</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Built-in synthesizer</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Always plays in DVX&#8217;s own synthesizer.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>midi</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>softwave</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Built-in SoundFont synthesizer</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Plays the SoundFont in the computer itself; if the SoundFont cannot be loaded, in the built-in synthesizer.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>midiIn</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>none</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>None</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No MIDI input.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>midiIn</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>mpu401</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>MIDI port</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Reads a MIDI keyboard on the MIDI port (at <code>mpuPort</code>), for programs such as Sound Recorder. The port is shared with MIDI music when <code>midi</code> is <code>mpu401</code> too.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>modules</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>wavetable</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Wavetable synthesizer when free</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Plays a module on the voices of a Gravis UltraSound or Sound Blaster AWE when no other music uses them and the module fits; otherwise the computer mixes it.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>modules</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>software</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Mixed in software</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The computer always mixes modules.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>mpuMode</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>gm</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Not in Control Panel</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A General MIDI synthesizer: the music is sent as it is.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>mpuMode</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>mt32</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Not in Control Panel</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A Roland MT-32: General MIDI music is changed to suit it.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>mpuMode</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>raw</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Not in Control Panel</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The music is sent unchanged, with no setting up; for music made for an MT-32.</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect3">
<h4 id="folders-blaster"><a class="anchor" href="#folders-blaster"></a>B.2.12. Sound card settings in AUTOEXEC.BAT: BLASTER and ULTRASND</h4>
<div class="paragraph">
<p><a id="_ix2151" class="ixterm"></a><a id="_ix2152" class="ixterm"></a><a id="_ix2153" class="ixterm"></a><a id="_ix2154" class="ixterm"></a>Some sound cards are not set in <code>DVX.INI</code> at all, but with DOS settings that the card&#8217;s own software uses too. You set them with <code>SET</code> lines in <code>AUTOEXEC.BAT</code>, before DVX starts.</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1">BLASTER (Sound Blaster cards)</dt>
<dd>
<p>The Sound Blaster&#8217;s port, IRQ, and DMA channels, for example:</p>
<div class="listingblock">
<div class="content">
<pre>SET BLASTER=A220 I5 D1 H5</pre>
</div>
</div>
<div class="paragraph">
<p>DVX reads <code>A</code> (the port), <code>I</code> (the IRQ), <code>D</code> (the 8-bit DMA channel), and <code>H</code> (the 16-bit DMA channel). Without BLASTER, DVX looks at ports 220h and 240h, which finds only a Sound Blaster 16; older Sound Blasters need BLASTER. A Sound Blaster 16&#8217;s own IRQ and DMA settings are used even when BLASTER gives others. If DVX finds a Sound Blaster but cannot tell which IRQ or DMA channel it uses, or cannot use them, the log says &#8220;Audio: sb: IRQ or DMA channel unknown or unusable (set BLASTER, e.g. A220 I5 D1 H5)&#8221;.</p>
</div>
<div class="paragraph">
<p><a id="_ix2155" class="ixterm"></a>A Sound Blaster AWE needs BLASTER for its recorded instruments too. Their port is the <code>E</code> in BLASTER, such as <code>E620</code>; without <code>E</code>, DVX uses the <code>A</code> port plus 400h.</p>
</div>
</dd>
<dt class="hdlist1">ULTRASND (Gravis UltraSound)</dt>
<dd>
<p><a id="_ix2156" class="ixterm"></a>The UltraSound&#8217;s port, its two DMA channels (playing and recording), and its two IRQs (the card&#8217;s and the MIDI port&#8217;s), for example:</p>
<div class="listingblock">
<div class="content">
<pre>SET ULTRASND=220,1,1,11,5</pre>
</div>
</div>
<div class="paragraph">
<p>DVX cannot play sound on an UltraSound without it; the log then says that ULTRASND is not set. When the UltraSound is used only for music, with another card playing the sound, DVX takes its port from ULTRASND, or without it looks at ports 220h, 240h, 260h, 210h, 230h, and 250h.</p>
</div>
</dd>
</dl>
</div>
<div class="paragraph">
<p><a id="_ix2157" class="ixterm"></a><a id="_ix2158" class="ixterm"></a>Two more DOS settings tell DVX where the cards' own instruments are, for the <code>soundFont</code> key: ULTRADIR names the folder of the UltraSound&#8217;s software, where its patches and <code>ULTRASND.INI</code> are; SOUND names the folder of Creative&#8217;s software for the AWE, whose <code>SFBANK</code> folder holds the AWE&#8217;s instrument file (<code>SYNTHGM.SF2</code> or <code>SYNTHGM.SBK</code>).</p>
</div>
</div>
<div class="sect3">
<h4 id="folders-ini-sounds"><a class="anchor" href="#folders-ini-sounds"></a>B.2.13. The <code>[sounds]</code> section: event sounds</h4>
<div class="paragraph">
<p><a id="_ix2159" class="ixterm"></a><a id="_ix2160" class="ixterm"></a>The sound DVX plays for each event. <strong>When a change takes effect:</strong> when you click <b class="button">OK</b> in Control Panel; a change by hand, the next time DVX starts. All nine keys are set on Control Panel&#8217;s Sounds page (<a href="#cpanel-sounds">Section 7.12</a>), and its <b class="button">OK</b> writes all nine.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 15.3846%;">
<col style="width: 23.0769%;">
<col style="width: 46.1538%;">
<col style="width: 15.3847%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">Control Panel&#8217;s event</th>
<th class="tableblock halign-left valign-top">Plays when</th>
<th class="tableblock halign-left valign-top">In the file DVX comes with</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>default</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Default beep</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A program asks for a beep, and a message without a picture appears.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>beep.wav</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>startup</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Start DVX</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX has started.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>startup.wav</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>exit</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Exit DVX</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX is ending. DVX waits up to 5 seconds for it to finish; after it, DVX plays no other sound.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>exit.wav</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>error</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Error</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A message about an error appears.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>error.wav</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>warning</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Warning</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A warning message appears.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>warning.wav</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>question</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Question</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A message that asks a question appears.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>question.wav</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>information</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Information</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A message that tells you something appears.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>info.wav</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>windowOpen</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Open window</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A window opens (not a dialog box).</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Empty</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>windowClose</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Close window</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A window closes (not a dialog box).</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Empty</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix2161" class="ixterm"></a>The value of each key is a sound file, WAV or VOC:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>A name alone, such as <code>beep.wav</code>, is looked for in your <code>USER\SOUNDS</code> folder first, then in <code>SHARED\SOUNDS</code>. An add-on&#8217;s sound is named by its publisher&#8217;s folder and the file name.</p>
</li>
<li>
<p>Any other name with a folder in it, or a whole path, is that file.</p>
</li>
<li>
<p>Empty: no sound for that event.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p><strong>Default:</strong> a missing key also means no sound for that event, not the sound in the file DVX comes with. If a file is not found or cannot be played, the event is silent, and the log says &#8220;Audio: desktop sound <em>file</em>: <em>reason</em>&#8221;.</p>
</div>
</div>
<div class="sect3">
<h4 id="folders-ini-colors"><a class="anchor" href="#folders-ini-colors"></a>B.2.14. The <code>[colors]</code> section: screen colors</h4>
<div class="paragraph">
<p><a id="_ix2162" class="ixterm"></a><a id="_ix2163" class="ixterm"></a>The color of each part of the screen. The file DVX comes with does not have this section; Control Panel writes all twenty keys the first time you click <b class="button">OK</b>. <strong>When a change takes effect:</strong> a change by hand, the next time DVX starts; Control Panel&#8217;s changes at once. All the keys are set on Control Panel&#8217;s Colors page (<a href="#cpanel-colors">Section 7.5</a>), each by its name in the <strong>System Colors</strong> list, or all together by a theme.</p>
</div>
<div class="paragraph">
<p>Each value is three numbers from 0 to 255, separated by commas: the amounts of red, green, and blue, for example <code>desktop = 0,128,128</code>. A number below 0 counts as 0, one above 255 as 255. A key that is missing, or not three numbers, keeps DVX&#8217;s standard color, the one <b class="button">Reset</b> on the Colors page puts back.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 37.5%;">
<col style="width: 37.5%;">
<col style="width: 25%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top"><strong>System Colors</strong> name</th>
<th class="tableblock halign-left valign-top">Standard color</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>desktop</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Desktop</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>0,128,128</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>windowFace</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Window Face</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>192,192,192</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>windowHighlight</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Window Highlight</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>255,255,255</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>windowShadow</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Window Shadow</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>128,128,128</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>activeTitleBg</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Active Title Bar</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>48,48,48</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>activeTitleFg</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Active Title Text</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>255,255,255</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>inactiveTitleBg</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Inactive Title Bar</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>160,160,160</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>inactiveTitleFg</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Inactive Title Text</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>64,64,64</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>contentBg</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Content Background</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>192,192,192</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>contentFg</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Content Text</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>0,0,0</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>menuBg</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Menu Background</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>192,192,192</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>menuFg</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Menu Text</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>0,0,0</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>menuHighlightBg</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Menu Highlight</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>48,48,48</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>menuHighlightFg</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Menu Highlight Text</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>255,255,255</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>buttonFace</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Button Face</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>192,192,192</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>scrollbarBg</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Scrollbar Background</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>192,192,192</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>scrollbarFg</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Scrollbar Foreground</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>128,128,128</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>scrollbarTrough</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Scrollbar Trough</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>160,160,160</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>cursorColor</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Cursor Color</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>255,255,255</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>cursorOutline</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Cursor Outline</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>0,0,0</code></p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix2164" class="ixterm"></a>A theme file (<code>.THM</code>) is a settings file with the same <code>[colors]</code> section. <code>DVX.INI</code> keeps the colors themselves, not the name of the theme you chose.</p>
</div>
</div>
<div class="sect3">
<h4 id="folders-ini-desktop"><a class="anchor" href="#folders-ini-desktop"></a>B.2.15. The <code>[desktop]</code> section: wallpaper and screen saver</h4>
<div class="paragraph">
<p><a id="_ix2165" class="ixterm"></a><a id="_ix2166" class="ixterm"></a><a id="_ix2167" class="ixterm"></a>The picture on the desktop and the screen saver. The file DVX comes with does not have this section; Control Panel writes it the first time you click <b class="button">OK</b>. <strong>When a change takes effect:</strong> a change by hand, the next time DVX starts; Control Panel&#8217;s changes at once. All four keys are set on Control Panel&#8217;s Desktop page (<a href="#cpanel-desktop">Section 7.6</a>).</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 15.3846%;">
<col style="width: 46.1538%;">
<col style="width: 15.3846%;">
<col style="width: 23.077%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">Values</th>
<th class="tableblock halign-left valign-top">Default</th>
<th class="tableblock halign-left valign-top">Set by</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>wallpaper</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2168" class="ixterm"></a>A picture file (BMP, JPEG, PNG, or GIF). A name alone is looked for in your <code>USER\WPAPER</code> folder first, then in <code>SHARED\WPAPER</code>; an add-on&#8217;s picture is named by its publisher&#8217;s folder and the file name; any other name with a folder in it is that file. Control Panel saves a picture from a wallpaper folder by its name alone, and any other by its whole path. Without a picture, the desktop shows the plain <strong>Desktop</strong> color. If the picture cannot be loaded when DVX starts, there is no wallpaper, and the log says &#8220;Preferences: failed to load the wallpaper&#8221;.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">None</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Wallpaper</strong> list, <b class="button">Browse&#8230;&#8203;</b>; <b class="button">Clear</b> removes the key</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>mode</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2169" class="ixterm"></a>How the picture fills the screen: <code>stretch</code>, <code>tile</code>, or <code>center</code>.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>stretch</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Mode</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>saver</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2170" class="ixterm"></a>The screen saver: the file name of one in your <code>USER\SAVERS</code> folder or in <code>SHARED\SAVERS</code>, such as <code>starfld.app</code> for Starfield, or a path. Empty: no screen saver. If the file is not found when its time comes, nothing starts, and the log notes it.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">None</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Screen saver</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>saverWait</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2171" class="ixterm"></a>The minutes without a key press or mouse movement before the screen saver starts, from 1 to 60; a number outside counts as the nearest end.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>10</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Wait</strong></p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect3">
<h4 id="folders-ini-fonts"><a class="anchor" href="#folders-ini-fonts"></a>B.2.16. The <code>[fonts]</code> section: text smoothing</h4>
<div class="paragraph">
<p><a id="_ix2172" class="ixterm"></a><a id="_ix2173" class="ixterm"></a>The file DVX comes with does not have this section; Control Panel writes it the first time you click <b class="button">OK</b>. <strong>When a change takes effect:</strong> a change by hand, the next time DVX starts; Control Panel&#8217;s change at once.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 15.3846%;">
<col style="width: 46.1538%;">
<col style="width: 15.3846%;">
<col style="width: 23.077%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">Values</th>
<th class="tableblock halign-left valign-top">Default</th>
<th class="tableblock halign-left valign-top">Set by</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>smoothing</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2174" class="ixterm"></a><code>true</code> smooths the edges of text; <code>false</code> draws it sharp. Smoothing works only in modes with more than 256 colors; at 256 colors text is always sharp.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Control Panel, Video page, <strong>Smooth the edges of text (more than 256 colors)</strong> (<a href="#cpanel-video">Section 7.7</a>)</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect3">
<h4 id="folders-ini-joystick"><a class="anchor" href="#folders-ini-joystick"></a>B.2.17. The <code>[joystick]</code> section: game controllers</h4>
<div class="paragraph">
<p><a id="_ix2175" class="ixterm"></a><a id="_ix2176" class="ixterm"></a><a id="_ix2177" class="ixterm"></a>Joysticks and the keyboard joystick. The file DVX comes with does not have this section; Control Panel writes it when it saves. <strong>When a change takes effect:</strong> DVX reads this section the first time a program, or Control Panel, uses a game controller after DVX starts, so a change by hand takes effect the next time DVX starts. Changes on Control Panel&#8217;s Game Controllers page (<a href="#cpanel-game-controllers">Section 7.11</a>) work at once.</p>
</div>
<div class="paragraph">
<p>Some keys start with the name of a controller: <code>gameport0</code> and <code>gameport1</code> are the joysticks on the game port, and <code>keyboard0</code> is the keyboard joystick.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 15.3846%;">
<col style="width: 46.1538%;">
<col style="width: 15.3846%;">
<col style="width: 23.077%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">Values</th>
<th class="tableblock halign-left valign-top">Default</th>
<th class="tableblock halign-left valign-top">Set by</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>pollHz</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2178" class="ixterm"></a>How many times a second DVX reads the controllers, from 10 to 200; a number outside counts as the nearest end.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>60</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">By hand only</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>fallback</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2179" class="ixterm"></a>When the keyboard stands in for a joystick: <code>auto</code> (<strong>When no joystick is found</strong>), <code>always</code> (<strong>Always</strong>), or <code>never</code> (<strong>Never</strong>).</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>auto</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Keyboard</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>gameport.mode</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2180" class="ixterm"></a><code>twoSticks</code> (<strong>Two joysticks</strong>) or <code>fourAxes</code> (<strong>One joystick with 4 axes</strong>).</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>twoSticks</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Game port</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>gameport0.axis0</code>, <code>gameport0.axis1</code>, and so on</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2181" class="ixterm"></a><a id="_ix2182" class="ixterm"></a>A joystick&#8217;s calibration, one key for each axis: the controller&#8217;s name, <code>.axis</code>, and the axis number, counting from 0. The value is three whole numbers, <code>min,center,max</code>, with <code>min</code> smaller than <code>center</code> and <code>center</code> smaller than <code>max</code>. A missing key or a value not understood means that axis calibrates itself: the middle is where the stick rests when it is found, and the range is learned as you move it.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">None</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">Calibrate&#8230;&#8203;</b> writes them; <b class="button">Automatic</b> removes them</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>gameport0.deadZone</code> and so on</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2183" class="ixterm"></a>How far, in percent of the way to either end, the stick can move from the middle and still count as the middle: from 0 to 50; a number outside counts as the nearest end.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>8</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Dead zone</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>keyboard.up</code>, <code>keyboard.down</code>, <code>keyboard.left</code>, <code>keyboard.right</code>, <code>keyboard.button1</code> to <code>keyboard.button4</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2184" class="ixterm"></a>The keys of the keyboard joystick, each one of: <code>Up</code>, <code>Down</code>, <code>Left</code>, <code>Right</code>, <code>LCtrl</code>, <code>RCtrl</code>, <code>LShift</code>, <code>RShift</code>, <code>LAlt</code>, <code>RAlt</code>, <code>Space</code>, <code>Enter</code>, <code>Tab</code>, <code>Backspace</code>, <code>Insert</code>, <code>Delete</code>, <code>Home</code>, <code>End</code>, <code>PgUp</code>, <code>PgDn</code>, <code>Keypad0</code> to <code>Keypad9</code>, <code>A</code> to <code>Z</code>, or <code>0</code> to <code>9</code>, in capital or small letters. A name not on this list means that key&#8217;s default.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Up</code>, <code>Down</code>, <code>Left</code>, <code>Right</code>, <code>LCtrl</code>, <code>Space</code>, <code>LShift</code>, <code>Z</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><b class="button">Keys&#8230;&#8203;</b></p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>A game controller add-on may keep settings of its own in this section, starting with its own name.</p>
</div>
</div>
<div class="sect3">
<h4 id="folders-ini-help"><a class="anchor" href="#folders-ini-help"></a>B.2.18. The <code>[help]</code> section: DVX&#8217;s own notes</h4>
<div class="paragraph">
<p><a id="_ix2185" class="ixterm"></a>DVX writes this section itself when it starts, to keep track of its help files: the first time, and whenever it brings them up to date. <strong>Do not change it.</strong></p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 25%;">
<col style="width: 75%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">What DVX keeps in it</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>libCount</code>, <code>widgetCount</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2186" class="ixterm"></a>How many libraries and controls DVX found the last time it brought its help files up to date. When either number is different at a start, because something was added or removed, DVX brings every help file up to date; that is when the bar on the start-up screen fills a second time.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>retries</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2187" class="ixterm"></a>How many starts in a row bringing the help files up to date has failed. After 3, DVX stops trying until libraries or controls are added or removed.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>A wrong number makes DVX bring every help file up to date at the next start, which only makes that start slower. If you delete the section, DVX writes it again with the counts it finds, without bringing the help files up to date.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="folders-assoc"><a class="anchor" href="#folders-assoc"></a>B.3. ASSOC.INI: which program opens each kind of file</h3>
<div class="paragraph">
<p><a id="_ix2188" class="ixterm"></a><a id="_ix2189" class="ixterm"></a>When you open a document, for example by double-clicking it in File Manager or Program Manager, or by naming it in Program Manager&#8217;s <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Run&#8230;&#8203;</b></span>, DVX starts the program set up for its kind of file, its extension. DVX keeps this list in two files called <code>ASSOC.INI</code>:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><a id="_ix2190" class="ixterm"></a><code>C:\DVX\SYSTEM\ASSOC.INI</code> is the list that comes with DVX, with comments that explain it. DVX never changes it; an upgrade replaces it.</p>
</li>
<li>
<p><a id="_ix2191" class="ixterm"></a><code>ASSOC.INI</code> in your USER folder holds only your changes to that list. It is made the first time you change a file type in Control Panel, and holds the line <code>[associations]</code> and the lines you changed, without comments.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>DVX reads the two together: every type in the shipped list that you have not changed, and then your own lines. A line in your file replaces the shipped line for the same extension, and a line with nothing after the <code>=</code> removes a shipped type.</p>
</div>
<div class="paragraph">
<p><a id="_ix2192" class="ixterm"></a>Both files have one section, <code>[associations]</code>, with one line for each extension:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>EXTENSION = program,arguments</pre>
</div>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><code>EXTENSION</code></dt>
<dd>
<p>The extension without the dot: one to eight letters or digits, such as <code>TXT</code>. Capital and small letters count as the same. An extension that is longer, or has other characters, never matches a file.</p>
</dd>
<dt class="hdlist1"><code>program</code></dt>
<dd>
<p>The program that opens the file, as a path from the DVX folder (such as <code>apps/kpunch/notepad/notepad.app</code>) or a whole path. Both <code>/</code> and <code>\</code> work in it. It can be a DVX program (<code>.app</code>) or a DOS program (<code>.EXE</code>, <code>.COM</code>, or <code>.BAT</code>); a DOS program may be just its name if DOS can find it along the PATH.</p>
</dd>
<dt class="hdlist1"><code>arguments</code></dt>
<dd>
<p>Optional, after the first comma: what to give the program. <code>%1</code> stands for the document&#8217;s whole path, which DVX puts in quotes if it has a space in it (unless you wrote <code>"%1"</code> in quotes yourself). Without arguments, the program is given just the document.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p><a id="_ix2193" class="ixterm"></a>For example, an <code>ASSOC.INI</code> in your USER folder with these lines opens <code>.LOG</code> and <code>.NFO</code> files in Notepad, and makes GIF pictures open in nothing at all instead of Image Viewer:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>[associations]
LOG = apps/kpunch/notepad/notepad.app
NFO = apps/kpunch/notepad/notepad.app
GIF =</pre>
</div>
</div>
<div class="paragraph">
<p><a id="_ix2194" class="ixterm"></a>A type whose program is part of DVX you did not install, such as DVX BASIC, opens nothing, as if it had no program. Control Panel still lists it.</p>
</div>
<div class="paragraph">
<p><a id="_ix2195" class="ixterm"></a><a id="_ix2196" class="ixterm"></a>The easy way to change the list is Control Panel&#8217;s File Types page (see <a href="#cpanel-file-types">Section 7.8</a>), which also lists the types DVX comes with. Your changes there are written to your <code>ASSOC.INI</code> when you click <b class="button">OK</b>: a new or changed type is written as its line; a removed type you added yourself loses its line; a removed type DVX came with gets an empty line; and setting a type back to exactly the program DVX came with removes its line from your file, so it follows the shipped list again. If the file cannot be saved, the log says &#8220;Assoc: cannot save the file types&#8221; followed by the file&#8217;s name.</p>
</div>
<div class="paragraph">
<p><a id="_ix2197" class="ixterm"></a>DVX reads the two files the first time it needs a file type and keeps what it read, so change <code>ASSOC.INI</code> by hand only while DVX is not running. To go back to the file types DVX came with, delete <code>ASSOC.INI</code> from your USER folder while DVX is not running (see <a href="#folders-defaults">Section B.5</a>).</p>
</div>
</div>
<div class="sect2">
<h3 id="folders-other"><a class="anchor" href="#folders-other"></a>B.4. Other settings files</h3>
<div class="paragraph">
<p><a id="_ix2198" class="ixterm"></a><a id="_ix2199" class="ixterm"></a><a id="_ix2200" class="ixterm"></a>Each program that remembers settings or keeps files of its own has a folder in the <code>APPS</code> folder of your USER folder. For a program in the DVX folder, it is the same path as the program&#8217;s own folder: Program Manager, which is <code>C:\DVX\APPS\KPUNCH\PROGMAN\PROGMAN.APP</code>, keeps its settings in <code>C:\DVX\USER\APPS\KPUNCH\PROGMAN</code>. For a program outside the DVX folder, it is a folder named after the program&#8217;s file, without the extension: a program <code>GAME.APP</code> on a floppy disk uses <code>USER\APPS\GAME</code>. The folder is made when the program first saves something.</p>
</div>
<div class="paragraph">
<p>These programs that come with DVX keep files there:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 30%;">
<col style="width: 50%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Program</th>
<th class="tableblock halign-left valign-top">File in <code>USER\APPS\KPUNCH...</code></th>
<th class="tableblock halign-left valign-top">What it holds</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Program Manager</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>PROGMAN\PROGMAN.INI</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Your groups and their items, the options, and the Run history. See <a href="#folders-progman-ini">Section B.4.1</a>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Terminal</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>TERMINAL\TERMINAL.INI</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The phone book and the transfer settings. See <a href="#folders-terminal-ini">Section B.4.3</a>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>DVXBASIC\DVXBASIC.INI</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The editor&#8217;s preferences and the recent projects. See <a href="#folders-dvxbasic-ini">Section B.4.4</a>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Media Player</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>PLAYER\PLAYER.INI</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The play list and the player&#8217;s settings. See <a href="#folders-player-ini">Section B.4.5</a>.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Sound Recorder</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>RECORDER\RECORDER.INI</code>, <code>RECORDING.WAV</code>, <code>RECORDING.MID</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The recorder&#8217;s settings, and a recording that is not saved yet. See <a href="#folders-recorder-ini">Section B.4.6</a>.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix2201" class="ixterm"></a>These programs keep no settings file of their own: Clock, Control Panel (it writes <code>DVX.INI</code>, <code>ASSOC.INI</code>, and the themes you save in <code>USER\THEMES</code>), DVX Demo, DVX Help (its Back and Forward history lasts only while it runs), File Manager, Help Editor, Image Viewer, Notepad, Package Builder (your keys are in <code>USER\KEYS</code>; its package templates are documents you save where you like), Resource Editor, Widget Showcase, Welcome (it changes only the <code>welcome</code> key in <code>DVX.INI</code>), Software (it uses <code>DVX.INI</code>, <code>USER\KEYS</code>, and <code>USER\DOWNLOAD</code>), and the screen savers.</p>
</div>
<div class="sect3">
<h4 id="folders-progman-ini"><a class="anchor" href="#folders-progman-ini"></a>B.4.1. Program Manager: PROGMAN.INI</h4>
<div class="paragraph">
<p><a id="_ix2202" class="ixterm"></a><a id="_ix2203" class="ixterm"></a><a id="_ix2204" class="ixterm"></a>Program Manager keeps your groups in <code>USER\APPS\KPUNCH\PROGMAN\PROGMAN.INI</code> and saves the file after every change. (For groups and items, see <a href="#progman-groups">Section 6.3</a> and <a href="#progman-items">Section 6.4</a>.)</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 15.3846%;">
<col style="width: 23.0769%;">
<col style="width: 38.4615%;">
<col style="width: 23.077%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Section</th>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">What it holds</th>
<th class="tableblock halign-left valign-top">Default</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[options]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>minimizeOnRun</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">Options</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Minimize on Run</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>false</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[options]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>restoreAlone</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">Options</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Restore when Alone</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>false</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[options]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>autoArrange</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">View</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Auto Arrange</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[options]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>view</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">View</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Large Icons</b></span>, <span class="menuseq"><b class="menu">View</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Small Icons</b></span>, or <span class="menuseq"><b class="menu">View</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">List</b></span>: <code>large</code>, <code>small</code>, or <code>list</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>large</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[options]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>group</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The name of the group shown</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Installed Programs</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[groups]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>count</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">How many of your groups follow, at most 64</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Missing: the groups <strong>Main</strong> and <strong>Startup</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[group1]</code>, <code>[group2]</code>, &#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>name</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The group&#8217;s name</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&#8220;Group <em>n</em>&#8221;</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[group1]</code>, &#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>count</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">How many items the group has, at most 256</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>0</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[group1]</code>, &#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>item1.name</code>, <code>item2.name</code>, &#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The item&#8217;s <strong>Name</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">An item without a name is left out</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[group1]</code>, &#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>item1.program</code>, &#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The item&#8217;s <strong>Program</strong>: a program, a DOS program, or a document</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">An item without a program is left out</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[group1]</code>, &#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>item1.args</code>, &#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Arguments</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Empty</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[group1]</code>, &#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>item1.folder</code>, &#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Working folder</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Empty</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[group1]</code>, &#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>item1.icon</code>, &#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Icon file</strong> (empty: the program&#8217;s own)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Empty</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[group1]</code>, &#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>item1.key</code>, &#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Shortcut key</strong>, such as <code>Ctrl+Alt+P</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">None; a key not understood is dropped</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[group1]</code>, &#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>item1.minimized</code>, &#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Run minimized</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>false</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[group1]</code>, &#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>item1.pause</code>, &#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Wait for a key when a DOS program ends</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>false</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[group1]</code>, &#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>item1.col</code>, <code>item1.row</code>, &#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Where the item is in the group</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Placed by Program Manager</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[run]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>history1</code> to <code>history10</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The commands typed in <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Run&#8230;&#8203;</b></span>, newest first</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">None</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>An item&#8217;s settings that are empty or off are left out of the file. The <strong>Installed Programs</strong> group is never saved: Program Manager makes it again from the programs it finds each time DVX starts, and whenever programs are added or removed. The items in your <strong>Startup</strong> group run once, right after DVX has started. Damaged lines are skipped, and a group whose name is already taken gets a number after it.</p>
</div>
<div class="paragraph">
<p>If <code>PROGMAN.INI</code> is missing, Program Manager starts with two empty groups, <strong>Main</strong> and <strong>Startup</strong>, the default options, and no Run history.</p>
</div>
</div>
<div class="sect3">
<h4 id="folders-programs-cac"><a class="anchor" href="#folders-programs-cac"></a>B.4.2. PROGRAMS.CAC: the list of programs</h4>
<div class="paragraph">
<p><a id="_ix2205" class="ixterm"></a><a id="_ix2206" class="ixterm"></a><code>USER\PROGRAMS.CAC</code> is DVX&#8217;s memory of each program&#8217;s name, description, and icon, so that Program Manager, File Manager, and other programs can show them without reading every program file at each start. DVX checks each program against its file: a program that changed is read again, and one that was removed is forgotten. DVX saves its changes a few seconds after they happen, while the computer is idle, and the rest when DVX ends. A damaged file is noted in the log and made again.</p>
</div>
<div class="paragraph">
<p>You may delete it at any time DVX is not running: DVX makes it again, and only the next start is slower. Delete it if Program Manager shows a program&#8217;s old name or icon after the program was changed.</p>
</div>
</div>
<div class="sect3">
<h4 id="folders-terminal-ini"><a class="anchor" href="#folders-terminal-ini"></a>B.4.3. Terminal: TERMINAL.INI</h4>
<div class="paragraph">
<p><a id="_ix2207" class="ixterm"></a><a id="_ix2208" class="ixterm"></a><a id="_ix2209" class="ixterm"></a>Terminal keeps the phone book and the transfer settings in <code>USER\APPS\KPUNCH\TERMINAL\TERMINAL.INI</code>, and saves it whenever you change a session or a transfer setting (see <a href="#terminal-phone-book">Section 9.4</a> and <a href="#terminal-settings">Section 9.8</a>). Terminals running at the same time share the file: each reads it again before it saves, and changes only what was changed in it. Every choice is written as a word, and every value is brought into range when the file is read, so a file changed by hand cannot give a session a value Terminal does not allow. If the file is missing or empty, Terminal starts with one session, &#8220;Direct COM1&#8221;, and the transfer defaults. If it cannot save the file, Terminal says &#8220;The phone book could not be saved&#8221;. If the file is there but cannot be read, Terminal starts with the defaults and does not save over it (see <a href="#terminal-settings-file">Section 9.8.8</a>).</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 14.2857%;">
<col style="width: 28.5714%;">
<col style="width: 35.7142%;">
<col style="width: 21.4287%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Section</th>
<th class="tableblock halign-left valign-top">Keys</th>
<th class="tableblock halign-left valign-top">What they hold</th>
<th class="tableblock halign-left valign-top">Default</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[phonebook]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>entries</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">How many sessions follow, 0 to 32</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">One session</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[phonebook]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>current</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The session used last (0 is the first)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>0</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[transfer]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>directory</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The download folder</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>USER\DOWNLOAD</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[transfer]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>protocol</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>xmodem</code>, <code>xmodem1k</code>, <code>ymodem</code>, or <code>zmodem</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>zmodem</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[transfer]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>exists</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">When a file being received is already there: <code>ask</code>, <code>rename</code>, <code>resume</code>, <code>overwrite</code>, or <code>skip</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>ask</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[transfer]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>autozmodem</code>, <code>escapectl</code>, <code>resume</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The transfer options, <code>true</code> or <code>false</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code>, <code>false</code>, <code>false</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[entry1]</code>, <code>[entry2]</code>, &#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>name</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The session&#8217;s name</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Direct COM1</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[entry1]</code>, &#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>type</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>serial</code>, <code>modem</code>, <code>secure</code>, or <code>telnet</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>serial</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[entry1]</code>, &#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>port</code>, <code>speed</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The serial port (<code>COM1</code> to <code>COM4</code>) and its speed (300 to 115200)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>COM1</code>, <code>9600</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[entry1]</code>, &#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>databits</code>, <code>parity</code>, <code>stopbits</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">5 to 8; <code>N</code>, <code>E</code>, <code>O</code>, <code>M</code>, or <code>S</code>; 1 or 2</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>8</code>, <code>N</code>, <code>1</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[entry1]</code>, &#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>flow</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>none</code>, <code>xonxoff</code>, or <code>rtscts</code> (a secure link over a COM port cannot use <code>xonxoff</code>)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>none</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[entry1]</code>, &#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>init</code>, <code>dialprefix</code>, <code>phone</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The modem&#8217;s commands and the number to dial</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>ATZ</code>, <code>ATDT</code>, empty</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[entry1]</code>, &#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>redial</code>, <code>redialdelay</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">How many times to redial, and the seconds between (1 to 300)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>3</code>, <code>30</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[entry1]</code>, &#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>host</code>, <code>tcpport</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The Telnet host and port (1 to 65535)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Empty, <code>23</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[entry1]</code>, &#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>passphrase</code>, <code>askpassphrase</code>, <code>securenet</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The secure link&#8217;s passphrase (saved scrambled, and never saved when it is asked for at each connect) and its options</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Empty, <code>false</code>, <code>false</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[entry1]</code>, &#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>cols</code>, <code>rows</code>, <code>scrollback</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The screen size (40 to 132 by 10 to 60) and the lines kept (100 to 10000)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>80</code>, <code>25</code>, <code>1000</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[entry1]</code>, &#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>scheme</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>standard</code>, <code>green</code>, <code>amber</code>, or <code>light</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>standard</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[entry1]</code>, &#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>localecho</code>, <code>ansimusic</code>, <code>answerback</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Local echo, ANSI music, and the answerback text</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>false</code>, <code>true</code>, empty</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p>The passphrase is scrambled the same way as the package server password: not locked, only hidden from a quick look.</p>
</div>
</div>
<div class="sect3">
<h4 id="folders-dvxbasic-ini"><a class="anchor" href="#folders-dvxbasic-ini"></a>B.4.4. DVX BASIC: DVXBASIC.INI</h4>
<div class="paragraph">
<p><a id="_ix2210" class="ixterm"></a><a id="_ix2211" class="ixterm"></a>DVX BASIC keeps its preferences in <code>USER\APPS\KPUNCH\DVXBASIC\DVXBASIC.INI</code>, made the first time a setting is saved, and saves it after each change.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 15.3846%;">
<col style="width: 23.0769%;">
<col style="width: 46.1538%;">
<col style="width: 15.3847%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Section</th>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">What it holds</th>
<th class="tableblock halign-left valign-top">Default</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[view]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>toolbar</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">View</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Toolbar</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[view]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>statusbar</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">View</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Status Bar</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[run]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>saveOnRun</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">Run</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Save on Run</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[run]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>outputToLog</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">Run</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Output Window to Log</b></span></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>false</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[editor]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>renameSkipComments</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="menuseq"><b class="menu">Tools</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Preferences&#8230;&#8203;</b></span>, <strong>Skip comments/strings when renaming</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[editor]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>optionExplicit</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>OPTION EXPLICIT default for new projects</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>false</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[editor]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>tabWidth</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Tab width</strong>, 1 to 8</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>3</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[editor]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>useSpaces</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Insert spaces instead of tabs</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[defaults]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>author</code>, <code>publisher</code>, <code>version</code>, <code>copyright</code>, <code>description</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The <strong>New Project Defaults</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Empty (<code>version</code>: <code>1.0</code>)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[syntax]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>color0</code> to <code>color6</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The colors on the Preferences window&#8217;s <strong>Colors</strong> tab: Default Text, Keywords, Strings, Comments, Numbers, Operators, and Types</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC&#8217;s own colors</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[recent]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>file0</code> to <code>file15</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The recent projects</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">None</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect3">
<h4 id="folders-player-ini"><a class="anchor" href="#folders-player-ini"></a>B.4.5. Media Player: PLAYER.INI</h4>
<div class="paragraph">
<p><a id="_ix2212" class="ixterm"></a><a id="_ix2213" class="ixterm"></a>Media Player reads <code>USER\APPS\KPUNCH\PLAYER\PLAYER.INI</code> when its window opens, and writes it when the window closes (see <a href="#programs-media-player">Section 8.7</a>).</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 15.3846%;">
<col style="width: 23.0769%;">
<col style="width: 46.1538%;">
<col style="width: 15.3847%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Section</th>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">What it holds</th>
<th class="tableblock halign-left valign-top">Default</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[Player]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Volume</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The volume slider, 0 to 100</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>100</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[Player]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Repeat</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Repeat Off</strong>, <strong>Repeat List</strong>, or <strong>Repeat Track</strong>: <code>off</code>, <code>list</code>, or <code>track</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>off</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[Player]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Shuffle</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Shuffle</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>false</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[Player]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Folder</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Where the file dialogs start</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Empty</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[Player]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Track</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The track that was selected (0 is the first)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">None selected</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[List]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>File1</code>, <code>File2</code>, &#8230;&#8203;</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The play list</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Empty</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect3">
<h4 id="folders-recorder-ini"><a class="anchor" href="#folders-recorder-ini"></a>B.4.6. Sound Recorder: RECORDER.INI and the recording files</h4>
<div class="paragraph">
<p><a id="_ix2214" class="ixterm"></a><a id="_ix2215" class="ixterm"></a>Sound Recorder reads <code>USER\APPS\KPUNCH\RECORDER\RECORDER.INI</code> when its window opens, and writes it when the window closes (see <a href="#programs-sound-recorder">Section 8.8</a>).</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 15.3846%;">
<col style="width: 23.0769%;">
<col style="width: 46.1538%;">
<col style="width: 15.3847%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Section</th>
<th class="tableblock halign-left valign-top">Key</th>
<th class="tableblock halign-left valign-top">What it holds</th>
<th class="tableblock halign-left valign-top">Default</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[Recorder]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Quality</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Telephone Quality</strong>, <strong>Radio Quality</strong>, or <strong>CD Quality</strong>: <code>telephone</code>, <code>radio</code>, or <code>cd</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>radio</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[Recorder]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Input</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Microphone</strong> (<code>0</code>), <strong>Line In</strong> (<code>1</code>), <strong>CD Audio</strong> (<code>2</code>), or <strong>MIDI Keyboard</strong> (<code>-1</code>)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>0</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>[Recorder]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Folder</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Where the file dialogs start</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Empty</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix2216" class="ixterm"></a>The same folder holds <code>RECORDING.WAV</code> and <code>RECORDING.MID</code> while you record: they keep a recording until you save it with <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Save As&#8230;&#8203;</b></span>. Sound Recorder deletes them when it closes, after asking about a recording you have not saved.</p>
</div>
</div>
<div class="sect3">
<h4 id="folders-keys"><a class="anchor" href="#folders-keys"></a>B.4.7. KEYS: publisher keys</h4>
<div class="paragraph">
<p><a id="_ix2217" class="ixterm"></a><a id="_ix2218" class="ixterm"></a><a id="_ix2219" class="ixterm"></a>Keys prove who made a package (see <a href="#addons-signatures">Section 10.8</a>).</p>
</div>
<div class="ulist">
<ul>
<li>
<p><code>C:\DVX\SYSTEM\KEYS</code> holds DVX&#8217;s own key, <code>KPUNCH.KEY</code>. It is part of DVX, not a setting. Do not delete it: without it DVX cannot check its own packages and updates.</p>
</li>
<li>
<p><code>USER\KEYS</code> holds the keys of the publishers you chose to trust, as <code>.KEY</code> files. Software&#8217;s <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Trust a Publisher&#8217;s Key&#8230;&#8203;</b></span> copies a key there. To stop trusting a publisher, delete their <code>.KEY</code> file from this folder while DVX is not running.</p>
</li>
<li>
<p><code>USER\KEYS</code> also holds the keys you make yourself in Package Builder (<b class="button">New Key&#8230;&#8203;</b>): a <code>.SEC</code> file, your private key, and a <code>.KEY</code> file with the same name to give to others.</p>
</li>
</ul>
</div>
<div class="admonitionblock warning">
<table>
<tr>
<td class="icon">
<div class="title">Warning</div>
</td>
<td class="content">
<a id="_ix2220" class="ixterm"></a>Keep a copy of your <code>.SEC</code> files somewhere safe. A private key cannot be made again, and an upgrade of a package must be signed with the same key as the version that is installed, so without it you cannot publish upgrades of the packages you signed with it.
</td>
</tr>
</table>
</div>
</div>
<div class="sect3">
<h4 id="folders-download"><a class="anchor" href="#folders-download"></a>B.4.8. DOWNLOAD</h4>
<div class="paragraph">
<p><a id="_ix2221" class="ixterm"></a><code>USER\DOWNLOAD</code> holds the packages Software fetches from the package server, while it fetches and installs them; a download not yet finished ends in <code>.PRT</code>. Software deletes what it fetched once it is installed. Until then (for example after you choose <b class="button">Cancel</b> in its <strong>Install Software</strong> window) it keeps the packages, so that installing them again does not download them again, and it keeps a download that was stopped, so it can carry on from where it stopped. Each fetch removes the packages an earlier one left there. It is also Terminal&#8217;s usual download folder; the files Terminal receives stay there until you delete them.</p>
</div>
</div>
<div class="sect3">
<h4 id="folders-system-files"><a class="anchor" href="#folders-system-files"></a>B.4.9. Files in the DVX folder</h4>
<div class="paragraph">
<p><a id="_ix2222" class="ixterm"></a><a id="_ix2223" class="ixterm"></a><a id="_ix2224" class="ixterm"></a>These files outside the USER folder are DVX&#8217;s own records. They are not settings, and you should not change or delete them:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 33.3333%;">
<col style="width: 66.6667%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">File or folder</th>
<th class="tableblock halign-left valign-top">What it holds</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>C:\DVX\SETUP.LST</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Setup&#8217;s list of every file it installed, one to a line. Setup uses it to recognise a folder that holds DVX, and to remove DVX; without it, Setup cannot remove DVX.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>C:\DVX\SYSTEM\PACKAGES</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A file for each installed package, listing every file it put in the DVX folder. Without them, Software no longer knows what is installed.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>C:\DVX\SYSTEM\KEYS</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX&#8217;s own key (see <a href="#folders-keys">Section B.4.7</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>C:\AUTOEXEC.DVX</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The copy of <code>AUTOEXEC.BAT</code> that Setup keeps when it adds or removes the line that starts DVX. It is on the drive the computer starts from.</p></td>
</tr>
</tbody>
</table>
<div class="paragraph">
<p><a id="_ix2225" class="ixterm"></a>Setup writes a log file only when you start it with <code>/LOG=</code>, for example <code>SETUP /LOG=C:\SETUP.LOG</code>.</p>
</div>
</div>
<div class="sect3">
<h4 id="folders-temporary"><a class="anchor" href="#folders-temporary"></a>B.4.10. Temporary files</h4>
<div class="paragraph">
<p><a id="_ix2226" class="ixterm"></a>You may come across these files. DVX makes them while it works and normally deletes them again:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 33.3333%;">
<col style="width: 66.6667%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">File</th>
<th class="tableblock halign-left valign-top">What it is</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>DVX.$IN</code>, <code>DVX.~IN</code>, and others like them</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a id="_ix2227" class="ixterm"></a>A settings file being saved. DVX writes the new file with <code>$</code> and the first two letters of its extension, such as <code>DVX.$IN</code> or <code>PROGMAN.$IN</code>, then parks the old one with <code>~</code>, such as <code>DVX.~IN</code>, puts the new one in place, and deletes the old one. If the computer is switched off or DVX stops in the middle, these files can be left behind. A <code>$</code> file can be deleted. A <code>~</code> file whose settings file is missing is the complete old copy of your settings: keep it, and rename it back, for example <code>REN DVX.~IN DVX.INI</code>, before you start DVX.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>_dvx01.APP</code> and others like it</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A copy of a program that is running twice, made in the TEMP folder (or, without one, in the USER folder) and deleted when that copy ends. One left behind after a crash can be deleted while DVX is not running.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>PKGMAKE</code> folder</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Made in the TEMP folder (or the USER folder) while DVX BASIC makes a package, and removed afterwards.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>PRINTICO.BMP</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Made in the TEMP folder (or Icon Editor&#8217;s folder in the USER folder) while Icon Editor prints an icon, and deleted afterwards.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>demo.txt</code>, <code>demo.ini</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Made in BASIC Demo&#8217;s folder in the USER folder by its <strong>File I/O</strong> and <strong>INI</strong> buttons, and deleted straight away.</p></td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="sect2">
<h3 id="folders-defaults"><a class="anchor" href="#folders-defaults"></a>B.5. Going back to the default settings</h3>
<div class="paragraph">
<p><a id="_ix2228" class="ixterm"></a><a id="_ix2229" class="ixterm"></a><a id="_ix2230" class="ixterm"></a><a id="_ix2231" class="ixterm"></a>Each settings file can be deleted to put that part of DVX back as it came. A missing file is not an error: DVX, or the program, starts with its defaults and makes the file again when it next saves. Delete files only while DVX is not running.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 28.5714%;">
<col style="width: 14.2857%;">
<col style="width: 28.5714%;">
<col style="width: 28.5715%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">File or folder (in the USER folder unless shown)</th>
<th class="tableblock halign-left valign-top">Safe to delete?</th>
<th class="tableblock halign-left valign-top">What you get</th>
<th class="tableblock halign-left valign-top">What you lose</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>DVX.INI</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Yes</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A new copy of the settings DVX came with, made when DVX starts (see the steps below).</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Every setting made in Control Panel (but not the file types), Software&#8217;s package server settings, and your changes by hand.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>ASSOC.INI</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Yes</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The file types DVX came with, from the next start.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Your changes to the file types.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>APPS\KPUNCH\PROGMAN\PROGMAN.INI</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Yes</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Two empty groups, <strong>Main</strong> and <strong>Startup</strong>, <strong>Large Icons</strong>, <strong>Auto Arrange</strong> on, and no Run history. <strong>Installed Programs</strong> is made again anyway.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Every group and item you made, their shortcut keys, and your Startup items.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>APPS\KPUNCH\TERMINAL\TERMINAL.INI</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Yes</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">One session, &#8220;Direct COM1&#8221;, ZMODEM, and the download folder <code>USER\DOWNLOAD</code>.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The whole phone book, with any passphrases saved in it.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>APPS\KPUNCH\DVXBASIC\DVXBASIC.INI</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Yes</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC&#8217;s default preferences and colors.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The recent projects, the project defaults, and your colors.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>APPS\KPUNCH\PLAYER\PLAYER.INI</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Yes</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Volume 100, Repeat Off, Shuffle off, and an empty play list.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The play list.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>APPS\KPUNCH\RECORDER\RECORDER.INI</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Yes</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Radio Quality and the microphone.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The last folder used.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>APPS\KPUNCH\RECORDER\RECORDING.WAV</code>, <code>RECORDING.MID</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Yes</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Nothing; Sound Recorder deletes them when it closes anyway.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A recording not yet saved.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>APPS</code> (the whole folder)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Yes</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Every program&#8217;s defaults.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">All of the above, and any other files programs saved there.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>PROGRAMS.CAC</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Yes</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX makes it again.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Nothing; the next start is slower.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>SECLINK.RND</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Yes</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX writes a new one when it exits, if a program used it during that session.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Nothing.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>DOWNLOAD</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Yes, when Software is not installing anything</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Made again when needed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Packages fetched but not installed yet, and the files Terminal received there.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>KEYS</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Only with care</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Only DVX&#8217;s own key is trusted (it is in <code>SYSTEM\KEYS</code>).</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Your trust in every other publisher, and your own private keys (<code>.SEC</code>), which cannot be made again (see <a href="#folders-keys">Section B.4.7</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>FONTS</code>, <code>SOUNDS</code>, <code>THEMES</code>, <code>WPAPER</code>, <code>BANKS</code>, <code>SAVERS</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Yes</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Only DVX&#8217;s own files of that kind (in <code>SHARED</code>).</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Your own files of that kind. A setting that named one of them then finds nothing: no sound, no wallpaper, no screen saver, or DVX&#8217;s standard instruments.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">A <code>$</code> scratch file, such as <code>DVX.$IN</code>, and a left-over <code>_dvx01.APP</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Yes</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">A <code>~</code> file whose settings file is missing, such as <code>DVX.~IN</code> without <code>DVX.INI</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Your settings: it is the only copy. Rename it back instead (see <a href="#folders-temporary">Section B.4.10</a>).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">The whole USER folder</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Yes</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX starts with everything as it came, and makes a new <code>DVX.INI</code> at the next start (see <a href="#folders-defaults-steps">Section B.5.1</a> for its screen mode).</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Every setting and every file saved in it.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>C:\DVX\SETUP.LST</code>, <code>C:\DVX\SYSTEM\PACKAGES</code>, <code>C:\DVX\SYSTEM\KEYS</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">No</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">-</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Removing DVX, Software&#8217;s record of what is installed, and the check of DVX&#8217;s own packages.</p></td>
</tr>
</tbody>
</table>
<div class="sect3">
<h4 id="folders-defaults-steps"><a class="anchor" href="#folders-defaults-steps"></a>B.5.1. Putting back the settings DVX came with</h4>
<div class="paragraph">
<p><a id="_ix2232" class="ixterm"></a>To go back to the settings in <code>DVX.INI</code> that DVX came with, rename your <code>DVX.INI</code> rather than deleting it, so you can still look up your old settings or copy one back:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>Exit DVX.</p>
</li>
<li>
<p>At the DOS prompt, rename the file:</p>
<div class="listingblock">
<div class="content">
<pre>CD \DVX\USER
REN DVX.INI DVXOLD.INI</pre>
</div>
</div>
<div class="paragraph">
<p>If you set DVXUSER, change to the folder it names instead.</p>
</div>
</li>
<li>
<p>Start DVX. It copies <code>SYSTEM\DVX.INI</code> into your USER folder.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p><a id="_ix2233" class="ixterm"></a>The new copy has the values of the file DVX came with, which are not quite those Setup gave you:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><a id="_ix2234" class="ixterm"></a>The screen mode is 1024 x 768 with 65 thousand colors, not the mode Setup chose. If your card has no mode that large, DVX starts in safe video mode and asks whether to use that mode from now on: click <b class="button">Yes</b>. If the card has the mode but the monitor cannot show it, the screen stays blank or unreadable: exit DVX, then start it again while holding down a <kbd>Shift</kbd> key, and click <b class="button">Yes</b> when it asks whether to use the safe video mode from now on (see <a href="#installing-safe-start">Section 3.13</a>). Then choose the mode you want on Control Panel&#8217;s Video page.</p>
</li>
<li>
<p>The Welcome window appears again at the start.</p>
</li>
<li>
<p>The colors, wallpaper, screen saver, and text smoothing go back to DVX&#8217;s own, and the mouse, network, printer, sound, event sounds, and package server go back to the values in the file DVX came with.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p><a id="_ix2235" class="ixterm"></a>To start over completely, rename the whole USER folder instead (for example <code>MOVE C:\DVX\USER C:\DVX\USEROLD</code> with DVX not running). DVX makes a new, empty USER folder at the next start, with a new <code>DVX.INI</code> like the one described above. You can copy files you want to keep, such as your Program Manager groups or Terminal&#8217;s phone book, from the old folder into the new one later, with DVX not running.</p>
</div>
<div class="paragraph">
<p>To put back a single program&#8217;s settings, delete (or rename) just its file from the table above. To put back the file types, delete <code>ASSOC.INI</code>.</p>
</div>
</div>
</div>
<div class="sect2">
<h3 id="folders-log"><a class="anchor" href="#folders-log"></a>B.6. The log file, DVX.LOG</h3>
<div class="paragraph">
<p><a id="_ix2236" class="ixterm"></a><a id="_ix2237" class="ixterm"></a><a id="_ix2238" class="ixterm"></a>DVX writes a record of what it does, and of what goes wrong, to the file <code>DVX.LOG</code> in your USER folder: <code>C:\DVX\USER\DVX.LOG</code>, or <code>DVX.LOG</code> in the folder DVXUSER names, or <code>TEMP\DVXUSER\DVX.LOG</code> when DVX runs from a disk it cannot write to (see <a href="#folders-layout">Section B.1</a>). It is the place to look when something fails without a message, such as a sound card that stays silent or a network that does not start, and the file to send with a problem report.</p>
</div>
<div class="sect3">
<h4 id="folders-log-when"><a class="anchor" href="#folders-log-when"></a>B.6.1. When DVX writes it</h4>
<div class="ulist">
<ul>
<li>
<p><a id="_ix2239" class="ixterm"></a>DVX empties the file each time it starts, so it holds only the latest session. Copy it before you start DVX again if you want to keep it.</p>
</li>
<li>
<p><a id="_ix2240" class="ixterm"></a>DVX adds each line the moment something happens, and the line is on the disk straight away, so the log keeps everything up to a crash. The file never grows past 512 KB: when it does, DVX removes its oldest lines and keeps the newest 256 KB at most, starting with the line &#8220;Log: older lines were removed when the log passed 524288 bytes&#8221;.</p>
</li>
<li>
<p><a id="_ix2241" class="ixterm"></a><a id="_ix2242" class="ixterm"></a>When DVX cannot write to its USER folder and there is no TEMP folder, there is no log file. DVX keeps only the last part of the log (16 KB) in memory, which is lost when it exits. To read it, open System Information in Program Manager&#8217;s <b class="menuref">Help</b> menu and scroll to its end: after the line &#8220;DVX cannot write its log to a disk, so it keeps the latest lines here:&#8221; come the latest lines of the log. To get a log file, set TEMP or DVXUSER (see <a href="#folders-read-only">Section B.1.4</a>).</p>
</li>
<li>
<p><a id="_ix2243" class="ixterm"></a>System Information always ends with where the log is: &#8220;Log file:&#8221; and the file&#8217;s full name.</p>
</li>
</ul>
</div>
</div>
<div class="sect3">
<h4 id="folders-log-reading"><a class="anchor" href="#folders-log-reading"></a>B.6.2. Reading the log</h4>
<div class="paragraph">
<p><a id="_ix2244" class="ixterm"></a>The log is a plain text file. Open it in Notepad with <span class="menuseq"><b class="menu">File</b>&#160;<b class="caret">&#8250;</b> <b class="menuitem">Open&#8230;&#8203;</b></span>, or, with DVX not running, at the DOS prompt:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>EDIT C:\DVX\USER\DVX.LOG</pre>
</div>
</div>
<div class="paragraph">
<p><a id="_ix2245" class="ixterm"></a>A very long log may be too big for Notepad, which then says so; use EDIT or <code>TYPE C:\DVX\USER\DVX.LOG | MORE</code> at the DOS prompt instead.</p>
</div>
<div class="paragraph">
<p>Each line is one note. These are the kinds of lines you find, roughly in the order they appear:</p>
</div>
<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 33.3333%;">
<col style="width: 66.6667%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Lines about</th>
<th class="tableblock halign-left valign-top">What they say</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX starting</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A line saying that DVX is starting, then the USER folder DVX uses, and each library and control that DVX loads. A part that could not be loaded has a line starting with &#8220;FAILED:&#8221; that says why, for example an add-on made for another version of DVX. A safe start notes the add-ons it left out.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">The help files</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Bringing the help files up to date, when libraries or controls were added or removed.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">The screen</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The screen mode asked for in <code>DVX.INI</code>, the list of modes the video card offers (&#8220;Available video modes:&#8221;), and the mode chosen (&#8220;Selected:&#8221;).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">The computer</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A block from &#8220;=== System Information ===&#8221; to &#8220;=== End System Information ===&#8221; with the processor, the memory, the DOS version, the TEMP folder, the video card and its memory, the mouse, and the drives.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Your settings</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Lines starting with &#8220;Preferences:&#8221; for the mouse, the colors, text smoothing, the wallpaper, and the screen saver, for example &#8220;Preferences: failed to load the wallpaper&#8221; when the picture cannot be loaded.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Programs</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Each program started, a program that could not be loaded and why, and a program that ended itself.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Crashes</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">When a program crashes, you see &#8220;'<em>name</em>' has caused a fault and will be terminated.&#8221;, and the log gets &#8220;=== CRASH ===&#8221; followed by the details, the program&#8217;s name and file, and the fact that DVX recovered by ending it.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX BASIC programs</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">An error a BASIC program did not handle, starting &#8220;BASIC RUNTIME ERROR:&#8221; with the details below it, and any notes the program writes to the log itself.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Hardware</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The sound hardware found or not found (for example the BLASTER advice in <a href="#folders-blaster">Section B.2.12</a>), the network (&#8220;no packet driver found&#8221;, and the address the network gave), game controllers, and fonts that could not be used (&#8220;Fonts:&#8221;).</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Programs at work</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Packages Software installs, removes, or publishes; Terminal&#8217;s connections and file transfers (&#8220;Terminal:&#8221;); the screen saver starting and ending; settings that could not be saved.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DVX ending</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Two lines saying that DVX is shutting down and that it has exited. A log that stops before them means DVX stopped without exiting normally.</p></td>
</tr>
</tbody>
</table>
</div>
<div class="sect3">
<h4 id="folders-log-report"><a class="anchor" href="#folders-log-report"></a>B.6.3. Sending the log with a problem report</h4>
<div class="paragraph">
<p><a id="_ix2246" class="ixterm"></a><a id="_ix2247" class="ixterm"></a><a id="_ix2248" class="ixterm"></a>When you report a problem, for example to the author of a program that failed, send the log of the session in which it happened:</p>
</div>
<div class="olist arabic">
<ol class="arabic">
<li>
<p>When the problem happens, write down what you were doing, and the exact words of any message, including its title.</p>
</li>
<li>
<p>If DVX is still running, exit it if you can. (The log is complete up to the moment of the problem even if DVX stopped.)</p>
</li>
<li>
<p>Before you start DVX again, copy the log, for example to a floppy disk or under another name:</p>
<div class="listingblock">
<div class="content">
<pre>COPY C:\DVX\USER\DVX.LOG A:\DVX.LOG</pre>
</div>
</div>
<div class="paragraph">
<p>If you set DVXUSER, copy <code>DVX.LOG</code> from the folder it names.</p>
</div>
</li>
<li>
<p>Send the copy with your report, together with what you wrote down.</p>
</li>
</ol>
</div>
<div class="paragraph">
<p>The log already describes your computer (processor, memory, video card, and drives), so you do not need to list them. It does contain the names of your folders and of the files programs used; read it first if that matters to you.</p>
</div>
<div class="paragraph">
<p><a id="_ix2249" class="ixterm"></a>For a problem with Setup itself, start it as <code>SETUP /LOG=C:\SETUP.LOG</code> and send the file <code>C:\SETUP.LOG</code> it writes.</p>
</div>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="index">Index</h2>
<div class="sectionbody dvx-index">
<p class="ixjump"><a href="#_ixgroup_A">A</a> <a href="#_ixgroup_B">B</a> <a href="#_ixgroup_C">C</a> <a href="#_ixgroup_D">D</a> <a href="#_ixgroup_E">E</a> <a href="#_ixgroup_F">F</a> <a href="#_ixgroup_G">G</a> <a href="#_ixgroup_H">H</a> <a href="#_ixgroup_I">I</a> <a href="#_ixgroup_J">J</a> <a href="#_ixgroup_K">K</a> <a href="#_ixgroup_L">L</a> <a href="#_ixgroup_M">M</a> <a href="#_ixgroup_N">N</a> <a href="#_ixgroup_O">O</a> <a href="#_ixgroup_P">P</a> <a href="#_ixgroup_R">R</a> <a href="#_ixgroup_S">S</a> <a href="#_ixgroup_T">T</a> <a href="#_ixgroup_U">U</a> <a href="#_ixgroup_V">V</a> <a href="#_ixgroup_W">W</a> <a href="#_ixgroup_X">X</a> <a href="#_ixgroup_Y">Y</a> <a href="#_ixgroup_Z">Z</a></p>
<h3 id="_ixgroup_A">A</h3>
<ul class="ixlist">
<li><span class="ixname">Abort</span>
<ul>
<li><span class="ixname">Retry</span>
<ul>
<li><span class="ixname">Fail</span>, <a href="#_ix1828">11.12.5. Read-only disks, CD-ROMs, and empty drives</a></li>
</ul></li>
</ul></li>
<li><span class="ixname">About DVX</span>, <a href="#_ix637">6.10.5. Help menu</a></li>
<li><span class="ixname">active window</span>, <a href="#_ix328">5.2.2. The keyboard</a></li>
<li><span class="ixname">add-ons</span>, <a href="#_ix6">1.1. What DVX is</a>, <a href="#_ix1201">10. Managing Add-ons</a>
<ul>
<li><span class="ixname">adding later</span>, <a href="#_ix162">3.6. The add-ons on the CD</a></li>
<li><span class="ixname">after installing</span>, <a href="#_ix1278">10.3.7. When the install is done</a></li>
<li><span class="ixname">cancelling</span>, <a href="#_ix1277">10.3.6. Progress and Cancel</a></li>
<li><span class="ixname">could not be loaded</span>, <a href="#_ix1455">11.2.9. DVX says add-ons were not loaded</a></li>
<li><span class="ixname">disk space</span>, <a href="#_ix1274">10.3.5. Disk space</a></li>
<li><span class="ixname">DVX General MIDI</span>, <a href="#_ix47">1.4.3. Sounds and music</a>, <a href="#_ix156">3.6. The add-ons on the CD</a></li>
<li><span class="ixname">files in SHARED</span>, <a href="#_ix1986">B.1.1. The DVX folder</a></li>
<li><span class="ixname">finding</span>, <a href="#_ix1238">10.2.3. The Available page</a></li>
<li><span class="ixname">install problems</span>, <a href="#_ix1285">10.3.8. When a package cannot be installed</a></li>
<li><span class="ixname">installed by Setup</span>, <a href="#_ix161">3.6. The add-ons on the CD</a></li>
<li><span class="ixname">installing</span>, <a href="#_ix1253">10.3. Installing add-ons</a></li>
<li><span class="ixname">installing from a file</span>, <a href="#_ix1255">10.3.1. Installing from a file</a></li>
<li><span class="ixname">installing from the package server</span>, <a href="#_ix1262">10.3.2. Installing from the package server</a></li>
<li><span class="ixname">kinds</span>, <a href="#_ix1208">10.1.1. Kinds of packages</a></li>
<li><span class="ixname">made for another version</span>, <a href="#_ix1371">10.10.2. Add-ons made for another version of DVX</a></li>
<li><span class="ixname">More Fonts</span>, <a href="#_ix40">1.4.1. Fonts</a>, <a href="#_ix158">3.6. The add-ons on the CD</a></li>
<li><span class="ixname">not loaded</span>, <a href="#_ix1369">10.10.1. Add-ons left out at start-up</a></li>
<li><span class="ixname">not loaded at start</span>, <a href="#_ix238">3.12.2. What you see while DVX starts</a></li>
<li><span class="ixname">on the CD</span>, <a href="#_ix154">3.6. The add-ons on the CD</a>, <a href="#_ix1265">10.3.3. The add-ons on the DVX CD</a></li>
<li><span class="ixname">per-user settings</span>, <a href="#_ix1227">10.1.3. Where add-ons are installed</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix1722">11.11. Setup, add-ons, and Software</a></li>
<li><span class="ixname">programs</span>, <a href="#_ix1209">10.1.1. Kinds of packages</a></li>
<li><span class="ixname">publishing</span>, <a href="#_ix1332">10.7. Publishing your own packages</a></li>
<li><span class="ixname">removing</span>, <a href="#_ix1298">10.4. Removing add-ons</a></li>
<li><span class="ixname">removing at the DOS prompt</span>, <a href="#_ix1458">11.2.9. DVX says add-ons were not loaded</a></li>
<li><span class="ixname">safe start</span>, <a href="#_ix250">3.13.2. Safe start</a>, <a href="#_ix1374">10.10.3. Starting without add-ons</a></li>
<li><span class="ixname">signatures</span>, <a href="#_ix160">3.6. The add-ons on the CD</a></li>
<li><span class="ixname">signed</span>, <a href="#_ix1339">10.8. Signatures and trusted publishers</a></li>
<li><span class="ixname">Software program</span>, <a href="#_ix1231">10.2. The Software program</a></li>
<li><span class="ixname">stop working with new DVX</span>, <a href="#_ix1313">10.5.1. Updating DVX itself</a></li>
<li><span class="ixname">trouble</span>, <a href="#_ix1367">10.10. When an add-on causes trouble</a></li>
<li><span class="ixname">trusted keys</span>, <a href="#_ix2219">B.4.7. KEYS: publisher keys</a></li>
<li><span class="ixname">unsigned</span>, <a href="#_ix1345">10.8.2. Unsigned packages</a></li>
<li><span class="ixname">updating</span>, <a href="#_ix1306">10.5. Keeping DVX and your add-ons up to date</a></li>
<li><span class="ixname">updating one</span>, <a href="#_ix1310">10.5. Keeping DVX and your add-ons up to date</a></li>
<li><span class="ixname">upgrading</span>, <a href="#_ix1280">10.3.7. When the install is done</a></li>
<li><span class="ixname">what they are</span>, <a href="#_ix1203">10.1. Add-ons and packages</a></li>
<li><span class="ixname">what will be installed</span>, <a href="#_ix1272">10.3.4. The Install Software window</a></li>
<li><span class="ixname">where installed</span>, <a href="#_ix1223">10.1.3. Where add-ons are installed</a></li>
</ul></li>
<li><span class="ixname">Alt+Tab</span>, <a href="#_ix347">5.3.2. The active window and switching windows</a></li>
<li><span class="ixname">ANSI music</span>, <a href="#_ix1182">9.8.5. ANSI music and the bell</a></li>
<li><span class="ixname">ANSI terminal</span>, <a href="#_ix1176">9.8.1. Terminal emulation</a></li>
<li><span class="ixname">answerback</span>, <a href="#_ix1181">9.8.4. Answerback</a></li>
<li><span class="ixname">Application Error</span>, <a href="#_ix1908">11.13.4. A program crashes</a></li>
<li><span class="ixname">APPS folder</span>, <a href="#_ix1975">B.1.1. The DVX folder</a></li>
<li><span class="ixname">ASSOC.INI</span>, <a href="#_ix1991">B.1.2. The USER folder</a>, <a href="#_ix2188">B.3. ASSOC.INI: which program opens each kind of file</a>
<ul>
<li><span class="ixname">editing by hand</span>, <a href="#_ix2197">B.3. ASSOC.INI: which program opens each kind of file</a></li>
<li><span class="ixname">example</span>, <a href="#_ix2193">B.3. ASSOC.INI: which program opens each kind of file</a></li>
<li><span class="ixname">format</span>, <a href="#_ix2192">B.3. ASSOC.INI: which program opens each kind of file</a></li>
</ul></li>
<li><span class="ixname">Auto Arrange</span>, <a href="#_ix612">6.5. Views and arranging icons</a></li>
<li><span class="ixname">AUTOEXEC.BAT</span>
<ul>
<li><span class="ixname">BLASTER</span>, <a href="#_ix1546">11.7.3. Sound Blaster cards and the BLASTER setting</a></li>
<li><span class="ixname">BLASTER and ULTRASND</span>, <a href="#_ix829">7.12.4. Choosing and testing instruments</a>, <a href="#_ix2153">B.2.12. Sound card settings in AUTOEXEC.BAT: BLASTER and ULTRASND</a></li>
<li><span class="ixname">drivers</span>, <a href="#_ix64">2.2.3. DOS</a></li>
<li><span class="ixname">DVXUSER</span>, <a href="#_ix217">3.11. Where DVX puts its files</a>, <a href="#_ix2007">B.1.3. Keeping the USER folder somewhere else: DVXUSER</a></li>
<li><span class="ixname">editing</span>, <a href="#_ix177">3.7.4. Starting DVX when the computer starts</a>, <a href="#_ix1400">11.1.8. Change AUTOEXEC.BAT or CONFIG.SYS</a></li>
<li><span class="ixname">mouse driver</span>, <a href="#_ix1505">11.4.1. The pointer does not move</a></li>
<li><span class="ixname">packet driver</span>, <a href="#_ix274">4.3. Loading the packet driver</a>, <a href="#_ix1643">11.9.1. How DVX uses the network</a></li>
<li><span class="ixname">Setup</span>, <a href="#_ix1750">11.11.7. After installing: settings and AUTOEXEC.BAT</a></li>
<li><span class="ixname">sound settings</span>, <a href="#_ix1597">11.7.18. Sound settings in DVX.INI</a></li>
<li><span class="ixname">starting DVX</span>, <a href="#_ix174">3.7.4. Starting DVX when the computer starts</a></li>
<li><span class="ixname">TEMP</span>, <a href="#_ix1843">11.12.8. The TEMP folder</a>, <a href="#_ix2017">B.1.4. Running DVX from a disk it cannot write to</a></li>
<li><span class="ixname">ULTRASND</span>, <a href="#_ix1550">11.7.4. Gravis UltraSound and the ULTRASND setting</a></li>
</ul></li>
<li><span class="ixname">AUTOEXEC.DVX</span>, <a href="#_ix176">3.7.4. Starting DVX when the computer starts</a>, <a href="#_ix1751">11.11.7. After installing: settings and AUTOEXEC.BAT</a>, <a href="#_ix2224">B.4.9. Files in the DVX folder</a></li>
</ul>
<h3 id="_ixgroup_B">B</h3>
<ul class="ixlist">
<li><span class="ixname">backing up</span>, <a href="#_ix215">3.11. Where DVX puts its files</a>, <a href="#_ix2023">B.1.5. Backing up your settings and files</a>
<ul>
<li><span class="ixname">USER folder</span>, <a href="#_ix1936">11.15. Going back to the default settings</a></li>
</ul></li>
<li><span class="ixname">BASIC Demo</span>, <a href="#_ix847">8.1. Which programs you have</a>, <a href="#_ix1018">8.11.2. BASIC Demo</a>
<ul>
<li><span class="ixname">menus</span>, <a href="#_ix1019">8.11.2. BASIC Demo</a></li>
<li><span class="ixname">printing</span>, <a href="#_ix1633">11.8.8. Printing from particular programs</a></li>
</ul></li>
<li><span class="ixname">BASIC programs</span>
<ul>
<li><span class="ixname">errors</span>, <a href="#_ix1923">11.14. Error messages from DVX BASIC programs</a></li>
</ul></li>
<li><span class="ixname">BASIC Runtime Error</span>, <a href="#_ix1924">11.14. Error messages from DVX BASIC programs</a></li>
<li><span class="ixname">bell</span>, <a href="#_ix1187">9.8.5. ANSI music and the bell</a></li>
<li><span class="ixname">BLASTER setting</span>, <a href="#_ix91">2.6.1. Sound cards</a>, <a href="#_ix1545">11.7.3. Sound Blaster cards and the BLASTER setting</a>, <a href="#_ix2151">B.2.12. Sound card settings in AUTOEXEC.BAT: BLASTER and ULTRASND</a></li>
<li><span class="ixname">bulletin boards</span>, <a href="#_ix1045">9. Terminal</a></li>
<li><span class="ixname">bundles</span>, <a href="#_ix1216">10.1.1. Kinds of packages</a>
<ul>
<li><span class="ixname">on the Installed page</span>, <a href="#_ix1234">10.2.2. The Installed page</a></li>
<li><span class="ixname">parts of DVX</span>, <a href="#_ix1359">10.9. The optional parts of DVX</a></li>
</ul></li>
<li><span class="ixname">buttons</span>, <a href="#_ix398">5.5.3.1. Buttons</a></li>
</ul>
<h3 id="_ixgroup_C">C</h3>
<ul class="ixlist">
<li><span class="ixname">capture</span>
<ul>
<li><span class="ixname">Terminal</span>, <a href="#_ix1191">9.8.7. Capturing to a file</a></li>
</ul></li>
<li><span class="ixname">Cascade</span>, <a href="#_ix369">5.3.10. Arranging windows</a></li>
<li><span class="ixname">CD</span>, <a href="#_ix116">3.1.1. The CD</a></li>
<li><span class="ixname">CD-ROM</span>
<ul>
<li><span class="ixname">cannot write</span>, <a href="#_ix1826">11.12.5. Read-only disks, CD-ROMs, and empty drives</a></li>
<li><span class="ixname">running DVX from</span>, <a href="#_ix1830">11.12.6. DVX runs from a disk it cannot write to</a>, <a href="#_ix2014">B.1.4. Running DVX from a disk it cannot write to</a></li>
</ul></li>
<li><span class="ixname">check boxes</span>, <a href="#_ix400">5.5.3.2. Check boxes</a></li>
<li><span class="ixname">clipboard</span>, <a href="#_ix4">1.1. What DVX is</a>, <a href="#_ix466">5.7. Copying and pasting</a>
<ul>
<li><span class="ixname">between programs</span>, <a href="#_ix472">5.7. Copying and pasting</a></li>
<li><span class="ixname">files</span>, <a href="#_ix892">8.3.5. Copying and moving files and folders</a></li>
<li><span class="ixname">Notepad</span>, <a href="#_ix924">8.4.3. Typing and editing</a></li>
<li><span class="ixname">Terminal</span>, <a href="#_ix1067">9.3.2. Using the terminal screen</a></li>
</ul></li>
<li><span class="ixname">Clock</span>, <a href="#_ix14">1.2. The programs that come with DVX</a>, <a href="#_ix837">8.1. Which programs you have</a>, <a href="#_ix944">8.5. Clock</a>
<ul>
<li><span class="ixname">more than one</span>, <a href="#_ix947">8.5. Clock</a></li>
<li><span class="ixname">setting the time</span>, <a href="#_ix948">8.5. Clock</a></li>
</ul></li>
<li><span class="ixname">Close box</span>, <a href="#_ix338">5.3.1. Parts of a window</a></li>
<li><span class="ixname">colors</span>
<ul>
<li><span class="ixname">changing</span>, <a href="#_ix685">7.5. Colors page</a></li>
<li><span class="ixname">color box</span>, <a href="#_ix698">7.5.1. The color box</a></li>
<li><span class="ixname">DVX.INI</span>, <a href="#_ix2163">B.2.14. The <code>[colors]</code> section: screen colors</a></li>
<li><span class="ixname">number of</span>, <a href="#_ix2055">B.2.5. The <code>[video]</code> section: screen mode</a></li>
<li><span class="ixname">parts of the screen</span>, <a href="#_ix688">7.5. Colors page</a></li>
<li><span class="ixname">standard</span>, <a href="#_ix697">7.5. Colors page</a></li>
</ul></li>
<li><span class="ixname">column lists</span>, <a href="#_ix419">5.5.3.6. Lists</a></li>
<li><span class="ixname">combo boxes</span>, <a href="#_ix422">5.5.3.7. Drop-down lists</a></li>
<li><span class="ixname">command line</span>
<ul>
<li><span class="ixname">DVX</span>, <a href="#_ix229">3.12.1. DVX&#8217;s command-line switches</a>, <a href="#_ix1461">11.2.10. Starting DVX with switches</a></li>
</ul></li>
<li><span class="ixname">Communications part</span>, <a href="#_ix28">1.3. The optional parts</a>
<ul>
<li><span class="ixname">Networking</span>, <a href="#_ix1366">10.9.3. What needs Networking</a></li>
</ul></li>
<li><span class="ixname">computer name</span>, <a href="#_ix286">4.4.4. Computer name and packet driver</a></li>
<li><span class="ixname">CONFIG.SYS</span>
<ul>
<li><span class="ixname">editing</span>, <a href="#_ix1401">11.1.8. Change AUTOEXEC.BAT or CONFIG.SYS</a></li>
<li><span class="ixname">memory</span>, <a href="#_ix1431">11.2.6. Memory messages before the title screen</a></li>
</ul></li>
<li><span class="ixname">context menus</span>, <a href="#_ix383">5.4.4. Context menus</a></li>
<li><span class="ixname">Control Panel</span>, <a href="#_ix17">1.2. The programs that come with DVX</a>, <a href="#_ix645">7. Control Panel</a>, <a href="#_ix864">8.2.7. Programs described elsewhere</a>
<ul>
<li><span class="ixname">Acceleration</span>, <a href="#_ix678">7.4. Mouse page</a></li>
<li><span class="ixname">Add file type</span>, <a href="#_ix743">7.8. File Types page</a></li>
<li><span class="ixname">already open</span>, <a href="#_ix651">7.1. Opening Control Panel</a></li>
<li><span class="ixname">Apply buttons</span>, <a href="#_ix656">7.2. The Control Panel window</a></li>
<li><span class="ixname">Apply Mode</span>, <a href="#_ix725">7.7. Video page</a></li>
<li><span class="ixname">Available Video Modes</span>, <a href="#_ix724">7.7. Video page</a></li>
<li><span class="ixname">canceling changes</span>, <a href="#_ix667">7.3.2. Clicking Cancel</a></li>
<li><span class="ixname">Change color</span>, <a href="#_ix690">7.5. Colors page</a></li>
<li><span class="ixname">Colors page</span>, <a href="#_ix686">7.5. Colors page</a>, <a href="#_ix1496">11.3.6. Colors, themes, and the desktop picture</a></li>
<li><span class="ixname">Computer name</span>, <a href="#_ix762">7.9. Network page</a></li>
<li><span class="ixname">Connected to</span>, <a href="#_ix773">7.10. Printer page</a></li>
<li><span class="ixname">Controller</span>, <a href="#_ix787">7.11. Game Controllers page</a></li>
<li><span class="ixname">Cursor Speed</span>, <a href="#_ix681">7.4. Mouse page</a></li>
<li><span class="ixname">Dead zone</span>, <a href="#_ix792">7.11. Game Controllers page</a></li>
<li><span class="ixname">Desktop page</span>, <a href="#_ix703">7.6. Desktop page</a>, <a href="#_ix1027">8.12. Screen savers</a>, <a href="#_ix1497">11.3.6. Colors, themes, and the desktop picture</a></li>
<li><span class="ixname">DHCP</span>, <a href="#_ix754">7.9. Network page</a></li>
<li><span class="ixname">Double-Click Speed</span>, <a href="#_ix676">7.4. Mouse page</a></li>
<li><span class="ixname">Events</span>, <a href="#_ix802">7.12.1. Event sounds</a></li>
<li><span class="ixname">File Types page</span>, <a href="#_ix739">7.8. File Types page</a>, <a href="#_ix857">8.2.4. Opening documents</a>, <a href="#_ix1894">11.13.1. A program will not start</a>, <a href="#_ix2195">B.3. ASSOC.INI: which program opens each kind of file</a></li>
<li><span class="ixname">Game Controllers page</span>, <a href="#_ix785">7.11. Game Controllers page</a></li>
<li><span class="ixname">Game port</span>, <a href="#_ix794">7.11. Game Controllers page</a></li>
<li><span class="ixname">Help menu</span>, <a href="#_ix653">7.2. The Control Panel window</a></li>
<li><span class="ixname">Instruments</span>, <a href="#_ix822">7.12.2. Sound hardware and music</a></li>
<li><span class="ixname">keyboard</span>, <a href="#_ix659">7.2.1. Using the keyboard</a></li>
<li><span class="ixname">Keyboard joystick</span>, <a href="#_ix796">7.11. Game Controllers page</a></li>
<li><span class="ixname">MIDI in</span>, <a href="#_ix818">7.12.2. Sound hardware and music</a></li>
<li><span class="ixname">MIDI music</span>, <a href="#_ix816">7.12.2. Sound hardware and music</a></li>
<li><span class="ixname">missing settings</span>, <a href="#_ix830">7.13. Settings that are not in Control Panel</a></li>
<li><span class="ixname">Modules</span>, <a href="#_ix820">7.12.2. Sound hardware and music</a></li>
<li><span class="ixname">Mouse page</span>, <a href="#_ix669">7.4. Mouse page</a></li>
<li><span class="ixname">Name server</span>, <a href="#_ix760">7.9. Network page</a></li>
<li><span class="ixname">network Address</span>, <a href="#_ix756">7.9. Network page</a></li>
<li><span class="ixname">Network page</span>, <a href="#_ix278">4.4. Network settings</a>, <a href="#_ix751">7.9. Network page</a>, <a href="#_ix1648">11.9.2. The Network Status window</a></li>
<li><span class="ixname">OK and Cancel</span>, <a href="#_ix390">5.5.1. How dialog boxes work</a>, <a href="#_ix655">7.2. The Control Panel window</a>, <a href="#_ix661">7.3. Trying out, keeping, and canceling changes</a></li>
<li><span class="ixname">opening</span>, <a href="#_ix647">7.1. Opening Control Panel</a></li>
<li><span class="ixname">Packet driver</span>, <a href="#_ix763">7.9. Network page</a></li>
<li><span class="ixname">page not installed</span>, <a href="#_ix657">7.2. The Control Panel window</a></li>
<li><span class="ixname">Printer model</span>, <a href="#_ix771">7.10. Printer page</a></li>
<li><span class="ixname">Printer page</span>, <a href="#_ix769">7.10. Printer page</a>, <a href="#_ix1602">11.8.1. Check the printer settings first</a></li>
<li><span class="ixname">saving settings</span>, <a href="#_ix663">7.3.1. Clicking OK</a></li>
<li><span class="ixname">Screen saver</span>, <a href="#_ix715">7.6.2. Screen saver</a></li>
<li><span class="ixname">screen saver Wait</span>, <a href="#_ix718">7.6.2. Screen saver</a></li>
<li><span class="ixname">Scroll Speed</span>, <a href="#_ix673">7.4. Mouse page</a></li>
<li><span class="ixname">Scroll Wheel</span>, <a href="#_ix671">7.4. Mouse page</a></li>
<li><span class="ixname">settings not saved</span>, <a href="#_ix1848">11.12.9. Saving onto a full disk</a></li>
<li><span class="ixname">Smooth the edges of text</span>, <a href="#_ix728">7.7. Video page</a></li>
<li><span class="ixname">Sound</span>, <a href="#_ix803">7.12.1. Event sounds</a></li>
<li><span class="ixname">Sound driver</span>, <a href="#_ix809">7.12.2. Sound hardware and music</a></li>
<li><span class="ixname">SoundFont</span>, <a href="#_ix824">7.12.2. Sound hardware and music</a></li>
<li><span class="ixname">Sounds page</span>, <a href="#_ix800">7.12. Sounds page</a>, <a href="#_ix973">8.7.7. Where the music plays</a>, <a href="#_ix1540">11.7.2. Nothing is heard</a></li>
<li><span class="ixname">System Colors</span>, <a href="#_ix689">7.5. Colors page</a></li>
<li><span class="ixname">tabs</span>, <a href="#_ix654">7.2. The Control Panel window</a></li>
<li><span class="ixname">Test Area</span>, <a href="#_ix683">7.4. Mouse page</a></li>
<li><span class="ixname">Theme</span>, <a href="#_ix692">7.5. Colors page</a></li>
<li><span class="ixname">Video page</span>, <a href="#_ix722">7.7. Video page</a>, <a href="#_ix1478">11.3.3. Choosing another screen mode</a></li>
<li><span class="ixname">Volume</span>, <a href="#_ix806">7.12.1. Event sounds</a></li>
<li><span class="ixname">Wallpaper</span>, <a href="#_ix707">7.6.1. Wallpaper</a></li>
<li><span class="ixname">wallpaper Mode</span>, <a href="#_ix711">7.6.1. Wallpaper</a></li>
<li><span class="ixname">when changes take effect</span>, <a href="#_ix662">7.3. Trying out, keeping, and canceling changes</a></li>
<li><span class="ixname">window</span>, <a href="#_ix652">7.2. The Control Panel window</a></li>
</ul></li>
<li><span class="ixname">controls</span>, <a href="#_ix397">5.5.3. Controls</a>
<ul>
<li><span class="ixname">buttons</span>, <a href="#_ix399">5.5.3.1. Buttons</a></li>
<li><span class="ixname">check boxes</span>, <a href="#_ix401">5.5.3.2. Check boxes</a></li>
<li><span class="ixname">drop-down lists</span>, <a href="#_ix421">5.5.3.7. Drop-down lists</a></li>
<li><span class="ixname">lists</span>, <a href="#_ix414">5.5.3.6. Lists</a></li>
<li><span class="ixname">number boxes</span>, <a href="#_ix411">5.5.3.5. Number boxes</a></li>
<li><span class="ixname">option buttons</span>, <a href="#_ix403">5.5.3.3. Option buttons</a></li>
<li><span class="ixname">sliders</span>, <a href="#_ix424">5.5.3.8. Sliders</a></li>
<li><span class="ixname">tabs</span>, <a href="#_ix426">5.5.3.9. Tabs</a></li>
<li><span class="ixname">text boxes</span>, <a href="#_ix406">5.5.3.4. Text boxes</a></li>
<li><span class="ixname">trees</span>, <a href="#_ix428">5.5.3.10. Trees</a></li>
</ul></li>
<li><span class="ixname">copying and pasting</span>, <a href="#_ix467">5.7. Copying and pasting</a></li>
<li><span class="ixname">crashes</span>
<ul>
<li><span class="ixname">DVX</span>, <a href="#_ix1445">11.2.7. DVX stops while starting</a></li>
</ul></li>
<li><span class="ixname">Ctrl+Break</span>, <a href="#_ix1406">11.2.1. What a normal start looks like</a>, <a href="#_ix1519">11.5.2. Other keyboard questions</a></li>
<li><span class="ixname">Ctrl+C</span>, <a href="#_ix1407">11.2.1. What a normal start looks like</a>, <a href="#_ix1520">11.5.2. Other keyboard questions</a></li>
<li><span class="ixname">CuteMouse</span>, <a href="#_ix1508">11.4.2. The scroll wheel does nothing</a></li>
<li><span class="ixname">cutting text</span>, <a href="#_ix468">5.7. Copying and pasting</a></li>
</ul>
<h3 id="_ixgroup_D">D</h3>
<ul class="ixlist">
<li><span class="ixname">databases</span>
<ul>
<li><span class="ixname">problems</span>, <a href="#_ix1883">11.12.15. Databases</a></li>
</ul></li>
<li><span class="ixname">Databases part</span>, <a href="#_ix25">1.3. The optional parts</a></li>
<li><span class="ixname">date and time</span>
<ul>
<li><span class="ixname">setting</span>, <a href="#_ix831">7.13. Settings that are not in Control Panel</a></li>
<li><span class="ixname">showing</span>, <a href="#_ix945">8.5. Clock</a></li>
</ul></li>
<li><span class="ixname">defaults</span>
<ul>
<li><span class="ixname">going back to</span>, <a href="#_ix2229">B.5. Going back to the default settings</a></li>
</ul></li>
<li><span class="ixname">demos</span>, <a href="#_ix1014">8.11. DVX Demo and BASIC Demo</a></li>
<li><span class="ixname">Demos part</span>, <a href="#_ix32">1.3. The optional parts</a></li>
<li><span class="ixname">desktop</span>, <a href="#_ix306">5. Using the Desktop</a>
<ul>
<li><span class="ixname">background</span>, <a href="#_ix308">5.1. The screen after start-up</a></li>
<li><span class="ixname">messages at start-up</span>, <a href="#_ix310">5.1. The screen after start-up</a></li>
<li><span class="ixname">picture</span>, <a href="#_ix704">7.6. Desktop page</a></li>
<li><span class="ixname">screen after start-up</span>, <a href="#_ix307">5.1. The screen after start-up</a></li>
<li><span class="ixname">what it is</span>, <a href="#_ix2">1.1. What DVX is</a></li>
</ul></li>
<li><span class="ixname">desktop sounds</span>, <a href="#_ix517">5.13. Desktop sounds</a></li>
<li><span class="ixname">developer tools</span>, <a href="#_ix1030">8.13. Developer tools</a></li>
<li><span class="ixname">Developer Tools part</span>, <a href="#_ix31">1.3. The optional parts</a></li>
<li><span class="ixname">DHCP</span>, <a href="#_ix280">4.4.1. Getting the address automatically (DHCP)</a></li>
<li><span class="ixname">dialog boxes</span>, <a href="#_ix385">5.5. Dialog boxes and controls</a>
<ul>
<li><span class="ixname">answering</span>, <a href="#_ix386">5.5.1. How dialog boxes work</a></li>
<li><span class="ixname">Cancel</span>, <a href="#_ix391">5.5.1. How dialog boxes work</a></li>
<li><span class="ixname">Choose a Folder</span>, <a href="#_ix439">5.6. Opening and saving files</a></li>
<li><span class="ixname">choosing from a list</span>, <a href="#_ix431">5.5.4. Dialog boxes that many programs share</a></li>
<li><span class="ixname">Color</span>, <a href="#_ix434">5.5.4. Dialog boxes that many programs share</a></li>
<li><span class="ixname">color</span>, <a href="#_ix699">7.5.1. The color box</a></li>
<li><span class="ixname">file dialogs</span>, <a href="#_ix1801">11.12.1. Messages in the Open, Save As, and Choose a Folder dialogs</a></li>
<li><span class="ixname">Font</span>, <a href="#_ix433">5.5.4. Dialog boxes that many programs share</a></li>
<li><span class="ixname">input box</span>, <a href="#_ix430">5.5.4. Dialog boxes that many programs share</a></li>
<li><span class="ixname">keys</span>, <a href="#_ix387">5.5.1. How dialog boxes work</a></li>
<li><span class="ixname">message boxes</span>, <a href="#_ix392">5.5.2. Message boxes</a>, <a href="#_ix1380">11.1.1. Read the message</a></li>
<li><span class="ixname">Open</span>, <a href="#_ix437">5.6. Opening and saving files</a></li>
<li><span class="ixname">Run</span>, <a href="#_ix621">6.7. Running a command</a></li>
<li><span class="ixname">Save As</span>, <a href="#_ix438">5.6. Opening and saving files</a></li>
<li><span class="ixname">standard</span>, <a href="#_ix429">5.5.4. Dialog boxes that many programs share</a></li>
</ul></li>
<li><span class="ixname">disk space</span>, <a href="#_ix83">2.5. Disk space</a>
<ul>
<li><span class="ixname">add-ons</span>, <a href="#_ix1766">11.11.12. The Install Software window</a></li>
<li><span class="ixname">before saving</span>, <a href="#_ix1846">11.12.9. Saving onto a full disk</a></li>
<li><span class="ixname">each choice</span>, <a href="#_ix85">2.5. Disk space</a></li>
<li><span class="ixname">Setup</span>, <a href="#_ix140">3.3.5. Choosing what to install</a>, <a href="#_ix1732">11.11.3. Not enough disk space, or the folder cannot be made</a></li>
<li><span class="ixname">upgrade</span>, <a href="#_ix86">2.5. Disk space</a></li>
<li><span class="ixname">wrong</span>, <a href="#_ix1822">11.12.4. Big disks and big files</a></li>
</ul></li>
<li><span class="ixname">disks</span>
<ul>
<li><span class="ixname">empty drive</span>, <a href="#_ix1827">11.12.5. Read-only disks, CD-ROMs, and empty drives</a></li>
<li><span class="ixname">full</span>, <a href="#_ix1845">11.12.9. Saving onto a full disk</a>, <a href="#_ix1866">11.12.11. Notepad</a></li>
<li><span class="ixname">large</span>, <a href="#_ix1820">11.12.4. Big disks and big files</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix1800">11.12. Files, disks, and folders</a></li>
<li><span class="ixname">read-only</span>, <a href="#_ix1824">11.12.5. Read-only disks, CD-ROMs, and empty drives</a></li>
<li><span class="ixname">write-protected</span>, <a href="#_ix1825">11.12.5. Read-only disks, CD-ROMs, and empty drives</a></li>
</ul></li>
<li><span class="ixname">DNS</span>, <a href="#_ix285">4.4.3. Name servers</a></li>
<li><span class="ixname">documents</span>
<ul>
<li><span class="ixname">opening from Program Manager</span>, <a href="#_ix549">6.2. Starting programs</a></li>
<li><span class="ixname">opening with Run</span>, <a href="#_ix622">6.7. Running a command</a></li>
<li><span class="ixname">which program opens</span>, <a href="#_ix740">7.8. File Types page</a></li>
</ul></li>
<li><span class="ixname">DOS programs</span>, <a href="#_ix7">1.1. What DVX is</a>, <a href="#_ix521">5.15. Running DOS programs</a>
<ul>
<li><span class="ixname">adding</span>, <a href="#_ix628">6.8.1. Setting up a DOS program item</a></li>
<li><span class="ixname">after it ends</span>, <a href="#_ix526">5.15. Running DOS programs</a></li>
<li><span class="ixname">closing other programs first</span>, <a href="#_ix523">5.15. Running DOS programs</a></li>
<li><span class="ixname">from File Manager</span>, <a href="#_ix884">8.3.4. Opening files and starting programs</a></li>
<li><span class="ixname">network</span>, <a href="#_ix277">4.3. Loading the packet driver</a></li>
<li><span class="ixname">opening documents with</span>, <a href="#_ix746">7.8.1. The Add File Type and Change File Type boxes</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix1914">11.13.6. DOS programs</a></li>
<li><span class="ixname">Program Manager items</span>, <a href="#_ix626">6.8. DOS program items</a></li>
<li><span class="ixname">running</span>, <a href="#_ix522">5.15. Running DOS programs</a>, <a href="#_ix629">6.8.2. What happens when it runs</a></li>
<li><span class="ixname">while running</span>, <a href="#_ix525">5.15. Running DOS programs</a></li>
</ul></li>
<li><span class="ixname">DOS prompt tools</span>, <a href="#_ix1043">8.13.7. Tools for the DOS prompt</a></li>
<li><span class="ixname">DOS version</span>, <a href="#_ix62">2.2.3. DOS</a></li>
<li><span class="ixname">DOSLFN</span>, <a href="#_ix1818">11.12.3. Long file names</a></li>
<li><span class="ixname">double-click speed</span>, <a href="#_ix675">7.4. Mouse page</a></li>
<li><span class="ixname">DOWNLOAD folder</span>, <a href="#_ix1784">11.11.16. The package server cannot be reached</a>, <a href="#_ix1998">B.1.2. The USER folder</a>, <a href="#_ix2221">B.4.8. DOWNLOAD</a></li>
<li><span class="ixname">downloading files</span>, <a href="#_ix1129">9.6. Sending and receiving files</a></li>
<li><span class="ixname">DPK files</span>, <a href="#_ix1205">10.1. Add-ons and packages</a></li>
<li><span class="ixname">drives</span>, <a href="#_ix444">5.6.1. Parts of the dialog box</a>, <a href="#_ix464">5.6.7. Drives</a></li>
<li><span class="ixname">drop-down lists</span>, <a href="#_ix420">5.5.3.7. Drop-down lists</a></li>
<li><span class="ixname">DVX</span>, <a href="#_ix1">1. About DVX</a>
<ul>
<li><span class="ixname">exiting</span>, <a href="#_ix530">5.16. Exiting DVX</a>, <a href="#_ix1911">11.13.5. DVX will not exit</a></li>
<li><span class="ixname">licence</span>, <a href="#_ix8">1.1. What DVX is</a></li>
<li><span class="ixname">updating</span>, <a href="#_ix1312">10.5.1. Updating DVX itself</a></li>
</ul></li>
<li><span class="ixname">DVX BASIC</span>, <a href="#_ix24">1.3. The optional parts</a>, <a href="#_ix845">8.1. Which programs you have</a>, <a href="#_ix1032">8.13.1. DVX BASIC</a>
<ul>
<li><span class="ixname">error messages</span>, <a href="#_ix1922">11.14. Error messages from DVX BASIC programs</a></li>
<li><span class="ixname">error numbers</span>, <a href="#_ix1928">11.14.5. Error numbers</a></li>
<li><span class="ixname">find and replace</span>, <a href="#_ix1034">8.13.1. DVX BASIC</a></li>
<li><span class="ixname">first program</span>, <a href="#_ix1033">8.13.1. DVX BASIC</a></li>
<li><span class="ixname">message title</span>, <a href="#_ix1385">11.1.1. Read the message</a></li>
<li><span class="ixname">missing library</span>, <a href="#_ix1927">11.14.3. A part of DVX the program needs is missing</a></li>
<li><span class="ixname">settings file</span>, <a href="#_ix2211">B.4.4. DVX BASIC: DVXBASIC.INI</a></li>
</ul></li>
<li><span class="ixname">DVX Demo</span>, <a href="#_ix846">8.1. Which programs you have</a>, <a href="#_ix1015">8.11.1. DVX Demo</a>
<ul>
<li><span class="ixname">Debug Layout</span>, <a href="#_ix1017">8.11.1. DVX Demo</a></li>
<li><span class="ixname">menus</span>, <a href="#_ix1016">8.11.1. DVX Demo</a></li>
<li><span class="ixname">messages</span>, <a href="#_ix1873">11.12.12. Other programs' file messages</a></li>
</ul></li>
<li><span class="ixname">DVX General MIDI</span>, <a href="#_ix1267">10.3.3. The add-ons on the DVX CD</a>, <a href="#_ix1568">11.7.10. MIDI music plays on the wrong instruments, or sounds like the FM chip</a></li>
<li><span class="ixname">DVX Help</span>, <a href="#_ix16">1.2. The programs that come with DVX</a>, <a href="#_ix510">5.11. Getting help</a>, <a href="#_ix839">8.1. Which programs you have</a>, <a href="#_ix995">8.9. DVX Help</a>
<ul>
<li><span class="ixname">back and forward</span>, <a href="#_ix1001">8.9.4. Going back and forward</a></li>
<li><span class="ixname">F1 key</span>, <a href="#_ix850">8.2.2. Help for every program</a></li>
<li><span class="ixname">from Program Manager</span>, <a href="#_ix636">6.10.5. Help menu</a></li>
<li><span class="ixname">index</span>, <a href="#_ix1002">8.9.5. Looking things up in the index</a></li>
<li><span class="ixname">keys</span>, <a href="#_ix1005">8.9.7. DVX Help menu and keys</a></li>
<li><span class="ixname">links</span>, <a href="#_ix1000">8.9.3. Reading pages and following links</a></li>
<li><span class="ixname">opening</span>, <a href="#_ix996">8.9.1. Opening DVX Help</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix1880">11.12.14. Help files</a></li>
<li><span class="ixname">search</span>, <a href="#_ix1003">8.9.6. Searching</a></li>
<li><span class="ixname">table of contents</span>, <a href="#_ix999">8.9.2. The DVX Help window</a></li>
<li><span class="ixname">user guide</span>, <a href="#_ix997">8.9.1. Opening DVX Help</a></li>
<li><span class="ixname">window</span>, <a href="#_ix998">8.9.2. The DVX Help window</a></li>
</ul></li>
<li><span class="ixname">DVX.EXE</span>, <a href="#_ix227">3.12. Starting DVX</a>, <a href="#_ix1967">B.1.1. The DVX folder</a>
<ul>
<li><span class="ixname">/SAFE switch</span>, <a href="#_ix1451">11.2.8. Safe start</a></li>
<li><span class="ixname">switches</span>, <a href="#_ix1460">11.2.10. Starting DVX with switches</a></li>
</ul></li>
<li><span class="ixname">DVX.INI</span>, <a href="#_ix1990">B.1.2. The USER folder</a>, <a href="#_ix2028">B.2. DVX.INI, the settings file</a>
<ul>
<li><span class="ixname">acceleration</span>, <a href="#_ix2063">B.2.6. The <code>[mouse]</code> section</a></li>
<li><span class="ixname">address</span>, <a href="#_ix2076">B.2.8. The <code>[network]</code> section</a></li>
<li><span class="ixname">audio section</span>, <a href="#_ix1538">11.7.1. How DVX finds the sound card</a>, <a href="#_ix1595">11.7.18. Sound settings in DVX.INI</a>, <a href="#_ix2115">B.2.11. The <code>[audio]</code> section: sound hardware and music</a></li>
<li><span class="ixname">back to defaults</span>, <a href="#_ix1933">11.15. Going back to the default settings</a></li>
<li><span class="ixname">baud</span>, <a href="#_ix2101">B.2.10. The <code>[printer]</code> section</a></li>
<li><span class="ixname">bits</span>, <a href="#_ix2123">B.2.11. The <code>[audio]</code> section: sound hardware and music</a></li>
<li><span class="ixname">bpp</span>, <a href="#_ix2054">B.2.5. The <code>[video]</code> section: screen mode</a></li>
<li><span class="ixname">cannot be read</span>, <a href="#_ix2048">B.2.3. How DVX reads and saves the file</a></li>
<li><span class="ixname">changing by hand</span>, <a href="#_ix2037">B.2.2. Changing DVX.INI by hand</a></li>
<li><span class="ixname">channels</span>, <a href="#_ix2124">B.2.11. The <code>[audio]</code> section: sound hardware and music</a></li>
<li><span class="ixname">colors section</span>, <a href="#_ix2162">B.2.14. The <code>[colors]</code> section: screen colors</a></li>
<li><span class="ixname">columns</span>, <a href="#_ix2105">B.2.10. The <code>[printer]</code> section</a></li>
<li><span class="ixname">comments</span>, <a href="#_ix2043">B.2.3. How DVX reads and saves the file</a></li>
<li><span class="ixname">Control Panel settings</span>, <a href="#_ix664">7.3.1. Clicking OK</a></li>
<li><span class="ixname">copy before editing</span>, <a href="#_ix2038">B.2.2. Changing DVX.INI by hand</a></li>
<li><span class="ixname">damaged</span>, <a href="#_ix1934">11.15. Going back to the default settings</a></li>
<li><span class="ixname">deadZone</span>, <a href="#_ix2183">B.2.17. The <code>[joystick]</code> section: game controllers</a></li>
<li><span class="ixname">deleting</span>, <a href="#_ix1392">11.1.4. Go back to the default settings</a>, <a href="#_ix2230">B.5. Going back to the default settings</a></li>
<li><span class="ixname">desktop key</span>, <a href="#_ix2067">B.2.7. The <code>[shell]</code> section: the desktop and the Welcome window</a></li>
<li><span class="ixname">desktop section</span>, <a href="#_ix2165">B.2.15. The <code>[desktop]</code> section: wallpaper and screen saver</a></li>
<li><span class="ixname">dhcp</span>, <a href="#_ix2075">B.2.8. The <code>[network]</code> section</a></li>
<li><span class="ixname">dns1 and dns2</span>, <a href="#_ix2079">B.2.8. The <code>[network]</code> section</a></li>
<li><span class="ixname">doubleclick</span>, <a href="#_ix2062">B.2.6. The <code>[mouse]</code> section</a></li>
<li><span class="ixname">driver</span>, <a href="#_ix2120">B.2.11. The <code>[audio]</code> section: sound hardware and music</a></li>
<li><span class="ixname">editing</span>, <a href="#_ix2036">B.2.2. Changing DVX.INI by hand</a></li>
<li><span class="ixname">editing while DVX runs</span>, <a href="#_ix2040">B.2.2. Changing DVX.INI by hand</a></li>
<li><span class="ixname">fallback</span>, <a href="#_ix2179">B.2.17. The <code>[joystick]</code> section: game controllers</a></li>
<li><span class="ixname">file</span>, <a href="#_ix2097">B.2.10. The <code>[printer]</code> section</a></li>
<li><span class="ixname">first start</span>, <a href="#_ix260">3.14.4. The Program Manager the first time</a>, <a href="#_ix2031">B.2.1. Where DVX.INI is and how it is made</a></li>
<li><span class="ixname">fmTones</span>, <a href="#_ix2130">B.2.11. The <code>[audio]</code> section: sound hardware and music</a></li>
<li><span class="ixname">fonts section</span>, <a href="#_ix2172">B.2.16. The <code>[fonts]</code> section: text smoothing</a></li>
<li><span class="ixname">format</span>, <a href="#_ix2041">B.2.3. How DVX reads and saves the file</a></li>
<li><span class="ixname">gameport.mode</span>, <a href="#_ix2180">B.2.17. The <code>[joystick]</code> section: game controllers</a></li>
<li><span class="ixname">gateway</span>, <a href="#_ix2078">B.2.8. The <code>[network]</code> section</a></li>
<li><span class="ixname">going back to the shipped settings</span>, <a href="#_ix2232">B.5.1. Putting back the settings DVX came with</a></li>
<li><span class="ixname">gusVoices</span>, <a href="#_ix2141">B.2.11. The <code>[audio]</code> section: sound hardware and music</a></li>
<li><span class="ixname">handshake</span>, <a href="#_ix2103">B.2.10. The <code>[printer]</code> section</a></li>
<li><span class="ixname">header and footer</span>, <a href="#_ix2109">B.2.10. The <code>[printer]</code> section</a></li>
<li><span class="ixname">height</span>, <a href="#_ix2053">B.2.5. The <code>[video]</code> section: screen mode</a></li>
<li><span class="ixname">help section</span>, <a href="#_ix2185">B.2.18. The <code>[help]</code> section: DVX&#8217;s own notes</a></li>
<li><span class="ixname">hostname</span>, <a href="#_ix2081">B.2.8. The <code>[network]</code> section</a></li>
<li><span class="ixname">joystick calibration</span>, <a href="#_ix2181">B.2.17. The <code>[joystick]</code> section: game controllers</a></li>
<li><span class="ixname">joystick section</span>, <a href="#_ix2175">B.2.17. The <code>[joystick]</code> section: game controllers</a></li>
<li><span class="ixname">keyboard joystick keys</span>, <a href="#_ix2184">B.2.17. The <code>[joystick]</code> section: game controllers</a></li>
<li><span class="ixname">libCount and widgetCount</span>, <a href="#_ix2186">B.2.18. The <code>[help]</code> section: DVX&#8217;s own notes</a></li>
<li><span class="ixname">linesPerPage</span>, <a href="#_ix2104">B.2.10. The <code>[printer]</code> section</a></li>
<li><span class="ixname">lptDac</span>, <a href="#_ix2147">B.2.11. The <code>[audio]</code> section: sound hardware and music</a></li>
<li><span class="ixname">lptPort</span>, <a href="#_ix2149">B.2.11. The <code>[audio]</code> section: sound hardware and music</a></li>
<li><span class="ixname">margins</span>, <a href="#_ix2106">B.2.10. The <code>[printer]</code> section</a></li>
<li><span class="ixname">midi</span>, <a href="#_ix2131">B.2.11. The <code>[audio]</code> section: sound hardware and music</a></li>
<li><span class="ixname">midiBank</span>, <a href="#_ix2137">B.2.11. The <code>[audio]</code> section: sound hardware and music</a></li>
<li><span class="ixname">midiIn</span>, <a href="#_ix2132">B.2.11. The <code>[audio]</code> section: sound hardware and music</a></li>
<li><span class="ixname">mode</span>, <a href="#_ix2169">B.2.15. The <code>[desktop]</code> section: wallpaper and screen saver</a></li>
<li><span class="ixname">model</span>, <a href="#_ix2099">B.2.10. The <code>[printer]</code> section</a></li>
<li><span class="ixname">modules</span>, <a href="#_ix2133">B.2.11. The <code>[audio]</code> section: sound hardware and music</a></li>
<li><span class="ixname">mouse section</span>, <a href="#_ix2058">B.2.6. The <code>[mouse]</code> section</a></li>
<li><span class="ixname">mpuMode</span>, <a href="#_ix2134">B.2.11. The <code>[audio]</code> section: sound hardware and music</a></li>
<li><span class="ixname">mpuPort</span>, <a href="#_ix2136">B.2.11. The <code>[audio]</code> section: sound hardware and music</a></li>
<li><span class="ixname">netmask</span>, <a href="#_ix2077">B.2.8. The <code>[network]</code> section</a></li>
<li><span class="ixname">network section</span>, <a href="#_ix1675">11.9.11. Network settings in DVX.INI</a>, <a href="#_ix2073">B.2.8. The <code>[network]</code> section</a></li>
<li><span class="ixname">network settings</span>, <a href="#_ix294">4.4.5. When a setting is not valid</a></li>
<li><span class="ixname">oplPort</span>, <a href="#_ix2135">B.2.11. The <code>[audio]</code> section: sound hardware and music</a></li>
<li><span class="ixname">optional sound keys</span>, <a href="#_ix2119">B.2.11. The <code>[audio]</code> section: sound hardware and music</a></li>
<li><span class="ixname">package server</span>, <a href="#_ix1323">10.6.1. The Package Server window</a></li>
<li><span class="ixname">packages section</span>, <a href="#_ix1787">11.11.17. The Package Server window</a>, <a href="#_ix2086">B.2.9. The <code>[packages]</code> section: the package server</a></li>
<li><span class="ixname">password</span>, <a href="#_ix2091">B.2.9. The <code>[packages]</code> section: the package server</a></li>
<li><span class="ixname">pollHz</span>, <a href="#_ix2178">B.2.17. The <code>[joystick]</code> section: game controllers</a></li>
<li><span class="ixname">port in packages</span>, <a href="#_ix2089">B.2.9. The <code>[packages]</code> section: the package server</a></li>
<li><span class="ixname">port in printer</span>, <a href="#_ix2095">B.2.10. The <code>[printer]</code> section</a></li>
<li><span class="ixname">printer section</span>, <a href="#_ix1637">11.8.9. Printer settings in DVX.INI</a>, <a href="#_ix2093">B.2.10. The <code>[printer]</code> section</a></li>
<li><span class="ixname">rate</span>, <a href="#_ix2122">B.2.11. The <code>[audio]</code> section: sound hardware and music</a></li>
<li><span class="ixname">retries</span>, <a href="#_ix2187">B.2.18. The <code>[help]</code> section: DVX&#8217;s own notes</a></li>
<li><span class="ixname">safe saving</span>, <a href="#_ix2047">B.2.3. How DVX reads and saves the file</a></li>
<li><span class="ixname">saver</span>, <a href="#_ix2170">B.2.15. The <code>[desktop]</code> section: wallpaper and screen saver</a></li>
<li><span class="ixname">saverWait</span>, <a href="#_ix2171">B.2.15. The <code>[desktop]</code> section: wallpaper and screen saver</a></li>
<li><span class="ixname">saving</span>, <a href="#_ix2046">B.2.3. How DVX reads and saves the file</a></li>
<li><span class="ixname">sections</span>, <a href="#_ix2049">B.2.4. The sections of DVX.INI</a></li>
<li><span class="ixname">server</span>, <a href="#_ix2088">B.2.9. The <code>[packages]</code> section: the package server</a></li>
<li><span class="ixname">shell section</span>, <a href="#_ix1428">11.2.5. DVX starts, then closes: the Program Manager cannot be loaded</a>, <a href="#_ix2066">B.2.7. The <code>[shell]</code> section: the desktop and the Welcome window</a></li>
<li><span class="ixname">shipped copy</span>, <a href="#_ix2032">B.2.1. Where DVX.INI is and how it is made</a></li>
<li><span class="ixname">smoothing</span>, <a href="#_ix2174">B.2.16. The <code>[fonts]</code> section: text smoothing</a></li>
<li><span class="ixname">sound hardware settings</span>, <a href="#_ix828">7.12.4. Choosing and testing instruments</a></li>
<li><span class="ixname">soundFont</span>, <a href="#_ix2139">B.2.11. The <code>[audio]</code> section: sound hardware and music</a></li>
<li><span class="ixname">sounds section</span>, <a href="#_ix2159">B.2.13. The <code>[sounds]</code> section: event sounds</a></li>
<li><span class="ixname">speakerPcm</span>, <a href="#_ix2128">B.2.11. The <code>[audio]</code> section: sound hardware and music</a></li>
<li><span class="ixname">speed</span>, <a href="#_ix2064">B.2.6. The <code>[mouse]</code> section</a></li>
<li><span class="ixname">tabWidth</span>, <a href="#_ix2107">B.2.10. The <code>[printer]</code> section</a></li>
<li><span class="ixname">temporary copies</span>, <a href="#_ix2227">B.4.10. Temporary files</a></li>
<li><span class="ixname">user</span>, <a href="#_ix2090">B.2.9. The <code>[packages]</code> section: the package server</a></li>
<li><span class="ixname">values not understood</span>, <a href="#_ix2045">B.2.3. How DVX reads and saves the file</a></li>
<li><span class="ixname">vector</span>, <a href="#_ix2083">B.2.8. The <code>[network]</code> section</a></li>
<li><span class="ixname">video section</span>, <a href="#_ix1468">11.3.1. The screen is blank or cannot be read after DVX starts</a>, <a href="#_ix1485">11.3.4. Setting the screen mode in DVX.INI</a>, <a href="#_ix2050">B.2.5. The <code>[video]</code> section: screen mode</a></li>
<li><span class="ixname">voices</span>, <a href="#_ix2125">B.2.11. The <code>[audio]</code> section: sound hardware and music</a></li>
<li><span class="ixname">volume</span>, <a href="#_ix2126">B.2.11. The <code>[audio]</code> section: sound hardware and music</a></li>
<li><span class="ixname">wallpaper</span>, <a href="#_ix2168">B.2.15. The <code>[desktop]</code> section: wallpaper and screen saver</a></li>
<li><span class="ixname">welcome</span>, <a href="#_ix2068">B.2.7. The <code>[shell]</code> section: the desktop and the Welcome window</a></li>
<li><span class="ixname">wheel</span>, <a href="#_ix2060">B.2.6. The <code>[mouse]</code> section</a></li>
<li><span class="ixname">wheelspeed</span>, <a href="#_ix2061">B.2.6. The <code>[mouse]</code> section</a></li>
<li><span class="ixname">where it is</span>, <a href="#_ix2030">B.2.1. Where DVX.INI is and how it is made</a></li>
<li><span class="ixname">width</span>, <a href="#_ix2052">B.2.5. The <code>[video]</code> section: screen mode</a></li>
<li><span class="ixname">wrap</span>, <a href="#_ix2108">B.2.10. The <code>[printer]</code> section</a></li>
<li><span class="ixname">written by Setup</span>, <a href="#_ix171">3.7.3. DVX&#8217;s settings file</a>, <a href="#_ix2034">B.2.1. Where DVX.INI is and how it is made</a></li>
<li><span class="ixname">wssDma</span>, <a href="#_ix2146">B.2.11. The <code>[audio]</code> section: sound hardware and music</a></li>
<li><span class="ixname">wssIrq</span>, <a href="#_ix2145">B.2.11. The <code>[audio]</code> section: sound hardware and music</a></li>
<li><span class="ixname">wssPort</span>, <a href="#_ix2143">B.2.11. The <code>[audio]</code> section: sound hardware and music</a></li>
<li><span class="ixname">yes and no values</span>, <a href="#_ix2044">B.2.3. How DVX reads and saves the file</a></li>
</ul></li>
<li><span class="ixname">DVX.LOG</span>, <a href="#_ix1938">11.16. The log file</a>, <a href="#_ix1992">B.1.2. The USER folder</a>, <a href="#_ix2237">B.6. The log file, DVX.LOG</a></li>
<li><span class="ixname">DVXBASIC.INI</span>, <a href="#_ix2210">B.4.4. DVX BASIC: DVXBASIC.INI</a></li>
<li><span class="ixname">DVXPKG</span>, <a href="#_ix1459">11.2.9. DVX says add-ons were not loaded</a></li>
<li><span class="ixname">DVXUSER</span>, <a href="#_ix216">3.11. Where DVX puts its files</a>, <a href="#_ix1839">11.12.7. The USER folder and DVXUSER</a>, <a href="#_ix2006">B.1.3. Keeping the USER folder somewhere else: DVXUSER</a>
<ul>
<li><span class="ixname">folder cannot be written</span>, <a href="#_ix224">3.11.1. Running DVX from a CD-ROM or a write-protected disk</a>, <a href="#_ix1836">11.12.6. DVX runs from a disk it cannot write to</a>, <a href="#_ix2021">B.1.4. Running DVX from a disk it cannot write to</a></li>
<li><span class="ixname">removing DVX</span>, <a href="#_ix198">3.9. Removing DVX</a></li>
<li><span class="ixname">Setup</span>, <a href="#_ix2010">B.1.3. Keeping the USER folder somewhere else: DVXUSER</a></li>
<li><span class="ixname">several people</span>, <a href="#_ix2011">B.1.3. Keeping the USER folder somewhere else: DVXUSER</a></li>
</ul></li>
</ul>
<h3 id="_ixgroup_E">E</h3>
<ul class="ixlist">
<li><span class="ixname">editing text</span>, <a href="#_ix407">5.5.3.4. Text boxes</a></li>
<li><span class="ixname">EMM386</span>, <a href="#_ix1433">11.2.6. Memory messages before the title screen</a></li>
<li><span class="ixname">encryption</span>
<ul>
<li><span class="ixname">secure link</span>, <a href="#_ix1160">9.7. The secure link</a></li>
</ul></li>
<li><span class="ixname">End Task</span>, <a href="#_ix500">5.10.2. The buttons</a></li>
<li><span class="ixname">error numbers</span>, <a href="#_ix1929">11.14.5. Error numbers</a></li>
<li><span class="ixname">ERRORLEVEL</span>, <a href="#_ix210">3.10.1. Installing without questions</a></li>
<li><span class="ixname">exiting DVX</span>, <a href="#_ix243">3.12.3. Leaving DVX</a>, <a href="#_ix529">5.16. Exiting DVX</a>
<ul>
<li><span class="ixname">from Program Manager</span>, <a href="#_ix546">6.1. The Program Manager window</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix1910">11.13.5. DVX will not exit</a></li>
<li><span class="ixname">program not responding</span>, <a href="#_ix533">5.16. Exiting DVX</a></li>
<li><span class="ixname">unsaved work</span>, <a href="#_ix532">5.16. Exiting DVX</a></li>
</ul></li>
</ul>
<h3 id="_ixgroup_F">F</h3>
<ul class="ixlist">
<li><span class="ixname">FAT32</span>, <a href="#_ix1821">11.12.4. Big disks and big files</a></li>
<li><span class="ixname">file dialogs</span>
<ul>
<li><span class="ixname">extension added</span>, <a href="#_ix1811">11.12.1. Messages in the Open, Save As, and Choose a Folder dialogs</a></li>
<li><span class="ixname">large folder</span>, <a href="#_ix1812">11.12.1. Messages in the Open, Save As, and Choose a Folder dialogs</a></li>
<li><span class="ixname">messages</span>, <a href="#_ix1802">11.12.1. Messages in the Open, Save As, and Choose a Folder dialogs</a></li>
</ul></li>
<li><span class="ixname">File Manager</span>, <a href="#_ix12">1.2. The programs that come with DVX</a>, <a href="#_ix835">8.1. Which programs you have</a>, <a href="#_ix867">8.3. File Manager</a>
<ul>
<li><span class="ixname">closing</span>, <a href="#_ix917">8.3.12. Closing File Manager</a></li>
<li><span class="ixname">copy problems</span>, <a href="#_ix1855">11.12.10.2. Questions while a copy, move, or delete runs</a></li>
<li><span class="ixname">copying files</span>, <a href="#_ix887">8.3.5. Copying and moving files and folders</a></li>
<li><span class="ixname">deleting files</span>, <a href="#_ix903">8.3.6. Making folders, renaming, and deleting</a></li>
<li><span class="ixname">drive bar</span>, <a href="#_ix872">8.3.2. The File Manager window</a></li>
<li><span class="ixname">drives</span>, <a href="#_ix875">8.3.2. The File Manager window</a></li>
<li><span class="ixname">errors</span>, <a href="#_ix897">8.3.5. Copying and moving files and folders</a></li>
<li><span class="ixname">file list</span>, <a href="#_ix876">8.3.2. The File Manager window</a></li>
<li><span class="ixname">filter</span>, <a href="#_ix909">8.3.8. Showing only some files</a></li>
<li><span class="ixname">folder tree</span>, <a href="#_ix874">8.3.2. The File Manager window</a></li>
<li><span class="ixname">folder tree commands</span>, <a href="#_ix881">8.3.3. Choosing files</a></li>
<li><span class="ixname">going up a folder</span>, <a href="#_ix877">8.3.2. The File Manager window</a></li>
<li><span class="ixname">keys</span>, <a href="#_ix915">8.3.11. File Manager keys</a></li>
<li><span class="ixname">making folders</span>, <a href="#_ix899">8.3.6. Making folders, renaming, and deleting</a></li>
<li><span class="ixname">menus</span>, <a href="#_ix914">8.3.10. File Manager menus</a></li>
<li><span class="ixname">messages</span>, <a href="#_ix1852">11.12.10. File Manager</a></li>
<li><span class="ixname">moving files</span>, <a href="#_ix888">8.3.5. Copying and moving files and folders</a></li>
<li><span class="ixname">opening files</span>, <a href="#_ix882">8.3.4. Opening files and starting programs</a></li>
<li><span class="ixname">opening packages</span>, <a href="#_ix1257">10.3.1. Installing from a file</a></li>
<li><span class="ixname">path box</span>, <a href="#_ix873">8.3.2. The File Manager window</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix1851">11.12.10. File Manager</a></li>
<li><span class="ixname">progress window</span>, <a href="#_ix894">8.3.5. Copying and moving files and folders</a></li>
<li><span class="ixname">properties</span>, <a href="#_ix910">8.3.9. Properties and attributes</a></li>
<li><span class="ixname">renaming files</span>, <a href="#_ix901">8.3.6. Making folders, renaming, and deleting</a></li>
<li><span class="ixname">replacing files</span>, <a href="#_ix895">8.3.5. Copying and moving files and folders</a></li>
<li><span class="ixname">selecting files</span>, <a href="#_ix879">8.3.3. Choosing files</a></li>
<li><span class="ixname">several windows</span>, <a href="#_ix871">8.3.1. Starting File Manager</a></li>
<li><span class="ixname">sorting</span>, <a href="#_ix878">8.3.2. The File Manager window</a></li>
<li><span class="ixname">starting</span>, <a href="#_ix870">8.3.1. Starting File Manager</a></li>
</ul></li>
<li><span class="ixname">file names</span>
<ul>
<li><span class="ixname">rules</span>, <a href="#_ix1815">11.12.2. File names that are not allowed</a></li>
</ul></li>
<li><span class="ixname">file transfers</span>, <a href="#_ix1126">9.6. Sending and receiving files</a>
<ul>
<li><span class="ixname">cancelling</span>, <a href="#_ix1144">9.6.5. Cancelling a transfer</a></li>
<li><span class="ixname">choosing a protocol</span>, <a href="#_ix1134">9.6. Sending and receiving files</a></li>
<li><span class="ixname">continuing a download</span>, <a href="#_ix1146">9.6.6. When a file already exists</a></li>
<li><span class="ixname">download folder</span>, <a href="#_ix1137">9.6.2. Receiving files</a></li>
<li><span class="ixname">file already exists</span>, <a href="#_ix1145">9.6.6. When a file already exists</a></li>
<li><span class="ixname">file names</span>, <a href="#_ix1140">9.6.3. Names of received files</a></li>
<li><span class="ixname">File Transfer window</span>, <a href="#_ix1142">9.6.4. The File Transfer window</a></li>
<li><span class="ixname">messages</span>, <a href="#_ix1150">9.6.8. Transfer results and messages</a></li>
<li><span class="ixname">options</span>, <a href="#_ix1147">9.6.7. Transfer options</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix1707">11.10.7. File transfers</a></li>
<li><span class="ixname">receiving</span>, <a href="#_ix1136">9.6.2. Receiving files</a></li>
<li><span class="ixname">sending</span>, <a href="#_ix1135">9.6.1. Sending files</a></li>
</ul></li>
<li><span class="ixname">file types</span>, <a href="#_ix738">7.8. File Types page</a>, <a href="#_ix856">8.2.4. Opening documents</a>
<ul>
<li><span class="ixname">adding</span>, <a href="#_ix742">7.8. File Types page</a></li>
<li><span class="ixname">as installed</span>, <a href="#_ix749">7.8.3. File types DVX sets up</a></li>
<li><span class="ixname">ASSOC.INI</span>, <a href="#_ix2189">B.3. ASSOC.INI: which program opens each kind of file</a></li>
<li><span class="ixname">changing</span>, <a href="#_ix744">7.8. File Types page</a>, <a href="#_ix2196">B.3. ASSOC.INI: which program opens each kind of file</a></li>
<li><span class="ixname">program not installed</span>, <a href="#_ix2194">B.3. ASSOC.INI: which program opens each kind of file</a></li>
<li><span class="ixname">removing</span>, <a href="#_ix745">7.8. File Types page</a></li>
</ul></li>
<li><span class="ixname">files</span>
<ul>
<li><span class="ixname">attributes</span>, <a href="#_ix911">8.3.9. Properties and attributes</a></li>
<li><span class="ixname">copying</span>, <a href="#_ix889">8.3.5. Copying and moving files and folders</a></li>
<li><span class="ixname">deleting</span>, <a href="#_ix904">8.3.6. Making folders, renaming, and deleting</a></li>
<li><span class="ixname">endings</span>, <a href="#_ix453">5.6.3. Saving a file</a></li>
<li><span class="ixname">extensions</span>, <a href="#_ix741">7.8. File Types page</a></li>
<li><span class="ixname">file list</span>, <a href="#_ix442">5.6.1. Parts of the dialog box</a></li>
<li><span class="ixname">file types filter</span>, <a href="#_ix446">5.6.1. Parts of the dialog box</a></li>
<li><span class="ixname">hidden</span>, <a href="#_ix913">8.3.9. Properties and attributes</a></li>
<li><span class="ixname">long names</span>, <a href="#_ix462">5.6.6. File names</a>, <a href="#_ix1817">11.12.3. Long file names</a></li>
<li><span class="ixname">managing</span>, <a href="#_ix868">8.3. File Manager</a></li>
<li><span class="ixname">moving</span>, <a href="#_ix890">8.3.5. Copying and moving files and folders</a></li>
<li><span class="ixname">names</span>, <a href="#_ix460">5.6.6. File names</a>, <a href="#_ix906">8.3.7. File and folder names</a></li>
<li><span class="ixname">names not allowed</span>, <a href="#_ix1813">11.12.2. File names that are not allowed</a></li>
<li><span class="ixname">opening</span>, <a href="#_ix435">5.6. Opening and saving files</a>, <a href="#_ix448">5.6.2. Opening a file</a>, <a href="#_ix855">8.2.4. Opening documents</a>, <a href="#_ix883">8.3.4. Opening files and starting programs</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix1799">11.12. Files, disks, and folders</a></li>
<li><span class="ixname">read-only</span>, <a href="#_ix912">8.3.9. Properties and attributes</a></li>
<li><span class="ixname">read-only attribute</span>, <a href="#_ix1829">11.12.5. Read-only disks, CD-ROMs, and empty drives</a></li>
<li><span class="ixname">renaming</span>, <a href="#_ix902">8.3.6. Making folders, renaming, and deleting</a></li>
<li><span class="ixname">saving</span>, <a href="#_ix436">5.6. Opening and saving files</a>, <a href="#_ix452">5.6.3. Saving a file</a>, <a href="#_ix927">8.4.4. Opening and saving files</a></li>
<li><span class="ixname">saving large</span>, <a href="#_ix1847">11.12.9. Saving onto a full disk</a></li>
<li><span class="ixname">saving safely</span>, <a href="#_ix934">8.4.5. File size and line ends</a></li>
<li><span class="ixname">selecting</span>, <a href="#_ix880">8.3.3. Choosing files</a></li>
<li><span class="ixname">types</span>, <a href="#_ix737">7.8. File Types page</a></li>
<li><span class="ixname">where DVX keeps them</span>, <a href="#_ix212">3.11. Where DVX puts its files</a></li>
</ul></li>
<li><span class="ixname">filters</span>, <a href="#_ix447">5.6.1. Parts of the dialog box</a></li>
<li><span class="ixname">first start</span>, <a href="#_ix251">3.14. The first start</a>, <a href="#_ix1009">8.10. Welcome</a></li>
<li><span class="ixname">floppy disks</span>, <a href="#_ix118">3.1.2. The floppy disks</a>
<ul>
<li><span class="ixname">changing</span>, <a href="#_ix166">3.7.2. Changing floppy disks</a></li>
</ul></li>
<li><span class="ixname">flow control</span>, <a href="#_ix1083">9.4.4.1. The Connection page</a>
<ul>
<li><span class="ixname">secure link</span>, <a href="#_ix1167">9.7.2. Setting up a secure link session</a></li>
<li><span class="ixname">ZMODEM</span>, <a href="#_ix1149">9.6.7. Transfer options</a></li>
</ul></li>
<li><span class="ixname">focus</span>, <a href="#_ix330">5.2.2. The keyboard</a></li>
<li><span class="ixname">folders</span>, <a href="#_ix1962">B. DVX Folders and Settings Files</a>
<ul>
<li><span class="ixname">add-ons</span>, <a href="#_ix1224">10.1.3. Where add-ons are installed</a></li>
<li><span class="ixname">APPS</span>, <a href="#_ix1976">B.1.1. The DVX folder</a></li>
<li><span class="ixname">choosing</span>, <a href="#_ix455">5.6.4. Choosing a folder</a></li>
<li><span class="ixname">copying</span>, <a href="#_ix891">8.3.5. Copying and moving files and folders</a></li>
<li><span class="ixname">deleting</span>, <a href="#_ix905">8.3.6. Making folders, renaming, and deleting</a></li>
<li><span class="ixname">do not change</span>, <a href="#_ix1987">B.1.1. The DVX folder</a></li>
<li><span class="ixname">DVX folder</span>, <a href="#_ix51">1.5.3. Conventions</a>, <a href="#_ix211">3.11. Where DVX puts its files</a>, <a href="#_ix1964">B.1. The DVX folders</a>, <a href="#_ix1966">B.1.1. The DVX folder</a></li>
<li><span class="ixname">LIBS</span>, <a href="#_ix1972">B.1.1. The DVX folder</a></li>
<li><span class="ixname">making</span>, <a href="#_ix900">8.3.6. Making folders, renaming, and deleting</a></li>
<li><span class="ixname">managing</span>, <a href="#_ix869">8.3. File Manager</a></li>
<li><span class="ixname">opening in a dialog box</span>, <a href="#_ix445">5.6.1. Parts of the dialog box</a></li>
<li><span class="ixname">Path box</span>, <a href="#_ix443">5.6.1. Parts of the dialog box</a></li>
<li><span class="ixname">program settings</span>, <a href="#_ix1996">B.1.2. The USER folder</a>, <a href="#_ix2199">B.4. Other settings files</a></li>
<li><span class="ixname">SHARED</span>, <a href="#_ix1226">10.1.3. Where add-ons are installed</a>, <a href="#_ix1978">B.1.1. The DVX folder</a></li>
<li><span class="ixname">SYSTEM</span>, <a href="#_ix1970">B.1.1. The DVX folder</a></li>
<li><span class="ixname">typing a path</span>, <a href="#_ix457">5.6.5. Typing a path</a></li>
<li><span class="ixname">user folder</span>, <a href="#_ix859">8.2.5. Settings the programs remember</a>, <a href="#_ix1228">10.1.3. Where add-ons are installed</a>, <a href="#_ix1989">B.1.2. The USER folder</a></li>
<li><span class="ixname">WIDGETS</span>, <a href="#_ix1974">B.1.1. The DVX folder</a></li>
</ul></li>
<li><span class="ixname">fonts</span>
<ul>
<li><span class="ixname">add-ons</span>, <a href="#_ix1210">10.1.1. Kinds of packages</a></li>
<li><span class="ixname">adding later</span>, <a href="#_ix146">3.4. Choosing the fonts</a></li>
<li><span class="ixname">base set</span>, <a href="#_ix38">1.4.1. Fonts</a>, <a href="#_ix144">3.4. Choosing the fonts</a></li>
<li><span class="ixname">choosing in Setup</span>, <a href="#_ix142">3.4. Choosing the fonts</a></li>
<li><span class="ixname">DVX Fonts</span>, <a href="#_ix1270">10.3.3. The add-ons on the DVX CD</a></li>
<li><span class="ixname">DVX&#8217;s own font</span>, <a href="#_ix37">1.4.1. Fonts</a></li>
<li><span class="ixname">folder</span>, <a href="#_ix1980">B.1.1. The DVX folder</a></li>
<li><span class="ixname">Font dialog box</span>, <a href="#_ix432">5.5.4. Dialog boxes that many programs share</a></li>
<li><span class="ixname">licence</span>, <a href="#_ix42">1.4.1. Fonts</a>, <a href="#_ix147">3.4. Choosing the fonts</a></li>
<li><span class="ixname">missing</span>, <a href="#_ix41">1.4.1. Fonts</a>, <a href="#_ix145">3.4. Choosing the fonts</a>, <a href="#_ix1877">11.12.13. Fonts</a></li>
<li><span class="ixname">More Fonts</span>, <a href="#_ix1268">10.3.3. The add-ons on the DVX CD</a></li>
<li><span class="ixname">More Fonts add-on</span>, <a href="#_ix39">1.4.1. Fonts</a>, <a href="#_ix159">3.6. The add-ons on the CD</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix1876">11.12.13. Fonts</a></li>
<li><span class="ixname">smooth edges</span>, <a href="#_ix1484">11.3.3. Choosing another screen mode</a></li>
<li><span class="ixname">smoothing</span>, <a href="#_ix726">7.7. Video page</a></li>
<li><span class="ixname">System font</span>, <a href="#_ix1878">11.12.13. Fonts</a></li>
<li><span class="ixname">your own</span>, <a href="#_ix2001">B.1.2.1. Your own fonts, sounds, themes, pictures, banks, and screen savers</a></li>
</ul></li>
<li><span class="ixname">full-screen programs</span>, <a href="#_ix518">5.14. Programs that use the whole screen</a>, <a href="#_ix1490">11.3.5. Other screen problems</a></li>
</ul>
<h3 id="_ixgroup_G">G</h3>
<ul class="ixlist">
<li><span class="ixname">game controllers</span>, <a href="#_ix784">7.11. Game Controllers page</a>
<ul>
<li><span class="ixname">DVX.INI</span>, <a href="#_ix2177">B.2.17. The <code>[joystick]</code> section: game controllers</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix1526">11.6. Game controllers do not work</a></li>
</ul></li>
<li><span class="ixname">games</span>
<ul>
<li><span class="ixname">full screen</span>, <a href="#_ix519">5.14. Programs that use the whole screen</a></li>
</ul></li>
<li><span class="ixname">groups</span>, <a href="#_ix553">6.3. Groups</a>
<ul>
<li><span class="ixname">deleting</span>, <a href="#_ix564">6.3.4. Deleting a group</a></li>
<li><span class="ixname">making</span>, <a href="#_ix559">6.3.2. Making a group</a></li>
<li><span class="ixname">renaming</span>, <a href="#_ix562">6.3.3. Renaming a group</a></li>
</ul></li>
<li><span class="ixname">guide</span>
<ul>
<li><span class="ixname">chapters</span>, <a href="#_ix49">1.5.2. How it is organized</a></li>
<li><span class="ixname">conventions</span>, <a href="#_ix50">1.5.3. Conventions</a></li>
<li><span class="ixname">who it is for</span>, <a href="#_ix48">1.5.1. Who it is for</a></li>
</ul></li>
</ul>
<h3 id="_ixgroup_H">H</h3>
<ul class="ixlist">
<li><span class="ixname">help</span>, <a href="#_ix509">5.11. Getting help</a></li>
<li><span class="ixname">Help Editor</span>, <a href="#_ix1037">8.13.3. Help Editor</a>
<ul>
<li><span class="ixname">problems</span>, <a href="#_ix1872">11.12.12. Other programs' file messages</a></li>
</ul></li>
<li><span class="ixname">help files</span>
<ul>
<li><span class="ixname">problems</span>, <a href="#_ix1881">11.12.14. Help files</a></li>
<li><span class="ixname">rebuilding</span>, <a href="#_ix1405">11.2.1. What a normal start looks like</a></li>
<li><span class="ixname">writing</span>, <a href="#_ix1038">8.13.3. Help Editor</a></li>
</ul></li>
<li><span class="ixname">HIMEM.SYS</span>, <a href="#_ix1432">11.2.6. Memory messages before the title screen</a></li>
<li><span class="ixname">hourglass</span>, <a href="#_ix326">5.2.1. The mouse</a></li>
</ul>
<h3 id="_ixgroup_I">I</h3>
<ul class="ixlist">
<li><span class="ixname">Icon Editor</span>, <a href="#_ix1035">8.13.2. Icon Editor</a>
<ul>
<li><span class="ixname">printing</span>, <a href="#_ix1632">11.8.8. Printing from particular programs</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix1870">11.12.12. Other programs' file messages</a></li>
</ul></li>
<li><span class="ixname">icons</span>
<ul>
<li><span class="ixname">drawing</span>, <a href="#_ix1036">8.13.2. Icon Editor</a></li>
<li><span class="ixname">minimized windows</span>, <a href="#_ix356">5.3.6. Minimizing a window</a></li>
<li><span class="ixname">Program Manager items</span>, <a href="#_ix595">6.4.5. Icons</a></li>
</ul></li>
<li><span class="ixname">Image Viewer</span>, <a href="#_ix15">1.2. The programs that come with DVX</a>, <a href="#_ix838">8.1. Which programs you have</a>, <a href="#_ix949">8.6. Image Viewer</a>
<ul>
<li><span class="ixname">menus</span>, <a href="#_ix956">8.6.4. Image Viewer menus and messages</a></li>
<li><span class="ixname">opening pictures</span>, <a href="#_ix952">8.6.2. Looking at a picture</a></li>
<li><span class="ixname">printing</span>, <a href="#_ix954">8.6.3. Printing a picture</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix1869">11.12.12. Other programs' file messages</a></li>
<li><span class="ixname">starting</span>, <a href="#_ix951">8.6.1. Starting Image Viewer</a></li>
</ul></li>
<li><span class="ixname">INI files</span>
<ul>
<li><span class="ixname">format</span>, <a href="#_ix2042">B.2.3. How DVX reads and saves the file</a></li>
</ul></li>
<li><span class="ixname">Installed Programs group</span>, <a href="#_ix555">6.3.1. The groups on a new installation</a></li>
<li><span class="ixname">installing</span>, <a href="#_ix112">3. Installing DVX</a>
<ul>
<li><span class="ixname">add-ons</span>, <a href="#_ix1252">10.3. Installing add-ons</a></li>
<li><span class="ixname">before you start</span>, <a href="#_ix121">3.2. Before you install</a></li>
<li><span class="ixname">Communications part</span>, <a href="#_ix1049">9.1. What you need</a></li>
<li><span class="ixname">folder</span>, <a href="#_ix132">3.3.4. Choosing the folder</a></li>
<li><span class="ixname">from CD</span>, <a href="#_ix115">3.1.1. The CD</a></li>
<li><span class="ixname">from floppy disks</span>, <a href="#_ix117">3.1.2. The floppy disks</a></li>
<li><span class="ixname">media</span>, <a href="#_ix114">3.1. The DVX disks</a></li>
<li><span class="ixname">optional parts</span>, <a href="#_ix833">8.1. Which programs you have</a></li>
<li><span class="ixname">unattended</span>, <a href="#_ix208">3.10.1. Installing without questions</a></li>
</ul></li>
<li><span class="ixname">IP address</span>, <a href="#_ix282">4.4.2. Setting the address yourself</a></li>
<li><span class="ixname">items</span>, <a href="#_ix568">6.4. Items</a>
<ul>
<li><span class="ixname">adding</span>, <a href="#_ix571">6.4.2. Adding an item</a></li>
<li><span class="ixname">arguments</span>, <a href="#_ix577">6.4.3. Item properties</a></li>
<li><span class="ixname">copying</span>, <a href="#_ix600">6.4.8. Copying an item to a group</a></li>
<li><span class="ixname">deleting</span>, <a href="#_ix603">6.4.9. Deleting an item</a></li>
<li><span class="ixname">icon</span>, <a href="#_ix580">6.4.3. Item properties</a></li>
<li><span class="ixname">moving</span>, <a href="#_ix598">6.4.7. Moving an item to another group</a></li>
<li><span class="ixname">name</span>, <a href="#_ix574">6.4.3. Item properties</a></li>
<li><span class="ixname">program</span>, <a href="#_ix575">6.4.3. Item properties</a></li>
<li><span class="ixname">properties</span>, <a href="#_ix573">6.4.3. Item properties</a></li>
<li><span class="ixname">renaming</span>, <a href="#_ix596">6.4.6. Renaming an item</a></li>
<li><span class="ixname">run minimized</span>, <a href="#_ix582">6.4.3. Item properties</a></li>
<li><span class="ixname">shortcut key</span>, <a href="#_ix581">6.4.3. Item properties</a></li>
<li><span class="ixname">wait for a key</span>, <a href="#_ix584">6.4.3. Item properties</a></li>
<li><span class="ixname">working folder</span>, <a href="#_ix578">6.4.3. Item properties</a></li>
</ul></li>
</ul>
<h3 id="_ixgroup_J">J</h3>
<ul class="ixlist">
<li><span class="ixname">joysticks</span>, <a href="#_ix111">2.6.6. Joysticks</a>, <a href="#_ix783">7.11. Game Controllers page</a>
<ul>
<li><span class="ixname">calibrating</span>, <a href="#_ix790">7.11. Game Controllers page</a></li>
<li><span class="ixname">calibration</span>, <a href="#_ix2182">B.2.17. The <code>[joystick]</code> section: game controllers</a></li>
<li><span class="ixname">choosing</span>, <a href="#_ix786">7.11. Game Controllers page</a></li>
<li><span class="ixname">dead zone</span>, <a href="#_ix791">7.11. Game Controllers page</a></li>
<li><span class="ixname">detecting</span>, <a href="#_ix788">7.11. Game Controllers page</a></li>
<li><span class="ixname">DVX.INI</span>, <a href="#_ix2176">B.2.17. The <code>[joystick]</code> section: game controllers</a></li>
<li><span class="ixname">game port</span>, <a href="#_ix793">7.11. Game Controllers page</a></li>
<li><span class="ixname">keyboard</span>, <a href="#_ix1522">11.5.2. Other keyboard questions</a></li>
<li><span class="ixname">keyboard as</span>, <a href="#_ix795">7.11. Game Controllers page</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix1527">11.6. Game controllers do not work</a></li>
<li><span class="ixname">testing</span>, <a href="#_ix789">7.11. Game Controllers page</a></li>
</ul></li>
</ul>
<h3 id="_ixgroup_K">K</h3>
<ul class="ixlist">
<li><span class="ixname">KEYB</span>, <a href="#_ix1517">11.5.1. Keys type the wrong characters</a></li>
<li><span class="ixname">keyboard</span>, <a href="#_ix314">5.2. Using the mouse and the keyboard</a>
<ul>
<li><span class="ixname">games</span>, <a href="#_ix1521">11.5.2. Other keyboard questions</a></li>
<li><span class="ixname">layout</span>, <a href="#_ix1516">11.5.1. Keys type the wrong characters</a></li>
<li><span class="ixname">national</span>, <a href="#_ix1518">11.5.1. Keys type the wrong characters</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix1515">11.5. The keyboard does not work as expected</a></li>
<li><span class="ixname">using DVX without a mouse</span>, <a href="#_ix1523">11.5.3. Using DVX without a mouse</a></li>
</ul></li>
<li><span class="ixname">keyboard focus</span>, <a href="#_ix329">5.2.2. The keyboard</a></li>
<li><span class="ixname">keyboard shortcuts</span>, <a href="#_ix479">5.9. Keys that work in every program</a>, <a href="#_ix1951">A. Keyboard Shortcuts</a>
<ul>
<li><span class="ixname">Alt+F4</span>, <a href="#_ix483">5.9. Keys that work in every program</a>, <a href="#_ix1954">A.1. Keys that work in every program</a></li>
<li><span class="ixname">Alt+Space</span>, <a href="#_ix486">5.9. Keys that work in every program</a>, <a href="#_ix1957">A.1. Keys that work in every program</a></li>
<li><span class="ixname">Alt+Tab</span>, <a href="#_ix346">5.3.2. The active window and switching windows</a>, <a href="#_ix481">5.9. Keys that work in every program</a>, <a href="#_ix1952">A.1. Keys that work in every program</a></li>
<li><span class="ixname">Control Panel</span>, <a href="#_ix660">7.2.1. Using the keyboard</a></li>
<li><span class="ixname">Ctrl+C</span>, <a href="#_ix470">5.7. Copying and pasting</a>, <a href="#_ix1960">A.4. Cut, copy, and paste</a></li>
<li><span class="ixname">Ctrl+Esc</span>, <a href="#_ix484">5.9. Keys that work in every program</a>, <a href="#_ix490">5.10. Task Manager</a>, <a href="#_ix1955">A.1. Keys that work in every program</a></li>
<li><span class="ixname">Ctrl+F12</span>, <a href="#_ix475">5.8. Saving a picture of the screen</a></li>
<li><span class="ixname">Ctrl+Shift+F12</span>, <a href="#_ix476">5.8. Saving a picture of the screen</a></li>
<li><span class="ixname">Ctrl+V</span>, <a href="#_ix471">5.7. Copying and pasting</a>, <a href="#_ix1961">A.4. Cut, copy, and paste</a></li>
<li><span class="ixname">Ctrl+X</span>, <a href="#_ix469">5.7. Copying and pasting</a>, <a href="#_ix1959">A.4. Cut, copy, and paste</a></li>
<li><span class="ixname">DVX Help</span>, <a href="#_ix1006">8.9.7. DVX Help menu and keys</a></li>
<li><span class="ixname">F1</span>, <a href="#_ix485">5.9. Keys that work in every program</a>, <a href="#_ix511">5.11. Getting help</a>, <a href="#_ix851">8.2.2. Help for every program</a>, <a href="#_ix1956">A.1. Keys that work in every program</a></li>
<li><span class="ixname">F10</span>, <a href="#_ix376">5.4.2. Using menus with the keyboard</a></li>
<li><span class="ixname">File Manager</span>, <a href="#_ix916">8.3.11. File Manager keys</a></li>
<li><span class="ixname">full-screen programs</span>, <a href="#_ix487">5.9. Keys that work in every program</a>, <a href="#_ix520">5.14. Programs that use the whole screen</a></li>
<li><span class="ixname">global</span>, <a href="#_ix480">5.9. Keys that work in every program</a></li>
<li><span class="ixname">in dialog boxes</span>, <a href="#_ix388">5.5.1. How dialog boxes work</a></li>
<li><span class="ixname">in menus</span>, <a href="#_ix380">5.4.3. Marks in menus</a></li>
<li><span class="ixname">Media Player</span>, <a href="#_ix975">8.7.8. Media Player menus</a></li>
<li><span class="ixname">message boxes</span>, <a href="#_ix1383">11.1.1. Read the message</a></li>
<li><span class="ixname">Notepad</span>, <a href="#_ix922">8.4.3. Typing and editing</a></li>
<li><span class="ixname">OK and Cancel</span>, <a href="#_ix389">5.5.1. How dialog boxes work</a></li>
<li><span class="ixname">Program Manager</span>, <a href="#_ix644">6.11. Keyboard shortcuts in Program Manager</a></li>
<li><span class="ixname">Program Manager items</span>, <a href="#_ix587">6.4.4. Shortcut keys</a></li>
<li><span class="ixname">Setup</span>, <a href="#_ix125">3.3.1. Starting Setup</a></li>
<li><span class="ixname">Shift+Alt+Tab</span>, <a href="#_ix482">5.9. Keys that work in every program</a>, <a href="#_ix1953">A.1. Keys that work in every program</a></li>
<li><span class="ixname">Sound Recorder</span>, <a href="#_ix992">8.8.6. Sound Recorder menus and keys</a></li>
<li><span class="ixname">Terminal</span>, <a href="#_ix1065">9.3.2. Using the terminal screen</a></li>
<li><span class="ixname">underlined letters</span>, <a href="#_ix331">5.2.2. The keyboard</a></li>
<li><span class="ixname">without a mouse</span>, <a href="#_ix1524">11.5.3. Using DVX without a mouse</a></li>
</ul></li>
<li><span class="ixname">keys</span>, <a href="#_ix1341">10.8. Signatures and trusted publishers</a>
<ul>
<li><span class="ixname">DVX Repository</span>, <a href="#_ix1342">10.8. Signatures and trusted publishers</a></li>
<li><span class="ixname">private</span>, <a href="#_ix2220">B.4.7. KEYS: publisher keys</a></li>
<li><span class="ixname">removing</span>, <a href="#_ix1355">10.8.5. Removing a trusted key</a></li>
<li><span class="ixname">trusting</span>, <a href="#_ix1350">10.8.4. Trusting a publisher&#8217;s key</a></li>
</ul></li>
<li><span class="ixname">KEYS folder</span>, <a href="#_ix1792">11.11.18. Signatures and trusted keys</a>, <a href="#_ix1999">B.1.2. The USER folder</a>, <a href="#_ix2217">B.4.7. KEYS: publisher keys</a></li>
</ul>
<h3 id="_ixgroup_L">L</h3>
<ul class="ixlist">
<li><span class="ixname">Large Icons</span>, <a href="#_ix608">6.5. Views and arranging icons</a></li>
<li><span class="ixname">LFN</span>, <a href="#_ix1819">11.12.3. Long file names</a></li>
<li><span class="ixname">LIBS folder</span>, <a href="#_ix1971">B.1.1. The DVX folder</a></li>
<li><span class="ixname">licence</span>, <a href="#_ix9">1.1. What DVX is</a>, <a href="#_ix128">3.3.2. The licence</a></li>
<li><span class="ixname">lists</span>, <a href="#_ix413">5.5.3.6. Lists</a>
<ul>
<li><span class="ixname">column headings</span>, <a href="#_ix418">5.5.3.6. Lists</a></li>
<li><span class="ixname">selecting several items</span>, <a href="#_ix417">5.5.3.6. Lists</a></li>
<li><span class="ixname">typing to find an item</span>, <a href="#_ix415">5.5.3.6. Lists</a></li>
</ul></li>
<li><span class="ixname">local echo</span>, <a href="#_ix1179">9.8.3. Local echo</a></li>
<li><span class="ixname">log file</span>, <a href="#_ix1937">11.16. The log file</a>, <a href="#_ix1993">B.1.2. The USER folder</a>, <a href="#_ix2236">B.6. The log file, DVX.LOG</a>
<ul>
<li><span class="ixname">emptied at start</span>, <a href="#_ix1943">11.16.2. Keep it before you start DVX again</a>, <a href="#_ix2239">B.6.1. When DVX writes it</a></li>
<li><span class="ixname">first steps</span>, <a href="#_ix1390">11.1.3. Look in the log file</a></li>
<li><span class="ixname">in System Information</span>, <a href="#_ix641">6.10.5. Help menu</a>, <a href="#_ix1942">11.16.1. Where it is</a></li>
<li><span class="ixname">location</span>, <a href="#_ix1939">11.16. The log file</a></li>
<li><span class="ixname">network</span>, <a href="#_ix304">4.5. Checking that it works</a></li>
<li><span class="ixname">no TEMP folder</span>, <a href="#_ix2241">B.6.1. When DVX writes it</a></li>
<li><span class="ixname">reading</span>, <a href="#_ix1945">11.16.3. What to look for</a>, <a href="#_ix2244">B.6.2. Reading the log</a></li>
<li><span class="ixname">recording lines</span>, <a href="#_ix1590">11.7.16. Recording sound</a></li>
<li><span class="ixname">sending</span>, <a href="#_ix1946">11.16.4. Sending it with a problem report</a></li>
<li><span class="ixname">sending with a problem report</span>, <a href="#_ix2246">B.6.3. Sending the log with a problem report</a></li>
<li><span class="ixname">size</span>, <a href="#_ix1944">11.16.2. Keep it before you start DVX again</a>, <a href="#_ix2240">B.6.1. When DVX writes it</a></li>
<li><span class="ixname">Software</span>, <a href="#_ix1375">10.10.3. Starting without add-ons</a></li>
<li><span class="ixname">sound lines</span>, <a href="#_ix1583">11.7.15. Sound lines in the log file</a></li>
<li><span class="ixname">where</span>, <a href="#_ix1940">11.16.1. Where it is</a>, <a href="#_ix2243">B.6.1. When DVX writes it</a></li>
</ul></li>
<li><span class="ixname">long file names</span>, <a href="#_ix63">2.2.3. DOS</a>, <a href="#_ix461">5.6.6. File names</a>, <a href="#_ix907">8.3.7. File and folder names</a>, <a href="#_ix1816">11.12.3. Long file names</a>
<ul>
<li><span class="ixname">received files</span>, <a href="#_ix1141">9.6.3. Names of received files</a></li>
</ul></li>
</ul>
<h3 id="_ixgroup_M">M</h3>
<ul class="ixlist">
<li><span class="ixname">Media Player</span>, <a href="#_ix29">1.3. The optional parts</a>, <a href="#_ix842">8.1. Which programs you have</a>, <a href="#_ix957">8.7. Media Player</a>
<ul>
<li><span class="ixname">file formats</span>, <a href="#_ix960">8.7.1. What Media Player plays</a></li>
<li><span class="ixname">menus</span>, <a href="#_ix974">8.7.8. Media Player menus</a></li>
<li><span class="ixname">messages</span>, <a href="#_ix977">8.7.9. Media Player messages</a></li>
<li><span class="ixname">pausing</span>, <a href="#_ix965">8.7.4. Playing music</a></li>
<li><span class="ixname">play list</span>, <a href="#_ix966">8.7.5. Making a play list</a></li>
<li><span class="ixname">playing a file</span>, <a href="#_ix964">8.7.4. Playing music</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix1591">11.7.17. Media Player</a></li>
<li><span class="ixname">repeat</span>, <a href="#_ix969">8.7.6. Repeat and shuffle</a></li>
<li><span class="ixname">settings</span>, <a href="#_ix968">8.7.5. Making a play list</a></li>
<li><span class="ixname">settings file</span>, <a href="#_ix2213">B.4.5. Media Player: PLAYER.INI</a></li>
<li><span class="ixname">shuffle</span>, <a href="#_ix970">8.7.6. Repeat and shuffle</a></li>
<li><span class="ixname">sound card</span>, <a href="#_ix971">8.7.7. Where the music plays</a></li>
<li><span class="ixname">starting</span>, <a href="#_ix963">8.7.2. Starting Media Player</a></li>
<li><span class="ixname">where MIDI plays</span>, <a href="#_ix1565">11.7.9. MIDI music</a></li>
</ul></li>
<li><span class="ixname">memory</span>, <a href="#_ix57">2.2.2. Memory</a>
<ul>
<li><span class="ixname">conventional</span>, <a href="#_ix1443">11.2.6. Memory messages before the title screen</a></li>
<li><span class="ixname">free</span>, <a href="#_ix640">6.10.5. Help menu</a></li>
<li><span class="ixname">freeing</span>, <a href="#_ix58">2.2.2. Memory</a></li>
<li><span class="ixname">how much is free</span>, <a href="#_ix59">2.2.2. Memory</a></li>
<li><span class="ixname">in use</span>, <a href="#_ix497">5.10.1. The list of programs</a></li>
<li><span class="ixname">messages at start</span>, <a href="#_ix1429">11.2.6. Memory messages before the title screen</a></li>
<li><span class="ixname">running low</span>, <a href="#_ix1896">11.13.2. Running low on memory</a></li>
<li><span class="ixname">screen mode</span>, <a href="#_ix1417">11.2.2. DVX says the video card has no usable mode</a></li>
<li><span class="ixname">used by a program</span>, <a href="#_ix493">5.10.1. The list of programs</a></li>
</ul></li>
<li><span class="ixname">menus</span>, <a href="#_ix373">5.4. Menus</a>
<ul>
<li><span class="ixname">check marks</span>, <a href="#_ix378">5.4.3. Marks in menus</a>, <a href="#_ix860">8.2.6. Menus and keys</a></li>
<li><span class="ixname">context menus</span>, <a href="#_ix382">5.4.4. Context menus</a></li>
<li><span class="ixname">Help menu</span>, <a href="#_ix852">8.2.2. Help for every program</a></li>
<li><span class="ixname">marks</span>, <a href="#_ix377">5.4.3. Marks in menus</a></li>
<li><span class="ixname">menu bar</span>, <a href="#_ix341">5.3.1. Parts of a window</a></li>
<li><span class="ixname">option marks</span>, <a href="#_ix381">5.4.3. Marks in menus</a></li>
<li><span class="ixname">Program Manager</span>, <a href="#_ix634">6.10. Menus</a></li>
<li><span class="ixname">round marks</span>, <a href="#_ix861">8.2.6. Menus and keys</a></li>
<li><span class="ixname">shortcut keys</span>, <a href="#_ix379">5.4.3. Marks in menus</a></li>
<li><span class="ixname">Terminal</span>, <a href="#_ix1061">9.3.1. Menus</a></li>
<li><span class="ixname">using with the keyboard</span>, <a href="#_ix375">5.4.2. Using menus with the keyboard</a></li>
<li><span class="ixname">using with the mouse</span>, <a href="#_ix374">5.4.1. Using menus with the mouse</a></li>
</ul></li>
<li><span class="ixname">message boxes</span>, <a href="#_ix393">5.5.2. Message boxes</a>, <a href="#_ix1381">11.1.1. Read the message</a>
<ul>
<li><span class="ixname">keys</span>, <a href="#_ix1382">11.1.1. Read the message</a></li>
<li><span class="ixname">titles</span>, <a href="#_ix1384">11.1.1. Read the message</a></li>
</ul></li>
<li><span class="ixname">messages</span>, <a href="#_ix394">5.5.2. Message boxes</a>
<ul>
<li><span class="ixname">80386 required</span>, <a href="#_ix1434">11.2.6. Memory messages before the title screen</a></li>
<li><span class="ixname">a program is using a game controller</span>, <a href="#_ix797">7.11. Game Controllers page</a></li>
<li><span class="ixname">access denied</span>, <a href="#_ix1859">11.12.10.2. Questions while a copy, move, or delete runs</a></li>
<li><span class="ixname">add-ons</span>, <a href="#_ix237">3.12.2. What you see while DVX starts</a></li>
<li><span class="ixname">address not valid</span>, <a href="#_ix291">4.4.5. When a setting is not valid</a></li>
<li><span class="ixname">already exists</span>, <a href="#_ix454">5.6.3. Saving a file</a>, <a href="#_ix896">8.3.5. Copying and moving files and folders</a></li>
<li><span class="ixname">already exists replace</span>, <a href="#_ix1803">11.12.1. Messages in the Open, Save As, and Choose a Folder dialogs</a></li>
<li><span class="ixname">already exists replace it with</span>, <a href="#_ix1856">11.12.10.2. Questions while a copy, move, or delete runs</a></li>
<li><span class="ixname">already exists what should happen</span>, <a href="#_ix1715">11.10.7. File transfers</a></li>
<li><span class="ixname">already running</span>, <a href="#_ix550">6.2. Starting programs</a>, <a href="#_ix650">7.1. Opening Control Panel</a>, <a href="#_ix854">8.2.3. One copy or several</a>, <a href="#_ix1887">11.13.1. A program will not start</a></li>
<li><span class="ixname">already the shortcut</span>, <a href="#_ix593">6.4.4. Shortcut keys</a></li>
<li><span class="ixname">an extension is one to eight letters</span>, <a href="#_ix747">7.8.1. The Add File Type and Change File Type boxes</a></li>
<li><span class="ixname">another job is running</span>, <a href="#_ix1761">11.11.11. A package cannot be read</a></li>
<li><span class="ixname">Application Error</span>, <a href="#_ix507">5.10.3. When a program stops responding</a></li>
<li><span class="ixname">are you sure you want to exit DVX</span>, <a href="#_ix1912">11.13.5. DVX will not exit</a></li>
<li><span class="ixname">BASIC runtime error</span>, <a href="#_ix1925">11.14. Error messages from DVX BASIC programs</a></li>
<li><span class="ixname">before the desktop</span>, <a href="#_ix1386">11.1.1. Read the message</a></li>
<li><span class="ixname">built for a different version of DVX</span>, <a href="#_ix1889">11.13.1. A program will not start</a></li>
<li><span class="ixname">Cancelled</span>, <a href="#_ix1152">9.6.8. Transfer results and messages</a></li>
<li><span class="ixname">cannot be a shortcut key</span>, <a href="#_ix591">6.4.4. Shortcut keys</a></li>
<li><span class="ixname">cannot be installed</span>, <a href="#_ix1284">10.3.8. When a package cannot be installed</a></li>
<li><span class="ixname">cannot be installed package</span>, <a href="#_ix1760">11.11.11. A package cannot be read</a></li>
<li><span class="ixname">cannot be installed reason</span>, <a href="#_ix1768">11.11.13. A package &#8220;cannot be installed&#8221;</a></li>
<li><span class="ixname">cannot be published</span>, <a href="#_ix1337">10.7. Publishing your own packages</a></li>
<li><span class="ixname">cannot be reached</span>, <a href="#_ix1119">9.5.3. Connecting by Telnet</a></li>
<li><span class="ixname">cannot be reached check the network settings</span>, <a href="#_ix1671">11.9.9. A server cannot be reached</a></li>
<li><span class="ixname">cannot create the file</span>, <a href="#_ix2111">B.2.10. The <code>[printer]</code> section</a></li>
<li><span class="ixname">cannot create the file print</span>, <a href="#_ix1616">11.8.3. The printout stops before it starts</a></li>
<li><span class="ixname">cannot create the file transfer</span>, <a href="#_ix1714">11.10.7. File transfers</a></li>
<li><span class="ixname">cannot find</span>, <a href="#_ix232">3.12.1. DVX&#8217;s command-line switches</a>, <a href="#_ix1892">11.13.1. A program will not start</a></li>
<li><span class="ixname">Cannot find</span>, <a href="#_ix527">5.15. Running DOS programs</a>, <a href="#_ix624">6.7. Running a command</a></li>
<li><span class="ixname">cannot open folder or drive</span>, <a href="#_ix1853">11.12.10. File Manager</a></li>
<li><span class="ixname">cannot open swap file</span>, <a href="#_ix1441">11.2.6. Memory messages before the title screen</a></li>
<li><span class="ixname">cannot read or write</span>, <a href="#_ix898">8.3.5. Copying and moving files and folders</a></li>
<li><span class="ixname">capture file could not be opened</span>, <a href="#_ix1192">9.8.7. Capturing to a file</a>, <a href="#_ix1701">11.10.6. Terminal&#8217;s messages</a></li>
<li><span class="ixname">carrier lost</span>, <a href="#_ix1105">9.5.2. Dialing with a modem</a>, <a href="#_ix1692">11.10.4. Modems</a></li>
<li><span class="ixname">caused a fault</span>, <a href="#_ix1909">11.13.4. A program crashes</a></li>
<li><span class="ixname">changed or damaged</span>, <a href="#_ix1297">10.3.8. When a package cannot be installed</a></li>
<li><span class="ixname">changes cannot be saved to disk</span>, <a href="#_ix223">3.11.1. Running DVX from a CD-ROM or a write-protected disk</a>, <a href="#_ix1835">11.12.6. DVX runs from a disk it cannot write to</a>, <a href="#_ix2020">B.1.4. Running DVX from a disk it cannot write to</a></li>
<li><span class="ixname">choose a package first</span>, <a href="#_ix1243">10.2.6. Choosing a package and sorting the lists</a></li>
<li><span class="ixname">clipboard holds no files</span>, <a href="#_ix893">8.3.5. Copying and moving files and folders</a>, <a href="#_ix1854">11.12.10.1. Starting a copy, move, or delete</a></li>
<li><span class="ixname">Close Program</span>, <a href="#_ix535">5.16. Exiting DVX</a></li>
<li><span class="ixname">closed the connection</span>, <a href="#_ix1114">9.5.3. Connecting by Telnet</a></li>
<li><span class="ixname">COM could not be opened</span>, <a href="#_ix1683">11.10.2. A COM port cannot be opened</a></li>
<li><span class="ixname">computer name</span>, <a href="#_ix289">4.4.5. When a setting is not valid</a></li>
<li><span class="ixname">Connected</span>, <a href="#_ix299">4.5. Checking that it works</a></li>
<li><span class="ixname">Connected CONNECT</span>, <a href="#_ix1103">9.5.2. Dialing with a modem</a></li>
<li><span class="ixname">connected network</span>, <a href="#_ix1652">11.9.2. The Network Status window</a></li>
<li><span class="ixname">Connected to COM</span>, <a href="#_ix1094">9.5.1. Connecting by serial port</a></li>
<li><span class="ixname">Connected to host</span>, <a href="#_ix1113">9.5.3. Connecting by Telnet</a></li>
<li><span class="ixname">connection failed</span>, <a href="#_ix1120">9.5.3. Connecting by Telnet</a></li>
<li><span class="ixname">connection was lost</span>, <a href="#_ix1121">9.5.3. Connecting by Telnet</a>, <a href="#_ix1672">11.9.9. A server cannot be reached</a></li>
<li><span class="ixname">could not be loaded FATAL</span>, <a href="#_ix1423">11.2.4. DVX says a file could not be loaded</a></li>
<li><span class="ixname">could not create the folder</span>, <a href="#_ix138">3.3.4. Choosing the folder</a></li>
<li><span class="ixname">could not load</span>, <a href="#_ix1874">11.12.12. Other programs' file messages</a></li>
<li><span class="ixname">could not load wallpaper image</span>, <a href="#_ix712">7.6.1. Wallpaper</a>, <a href="#_ix1498">11.3.6. Colors, themes, and the desktop picture</a></li>
<li><span class="ixname">could not open error</span>, <a href="#_ix1863">11.12.11. Notepad</a></li>
<li><span class="ixname">could not open help file</span>, <a href="#_ix1007">8.9.7. DVX Help menu and keys</a>, <a href="#_ix1882">11.12.14. Help files</a></li>
<li><span class="ixname">could not prepare the icon for printing</span>, <a href="#_ix1634">11.8.8. Printing from particular programs</a></li>
<li><span class="ixname">could not run</span>, <a href="#_ix528">5.15. Running DOS programs</a></li>
<li><span class="ixname">could not save error 61</span>, <a href="#_ix1865">11.12.11. Notepad</a></li>
<li><span class="ixname">could not save error 75</span>, <a href="#_ix1864">11.12.11. Notepad</a></li>
<li><span class="ixname">could not save the theme file</span>, <a href="#_ix702">7.5.3. Changing a color and saving your own theme</a>, <a href="#_ix1499">11.3.6. Colors, themes, and the desktop picture</a></li>
<li><span class="ixname">could not start no usable graphics mode</span>, <a href="#_ix1412">11.2.2. DVX says the video card has no usable mode</a></li>
<li><span class="ixname">could not use mode</span>, <a href="#_ix1415">11.2.2. DVX says the video card has no usable mode</a></li>
<li><span class="ixname">could not write to the file</span>, <a href="#_ix1612">11.8.2. The printer has a problem</a></li>
<li><span class="ixname">did not answer</span>, <a href="#_ix1670">11.9.9. A server cannot be reached</a></li>
<li><span class="ixname">different set of DVX disks</span>, <a href="#_ix168">3.7.2. Changing floppy disks</a>, <a href="#_ix1738">11.11.4. Floppy disk questions</a></li>
<li><span class="ixname">different version of DVX</span>, <a href="#_ix551">6.2. Starting programs</a></li>
<li><span class="ixname">disk cannot be read</span>, <a href="#_ix170">3.7.2. Changing floppy disks</a></li>
<li><span class="ixname">disk cannot be read Setup</span>, <a href="#_ix1739">11.11.4. Floppy disk questions</a></li>
<li><span class="ixname">disk is full</span>, <a href="#_ix1858">11.12.10.2. Questions while a copy, move, or delete runs</a></li>
<li><span class="ixname">does not exist</span>, <a href="#_ix449">5.6.2. Opening a file</a></li>
<li><span class="ixname">does not exist check</span>, <a href="#_ix1804">11.12.1. Messages in the Open, Save As, and Choose a Folder dialogs</a></li>
<li><span class="ixname">does not exist create</span>, <a href="#_ix451">5.6.2. Opening a file</a>, <a href="#_ix1806">11.12.1. Messages in the Open, Save As, and Choose a Folder dialogs</a></li>
<li><span class="ixname">does not know that email</span>, <a href="#_ix1330">10.6.3. Messages from the package server</a></li>
<li><span class="ixname">does not know that email and password</span>, <a href="#_ix1796">11.11.19. Publishing packages</a></li>
<li><span class="ixname">drive is not ready</span>, <a href="#_ix1808">11.12.1. Messages in the Open, Save As, and Choose a Folder dialogs</a></li>
<li><span class="ixname">Drive Not Ready</span>, <a href="#_ix465">5.6.7. Drives</a></li>
<li><span class="ixname">DVX cannot save anything</span>, <a href="#_ix222">3.11.1. Running DVX from a CD-ROM or a write-protected disk</a>, <a href="#_ix1834">11.12.6. DVX runs from a disk it cannot write to</a>, <a href="#_ix2019">B.1.4. Running DVX from a disk it cannot write to</a></li>
<li><span class="ixname">DVX could not run</span>, <a href="#_ix1916">11.13.6. DOS programs</a></li>
<li><span class="ixname">DVX could not start</span>, <a href="#_ix75">2.3.2. When the card has no VESA BIOS</a></li>
<li><span class="ixname">DVX is already installed</span>, <a href="#_ix137">3.3.4. Choosing the folder</a></li>
<li><span class="ixname">DVX is already installed in</span>, <a href="#_ix1730">11.11.2. Choosing the folder</a></li>
<li><span class="ixname">DVX is not installed</span>, <a href="#_ix187">3.8. Upgrading or repairing DVX</a></li>
<li><span class="ixname">DVX is not installed in</span>, <a href="#_ix1729">11.11.2. Choosing the folder</a></li>
<li><span class="ixname">DVX is running from a disk it cannot write to</span>, <a href="#_ix1833">11.12.6. DVX runs from a disk it cannot write to</a></li>
<li><span class="ixname">DVX itself is removed with Setup</span>, <a href="#_ix1305">10.4. Removing add-ons</a></li>
<li><span class="ixname">DVX Setup needs a video card</span>, <a href="#_ix76">2.3.2. When the card has no VESA BIOS</a></li>
<li><span class="ixname">DVX stopped while starting</span>, <a href="#_ix242">3.12.2. What you see while DVX starts</a>, <a href="#_ix1446">11.2.7. DVX stops while starting</a></li>
<li><span class="ixname">enter the host name</span>, <a href="#_ix1115">9.5.3. Connecting by Telnet</a>, <a href="#_ix1699">11.10.6. Terminal&#8217;s messages</a></li>
<li><span class="ixname">exit DVX</span>, <a href="#_ix531">5.16. Exiting DVX</a></li>
<li><span class="ixname">exit DVX question</span>, <a href="#_ix504">5.10.2. The buttons</a>, <a href="#_ix1905">11.13.3. A program stops responding</a></li>
<li><span class="ixname">extension is one to eight letters</span>, <a href="#_ix1895">11.13.1. A program will not start</a></li>
<li><span class="ixname">external function not found</span>, <a href="#_ix1926">11.14.3. A part of DVX the program needs is missing</a></li>
<li><span class="ixname">failed to allocate backbuffer</span>, <a href="#_ix1416">11.2.2. DVX says the video card has no usable mode</a></li>
<li><span class="ixname">failed to change video mode</span>, <a href="#_ix735">7.7.2. If the new mode does not work</a>, <a href="#_ix1481">11.3.3. Choosing another screen mode</a></li>
<li><span class="ixname">failed to create instance copy</span>, <a href="#_ix1844">11.12.8. The TEMP folder</a></li>
<li><span class="ixname">failed to create task</span>, <a href="#_ix1891">11.13.1. A program will not start</a></li>
<li><span class="ixname">failed to load</span>, <a href="#_ix234">3.12.1. DVX&#8217;s command-line switches</a>, <a href="#_ix1427">11.2.5. DVX starts, then closes: the Program Manager cannot be loaded</a>, <a href="#_ix2071">B.2.7. The <code>[shell]</code> section: the desktop and the Welcome window</a></li>
<li><span class="ixname">failed to load program</span>, <a href="#_ix1888">11.13.1. A program will not start</a></li>
<li><span class="ixname">FATAL could not be loaded</span>, <a href="#_ix239">3.12.2. What you see while DVX starts</a></li>
<li><span class="ixname">file name not allowed</span>, <a href="#_ix908">8.3.7. File and folder names</a></li>
<li><span class="ixname">File Not Found</span>, <a href="#_ix450">5.6.2. Opening a file</a>, <a href="#_ix1805">11.12.1. Messages in the Open, Save As, and Choose a Folder dialogs</a></li>
<li><span class="ixname">file types could not be saved</span>, <a href="#_ix666">7.3.1. Clicking OK</a>, <a href="#_ix1850">11.12.9. Saving onto a full disk</a></li>
<li><span class="ixname">files changed since installed</span>, <a href="#_ix189">3.8. Upgrading or repairing DVX</a>, <a href="#_ix1282">10.3.7. When the install is done</a>, <a href="#_ix1303">10.4. Removing add-ons</a>, <a href="#_ix1747">11.11.6. Parts and add-ons in Setup</a></li>
<li><span class="ixname">files could not be deleted</span>, <a href="#_ix190">3.8. Upgrading or repairing DVX</a>, <a href="#_ix1304">10.4. Removing add-ons</a>, <a href="#_ix1748">11.11.6. Parts and add-ons in Setup</a>, <a href="#_ix1778">11.11.15. Removing a package</a></li>
<li><span class="ixname">files could not be removed</span>, <a href="#_ix201">3.9. Removing DVX</a></li>
<li><span class="ixname">finding</span>, <a href="#_ix1378">11. Troubleshooting</a></li>
<li><span class="ixname">folder cannot be read Media Player</span>, <a href="#_ix1593">11.7.17. Media Player</a></li>
<li><span class="ixname">folder does not exist</span>, <a href="#_ix1807">11.12.1. Messages in the Open, Save As, and Choose a Folder dialogs</a></li>
<li><span class="ixname">FONTS takes NONE or BASE</span>, <a href="#_ix207">3.10. Setup&#8217;s command-line switches</a></li>
<li><span class="ixname">from the package server</span>, <a href="#_ix1771">11.11.13. A package &#8220;cannot be installed&#8221;</a></li>
<li><span class="ixname">from the package server not signed</span>, <a href="#_ix1293">10.3.8. When a package cannot be installed</a></li>
<li><span class="ixname">game controller support is not installed</span>, <a href="#_ix1532">11.6. Game controllers do not work</a></li>
<li><span class="ixname">gateway not valid</span>, <a href="#_ix293">4.4.5. When a setting is not valid</a></li>
<li><span class="ixname">group is empty</span>, <a href="#_ix544">6.1. The Program Manager window</a></li>
<li><span class="ixname">group is full</span>, <a href="#_ix1920">11.13.8. Program Manager messages</a></li>
<li><span class="ixname">group needs a name</span>, <a href="#_ix560">6.3.2. Making a group</a></li>
<li><span class="ixname">help compiler is not available</span>, <a href="#_ix1875">11.12.12. Other programs' file messages</a></li>
<li><span class="ixname">host did not answer</span>, <a href="#_ix1118">9.5.3. Connecting by Telnet</a></li>
<li><span class="ixname">host did not answer the secure link</span>, <a href="#_ix1172">9.7.4. When the secure link does not connect</a></li>
<li><span class="ixname">host was not found</span>, <a href="#_ix1116">9.5.3. Connecting by Telnet</a>, <a href="#_ix1665">11.9.8. A computer&#8217;s name cannot be found</a></li>
<li><span class="ixname">how this guide shows them</span>, <a href="#_ix1387">11.1.1. Read the message</a></li>
<li><span class="ixname">image could not be saved</span>, <a href="#_ix478">5.8. Saving a picture of the screen</a>, <a href="#_ix1493">11.3.5. Other screen problems</a></li>
<li><span class="ixname">Image Viewer</span>, <a href="#_ix955">8.6.3. Printing a picture</a></li>
<li><span class="ixname">insert disk</span>, <a href="#_ix167">3.7.2. Changing floppy disks</a>, <a href="#_ix1736">11.11.4. Floppy disk questions</a></li>
<li><span class="ixname">installed</span>, <a href="#_ix1279">10.3.7. When the install is done</a></li>
<li><span class="ixname">installing did not finish</span>, <a href="#_ix1774">11.11.14. Installing or removing stops part way</a></li>
<li><span class="ixname">instrument bank missing or damaged</span>, <a href="#_ix1575">11.7.12. Instruments and SoundFont test messages</a></li>
<li><span class="ixname">interrupt could not be found</span>, <a href="#_ix1097">9.5.1. Connecting by serial port</a></li>
<li><span class="ixname">Invalid Filename</span>, <a href="#_ix463">5.6.6. File names</a></li>
<li><span class="ixname">invalid filename</span>, <a href="#_ix1814">11.12.2. File names that are not allowed</a></li>
<li><span class="ixname">Invalid Folder</span>, <a href="#_ix456">5.6.4. Choosing a folder</a></li>
<li><span class="ixname">is a file not a folder</span>, <a href="#_ix1809">11.12.1. Messages in the Open, Save As, and Choose a Folder dialogs</a></li>
<li><span class="ixname">is not installed</span>, <a href="#_ix658">7.2. The Control Panel window</a></li>
<li><span class="ixname">keep this display mode</span>, <a href="#_ix731">7.7.1. Changing the video mode</a>, <a href="#_ix1480">11.3.3. Choosing another screen mode</a></li>
<li><span class="ixname">key cannot be trusted</span>, <a href="#_ix1353">10.8.4. Trusting a publisher&#8217;s key</a></li>
<li><span class="ixname">larger than 2 GB</span>, <a href="#_ix1156">9.6.8. Transfer results and messages</a></li>
<li><span class="ixname">licence of the font cannot be read</span>, <a href="#_ix1879">11.12.13. Fonts</a></li>
<li><span class="ixname">line is busy</span>, <a href="#_ix1690">11.10.4. Modems</a></li>
<li><span class="ixname">list of all</span>, <a href="#_ix1949">11.17. Messages, A to Z</a></li>
<li><span class="ixname">Load error no DOS memory</span>, <a href="#_ix1435">11.2.6. Memory messages before the title screen</a></li>
<li><span class="ixname">Load error no DPMI memory</span>, <a href="#_ix1436">11.2.6. Memory messages before the title screen</a></li>
<li><span class="ixname">Load error not EXE</span>, <a href="#_ix1437">11.2.6. Memory messages before the title screen</a></li>
<li><span class="ixname">made for a different version</span>, <a href="#_ix1289">10.3.8. When a package cannot be installed</a></li>
<li><span class="ixname">Media Player</span>, <a href="#_ix976">8.7.9. Media Player messages</a></li>
<li><span class="ixname">Media Player cannot play</span>, <a href="#_ix1592">11.7.17. Media Player</a></li>
<li><span class="ixname">modem did not answer</span>, <a href="#_ix1106">9.5.2. Dialing with a modem</a>, <a href="#_ix1689">11.10.4. Modems</a></li>
<li><span class="ixname">modem refused the dial command</span>, <a href="#_ix1109">9.5.2. Dialing with a modem</a></li>
<li><span class="ixname">modem refused the setup command</span>, <a href="#_ix1107">9.5.2. Dialing with a modem</a></li>
<li><span class="ixname">move the stick further</span>, <a href="#_ix798">7.11.1. Calibrating a joystick</a>, <a href="#_ix1531">11.6. Game controllers do not work</a></li>
<li><span class="ixname">name could not be found</span>, <a href="#_ix1674">11.9.10. Network messages in BASIC programs</a></li>
<li><span class="ixname">name server not valid</span>, <a href="#_ix290">4.4.5. When a setting is not valid</a></li>
<li><span class="ixname">needs a newer DVX</span>, <a href="#_ix1288">10.3.8. When a package cannot be installed</a></li>
<li><span class="ixname">needs the Networking part</span>, <a href="#_ix1251">10.2.8. Software without the Networking part</a></li>
<li><span class="ixname">network settings</span>, <a href="#_ix288">4.4.5. When a setting is not valid</a>, <a href="#_ix767">7.9.2. Problems that stop OK</a>, <a href="#_ix1661">11.9.7. Control Panel will not accept the network settings</a></li>
<li><span class="ixname">Networking is not installed</span>, <a href="#_ix271">4.2.1. Adding the Networking part</a></li>
<li><span class="ixname">networking is not installed</span>, <a href="#_ix1653">11.9.3. Networking is not installed</a></li>
<li><span class="ixname">Networking is not started</span>, <a href="#_ix302">4.5. Checking that it works</a></li>
<li><span class="ixname">networking is not started</span>, <a href="#_ix1649">11.9.2. The Network Status window</a></li>
<li><span class="ixname">newer version is installed</span>, <a href="#_ix1290">10.3.8. When a package cannot be installed</a></li>
<li><span class="ixname">no dial tone</span>, <a href="#_ix1108">9.5.2. Dialing with a modem</a>, <a href="#_ix1691">11.10.4. Modems</a></li>
<li><span class="ixname">no DVX package</span>, <a href="#_ix203">3.9. Removing DVX</a></li>
<li><span class="ixname">no DVX package beside</span>, <a href="#_ix1724">11.11.1. Setup will not start</a></li>
<li><span class="ixname">no file transfer can be started</span>, <a href="#_ix1157">9.6.8. Transfer results and messages</a></li>
<li><span class="ixname">no file transfer can be started now</span>, <a href="#_ix1702">11.10.6. Terminal&#8217;s messages</a></li>
<li><span class="ixname">no game controllers found</span>, <a href="#_ix1528">11.6. Game controllers do not work</a></li>
<li><span class="ixname">no longer has its shortcut key</span>, <a href="#_ix592">6.4.4. Shortcut keys</a></li>
<li><span class="ixname">no matching topics found</span>, <a href="#_ix1004">8.9.6. Searching</a></li>
<li><span class="ixname">no modules loaded</span>, <a href="#_ix1425">11.2.4. DVX says a file could not be loaded</a></li>
<li><span class="ixname">no music or sound files</span>, <a href="#_ix1594">11.7.17. Media Player</a></li>
<li><span class="ixname">no other group</span>, <a href="#_ix602">6.4.8. Copying an item to a group</a></li>
<li><span class="ixname">No packet driver found</span>, <a href="#_ix301">4.5. Checking that it works</a></li>
<li><span class="ixname">no packet driver found</span>, <a href="#_ix1650">11.9.2. The Network Status window</a></li>
<li><span class="ixname">no port</span>, <a href="#_ix1614">11.8.3. The printout stops before it starts</a></li>
<li><span class="ixname">no program is set</span>, <a href="#_ix886">8.3.4. Opening files and starting programs</a></li>
<li><span class="ixname">no program is set to open</span>, <a href="#_ix1860">11.12.10.3. New Folder, Rename, opening, and Properties</a></li>
<li><span class="ixname">no program is set up</span>, <a href="#_ix233">3.12.1. DVX&#8217;s command-line switches</a></li>
<li><span class="ixname">no program is set up to open</span>, <a href="#_ix1893">11.13.1. A program will not start</a></li>
<li><span class="ixname">no program set up</span>, <a href="#_ix625">6.7. Running a command</a></li>
<li><span class="ixname">no room for another group</span>, <a href="#_ix561">6.3.2. Making a group</a></li>
<li><span class="ixname">no serial port there</span>, <a href="#_ix1095">9.5.1. Connecting by serial port</a></li>
<li><span class="ixname">no signature by DVX&#8217;s key</span>, <a href="#_ix1331">10.6.3. Messages from the package server</a></li>
<li><span class="ixname">no sound device could be started</span>, <a href="#_ix1580">11.7.14. Sound and music messages</a></li>
<li><span class="ixname">no suitable mode found</span>, <a href="#_ix1414">11.2.2. DVX says the video card has no usable mode</a></li>
<li><span class="ixname">no usable graphics mode</span>, <a href="#_ix74">2.3.2. When the card has no VESA BIOS</a></li>
<li><span class="ixname">no VESA BIOS extension</span>, <a href="#_ix1413">11.2.2. DVX says the video card has no usable mode</a></li>
<li><span class="ixname">not a text file</span>, <a href="#_ix935">8.4.5. File size and line ends</a>, <a href="#_ix1867">11.12.11. Notepad</a></li>
<li><span class="ixname">not connected joystick</span>, <a href="#_ix1529">11.6. Game controllers do not work</a></li>
<li><span class="ixname">not enough free space</span>, <a href="#_ix87">2.5. Disk space</a>, <a href="#_ix141">3.3.5. Choosing what to install</a></li>
<li><span class="ixname">not enough free space for DVX</span>, <a href="#_ix1733">11.11.3. Not enough disk space, or the folder cannot be made</a></li>
<li><span class="ixname">not enough memory</span>, <a href="#_ix1296">10.3.8. When a package cannot be installed</a></li>
<li><span class="ixname">not enough memory to capture the image</span>, <a href="#_ix1492">11.3.5. Other screen problems</a></li>
<li><span class="ixname">not enough memory to print</span>, <a href="#_ix1617">11.8.3. The printout stops before it starts</a></li>
<li><span class="ixname">not enough memory to run Setup</span>, <a href="#_ix1726">11.11.1. Setup will not start</a></li>
<li><span class="ixname">not enough memory to start Software</span>, <a href="#_ix1757">11.11.10. Software will not start, or its server pages are off</a></li>
<li><span class="ixname">not enough room on the disk</span>, <a href="#_ix1275">10.3.5. Disk space</a></li>
<li><span class="ixname">not enough room on the disk package</span>, <a href="#_ix1775">11.11.14. Installing or removing stops part way</a></li>
<li><span class="ixname">not installed by this Setup</span>, <a href="#_ix200">3.9. Removing DVX</a></li>
<li><span class="ixname">not responding</span>, <a href="#_ix1903">11.13.3. A program stops responding</a></li>
<li><span class="ixname">not responding to close</span>, <a href="#_ix534">5.16. Exiting DVX</a></li>
<li><span class="ixname">not responding to the request to close</span>, <a href="#_ix1913">11.13.5. DVX will not exit</a></li>
<li><span class="ixname">not signed by a publisher DVX trusts</span>, <a href="#_ix1765">11.11.12. The Install Software window</a></li>
<li><span class="ixname">not signed by the publisher</span>, <a href="#_ix1291">10.3.8. When a package cannot be installed</a></li>
<li><span class="ixname">not signed by the publisher of the installed version</span>, <a href="#_ix1769">11.11.13. A package &#8220;cannot be installed&#8221;</a></li>
<li><span class="ixname">Notepad</span>, <a href="#_ix942">8.4.8. Notepad messages</a></li>
<li><span class="ixname">old settings could not all be removed</span>, <a href="#_ix191">3.8. Upgrading or repairing DVX</a></li>
<li><span class="ixname">other software needs these parts</span>, <a href="#_ix1746">11.11.6. Parts and add-ons in Setup</a></li>
<li><span class="ixname">out of memory application slot</span>, <a href="#_ix1890">11.13.1. A program will not start</a></li>
<li><span class="ixname">package server</span>, <a href="#_ix1326">10.6.3. Messages from the package server</a></li>
<li><span class="ixname">package server cannot be reached</span>, <a href="#_ix1781">11.11.16. The package server cannot be reached</a></li>
<li><span class="ixname">package server cannot be saved</span>, <a href="#_ix1788">11.11.17. The Package Server window</a></li>
<li><span class="ixname">package server needs Networking</span>, <a href="#_ix272">4.2.1. Adding the Networking part</a>, <a href="#_ix1758">11.11.10. Software will not start, or its server pages are off</a></li>
<li><span class="ixname">page setup</span>, <a href="#_ix781">7.10.1. Page Setup</a>, <a href="#_ix1629">11.8.7. Print dialog and Page Setup messages</a></li>
<li><span class="ixname">page setup could not be saved</span>, <a href="#_ix1630">11.8.7. Print dialog and Page Setup messages</a></li>
<li><span class="ixname">page table memory</span>, <a href="#_ix1440">11.2.6. Memory messages before the title screen</a></li>
<li><span class="ixname">passphrase does not match</span>, <a href="#_ix1170">9.7.4. When the secure link does not connect</a>, <a href="#_ix1695">11.10.5. The secure link</a></li>
<li><span class="ixname">path is too long</span>, <a href="#_ix1810">11.12.1. Messages in the Open, Save As, and Choose a Folder dialogs</a></li>
<li><span class="ixname">phone book cannot be read</span>, <a href="#_ix1197">9.8.8. Where Terminal keeps its settings</a>, <a href="#_ix1704">11.10.6. Terminal&#8217;s messages</a></li>
<li><span class="ixname">phone book could not be saved</span>, <a href="#_ix1196">9.8.8. Where Terminal keeps its settings</a>, <a href="#_ix1705">11.10.6. Terminal&#8217;s messages</a></li>
<li><span class="ixname">phone book is full</span>, <a href="#_ix1074">9.4.1. Adding a session</a>, <a href="#_ix1703">11.10.6. Terminal&#8217;s messages</a></li>
<li><span class="ixname">plain http only</span>, <a href="#_ix1319">10.6.1. The Package Server window</a>, <a href="#_ix1782">11.11.16. The package server cannot be reached</a></li>
<li><span class="ixname">port already in use</span>, <a href="#_ix1096">9.5.1. Connecting by serial port</a></li>
<li><span class="ixname">port cannot be opened</span>, <a href="#_ix1615">11.8.3. The printout stops before it starts</a></li>
<li><span class="ixname">port did not respond</span>, <a href="#_ix1099">9.5.1. Connecting by serial port</a></li>
<li><span class="ixname">port is a number</span>, <a href="#_ix1322">10.6.1. The Package Server window</a></li>
<li><span class="ixname">port stopped working</span>, <a href="#_ix1100">9.5.1. Connecting by serial port</a></li>
<li><span class="ixname">printer driver is missing</span>, <a href="#_ix1623">11.8.5. The printer driver is missing</a></li>
<li><span class="ixname">printer not responding</span>, <a href="#_ix1611">11.8.2. The printer has a problem</a></li>
<li><span class="ixname">printer off line</span>, <a href="#_ix1609">11.8.2. The printer has a problem</a></li>
<li><span class="ixname">printer out of paper</span>, <a href="#_ix1608">11.8.2. The printer has a problem</a></li>
<li><span class="ixname">printer reports an error</span>, <a href="#_ix1610">11.8.2. The printer has a problem</a></li>
<li><span class="ixname">printing</span>, <a href="#_ix938">8.4.6. Printing from Notepad</a></li>
<li><span class="ixname">printing is not installed</span>, <a href="#_ix1635">11.8.8. Printing from particular programs</a></li>
<li><span class="ixname">printing is not installed control panel</span>, <a href="#_ix1636">11.8.8. Printing from particular programs</a></li>
<li><span class="ixname">prints text only</span>, <a href="#_ix1620">11.8.4. Pictures do not print</a></li>
<li><span class="ixname">program is using a game controller</span>, <a href="#_ix1530">11.6. Game controllers do not work</a></li>
<li><span class="ixname">protected mode not accessible</span>, <a href="#_ix1438">11.2.6. Memory messages before the title screen</a></li>
<li><span class="ixname">read-only delete it anyway</span>, <a href="#_ix1857">11.12.10.2. Questions while a copy, move, or delete runs</a></li>
<li><span class="ixname">reading</span>, <a href="#_ix1379">11.1.1. Read the message</a></li>
<li><span class="ixname">receiver did not start</span>, <a href="#_ix1153">9.6.8. Transfer results and messages</a>, <a href="#_ix1711">11.10.7. File transfers</a></li>
<li><span class="ixname">refused the connection</span>, <a href="#_ix1117">9.5.3. Connecting by Telnet</a>, <a href="#_ix1669">11.9.9. A server cannot be reached</a></li>
<li><span class="ixname">remove</span>, <a href="#_ix199">3.9. Removing DVX</a></li>
<li><span class="ixname">remove them all</span>, <a href="#_ix1301">10.4. Removing add-ons</a></li>
<li><span class="ixname">remove them too</span>, <a href="#_ix1302">10.4. Removing add-ons</a></li>
<li><span class="ixname">Run DOS Program</span>, <a href="#_ix524">5.15. Running DOS programs</a></li>
<li><span class="ixname">running a DOS program</span>, <a href="#_ix885">8.3.4. Opening files and starting programs</a></li>
<li><span class="ixname">running closes these programs first</span>, <a href="#_ix1915">11.13.6. DOS programs</a></li>
<li><span class="ixname">running from a disk it cannot write to</span>, <a href="#_ix220">3.11.1. Running DVX from a CD-ROM or a write-protected disk</a>, <a href="#_ix2018">B.1.4. Running DVX from a disk it cannot write to</a></li>
<li><span class="ixname">safe video mode</span>, <a href="#_ix246">3.13.1. Safe video mode</a>, <a href="#_ix1471">11.3.2. The Safe Video Mode question</a></li>
<li><span class="ixname">Save changes</span>, <a href="#_ix395">5.5.2. Message boxes</a>, <a href="#_ix929">8.4.4. Opening and saving files</a></li>
<li><span class="ixname">says it is part of DVX</span>, <a href="#_ix1292">10.3.8. When a package cannot be installed</a>, <a href="#_ix1770">11.11.13. A package &#8220;cannot be installed&#8221;</a></li>
<li><span class="ixname">screen mode could not be saved</span>, <a href="#_ix247">3.13.1. Safe video mode</a>, <a href="#_ix1476">11.3.2. The Safe Video Mode question</a></li>
<li><span class="ixname">screen mode does not work on this computer</span>, <a href="#_ix1473">11.3.2. The Safe Video Mode question</a></li>
<li><span class="ixname">secure link cannot use XON/XOFF</span>, <a href="#_ix1168">9.7.2. Setting up a secure link session</a>, <a href="#_ix1696">11.10.5. The secure link</a></li>
<li><span class="ixname">secure link over a COM port</span>, <a href="#_ix1700">11.10.6. Terminal&#8217;s messages</a></li>
<li><span class="ixname">secure link was lost</span>, <a href="#_ix1173">9.7.4. When the secure link does not connect</a></li>
<li><span class="ixname">sender did not start</span>, <a href="#_ix1154">9.6.8. Transfer results and messages</a>, <a href="#_ix1712">11.10.7. File transfers</a></li>
<li><span class="ixname">server cannot be reached</span>, <a href="#_ix1329">10.6.3. Messages from the package server</a></li>
<li><span class="ixname">setting is not supported</span>, <a href="#_ix1098">9.5.1. Connecting by serial port</a></li>
<li><span class="ixname">settings could not be saved</span>, <a href="#_ix665">7.3.1. Clicking OK</a>, <a href="#_ix1849">11.12.9. Saving onto a full disk</a></li>
<li><span class="ixname">settings file could not be written</span>, <a href="#_ix173">3.7.3. DVX&#8217;s settings file</a></li>
<li><span class="ixname">Setup could not create the folder</span>, <a href="#_ix1734">11.11.3. Not enough disk space, or the folder cannot be made</a></li>
<li><span class="ixname">Setup could not write</span>, <a href="#_ix1741">11.11.5. Setup stops while unpacking</a></li>
<li><span class="ixname">Setup folder page</span>, <a href="#_ix133">3.3.4. Choosing the folder</a></li>
<li><span class="ixname">Setup is reading DVX from</span>, <a href="#_ix136">3.3.4. Choosing the folder</a></li>
<li><span class="ixname">Setup keeps parts</span>, <a href="#_ix188">3.8. Upgrading or repairing DVX</a></li>
<li><span class="ixname">Setup needs a video card</span>, <a href="#_ix1725">11.11.1. Setup will not start</a></li>
<li><span class="ixname">Setup was cancelled</span>, <a href="#_ix165">3.7.1. While Setup installs</a></li>
<li><span class="ixname">shortcut key</span>, <a href="#_ix589">6.4.4. Shortcut keys</a></li>
<li><span class="ixname">signature does not fit</span>, <a href="#_ix1295">10.3.8. When a package cannot be installed</a></li>
<li><span class="ixname">signed by another key</span>, <a href="#_ix1294">10.3.8. When a package cannot be installed</a></li>
<li><span class="ixname">sound</span>, <a href="#_ix1579">11.7.14. Sound and music messages</a></li>
<li><span class="ixname">sound card cannot record</span>, <a href="#_ix1588">11.7.16. Recording sound</a></li>
<li><span class="ixname">sound device none running</span>, <a href="#_ix827">7.12.2. Sound hardware and music</a>, <a href="#_ix1541">11.7.2. Nothing is heard</a></li>
<li><span class="ixname">sound driver and MIDI changes</span>, <a href="#_ix1542">11.7.2. Nothing is heard</a></li>
<li><span class="ixname">sound is not installed</span>, <a href="#_ix1543">11.7.2. Nothing is heard</a></li>
<li><span class="ixname">Sound Recorder</span>, <a href="#_ix993">8.8.7. Sound Recorder messages</a></li>
<li><span class="ixname">Sound Recorder cannot record</span>, <a href="#_ix1589">11.7.16. Recording sound</a></li>
<li><span class="ixname">sounds test failed</span>, <a href="#_ix1561">11.7.8. Desktop sounds</a></li>
<li><span class="ixname">started in safe video mode as you asked</span>, <a href="#_ix1474">11.3.2. The Safe Video Mode question</a></li>
<li><span class="ixname">subnet mask not valid</span>, <a href="#_ix292">4.4.5. When a setting is not valid</a></li>
<li><span class="ixname">swap space</span>, <a href="#_ix1442">11.2.6. Memory messages before the title screen</a></li>
<li><span class="ixname">synthesizer or sound device is being used</span>, <a href="#_ix1582">11.7.14. Sound and music messages</a></li>
<li><span class="ixname">Telnet needs Networking</span>, <a href="#_ix1698">11.10.6. Terminal&#8217;s messages</a></li>
<li><span class="ixname">the details are in</span>, <a href="#_ix1447">11.2.7. DVX stops while starting</a></li>
<li><span class="ixname">the folder DVXUSER names</span>, <a href="#_ix225">3.11.1. Running DVX from a CD-ROM or a write-protected disk</a>, <a href="#_ix1837">11.12.6. DVX runs from a disk it cannot write to</a>, <a href="#_ix2022">B.1.4. Running DVX from a disk it cannot write to</a></li>
<li><span class="ixname">theme file name is too long</span>, <a href="#_ix701">7.5.3. Changing a color and saving your own theme</a></li>
<li><span class="ixname">this is not disk</span>, <a href="#_ix169">3.7.2. Changing floppy disks</a>, <a href="#_ix1737">11.11.4. Floppy disk questions</a></li>
<li><span class="ixname">too big for Notepad</span>, <a href="#_ix931">8.4.5. File size and line ends</a>, <a href="#_ix1868">11.12.11. Notepad</a>, <a href="#_ix2245">B.6.2. Reading the log</a></li>
<li><span class="ixname">too many errors</span>, <a href="#_ix1155">9.6.8. Transfer results and messages</a>, <a href="#_ix1713">11.10.7. File transfers</a></li>
<li><span class="ixname">too many sounds are playing</span>, <a href="#_ix1581">11.7.14. Sound and music messages</a></li>
<li><span class="ixname">Transfer complete</span>, <a href="#_ix1151">9.6.8. Transfer results and messages</a></li>
<li><span class="ixname">type the folder</span>, <a href="#_ix134">3.3.4. Choosing the folder</a></li>
<li><span class="ixname">type the name of the file to print to</span>, <a href="#_ix777">7.10. Printer page</a>, <a href="#_ix1626">11.8.6. Printing to a file</a></li>
<li><span class="ixname">type the program</span>, <a href="#_ix576">6.4.3. Item properties</a></li>
<li><span class="ixname">type the program that opens this type</span>, <a href="#_ix748">7.8.1. The Add File Type and Change File Type boxes</a></li>
<li><span class="ixname">type the whole path</span>, <a href="#_ix135">3.3.4. Choosing the folder</a></li>
<li><span class="ixname">upgrade</span>, <a href="#_ix186">3.8. Upgrading or repairing DVX</a></li>
<li><span class="ixname">Waiting for a DHCP server</span>, <a href="#_ix300">4.5. Checking that it works</a></li>
<li><span class="ixname">waiting for a DHCP server</span>, <a href="#_ix1651">11.9.2. The Network Status window</a></li>
<li><span class="ixname">was not loaded</span>, <a href="#_ix1370">10.10.1. Add-ons left out at start-up</a>, <a href="#_ix1456">11.2.9. DVX says add-ons were not loaded</a></li>
<li><span class="ixname">which is not here</span>, <a href="#_ix1287">10.3.8. When a package cannot be installed</a></li>
<li><span class="ixname">XMS switched CPU into V86 mode</span>, <a href="#_ix1439">11.2.6. Memory messages before the title screen</a></li>
</ul></li>
<li><span class="ixname">MIDI</span>
<ul>
<li><span class="ixname">DVX General MIDI</span>, <a href="#_ix157">3.6. The add-ons on the CD</a>, <a href="#_ix1269">10.3.3. The add-ons on the DVX CD</a></li>
<li><span class="ixname">external synthesizer</span>, <a href="#_ix101">2.6.2. MIDI</a>, <a href="#_ix1571">11.7.11. MIDI music to an external synthesizer is silent</a></li>
<li><span class="ixname">General MIDI SoundFont</span>, <a href="#_ix1567">11.7.10. MIDI music plays on the wrong instruments, or sounds like the FM chip</a></li>
<li><span class="ixname">hardware</span>, <a href="#_ix99">2.6.2. MIDI</a></li>
<li><span class="ixname">input</span>, <a href="#_ix104">2.6.2. MIDI</a></li>
<li><span class="ixname">instrument add-ons</span>, <a href="#_ix1211">10.1.1. Kinds of packages</a></li>
<li><span class="ixname">instrument banks</span>, <a href="#_ix46">1.4.3. Sounds and music</a>, <a href="#_ix821">7.12.2. Sound hardware and music</a>, <a href="#_ix1574">11.7.12. Instruments and SoundFont test messages</a>, <a href="#_ix2138">B.2.11. The <code>[audio]</code> section: sound hardware and music</a></li>
<li><span class="ixname">instrument banks folder</span>, <a href="#_ix1984">B.1.1. The DVX folder</a></li>
<li><span class="ixname">keyboard</span>, <a href="#_ix103">2.6.2. MIDI</a></li>
<li><span class="ixname">MIDI in</span>, <a href="#_ix817">7.12.2. Sound hardware and music</a></li>
<li><span class="ixname">MPU-401</span>, <a href="#_ix100">2.6.2. MIDI</a>, <a href="#_ix1572">11.7.11. MIDI music to an external synthesizer is silent</a></li>
<li><span class="ixname">music choices</span>, <a href="#_ix2150">B.2.11. The <code>[audio]</code> section: sound hardware and music</a></li>
<li><span class="ixname">playing</span>, <a href="#_ix961">8.7.1. What Media Player plays</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix1562">11.7.9. MIDI music</a></li>
<li><span class="ixname">recording a keyboard</span>, <a href="#_ix986">8.8.4. Recording a MIDI keyboard</a></li>
<li><span class="ixname">Roland MT-32</span>, <a href="#_ix1573">11.7.11. MIDI music to an external synthesizer is silent</a></li>
<li><span class="ixname">SoundFont</span>, <a href="#_ix823">7.12.2. Sound hardware and music</a>, <a href="#_ix2140">B.2.11. The <code>[audio]</code> section: sound hardware and music</a></li>
<li><span class="ixname">testing instruments</span>, <a href="#_ix825">7.12.2. Sound hardware and music</a></li>
<li><span class="ixname">wavetable</span>, <a href="#_ix102">2.6.2. MIDI</a></li>
<li><span class="ixname">wavetable memory</span>, <a href="#_ix1570">11.7.10. MIDI music plays on the wrong instruments, or sounds like the FM chip</a></li>
<li><span class="ixname">where it plays</span>, <a href="#_ix1563">11.7.9. MIDI music</a></li>
<li><span class="ixname">where music plays</span>, <a href="#_ix815">7.12.2. Sound hardware and music</a></li>
<li><span class="ixname">wrong instruments</span>, <a href="#_ix1566">11.7.10. MIDI music plays on the wrong instruments, or sounds like the FM chip</a></li>
</ul></li>
<li><span class="ixname">Minimize on Run</span>, <a href="#_ix631">6.9. Options</a></li>
<li><span class="ixname">modems</span>, <a href="#_ix108">2.6.4. Serial ports and modems</a>, <a href="#_ix1054">9.1. What you need</a>
<ul>
<li><span class="ixname">AT commands</span>, <a href="#_ix1110">9.5.2. Dialing with a modem</a></li>
<li><span class="ixname">dial command</span>, <a href="#_ix1085">9.4.4.2. The Modem page</a></li>
<li><span class="ixname">dialing</span>, <a href="#_ix1101">9.5.2. Dialing with a modem</a></li>
<li><span class="ixname">hanging up</span>, <a href="#_ix1104">9.5.2. Dialing with a modem</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix1687">11.10.4. Modems</a></li>
<li><span class="ixname">redialing</span>, <a href="#_ix1086">9.4.4.2. The Modem page</a></li>
<li><span class="ixname">setup command</span>, <a href="#_ix1084">9.4.4.2. The Modem page</a></li>
</ul></li>
<li><span class="ixname">monitor</span>
<ul>
<li><span class="ixname">cannot show mode</span>, <a href="#_ix1466">11.3.1. The screen is blank or cannot be read after DVX starts</a></li>
</ul></li>
<li><span class="ixname">More Fonts</span>, <a href="#_ix1266">10.3.3. The add-ons on the DVX CD</a></li>
<li><span class="ixname">mouse</span>, <a href="#_ix313">5.2. Using the mouse and the keyboard</a>
<ul>
<li><span class="ixname">acceleration</span>, <a href="#_ix677">7.4. Mouse page</a>, <a href="#_ix1511">11.4.3. The pointer is hard to control, or double-clicks do not work</a></li>
<li><span class="ixname">buttons</span>, <a href="#_ix1513">11.4.3. The pointer is hard to control, or double-clicks do not work</a></li>
<li><span class="ixname">click</span>, <a href="#_ix52">1.5.3. Conventions</a></li>
<li><span class="ixname">clicking</span>, <a href="#_ix315">5.2.1. The mouse</a></li>
<li><span class="ixname">cursor speed</span>, <a href="#_ix680">7.4. Mouse page</a></li>
<li><span class="ixname">double-click speed</span>, <a href="#_ix674">7.4. Mouse page</a>, <a href="#_ix1512">11.4.3. The pointer is hard to control, or double-clicks do not work</a></li>
<li><span class="ixname">double-clicking</span>, <a href="#_ix318">5.2.1. The mouse</a></li>
<li><span class="ixname">dragging</span>, <a href="#_ix316">5.2.1. The mouse</a></li>
<li><span class="ixname">driver</span>, <a href="#_ix79">2.4. Mouse</a>, <a href="#_ix1503">11.4.1. The pointer does not move</a></li>
<li><span class="ixname">DVX.INI</span>, <a href="#_ix2059">B.2.6. The <code>[mouse]</code> section</a></li>
<li><span class="ixname">hourglass</span>, <a href="#_ix325">5.2.1. The mouse</a></li>
<li><span class="ixname">no driver</span>, <a href="#_ix80">2.4. Mouse</a></li>
<li><span class="ixname">not detected</span>, <a href="#_ix1399">11.1.7. Find out about your computer</a></li>
<li><span class="ixname">pointer does not move</span>, <a href="#_ix1502">11.4.1. The pointer does not move</a></li>
<li><span class="ixname">pointer shapes</span>, <a href="#_ix323">5.2.1. The mouse</a></li>
<li><span class="ixname">pointer speed</span>, <a href="#_ix679">7.4. Mouse page</a>, <a href="#_ix2065">B.2.6. The <code>[mouse]</code> section</a></li>
<li><span class="ixname">pointing</span>, <a href="#_ix317">5.2.1. The mouse</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix1501">11.4. The mouse does not work</a></li>
<li><span class="ixname">right button</span>, <a href="#_ix319">5.2.1. The mouse</a>, <a href="#_ix384">5.4.4. Context menus</a></li>
<li><span class="ixname">scroll speed</span>, <a href="#_ix672">7.4. Mouse page</a></li>
<li><span class="ixname">scroll wheel</span>, <a href="#_ix320">5.2.1. The mouse</a>, <a href="#_ix670">7.4. Mouse page</a>, <a href="#_ix1507">11.4.2. The scroll wheel does nothing</a></li>
<li><span class="ixname">settings</span>, <a href="#_ix668">7.4. Mouse page</a></li>
<li><span class="ixname">testing double-clicks</span>, <a href="#_ix682">7.4. Mouse page</a></li>
<li><span class="ixname">too fast</span>, <a href="#_ix1509">11.4.3. The pointer is hard to control, or double-clicks do not work</a></li>
<li><span class="ixname">too slow</span>, <a href="#_ix1510">11.4.3. The pointer is hard to control, or double-clicks do not work</a></li>
<li><span class="ixname">wheel</span>, <a href="#_ix81">2.4. Mouse</a></li>
<li><span class="ixname">wheel driver</span>, <a href="#_ix684">7.4.1. Adjusting the double-click speed</a></li>
</ul></li>
<li><span class="ixname">mouse driver</span>
<ul>
<li><span class="ixname">loading</span>, <a href="#_ix1504">11.4.1. The pointer does not move</a></li>
</ul></li>
<li><span class="ixname">music</span>
<ul>
<li><span class="ixname">ANSI music</span>, <a href="#_ix1183">9.8.5. ANSI music and the bell</a></li>
<li><span class="ixname">playing</span>, <a href="#_ix958">8.7. Media Player</a></li>
</ul></li>
<li><span class="ixname">music modules</span>, <a href="#_ix962">8.7.1. What Media Player plays</a>, <a href="#_ix1576">11.7.13. Music modules (MOD, S3M, XM, and IT files)</a></li>
</ul>
<h3 id="_ixgroup_N">N</h3>
<ul class="ixlist">
<li><span class="ixname">name servers</span>, <a href="#_ix284">4.4.3. Name servers</a>, <a href="#_ix1664">11.9.8. A computer&#8217;s name cannot be found</a></li>
<li><span class="ixname">network card</span>, <a href="#_ix106">2.6.3. Network card</a>, <a href="#_ix268">4.2. What you need</a></li>
<li><span class="ixname">Network Status window</span>, <a href="#_ix296">4.5. Checking that it works</a>, <a href="#_ix1647">11.9.2. The Network Status window</a>
<ul>
<li><span class="ixname">lines</span>, <a href="#_ix297">4.5. Checking that it works</a></li>
<li><span class="ixname">states</span>, <a href="#_ix298">4.5. Checking that it works</a></li>
</ul></li>
<li><span class="ixname">networking</span>, <a href="#_ix261">4. Setting Up Networking</a>
<ul>
<li><span class="ixname">adding</span>, <a href="#_ix1363">10.9.1. Adding a part after Setup</a></li>
<li><span class="ixname">address</span>, <a href="#_ix755">7.9. Network page</a></li>
<li><span class="ixname">BASIC program messages</span>, <a href="#_ix1673">11.9.10. Network messages in BASIC programs</a></li>
<li><span class="ixname">checking</span>, <a href="#_ix295">4.5. Checking that it works</a></li>
<li><span class="ixname">computer name</span>, <a href="#_ix761">7.9. Network page</a>, <a href="#_ix2082">B.2.8. The <code>[network]</code> section</a></li>
<li><span class="ixname">DHCP</span>, <a href="#_ix281">4.4.1. Getting the address automatically (DHCP)</a>, <a href="#_ix753">7.9. Network page</a>, <a href="#_ix1657">11.9.5. Waiting for a DHCP server</a></li>
<li><span class="ixname">DNS</span>, <a href="#_ix1663">11.9.8. A computer&#8217;s name cannot be found</a></li>
<li><span class="ixname">does not start</span>, <a href="#_ix2085">B.2.8. The <code>[network]</code> section</a></li>
<li><span class="ixname">DOS programs</span>, <a href="#_ix1645">11.9.1. How DVX uses the network</a></li>
<li><span class="ixname">DVX.INI</span>, <a href="#_ix2074">B.2.8. The <code>[network]</code> section</a></li>
<li><span class="ixname">DVX.INI settings</span>, <a href="#_ix1676">11.9.11. Network settings in DVX.INI</a></li>
<li><span class="ixname">fixed address</span>, <a href="#_ix283">4.4.2. Setting the address yourself</a>, <a href="#_ix1659">11.9.5. Waiting for a DHCP server</a></li>
<li><span class="ixname">gateway</span>, <a href="#_ix758">7.9. Network page</a></li>
<li><span class="ixname">hardware</span>, <a href="#_ix105">2.6.3. Network card</a></li>
<li><span class="ixname">name not found</span>, <a href="#_ix1662">11.9.8. A computer&#8217;s name cannot be found</a></li>
<li><span class="ixname">name servers</span>, <a href="#_ix759">7.9. Network page</a>, <a href="#_ix2080">B.2.8. The <code>[network]</code> section</a></li>
<li><span class="ixname">Network Status window</span>, <a href="#_ix766">7.9.1. The Network Status window</a></li>
<li><span class="ixname">Networking part</span>, <a href="#_ix26">1.3. The optional parts</a>, <a href="#_ix270">4.2.1. Adding the Networking part</a></li>
<li><span class="ixname">no address</span>, <a href="#_ix1658">11.9.5. Waiting for a DHCP server</a></li>
<li><span class="ixname">no packet driver</span>, <a href="#_ix1655">11.9.4. No packet driver found</a></li>
<li><span class="ixname">not installed</span>, <a href="#_ix1654">11.9.3. Networking is not installed</a></li>
<li><span class="ixname">package server</span>, <a href="#_ix1315">10.6. The package server</a></li>
<li><span class="ixname">packet driver</span>, <a href="#_ix752">7.9. Network page</a>, <a href="#_ix1641">11.9.1. How DVX uses the network</a></li>
<li><span class="ixname">packet driver interrupt</span>, <a href="#_ix2084">B.2.8. The <code>[network]</code> section</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix1640">11.9. The network does not work</a></li>
<li><span class="ixname">requirements</span>, <a href="#_ix267">4.2. What you need</a></li>
<li><span class="ixname">restarting</span>, <a href="#_ix765">7.9. Network page</a></li>
<li><span class="ixname">server cannot be reached</span>, <a href="#_ix1666">11.9.9. A server cannot be reached</a></li>
<li><span class="ixname">settings</span>, <a href="#_ix279">4.4. Network settings</a>, <a href="#_ix750">7.9. Network page</a></li>
<li><span class="ixname">settings rejected</span>, <a href="#_ix1660">11.9.7. Control Panel will not accept the network settings</a></li>
<li><span class="ixname">Software</span>, <a href="#_ix1250">10.2.8. Software without the Networking part</a></li>
<li><span class="ixname">status</span>, <a href="#_ix764">7.9. Network page</a>, <a href="#_ix1646">11.9.2. The Network Status window</a></li>
<li><span class="ixname">subnet mask</span>, <a href="#_ix757">7.9. Network page</a></li>
<li><span class="ixname">Terminal</span>, <a href="#_ix1050">9.1. What you need</a></li>
<li><span class="ixname">trying it out</span>, <a href="#_ix303">4.5. Checking that it works</a></li>
<li><span class="ixname">what it is for</span>, <a href="#_ix262">4.1. What networking gives you</a></li>
<li><span class="ixname">what needs it</span>, <a href="#_ix1365">10.9.3. What needs Networking</a></li>
<li><span class="ixname">when it starts</span>, <a href="#_ix1644">11.9.1. How DVX uses the network</a></li>
</ul></li>
<li><span class="ixname">Not responding</span>, <a href="#_ix495">5.10.1. The list of programs</a></li>
<li><span class="ixname">Notepad</span>, <a href="#_ix13">1.2. The programs that come with DVX</a>, <a href="#_ix836">8.1. Which programs you have</a>, <a href="#_ix918">8.4. Notepad</a>
<ul>
<li><span class="ixname">editing DVX.INI</span>, <a href="#_ix2039">B.2.2. Changing DVX.INI by hand</a></li>
<li><span class="ixname">keys</span>, <a href="#_ix921">8.4.3. Typing and editing</a></li>
<li><span class="ixname">line ends</span>, <a href="#_ix932">8.4.5. File size and line ends</a></li>
<li><span class="ixname">menus</span>, <a href="#_ix941">8.4.7. Notepad menus</a></li>
<li><span class="ixname">messages</span>, <a href="#_ix943">8.4.8. Notepad messages</a>, <a href="#_ix1862">11.12.11. Notepad</a></li>
<li><span class="ixname">opening files</span>, <a href="#_ix926">8.4.4. Opening and saving files</a></li>
<li><span class="ixname">page setup</span>, <a href="#_ix940">8.4.6. Printing from Notepad</a></li>
<li><span class="ixname">printing</span>, <a href="#_ix937">8.4.6. Printing from Notepad</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix1861">11.12.11. Notepad</a></li>
<li><span class="ixname">Save changes</span>, <a href="#_ix928">8.4.4. Opening and saving files</a></li>
<li><span class="ixname">saving</span>, <a href="#_ix925">8.4.4. Opening and saving files</a></li>
<li><span class="ixname">saving safely</span>, <a href="#_ix933">8.4.5. File size and line ends</a></li>
<li><span class="ixname">size limit</span>, <a href="#_ix930">8.4.5. File size and line ends</a></li>
<li><span class="ixname">starting</span>, <a href="#_ix920">8.4.1. Starting Notepad</a></li>
<li><span class="ixname">undo</span>, <a href="#_ix923">8.4.3. Typing and editing</a></li>
</ul></li>
<li><span class="ixname">number boxes</span>, <a href="#_ix410">5.5.3.5. Number boxes</a></li>
</ul>
<h3 id="_ixgroup_O">O</h3>
<ul class="ixlist">
<li><span class="ixname">Open dialog box</span>, <a href="#_ix440">5.6. Opening and saving files</a></li>
<li><span class="ixname">option buttons</span>, <a href="#_ix402">5.5.3.3. Option buttons</a></li>
</ul>
<h3 id="_ixgroup_P">P</h3>
<ul class="ixlist">
<li><span class="ixname">Package Builder</span>, <a href="#_ix1040">8.13.5. Package Builder</a>
<ul>
<li><span class="ixname">keys</span>, <a href="#_ix1354">10.8.4. Trusting a publisher&#8217;s key</a></li>
<li><span class="ixname">messages</span>, <a href="#_ix1797">11.11.20. Package Builder</a></li>
</ul></li>
<li><span class="ixname">package server</span>, <a href="#_ix120">3.1.2. The floppy disks</a>, <a href="#_ix266">4.1. What networking gives you</a>, <a href="#_ix1314">10.6. The package server</a>
<ul>
<li><span class="ixname">account</span>, <a href="#_ix1320">10.6.1. The Package Server window</a></li>
<li><span class="ixname">address</span>, <a href="#_ix1318">10.6.1. The Package Server window</a></li>
<li><span class="ixname">cannot be reached</span>, <a href="#_ix1779">11.11.16. The package server cannot be reached</a></li>
<li><span class="ixname">catalogue</span>, <a href="#_ix1236">10.2.3. The Available page</a></li>
<li><span class="ixname">choosing</span>, <a href="#_ix1317">10.6.1. The Package Server window</a></li>
<li><span class="ixname">default</span>, <a href="#_ix1321">10.6.1. The Package Server window</a></li>
<li><span class="ixname">downloads</span>, <a href="#_ix1264">10.3.2. Installing from the package server</a></li>
<li><span class="ixname">DVX.INI</span>, <a href="#_ix2087">B.2.9. The <code>[packages]</code> section: the package server</a></li>
<li><span class="ixname">how it is used</span>, <a href="#_ix1325">10.6.2. How Software uses the package server</a></li>
<li><span class="ixname">installing from</span>, <a href="#_ix1263">10.3.2. Installing from the package server</a></li>
<li><span class="ixname">messages</span>, <a href="#_ix1327">10.6.3. Messages from the package server</a></li>
<li><span class="ixname">password</span>, <a href="#_ix1324">10.6.1. The Package Server window</a>, <a href="#_ix2092">B.2.9. The <code>[packages]</code> section: the package server</a></li>
<li><span class="ixname">publishing</span>, <a href="#_ix1334">10.7. Publishing your own packages</a></li>
<li><span class="ixname">registering</span>, <a href="#_ix1335">10.7. Publishing your own packages</a></li>
<li><span class="ixname">review</span>, <a href="#_ix1336">10.7. Publishing your own packages</a></li>
<li><span class="ixname">settings</span>, <a href="#_ix1785">11.11.17. The Package Server window</a></li>
<li><span class="ixname">signatures</span>, <a href="#_ix1348">10.8.3. Rules DVX always keeps</a>, <a href="#_ix1772">11.11.13. A package &#8220;cannot be installed&#8221;</a></li>
</ul></li>
<li><span class="ixname">Package Server window</span>, <a href="#_ix1786">11.11.17. The Package Server window</a></li>
<li><span class="ixname">packages</span>, <a href="#_ix1202">10. Managing Add-ons</a>
<ul>
<li><span class="ixname">bundles</span>, <a href="#_ix1217">10.1.1. Kinds of packages</a></li>
<li><span class="ixname">cannot be installed</span>, <a href="#_ix1767">11.11.13. A package &#8220;cannot be installed&#8221;</a></li>
<li><span class="ixname">cannot be read</span>, <a href="#_ix1759">11.11.11. A package cannot be read</a></li>
<li><span class="ixname">details</span>, <a href="#_ix1245">10.2.7. The Details window</a></li>
<li><span class="ixname">DPK files</span>, <a href="#_ix1204">10.1. Add-ons and packages</a></li>
<li><span class="ixname">DVX itself</span>, <a href="#_ix1206">10.1. Add-ons and packages</a></li>
<li><span class="ixname">install stopped</span>, <a href="#_ix1773">11.11.14. Installing or removing stops part way</a></li>
<li><span class="ixname">installing</span>, <a href="#_ix1254">10.3. Installing add-ons</a></li>
<li><span class="ixname">kinds</span>, <a href="#_ix1207">10.1.1. Kinds of packages</a></li>
<li><span class="ixname">kpunch</span>, <a href="#_ix1221">10.1.2. Names, package names, and versions</a></li>
<li><span class="ixname">making</span>, <a href="#_ix1041">8.13.5. Package Builder</a></li>
<li><span class="ixname">names</span>, <a href="#_ix1218">10.1.2. Names, package names, and versions</a></li>
<li><span class="ixname">needed packages</span>, <a href="#_ix1259">10.3.1. Installing from a file</a></li>
<li><span class="ixname">needs</span>, <a href="#_ix1222">10.1.2. Names, package names, and versions</a></li>
<li><span class="ixname">package names</span>, <a href="#_ix1220">10.1.2. Names, package names, and versions</a></li>
<li><span class="ixname">publishing</span>, <a href="#_ix1333">10.7. Publishing your own packages</a></li>
<li><span class="ixname">publishing problems</span>, <a href="#_ix1794">11.11.19. Publishing packages</a></li>
<li><span class="ixname">removing</span>, <a href="#_ix1299">10.4. Removing add-ons</a>, <a href="#_ix1776">11.11.15. Removing a package</a></li>
<li><span class="ixname">shared files</span>, <a href="#_ix1225">10.1.3. Where add-ons are installed</a></li>
<li><span class="ixname">signatures</span>, <a href="#_ix1790">11.11.18. Signatures and trusted keys</a></li>
<li><span class="ixname">signed</span>, <a href="#_ix1340">10.8. Signatures and trusted publishers</a></li>
<li><span class="ixname">unsigned</span>, <a href="#_ix1763">11.11.12. The Install Software window</a></li>
<li><span class="ixname">updating</span>, <a href="#_ix1307">10.5. Keeping DVX and your add-ons up to date</a></li>
<li><span class="ixname">versions</span>, <a href="#_ix1219">10.1.2. Names, package names, and versions</a></li>
</ul></li>
<li><span class="ixname">packet driver</span>, <a href="#_ix269">4.2. What you need</a>, <a href="#_ix1642">11.9.1. How DVX uses the network</a>
<ul>
<li><span class="ixname">choosing the interrupt</span>, <a href="#_ix287">4.4.4. Computer name and packet driver</a></li>
<li><span class="ixname">how DVX finds it</span>, <a href="#_ix275">4.3. Loading the packet driver</a></li>
<li><span class="ixname">loading</span>, <a href="#_ix273">4.3. Loading the packet driver</a></li>
<li><span class="ixname">none loaded</span>, <a href="#_ix276">4.3. Loading the packet driver</a></li>
<li><span class="ixname">not found</span>, <a href="#_ix1656">11.9.4. No packet driver found</a></li>
</ul></li>
<li><span class="ixname">Page Setup</span>, <a href="#_ix780">7.10.1. Page Setup</a></li>
<li><span class="ixname">parts of DVX</span>, <a href="#_ix22">1.3. The optional parts</a>, <a href="#_ix1357">10.9. The optional parts of DVX</a>
<ul>
<li><span class="ixname">adding</span>, <a href="#_ix1361">10.9.1. Adding a part after Setup</a></li>
<li><span class="ixname">adding later</span>, <a href="#_ix34">1.3. The optional parts</a>, <a href="#_ix152">3.5. Choosing the parts</a></li>
<li><span class="ixname">choosing in Setup</span>, <a href="#_ix148">3.5. Choosing the parts</a></li>
<li><span class="ixname">leaving out</span>, <a href="#_ix150">3.5. Choosing the parts</a></li>
<li><span class="ixname">left out</span>, <a href="#_ix36">1.3. The optional parts</a></li>
<li><span class="ixname">needs</span>, <a href="#_ix33">1.3. The optional parts</a>, <a href="#_ix151">3.5. Choosing the parts</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix1745">11.11.6. Parts and add-ons in Setup</a></li>
<li><span class="ixname">removing</span>, <a href="#_ix35">1.3. The optional parts</a>, <a href="#_ix153">3.5. Choosing the parts</a>, <a href="#_ix1364">10.9.2. Removing a part</a></li>
</ul></li>
<li><span class="ixname">passphrases</span>, <a href="#_ix1163">9.7.1. Passphrases</a>
<ul>
<li><span class="ixname">Secure Link page</span>, <a href="#_ix1087">9.4.4.3. The Secure Link page</a></li>
<li><span class="ixname">wrong</span>, <a href="#_ix1171">9.7.4. When the secure link does not connect</a></li>
</ul></li>
<li><span class="ixname">paths</span>, <a href="#_ix458">5.6.5. Typing a path</a>
<ul>
<li><span class="ixname">forward slash</span>, <a href="#_ix459">5.6.5. Typing a path</a></li>
<li><span class="ixname">slashes</span>, <a href="#_ix1823">11.12.4. Big disks and big files</a></li>
</ul></li>
<li><span class="ixname">PC speaker</span>, <a href="#_ix1555">11.7.6. Printer-port sound devices and the PC speaker</a></li>
<li><span class="ixname">Phone Book</span>, <a href="#_ix1071">9.4. The Phone Book</a></li>
<li><span class="ixname">pictures</span>
<ul>
<li><span class="ixname">viewing</span>, <a href="#_ix950">8.6. Image Viewer</a></li>
</ul></li>
<li><span class="ixname">play lists</span>, <a href="#_ix967">8.7.5. Making a play list</a></li>
<li><span class="ixname">PLAYER.INI</span>, <a href="#_ix2212">B.4.5. Media Player: PLAYER.INI</a></li>
<li><span class="ixname">PRINTER.PRN</span>, <a href="#_ix1625">11.8.6. Printing to a file</a></li>
<li><span class="ixname">printers</span>, <a href="#_ix110">2.6.5. Printers</a></li>
<li><span class="ixname">printing</span>
<ul>
<li><span class="ixname">cannot start</span>, <a href="#_ix1613">11.8.3. The printout stops before it starts</a></li>
<li><span class="ixname">driver missing</span>, <a href="#_ix1622">11.8.5. The printer driver is missing</a></li>
<li><span class="ixname">DVX.INI</span>, <a href="#_ix2094">B.2.10. The <code>[printer]</code> section</a></li>
<li><span class="ixname">DVX.INI settings</span>, <a href="#_ix1638">11.8.9. Printer settings in DVX.INI</a></li>
<li><span class="ixname">from BASIC programs</span>, <a href="#_ix1631">11.8.8. Printing from particular programs</a></li>
<li><span class="ixname">header codes</span>, <a href="#_ix2114">B.2.10. The <code>[printer]</code> section</a></li>
<li><span class="ixname">headers and footers</span>, <a href="#_ix779">7.10.1. Page Setup</a>, <a href="#_ix2110">B.2.10. The <code>[printer]</code> section</a></li>
<li><span class="ixname">margins</span>, <a href="#_ix778">7.10.1. Page Setup</a></li>
<li><span class="ixname">nothing prints</span>, <a href="#_ix1600">11.8. Nothing prints</a></li>
<li><span class="ixname">page setup</span>, <a href="#_ix776">7.10. Printer page</a></li>
<li><span class="ixname">Page Setup</span>, <a href="#_ix939">8.4.6. Printing from Notepad</a>, <a href="#_ix1628">11.8.7. Print dialog and Page Setup messages</a></li>
<li><span class="ixname">page setup rules</span>, <a href="#_ix2112">B.2.10. The <code>[printer]</code> section</a></li>
<li><span class="ixname">pictures</span>, <a href="#_ix953">8.6.3. Printing a picture</a>, <a href="#_ix1618">11.8.4. Pictures do not print</a></li>
<li><span class="ixname">port</span>, <a href="#_ix1603">11.8.1. Check the printer settings first</a></li>
<li><span class="ixname">PostScript</span>, <a href="#_ix1621">11.8.5. The printer driver is missing</a></li>
<li><span class="ixname">Print dialog</span>, <a href="#_ix1627">11.8.7. Print dialog and Page Setup messages</a></li>
<li><span class="ixname">printer model</span>, <a href="#_ix770">7.10. Printer page</a>, <a href="#_ix1604">11.8.1. Check the printer settings first</a>, <a href="#_ix2100">B.2.10. The <code>[printer]</code> section</a></li>
<li><span class="ixname">printer models</span>, <a href="#_ix2113">B.2.10. The <code>[printer]</code> section</a></li>
<li><span class="ixname">printer port</span>, <a href="#_ix772">7.10. Printer page</a>, <a href="#_ix2096">B.2.10. The <code>[printer]</code> section</a></li>
<li><span class="ixname">printer problems</span>, <a href="#_ix1607">11.8.2. The printer has a problem</a></li>
<li><span class="ixname">printer settings</span>, <a href="#_ix768">7.10. Printer page</a></li>
<li><span class="ixname">printers</span>, <a href="#_ix109">2.6.5. Printers</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix1599">11.8. Nothing prints</a></li>
<li><span class="ixname">progress window</span>, <a href="#_ix1606">11.8.1. Check the printer settings first</a></li>
<li><span class="ixname">sample report</span>, <a href="#_ix1020">8.11.2. BASIC Demo</a></li>
<li><span class="ixname">serial printer</span>, <a href="#_ix775">7.10. Printer page</a>, <a href="#_ix1605">11.8.1. Check the printer settings first</a>, <a href="#_ix2102">B.2.10. The <code>[printer]</code> section</a></li>
<li><span class="ixname">settings</span>, <a href="#_ix1601">11.8.1. Check the printer settings first</a></li>
<li><span class="ixname">test page</span>, <a href="#_ix782">7.10.2. Setting up a printer and printing a test page</a></li>
<li><span class="ixname">text</span>, <a href="#_ix936">8.4.6. Printing from Notepad</a></li>
<li><span class="ixname">text only</span>, <a href="#_ix1619">11.8.4. Pictures do not print</a></li>
<li><span class="ixname">to a file</span>, <a href="#_ix774">7.10. Printer page</a>, <a href="#_ix1624">11.8.6. Printing to a file</a>, <a href="#_ix2098">B.2.10. The <code>[printer]</code> section</a></li>
</ul></li>
<li><span class="ixname">problem reports</span>, <a href="#_ix1947">11.16.4. Sending it with a problem report</a>, <a href="#_ix2247">B.6.3. Sending the log with a problem report</a></li>
<li><span class="ixname">problems</span>
<ul>
<li><span class="ixname">solving</span>, <a href="#_ix1377">11. Troubleshooting</a></li>
</ul></li>
<li><span class="ixname">processor</span>, <a href="#_ix55">2.2.1. Processor</a></li>
<li><span class="ixname">PROGMAN.INI</span>, <a href="#_ix1921">11.13.8. Program Manager messages</a>, <a href="#_ix2202">B.4.1. Program Manager: PROGMAN.INI</a></li>
<li><span class="ixname">Program Manager</span>, <a href="#_ix11">1.2. The programs that come with DVX</a>, <a href="#_ix536">6. Program Manager</a>, <a href="#_ix863">8.2.7. Programs described elsewhere</a>
<ul>
<li><span class="ixname">adding an item</span>, <a href="#_ix570">6.4.2. Adding an item</a></li>
<li><span class="ixname">arranging icons</span>, <a href="#_ix607">6.5. Views and arranging icons</a></li>
<li><span class="ixname">at start-up</span>, <a href="#_ix309">5.1. The screen after start-up</a></li>
<li><span class="ixname">Auto Arrange</span>, <a href="#_ix611">6.5. Views and arranging icons</a></li>
<li><span class="ixname">cannot be loaded</span>, <a href="#_ix1426">11.2.5. DVX starts, then closes: the Program Manager cannot be loaded</a></li>
<li><span class="ixname">closing</span>, <a href="#_ix545">6.1. The Program Manager window</a></li>
<li><span class="ixname">context menus</span>, <a href="#_ix642">6.10.6. Right-click menus</a></li>
<li><span class="ixname">Control Panel</span>, <a href="#_ix648">7.1. Opening Control Panel</a></li>
<li><span class="ixname">copying an item</span>, <a href="#_ix601">6.4.8. Copying an item to a group</a></li>
<li><span class="ixname">deleting a group</span>, <a href="#_ix565">6.3.4. Deleting a group</a></li>
<li><span class="ixname">deleting an item</span>, <a href="#_ix604">6.4.9. Deleting an item</a></li>
<li><span class="ixname">DOS programs</span>, <a href="#_ix627">6.8. DOS program items</a></li>
<li><span class="ixname">dragging icons</span>, <a href="#_ix610">6.5. Views and arranging icons</a></li>
<li><span class="ixname">ending</span>, <a href="#_ix503">5.10.2. The buttons</a>, <a href="#_ix1904">11.13.3. A program stops responding</a></li>
<li><span class="ixname">first start</span>, <a href="#_ix257">3.14.4. The Program Manager the first time</a></li>
<li><span class="ixname">group list menu</span>, <a href="#_ix566">6.3.4. Deleting a group</a></li>
<li><span class="ixname">groups</span>, <a href="#_ix258">3.14.4. The Program Manager the first time</a>, <a href="#_ix552">6.3. Groups</a></li>
<li><span class="ixname">groups file</span>, <a href="#_ix2204">B.4.1. Program Manager: PROGMAN.INI</a></li>
<li><span class="ixname">Groups list</span>, <a href="#_ix539">6.1. The Program Manager window</a></li>
<li><span class="ixname">Help menu</span>, <a href="#_ix512">5.11. Getting help</a></li>
<li><span class="ixname">icon area</span>, <a href="#_ix541">6.1. The Program Manager window</a></li>
<li><span class="ixname">icons</span>, <a href="#_ix594">6.4.5. Icons</a></li>
<li><span class="ixname">Installed Programs group</span>, <a href="#_ix554">6.3.1. The groups on a new installation</a>, <a href="#_ix849">8.2.1. Starting a program</a></li>
<li><span class="ixname">Installed Programs properties</span>, <a href="#_ix585">6.4.3. Item properties</a></li>
<li><span class="ixname">item menu</span>, <a href="#_ix605">6.4.9. Deleting an item</a></li>
<li><span class="ixname">item properties</span>, <a href="#_ix572">6.4.3. Item properties</a></li>
<li><span class="ixname">items</span>, <a href="#_ix567">6.4. Items</a></li>
<li><span class="ixname">keyboard shortcuts</span>, <a href="#_ix643">6.11. Keyboard shortcuts in Program Manager</a></li>
<li><span class="ixname">making a group</span>, <a href="#_ix558">6.3.2. Making a group</a></li>
<li><span class="ixname">menus</span>, <a href="#_ix538">6.1. The Program Manager window</a>, <a href="#_ix633">6.10. Menus</a></li>
<li><span class="ixname">messages</span>, <a href="#_ix1919">11.13.8. Program Manager messages</a></li>
<li><span class="ixname">moving an item</span>, <a href="#_ix599">6.4.7. Moving an item to another group</a></li>
<li><span class="ixname">new programs</span>, <a href="#_ix1283">10.3.7. When the install is done</a></li>
<li><span class="ixname">opening packages</span>, <a href="#_ix1258">10.3.1. Installing from a file</a></li>
<li><span class="ixname">options</span>, <a href="#_ix630">6.9. Options</a></li>
<li><span class="ixname">program names and icons</span>, <a href="#_ix2206">B.4.2. PROGRAMS.CAC: the list of programs</a></li>
<li><span class="ixname">refreshing</span>, <a href="#_ix614">6.5. Views and arranging icons</a></li>
<li><span class="ixname">renaming a group</span>, <a href="#_ix563">6.3.3. Renaming a group</a></li>
<li><span class="ixname">renaming an item</span>, <a href="#_ix597">6.4.6. Renaming an item</a></li>
<li><span class="ixname">Run</span>, <a href="#_ix619">6.7. Running a command</a></li>
<li><span class="ixname">saving the layout</span>, <a href="#_ix616">6.5. Views and arranging icons</a></li>
<li><span class="ixname">Search box</span>, <a href="#_ix540">6.1. The Program Manager window</a></li>
<li><span class="ixname">searching</span>, <a href="#_ix617">6.6. Searching for a program</a></li>
<li><span class="ixname">selecting items</span>, <a href="#_ix569">6.4.1. Selecting items</a></li>
<li><span class="ixname">settings file</span>, <a href="#_ix2203">B.4.1. Program Manager: PROGMAN.INI</a></li>
<li><span class="ixname">shortcut keys</span>, <a href="#_ix586">6.4.4. Shortcut keys</a></li>
<li><span class="ixname">sorting</span>, <a href="#_ix613">6.5. Views and arranging icons</a></li>
<li><span class="ixname">starting programs</span>, <a href="#_ix547">6.2. Starting programs</a></li>
<li><span class="ixname">Startup group</span>, <a href="#_ix312">5.1. The screen after start-up</a>, <a href="#_ix556">6.3.1. The groups on a new installation</a></li>
<li><span class="ixname">Startup group problems</span>, <a href="#_ix1454">11.2.8. Safe start</a></li>
<li><span class="ixname">status bar</span>, <a href="#_ix542">6.1. The Program Manager window</a></li>
<li><span class="ixname">System Information</span>, <a href="#_ix1398">11.1.7. Find out about your computer</a></li>
<li><span class="ixname">views</span>, <a href="#_ix606">6.5. Views and arranging icons</a></li>
<li><span class="ixname">window</span>, <a href="#_ix537">6.1. The Program Manager window</a></li>
</ul></li>
<li><span class="ixname">programming</span>, <a href="#_ix1031">8.13. Developer tools</a></li>
<li><span class="ixname">programs</span>
<ul>
<li><span class="ixname">always installed</span>, <a href="#_ix10">1.2. The programs that come with DVX</a></li>
<li><span class="ixname">crash</span>, <a href="#_ix508">5.10.3. When a program stops responding</a></li>
<li><span class="ixname">crashes</span>, <a href="#_ix1907">11.13.4. A program crashes</a></li>
<li><span class="ixname">crashing while DVX starts</span>, <a href="#_ix241">3.12.2. What you see while DVX starts</a></li>
<li><span class="ixname">install parts</span>, <a href="#_ix834">8.1. Which programs you have</a></li>
<li><span class="ixname">more than one copy</span>, <a href="#_ix853">8.2.3. One copy or several</a></li>
<li><span class="ixname">not responding</span>, <a href="#_ix505">5.10.3. When a program stops responding</a>, <a href="#_ix1899">11.13.3. A program stops responding</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix1885">11.13. A program does not work</a></li>
<li><span class="ixname">standard</span>, <a href="#_ix832">8. The Standard Programs</a></li>
<li><span class="ixname">starting</span>, <a href="#_ix548">6.2. Starting programs</a>, <a href="#_ix848">8.2.1. Starting a program</a></li>
<li><span class="ixname">stuck</span>, <a href="#_ix1394">11.1.5. End a program that is stuck</a></li>
<li><span class="ixname">will not start</span>, <a href="#_ix1886">11.13.1. A program will not start</a></li>
</ul></li>
<li><span class="ixname">PROGRAMS.CAC</span>, <a href="#_ix1994">B.1.2. The USER folder</a>, <a href="#_ix2205">B.4.2. PROGRAMS.CAC: the list of programs</a></li>
</ul>
<h3 id="_ixgroup_R">R</h3>
<ul class="ixlist">
<li><span class="ixname">read-only disk</span>, <a href="#_ix218">3.11.1. Running DVX from a CD-ROM or a write-protected disk</a>, <a href="#_ix2013">B.1.4. Running DVX from a disk it cannot write to</a></li>
<li><span class="ixname">RECORDER.INI</span>, <a href="#_ix2214">B.4.6. Sound Recorder: RECORDER.INI and the recording files</a></li>
<li><span class="ixname">recording sound</span>, <a href="#_ix980">8.8. Sound Recorder</a>
<ul>
<li><span class="ixname">problems</span>, <a href="#_ix1587">11.7.16. Recording sound</a></li>
</ul></li>
<li><span class="ixname">Refresh</span>, <a href="#_ix615">6.5. Views and arranging icons</a></li>
<li><span class="ixname">removing DVX</span>, <a href="#_ix194">3.9. Removing DVX</a>
<ul>
<li><span class="ixname">problems</span>, <a href="#_ix1753">11.11.8. Removing DVX</a></li>
<li><span class="ixname">what is removed</span>, <a href="#_ix197">3.9. Removing DVX</a></li>
</ul></li>
<li><span class="ixname">repairing DVX</span>, <a href="#_ix180">3.8. Upgrading or repairing DVX</a>
<ul>
<li><span class="ixname">when DVX will not start</span>, <a href="#_ix240">3.12.2. What you see while DVX starts</a></li>
</ul></li>
<li><span class="ixname">requirements</span>, <a href="#_ix53">2. System Requirements</a>
<ul>
<li><span class="ixname">checking</span>, <a href="#_ix1395">11.1.6. Check what DVX needs</a></li>
<li><span class="ixname">disk space</span>, <a href="#_ix82">2.5. Disk space</a></li>
<li><span class="ixname">DOS</span>, <a href="#_ix61">2.2.3. DOS</a></li>
<li><span class="ixname">memory</span>, <a href="#_ix56">2.2.2. Memory</a></li>
<li><span class="ixname">mouse</span>, <a href="#_ix78">2.4. Mouse</a></li>
<li><span class="ixname">processor</span>, <a href="#_ix54">2.2.1. Processor</a></li>
<li><span class="ixname">video</span>, <a href="#_ix65">2.3.1. A VESA video card</a></li>
</ul></li>
<li><span class="ixname">Resource Editor</span>, <a href="#_ix1039">8.13.4. Resource Editor</a>
<ul>
<li><span class="ixname">problems</span>, <a href="#_ix1871">11.12.12. Other programs' file messages</a></li>
</ul></li>
<li><span class="ixname">Restore when Alone</span>, <a href="#_ix632">6.9. Options</a></li>
<li><span class="ixname">Run dialog box</span>, <a href="#_ix620">6.7. Running a command</a>
<ul>
<li><span class="ixname">history</span>, <a href="#_ix623">6.7. Running a command</a></li>
</ul></li>
<li><span class="ixname">Run minimized</span>, <a href="#_ix583">6.4.3. Item properties</a></li>
</ul>
<h3 id="_ixgroup_S">S</h3>
<ul class="ixlist">
<li><span class="ixname">safe start</span>, <a href="#_ix230">3.12.1. DVX&#8217;s command-line switches</a>, <a href="#_ix248">3.13.2. Safe start</a>, <a href="#_ix1448">11.2.8. Safe start</a>
<ul>
<li><span class="ixname">add-ons</span>, <a href="#_ix1373">10.10.3. Starting without add-ons</a></li>
<li><span class="ixname">starting</span>, <a href="#_ix1449">11.2.8. Safe start</a></li>
<li><span class="ixname">what it does</span>, <a href="#_ix1452">11.2.8. Safe start</a></li>
<li><span class="ixname">when to use</span>, <a href="#_ix1388">11.1.2. Try a safe start</a></li>
</ul></li>
<li><span class="ixname">safe video mode</span>, <a href="#_ix244">3.13.1. Safe video mode</a>, <a href="#_ix736">7.7.2. If the new mode does not work</a>, <a href="#_ix1453">11.2.8. Safe start</a>, <a href="#_ix1469">11.3.2. The Safe Video Mode question</a>
<ul>
<li><span class="ixname">after going back to defaults</span>, <a href="#_ix2233">B.5.1. Putting back the settings DVX came with</a></li>
<li><span class="ixname">blank screen</span>, <a href="#_ix1467">11.3.1. The screen is blank or cannot be read after DVX starts</a></li>
<li><span class="ixname">Control Panel</span>, <a href="#_ix1475">11.3.2. The Safe Video Mode question</a></li>
<li><span class="ixname">DVX.INI</span>, <a href="#_ix2057">B.2.5. The <code>[video]</code> section: screen mode</a></li>
<li><span class="ixname">keeping</span>, <a href="#_ix732">7.7.1. Changing the video mode</a></li>
<li><span class="ixname">question</span>, <a href="#_ix1470">11.3.2. The Safe Video Mode question</a></li>
</ul></li>
<li><span class="ixname">Save As dialog box</span>, <a href="#_ix441">5.6. Opening and saving files</a></li>
<li><span class="ixname">saving</span>
<ul>
<li><span class="ixname">unsaved work</span>, <a href="#_ix396">5.5.2. Message boxes</a></li>
</ul></li>
<li><span class="ixname">screen</span>
<ul>
<li><span class="ixname">problems</span>, <a href="#_ix1464">11.3. The screen is wrong</a></li>
</ul></li>
<li><span class="ixname">screen resolution</span>, <a href="#_ix721">7.7. Video page</a>
<ul>
<li><span class="ixname">changing</span>, <a href="#_ix1479">11.3.3. Choosing another screen mode</a></li>
</ul></li>
<li><span class="ixname">screen savers</span>, <a href="#_ix21">1.2. The programs that come with DVX</a>, <a href="#_ix513">5.12. The screen saver</a>, <a href="#_ix841">8.1. Which programs you have</a>, <a href="#_ix1021">8.12. Screen savers</a>
<ul>
<li><span class="ixname">add-ons</span>, <a href="#_ix1215">10.1.1. Kinds of packages</a></li>
<li><span class="ixname">adding</span>, <a href="#_ix1029">8.12. Screen savers</a></li>
<li><span class="ixname">Blank Screen</span>, <a href="#_ix1022">8.12. Screen savers</a></li>
<li><span class="ixname">choosing</span>, <a href="#_ix714">7.6.2. Screen saver</a>, <a href="#_ix1026">8.12. Screen savers</a></li>
<li><span class="ixname">does not start</span>, <a href="#_ix1918">11.13.7. Screen savers</a></li>
<li><span class="ixname">DVX.INI</span>, <a href="#_ix2167">B.2.15. The <code>[desktop]</code> section: wallpaper and screen saver</a></li>
<li><span class="ixname">folder</span>, <a href="#_ix1985">B.1.1. The DVX folder</a></li>
<li><span class="ixname">Marquee</span>, <a href="#_ix1023">8.12. Screen savers</a></li>
<li><span class="ixname">Mystify</span>, <a href="#_ix1024">8.12. Screen savers</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix1917">11.13.7. Screen savers</a></li>
<li><span class="ixname">Starfield</span>, <a href="#_ix1025">8.12. Screen savers</a></li>
<li><span class="ixname">starting and stopping</span>, <a href="#_ix1028">8.12. Screen savers</a></li>
<li><span class="ixname">testing</span>, <a href="#_ix719">7.6.2. Screen saver</a></li>
<li><span class="ixname">turning off</span>, <a href="#_ix716">7.6.2. Screen saver</a></li>
<li><span class="ixname">wait time</span>, <a href="#_ix717">7.6.2. Screen saver</a></li>
<li><span class="ixname">waking the screen</span>, <a href="#_ix515">5.12. The screen saver</a></li>
<li><span class="ixname">when they start</span>, <a href="#_ix514">5.12. The screen saver</a></li>
<li><span class="ixname">your own</span>, <a href="#_ix2004">B.1.2.1. Your own fonts, sounds, themes, pictures, banks, and screen savers</a></li>
</ul></li>
<li><span class="ixname">screenshots</span>, <a href="#_ix473">5.8. Saving a picture of the screen</a>
<ul>
<li><span class="ixname">file format</span>, <a href="#_ix477">5.8. Saving a picture of the screen</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix1491">11.3.5. Other screen problems</a></li>
<li><span class="ixname">window menu</span>, <a href="#_ix363">5.3.9. The window menu</a></li>
</ul></li>
<li><span class="ixname">scroll bars</span>, <a href="#_ix343">5.3.1. Parts of a window</a>, <a href="#_ix359">5.3.8. Scroll bars</a></li>
<li><span class="ixname">scroll wheel</span>, <a href="#_ix321">5.2.1. The mouse</a></li>
<li><span class="ixname">scrollback</span>, <a href="#_ix1189">9.8.6. Scrollback</a></li>
<li><span class="ixname">searching</span>
<ul>
<li><span class="ixname">for programs</span>, <a href="#_ix618">6.6. Searching for a program</a></li>
</ul></li>
<li><span class="ixname">SECLINK.RND</span>, <a href="#_ix1995">B.1.2. The USER folder</a></li>
<li><span class="ixname">secproxy</span>, <a href="#_ix1162">9.7. The secure link</a></li>
<li><span class="ixname">secure link</span>, <a href="#_ix1158">9.7. The secure link</a>
<ul>
<li><span class="ixname">connecting</span>, <a href="#_ix1169">9.7.3. What you see when you connect</a></li>
<li><span class="ixname">passphrases</span>, <a href="#_ix1164">9.7.1. Passphrases</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix1693">11.10.5. The secure link</a></li>
<li><span class="ixname">proxy</span>, <a href="#_ix1161">9.7. The secure link</a></li>
<li><span class="ixname">Secure Link Passphrase dialog box</span>, <a href="#_ix1165">9.7.1. Passphrases</a></li>
<li><span class="ixname">setting up</span>, <a href="#_ix1166">9.7.2. Setting up a secure link session</a></li>
</ul></li>
<li><span class="ixname">serial ports</span>, <a href="#_ix107">2.6.4. Serial ports and modems</a>, <a href="#_ix1053">9.1. What you need</a>
<ul>
<li><span class="ixname">cannot be opened</span>, <a href="#_ix1682">11.10.2. A COM port cannot be opened</a></li>
<li><span class="ixname">choosing</span>, <a href="#_ix1080">9.4.4.1. The Connection page</a></li>
<li><span class="ixname">connecting</span>, <a href="#_ix1092">9.5.1. Connecting by serial port</a></li>
<li><span class="ixname">flow control</span>, <a href="#_ix1082">9.4.4.1. The Connection page</a></li>
<li><span class="ixname">garbage characters</span>, <a href="#_ix1684">11.10.3. Garbage, nothing, or doubled letters on the screen</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix1680">11.10. Serial ports, modems, and Terminal</a></li>
<li><span class="ixname">speed</span>, <a href="#_ix1081">9.4.4.1. The Connection page</a></li>
</ul></li>
<li><span class="ixname">Session Settings</span>, <a href="#_ix1078">9.4.4. Session settings</a></li>
<li><span class="ixname">settings</span>
<ul>
<li><span class="ixname">back to defaults</span>, <a href="#_ix1391">11.1.4. Go back to the default settings</a>, <a href="#_ix1930">11.15. Going back to the default settings</a>, <a href="#_ix2228">B.5. Going back to the default settings</a></li>
<li><span class="ixname">changing</span>, <a href="#_ix646">7. Control Panel</a></li>
<li><span class="ixname">DVX.INI</span>, <a href="#_ix2029">B.2. DVX.INI, the settings file</a></li>
<li><span class="ixname">programs</span>, <a href="#_ix858">8.2.5. Settings the programs remember</a>, <a href="#_ix1997">B.1.2. The USER folder</a>, <a href="#_ix2200">B.4. Other settings files</a></li>
<li><span class="ixname">resetting</span>, <a href="#_ix1931">11.15. Going back to the default settings</a></li>
<li><span class="ixname">starting over</span>, <a href="#_ix2235">B.5.1. Putting back the settings DVX came with</a></li>
<li><span class="ixname">where kept</span>, <a href="#_ix1840">11.12.7. The USER folder and DVXUSER</a></li>
</ul></li>
<li><span class="ixname">settings files</span>, <a href="#_ix1963">B. DVX Folders and Settings Files</a>
<ul>
<li><span class="ixname">programs</span>, <a href="#_ix2198">B.4. Other settings files</a></li>
<li><span class="ixname">programs without</span>, <a href="#_ix2201">B.4. Other settings files</a></li>
</ul></li>
<li><span class="ixname">Setup</span>, <a href="#_ix113">3. Installing DVX</a>
<ul>
<li><span class="ixname">add-ons</span>, <a href="#_ix155">3.6. The add-ons on the CD</a>, <a href="#_ix1744">11.11.6. Parts and add-ons in Setup</a></li>
<li><span class="ixname">adding parts</span>, <a href="#_ix1362">10.9.1. Adding a part after Setup</a></li>
<li><span class="ixname">AUTOEXEC.BAT</span>, <a href="#_ix175">3.7.4. Starting DVX when the computer starts</a>, <a href="#_ix1749">11.11.7. After installing: settings and AUTOEXEC.BAT</a></li>
<li><span class="ixname">cancelling</span>, <a href="#_ix164">3.7.1. While Setup installs</a>, <a href="#_ix1742">11.11.5. Setup stops while unpacking</a></li>
<li><span class="ixname">command line</span>, <a href="#_ix204">3.10. Setup&#8217;s command-line switches</a></li>
<li><span class="ixname">disk space</span>, <a href="#_ix84">2.5. Disk space</a>, <a href="#_ix1731">11.11.3. Not enough disk space, or the folder cannot be made</a></li>
<li><span class="ixname">DVX already installed</span>, <a href="#_ix130">3.3.3. Choosing what to do</a></li>
<li><span class="ixname">DVX.INI</span>, <a href="#_ix2035">B.2.1. Where DVX.INI is and how it is made</a></li>
<li><span class="ixname">DVXUSER</span>, <a href="#_ix2009">B.1.3. Keeping the USER folder somewhere else: DVXUSER</a></li>
<li><span class="ixname">floppy disks</span>, <a href="#_ix1735">11.11.4. Floppy disk questions</a></li>
<li><span class="ixname">folder messages</span>, <a href="#_ix1728">11.11.2. Choosing the folder</a></li>
<li><span class="ixname">folder page</span>, <a href="#_ix131">3.3.4. Choosing the folder</a></li>
<li><span class="ixname">fonts</span>, <a href="#_ix143">3.4. Choosing the fonts</a></li>
<li><span class="ixname">in the DVX folder</span>, <a href="#_ix202">3.9. Removing DVX</a></li>
<li><span class="ixname">keyboard</span>, <a href="#_ix124">3.3.1. Starting Setup</a></li>
<li><span class="ixname">last page</span>, <a href="#_ix178">3.7.5. The last page</a></li>
<li><span class="ixname">licence page</span>, <a href="#_ix127">3.3.2. The licence</a></li>
<li><span class="ixname">log</span>, <a href="#_ix1754">11.11.9. Keeping a record of Setup</a></li>
<li><span class="ixname">log file</span>, <a href="#_ix2225">B.4.9. Files in the DVX folder</a></li>
<li><span class="ixname">/LOG switch</span>, <a href="#_ix1755">11.11.9. Keeping a record of Setup</a></li>
<li><span class="ixname">never writes to the disks</span>, <a href="#_ix119">3.1.2. The floppy disks</a></li>
<li><span class="ixname">only offers Remove</span>, <a href="#_ix1727">11.11.1. Setup will not start</a></li>
<li><span class="ixname">parts</span>, <a href="#_ix23">1.3. The optional parts</a>, <a href="#_ix149">3.5. Choosing the parts</a>, <a href="#_ix1743">11.11.6. Parts and add-ons in Setup</a></li>
<li><span class="ixname">parts of DVX</span>, <a href="#_ix1358">10.9. The optional parts of DVX</a></li>
<li><span class="ixname">problem report</span>, <a href="#_ix2249">B.6.3. Sending the log with a problem report</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix1720">11.11. Setup, add-ons, and Software</a></li>
<li><span class="ixname">progress page</span>, <a href="#_ix163">3.7.1. While Setup installs</a></li>
<li><span class="ixname">quitting</span>, <a href="#_ix126">3.3.1. Starting Setup</a></li>
<li><span class="ixname">Remove DVX</span>, <a href="#_ix196">3.9. Removing DVX</a></li>
<li><span class="ixname">removing DVX</span>, <a href="#_ix1752">11.11.8. Removing DVX</a></li>
<li><span class="ixname">repairing DVX</span>, <a href="#_ix1424">11.2.4. DVX says a file could not be loaded</a></li>
<li><span class="ixname">screen</span>, <a href="#_ix123">3.3.1. Starting Setup</a></li>
<li><span class="ixname">signatures</span>, <a href="#_ix1248">10.2.7. The Details window</a></li>
<li><span class="ixname">start page</span>, <a href="#_ix129">3.3.3. Choosing what to do</a></li>
<li><span class="ixname">starting</span>, <a href="#_ix122">3.3.1. Starting Setup</a></li>
<li><span class="ixname">starting choices</span>, <a href="#_ix206">3.10. Setup&#8217;s command-line switches</a></li>
<li><span class="ixname">switches</span>, <a href="#_ix205">3.10. Setup&#8217;s command-line switches</a></li>
<li><span class="ixname">unattended install</span>, <a href="#_ix209">3.10.1. Installing without questions</a></li>
<li><span class="ixname">unpacking problems</span>, <a href="#_ix1740">11.11.5. Setup stops while unpacking</a></li>
<li><span class="ixname">Upgrade or repair</span>, <a href="#_ix181">3.8. Upgrading or repairing DVX</a></li>
<li><span class="ixname">video</span>, <a href="#_ix77">2.3.2. When the card has no VESA BIOS</a></li>
<li><span class="ixname">What to install page</span>, <a href="#_ix139">3.3.5. Choosing what to install</a></li>
<li><span class="ixname">will not start</span>, <a href="#_ix1723">11.11.1. Setup will not start</a></li>
</ul></li>
<li><span class="ixname">SETUP.LST</span>, <a href="#_ix1968">B.1.1. The DVX folder</a>, <a href="#_ix2222">B.4.9. Files in the DVX folder</a></li>
<li><span class="ixname">SHARED folder</span>, <a href="#_ix1977">B.1.1. The DVX folder</a></li>
<li><span class="ixname">Shift key</span>
<ul>
<li><span class="ixname">at start</span>, <a href="#_ix249">3.13.2. Safe start</a></li>
<li><span class="ixname">safe start</span>, <a href="#_ix1450">11.2.8. Safe start</a></li>
</ul></li>
<li><span class="ixname">shortcut keys</span>
<ul>
<li><span class="ixname">items</span>, <a href="#_ix588">6.4.4. Shortcut keys</a></li>
<li><span class="ixname">kept by DVX</span>, <a href="#_ix590">6.4.4. Shortcut keys</a></li>
</ul></li>
<li><span class="ixname">SIG files</span>, <a href="#_ix1261">10.3.1. Installing from a file</a></li>
<li><span class="ixname">signatures</span>, <a href="#_ix1338">10.8. Signatures and trusted publishers</a>
<ul>
<li><span class="ixname">keys</span>, <a href="#_ix2218">B.4.7. KEYS: publisher keys</a></li>
<li><span class="ixname">not trusted</span>, <a href="#_ix1247">10.2.7. The Details window</a>, <a href="#_ix1764">11.11.12. The Install Software window</a></li>
<li><span class="ixname">package server</span>, <a href="#_ix1349">10.8.3. Rules DVX always keeps</a></li>
<li><span class="ixname">removing a trusted key</span>, <a href="#_ix1356">10.8.5. Removing a trusted key</a></li>
<li><span class="ixname">rules</span>, <a href="#_ix1346">10.8.3. Rules DVX always keeps</a></li>
<li><span class="ixname">SIG files</span>, <a href="#_ix1260">10.3.1. Installing from a file</a></li>
<li><span class="ixname">Signed by</span>, <a href="#_ix1246">10.2.7. The Details window</a></li>
<li><span class="ixname">Signed column</span>, <a href="#_ix1343">10.8.1. What the Signed column means</a></li>
<li><span class="ixname">trusted keys</span>, <a href="#_ix1789">11.11.18. Signatures and trusted keys</a></li>
<li><span class="ixname">trusting a publisher</span>, <a href="#_ix1352">10.8.4. Trusting a publisher&#8217;s key</a></li>
<li><span class="ixname">unsigned packages</span>, <a href="#_ix1344">10.8.2. Unsigned packages</a></li>
<li><span class="ixname">updates</span>, <a href="#_ix1347">10.8.3. Rules DVX always keeps</a></li>
<li><span class="ixname">warning</span>, <a href="#_ix1273">10.3.4. The Install Software window</a></li>
</ul></li>
<li><span class="ixname">sliders</span>, <a href="#_ix423">5.5.3.8. Sliders</a></li>
<li><span class="ixname">Small Icons</span>, <a href="#_ix609">6.5. Views and arranging icons</a></li>
<li><span class="ixname">Software</span>, <a href="#_ix18">1.2. The programs that come with DVX</a>, <a href="#_ix865">8.2.7. Programs described elsewhere</a>, <a href="#_ix1229">10.2. The Software program</a>
<ul>
<li><span class="ixname">Available page</span>, <a href="#_ix1235">10.2.3. The Available page</a></li>
<li><span class="ixname">choosing a package</span>, <a href="#_ix1241">10.2.6. Choosing a package and sorting the lists</a></li>
<li><span class="ixname">Details window</span>, <a href="#_ix1244">10.2.7. The Details window</a>, <a href="#_ix1793">11.11.18. Signatures and trusted keys</a></li>
<li><span class="ixname">Find box</span>, <a href="#_ix1237">10.2.3. The Available page</a></li>
<li><span class="ixname">Install from File</span>, <a href="#_ix1256">10.3.1. Installing from a file</a></li>
<li><span class="ixname">Install Software window</span>, <a href="#_ix1271">10.3.4. The Install Software window</a>, <a href="#_ix1762">11.11.12. The Install Software window</a></li>
<li><span class="ixname">Installed page</span>, <a href="#_ix1233">10.2.2. The Installed page</a></li>
<li><span class="ixname">menus</span>, <a href="#_ix1232">10.2.1. Software&#8217;s menus</a></li>
<li><span class="ixname">package server</span>, <a href="#_ix265">4.1. What networking gives you</a>, <a href="#_ix1780">11.11.16. The package server cannot be reached</a></li>
<li><span class="ixname">Package Server window</span>, <a href="#_ix1316">10.6.1. The Package Server window</a></li>
<li><span class="ixname">parts of DVX</span>, <a href="#_ix1360">10.9. The optional parts of DVX</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix1721">11.11. Setup, add-ons, and Software</a></li>
<li><span class="ixname">progress window</span>, <a href="#_ix1276">10.3.6. Progress and Cancel</a></li>
<li><span class="ixname">Published page</span>, <a href="#_ix1240">10.2.5. The Published page</a></li>
<li><span class="ixname">publishing</span>, <a href="#_ix1795">11.11.19. Publishing packages</a></li>
<li><span class="ixname">removing</span>, <a href="#_ix1777">11.11.15. Removing a package</a></li>
<li><span class="ixname">removing packages</span>, <a href="#_ix1300">10.4. Removing add-ons</a></li>
<li><span class="ixname">sorting</span>, <a href="#_ix1242">10.2.6. Choosing a package and sorting the lists</a></li>
<li><span class="ixname">starting</span>, <a href="#_ix1230">10.2. The Software program</a></li>
<li><span class="ixname">status lines</span>, <a href="#_ix1783">11.11.16. The package server cannot be reached</a></li>
<li><span class="ixname">Trust a Publisher&#8217;s Key</span>, <a href="#_ix1351">10.8.4. Trusting a publisher&#8217;s key</a></li>
<li><span class="ixname">trusting a publisher</span>, <a href="#_ix1791">11.11.18. Signatures and trusted keys</a></li>
<li><span class="ixname">Updates page</span>, <a href="#_ix193">3.8. Upgrading or repairing DVX</a>, <a href="#_ix1239">10.2.4. The Updates page</a></li>
<li><span class="ixname">updating</span>, <a href="#_ix1309">10.5. Keeping DVX and your add-ons up to date</a></li>
<li><span class="ixname">will not start</span>, <a href="#_ix1756">11.11.10. Software will not start, or its server pages are off</a></li>
<li><span class="ixname">without Networking</span>, <a href="#_ix1249">10.2.8. Software without the Networking part</a></li>
</ul></li>
<li><span class="ixname">sound</span>
<ul>
<li><span class="ixname">add-ons</span>, <a href="#_ix1214">10.1.1. Kinds of packages</a></li>
<li><span class="ixname">after a DOS program</span>, <a href="#_ix1558">11.7.7. Sounds stop, stutter, or are cut off</a></li>
<li><span class="ixname">ANSI music</span>, <a href="#_ix1184">9.8.5. ANSI music and the bell</a></li>
<li><span class="ixname">cards</span>, <a href="#_ix88">2.6.1. Sound cards</a></li>
<li><span class="ixname">choosing the device</span>, <a href="#_ix808">7.12.2. Sound hardware and music</a></li>
<li><span class="ixname">Covox</span>, <a href="#_ix1553">11.7.6. Printer-port sound devices and the PC speaker</a></li>
<li><span class="ixname">desktop sounds</span>, <a href="#_ix516">5.13. Desktop sounds</a>, <a href="#_ix1559">11.7.8. Desktop sounds</a></li>
<li><span class="ixname">drivers</span>, <a href="#_ix1537">11.7.1. How DVX finds the sound card</a></li>
<li><span class="ixname">DVX.INI</span>, <a href="#_ix2116">B.2.11. The <code>[audio]</code> section: sound hardware and music</a></li>
<li><span class="ixname">DVX.INI settings</span>, <a href="#_ix1596">11.7.18. Sound settings in DVX.INI</a></li>
<li><span class="ixname">event sounds</span>, <a href="#_ix45">1.4.3. Sounds and music</a>, <a href="#_ix801">7.12.1. Event sounds</a>, <a href="#_ix2160">B.2.13. The <code>[sounds]</code> section: event sounds</a></li>
<li><span class="ixname">events</span>, <a href="#_ix1560">11.7.8. Desktop sounds</a></li>
<li><span class="ixname">finding the sound card</span>, <a href="#_ix1536">11.7.1. How DVX finds the sound card</a></li>
<li><span class="ixname">FM music chip</span>, <a href="#_ix97">2.6.1. Sound cards</a></li>
<li><span class="ixname">Gravis UltraSound</span>, <a href="#_ix93">2.6.1. Sound cards</a>, <a href="#_ix812">7.12.2. Sound hardware and music</a>, <a href="#_ix1547">11.7.4. Gravis UltraSound and the ULTRASND setting</a>, <a href="#_ix2142">B.2.11. The <code>[audio]</code> section: sound hardware and music</a>, <a href="#_ix2156">B.2.12. Sound card settings in AUTOEXEC.BAT: BLASTER and ULTRASND</a></li>
<li><span class="ixname">hardware</span>, <a href="#_ix89">2.6.1. Sound cards</a></li>
<li><span class="ixname">log file</span>, <a href="#_ix1584">11.7.15. Sound lines in the log file</a></li>
<li><span class="ixname">messages</span>, <a href="#_ix1578">11.7.14. Sound and music messages</a></li>
<li><span class="ixname">MIDI music</span>, <a href="#_ix1564">11.7.9. MIDI music</a></li>
<li><span class="ixname">music modules</span>, <a href="#_ix819">7.12.2. Sound hardware and music</a>, <a href="#_ix1577">11.7.13. Music modules (MOD, S3M, XM, and IT files)</a></li>
<li><span class="ixname">no sound</span>, <a href="#_ix1535">11.7. There is no sound</a></li>
<li><span class="ixname">no sound at all</span>, <a href="#_ix1539">11.7.2. Nothing is heard</a></li>
<li><span class="ixname">PC speaker</span>, <a href="#_ix96">2.6.1. Sound cards</a>, <a href="#_ix814">7.12.2. Sound hardware and music</a>, <a href="#_ix1554">11.7.6. Printer-port sound devices and the PC speaker</a>, <a href="#_ix2129">B.2.11. The <code>[audio]</code> section: sound hardware and music</a></li>
<li><span class="ixname">playing</span>, <a href="#_ix959">8.7. Media Player</a></li>
<li><span class="ixname">port numbers</span>, <a href="#_ix2118">B.2.11. The <code>[audio]</code> section: sound hardware and music</a></li>
<li><span class="ixname">printer port device</span>, <a href="#_ix813">7.12.2. Sound hardware and music</a>, <a href="#_ix2148">B.2.11. The <code>[audio]</code> section: sound hardware and music</a></li>
<li><span class="ixname">printer port devices</span>, <a href="#_ix1552">11.7.6. Printer-port sound devices and the PC speaker</a></li>
<li><span class="ixname">printer-port devices</span>, <a href="#_ix95">2.6.1. Sound cards</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix1534">11.7. There is no sound</a></li>
<li><span class="ixname">recording</span>, <a href="#_ix98">2.6.1. Sound cards</a>, <a href="#_ix979">8.8. Sound Recorder</a>, <a href="#_ix1586">11.7.16. Recording sound</a></li>
<li><span class="ixname">recording and playing at once</span>, <a href="#_ix983">8.8.3. Recording sound</a></li>
<li><span class="ixname">settings</span>, <a href="#_ix799">7.12. Sounds page</a></li>
<li><span class="ixname">slow computer</span>, <a href="#_ix1557">11.7.7. Sounds stop, stutter, or are cut off</a></li>
<li><span class="ixname">Sound Blaster</span>, <a href="#_ix90">2.6.1. Sound cards</a>, <a href="#_ix811">7.12.2. Sound hardware and music</a>, <a href="#_ix1544">11.7.3. Sound Blaster cards and the BLASTER setting</a>, <a href="#_ix2154">B.2.12. Sound card settings in AUTOEXEC.BAT: BLASTER and ULTRASND</a></li>
<li><span class="ixname">Sound Blaster AWE</span>, <a href="#_ix2155">B.2.12. Sound card settings in AUTOEXEC.BAT: BLASTER and ULTRASND</a></li>
<li><span class="ixname">sound card</span>, <a href="#_ix972">8.7.7. Where the music plays</a></li>
<li><span class="ixname">sound device</span>, <a href="#_ix826">7.12.2. Sound hardware and music</a></li>
<li><span class="ixname">sound driver</span>, <a href="#_ix807">7.12.2. Sound hardware and music</a>, <a href="#_ix2121">B.2.11. The <code>[audio]</code> section: sound hardware and music</a></li>
<li><span class="ixname">sound file names</span>, <a href="#_ix2161">B.2.13. The <code>[sounds]</code> section: event sounds</a></li>
<li><span class="ixname">sound files folder</span>, <a href="#_ix1981">B.1.1. The DVX folder</a></li>
<li><span class="ixname">stuttering</span>, <a href="#_ix1556">11.7.7. Sounds stop, stutter, or are cut off</a></li>
<li><span class="ixname">testing</span>, <a href="#_ix804">7.12.1. Event sounds</a></li>
<li><span class="ixname">volume</span>, <a href="#_ix805">7.12.1. Event sounds</a>, <a href="#_ix2127">B.2.11. The <code>[audio]</code> section: sound hardware and music</a></li>
<li><span class="ixname">when settings take effect</span>, <a href="#_ix2117">B.2.11. The <code>[audio]</code> section: sound hardware and music</a></li>
<li><span class="ixname">Windows Sound System</span>, <a href="#_ix92">2.6.1. Sound cards</a>, <a href="#_ix810">7.12.2. Sound hardware and music</a>, <a href="#_ix1551">11.7.5. Windows Sound System cards</a>, <a href="#_ix2144">B.2.11. The <code>[audio]</code> section: sound hardware and music</a></li>
<li><span class="ixname">your own sounds</span>, <a href="#_ix2003">B.1.2.1. Your own fonts, sounds, themes, pictures, banks, and screen savers</a></li>
</ul></li>
<li><span class="ixname">Sound Recorder</span>, <a href="#_ix30">1.3. The optional parts</a>, <a href="#_ix843">8.1. Which programs you have</a>, <a href="#_ix978">8.8. Sound Recorder</a>
<ul>
<li><span class="ixname">disk space</span>, <a href="#_ix985">8.8.3. Recording sound</a></li>
<li><span class="ixname">menus</span>, <a href="#_ix991">8.8.6. Sound Recorder menus and keys</a></li>
<li><span class="ixname">messages</span>, <a href="#_ix994">8.8.7. Sound Recorder messages</a></li>
<li><span class="ixname">MIDI keyboard</span>, <a href="#_ix987">8.8.4. Recording a MIDI keyboard</a></li>
<li><span class="ixname">opening files</span>, <a href="#_ix990">8.8.5. Saving and opening recordings</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix1585">11.7.16. Recording sound</a></li>
<li><span class="ixname">quality</span>, <a href="#_ix984">8.8.3. Recording sound</a></li>
<li><span class="ixname">recording</span>, <a href="#_ix982">8.8.3. Recording sound</a></li>
<li><span class="ixname">recording files</span>, <a href="#_ix2216">B.4.6. Sound Recorder: RECORDER.INI and the recording files</a></li>
<li><span class="ixname">Save changes</span>, <a href="#_ix989">8.8.5. Saving and opening recordings</a></li>
<li><span class="ixname">saving</span>, <a href="#_ix988">8.8.5. Saving and opening recordings</a></li>
<li><span class="ixname">settings file</span>, <a href="#_ix2215">B.4.6. Sound Recorder: RECORDER.INI and the recording files</a></li>
<li><span class="ixname">starting</span>, <a href="#_ix981">8.8.1. Starting Sound Recorder</a></li>
</ul></li>
<li><span class="ixname">SOUND setting</span>, <a href="#_ix2158">B.2.12. Sound card settings in AUTOEXEC.BAT: BLASTER and ULTRASND</a></li>
<li><span class="ixname">SoundFont</span>, <a href="#_ix1569">11.7.10. MIDI music plays on the wrong instruments, or sounds like the FM chip</a></li>
<li><span class="ixname">spin boxes</span>, <a href="#_ix412">5.5.3.5. Number boxes</a></li>
<li><span class="ixname">starting DVX</span>, <a href="#_ix226">3.12. Starting DVX</a>
<ul>
<li><span class="ixname">normal start</span>, <a href="#_ix1404">11.2.1. What a normal start looks like</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix1403">11.2. DVX will not start</a></li>
<li><span class="ixname">switches</span>, <a href="#_ix228">3.12.1. DVX&#8217;s command-line switches</a></li>
<li><span class="ixname">title screen</span>, <a href="#_ix235">3.12.2. What you see while DVX starts</a></li>
<li><span class="ixname">what appears</span>, <a href="#_ix236">3.12.2. What you see while DVX starts</a></li>
<li><span class="ixname">with a program</span>, <a href="#_ix231">3.12.1. DVX&#8217;s command-line switches</a></li>
</ul></li>
<li><span class="ixname">Startup group</span>, <a href="#_ix557">6.3.1. The groups on a new installation</a></li>
<li><span class="ixname">status bar</span>
<ul>
<li><span class="ixname">Program Manager</span>, <a href="#_ix543">6.1. The Program Manager window</a></li>
</ul></li>
<li><span class="ixname">SYSTEM folder</span>, <a href="#_ix1969">B.1.1. The DVX folder</a>
<ul>
<li><span class="ixname">ASSOC.INI</span>, <a href="#_ix2190">B.3. ASSOC.INI: which program opens each kind of file</a></li>
<li><span class="ixname">DVX.INI</span>, <a href="#_ix2033">B.2.1. Where DVX.INI is and how it is made</a></li>
<li><span class="ixname">PACKAGES</span>, <a href="#_ix2223">B.4.9. Files in the DVX folder</a></li>
</ul></li>
<li><span class="ixname">System Information</span>, <a href="#_ix638">6.10.5. Help menu</a>, <a href="#_ix1397">11.1.7. Find out about your computer</a>
<ul>
<li><span class="ixname">log</span>, <a href="#_ix1941">11.16.1. Where it is</a>, <a href="#_ix2242">B.6.1. When DVX writes it</a></li>
<li><span class="ixname">window</span>, <a href="#_ix639">6.10.5. Help menu</a></li>
</ul></li>
<li><span class="ixname">system menu</span>, <a href="#_ix362">5.3.9. The window menu</a></li>
</ul>
<h3 id="_ixgroup_T">T</h3>
<ul class="ixlist">
<li><span class="ixname">tabs</span>, <a href="#_ix425">5.5.3.9. Tabs</a></li>
<li><span class="ixname">Task Manager</span>, <a href="#_ix20">1.2. The programs that come with DVX</a>, <a href="#_ix488">5.10. Task Manager</a>, <a href="#_ix866">8.2.7. Programs described elsewhere</a>
<ul>
<li><span class="ixname">columns</span>, <a href="#_ix491">5.10.1. The list of programs</a></li>
<li><span class="ixname">End Task</span>, <a href="#_ix499">5.10.2. The buttons</a>, <a href="#_ix1901">11.13.3. A program stops responding</a></li>
<li><span class="ixname">ending a stuck program</span>, <a href="#_ix1393">11.1.5. End a program that is stuck</a></li>
<li><span class="ixname">ending Program Manager</span>, <a href="#_ix502">5.10.2. The buttons</a></li>
<li><span class="ixname">memory</span>, <a href="#_ix60">2.2.2. Memory</a>, <a href="#_ix1897">11.13.2. Running low on memory</a></li>
<li><span class="ixname">Not responding</span>, <a href="#_ix494">5.10.1. The list of programs</a>, <a href="#_ix1900">11.13.3. A program stops responding</a></li>
<li><span class="ixname">opening</span>, <a href="#_ix489">5.10. Task Manager</a></li>
<li><span class="ixname">Run</span>, <a href="#_ix501">5.10.2. The buttons</a></li>
<li><span class="ixname">status line</span>, <a href="#_ix496">5.10.1. The list of programs</a></li>
<li><span class="ixname">Switch To</span>, <a href="#_ix498">5.10.2. The buttons</a></li>
<li><span class="ixname">Type column</span>, <a href="#_ix492">5.10.1. The list of programs</a></li>
</ul></li>
<li><span class="ixname">Telnet</span>, <a href="#_ix264">4.1. What networking gives you</a>, <a href="#_ix1111">9.5.3. Connecting by Telnet</a>
<ul>
<li><span class="ixname">address</span>, <a href="#_ix1122">9.5.4. Starting Terminal with a Telnet address</a></li>
<li><span class="ixname">host name</span>, <a href="#_ix1088">9.4.4.4. The Network page</a></li>
<li><span class="ixname">Networking part</span>, <a href="#_ix1052">9.1. What you need</a></li>
<li><span class="ixname">port</span>, <a href="#_ix1089">9.4.4.4. The Network page</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix1667">11.9.9. A server cannot be reached</a></li>
</ul></li>
<li><span class="ixname">TEMP folder</span>, <a href="#_ix221">3.11.1. Running DVX from a CD-ROM or a write-protected disk</a>, <a href="#_ix1841">11.12.8. The TEMP folder</a>, <a href="#_ix2016">B.1.4. Running DVX from a disk it cannot write to</a>
<ul>
<li><span class="ixname">settings</span>, <a href="#_ix1832">11.12.6. DVX runs from a disk it cannot write to</a></li>
</ul></li>
<li><span class="ixname">temporary files</span>, <a href="#_ix2226">B.4.10. Temporary files</a></li>
<li><span class="ixname">Terminal</span>, <a href="#_ix27">1.3. The optional parts</a>, <a href="#_ix844">8.1. Which programs you have</a>, <a href="#_ix1044">9. Terminal</a>
<ul>
<li><span class="ixname">adding a session</span>, <a href="#_ix1073">9.4.1. Adding a session</a></li>
<li><span class="ixname">ANSI music</span>, <a href="#_ix1185">9.8.5. ANSI music and the bell</a></li>
<li><span class="ixname">answerback</span>, <a href="#_ix1180">9.8.4. Answerback</a></li>
<li><span class="ixname">bell</span>, <a href="#_ix1186">9.8.5. ANSI music and the bell</a></li>
<li><span class="ixname">capturing to a file</span>, <a href="#_ix1190">9.8.7. Capturing to a file</a></li>
<li><span class="ixname">changing a session</span>, <a href="#_ix1075">9.4.2. Changing a session</a></li>
<li><span class="ixname">closing</span>, <a href="#_ix1125">9.5.5. Disconnecting and closing Terminal</a></li>
<li><span class="ixname">colors</span>, <a href="#_ix1177">9.8.2. Colors</a></li>
<li><span class="ixname">connecting</span>, <a href="#_ix1091">9.5. Connecting and disconnecting</a></li>
<li><span class="ixname">copying text</span>, <a href="#_ix1066">9.3.2. Using the terminal screen</a></li>
<li><span class="ixname">damaged settings file</span>, <a href="#_ix1198">9.8.8. Where Terminal keeps its settings</a></li>
<li><span class="ixname">deleting a session</span>, <a href="#_ix1076">9.4.3. Deleting a session</a></li>
<li><span class="ixname">disconnecting</span>, <a href="#_ix1124">9.5.5. Disconnecting and closing Terminal</a></li>
<li><span class="ixname">download folder</span>, <a href="#_ix1138">9.6.2. Receiving files</a></li>
<li><span class="ixname">emulation</span>, <a href="#_ix1175">9.8.1. Terminal emulation</a></li>
<li><span class="ixname">File Transfer window</span>, <a href="#_ix1143">9.6.4. The File Transfer window</a></li>
<li><span class="ixname">file transfers</span>, <a href="#_ix1127">9.6. Sending and receiving files</a>, <a href="#_ix1706">11.10.7. File transfers</a></li>
<li><span class="ixname">flow control</span>, <a href="#_ix1686">11.10.3. Garbage, nothing, or doubled letters on the screen</a></li>
<li><span class="ixname">installing</span>, <a href="#_ix1048">9.1. What you need</a></li>
<li><span class="ixname">local echo</span>, <a href="#_ix1178">9.8.3. Local echo</a>, <a href="#_ix1685">11.10.3. Garbage, nothing, or doubled letters on the screen</a></li>
<li><span class="ixname">menus</span>, <a href="#_ix1062">9.3.1. Menus</a></li>
<li><span class="ixname">messages</span>, <a href="#_ix1697">11.10.6. Terminal&#8217;s messages</a></li>
<li><span class="ixname">modem</span>, <a href="#_ix1102">9.5.2. Dialing with a modem</a></li>
<li><span class="ixname">modems</span>, <a href="#_ix1688">11.10.4. Modems</a></li>
<li><span class="ixname">network connections</span>, <a href="#_ix1668">11.9.9. A server cannot be reached</a></li>
<li><span class="ixname">Networking part</span>, <a href="#_ix1051">9.1. What you need</a></li>
<li><span class="ixname">notes on the screen</span>, <a href="#_ix1060">9.3. The Terminal window</a></li>
<li><span class="ixname">pasting text</span>, <a href="#_ix1068">9.3.2. Using the terminal screen</a></li>
<li><span class="ixname">Phone Book</span>, <a href="#_ix1070">9.4. The Phone Book</a></li>
<li><span class="ixname">phone book file</span>, <a href="#_ix2209">B.4.3. Terminal: TERMINAL.INI</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix1679">11.10. Serial ports, modems, and Terminal</a></li>
<li><span class="ixname">screen</span>, <a href="#_ix1058">9.3. The Terminal window</a></li>
<li><span class="ixname">screen size</span>, <a href="#_ix1090">9.4.4.5. The Screen page</a></li>
<li><span class="ixname">scrollback</span>, <a href="#_ix1188">9.8.6. Scrollback</a></li>
<li><span class="ixname">scrolling back</span>, <a href="#_ix1069">9.3.2. Using the terminal screen</a></li>
<li><span class="ixname">secure link</span>, <a href="#_ix1159">9.7. The secure link</a>, <a href="#_ix1694">11.10.5. The secure link</a></li>
<li><span class="ixname">Send Break</span>, <a href="#_ix1063">9.3.1. Menus</a></li>
<li><span class="ixname">serial port</span>, <a href="#_ix1093">9.5.1. Connecting by serial port</a></li>
<li><span class="ixname">session name</span>, <a href="#_ix1079">9.4.4.1. The Connection page</a></li>
<li><span class="ixname">Session Settings</span>, <a href="#_ix1077">9.4.4. Session settings</a></li>
<li><span class="ixname">sessions</span>, <a href="#_ix1047">9. Terminal</a>, <a href="#_ix1072">9.4. The Phone Book</a></li>
<li><span class="ixname">settings</span>, <a href="#_ix1174">9.8. Terminal settings</a></li>
<li><span class="ixname">settings file</span>, <a href="#_ix1193">9.8.8. Where Terminal keeps its settings</a>, <a href="#_ix1716">11.10.8. Terminal&#8217;s settings file</a>, <a href="#_ix2208">B.4.3. Terminal: TERMINAL.INI</a></li>
<li><span class="ixname">several at once</span>, <a href="#_ix1056">9.2. Starting Terminal</a>, <a href="#_ix1195">9.8.8. Where Terminal keeps its settings</a></li>
<li><span class="ixname">starting</span>, <a href="#_ix1055">9.2. Starting Terminal</a></li>
<li><span class="ixname">starting with an address</span>, <a href="#_ix1123">9.5.4. Starting Terminal with a Telnet address</a></li>
<li><span class="ixname">status bar</span>, <a href="#_ix1059">9.3. The Terminal window</a></li>
<li><span class="ixname">status messages</span>, <a href="#_ix1681">11.10.1. Where Terminal shows what happens</a></li>
<li><span class="ixname">Telnet</span>, <a href="#_ix263">4.1. What networking gives you</a>, <a href="#_ix1112">9.5.3. Connecting by Telnet</a></li>
<li><span class="ixname">Transfer Options</span>, <a href="#_ix1148">9.6.7. Transfer options</a></li>
<li><span class="ixname">troubleshooting</span>, <a href="#_ix1199">9.9. When something goes wrong in Terminal</a></li>
<li><span class="ixname">typing</span>, <a href="#_ix1064">9.3.2. Using the terminal screen</a></li>
<li><span class="ixname">window</span>, <a href="#_ix1057">9.3. The Terminal window</a></li>
</ul></li>
<li><span class="ixname">TERMINAL.INI</span>, <a href="#_ix1194">9.8.8. Where Terminal keeps its settings</a>, <a href="#_ix1717">11.10.8. Terminal&#8217;s settings file</a>, <a href="#_ix2207">B.4.3. Terminal: TERMINAL.INI</a></li>
<li><span class="ixname">text</span>
<ul>
<li><span class="ixname">smooth edges</span>, <a href="#_ix1483">11.3.3. Choosing another screen mode</a></li>
</ul></li>
<li><span class="ixname">text boxes</span>, <a href="#_ix405">5.5.3.4. Text boxes</a>
<ul>
<li><span class="ixname">passwords</span>, <a href="#_ix409">5.5.3.4. Text boxes</a></li>
</ul></li>
<li><span class="ixname">text files</span>
<ul>
<li><span class="ixname">editing</span>, <a href="#_ix919">8.4. Notepad</a></li>
</ul></li>
<li><span class="ixname">text smoothing</span>, <a href="#_ix70">2.3.1. A VESA video card</a>, <a href="#_ix727">7.7. Video page</a>
<ul>
<li><span class="ixname">DVX.INI</span>, <a href="#_ix2173">B.2.16. The <code>[fonts]</code> section: text smoothing</a></li>
</ul></li>
<li><span class="ixname">themes</span>, <a href="#_ix43">1.4.2. Color themes and desktop pictures</a>, <a href="#_ix687">7.5. Colors page</a>
<ul>
<li><span class="ixname">add-ons</span>, <a href="#_ix1212">10.1.1. Kinds of packages</a></li>
<li><span class="ixname">choosing</span>, <a href="#_ix693">7.5. Colors page</a></li>
<li><span class="ixname">file format</span>, <a href="#_ix2164">B.2.14. The <code>[colors]</code> section: screen colors</a></li>
<li><span class="ixname">folder</span>, <a href="#_ix1982">B.1.1. The DVX folder</a></li>
<li><span class="ixname">list of</span>, <a href="#_ix691">7.5. Colors page</a></li>
<li><span class="ixname">loading from a file</span>, <a href="#_ix694">7.5. Colors page</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix1494">11.3.6. Colors, themes, and the desktop picture</a></li>
<li><span class="ixname">saving</span>, <a href="#_ix695">7.5. Colors page</a>, <a href="#_ix700">7.5.3. Changing a color and saving your own theme</a></li>
<li><span class="ixname">standard colors</span>, <a href="#_ix696">7.5. Colors page</a></li>
<li><span class="ixname">your own</span>, <a href="#_ix2005">B.1.2.1. Your own fonts, sounds, themes, pictures, banks, and screen savers</a></li>
</ul></li>
<li><span class="ixname">Tile</span>, <a href="#_ix370">5.3.10. Arranging windows</a></li>
<li><span class="ixname">Tile Horizontally</span>, <a href="#_ix371">5.3.10. Arranging windows</a></li>
<li><span class="ixname">Tile Vertically</span>, <a href="#_ix372">5.3.10. Arranging windows</a></li>
<li><span class="ixname">title bar</span>, <a href="#_ix336">5.3.1. Parts of a window</a></li>
<li><span class="ixname">TMP</span>, <a href="#_ix1842">11.12.8. The TEMP folder</a></li>
<li><span class="ixname">tooltips</span>, <a href="#_ix322">5.2.1. The mouse</a></li>
<li><span class="ixname">tour of DVX</span>, <a href="#_ix1013">8.10.3. Taking the tour</a></li>
<li><span class="ixname">trees</span>, <a href="#_ix427">5.5.3.10. Trees</a></li>
<li><span class="ixname">troubleshooting</span>, <a href="#_ix1376">11. Troubleshooting</a>
<ul>
<li><span class="ixname">add-ons</span>, <a href="#_ix1368">10.10. When an add-on causes trouble</a>, <a href="#_ix1719">11.11. Setup, add-ons, and Software</a></li>
<li><span class="ixname">add-ons at start</span>, <a href="#_ix1457">11.2.9. DVX says add-ons were not loaded</a></li>
<li><span class="ixname">blank screen</span>, <a href="#_ix1465">11.3.1. The screen is blank or cannot be read after DVX starts</a></li>
<li><span class="ixname">computer too old</span>, <a href="#_ix1396">11.1.6. Check what DVX needs</a></li>
<li><span class="ixname">crash while starting</span>, <a href="#_ix1444">11.2.7. DVX stops while starting</a></li>
<li><span class="ixname">damaged DVX files</span>, <a href="#_ix1422">11.2.4. DVX says a file could not be loaded</a></li>
<li><span class="ixname">DVX will not start</span>, <a href="#_ix1402">11.2. DVX will not start</a></li>
<li><span class="ixname">files</span>, <a href="#_ix1798">11.12. Files, disks, and folders</a></li>
<li><span class="ixname">first steps</span>, <a href="#_ix1389">11.1.2. Try a safe start</a></li>
<li><span class="ixname">frozen screen</span>, <a href="#_ix1506">11.4.1. The pointer does not move</a>, <a href="#_ix1906">11.13.3. A program stops responding</a></li>
<li><span class="ixname">game controllers</span>, <a href="#_ix1525">11.6. Game controllers do not work</a></li>
<li><span class="ixname">installing add-ons</span>, <a href="#_ix1286">10.3.8. When a package cannot be installed</a></li>
<li><span class="ixname">keyboard problems</span>, <a href="#_ix1514">11.5. The keyboard does not work as expected</a></li>
<li><span class="ixname">log file</span>, <a href="#_ix2238">B.6. The log file, DVX.LOG</a></li>
<li><span class="ixname">messages A to Z</span>, <a href="#_ix1950">11.17. Messages, A to Z</a></li>
<li><span class="ixname">mouse problems</span>, <a href="#_ix1500">11.4. The mouse does not work</a></li>
<li><span class="ixname">network</span>, <a href="#_ix305">4.6. If the network does not work</a></li>
<li><span class="ixname">networking</span>, <a href="#_ix1639">11.9. The network does not work</a></li>
<li><span class="ixname">no sound</span>, <a href="#_ix1533">11.7. There is no sound</a></li>
<li><span class="ixname">no VESA video</span>, <a href="#_ix1408">11.2.2. DVX says the video card has no usable mode</a></li>
<li><span class="ixname">not enough memory to start</span>, <a href="#_ix1430">11.2.6. Memory messages before the title screen</a></li>
<li><span class="ixname">out of memory</span>, <a href="#_ix1898">11.13.2. Running low on memory</a></li>
<li><span class="ixname">package server</span>, <a href="#_ix1328">10.6.3. Messages from the package server</a></li>
<li><span class="ixname">printing</span>, <a href="#_ix1598">11.8. Nothing prints</a></li>
<li><span class="ixname">program not responding</span>, <a href="#_ix506">5.10.3. When a program stops responding</a></li>
<li><span class="ixname">program stops responding</span>, <a href="#_ix1902">11.13.3. A program stops responding</a></li>
<li><span class="ixname">programs</span>, <a href="#_ix1884">11.13. A program does not work</a></li>
<li><span class="ixname">reporting a problem</span>, <a href="#_ix2248">B.6.3. Sending the log with a problem report</a></li>
<li><span class="ixname">resetting settings</span>, <a href="#_ix1932">11.15. Going back to the default settings</a></li>
<li><span class="ixname">screen problems</span>, <a href="#_ix1462">11.3. The screen is wrong</a></li>
<li><span class="ixname">serial ports</span>, <a href="#_ix1677">11.10. Serial ports, modems, and Terminal</a></li>
<li><span class="ixname">settings</span>, <a href="#_ix2231">B.5. Going back to the default settings</a></li>
<li><span class="ixname">Setup</span>, <a href="#_ix1718">11.11. Setup, add-ons, and Software</a></li>
<li><span class="ixname">slow screen</span>, <a href="#_ix1421">11.2.3. The screen works, but it is slow (older video cards)</a></li>
<li><span class="ixname">Terminal</span>, <a href="#_ix1200">9.9. When something goes wrong in Terminal</a>, <a href="#_ix1678">11.10. Serial ports, modems, and Terminal</a></li>
<li><span class="ixname">video mode</span>, <a href="#_ix734">7.7.2. If the new mode does not work</a></li>
<li><span class="ixname">window lost</span>, <a href="#_ix1488">11.3.5. Other screen problems</a></li>
</ul></li>
<li><span class="ixname">type-ahead</span>, <a href="#_ix416">5.5.3.6. Lists</a></li>
</ul>
<h3 id="_ixgroup_U">U</h3>
<ul class="ixlist">
<li><span class="ixname">ULTRADIR setting</span>, <a href="#_ix1549">11.7.4. Gravis UltraSound and the ULTRASND setting</a>, <a href="#_ix2157">B.2.12. Sound card settings in AUTOEXEC.BAT: BLASTER and ULTRASND</a></li>
<li><span class="ixname">ULTRASND setting</span>, <a href="#_ix94">2.6.1. Sound cards</a>, <a href="#_ix1548">11.7.4. Gravis UltraSound and the ULTRASND setting</a>, <a href="#_ix2152">B.2.12. Sound card settings in AUTOEXEC.BAT: BLASTER and ULTRASND</a></li>
<li><span class="ixname">underlined letters</span>, <a href="#_ix332">5.2.2. The keyboard</a></li>
<li><span class="ixname">undo</span>, <a href="#_ix408">5.5.3.4. Text boxes</a>, <a href="#_ix1958">A.3. Typing and editing text</a></li>
<li><span class="ixname">uninstalling DVX</span>, <a href="#_ix195">3.9. Removing DVX</a></li>
<li><span class="ixname">UniVBE</span>, <a href="#_ix73">2.3.2. When the card has no VESA BIOS</a>, <a href="#_ix1411">11.2.2. DVX says the video card has no usable mode</a></li>
<li><span class="ixname">upgrading</span>, <a href="#_ix179">3.8. Upgrading or repairing DVX</a>
<ul>
<li><span class="ixname">add-ons</span>, <a href="#_ix1281">10.3.7. When the install is done</a>, <a href="#_ix1308">10.5. Keeping DVX and your add-ons up to date</a></li>
<li><span class="ixname">add-ons made for another version</span>, <a href="#_ix1372">10.10.2. Add-ons made for another version of DVX</a></li>
<li><span class="ixname">DVX</span>, <a href="#_ix1311">10.5.1. Updating DVX itself</a></li>
<li><span class="ixname">from the package server</span>, <a href="#_ix192">3.8. Upgrading or repairing DVX</a></li>
<li><span class="ixname">settings kept</span>, <a href="#_ix183">3.8. Upgrading or repairing DVX</a>, <a href="#_ix2027">B.1.5. Backing up your settings and files</a></li>
<li><span class="ixname">starting over</span>, <a href="#_ix185">3.8. Upgrading or repairing DVX</a></li>
<li><span class="ixname">what happens</span>, <a href="#_ix182">3.8. Upgrading or repairing DVX</a></li>
</ul></li>
<li><span class="ixname">uploading files</span>, <a href="#_ix1128">9.6. Sending and receiving files</a></li>
<li><span class="ixname">USER folder</span>, <a href="#_ix213">3.11. Where DVX puts its files</a>, <a href="#_ix1838">11.12.7. The USER folder and DVXUSER</a>, <a href="#_ix1965">B.1. The DVX folders</a>, <a href="#_ix1979">B.1.1. The DVX folder</a>, <a href="#_ix1988">B.1.2. The USER folder</a>
<ul>
<li><span class="ixname">ASSOC.INI</span>, <a href="#_ix2191">B.3. ASSOC.INI: which program opens each kind of file</a></li>
<li><span class="ixname">backing up</span>, <a href="#_ix214">3.11. Where DVX puts its files</a>, <a href="#_ix2024">B.1.5. Backing up your settings and files</a></li>
<li><span class="ixname">moving</span>, <a href="#_ix2008">B.1.3. Keeping the USER folder somewhere else: DVXUSER</a></li>
<li><span class="ixname">moving to another computer</span>, <a href="#_ix2026">B.1.5. Backing up your settings and files</a></li>
<li><span class="ixname">on a read-only disk</span>, <a href="#_ix1831">11.12.6. DVX runs from a disk it cannot write to</a></li>
<li><span class="ixname">one for each person</span>, <a href="#_ix2012">B.1.3. Keeping the USER folder somewhere else: DVXUSER</a></li>
<li><span class="ixname">restoring</span>, <a href="#_ix2025">B.1.5. Backing up your settings and files</a></li>
<li><span class="ixname">upgrading</span>, <a href="#_ix184">3.8. Upgrading or repairing DVX</a></li>
<li><span class="ixname">your own files</span>, <a href="#_ix2000">B.1.2.1. Your own fonts, sounds, themes, pictures, banks, and screen savers</a></li>
</ul></li>
</ul>
<h3 id="_ixgroup_V">V</h3>
<ul class="ixlist">
<li><span class="ixname">VESA BIOS</span>, <a href="#_ix67">2.3.1. A VESA video card</a></li>
<li><span class="ixname">VESA driver</span>, <a href="#_ix72">2.3.2. When the card has no VESA BIOS</a>, <a href="#_ix1410">11.2.2. DVX says the video card has no usable mode</a></li>
<li><span class="ixname">video cards</span>
<ul>
<li><span class="ixname">older</span>, <a href="#_ix71">2.3.1. A VESA video card</a>, <a href="#_ix1420">11.2.3. The screen works, but it is slow (older video cards)</a></li>
</ul></li>
<li><span class="ixname">video modes</span>, <a href="#_ix720">7.7. Video page</a>
<ul>
<li><span class="ixname">24-bit</span>, <a href="#_ix1418">11.2.2. DVX says the video card has no usable mode</a></li>
<li><span class="ixname">after going back to defaults</span>, <a href="#_ix1489">11.3.5. Other screen problems</a>, <a href="#_ix2234">B.5.1. Putting back the settings DVX came with</a></li>
<li><span class="ixname">after installing</span>, <a href="#_ix172">3.7.3. DVX&#8217;s settings file</a></li>
<li><span class="ixname">after the first start</span>, <a href="#_ix259">3.14.4. The Program Manager the first time</a></li>
<li><span class="ixname">banked</span>, <a href="#_ix1419">11.2.3. The screen works, but it is slow (older video cards)</a></li>
<li><span class="ixname">choosing</span>, <a href="#_ix69">2.3.1. A VESA video card</a>, <a href="#_ix729">7.7. Video page</a>, <a href="#_ix1477">11.3.3. Choosing another screen mode</a></li>
<li><span class="ixname">colors</span>, <a href="#_ix68">2.3.1. A VESA video card</a></li>
<li><span class="ixname">confirming</span>, <a href="#_ix730">7.7.1. Changing the video mode</a></li>
<li><span class="ixname">DVX.INI</span>, <a href="#_ix1486">11.3.4. Setting the screen mode in DVX.INI</a>, <a href="#_ix2051">B.2.5. The <code>[video]</code> section: screen mode</a></li>
<li><span class="ixname">how DVX chooses</span>, <a href="#_ix2056">B.2.5. The <code>[video]</code> section: screen mode</a></li>
<li><span class="ixname">list of</span>, <a href="#_ix723">7.7. Video page</a></li>
<li><span class="ixname">memory</span>, <a href="#_ix1482">11.3.3. Choosing another screen mode</a></li>
<li><span class="ixname">no usable mode</span>, <a href="#_ix1409">11.2.2. DVX says the video card has no usable mode</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix733">7.7.2. If the new mode does not work</a>, <a href="#_ix1463">11.3. The screen is wrong</a></li>
<li><span class="ixname">requirements</span>, <a href="#_ix66">2.3.1. A VESA video card</a></li>
<li><span class="ixname">safe video mode</span>, <a href="#_ix245">3.13.1. Safe video mode</a>, <a href="#_ix1472">11.3.2. The Safe Video Mode question</a></li>
</ul></li>
</ul>
<h3 id="_ixgroup_W">W</h3>
<ul class="ixlist">
<li><span class="ixname">wallpaper</span>, <a href="#_ix44">1.4.2. Color themes and desktop pictures</a>, <a href="#_ix705">7.6.1. Wallpaper</a>
<ul>
<li><span class="ixname">add-ons</span>, <a href="#_ix1213">10.1.1. Kinds of packages</a></li>
<li><span class="ixname">choosing any picture</span>, <a href="#_ix708">7.6.1. Wallpaper</a></li>
<li><span class="ixname">DVX.INI</span>, <a href="#_ix2166">B.2.15. The <code>[desktop]</code> section: wallpaper and screen saver</a></li>
<li><span class="ixname">folder</span>, <a href="#_ix1983">B.1.1. The DVX folder</a></li>
<li><span class="ixname">list of</span>, <a href="#_ix706">7.6.1. Wallpaper</a></li>
<li><span class="ixname">mode</span>, <a href="#_ix710">7.6.1. Wallpaper</a></li>
<li><span class="ixname">problems</span>, <a href="#_ix1495">11.3.6. Colors, themes, and the desktop picture</a></li>
<li><span class="ixname">removing</span>, <a href="#_ix709">7.6.1. Wallpaper</a></li>
<li><span class="ixname">your own pictures</span>, <a href="#_ix713">7.6.1. Wallpaper</a>, <a href="#_ix2002">B.1.2.1. Your own fonts, sounds, themes, pictures, banks, and screen savers</a></li>
</ul></li>
<li><span class="ixname">Welcome</span>, <a href="#_ix19">1.2. The programs that come with DVX</a>, <a href="#_ix252">3.14. The first start</a>, <a href="#_ix840">8.1. Which programs you have</a>, <a href="#_ix1008">8.10. Welcome</a>
<ul>
<li><span class="ixname">at start-up</span>, <a href="#_ix311">5.1. The screen after start-up</a></li>
<li><span class="ixname">Don&#8217;t show this again</span>, <a href="#_ix255">3.14.3. Closing Welcome and seeing it again</a></li>
<li><span class="ixname">DVX.INI</span>, <a href="#_ix2069">B.2.7. The <code>[shell]</code> section: the desktop and the Welcome window</a></li>
<li><span class="ixname">keys</span>, <a href="#_ix1011">8.10.2. The Welcome window</a></li>
<li><span class="ixname">Make it yours</span>, <a href="#_ix649">7.1. Opening Control Panel</a></li>
<li><span class="ixname">showing again</span>, <a href="#_ix1935">11.15. Going back to the default settings</a></li>
<li><span class="ixname">showing at start</span>, <a href="#_ix2072">B.2.7. The <code>[shell]</code> section: the desktop and the Welcome window</a></li>
<li><span class="ixname">starting later</span>, <a href="#_ix256">3.14.3. Closing Welcome and seeing it again</a></li>
<li><span class="ixname">tiles</span>, <a href="#_ix253">3.14.1. The Welcome tiles</a></li>
<li><span class="ixname">tour</span>, <a href="#_ix254">3.14.2. The tour</a>, <a href="#_ix1012">8.10.3. Taking the tour</a></li>
<li><span class="ixname">turning off</span>, <a href="#_ix1010">8.10.1. When Welcome appears</a></li>
</ul></li>
<li><span class="ixname">Widget Showcase</span>, <a href="#_ix1042">8.13.6. Widget Showcase</a></li>
<li><span class="ixname">WIDGETS folder</span>, <a href="#_ix1973">B.1.1. The DVX folder</a></li>
<li><span class="ixname">window menu</span>, <a href="#_ix361">5.3.9. The window menu</a></li>
<li><span class="ixname">windows</span>, <a href="#_ix5">1.1. What DVX is</a>, <a href="#_ix333">5.3. Windows</a>
<ul>
<li><span class="ixname">active window</span>, <a href="#_ix327">5.2.2. The keyboard</a>, <a href="#_ix345">5.3.2. The active window and switching windows</a></li>
<li><span class="ixname">arranging</span>, <a href="#_ix366">5.3.10. Arranging windows</a>, <a href="#_ix635">6.10.4. Window menu</a></li>
<li><span class="ixname">cannot be resized</span>, <a href="#_ix862">8.2.6. Menus and keys</a></li>
<li><span class="ixname">cascade</span>, <a href="#_ix367">5.3.10. Arranging windows</a></li>
<li><span class="ixname">changing size</span>, <a href="#_ix350">5.3.4. Changing the size of a window</a></li>
<li><span class="ixname">Close box</span>, <a href="#_ix337">5.3.1. Parts of a window</a></li>
<li><span class="ixname">closing</span>, <a href="#_ix358">5.3.7. Closing a window</a></li>
<li><span class="ixname">corners</span>, <a href="#_ix351">5.3.4. Changing the size of a window</a></li>
<li><span class="ixname">frame</span>, <a href="#_ix342">5.3.1. Parts of a window</a></li>
<li><span class="ixname">icons</span>, <a href="#_ix355">5.3.6. Minimizing a window</a></li>
<li><span class="ixname">Maximize button</span>, <a href="#_ix340">5.3.1. Parts of a window</a></li>
<li><span class="ixname">maximizing</span>, <a href="#_ix352">5.3.5. Maximizing and restoring a window</a></li>
<li><span class="ixname">Minimize button</span>, <a href="#_ix339">5.3.1. Parts of a window</a></li>
<li><span class="ixname">minimizing</span>, <a href="#_ix354">5.3.6. Minimizing a window</a></li>
<li><span class="ixname">moving</span>, <a href="#_ix348">5.3.3. Moving a window</a></li>
<li><span class="ixname">moving with the keyboard</span>, <a href="#_ix364">5.3.9.1. Moving and sizing with the keyboard</a></li>
<li><span class="ixname">off the screen</span>, <a href="#_ix1487">11.3.5. Other screen problems</a></li>
<li><span class="ixname">parts</span>, <a href="#_ix334">5.3.1. Parts of a window</a></li>
<li><span class="ixname">resizing</span>, <a href="#_ix324">5.2.1. The mouse</a>, <a href="#_ix349">5.3.4. Changing the size of a window</a></li>
<li><span class="ixname">resizing with the keyboard</span>, <a href="#_ix365">5.3.9.1. Moving and sizing with the keyboard</a></li>
<li><span class="ixname">restoring</span>, <a href="#_ix353">5.3.5. Maximizing and restoring a window</a></li>
<li><span class="ixname">restoring from an icon</span>, <a href="#_ix357">5.3.6. Minimizing a window</a></li>
<li><span class="ixname">several programs at once</span>, <a href="#_ix3">1.1. What DVX is</a></li>
<li><span class="ixname">switching</span>, <a href="#_ix344">5.3.2. The active window and switching windows</a></li>
<li><span class="ixname">tile</span>, <a href="#_ix368">5.3.10. Arranging windows</a></li>
<li><span class="ixname">title bar</span>, <a href="#_ix335">5.3.1. Parts of a window</a></li>
<li><span class="ixname">window menu</span>, <a href="#_ix360">5.3.9. The window menu</a></li>
</ul></li>
<li><span class="ixname">working folder</span>, <a href="#_ix579">6.4.3. Item properties</a></li>
<li><span class="ixname">write-protected disk</span>, <a href="#_ix219">3.11.1. Running DVX from a CD-ROM or a write-protected disk</a>, <a href="#_ix2015">B.1.4. Running DVX from a disk it cannot write to</a></li>
</ul>
<h3 id="_ixgroup_X">X</h3>
<ul class="ixlist">
<li><span class="ixname">XMODEM</span>, <a href="#_ix1130">9.6. Sending and receiving files</a>, <a href="#_ix1708">11.10.7. File transfers</a></li>
<li><span class="ixname">XMODEM-1K</span>, <a href="#_ix1131">9.6. Sending and receiving files</a></li>
</ul>
<h3 id="_ixgroup_Y">Y</h3>
<ul class="ixlist">
<li><span class="ixname">YMODEM</span>, <a href="#_ix1132">9.6. Sending and receiving files</a>, <a href="#_ix1709">11.10.7. File transfers</a></li>
</ul>
<h3 id="_ixgroup_Z">Z</h3>
<ul class="ixlist">
<li><span class="ixname">ZMODEM</span>, <a href="#_ix1133">9.6. Sending and receiving files</a>, <a href="#_ix1710">11.10.7. File transfers</a>
<ul>
<li><span class="ixname">automatic downloads</span>, <a href="#_ix1139">9.6.2. Receiving files</a></li>
</ul></li>
</ul>
</div>
</div>
</div>
<div id="footer">
<div id="footer-text">
Version 1.0.0<br>
</div>
</div>
</body>
</html>