--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/nitros9guide/tmode.refentry	Sun Jul 07 08:58:56 2002 +0000
@@ -0,0 +1,205 @@
+<refentry id="tmode">
+<refnamediv>
+<refname>TMODE</refname>
+<refpurpose>Change terminal operating mode</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+<cmdsynopsis>
+<command>TMODE</command>
+<arg choice="opt">
+  .&replstart;pathnum&replend;
+</arg>
+<arg choice="opt">
+  &replstart;arglist&replend;
+</arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+<refsect1><title>Description</title>
+<para>
+This command is used to display or change the operating parameters
+of the user's terminal.
+</para>
+<para>
+If no arguments are given, the present values for each parameter are
+displayed, otherwise, the parameter(s) given in the argument list
+are processed. Any number of parameters can be. given, and are
+separated by spaces or commas. A period and a number can be used to
+optionally specify the path number to be affected. If none is given,
+the standard input path is affected.
+</para>
+<para>
+NOTE: If this command is used in a shell procedure file, the
+option &quot;.&replstart;path num&replend;&quot; must be used to specify one of the standard
+output paths (0, 1 or 2) to change the terminal's operating
+characteristics. The change will remain in effect until the path is
+closed. To effect a permanent change to a device characteristic,
+the device descriptor must be changed.
+</para>
+<para>
+This command can work only if a path to the file/device has already
+been opened. You may alter the device descriptor to set a device's
+initial operating parameter (see the System Programmer's Manual).
+</para>
+
+<informaltable frame="none">
+<tgroup cols="2">
+<colspec colwidth="1in">
+<colspec colwidth="4in">
+<tbody>
+<row>
+<entry>upc</entry>
+<entry>Upper case only. Lower case characters are automatically
+converted to upper case.</entry>
+</row>
+<row>
+<entry>-upc</entry>
+<entry>Upper case and lower case characters permitted (default).</entry>
+</row>
+<row>
+<entry>bsb</entry>
+<entry>Erase on backspace: backspace characters echoed as a
+backspace-space-backspace sequence (default).</entry>
+</row>
+<row>
+<entry>-bsb</entry>
+<entry>no erase on backspace: echoes single backspace only</entry>
+</row>
+<row>
+<entry>bsl</entry>
+<entry>Backspace over line: lines are &quot;deleted&quot; by sending
+backspace-space-backspace sequences to erase the same
+line (for video terminals) (default).</entry>
+</row>
+<row>
+<entry>-bsl</entry>
+<entry>No backspace over line: lines are &quot;deleted&quot; by printing
+a new line  sequence (for hard-copy terminals).
+echo Input characters &quot;echoed&quot; back to terminal (default)</entry>
+</row>
+<row>
+<entry>-echo</entry>
+<entry>No echo</entry>
+</row>
+<row>
+<entry>lf</entry>
+<entry>Auto line feed on: line feeds automatically echoed to
+terminal on input and output carriage returns (default).</entry>
+</row>
+<row>
+<entry>-lf</entry>
+<entry>Auto line feed off.</entry>
+</row>
+<row>
+<entry>pause</entry>
+<entry>Screen pause on: output suspended upon full screen. See
+&quot;pag&quot; parameter for definition of screen size. Output
+can be resumed by typing any key.</entry>
+</row>
+<row>
+<entry>-pause</entry>
+<entry>Screen pause mode off.</entry>
+</row>
+<row>
+<entry>null=n</entry>
+<entry>Set null count: number of null ($00) characters
+transmitted after carriage returns for return delay.
+The number is decimal, default = 0.</entry>
+</row>
+<row>
+<entry>pag=n</entry>
+<entry>Set video display page length to n (decimal) lines.
+Used for &quot;pause&quot; mode, see above.</entry>
+</row>
+<row>
+<entry>bsp=h</entry>
+<entry>Set input backspace character. Numeric value of
+character in hexadecimal. Default = 08.</entry>
+</row>
+<row>
+<entry>bse=h</entry>
+<entry>Set output backspace character. Numeric value of
+character in hexadecimal. Default = 08.</entry>
+</row>
+<row>
+<entry>del=h</entry>
+<entry>Set input delete line character. Numeric value of
+character in hexadecimal. Default = 18.</entry>
+</row>
+<row>
+<entry>bell=h</entry>
+<entry>Set bell (alert) output character. Numeric value of
+character in hexadecimal. Default = 07</entry>
+</row>
+<row>
+<entry>eor=h</entry>
+<entry>Set end-of-record (carriage return) input character.
+Numeric value of character in hexadecimal. Default = 0D</entry>
+</row>
+<row>
+<entry>eof=h</entry>
+<entry>Set end-of-file input character. Numeric value of
+character in hexadecimal. Default 1B.</entry>
+</row>
+<row>
+<entry>type=h</entry>
+<entry>ACIA initialization value: sets parity, word size, etc.
+Value in hexadecimal. Default 15</entry>
+</row>
+<row>
+<entry>reprint=h</entry>
+<entry>Reprint line character. Numeric value of character
+in hexadecimal.</entry>
+</row>
+<row>
+<entry>dup=h</entry>
+<entry>Duplicate last input line character. Numeric value of
+character in hexadecimal.</entry>
+</row>
+<row>
+<entry>psc=h</entry>
+<entry>Pause character. Numeric value of character in
+hexadecimal.</entry>
+</row>
+<row>
+<entry>abort=h</entry>
+<entry>Abort character (normally control C). Numeric value
+of character in hexadecimal.</entry>
+</row>
+<row>
+<entry>quit=h</entry>
+<entry>Quit character (normally control E). Numeric value
+of character in hexadecimal.</entry>
+</row>
+<row>
+<entry>baud=d</entry>
+<entry>Set baud rate for software-controllable interface. Numeric
+code for baud rate: 0=110 1=300 2=600 3=1200 4=2400 5=4800
+6=9600 7=19200</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+
+</refsect1>
+<refsect1><title>Examples</title>
+<screen>
+tmode -upc lf null=4 bselF pause
+
+tmode pag=24 pause bsl -echo bsp=8 bsl=C
+</screen>
+<para>
+NOTE: If you use TMODE in a procedure file, it will be necessary to
+specify one of the standard output paths (.1 or .2) since the
+shell's standard input path will have been redirected to the disk
+file (TMODE can be used on an SCFMAN-type devices only).
+
+Example:
+</para>
+<screen>
+tmode .1 pag=24          (set lines/page on standard output)
+</screen>
+</refsect1>
+</refentry>
+