home *** CD-ROM | disk | FTP | other *** search
/ The Developer Connection…ice Driver Kit for OS/2 3 / DEV3-D1.ISO / editors / tinyed / t.doc < prev    next >
Encoding:
Text File  |  1994-03-03  |  100.4 KB  |  3,454 lines

  1.  
  2.  
  3.                                                                 TDoc-v220-0
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.         ===================================================================
  35.         T
  36.         A Tiny Editor
  37.         Version 2.20
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.         (C) Copyright IBM Corporation 1987, 1993
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.         (C) Copyright IBM Corporation 1987, 1993
  68.         
  69.         
  70.         
  71.         -------------------------------------------------------------------
  72.         Version 2.20, October 1993
  73.  
  74.         This program was written by:
  75.  
  76.         Tim Baldwin
  77.         
  78.         IBM UK Laboratories
  79.         Hursley Park
  80.         Winchester
  81.         Hampshire, SO21 2JN
  82.         
  83.         BALDWINT at WINVMB
  84.         baldy@vnet.ibm.com
  85.  
  86.  
  87.         (C) Copyright IBM Corporation 1987, 1993.  All Rights Reserved.
  88.         -------------------------------------------------------------------
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.         
  128.                                                                     Page  i
  129.  
  130.  
  131.         (C) Copyright IBM Corporation 1987, 1993
  132.         
  133.         
  134.         
  135.         PREFACE
  136.  
  137.         This document describes T, a very small yet very powerful full
  138.         screen text editor for IBM PC, PS/2 and compatible machines.  The
  139.         document is divided into two main parts: "Part 1.  Using The
  140.         Editor" and "Part 2.  Editor Reference".
  141.  
  142.         Part 1 is a user's guide containing these sections:
  143.  
  144.         -  "1.0 Introduction".  This describes T, giving an overview of its
  145.            main features and omissions.  It also details the hardware and
  146.            software you will need to be able to use the editor and how you
  147.            can obtain a copy.
  148.  
  149.         -  "2.0 Getting Started".  This describes how to install T ready
  150.            for use.  It describes how to start up the editor, what the
  151.            screen looks like and how to use the help files.
  152.  
  153.         -  "3.0 Editing".  Contains a brief introduction to editing with
  154.            T describing how to issue commands and functions and the basics
  155.            of editing.  This section also covers searching and replacing,
  156.            the word processing features, the box drawing functions and
  157.            describes how to print documents when using the editor.
  158.  
  159.         -  "4.0 Customising".  Describes how the editor can be customised
  160.            to change the screen colours, to redefine the keyboard functions
  161.            and to alter some other special editor settings.
  162.  
  163.         Part 2 is the reference manual, divided into three sections:
  164.  
  165.         -  "1.0 Commands".  An alphabetical list of all the editor's
  166.            commands.
  167.  
  168.         -  "2.0 Keyboard Functions".  An alphabetical list of all the
  169.            editor's keyboard functions.
  170.  
  171.         -  "3.0 Settings".  An alphabetical list of all the editor's
  172.            special settings.
  173.  
  174.         Two appendices are also included:
  175.  
  176.         -  "Appendix A.  Messages".  Lists all the messages T can produce,
  177.            giving the meaning of the message and any possible action that
  178.            may need to be taken.
  179.  
  180.         -  "Appendix B.  User Definable Keys".  Lists all the valid names
  181.            and shift- combinations for the user-definable keys.
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.         
  192.                                                                 Preface  ii
  193.  
  194.  
  195.         (C) Copyright IBM Corporation 1987, 1993
  196.         
  197.         
  198.         
  199.         CONTENTS
  200.  
  201.  
  202.           Part 1.  Using The Editor   . . . . . . . . . . . . . . . . . . 1
  203.  
  204.           1.0 Introduction  . . . . . . . . . . . . . . . . . . . . . . . 2
  205.           1.1 Features and Omissions  . . . . . . . . . . . . . . . . . . 2
  206.           1.2 What You Need   . . . . . . . . . . . . . . . . . . . . . . 3
  207.  
  208.           2.0 Getting Started   . . . . . . . . . . . . . . . . . . . . . 5
  209.           2.1 Starting T  . . . . . . . . . . . . . . . . . . . . . . . . 5
  210.           2.2 Screen Layout   . . . . . . . . . . . . . . . . . . . . . . 5
  211.           2.3 The Help File   . . . . . . . . . . . . . . . . . . . . . . 6
  212.  
  213.           3.0 Editing   . . . . . . . . . . . . . . . . . . . . . . . . . 7
  214.           3.1 Keyboard Functions  . . . . . . . . . . . . . . . . . . . . 7
  215.           3.2 Simple Editing  . . . . . . . . . . . . . . . . . . . . . . 7
  216.             3.2.1 The Command Line  . . . . . . . . . . . . . . . . . . . 7
  217.             3.2.2 The Data Area   . . . . . . . . . . . . . . . . . . . . 8
  218.             3.2.3 Marking and Copying Lines   . . . . . . . . . . . . . . 8
  219.             3.2.4 Saving Documents  . . . . . . . . . . . . . . . . . . . 9
  220.             3.2.5 Working On Several Documents  . . . . . . . . . . . . . 9
  221.           3.3 Search and Replace  . . . . . . . . . . . . . . . . . . . . 9
  222.             3.3.1 Searching   . . . . . . . . . . . . . . . . . . . . . . 9
  223.             3.3.2 Replacing  . . . . . . . . . . . . . . . . . . . . . . 10
  224.           3.4 Word Processing  . . . . . . . . . . . . . . . . . . . . . 10
  225.             3.4.1 The Right Margin and Word Spill  . . . . . . . . . . . 11
  226.             3.4.2 The ADJUST LINE Function   . . . . . . . . . . . . . . 11
  227.           3.5 Drawing Boxes  . . . . . . . . . . . . . . . . . . . . . . 12
  228.           3.6 Printing   . . . . . . . . . . . . . . . . . . . . . . . . 12
  229.             3.6.1 Printer Control Codes  . . . . . . . . . . . . . . . . 13
  230.             3.6.2 Printer Set Up   . . . . . . . . . . . . . . . . . . . 13
  231.  
  232.           4.0 Customising  . . . . . . . . . . . . . . . . . . . . . . . 14
  233.           4.1 The Custom Definition File   . . . . . . . . . . . . . . . 14
  234.             4.1.1 Colour and Mono Commands   . . . . . . . . . . . . . . 15
  235.             4.1.2 Key Commands   . . . . . . . . . . . . . . . . . . . . 17
  236.             4.1.3 Set Commands   . . . . . . . . . . . . . . . . . . . . 18
  237.           4.2 The HELP and USER Functions  . . . . . . . . . . . . . . . 18
  238.           4.3 The Enhanced Keyboard  . . . . . . . . . . . . . . . . . . 19
  239.  
  240.           Part 2.  Editor Reference  . . . . . . . . . . . . . . . . . . 20
  241.  
  242.           1.0 Commands   . . . . . . . . . . . . . . . . . . . . . . . . 21
  243.           1.1 APPEND   . . . . . . . . . . . . . . . . . . . . . . . . . 21
  244.           1.2 CHANGE   . . . . . . . . . . . . . . . . . . . . . . . . . 21
  245.           1.3 DOS  . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
  246.           1.4 EDIT   . . . . . . . . . . . . . . . . . . . . . . . . . . 22
  247.           1.5 FILE   . . . . . . . . . . . . . . . . . . . . . . . . . . 22
  248.           1.6 GET  . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
  249.           1.7 GOTO   . . . . . . . . . . . . . . . . . . . . . . . . . . 23
  250.           1.8 LOCATE   . . . . . . . . . . . . . . . . . . . . . . . . . 23
  251.           1.9 MARGIN   . . . . . . . . . . . . . . . . . . . . . . . . . 23
  252.           1.10 NAME  . . . . . . . . . . . . . . . . . . . . . . . . . . 24
  253.           1.11 PRINT   . . . . . . . . . . . . . . . . . . . . . . . . . 24
  254.  
  255.         
  256.                                                               Contents  iii
  257.  
  258.  
  259.         (C) Copyright IBM Corporation 1987, 1993
  260.         
  261.         
  262.         
  263.           1.12 PUT   . . . . . . . . . . . . . . . . . . . . . . . . . . 24
  264.           1.13 QUIT  . . . . . . . . . . . . . . . . . . . . . . . . . . 24
  265.           1.14 SAVE  . . . . . . . . . . . . . . . . . . . . . . . . . . 25
  266.           1.15 VERSION   . . . . . . . . . . . . . . . . . . . . . . . . 25
  267.  
  268.           2.0 Keyboard Functions   . . . . . . . . . . . . . . . . . . . 26
  269.           2.1 ADJUST LINE  . . . . . . . . . . . . . . . . . . . . . . . 26
  270.           2.2 BACKSPACE  . . . . . . . . . . . . . . . . . . . . . . . . 26
  271.           2.3 CLEAR MARK   . . . . . . . . . . . . . . . . . . . . . . . 26
  272.           2.4 COMMAND TOGGLE   . . . . . . . . . . . . . . . . . . . . . 26
  273.           2.5 COPY MARK  . . . . . . . . . . . . . . . . . . . . . . . . 27
  274.           2.6 DELETE CHARACTER   . . . . . . . . . . . . . . . . . . . . 27
  275.           2.7 DELETE LINE  . . . . . . . . . . . . . . . . . . . . . . . 27
  276.           2.8 DELETE MARK  . . . . . . . . . . . . . . . . . . . . . . . 27
  277.           2.9 DOWN   . . . . . . . . . . . . . . . . . . . . . . . . . . 27
  278.           2.10 EDIT  . . . . . . . . . . . . . . . . . . . . . . . . . . 27
  279.           2.11 END OF FILE   . . . . . . . . . . . . . . . . . . . . . . 27
  280.           2.12 END OF LINE   . . . . . . . . . . . . . . . . . . . . . . 28
  281.           2.13 END OF MARK   . . . . . . . . . . . . . . . . . . . . . . 28
  282.           2.14 END OF SCREEN   . . . . . . . . . . . . . . . . . . . . . 28
  283.           2.15 ESCAPE  . . . . . . . . . . . . . . . . . . . . . . . . . 28
  284.           2.16 FILE  . . . . . . . . . . . . . . . . . . . . . . . . . . 28
  285.           2.17 FOCUS   . . . . . . . . . . . . . . . . . . . . . . . . . 29
  286.           2.18 HELP  . . . . . . . . . . . . . . . . . . . . . . . . . . 29
  287.           2.19 INSERT LINE   . . . . . . . . . . . . . . . . . . . . . . 29
  288.           2.20 INSERT TOGGLE   . . . . . . . . . . . . . . . . . . . . . 29
  289.           2.21 JOIN LINE   . . . . . . . . . . . . . . . . . . . . . . . 29
  290.           2.22 LEFT  . . . . . . . . . . . . . . . . . . . . . . . . . . 29
  291.           2.23 MARK LEFT   . . . . . . . . . . . . . . . . . . . . . . . 30
  292.           2.24 MARK RIGHT  . . . . . . . . . . . . . . . . . . . . . . . 30
  293.           2.25 MOVE MARK   . . . . . . . . . . . . . . . . . . . . . . . 30
  294.           2.26 NAME  . . . . . . . . . . . . . . . . . . . . . . . . . . 30
  295.           2.27 NEW LINE  . . . . . . . . . . . . . . . . . . . . . . . . 30
  296.           2.28 NEXT FILE   . . . . . . . . . . . . . . . . . . . . . . . 30
  297.           2.29 NEXT LINE   . . . . . . . . . . . . . . . . . . . . . . . 31
  298.           2.30 NEXT TAB  . . . . . . . . . . . . . . . . . . . . . . . . 31
  299.           2.31 NEXT WORD   . . . . . . . . . . . . . . . . . . . . . . . 31
  300.           2.32 NOTHING   . . . . . . . . . . . . . . . . . . . . . . . . 31
  301.           2.33 PAGE DOWN   . . . . . . . . . . . . . . . . . . . . . . . 31
  302.           2.34 PAGE UP   . . . . . . . . . . . . . . . . . . . . . . . . 31
  303.           2.35 PREVIOUS FILE   . . . . . . . . . . . . . . . . . . . . . 31
  304.           2.36 PREVIOUS TAB  . . . . . . . . . . . . . . . . . . . . . . 32
  305.           2.37 PREVIOUS WORD   . . . . . . . . . . . . . . . . . . . . . 32
  306.           2.38 QUIT  . . . . . . . . . . . . . . . . . . . . . . . . . . 32
  307.           2.39 REPEAT FIND   . . . . . . . . . . . . . . . . . . . . . . 32
  308.           2.40 REPEAT LINE   . . . . . . . . . . . . . . . . . . . . . . 32
  309.           2.41 RIGHT   . . . . . . . . . . . . . . . . . . . . . . . . . 32
  310.           2.42 SAFE FILE   . . . . . . . . . . . . . . . . . . . . . . . 32
  311.           2.43 SAVE  . . . . . . . . . . . . . . . . . . . . . . . . . . 33
  312.           2.44 SCROLL DOWN   . . . . . . . . . . . . . . . . . . . . . . 33
  313.           2.45 SCROLL LEFT   . . . . . . . . . . . . . . . . . . . . . . 33
  314.           2.46 SCROLL RIGHT  . . . . . . . . . . . . . . . . . . . . . . 33
  315.           2.47 SCROLL UP   . . . . . . . . . . . . . . . . . . . . . . . 33
  316.           2.48 SET MARK  . . . . . . . . . . . . . . . . . . . . . . . . 33
  317.           2.49 SPLIT LINE  . . . . . . . . . . . . . . . . . . . . . . . 34
  318.  
  319.         
  320.                                                                Contents  iv
  321.  
  322.  
  323.         (C) Copyright IBM Corporation 1987, 1993
  324.         
  325.         
  326.         
  327.           2.50 START OF LINE   . . . . . . . . . . . . . . . . . . . . . 34
  328.           2.51 TOP OF FILE   . . . . . . . . . . . . . . . . . . . . . . 34
  329.           2.52 TOP OF MARK   . . . . . . . . . . . . . . . . . . . . . . 34
  330.           2.53 TOP OF SCREEN   . . . . . . . . . . . . . . . . . . . . . 34
  331.           2.54 TRUNCATE LINE   . . . . . . . . . . . . . . . . . . . . . 34
  332.           2.55 UNDO  . . . . . . . . . . . . . . . . . . . . . . . . . . 34
  333.           2.56 UP  . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
  334.           2.57 USER  . . . . . . . . . . . . . . . . . . . . . . . . . . 35
  335.  
  336.           3.0 Settings   . . . . . . . . . . . . . . . . . . . . . . . . 36
  337.           3.1 AUTOMATIC INDENT   . . . . . . . . . . . . . . . . . . . . 36
  338.           3.2 CGA SNOW   . . . . . . . . . . . . . . . . . . . . . . . . 36
  339.           3.3 COMMAND RECALL   . . . . . . . . . . . . . . . . . . . . . 37
  340.           3.4 COMMAND TOGGLE   . . . . . . . . . . . . . . . . . . . . . 37
  341.           3.5 EXACT MATCH  . . . . . . . . . . . . . . . . . . . . . . . 37
  342.           3.6 FOCUS LINE   . . . . . . . . . . . . . . . . . . . . . . . 37
  343.           3.7 HELP COMMAND   . . . . . . . . . . . . . . . . . . . . . . 38
  344.           3.8 HELP LINE  . . . . . . . . . . . . . . . . . . . . . . . . 38
  345.           3.9 INSERT CURSOR  . . . . . . . . . . . . . . . . . . . . . . 38
  346.           3.10 INSERT TOGGLE   . . . . . . . . . . . . . . . . . . . . . 38
  347.           3.11 KEYBOARD TYPE   . . . . . . . . . . . . . . . . . . . . . 39
  348.           3.12 LINE END  . . . . . . . . . . . . . . . . . . . . . . . . 39
  349.           3.13 REPLACE CURSOR  . . . . . . . . . . . . . . . . . . . . . 39
  350.           3.14 RIGHT MARGIN  . . . . . . . . . . . . . . . . . . . . . . 40
  351.           3.15 SEGMENT SIZE  . . . . . . . . . . . . . . . . . . . . . . 40
  352.           3.16 TAB EXPAND  . . . . . . . . . . . . . . . . . . . . . . . 40
  353.           3.17 TAB SPACING   . . . . . . . . . . . . . . . . . . . . . . 40
  354.           3.18 USER COMMAND  . . . . . . . . . . . . . . . . . . . . . . 41
  355.  
  356.           Appendix A.  Messages  . . . . . . . . . . . . . . . . . . . . 42
  357.  
  358.           Appendix B.  User Definable Keys   . . . . . . . . . . . . . . 46
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.         
  384.                                                                 Contents  v
  385.  
  386.  
  387.         (C) Copyright IBM Corporation 1987, 1993
  388.         
  389.         
  390.         
  391.                                                   Part 1.  Using The Editor
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.         
  448.                                                Part 1.  Using The Editor  1
  449.  
  450.  
  451.         (C) Copyright IBM Corporation 1987, 1993
  452.         
  453.         
  454.         
  455.         1.0 INTRODUCTION
  456.  
  457.         T is a full screen text editor for the IBM PC, PS/2 and compatible
  458.         family of machines.  Two versions of the editor are supplied, one
  459.         to run under DOS and the other to run under OS/2.  It is designed
  460.         to be quick and easy to learn and simple to use, while remaining
  461.         both extremely powerful and very small - the DOS version being
  462.         under 10,000 bytes in size.
  463.  
  464.         A very small editor has a number of advantages:
  465.  
  466.         -  It may be used on machines with a limited amount of memory.
  467.            Even a PC with a full 640K of base memory can have a large
  468.            amount of this used up when a number of
  469.            terminate-and-stay-resident type programs are installed - local
  470.            area network drivers and terminal emulators are prime examples.
  471.  
  472.         -  It may be used for editing large files that would be too large
  473.            to load into memory with a bigger editor.
  474.  
  475.         -  It may be invoked from inside other programs yet still have
  476.            enough free memory to edit a good sized file.
  477.  
  478.         -  It loads and starts very quickly indeed.  If you just wish to
  479.            make a small change to your CONFIG.SYS file it can be very
  480.            frustrating to spend time waiting for a large word processor to
  481.            start up.
  482.  
  483.         -  It can be placed on a diskette without consuming much space.
  484.            This can be useful for those "emergency" diskettes used to boot
  485.            up and fix a system when all else fails.
  486.  
  487.         -  It can be placed on a RAM disk without consuming much space.
  488.            This can be useful for palmtop type machines which often have no
  489.            disk drives at all.
  490.  
  491.  
  492.  
  493.         1.1 FEATURES AND OMISSIONS
  494.  
  495.         T has the following main features:
  496.  
  497.         -  Very small size, under 10,000 bytes.
  498.  
  499.         -  Fast, easy to use, full screen interface that adapts
  500.            automatically to use the full size of the display.
  501.  
  502.         -  Edits very large files, subject to available memory.
  503.  
  504.         -  Edits very long lines, up to 65,528 characters.
  505.  
  506.         -  Edits any number of files at once, subject to available memory.
  507.  
  508.         -  On screen help
  509.  
  510.  
  511.         
  512.                                                             Introduction  2
  513.  
  514.  
  515.         (C) Copyright IBM Corporation 1987, 1993
  516.         
  517.         
  518.         
  519.         -  Very fast search and replace functions.
  520.  
  521.         -  Customisable keyboard mapping and screen colours.
  522.  
  523.         -  Any DOS or OS/2 command may be run without leaving the editor.
  524.  
  525.         -  A "right hand margin" and "word-spill" to allow some simple word
  526.            processing to be performed.
  527.  
  528.         -  Native DOS and OS/2 versions, which also run under Windows and
  529.            Windows/NT.
  530.  
  531.         -  OS/2 version has full support for the HPFS.
  532.  
  533.         To keep T small it necessarily lacks some of the more advanced
  534.         features of larger editors and word processors.  In particular:
  535.  
  536.         -  Copying and moving data can only be performed on blocks of one
  537.            or more whole lines.
  538.  
  539.         -  Word processing capabilities are very limited.
  540.  
  541.         -  No programmability, although the appearance and function may be
  542.            customised.
  543.  
  544.         -  No direct support for the mouse or a menu system.
  545.  
  546.  
  547.  
  548.         1.2 WHAT YOU NEED
  549.  
  550.         T should run on any IBM PC, PS/2 or compatible machine.  It needs
  551.         PC-DOS or MS-DOS version 2.00 or later, or any version of OS/2.
  552.         The DOS version may also be run as a DOS application under
  553.         Microsoft Windows and both the DOS and OS/2 versions may be run
  554.         under Windows/NT.
  555.  
  556.         When used with OS/2 or with appropriate versions of Windows it may
  557.         be run from both full screen and windowed command prompts, or may
  558.         be started by placing an object in one of the OS/2 folders or
  559.         Windows Program Manager groups.
  560.  
  561.         
  562.         T is available through the Employee
  563.         Written Software programme.  The file TINYED.ZIP can be obtained
  564.         through CompuServe, from many BBS systems and via anonymous FTP
  565.         from a number of sites (e.g.  software.watson.ibm.com).  The ZIP
  566.         file should be unpacked with PKUNZIP to create the full package.
  567.  
  568.         The T package contains:
  569.  
  570.         T.EXE        This is the DOS version of the editor program.
  571.  
  572.         
  573.                                                             Introduction  3
  574.  
  575.  
  576.         (C) Copyright IBM Corporation 1987, 1993
  577.         
  578.         
  579.         
  580.         T2.EXE       This is the OS/2 version of the editor program.
  581.  
  582.         TKEY.EXE     This is the customiser program.  It will run under
  583.                      both DOS and OS/2 and will customise either version of
  584.                      the editor.
  585.  
  586.         THELP.HLP    This is a simple help file for the standard editor
  587.                      configuration.
  588.  
  589.         TKEYS.DEF    This is a sample custom definition file that describes
  590.                      the standard editor configuration.
  591.  
  592.         T.DOC        This is the full documentation in a plain ASCII
  593.                      printable format.
  594.  
  595.         In addition the publicly available TINYED.ZIP package contains the
  596.         following important file:
  597.  
  598.         LICENSE.TXT  This contains the terms and conditions under which IBM
  599.                      makes the package available.
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.         
  637.                                                             Introduction  4
  638.  
  639.  
  640.         (C) Copyright IBM Corporation 1987, 1993
  641.         
  642.         
  643.         
  644.         2.0 GETTING STARTED
  645.  
  646.         This section describes how to get T up and running, what the screen
  647.         looks like and how to ask for help.
  648.  
  649.  
  650.         2.1 STARTING T
  651.  
  652.         Only the program file (T.EXE for DOS or T2.EXE for OS/2) is
  653.         required to be able to use the editor; this should be located in
  654.         the current directory of the current drive, or in a subdirectory
  655.         listed in your PATH.  The other files are only required if you want
  656.         to customise the editor or if you want to use the supplied help
  657.         file.  These other files would normally be kept on a separate
  658.         diskette or in their own subdirectory (which need not be in the
  659.         PATH).
  660.  
  661.         If you use OS/2 exclusively or use both DOS and OS/2 but keep your
  662.         DOS and OS/2 programs in separate subdirectories you might want to
  663.         rename the OS/2 executable to T.EXE also.  This avoids having to
  664.         remember whether to type T or T2 depending on the environment you
  665.         are using.
  666.  
  667.         Since T is so small it makes sense to put it on a RAMDRIVE if you
  668.         have one installed, this means that it will load almost instantly.
  669.  
  670.         To start T simply enter the following command at the DOS or OS/2
  671.         prompt:
  672.  
  673.              T  <filename> <filename> ...
  674.          or  T2 <filename> <filename> ...
  675.  
  676.  
  677.         You can put any number, including zero, of file names after the
  678.         T command and T will load each file you list into its memory.  If
  679.         you are using the OS/2 HPFS and your file names include spaces you
  680.         must specify the name inside double quotes, so T does not think it
  681.         is two separate file names.
  682.  
  683.  
  684.         2.2 SCREEN LAYOUT
  685.  
  686.         The T screen is divided into four areas:
  687.  
  688.         1. The Message Line and the Help Line.
  689.  
  690.            The bottom line of the screen is used to display error and
  691.            informational messages.  When no messages are displayed this
  692.            line shows instead a single line of "help".  Typically the
  693.            functions assigned to the F-keys are displayed, but this can be
  694.            customised to whatever you find useful.
  695.  
  696.         2. The Status Line.
  697.  
  698.  
  699.  
  700.         
  701.                                                          Getting Started  5
  702.  
  703.  
  704.         (C) Copyright IBM Corporation 1987, 1993
  705.         
  706.         
  707.         
  708.            Above the message line is the status line.  This shows the name
  709.            of the current document and the line and column number of the
  710.            position of the cursor within the document.  If a right-hand
  711.            margin has been set this will also be displayed following an "M"
  712.            margin indicator.  The current typing mode (either "replace" or
  713.            "insert") is also indicated.
  714.  
  715.         3. The Command Line.
  716.  
  717.            Above the status line is the command line.  Any any valid T
  718.            command may be entered here.
  719.  
  720.         4. The Data Area.
  721.  
  722.            The rest of the screen is used to display the document being
  723.            edited.
  724.  
  725.         The size of the data area is automatically adjusted to fill the
  726.         whole of the screen.  Most modern displays can show more than 25
  727.         lines and many can show more than 80 columns.  T itself cannot
  728.         change the size of the display but it will use the full size of the
  729.         screen that is available when it is started.  So to see rather more
  730.         data on the screen first switch to a mode that shows more than 25
  731.         lines then invoke T.  For example, the following command will
  732.         switch to a 43 line 80 column mode under OS/2 or DOS (this needs
  733.         DOS 4.00 or later):
  734.  
  735.              MODE CO80,43
  736.  
  737.  
  738.  
  739.  
  740.         2.3 THE HELP FILE
  741.  
  742.         T is supplied with a simple help file which describes the default
  743.         key settings and the commands available.  When using T for the
  744.         first time ensure that the help file THELP.HLP is available in the
  745.         current directory of the current drive.  Later you can customise
  746.         the editor to allow the help file to be kept somewhere else.
  747.  
  748.         Press the F1 key to load and display the help file.  Then use the
  749.         PgUp and PgDn keys to view the various help panels it contains.  If
  750.         you have a 40-column display use the Home and End keys to view the
  751.         left and right hand panels.
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.         
  765.                                                          Getting Started  6
  766.  
  767.  
  768.         (C) Copyright IBM Corporation 1987, 1993
  769.         
  770.         
  771.         
  772.         3.0 EDITING
  773.  
  774.         This section gives a brief introduction to editing with T.  It
  775.         assumes the editor is used in its default configuration, as
  776.         supplied.  Later sections describe how to customise the editor.
  777.         Anyone who is familiar with the IBM Personal Editor will recognise
  778.         the way T works immediately and should be able to skip most of this
  779.         section - although a glance at "3.4 Word Processing" on page 10 and
  780.         "3.5 Drawing Boxes" on page 12 might be worthwhile.
  781.  
  782.  
  783.         3.1 KEYBOARD FUNCTIONS
  784.  
  785.         Most of the services that T can perform are accessed through
  786.         keyboard functions.  These functions are invoked by pressing the
  787.         key or key combination to which the function is assigned.  Many
  788.         functions are assigned to obvious keys, for example the LEFT
  789.         function (which moves the cursor one character to the left) is
  790.         assigned to the cursor Left key, the RIGHT function (to move the
  791.         cursor right) to the cursor Right key and so on.  Other functions
  792.         are assigned to key combinations that it is hoped provide some sort
  793.         of mnemonic for the function concerned, so for example the REPEAT
  794.         LINE function (to duplicate the current line) is assigned to Alt-R,
  795.         the SPLIT LINE function (to split the current line) to Alt-S and so
  796.         on.  Full details of these keyboard functions and the keys to which
  797.         they are assigned can be found in "2.0 Keyboard Functions" on page
  798.         26.
  799.  
  800.  
  801.         3.2 SIMPLE EDITING
  802.  
  803.         If T is started without any filename (by just entering T on the
  804.         command line) it displays and edits a new, empty, unnamed document.
  805.         A "Top of File" marker line indicates the top of the document and
  806.         an "End of File" marker indicates the end.  These marker lines are
  807.         not part of the document and may not be edited, although the cursor
  808.         may be moved onto them.
  809.  
  810.  
  811.         3.2.1 THE COMMAND LINE
  812.  
  813.         The cursor is initially placed on the command line, which is the
  814.         third line up from the bottom of the screen.  Any T command can be
  815.         entered on the command line and it is executed when the Enter key
  816.         is pressed.  As a command is typed mistakes can be corrected using
  817.         the functions LEFT, RIGHT and BACKSPACE (assigned to the cursor
  818.         Left, cursor Right and the Backspace keys, respectively).  When the
  819.         editor is in "replace" mode any characters typed overwrite those
  820.         already on the screen; when in "insert" mode any characters to the
  821.         right of the cursor are shifted right to make room for the new
  822.         text.  Switch between "insert" and "replace" mode by using the
  823.         function INSERT TOGGLE (assigned to the Ins key).
  824.  
  825.         When on the command line the cursor Up and cursor Down keys recall
  826.         any previous commands entered.  These can then either be entered
  827.  
  828.         
  829.                                                                  Editing  7
  830.  
  831.  
  832.         (C) Copyright IBM Corporation 1987, 1993
  833.         
  834.         
  835.         
  836.         again directly by pressing Enter or can be altered before being
  837.         reused.
  838.  
  839.  
  840.         3.2.2 THE DATA AREA
  841.  
  842.         The cursor may be switched between the data area and the command
  843.         line by using the function COMMAND TOGGLE (Esc key).  When the
  844.         cursor is on the command line a shadow cursor marks the position in
  845.         the data where the real cursor will appear when the function
  846.         COMMAND TOGGLE is used.
  847.  
  848.         When the cursor is in the data area it may be moved anywhere
  849.         between the "Top of File" and "End of File" marker lines.  At any
  850.         place text may be typed from the keyboard.  If the editor is in
  851.         "replace" mode any text typed will overwrite whatever was there
  852.         before, if it is in "insert" mode anything to the right of the
  853.         cursor will be shifted to the right to make room for the new text.
  854.  
  855.         To add a new line use the function INSERT LINE(Ctrl-Enter) and to
  856.         delete a line use the function DELETE LINE (Ctrl-Backspace).
  857.         Alternatively if the editor is in "insert" mode just pressing Enter
  858.         will insert a new blank line (using the function NEW LINE).
  859.  
  860.  
  861.         3.2.3 MARKING AND COPYING LINES
  862.  
  863.         A block of one or more lines may be marked by pressing the function
  864.         SET MARK (Alt-L) on the first and last lines of the required block.
  865.  
  866.         Marked blocks may be deleted using the function DELETE MARK (Alt-D)
  867.         or they be moved or copied somewhere else.  To move or copy a mark
  868.         first position the cursor at the line above the desired new
  869.         position, then use either the function MOVE MARK (Alt-M) or COPY
  870.         MARK (Alt-C).
  871.  
  872.         Marked blocks are also useful for limiting the scope of a CHANGE or
  873.         LOCATE command (described later).
  874.  
  875.         It is also possible to shift all marked lines one character to the
  876.         left or right by using the functions MARK LEFT (Shift-F7) or MARK
  877.         RIGHT (Shift-F8) respectively.  This can be used to indent blocks
  878.         of code when writing programs, for example.
  879.  
  880.         To duplicate a copy of the current line just use the function
  881.         REPEAT LINE (Alt-R).
  882.  
  883.  
  884.         3.2.4 SAVING DOCUMENTS
  885.  
  886.         If a document has a name (displayed on the status line) it can be
  887.         saved to disk simply by using the function SAVE (F2); once saved
  888.         you may quit the document with the function QUIT (F3).  Alternately
  889.         you can perform a save and quit in one operation by using the
  890.         function SAFE FILE (F4).  If a document doesn't have a name you
  891.  
  892.         
  893.                                                                  Editing  8
  894.  
  895.  
  896.         (C) Copyright IBM Corporation 1987, 1993
  897.         
  898.         
  899.         
  900.         must give it one: either use the NAME command to name the document
  901.         or use the SAVE or FILE commands along with a filename parameter.
  902.  
  903.         Note: Using the function SAFE FILE (F4) will not cause the document
  904.         to be written to disk if it has not been changed.  If you want to
  905.         force an unchanged document to be re-written to disk simply use the
  906.         FILE command from the command line.
  907.  
  908.  
  909.         3.2.5 WORKING ON SEVERAL DOCUMENTS
  910.  
  911.         T can edit any number of documents at once.  The documents are held
  912.         in an edit ring, and although only one can be displayed on the
  913.         screen at one time, you can cycle through the ring by using the
  914.         functions NEXT FILE (F10) or PREVIOUS FILE (F11).  The actual
  915.         number of documents you can hold in the ring depends on the size of
  916.         each document and how much memory your machine has; each document
  917.         has to be completely loaded in memory.
  918.  
  919.         To load multiple documents you can either enter several filenames
  920.         when T is started from the command line, or you can issue EDIT
  921.         commands to load more files once T is running.
  922.  
  923.         The marked line functions MOVE MARK (Alt-M) and COPY MARK (Alt-C)
  924.         are particularly useful when editing several documents as lines can
  925.         be moved and copied to and from different documents.
  926.  
  927.  
  928.         3.3 SEARCH AND REPLACE
  929.  
  930.  
  931.  
  932.         3.3.1 SEARCHING
  933.  
  934.         To search for a particular word or phrase in a document switch onto
  935.         the command line and use the LOCATE command.  In its simplest form
  936.         you just enter a command rather like this:
  937.  
  938.              /word
  939.  
  940.  
  941.         This will search the document for the next occurrence of "word".
  942.         T will only search from the current position forwards, so to search
  943.         from the top you first need to move to the top by using the
  944.         function TOP OF FILE (Ctrl-Home).
  945.  
  946.         Having found a match you can repeat the search to find the next
  947.         match simply by using the function REPEAT FIND (Alt-F).  If no
  948.         further matches can be found before the end of the document the
  949.         message "No match found" will be displayed.
  950.  
  951.         Normally LOCATE commands are case-sensitive i.e. a search for
  952.         "word" would not find "WORD" or even "Word".  To do a
  953.         case-insensitive search add the "c" option to the command, like
  954.         this:
  955.  
  956.         
  957.                                                                  Editing  9
  958.  
  959.  
  960.         (C) Copyright IBM Corporation 1987, 1993
  961.         
  962.         
  963.         
  964.              /word/c
  965.  
  966.  
  967.  
  968.  
  969.         3.3.2 REPLACING
  970.  
  971.         To change one word or phrase into something else switch onto the
  972.         command line and use the CHANGE command, for example:
  973.  
  974.              C/this/that
  975.  
  976.  
  977.         This will search for the next occurrence of the word "this" and
  978.         then prompt for an action with the message "Yes/No/Go/Last/Quit?".
  979.         Hit either Y, N, G, L or Q as appropriate:
  980.  
  981.         Yes   To change this occurrence of "this" into "that" and to search
  982.               for the next occurrence of "this".
  983.  
  984.         No    To skip this change, but to continue searching.
  985.  
  986.         Go    To make this change and all further changes to the end of the
  987.               document without any further prompting.
  988.  
  989.         Last  To make this change and to stop searching, so this becomes
  990.               the last change.
  991.  
  992.         Quit  To skip this change and stop searching.
  993.  
  994.         To avoid the prompt message and to make all changes straightaway
  995.         add the "*" option to the command:
  996.  
  997.              C/this/that/*
  998.  
  999.  
  1000.  
  1001.  
  1002.         3.4 WORD PROCESSING
  1003.  
  1004.         T is not designed to be a word processor, but it does provide some
  1005.         very simple word processing functions that are useful for creating
  1006.         quick notes or for entering marked-up documents that will later be
  1007.         formatted with a batch formatter.
  1008.  
  1009.  
  1010.         3.4.1 THE RIGHT MARGIN AND WORD SPILL
  1011.  
  1012.         The command MARGIN allows a right hand margin column to be set.
  1013.         When a margin is set the status line indicates its column number
  1014.         with "M nnn".  To set the right hand margin to column 72 you would
  1015.         enter the command:
  1016.  
  1017.              MARGIN 72
  1018.  
  1019.  
  1020.         
  1021.                                                                 Editing  10
  1022.  
  1023.  
  1024.         (C) Copyright IBM Corporation 1987, 1993
  1025.         
  1026.         
  1027.         
  1028.         As text is entered into the document any words that are typed
  1029.         across the right hand margin are automatically word-spilled onto a
  1030.         new inserted line.  This means it is possible to type whole
  1031.         paragraphs without having to worry about hitting Enter at the end
  1032.         of each line.  As words spill onto a new line they are
  1033.         automatically indented from the left hand side so as they align
  1034.         under the first non-blank character of the line above.  This makes
  1035.         it very simple to leave a left margin or to enter whole sections
  1036.         indented.
  1037.  
  1038.  
  1039.         3.4.2 THE ADJUST LINE FUNCTION
  1040.  
  1041.         If corrections need to be made to text entered with a right margin
  1042.         the text will not be reflowed automatically to keep the margins
  1043.         correct; in fact after making a number of corrections it will tend
  1044.         to end up in rather a mess.  The function ADJUST LINE (Alt-A) is
  1045.         provided to tidy up this mess and re-align everything correctly.
  1046.         ADJUST LINE is performed by pressing Alt-A and will adjust the
  1047.         current line to the current right margin setting.  If the line is
  1048.         too short it will be filled out with words from the next line down
  1049.         and if it is too long it will be split in two.  As with the
  1050.         word-spill, when ADJUST LINE spills words onto the next line they
  1051.         are aligned under the first non-blank character of the preceding
  1052.         line.
  1053.  
  1054.         ADJUST LINE will ignore blank lines, skipping over them and moving
  1055.         the cursor to the next line down, and if a line needs to be split
  1056.         in two the cursor will move down to the split-off portion.  This
  1057.         makes re-adjusting whole paragraphs very simple, just place the
  1058.         cursor on the first line of the paragraph and keep pressing Alt-A
  1059.         until it is re-flowed correctly.
  1060.  
  1061.         Note: When a line is too short and ADJUST LINE fills with words
  1062.         from the next line, these words are joined to the line with just
  1063.         one intervening blank.  If before the ADJUST LINE the last
  1064.         character happened to be a full stop at the end of a sentence you
  1065.         may need to go back and insert an extra space to maintain the
  1066.         convention of two blanks following a sentence end.
  1067.  
  1068.  
  1069.         3.5 DRAWING BOXES
  1070.  
  1071.         The PC character set contains a group of special symbols that can
  1072.         be used to draw boxes.  T assigns the box corner and intersection
  1073.         characters to the keys Alt-1 to Alt-9.  As a reminder of which box
  1074.         corner is assigned to which key, just look at the numeric keypad
  1075.         which is arranged like this:
  1076.  
  1077.              7  8  9
  1078.              4  5  6
  1079.              1  2  3
  1080.  
  1081.  
  1082.  
  1083.  
  1084.         
  1085.                                                                 Editing  11
  1086.  
  1087.  
  1088.         (C) Copyright IBM Corporation 1987, 1993
  1089.         
  1090.         
  1091.         
  1092.         So the Alt-7 key produces a top left box corner, the Alt-3 a bottom
  1093.         right and so on.  Remember that the keypad just provides a mnemonic
  1094.         - you must actually enter characters using the Alt-key and the
  1095.         numerals along the top of the main keyboard area.
  1096.  
  1097.         The horizontal line is assigned to Alt-- (Alt-minus) and the
  1098.         vertical line to Alt-= (Alt-equals).  These two may need
  1099.         reassigning to use other keys on non-English language keyboards,
  1100.         where the "-" and "=" keys don't appear on the top row just after
  1101.         the numerals.  This can be done by customising the editor (see "4.0
  1102.         Customising" on page 14).
  1103.  
  1104.  
  1105.         3.6 PRINTING
  1106.  
  1107.         To print the current document switch onto the command line and
  1108.         enter the PRINT command.  No special facilities are provided for
  1109.         formatted printing, the PRINT command will simply write a copy of
  1110.         the current document to the printer.  If used with no parameters
  1111.         PRINT will write to the device PRN, which for most people will be
  1112.         the printer attached to their machine.  If you have a serially
  1113.         attached printer or use a LAN printer you may need to specify the
  1114.         printer device, for example:
  1115.  
  1116.              PRINT COM1
  1117.          or  PRINT LPT2
  1118.  
  1119.  
  1120.         To print a piece of a document first mark the block of lines to be
  1121.         printed, then use the PUT command to write them to a device.  A
  1122.         device must be specified with the PUT command, so normally you
  1123.         would use:
  1124.  
  1125.              PUT PRN
  1126.  
  1127.  
  1128.  
  1129.  
  1130.         3.6.1 PRINTER CONTROL CODES
  1131.  
  1132.         You may embed printer control codes directly in your documents if
  1133.         you want to produce special effects such as bold or emphasised.
  1134.         You will need to refer to your printer's documentation to determine
  1135.         exactly which control codes are available and what they do.
  1136.  
  1137.         Control codes can normally be entered directly using the keypad on
  1138.         the right of the keyboard: hold down the Alt key and type the
  1139.         decimal value of the required control code on the keypad then
  1140.         release the Alt key.  The control code should appear at the cursor
  1141.         position, most control codes show up on the screen as odd little
  1142.         symbols.
  1143.  
  1144.         Some codes can also be entered using other keys, but these will
  1145.         require the use of the function ESCAPE (Alt-X).  For example to
  1146.         enter a form feed (ASCII value 12) you can either use the keypad
  1147.  
  1148.         
  1149.                                                                 Editing  12
  1150.  
  1151.  
  1152.         (C) Copyright IBM Corporation 1987, 1993
  1153.         
  1154.         
  1155.         
  1156.         method described above (hold down Alt, key 1 2 on the keypad and
  1157.         release Alt), or press ESCAPE (Alt-X) followed by Ctrl-L ("L" being
  1158.         the 12th letter of the alphabet).
  1159.  
  1160.  
  1161.         3.6.2 PRINTER SET UP
  1162.  
  1163.         You may prefer not to place the printer control codes directly in
  1164.         the document, but to keep the document as plain, readable text.
  1165.         But you may want to send a few special characters to the printer
  1166.         before printing a document, perhaps to switch the printer to NLQ
  1167.         mode.
  1168.  
  1169.         These printer set up sequences can be issued with a DOS ECHO
  1170.         command, for example to put a Proprinter into NLQ mode issue the
  1171.         following command:
  1172.  
  1173.              DOS ECHO xG >PRN
  1174.  
  1175.  
  1176.         where the "x" should be an ASCII "Esc" control code entered by
  1177.         hitting Alt-X followed by the Esc key.
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.         
  1213.                                                                 Editing  13
  1214.  
  1215.  
  1216.         (C) Copyright IBM Corporation 1987, 1993
  1217.         
  1218.         
  1219.         
  1220.         4.0 CUSTOMISING
  1221.  
  1222.         This section describes how you can customise T to match your own
  1223.         preferences for screen colours, keyboard layouts and special
  1224.         settings.  Even if you like T exactly the way it is supplied and
  1225.         don't want to change any of the colours or keys, you will probably
  1226.         still need to customise some of the special settings, at least to
  1227.         tell the editor where you keep its help file.
  1228.  
  1229.         To customise T you must first construct a custom definition
  1230.         file, which is described in detail in the next section.  Then use
  1231.         the TKEY.EXE customiser program to customise your copy of the
  1232.         editor, by entering this command on the DOS or OS/2 command line:
  1233.  
  1234.              TKEY  custom.DEF  editor.EXE
  1235.  
  1236.  
  1237.         Replace "custom.DEF" with the name of your custom definition file
  1238.         and replace "editor.EXE" with the name the editor you want to
  1239.         customise.  Unless you tell it otherwise TKEY will assume the
  1240.         custom definition file has an extension of .DEF and the editor of
  1241.         .EXE.  So to customise both the DOS and the OS/2 versions with a
  1242.         custom definition file called TCUST.DEF you would use the two
  1243.         commands:
  1244.  
  1245.              TKEY TCUST T
  1246.          and TKEY TCUST T2
  1247.  
  1248.  
  1249.         Once the customising is complete the changes are recorded
  1250.         permanently inside the editor's .EXE file.  You no longer need
  1251.         either the TKEY program or your custom definition file, unless you
  1252.         decide to make further changes.
  1253.  
  1254.  
  1255.         4.1 THE CUSTOM DEFINITION FILE
  1256.  
  1257.         The custom definition file contains a description of the way you
  1258.         want T to be configured.  An example of a custom definition file is
  1259.         supplied with T, this is called TKEYS.DEF and contains the
  1260.         description of the default configuration.  This file serves as a
  1261.         good example of how to write a custom definition, but should be
  1262.         used for reference only.  You should create your own custom
  1263.         definition file and call it something other than TKEYS.DEF.  This
  1264.         will ensure that if you ever obtain a new copy the T package you do
  1265.         not lose any changes you made.  Of course a good way to start your
  1266.         own definition file would be to copy TKEYS.DEF under another name.
  1267.  
  1268.         The custom definition file contains four sorts of item.  Normally
  1269.         each item is placed on a new line, although one item can be split
  1270.         over several lines or several items can be placed on one line if
  1271.         desired.
  1272.  
  1273.         1. Comments.
  1274.  
  1275.  
  1276.         
  1277.                                                             Customising  14
  1278.  
  1279.  
  1280.         (C) Copyright IBM Corporation 1987, 1993
  1281.         
  1282.         
  1283.         
  1284.            Comments are ignored by the customiser program and serve to make
  1285.            the definition file more readable.  Comments come in three
  1286.            flavours:
  1287.  
  1288.            a. Anything between the comment markers /* and */.  Comments of
  1289.               this sort can extend over several lines if required.
  1290.  
  1291.            b. Anything between the comment marker // and the end of the
  1292.               line.
  1293.  
  1294.            c. Several special words and symbols are also ignored: blank
  1295.               lines, blank spaces, ON, OF, TO, IS, ; (semicolon) and =
  1296.               (equals sign)..
  1297.  
  1298.         2. Colour and Mono Commands
  1299.  
  1300.            Colour and Mono commands define the colours used for the various
  1301.            parts of the screen on different types of display.
  1302.  
  1303.         3. Key Commands
  1304.  
  1305.            Key commands assign keyboard functions or single characters to
  1306.            keys.
  1307.  
  1308.         4. Set Commands
  1309.  
  1310.            Set commands alter the editor's special settings.
  1311.  
  1312.         In the following descriptions uppercase will be used to indicate
  1313.         keywords and lowercase to indicate parameters you must enter.
  1314.         Items in angle brackets are optional.  In your custom definition
  1315.         file you may use any mixture of upper- or lowercase.
  1316.  
  1317.  
  1318.         4.1.1 COLOUR AND MONO COMMANDS
  1319.  
  1320.              COLOUR area = <attr> fgcol ON <attr> bgcol
  1321.          or  COLOR  area = <attr> fgcol ON <attr> bgcol
  1322.          or  MONO   area = <attr> style
  1323.  
  1324.  
  1325.         Colour and Mono commands define the colours that will be used for
  1326.         the various areas of the screen.  Two forms of the command can be
  1327.         used, indicated by the keywords COLOUR (spelled COLOR if you
  1328.         prefer) or MONO.  The COLOUR colours are used on colour screens and
  1329.         the MONO colours are used on monochrome screens or colour screens
  1330.         when in a black-and-white mode (this latter feature can be useful
  1331.         when a colour adapter is driving a monochrome screen, as is often
  1332.         the case with LCD portables).
  1333.  
  1334.         The following parameters should be provided:
  1335.  
  1336.         area   is an area of the screen.  It should be one of:
  1337.                    DATA LINES
  1338.                    MARK LINES
  1339.  
  1340.         
  1341.                                                             Customising  15
  1342.  
  1343.  
  1344.         (C) Copyright IBM Corporation 1987, 1993
  1345.         
  1346.         
  1347.         
  1348.                    SHOW LINES
  1349.                    SHADOW CURSOR
  1350.                    STATUS LINE
  1351.                    HELP LINE
  1352.                    MESSAGE LINE
  1353.  
  1354.                Most of these refer to the obvious screen items or areas.
  1355.                SHOW LINES refers to those lines displayed in the data area
  1356.                that are not a part of the actual document being edited (for
  1357.                example the "Top of File" marker line).
  1358.  
  1359.         attr   is one or more attributes associated with the colour or
  1360.                style it precedes.  It can be omitted if no attributes are
  1361.                required or specified as one or more of:
  1362.                    BRIGHT or LIGHT
  1363.                    BLINKING
  1364.  
  1365.         fgcol  is the foreground colour for colour displays, specified as
  1366.                one of:
  1367.                    BLACK
  1368.                    BLUE
  1369.                    GREEN
  1370.                    TURQUOISE or CYAN
  1371.                    RED
  1372.                    PINK or MAGENTA
  1373.                    BROWN
  1374.                    WHITE
  1375.                    GREY or GRAY
  1376.                    YELLOW
  1377.  
  1378.         bgcol  is the background colour for colour displays specified from
  1379.                the same choices as the foreground colours.  Only the BRIGHT
  1380.                (or LIGHT) attribute may precede the background colour.
  1381.  
  1382.         style  is the style of text used for monochrome displays specified
  1383.                as one of:
  1384.                    NORMAL
  1385.                    REVERSE
  1386.                    UNDERLINE
  1387.  
  1388.         Note: Not all combinations of attributes and colours or styles are
  1389.         meaningful or useable on all systems, although the customiser
  1390.         program may accept them.  In particular the BRIGHT attribute has no
  1391.         effect on the REVERSE style, the UNDERLINED style may not always be
  1392.         available, the colour YELLOW is the same as BRIGHT BROWN and the
  1393.         colour GREY is the same as BRIGHT BLACK.  Also note that on some
  1394.         machines a BRIGHT background will actually produce a BLINKING
  1395.         foreground instead - bear this in mind if YELLOW (i.e. BRIGHT
  1396.         BROWN) or GREY (i.e. BRIGHT BLACK) are chosen as background
  1397.         colours.
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.         
  1405.                                                             Customising  16
  1406.  
  1407.  
  1408.         (C) Copyright IBM Corporation 1987, 1993
  1409.         
  1410.         
  1411.         
  1412.         4.1.2 KEY COMMANDS
  1413.  
  1414.              KEY <shift->keyname = function
  1415.          or  DEF <shift->keyname = function
  1416.          or  KEY <shift->keyname = character
  1417.          or  DEF <shift->keyname = character
  1418.  
  1419.  
  1420.         Key commands assign the editor's keyboard functions or single ASCII
  1421.         characters to user definable keys.  The parameters are:
  1422.  
  1423.         shift-     is the shift key that must be pressed.  It is omitted
  1424.                    for unshifted keys or specified as one of:
  1425.  
  1426.                    S-  for either of the shift keys
  1427.  
  1428.                    C-  for the Ctrl key
  1429.  
  1430.                    A-  for the Alt key
  1431.  
  1432.         keyname    is chosen from:
  1433.                        A to Z
  1434.                        0 to 9
  1435.                        F1 to F12
  1436.                        - (the minus key)
  1437.                        = (the equals key)
  1438.                        [ (the open square bracket key)
  1439.                        ] (the close square bracket key)
  1440.                        \ (the backslash key)
  1441.                        ESC
  1442.                        TAB
  1443.                        BACKSPACE
  1444.                        ENTER
  1445.                        PADENTER
  1446.                        HOME
  1447.                        END
  1448.                        PGUP
  1449.                        PGDN
  1450.                        UP
  1451.                        DOWN
  1452.                        LEFT
  1453.                        RIGHT
  1454.                        INS
  1455.                        DEL
  1456.                        PAD5
  1457.  
  1458.                    Not all shift-keyname combinations are valid, and some
  1459.                    are not available for use on the older PC keyboard (the
  1460.                    one with 10 F-keys over on the left).  See "Appendix B.
  1461.                    User Definable Keys" on page 46 for a full list of
  1462.                    combinations.
  1463.  
  1464.         function   is one of the keyboard functions.  The full list of
  1465.                    keyboard functions is defined in "2.0 Keyboard
  1466.                    Functions" on page 26.
  1467.  
  1468.         
  1469.                                                             Customising  17
  1470.  
  1471.  
  1472.         (C) Copyright IBM Corporation 1987, 1993
  1473.         
  1474.         
  1475.         
  1476.         character  is a single ASCII character.  This can either be
  1477.                    specified as the character itself in quotes, or using
  1478.                    the form:
  1479.  
  1480.              ASCII nnn
  1481.  
  1482.  
  1483.                    where nnn is the character's ASCII code point.  This
  1484.                    allows characters not normally present on the keyboard
  1485.                    (such as the box drawing characters) to be assigned to
  1486.                    keys.
  1487.  
  1488.  
  1489.  
  1490.         4.1.3 SET COMMANDS
  1491.  
  1492.              SET item = value
  1493.  
  1494.  
  1495.         Set commands allow customising of the special editor settings.
  1496.         These are described in detail in "3.0 Settings" on page 36.
  1497.  
  1498.  
  1499.         4.2 THE HELP AND USER FUNCTIONS
  1500.  
  1501.         The HELP and USER keyboard functions are rather special and quite
  1502.         powerful features.  The HELP and USER functions work in an
  1503.         identical way, the fact that one is called "HELP" is only really to
  1504.         suggest a good use for the function.  Once you are familiar with
  1505.         the way T works you may decide you no longer really need a help
  1506.         system, and you can then use the HELP function for something else
  1507.         completely.
  1508.  
  1509.         The functions are defined by two items in the custom definition
  1510.         file.  Firstly the keyboard function is assigned to key, and
  1511.         secondly a T command is assigned to the function.  For example:
  1512.  
  1513.              KEY F1 = HELP
  1514.              SET HELP COMMAND = "EDIT THELP.HLP"
  1515.  
  1516.  
  1517.         In this example the HELP keyboard function is assigned to the F1
  1518.         key and the function is then assigned the command "EDIT THELP.HLP".
  1519.  
  1520.         When the HELP keyboard function is pressed (i.e. F1 is pressed)
  1521.         T will execute the assigned command, just as if it had been typed
  1522.         on the command line.  In this example it will therefore load and
  1523.         display a help file.
  1524.  
  1525.         The command that is assigned to the function can be any command
  1526.         that could be entered on the T command line, so some other useful
  1527.         applications might be:
  1528.  
  1529.         -  Use the standard T help file but locate it in the \EDITORS
  1530.            subdirectory on the C: drive:
  1531.  
  1532.         
  1533.                                                             Customising  18
  1534.  
  1535.  
  1536.         (C) Copyright IBM Corporation 1987, 1993
  1537.         
  1538.         
  1539.         
  1540.              KEY F1 = HELP
  1541.              SET HELP COMMAND = "T C:\EDITORS\THELP.HLP"
  1542.  
  1543.  
  1544.         -  Set Alt-P to print the current document to COM1:
  1545.  
  1546.              KEY A-P = USER
  1547.              SET USER COMMAND = "PRINT COM1"
  1548.  
  1549.  
  1550.         -  Set Alt-H to invoke an external HELP program for a subject
  1551.            called "T":
  1552.  
  1553.              KEY A-H = HELP
  1554.              SET HELP COMMAND = "DOS HELP T"
  1555.  
  1556.  
  1557.         -  Set the F5 key to shell out to a DOS or OS/2 command prompt:
  1558.  
  1559.              KEY F5 = USER
  1560.              SET USER COMMAND = "DOS"
  1561.  
  1562.  
  1563.  
  1564.  
  1565.         4.3 THE ENHANCED KEYBOARD
  1566.  
  1567.         Most recent PCs and all PS/2s come with IBM's Enhanced Keyboard.
  1568.         This is the keyboard with twelve function keys arranged across the
  1569.         top and an extra set of cursor control keys between the typewriter
  1570.         keys and the numeric keypad.  Older PCs and some notebook style
  1571.         machines have a keyboard with just ten function keys.  To make use
  1572.         of the extra keys on the Enhanced Keyboard a program must work in a
  1573.         different way from that which was used to handle the old-style
  1574.         keyboards, if the old-style interface is used only the subset of
  1575.         keys present on the older keyboard will be recognised.
  1576.  
  1577.         T attempts to determine which type of keyboard interface to use, so
  1578.         that if an Enhanced Keyboard is attached all its keys will be
  1579.         available.  However the tests used to decide which type of keyboard
  1580.         is present can be fooled by some non-IBM BIOSs and by some older
  1581.         TSR programs that were created before the Enhanced Keyboard was
  1582.         available.  This usually shows up as a problem when the editor
  1583.         starts: the command line becomes full of a repeated character and
  1584.         the editor hangs.
  1585.  
  1586.         In situations like these you must force T to use the old keyboard
  1587.         interface by putting this line in your custom definition file:
  1588.  
  1589.              SET KEYBOARD TYPE = STANDARD
  1590.  
  1591.  
  1592.  
  1593.  
  1594.  
  1595.  
  1596.         
  1597.                                                             Customising  19
  1598.  
  1599.  
  1600.         (C) Copyright IBM Corporation 1987, 1993
  1601.         
  1602.         
  1603.         
  1604.                                                   Part 2.  Editor Reference
  1605.  
  1606.  
  1607.  
  1608.  
  1609.  
  1610.  
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.         
  1661.                                               Part 2.  Editor Reference  20
  1662.  
  1663.  
  1664.         (C) Copyright IBM Corporation 1987, 1993
  1665.         
  1666.         
  1667.         
  1668.         1.0 COMMANDS
  1669.  
  1670.         This section describes each of the commands that may be entered on
  1671.         the T command line.  In describing the syntax of the commands,
  1672.         uppercase letters are used for the command name and lowercase
  1673.         letters for any parameters you must supply.  Optional parameters
  1674.         are enclosed in angle brackets.  Commands may actually be entered
  1675.         in any mixture of upper- or lowercase.
  1676.  
  1677.         Where the parameters call for a filename any valid DOS or OS/2 file
  1678.         name may be used.  This may include the drive letter and directory
  1679.         path if required; if none is given the current drive and directory
  1680.         will be used, following the normal conventions.  When using the
  1681.         OS/2 High Performance File System (HPFS) filenames are not limited
  1682.         to the DOS "8-dot-3" format and any upper- or lowercase characters
  1683.         used will be preserved.
  1684.  
  1685.  
  1686.         1.1 APPEND
  1687.  
  1688.              APPEND filename
  1689.  
  1690.  
  1691.         The currently marked lines are written to the file
  1692.         "filename".  The lines are added to the end of the file, preserving
  1693.         any former contents.  The file is created if it does not exist.
  1694.  
  1695.  
  1696.         1.2 CHANGE
  1697.  
  1698.              C /target/replacement</options>
  1699.  
  1700.  
  1701.         The next occurrence of the text "target" starting from the current
  1702.         cursor position, is located.  Then the message
  1703.         "Yes/No/Go/Last/Quit?" is displayed, to which you should reply with
  1704.         one of:
  1705.  
  1706.         Y  to change this instance of "target" into
  1707.            "replacement".  The next occurrence of "target" is then found
  1708.            and the process repeats.
  1709.  
  1710.         N  to not change this instance of "target", but to continue
  1711.            searching for the next occurrence.
  1712.  
  1713.         G  to change this instance of "target" into
  1714.            "replacement" and then to change all further instances (until to
  1715.            end of the document) without further prompting.
  1716.  
  1717.         L  to change this instance of "target" into
  1718.            "replacement" and then to stop the command, so this becomes the
  1719.            last change made.
  1720.  
  1721.         Q  to stop the change command without making any further changes.
  1722.  
  1723.  
  1724.         
  1725.                                                                Commands  21
  1726.  
  1727.  
  1728.         (C) Copyright IBM Corporation 1987, 1993
  1729.         
  1730.         
  1731.         
  1732.         The "/" character is a delimiter and can be replaced with any
  1733.         character that does not occur in either the "target" or the
  1734.         "replacement".  Note that the delimiter is the first non-blank
  1735.         character following the C command.
  1736.  
  1737.         Following a final delimiter any of these options may be used:
  1738.  
  1739.         m  to restrict the changes to the marked lines only.
  1740.  
  1741.         *  to change all occurrences of "target" to
  1742.            "replacement" without prompting.
  1743.  
  1744.         Note: Change commands are always case-sensitive.
  1745.  
  1746.  
  1747.         1.3 DOS
  1748.  
  1749.              DOS <command>
  1750.          or  .<command>
  1751.  
  1752.  
  1753.         A secondary DOS or OS/2 shell is started to execute the
  1754.         "command".  A full stop may be used as a quick abbreviation for the
  1755.         word DOS.
  1756.  
  1757.         If no "command" is given the DOS or OS/2 command line prompt will
  1758.         appear.  You can return to T by entering the command EXIT.
  1759.  
  1760.  
  1761.         1.4 EDIT
  1762.  
  1763.              EDIT <filename>
  1764.          or  E <filename>
  1765.          or  T <filename>
  1766.  
  1767.  
  1768.         If a "filename" is given T will switch directly to display that
  1769.         document.  The file will be loaded from disk, if it is not already
  1770.         in the edit ring.
  1771.  
  1772.         If no "filename" is given the next document in the edit ring will
  1773.         be selected.
  1774.  
  1775.  
  1776.         1.5 FILE
  1777.  
  1778.              FILE <filename>
  1779.          or  F <filename>
  1780.  
  1781.  
  1782.         The current document will be saved to disk and then removed from
  1783.         the edit ring.  If a "filename" is given the document will be saved
  1784.         under this name, otherwise the name shown on the status line will
  1785.         be used.
  1786.  
  1787.  
  1788.         
  1789.                                                                Commands  22
  1790.  
  1791.  
  1792.         (C) Copyright IBM Corporation 1987, 1993
  1793.         
  1794.         
  1795.         
  1796.         1.6 GET
  1797.  
  1798.              GET filename
  1799.  
  1800.  
  1801.         The contents of "filename" will be inserted into the current
  1802.         document following the current line.
  1803.  
  1804.  
  1805.         1.7 GOTO
  1806.  
  1807.              GOTO linenum
  1808.          or  linenum
  1809.  
  1810.  
  1811.         Line number "linenum" will become the current line and will be
  1812.         displayed on the focus line.  If "linenum" is bigger than the
  1813.         number of lines in the document the last line will become the
  1814.         current line.  The word GOTO is optional, just entering the
  1815.         required "linenum" on the command line is sufficient.
  1816.  
  1817.  
  1818.         1.8 LOCATE
  1819.  
  1820.              L /target</options>
  1821.          or  /target</options>
  1822.  
  1823.  
  1824.         The next occurrence of the text "target", starting from the current
  1825.         cursor position, will be located and displayed on the focus line.
  1826.         If the "L /target" form of the command is used the delimiter,
  1827.         "/", may be replaced by any character that does not occur in
  1828.         "target".
  1829.  
  1830.         Following a final delimiter any of these options may be used:
  1831.  
  1832.         m  to restrict the search to the marked lines only.
  1833.  
  1834.         e  to force an exact-case match.
  1835.  
  1836.         c  to force an any-case match.  (Apologies to non-English speakers:
  1837.            only the 26 letters "a" to "z" are correctly handled.)
  1838.  
  1839.         Note: if neither e nor c is given the editor's EXACT MATCH setting
  1840.         is used.  This may be customised - refer to "4.0 Customising" on
  1841.         page 14 for more details.
  1842.  
  1843.  
  1844.         1.9 MARGIN
  1845.  
  1846.              MARGIN column
  1847.          or  M column
  1848.  
  1849.  
  1850.  
  1851.  
  1852.         
  1853.                                                                Commands  23
  1854.  
  1855.  
  1856.         (C) Copyright IBM Corporation 1987, 1993
  1857.         
  1858.         
  1859.         
  1860.         The right hand margin will be set to "column".  To remove the right
  1861.         hand margin enter a column value of zero.  The margin column is
  1862.         displayed on the status line in the form "M nnn".
  1863.  
  1864.         The margin is used by the word-spill features: as words are typed
  1865.         across the margin column they are automatically spilled onto the
  1866.         next line.  It is also used by the ADJUST LINE keyboard function
  1867.         (see "3.4 Word Processing" on page 10).
  1868.  
  1869.  
  1870.         1.10 NAME
  1871.  
  1872.              NAME <name>
  1873.          or  N <name>
  1874.  
  1875.  
  1876.         The current document will be renamed to "name".
  1877.  
  1878.  
  1879.         1.11 PRINT
  1880.  
  1881.              PRINT <device>
  1882.  
  1883.  
  1884.         The current document will be printed.  It is printed to the named
  1885.         "device", if one is specified, otherwise the device PRN is used.
  1886.  
  1887.  
  1888.         1.12 PUT
  1889.  
  1890.             PUT filename
  1891.  
  1892.  
  1893.         The currently marked lines will be written to the file
  1894.         "filename".  Any former contents of the file are lost.
  1895.  
  1896.         Note: The marked lines can be printed using the command PUT PRN.
  1897.  
  1898.  
  1899.         1.13 QUIT
  1900.  
  1901.              QUIT <ALL>
  1902.          or  Q <ALL>
  1903.  
  1904.  
  1905.         If used without the "ALL" parameter the current document will be
  1906.         removed from the edit ring.  It will not be saved to disk.  If any
  1907.         changes have been made, since the document was last saved, the
  1908.         message "Throw away changes? (y/n)" is displayed; hit either Y or N
  1909.         as appropriate.
  1910.  
  1911.         If the "ALL" parameter is specified all the current documents will
  1912.         be discarded without saving any changes and the editor will end and
  1913.         return to the operating system.  This parameter should be used with
  1914.         care.
  1915.  
  1916.         
  1917.                                                                Commands  24
  1918.  
  1919.  
  1920.         (C) Copyright IBM Corporation 1987, 1993
  1921.         
  1922.         
  1923.         
  1924.         1.14 SAVE
  1925.  
  1926.              SAVE <filename>
  1927.          or  S <filename>
  1928.  
  1929.  
  1930.         The current document will be saved to disk.  If a
  1931.         "filename" is given the document will be saved under this name,
  1932.         otherwise the name shown on the status line will be used.
  1933.  
  1934.  
  1935.         1.15 VERSION
  1936.  
  1937.              VER
  1938.  
  1939.  
  1940.         The T name, version number and copyright notice will be displayed.
  1941.  
  1942.  
  1943.  
  1944.  
  1945.  
  1946.  
  1947.  
  1948.  
  1949.  
  1950.  
  1951.  
  1952.  
  1953.  
  1954.  
  1955.  
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.         
  1981.                                                                Commands  25
  1982.  
  1983.  
  1984.         (C) Copyright IBM Corporation 1987, 1993
  1985.         
  1986.         
  1987.         
  1988.         2.0 KEYBOARD FUNCTIONS
  1989.  
  1990.         This section describes each of the keyboard functions that are
  1991.         available to the editor.  Keyboard functions are invoked by
  1992.         pressing the key to which they have been assigned.  This assignment
  1993.         is made in a custom definition file using entries of the form:
  1994.  
  1995.              KEY key = function
  1996.          or  DEF key = function
  1997.  
  1998.  
  1999.         The descriptions which follow include the default key to which the
  2000.         function is assigned.
  2001.  
  2002.  
  2003.         2.1 ADJUST LINE
  2004.  
  2005.         Default key: Alt-A
  2006.  
  2007.         Adjusts the current line to the right hand margin setting.  If the
  2008.         line extends beyond the margin it is split; if it does not reach
  2009.         the margin it is filled with words from the next line.  If a split
  2010.         occurs and the special setting AUTOMATIC INDENT is ON (see "3.0
  2011.         Settings" on page 36), the split-off portion will align under the
  2012.         first non-blank character of the previous line.
  2013.  
  2014.         ADJUST LINE will ignore blank lines and, when a line is split, the
  2015.         cursor will move to the split-off portion.  This makes it
  2016.         particularly simple to re-adjust a paragraph after making changes
  2017.         or altering the right hand margin.
  2018.  
  2019.  
  2020.         2.2 BACKSPACE
  2021.  
  2022.         Default key: Backspace
  2023.  
  2024.         Deletes the character to the left of the cursor, and moves the
  2025.         cursor one character to the left.
  2026.  
  2027.  
  2028.         2.3 CLEAR MARK
  2029.  
  2030.         Default key: Alt-U
  2031.  
  2032.         Un-marks any marked lines.
  2033.  
  2034.  
  2035.         2.4 COMMAND TOGGLE
  2036.  
  2037.         Default key: Esc
  2038.  
  2039.         Switches the cursor between the command line and the data area.
  2040.         When the cursor is on the command line a shadow cursor marks the
  2041.         current position in the data.
  2042.  
  2043.  
  2044.         
  2045.                                                      Keyboard Functions  26
  2046.  
  2047.  
  2048.         (C) Copyright IBM Corporation 1987, 1993
  2049.         
  2050.         
  2051.         
  2052.         2.5 COPY MARK
  2053.  
  2054.         Default key: Alt-C
  2055.  
  2056.         Inserts a copy the marked lines following the current line.  If
  2057.         there are several documents in the edit ring this may be used to
  2058.         copy lines from one document to another.
  2059.  
  2060.  
  2061.         2.6 DELETE CHARACTER
  2062.  
  2063.         Default key: Del
  2064.  
  2065.         Deletes the character at the cursor.
  2066.  
  2067.  
  2068.         2.7 DELETE LINE
  2069.  
  2070.         Default key: Ctrl-Backspace
  2071.  
  2072.         Deletes the current line.
  2073.  
  2074.  
  2075.         2.8 DELETE MARK
  2076.  
  2077.         Default key: Alt-D
  2078.  
  2079.         Deletes the marked lines.
  2080.  
  2081.  
  2082.         2.9 DOWN
  2083.  
  2084.         Default key: Down
  2085.  
  2086.         Moves the cursor down one line.
  2087.  
  2088.  
  2089.         2.10 EDIT
  2090.  
  2091.         Default key: F8
  2092.  
  2093.         Switches to the command line and keys in the command EDIT, ready
  2094.         for you to enter a filename.
  2095.  
  2096.  
  2097.         2.11 END OF FILE
  2098.  
  2099.         Default key: Ctrl-End
  2100.  
  2101.         Makes the current line the last line in the document, and positions
  2102.         this line at the bottom of the screen.
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.         
  2109.                                                      Keyboard Functions  27
  2110.  
  2111.  
  2112.         (C) Copyright IBM Corporation 1987, 1993
  2113.         
  2114.         
  2115.         
  2116.         2.12 END OF LINE
  2117.  
  2118.         Default key: End
  2119.  
  2120.         Moves the cursor to the position one character after the last
  2121.         character on the current line.
  2122.  
  2123.  
  2124.         2.13 END OF MARK
  2125.  
  2126.         Default key: Alt-E
  2127.  
  2128.         Makes the current line the last marked line, and positions this
  2129.         line on the focus line.  If the marked lines are in a different
  2130.         document that document will become the current document.
  2131.  
  2132.  
  2133.         2.14 END OF SCREEN
  2134.  
  2135.         Default key: Ctrl-PgDn
  2136.  
  2137.         Moves the cursor to the last line of the document on the screen.
  2138.  
  2139.  
  2140.         2.15 ESCAPE
  2141.  
  2142.         Default key: Alt-X
  2143.  
  2144.         This allows the entry of ASCII characters using keys on the
  2145.         keyboard that would normally perform a function.  Typically this is
  2146.         useful when entering printer control codes into a document.
  2147.  
  2148.         For example to enter the ASCII "Esc" character first use the
  2149.         ESCAPE function then press the Esc key.
  2150.  
  2151.         It is also possible to enter any ASCII character from 1 to 255
  2152.         using the numeric keypad on the right of the keyboard.  Press and
  2153.         hold the Alt key then type the decimal ASCII value on the keypad,
  2154.         release the Alt key and the character will appear.  Using the
  2155.         keypad in this way does not require the ESCAPEfunction.
  2156.  
  2157.         Note: To enter an ASCII NUL (character code 0) use the Ctrl-2 key.
  2158.  
  2159.  
  2160.         2.16 FILE
  2161.  
  2162.         Default key: None
  2163.  
  2164.         Writes the current document to disk using the name shown on the
  2165.         status line, then removes the document from the edit ring.
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.         
  2173.                                                      Keyboard Functions  28
  2174.  
  2175.  
  2176.         (C) Copyright IBM Corporation 1987, 1993
  2177.         
  2178.         
  2179.         
  2180.         2.17 FOCUS
  2181.  
  2182.         Default key: F12
  2183.  
  2184.         This places the current line onto the defined screen focus line.
  2185.         The focus line is defined by the special setting FOCUS LINE (see
  2186.         "3.0 Settings" on page 36).
  2187.  
  2188.  
  2189.         2.18 HELP
  2190.  
  2191.         Default key: F1
  2192.  
  2193.         Causes the command specified by the special setting HELP COMMAND
  2194.         (see "3.0 Settings" on page 36) to be executed.  Refer to "4.2 The
  2195.         HELP and USER Functions" on page 18 for more details about using
  2196.         the HELP function.
  2197.  
  2198.  
  2199.         2.19 INSERT LINE
  2200.  
  2201.         Default key: Ctrl-Enter and Ctrl-PadEnter
  2202.  
  2203.         Inserts a new blank line following the current line.  If the
  2204.         special setting AUTOMATIC INDENT is ON the cursor will be aligned
  2205.         under the first non-blank character of the preceding line.
  2206.  
  2207.  
  2208.         2.20 INSERT TOGGLE
  2209.  
  2210.         Default key: Ins
  2211.  
  2212.         Toggles the editor between "insert" and "replace" modes.  The shape
  2213.         of the cursor and the Rep/Ins indicator on the status line show
  2214.         which mode is active.
  2215.  
  2216.  
  2217.         2.21 JOIN LINE
  2218.  
  2219.         Default key: Alt-J
  2220.  
  2221.         Joins together the current line and the following line.  The lines
  2222.         are joined with a single blank between them.
  2223.  
  2224.  
  2225.         2.22 LEFT
  2226.  
  2227.         Default key: Left
  2228.  
  2229.         Moves the cursor one character to the left.
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.         
  2237.                                                      Keyboard Functions  29
  2238.  
  2239.  
  2240.         (C) Copyright IBM Corporation 1987, 1993
  2241.         
  2242.         
  2243.         
  2244.         2.23 MARK LEFT
  2245.  
  2246.         Default key: Shift-F7
  2247.  
  2248.         The marked lines are shifted one character to the left.  Only the
  2249.         characters to the right of the cursor position are shifted, so if
  2250.         you want to shift the whole line be sure to first position the
  2251.         cursor at the left hand edge.  Any characters moved to the left of
  2252.         the cursor column are lost.
  2253.  
  2254.  
  2255.         2.24 MARK RIGHT
  2256.  
  2257.         Default key: Shift-F8
  2258.  
  2259.         The marked lines are shifted one character to the right.  Only the
  2260.         characters to the right of the cursor position are shifted, so if
  2261.         you want to shift the whole line be sure to first position the
  2262.         cursor at the left hand edge.
  2263.  
  2264.  
  2265.         2.25 MOVE MARK
  2266.  
  2267.         Default key: Alt-M
  2268.  
  2269.         Moves the marked lines so they come after the current line.  If
  2270.         there are several documents in the edit ring this may be used to
  2271.         move lines from one document to another.
  2272.  
  2273.  
  2274.         2.26 NAME
  2275.  
  2276.         Default key: F7
  2277.  
  2278.         Switches to the command line and keys in the command NAME, ready
  2279.         for you to enter a new document name.
  2280.  
  2281.  
  2282.         2.27 NEW LINE
  2283.  
  2284.         Default key: Enter
  2285.  
  2286.         If in "insert" mode this will perform an INSERT LINE function, if
  2287.         in "replace" mode it will perform a NEXT LINE function.
  2288.  
  2289.  
  2290.         2.28 NEXT FILE
  2291.  
  2292.         Default key: F10
  2293.  
  2294.         Makes the next document in the edit ring the current document.
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.         
  2301.                                                      Keyboard Functions  30
  2302.  
  2303.  
  2304.         (C) Copyright IBM Corporation 1987, 1993
  2305.         
  2306.         
  2307.         
  2308.         2.29 NEXT LINE
  2309.  
  2310.         Default key: PadEnter
  2311.  
  2312.         Moves the cursor to the start of the next line in the document.
  2313.  
  2314.  
  2315.         2.30 NEXT TAB
  2316.  
  2317.         Default key: Tab
  2318.  
  2319.         Moves the cursor right to the next tab stop.  Tab stops are defined
  2320.         by the special setting TAB SPACING (see "3.0 Settings" on page 36).
  2321.  
  2322.  
  2323.         2.31 NEXT WORD
  2324.  
  2325.         Default key: Ctrl-Right
  2326.  
  2327.         Moves the cursor to the first character of the next word on the
  2328.         line.  A word is considered to be sequence of non-blank characters.
  2329.  
  2330.  
  2331.         2.32 NOTHING
  2332.  
  2333.         This function does nothing.  It is used when customising the editor
  2334.         to remove the default function from a key.
  2335.  
  2336.  
  2337.         2.33 PAGE DOWN
  2338.  
  2339.         Default key: PgDn
  2340.  
  2341.         Scrolls the current document down by one screen-full.
  2342.  
  2343.  
  2344.         2.34 PAGE UP
  2345.  
  2346.         Default key: PgUp
  2347.  
  2348.         Scrolls the current document up by one screen-full.
  2349.  
  2350.  
  2351.         2.35 PREVIOUS FILE
  2352.  
  2353.         Default keys: F11
  2354.  
  2355.         Makes the previous document in the edit ring the current document.
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.  
  2363.  
  2364.         
  2365.                                                      Keyboard Functions  31
  2366.  
  2367.  
  2368.         (C) Copyright IBM Corporation 1987, 1993
  2369.         
  2370.         
  2371.         
  2372.         2.36 PREVIOUS TAB
  2373.  
  2374.         Default key: Shift-Tab
  2375.  
  2376.         Moves the cursor left to the previous tab stop.  Tab stops are
  2377.         defined by the special setting TAB SPACING (see "3.0 Settings" on
  2378.         page 36).
  2379.  
  2380.  
  2381.         2.37 PREVIOUS WORD
  2382.  
  2383.         Default key: Ctrl-Left
  2384.  
  2385.         Moves the cursor to the first character of the previous word on the
  2386.         line.  A word is considered to be sequence of non-blank characters.
  2387.  
  2388.  
  2389.         2.38 QUIT
  2390.  
  2391.         Default key: F3
  2392.  
  2393.         Removes the current document from the edit ring.  If changes have
  2394.         been made to the document since it was last saved the message
  2395.         "Throw away changes? (y/n)" is displayed; hit either Y or N as
  2396.         appropriate.
  2397.  
  2398.  
  2399.         2.39 REPEAT FIND
  2400.  
  2401.         Default key: Alt-F
  2402.  
  2403.         Repeats the last LOCATE command that was issued.
  2404.  
  2405.  
  2406.         2.40 REPEAT LINE
  2407.  
  2408.         Default key: Alt-R
  2409.  
  2410.         Inserts a copy of the current line immediately following the
  2411.         current line.
  2412.  
  2413.  
  2414.         2.41 RIGHT
  2415.  
  2416.         Default key: Right
  2417.  
  2418.         Moves the cursor one character to the right.
  2419.  
  2420.  
  2421.         2.42 SAFE FILE
  2422.  
  2423.         Default key: F4
  2424.  
  2425.         If the document has changed this performs the FILEfunction, if the
  2426.         document has not changed it performs a QUIT.
  2427.  
  2428.         
  2429.                                                      Keyboard Functions  32
  2430.  
  2431.  
  2432.         (C) Copyright IBM Corporation 1987, 1993
  2433.         
  2434.         
  2435.         
  2436.         2.43 SAVE
  2437.  
  2438.         Default key: F2
  2439.  
  2440.         Writes the current document to disk under the name shown on the
  2441.         status line.
  2442.  
  2443.  
  2444.         2.44 SCROLL DOWN
  2445.  
  2446.         Default key: Shift-F4
  2447.  
  2448.         Scrolls the entire screen down by one line.
  2449.  
  2450.  
  2451.         2.45 SCROLL LEFT
  2452.  
  2453.         Default key: Shift-F1
  2454.  
  2455.         Scrolls the entire screen left by one character.
  2456.  
  2457.  
  2458.         2.46 SCROLL RIGHT
  2459.  
  2460.         Default key: Shift-F2
  2461.  
  2462.         Scrolls the entire screen right by one character.
  2463.  
  2464.  
  2465.         2.47 SCROLL UP
  2466.  
  2467.         Default key: Shift-F3
  2468.  
  2469.         Scrolls the entire screen up by one line.
  2470.  
  2471.  
  2472.         2.48 SET MARK
  2473.  
  2474.         Default key: Alt-L
  2475.  
  2476.         Marks one or more lines thus:
  2477.  
  2478.         -  If no lines are marked the current line only is marked.
  2479.  
  2480.         -  If one or more lines are already marked and the current line is
  2481.            outside the mark, the mark is extended to include the current
  2482.            line.
  2483.  
  2484.         -  If one or more lines are already marked and the current line is
  2485.            inside the mark, the mark is shrunk so the current line becomes
  2486.            the bottom of the mark.
  2487.  
  2488.  
  2489.  
  2490.  
  2491.  
  2492.         
  2493.                                                      Keyboard Functions  33
  2494.  
  2495.  
  2496.         (C) Copyright IBM Corporation 1987, 1993
  2497.         
  2498.         
  2499.         
  2500.         2.49 SPLIT LINE
  2501.  
  2502.         Default key: Alt-S
  2503.  
  2504.         Splits the current line into two at the cursor position.  If the
  2505.         special setting AUTOMATIC INDENT is ON the split-off portion aligns
  2506.         under the first non-blank character of the preceding line.
  2507.  
  2508.  
  2509.         2.50 START OF LINE
  2510.  
  2511.         Default key: Home
  2512.  
  2513.         Moves the cursor to the beginning of the current line.
  2514.  
  2515.  
  2516.         2.51 TOP OF FILE
  2517.  
  2518.         Default key: Ctrl-Home
  2519.  
  2520.         Makes the current line the first line in the document, and
  2521.         positions this line at the top of the screen.
  2522.  
  2523.  
  2524.         2.52 TOP OF MARK
  2525.  
  2526.         Default key: Alt-Y
  2527.  
  2528.         Makes the current line the first marked line.  If the marked lines
  2529.         are in a different document that document will become the current
  2530.         document.
  2531.  
  2532.  
  2533.         2.53 TOP OF SCREEN
  2534.  
  2535.         Default key: Ctrl-PgUp
  2536.  
  2537.         Moves the cursor to the first line of the document on the screen.
  2538.  
  2539.  
  2540.         2.54 TRUNCATE LINE
  2541.  
  2542.         Default keys: Alt-T
  2543.  
  2544.         Deletes all the characters on the current line to the right of the
  2545.         cursor.
  2546.  
  2547.  
  2548.         2.55 UNDO
  2549.  
  2550.         Default key: F9
  2551.  
  2552.         Provides a very limited error recovery.  Any changes made to the
  2553.         current line are undone.
  2554.  
  2555.  
  2556.         
  2557.                                                      Keyboard Functions  34
  2558.  
  2559.  
  2560.         (C) Copyright IBM Corporation 1987, 1993
  2561.         
  2562.         
  2563.         
  2564.         2.56 UP
  2565.  
  2566.         Default key: Up
  2567.  
  2568.         Moves the cursor up one line.
  2569.  
  2570.  
  2571.         2.57 USER
  2572.  
  2573.         Default key: F5
  2574.  
  2575.         Causes the command specified by the special setting USER COMMAND
  2576.         (see "3.0 Settings" on page 36) to be executed.  Refer to "4.2 The
  2577.         HELP and USER Functions" on page 18 for more information about the
  2578.         USER function.
  2579.  
  2580.  
  2581.  
  2582.  
  2583.  
  2584.  
  2585.  
  2586.  
  2587.  
  2588.  
  2589.  
  2590.  
  2591.  
  2592.  
  2593.  
  2594.  
  2595.  
  2596.  
  2597.  
  2598.  
  2599.  
  2600.  
  2601.  
  2602.  
  2603.  
  2604.  
  2605.  
  2606.  
  2607.  
  2608.  
  2609.  
  2610.  
  2611.  
  2612.  
  2613.  
  2614.  
  2615.  
  2616.  
  2617.  
  2618.  
  2619.  
  2620.         
  2621.                                                      Keyboard Functions  35
  2622.  
  2623.  
  2624.         (C) Copyright IBM Corporation 1987, 1993
  2625.         
  2626.         
  2627.         
  2628.         3.0 SETTINGS
  2629.  
  2630.         This section describes each of the special settings that may be
  2631.         defined when customising the editor.  These are entered in a custom
  2632.         definition file using entries of the form:
  2633.  
  2634.              SET item = value
  2635.  
  2636.  
  2637.  
  2638.  
  2639.         3.1 AUTOMATIC INDENT
  2640.  
  2641.              SET AUTOMATIC INDENT = ON
  2642.          or  SET AUTOMATIC INDENT = OFF
  2643.  
  2644.  
  2645.         This defines what the cursor will do when a new line is inserted.
  2646.         If it is set ON the cursor will be automatically indented so it
  2647.         aligns under the first non-blank character of the preceding line.
  2648.         If it is set OFF the cursor will always move to the left hand edge.
  2649.  
  2650.         The action of word-spill and the functions SPLIT LINE and ADJUST
  2651.         LINE are also affected by this setting.
  2652.  
  2653.  
  2654.         3.2 CGA SNOW
  2655.  
  2656.              SET CGA SNOW = ON
  2657.          or  SET CGA SNOW = OFF
  2658.  
  2659.  
  2660.         The old CGA card for the PC can produce "snow" on the display if
  2661.         the display is updated at the wrong times.  This can be eliminated
  2662.         but at the expense of slowing down scrolling speed.  When set to
  2663.         OFF T will look for the presence of the old CGA card and if it
  2664.         finds one it will ensure the snow does not occur.  When set to ON
  2665.         T will not attempt to eliminate the snow.
  2666.  
  2667.         Some types of display may appear to T as the old CGA adapter when
  2668.         in fact they are not and so could never create the snow problem.
  2669.         This is true for PCJrs, 3270PCs, some clone displays and the LCD
  2670.         displays found on many older laptops.  When using one of these
  2671.         displays setting CGA SNOW to ON may improve scrolling speed
  2672.         somewhat.
  2673.  
  2674.         This setting is ignored if a more recent display adapter (EGA, VGA,
  2675.         SVGA etc.) is installed, since these can never suffer from the
  2676.         "snow" problem.
  2677.  
  2678.  
  2679.  
  2680.  
  2681.  
  2682.  
  2683.  
  2684.         
  2685.                                                                Settings  36
  2686.  
  2687.  
  2688.         (C) Copyright IBM Corporation 1987, 1993
  2689.         
  2690.         
  2691.         
  2692.         3.3 COMMAND RECALL
  2693.  
  2694.              SET COMMAND RECALL = ON
  2695.          or  SET COMMAND RECALL = OFF
  2696.  
  2697.  
  2698.         This specifies whether or not previous command line commands will
  2699.         be kept available for recall by the cursor up and cursor down keys.
  2700.         If it is set ON command line commands are saved, if it is set OFF
  2701.         commands cannot be recalled.
  2702.  
  2703.  
  2704.         3.4 COMMAND TOGGLE
  2705.  
  2706.              SET COMMAND TOGGLE = DATA
  2707.          or  SET COMMAND TOGGLE = COMMAND
  2708.  
  2709.  
  2710.         This determines whether, when a new document is loaded, the cursor
  2711.         starts in the data area or on the command line.
  2712.  
  2713.  
  2714.         3.5 EXACT MATCH
  2715.  
  2716.              SET EXACT MATCH = ON
  2717.          or  SET EXACT MATCH = OFF
  2718.  
  2719.  
  2720.         This determines whether, by default, LOCATE commands take account
  2721.         of upper and lower case during searching.  If set ON the search
  2722.         must match exactly, if set OFF upper and lower case are considered
  2723.         identical.  The default can always be overridden with the locate
  2724.         command options "e" or "c".
  2725.  
  2726.         Note: Exact case match searches are very much faster and would be
  2727.         preferable when searching large documents.
  2728.  
  2729.  
  2730.         3.6 FOCUS LINE
  2731.  
  2732.              SET FOCUS LINE = row
  2733.          or  SET FOCUS LINE = -row
  2734.          or  SET FOCUS LINE = OFF
  2735.  
  2736.  
  2737.         The FOCUS LINE is the line within the data area that is used to
  2738.         display the current line when the FOCUS keyboard function is used.
  2739.         It is also the line used to display the result of a LOCATE or GOTO
  2740.         command.  The line may be specified as a positive number from the
  2741.         top of the screen or a negative number from the bottom of the
  2742.         screen.
  2743.  
  2744.         If set to OFF no focus row is defined.  The FOCUS function will
  2745.         have no effect and the target of LOCATE and GOTO commands will be
  2746.         displayed on whatever line currently contains the cursor.
  2747.  
  2748.         
  2749.                                                                Settings  37
  2750.  
  2751.  
  2752.         (C) Copyright IBM Corporation 1987, 1993
  2753.         
  2754.         
  2755.         
  2756.         3.7 HELP COMMAND
  2757.  
  2758.              SET HELP COMMAND = command
  2759.  
  2760.  
  2761.         The "command" should be a enclosed in single or double quotes.  It
  2762.         is the T command that will be executed when the HELP keyboard
  2763.         function is pressed.  Any valid T command can be given.
  2764.  
  2765.         For example:
  2766.  
  2767.              SET HELP COMMAND = "T THELP.HLP"
  2768.  
  2769.  
  2770.  
  2771.  
  2772.         3.8 HELP LINE
  2773.  
  2774.              SET HELP LINE = text
  2775.  
  2776.  
  2777.         The "text" should be enclosed in single or double quotes.  It is
  2778.         the text that will be displayed on the bottom line of the screen
  2779.         when there are no messages.
  2780.  
  2781.         Several "text" strings may be specified and they will concatenated
  2782.         together, this can be useful if you want to split the text over
  2783.         more than one line.
  2784.  
  2785.         For example:
  2786.  
  2787.              SET HELP LINE = "F1=Help F2=Save F3=Quit"
  2788.  
  2789.  
  2790.  
  2791.  
  2792.         3.9 INSERT CURSOR
  2793.  
  2794.              SET INSERT CURSOR = LINE
  2795.          or  SET INSERT CURSOR = HALF
  2796.          or  SET INSERT CURSOR = FULL
  2797.  
  2798.  
  2799.         This sets the shape of the cursor that is used when T is in
  2800.         "insert" typing mode.  LINE uses an underscore line cursor, HALF
  2801.         uses a half-height character block and FULL uses a full-height
  2802.         character block.
  2803.  
  2804.  
  2805.         3.10 INSERT TOGGLE
  2806.  
  2807.              SET INSERT TOGGLE = REPLACE
  2808.          or  SET INSERT TOGGLE = INSERT
  2809.  
  2810.  
  2811.  
  2812.         
  2813.                                                                Settings  38
  2814.  
  2815.  
  2816.         (C) Copyright IBM Corporation 1987, 1993
  2817.         
  2818.         
  2819.         
  2820.         This determines whether T initially starts up in "insert" or
  2821.         "replace" mode.
  2822.  
  2823.  
  2824.         3.11 KEYBOARD TYPE
  2825.  
  2826.              SET KEYBOARD TYPE = DEFAULT
  2827.          or  SET KEYBOARD TYPE = STANDARD
  2828.  
  2829.  
  2830.         If set to DEFAULT T will test if an Enhanced Keyboard (with 12
  2831.         F-keys across the top) is installed and if it finds one it will
  2832.         automatically make full use of it.
  2833.  
  2834.         If set to STANDARD T will assume the keyboard is an old style
  2835.         keyboard (with 10 F-keys over on the left).  This provides
  2836.         compatibility with some clone BIOSs and with some older TSR
  2837.         programs, but loses the ability to use the newer keys like F11 and
  2838.         F12.  See "4.3 The Enhanced Keyboard" on page 19 for more details.
  2839.  
  2840.  
  2841.         3.12 LINE END
  2842.  
  2843.              SET LINE END = DEFAULT
  2844.          or  SET LINE END = DOS
  2845.          or  SET LINE END = UNIX
  2846.  
  2847.  
  2848.         This determines how line ends will be interpreted when files are
  2849.         read from and written to disk.  If set to DOS line ends are
  2850.         indicated by the pair of characters hex 0D (carriage return)
  2851.         followed by hex 0A (line feed), as is the standard for DOS
  2852.         applications.  If set to UNIX lines ends are indicated by the
  2853.         single character hex 0A (new line), as is the standard for UNIX
  2854.         applications.
  2855.  
  2856.         When set to DEFAULT, T will read both DOS and UNIX style files and
  2857.         will always write DOS style files.
  2858.  
  2859.  
  2860.         3.13 REPLACE CURSOR
  2861.  
  2862.              SET REPLACE CURSOR = LINE
  2863.          or  SET REPLACE CURSOR = HALF
  2864.          or  SET REPLACE CURSOR = FULL
  2865.  
  2866.  
  2867.         This sets the shape of the cursor that is used when T is in
  2868.         "replace" typing mode.  LINE uses an underscore line cursor, HALF
  2869.         uses a half-height character block and FULL uses a full-height
  2870.         character block.
  2871.  
  2872.  
  2873.  
  2874.  
  2875.  
  2876.         
  2877.                                                                Settings  39
  2878.  
  2879.  
  2880.         (C) Copyright IBM Corporation 1987, 1993
  2881.         
  2882.         
  2883.         
  2884.         3.14 RIGHT MARGIN
  2885.  
  2886.              SET RIGHT MARGIN = column
  2887.          or  SET RIGHT MARGIN = OFF
  2888.  
  2889.  
  2890.         This sets an initial right hand margin column.  See "3.4 Word
  2891.         Processing" on page 10 for details about the function of the
  2892.         margin.  If set to OFF no initial margin is set.
  2893.  
  2894.  
  2895.         3.15 SEGMENT SIZE
  2896.  
  2897.              SET SEGMENT SIZE = DEFAULT
  2898.          or  SET SEGMENT SIZE = size
  2899.  
  2900.  
  2901.         This determines the size of the storage segments that T obtains
  2902.         from the operating system.  It should be set to a number between 8
  2903.         and 64 which specifies the segment size in K-bytes, or to DEFAULT
  2904.         which gives the best size for the operating system.  In turn this
  2905.         segment size determines the maximum line length that can be
  2906.         handled; the maximum being a few bytes less than the segment size.
  2907.  
  2908.         In general DOS works best with smaller segment sizes and OS/2 works
  2909.         better with larger sizes.  Setting DEFAULT will provide 8K segments
  2910.         under DOS and 64K under OS/2.
  2911.  
  2912.  
  2913.         3.16 TAB EXPAND
  2914.  
  2915.              SET TAB EXPAND = ON
  2916.          or  SET TAB EXPAND = OFF
  2917.  
  2918.  
  2919.         This setting determines how T will treat tab characters in
  2920.         documents that are read from disk.  If set ON tabs will be expanded
  2921.         with spaces up to the next tab stop (as determined by the TAB
  2922.         SPACING setting).  If set OFF tabs are treated just like any other
  2923.         character.
  2924.  
  2925.         Note: If set ON the tabs are expanded to spaces as the document is
  2926.         loaded from disk and are then discarded.  If the document is saved
  2927.         it will not contain the original tab characters.
  2928.  
  2929.  
  2930.         3.17 TAB SPACING
  2931.  
  2932.              SET TAB SPACING = number
  2933.  
  2934.  
  2935.         Tabs are equally spaced across the document starting from column 1.
  2936.         The spacing is set with this option.
  2937.  
  2938.  
  2939.  
  2940.         
  2941.                                                                Settings  40
  2942.  
  2943.  
  2944.         (C) Copyright IBM Corporation 1987, 1993
  2945.         
  2946.         
  2947.         
  2948.         For example:
  2949.  
  2950.              SET TAB SPACING = 8
  2951.  
  2952.  
  2953.  
  2954.  
  2955.         3.18 USER COMMAND
  2956.  
  2957.              SET USER COMMAND = command
  2958.  
  2959.  
  2960.         The "command" should be enclosed in single or double quotes.  It is
  2961.         the T command that will be executed when the USER keyboard function
  2962.         is pressed.  Any valid T command can given.
  2963.  
  2964.         For example:
  2965.  
  2966.              SET USER COMMAND = "DOS"
  2967.  
  2968.  
  2969.  
  2970.  
  2971.  
  2972.  
  2973.  
  2974.  
  2975.  
  2976.  
  2977.  
  2978.  
  2979.  
  2980.  
  2981.  
  2982.  
  2983.  
  2984.  
  2985.  
  2986.  
  2987.  
  2988.  
  2989.  
  2990.  
  2991.  
  2992.  
  2993.  
  2994.  
  2995.  
  2996.  
  2997.  
  2998.  
  2999.  
  3000.  
  3001.  
  3002.  
  3003.  
  3004.         
  3005.                                                                Settings  41
  3006.  
  3007.  
  3008.         (C) Copyright IBM Corporation 1987, 1993
  3009.         
  3010.         
  3011.         
  3012.         APPENDIX A.  MESSAGES
  3013.  
  3014.         This section provides a list of all the messages that T produces.
  3015.         It gives the reasons for each message and the action that should be
  3016.         taken.
  3017.  
  3018.         Except where noted these messages will all be displayed in the
  3019.         editor's message line and will be removed at the next keystroke.
  3020.  
  3021.         Cannot call OS
  3022.  
  3023.         The DOS command was unable to start up a secondary DOS or OS/2
  3024.         command processor.  Normally this indicates that there is not
  3025.         enough free memory, you will have to remove some documents from the
  3026.         ring if you want to issue the DOS command.
  3027.  
  3028.         If you believe there is enough free memory and the problem still
  3029.         exists it may be that DOS cannot locate its command processor.
  3030.         From the DOS prompt issue the command SET; you should see a series
  3031.         of lines one of which is of this form indicating where your copy of
  3032.         COMMAND.COM is located:
  3033.  
  3034.              COMSPEC=d:\path\COMMAND.COM
  3035.  
  3036.  
  3037.         If this is not present or is incorrect you may need to add a SET
  3038.         COMSPEC= line to your AUTOEXEC.BAT file.
  3039.  
  3040.         Cannot open file
  3041.  
  3042.         T is unable to open the requested disk file.  Normally this means
  3043.         that the filename is invalid for some reason, perhaps it contains
  3044.         characters not valid in a file name, or perhaps it conflicts with
  3045.         the name of a device or directory already on the disk.
  3046.  
  3047.         On a diskette system it may also indicate that the diskette drive
  3048.         is not ready, perhaps it does not contain a diskette or the drive
  3049.         door is open.
  3050.  
  3051.         Error reading file
  3052.  
  3053.         An error occurred while a document was being read from disk.  This
  3054.         is rare error and might indicate there are problems with the disk.
  3055.  
  3056.         Error writing file - NOT saved
  3057.  
  3058.         An error occurred while a document was being written to disk.
  3059.         Normally this means the disk became full while the file was being
  3060.         written.  You should save the file to another disk, one that has
  3061.         enough free space.
  3062.  
  3063.         File not found
  3064.  
  3065.         You attempted to GET a file that does not exist.  Check the
  3066.         spelling of the filename, maybe the file you want is not in the
  3067.  
  3068.         
  3069.                                                   Appendix A.  Messages  42
  3070.  
  3071.  
  3072.         (C) Copyright IBM Corporation 1987, 1993
  3073.         
  3074.         
  3075.         
  3076.         current directory and so needs a drive and/or directory path
  3077.         pre-pended to it.
  3078.  
  3079.         Incorrect parameter
  3080.  
  3081.         The parameter supplied to a T command was incorrect.  For the GOTO
  3082.         and MARGIN command the parameter must be a number less than 65535,
  3083.         for the QUIT command no parameter other than ALL is valid.
  3084.  
  3085.         Line too long
  3086.  
  3087.         This message indicates an attempt was made to load or to create a
  3088.         line longer than the maximum possible line length.  If this happens
  3089.         while loading a file the load will be aborted, the document in
  3090.         memory will be incomplete so you should QUIT straight away without
  3091.         saving.  Maximum line length is affected by the SEGMENT SIZE
  3092.         special setting - refer to "3.0 Settings" on page 36 for more
  3093.         details.
  3094.  
  3095.         Loading...
  3096.  
  3097.         Displays while a document is being loaded from disk.
  3098.  
  3099.         Mark already set
  3100.  
  3101.         You tried to mark a line, but a mark already exists in another
  3102.         document in the ring, only one document at a time may contain a
  3103.         mark.  If you no longer require the other mark first use the
  3104.         function CLEAR MARK.
  3105.  
  3106.         New file
  3107.  
  3108.         You asked to edit a document that does not exist on disk.  T has
  3109.         created a new empty document with the name you specified.
  3110.  
  3111.         No filename given
  3112.  
  3113.         The commands GET, PUT and APPEND must have a filename parameter
  3114.         specified.
  3115.  
  3116.         No marked lines
  3117.  
  3118.         The commands PUT and APPEND work on the currently marked lines.
  3119.         Some lines must be marked if the command is used.
  3120.  
  3121.         No match found
  3122.  
  3123.         The "target" specified in a LOCATE or CHANGE command cannot be
  3124.         found.  Remember that these commands only search from the current
  3125.         position forwards to the end of the document.  To search from the
  3126.         top first use the function TOP OF FILE.
  3127.  
  3128.         Out of memory
  3129.  
  3130.  
  3131.  
  3132.         
  3133.                                                   Appendix A.  Messages  43
  3134.  
  3135.  
  3136.         (C) Copyright IBM Corporation 1987, 1993
  3137.         
  3138.         
  3139.         
  3140.         T has run out of memory, you should save one or more of the
  3141.         documents in the ring to make space before continuing.  Most T
  3142.         commands and functions have no effect while the "Out of memory"
  3143.         condition exists.
  3144.  
  3145.         Press any key to continue
  3146.  
  3147.         This message is printed by the secondary DOS or OS/2 command shell
  3148.         started by the DOS command.  It is produced just before the command
  3149.         shell returns to T, and allows you some time to read whatever
  3150.         output is on the screen.
  3151.  
  3152.         Printer not ready
  3153.  
  3154.         The PRINT command could not complete correctly.  This may mean the
  3155.         printer is not turned on or set online, or it is not connected, or
  3156.         that it has run out of paper.  Or any number of other reasons that
  3157.         cause printers to fail.
  3158.  
  3159.         Printing...
  3160.  
  3161.         Displays while a document is being printed.
  3162.  
  3163.         Saving...
  3164.  
  3165.         Displays while a document is being saved.
  3166.  
  3167.         Source and destination conflict
  3168.  
  3169.         You cannot move or copy marked lines on top of themselves.  Move
  3170.         the cursor out of the marked area and try again.
  3171.  
  3172.         T cannot be started
  3173.  
  3174.         This message is printed by DOS if, when T is first loaded, there is
  3175.         not enough free memory get it started.  This can happen if you have
  3176.         a lot of TSR type programs loaded or if you are nested inside
  3177.         several other applications.
  3178.  
  3179.         Throw away changes? (y/n)
  3180.  
  3181.         You tried to QUIT a document that has been changed since it was
  3182.         last saved.  This message gives you a chance to save changes if the
  3183.         QUIT was selected accidentally.
  3184.  
  3185.         Type a character...
  3186.  
  3187.         The ESCAPE function takes the next character entered on the
  3188.         keyboard as an absolute ASCII code and enters it into the document.
  3189.         While ESCAPE is waiting for this character it displays a message.
  3190.  
  3191.         Unknown command
  3192.  
  3193.         You entered a command on the command line that is not a T command.
  3194.         Check the spelling of the command, or precede it by the word DOS
  3195.  
  3196.         
  3197.                                                   Appendix A.  Messages  44
  3198.  
  3199.  
  3200.         (C) Copyright IBM Corporation 1987, 1993
  3201.         
  3202.         
  3203.         
  3204.         (or a full stop) if it is a DOS or OS/2 command rather than a T
  3205.         command.
  3206.  
  3207.         Yes/No/Go/Last/Quit?
  3208.  
  3209.         The CHANGE command issues this message when it finds its
  3210.         "target" text.  Refer to "1.2 CHANGE" on page 21 for details of the
  3211.         CHANGE command.
  3212.  
  3213.  
  3214.  
  3215.  
  3216.  
  3217.  
  3218.  
  3219.  
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.  
  3230.  
  3231.  
  3232.  
  3233.  
  3234.  
  3235.  
  3236.  
  3237.  
  3238.  
  3239.  
  3240.  
  3241.  
  3242.  
  3243.  
  3244.  
  3245.  
  3246.  
  3247.  
  3248.  
  3249.  
  3250.  
  3251.  
  3252.  
  3253.  
  3254.  
  3255.  
  3256.  
  3257.  
  3258.  
  3259.  
  3260.         
  3261.                                                   Appendix A.  Messages  45
  3262.  
  3263.  
  3264.         (C) Copyright IBM Corporation 1987, 1993
  3265.         
  3266.         
  3267.         
  3268.         APPENDIX B.  USER DEFINABLE KEYS
  3269.  
  3270.         This section lists all the valid names and combinations of the user
  3271.         definable keys that can be entered in a custom definition file.
  3272.  
  3273.         Keys shown in parentheses are only available with the Enhanced
  3274.         Keyboard.
  3275.  
  3276.         -------------------------------------------------------------------
  3277.           Table 1. Unshifted Keys
  3278.           Esc           Enter        Tab          Backspace    (PadEnter)
  3279.           F1            F2           F3           F4           F5        
  3280.           F6            F7           F8           F9           F10       
  3281.           (F11)         (F12)                                            
  3282.           Home          End          PgUp         PgDn                   
  3283.           Left          Right        Up           Down                   
  3284.           Ins           Del          (Pad5)                              
  3285.                                                                          
  3286.         -------------------------------------------------------------------
  3287.  
  3288.         -------------------------------------------------------------------
  3289.           Table 2. Shift Keys
  3290.           s-Tab                                                          
  3291.           s-F1          s-F2         s-F3         s-F4         s-F5      
  3292.           s-F6          s-F7         s-F8         s-F9         s-F10     
  3293.           (s-F11)       (s-F12)                                          
  3294.                                                                          
  3295.         -------------------------------------------------------------------
  3296.  
  3297.         -------------------------------------------------------------------
  3298.           Table 3. Ctrl Keys
  3299.           c-Enter       (c-Tab)      c-Backspace   (c-PadEnter)             
  3300.           c-a           c-b          c-c          c-d          c-e       
  3301.           c-f           c-g          c-h          c-i          c-j       
  3302.           c-k           c-l          c-m          c-n          c-o       
  3303.           c-p           c-q          c-r          c-s          c-t       
  3304.           c-u           c-v          c-w          c-x          c-y       
  3305.           c-z                                                            
  3306.           c-2           c-6                                              
  3307.           c-F1          c-F2         c-F3         c-F4         c-F5      
  3308.           c-F6          c-F7         c-F8         c-F9         c-F10     
  3309.           (c-F11)       (c-F12)                                          
  3310.           c-Home        c-End        c-PgUp       c-PgDn                 
  3311.           c-Left        c-Right      (c-Up)       (c-Down)               
  3312.           (c-Ins)       (c-Del)      (c-Pad5)                            
  3313.           c--           c-[          c-]          c-\                    
  3314.                                                                          
  3315.         -------------------------------------------------------------------
  3316.  
  3317.  
  3318.  
  3319.  
  3320.  
  3321.  
  3322.  
  3323.  
  3324.         
  3325.                                        Appendix B.  User Definable Keys  46
  3326.  
  3327.  
  3328.         (C) Copyright IBM Corporation 1987, 1993
  3329.         
  3330.         
  3331.         
  3332.         -------------------------------------------------------------------
  3333.           Table 4. Alt Keys
  3334.           (a-Enter)     (a-Tab)      (a-Backspace)   (a-PadEnter)             
  3335.           a-a           a-b          a-c          a-d          a-e       
  3336.           a-f           a-g          a-h          a-i          a-j       
  3337.           a-k           a-l          a-m          a-n          a-o       
  3338.           a-p           a-q          a-r          a-s          a-t       
  3339.           a-u           a-v          a-w          a-x          a-y       
  3340.           a-z                                                            
  3341.           a-1           a-2          a-3          a-4          a-5       
  3342.           a-6           a-7          a-8          a-9          a-0       
  3343.           a-F1          a-F2         a-F3         a-F4         a-F5      
  3344.           a-F6          a-F7         a-F8         a-F9         a-F10     
  3345.           (a-F11)       (a-F12)                                          
  3346.           (a-Home)      (a-End)      (a-PgUp)     (a-PgDn)               
  3347.           (a-Left)      (a-Right)    (a-Up)       (a-Down)               
  3348.           (a-Ins)       (a-Del)                                          
  3349.           a--           a-=                                              
  3350.                                                                          
  3351.         -------------------------------------------------------------------
  3352.  
  3353.  
  3354.  
  3355.  
  3356.  
  3357.  
  3358.  
  3359.  
  3360.  
  3361.  
  3362.  
  3363.  
  3364.  
  3365.  
  3366.  
  3367.  
  3368.  
  3369.  
  3370.  
  3371.  
  3372.  
  3373.  
  3374.  
  3375.  
  3376.  
  3377.  
  3378.  
  3379.  
  3380.  
  3381.  
  3382.  
  3383.  
  3384.  
  3385.  
  3386.  
  3387.  
  3388.         
  3389.                                        Appendix B.  User Definable Keys  47
  3390.  
  3391.  
  3392.         ===================================================================
  3393.  
  3394.  
  3395.  
  3396.  
  3397.  
  3398.  
  3399.  
  3400.  
  3401.  
  3402.  
  3403.  
  3404.  
  3405.  
  3406.  
  3407.  
  3408.         ===================================================================
  3409.  
  3410.         (C) Copyright IBM Corporation 1987, 1993
  3411.  
  3412.  
  3413.  
  3414.  
  3415.  
  3416.  
  3417.  
  3418.  
  3419.  
  3420.  
  3421.  
  3422.  
  3423.  
  3424.  
  3425.  
  3426.  
  3427.  
  3428.  
  3429.  
  3430.  
  3431.  
  3432.  
  3433.  
  3434.  
  3435.  
  3436.  
  3437.  
  3438.  
  3439.  
  3440.  
  3441.  
  3442.  
  3443.  
  3444.  
  3445.  
  3446.  
  3447.  
  3448.  
  3449.  
  3450.  
  3451.  
  3452.  
  3453.                                                         Printed in the U.K.
  3454.