From 4aed2c8219774f5d797760606b8489a92ddc5163 Mon Sep 17 00:00:00 2001 From: toma Date: Wed, 25 Nov 2009 17:56:58 +0000 Subject: Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. BUG:215923 git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdebase@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da --- konsole/doc/VT100/genDocument | 257 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 257 insertions(+) create mode 100755 konsole/doc/VT100/genDocument (limited to 'konsole/doc/VT100/genDocument') diff --git a/konsole/doc/VT100/genDocument b/konsole/doc/VT100/genDocument new file mode 100755 index 000000000..4ecee0996 --- /dev/null +++ b/konsole/doc/VT100/genDocument @@ -0,0 +1,257 @@ +#!/bin/sh +RES=techref.html + +function header +{ +cat << etx >> $RES +

+ + + + +
$1
+

+etx +} + +cat > $RES /dev/null + +# -- HTML Header -------------------------------------------------------------------- + +cat >> $RES << etx + + +VT100 + + + + +
+ +etx + +# -- Editors Notes ------------------------------------------------------------------ + +cat >> $RES << etx + +

VT100

+
+ +Please note that this text is under construction. + +

Preface

+ +This document accompanies the Konsole program, which is a terminal emulation +for the X Windows System. Since material about the extend and precise semantics +of the emulatation intended to be handled by this programs is hard to find on the +internet today, it came out nessesary to include a more precise specification within +their release. +Hopefully, this helps to clearify the relation to the VT100, VT102, Linux, XTerm +and ansi.sys (ANSI-BBS) terminals, which are the target of these programs. Further, +it specifies which codes are interpreted by them, and what has been omitted. +

+To begin with, all of the above call themselfes "ANSI" emulations, which makes this +notion pretty vage. "ANSI" referes here to the American National Standards +Institute's documents X3.41-1974 and X3.64-1977. DEC partially implemented this +standart in their VT100 terminal, with some additions. The VT102 is a later extention +of that. Both the Linux console and the XTerm emulation implement most of VT102, +with some additions. MS stepped in later and produced another ANSI emulation, +ansi.sys, for their OS, which became of some relevance in BBS style +telecommunication programs. One can view this as a small subset of the VT100 +emulation, with some additions, of cause. +This situation is further confused by the fact, that often many versions of the +above terminals and emulations are out, one able to do a little more or less then +the other. +

+

+

+I'm working towards a +close integration of the konsole's source code with this document, but it +is still a long way to go. +

+Currently, the body of this document is mainly a concept data base, that +referes to the VT100 component of the emulation. Though the codes accepted by +konsole are now clearly indicated, a comparison to the xterm and Linux console +emulation is missing. +

+The konsole emulation sources is not linked closely with it's documentation, +and, also accurate at the time of writing, it can still fall slightly appart, +though the codes accepted and produced by konsole should be properly listed. +Work is currently in progress to fix this issue. + + + +

Notes & todos

+ +
+etx + + +# -- Codes -------------------------------------------------------------------------- + +./genTC.pl >> $RES + + +header "On VT100" + +cat >> $RES << etx + +The VT100 is an upward and downward software-compatible terminal; +that is, previous Digital video terminals have Digital's private standards +for control sequences. The American National Standards Institute has since +standardized escape and control sequences in terminals in documents X3.41-1974 +and X3.64-1977. +

+The VT100 is compatible with both the previous Digital standard and +ANSI standards. Customers may use existing Digital software designed around +the VT52 or new VT100 software. The VT100 has a "VT52 compatible" mode in +which the VT100 responds to control sequences like a VT52. In this mode, most +of the new VT100 features cannot be used. +

+Throughout this document references will be made to "VT52 mode" or +"ANSI mode". These two terms are used to indicate the VT100's software +compatibility. +

+NOTE: The ANSI standards allow the manufacturer flexibility in implementing +each function. This document describes how the VT100 will respond to the +implemented ANSI central function. +

+ +etx + +header "Modes" + +cat >> $RES << etx + + + +The Following is a list of VT100 modes which may be changed with Set +Mode (SM) and Reset Mode (RM) controls. + +

ANSI Specified Modes

+ + + + + + +
ParameterMnemonicFunction
0 Error (Ignored)
20 LNM Line Feed/New Line Mode
+ + +

DEC Private Modes

+ +If the first character in the parameter string is ? (077), the +parameters are interpreted as DEC private parameters according to the +following: + + + + + + + + + + + + + +
ParameterMnemonicFunction +
0 Error (Ignored)
1DECCKM Cursor Key
2DECANM ANSI/VT52
3DECCOLMColumn
4DECSCLMScrolling
5DECSCNMScreen
6DECOM Origin
7DECAWM Auto Wrap
8DECARM Auto Repeat
9DECINLMInterlace
+ +Any other parameter values are ignored. + +

+The following modes, which are specified in the ANSI standard, may be +considered to be permanently set, permanently reset, or not applicable, +as noted. + + + + + + + + + + + + + + + + + + + + +
MnemonicFunction State
CRM Control Representation Reset
EBM Editing Boundary Reset
ERM Erasure Set
FEAM Format Effector Action Reset
FETM Format Effector Transfer Reset
GATM Guarded Area Transfer NA
HEM Horizontal Editing NA
IRM Insertion-replacement Reset
KAM Keyboard Action Reset
MATM Multiple area transfer NA
PUM Positioning Unit Reset
SATM Selected Area Transfer NA
SRTM Status Reporting TransferReset
TSM Tabulation Stop Reset
TTM Transfer Termination NA
VEM Vertical Editing NA
+etx + +# -- Keyboard Codes ----------------------------------------------------------------- + +cat >> $RES << etx +

Keyboard Codes

+ +The notation <ESC> denotes a single ASCII Escape character, 1Bx. + + + + + + + + + + + + +
Cursor KeyVT52 modeANSI mode w/cursor
key mode reset		ANSI mode w/cursor
key mode set
UP <ESC>A<ESC>[A<ESC>OA
DOWN <ESC>B<ESC>[B<ESC>OB
RIGHT<ESC>C<ESC>[C<ESC>OC
LEFT <ESC>D<ESC>[D<ESC>OD
+etx + + +# -- Graphics Characters ------------------------------------------------------------ + +cat >> $RES << etx +

Special Graphics Characters

+ +If the Special Graphics set is selected, the graphics for ASCII codes +0137 through 0176 will be replaced according to the following table (see the +SCS control sequence). +etx + + +awk -f awk.table.graphic < Table.Graphic >> $RES + + +cat >> $RES << etx +NOTE 1: Codes 0152-0156 and 0164-0170 are used to draw rectangular grids" each +piece of this set is contiguous with other so the lines formed will be +unbroken. +

+NOTE 2: Codes 0157-0163 give better vertical resolution than dashes and +underlines when drawing graphs; using these segments, 120 x 132 resolution may +be obtained in 132 column mode with the Advanced Video Option installed. +

+ +

References

+

+

+ +This text is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +

+Lars Dölle, 1998 + + + + +etx -- cgit v1.2.1