Microsoft Programmer's Library 1.3/Microsoft-Programers-Library-v1.3.iso/books/mseditor.db

Text File | 1991-03-01 | 586.5 KB | 9,522 lines

%@1@%%@AB@%Microsoft Editor User's Guide for MS OS/2 and MS-DOS Operating Systems%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%MICROSOFT CORPORATION Information in this document is subject to change%@EH@%
without notice and does not represent a commitment on the part of Microsoft
Corporation. The software described in this document is furnished under a
license agreement or nondisclosure agreement. The software may be used or
copied only in accordance with the terms of the agreement. It is against the
law to copy the software on any medium except as specifically allowed in the
license or nondisclosure agreement. No part of this manual may be reproduced
or transmitted in any form or by any means, electronic or mechanical,
including photocopying and recording, for any purpose without the express
written permission of Microsoft.%@NL@%
%@NL@%
(c)Copyright Microsoft Corporation, 1987-1989. All rights reserved.
Simultaneously published in the U.S. and Canada.%@NL@%
%@NL@%
Printed and bound in the United States of America.%@NL@%
%@NL@%
Microsoft, MS, MS-DOS, CodeView, and XENIX are registered trademarks of
Microsoft Corporation.%@NL@%
%@NL@%
BRIEF is a registered trademark of UnderWare, Inc.%@NL@%
%@NL@%
Epsilon is a trademark of Lugaru Software, Ltd.%@NL@%
%@NL@%
IBM is a registered trademark of International Business Machines
Corporation.%@NL@%
%@NL@%
Tandy is a registered trademark of Tandy Corporation.%@NL@%
%@NL@%
UNIX is a registered trademark of American Telephone and Telegraph Company.%@NL@%
%@NL@%
WordStar is a registered trademark of MicroPro International Corporation.%@NL@%
%@NL@%
Document No. LN0801B-500-R00-0889%@NL@%
Part No. 07823%@NL@%
10 9 8 7 6 5 4 3 2 1%@NL@%
%@NL@%
%@NL@%
%@CR:MSETOC00@%%@1@%%@AB@%Table of Contents%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
Chapter 1%@BO:    370a@%  Introduction%@NL@%
Chapter 2%@BO:    7023@%  Edit Now%@NL@%
Chapter 3%@BO:    d239@%  Command Syntax%@NL@%
Chapter 4%@BO:   120e2@%  A Survey of the Editor's Commands%@NL@%
Chapter 5%@BO:   206bc@%  Regular Expressions%@NL@%
Chapter 6%@BO:   28e3a@%  Function Assignments and Macros%@NL@%
Chapter 7%@BO:   3396c@%  Switches, Assignments, and the TOOLS.INI File%@NL@%
Chapter 8%@BO:   3fbeb@%  Programming C Extensions%@NL@%
Chapter 9%@BO:   50fea@%  C-Extension Functions%@NL@%
%@NL@%
%@AB@%Appendixes%@AE@%%@NL@%
Appendix A%@BO:   5d119@%  Reference Tables%@NL@%
Appendix B%@BO:   765d4@%  Support Programs for the Microsoft Editor%@NL@%
Appendix C%@BO:   76d41@%  Microsoft Editor Messages%@NL@%
%@NL@%
%@AB@%Glossary%@BO:   860fe@%%@AE@%%@NL@%
%@NL@%
%@AB@%Index%@BO:   88e6d@%%@AE@%%@NL@%
%@NL@%
%@NL@%
%@CR:MSETOCO0@%%@1@%%@AB@%Table of Contents Overview%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@AB@%Chapter 1%@BO:    370a@%  Introduction%@AE@%%@NL@%
1.1%@BO:    4313@%  Editing Capabilities%@NL@%
1.2%@BO:    4be3@%  System Requirements%@NL@%
1.3%@BO:    4d45@%  Using This Manual%@NL@%
1.4%@BO:    53ee@%  Introducing the Microsoft(R) Editor%@NL@%
1.5%@BO:    5f30@%  Document Conventions%@NL@%
%@NL@%
%@AB@%Chapter 2%@BO:    7023@%  Edit Now%@AE@%%@NL@%
2.1%@BO:    7746@%  Starting the Editor%@NL@%
2.2%@BO:    7cc1@%  The Microsoft Editor's Screen%@NL@%
2.3%@BO:    859e@%  Sample Session%@NL@%
      2.3.1%@BO:    8b05@%  Inserting Text with the Insertmode Function%@NL@%
      2.3.2%@BO:    8e12@%  Removing Text with the Delete Function%@NL@%
      2.3.3%@BO:    9154@%  Using the Arg Function to Specify Text%@NL@%
      2.3.4%@BO:    94b9@%  Canceling and Undoing Commands%@NL@%
      2.3.5%@BO:    9bb3@%  Using Delete to Move Text%@NL@%
      2.3.6%@BO:    a384@%  Finding Strings with the Psearch Function%@NL@%
      2.3.7%@BO:    ab38@%  Inserting Spaces and Lines%@NL@%
      2.3.8%@BO:    af34@%  Exiting the Editor%@NL@%
2.4%@BO:    b16a@%  Getting Help%@NL@%
      2.4.1%@BO:    b45a@%  Starting On-Line Help%@NL@%
      2.4.2%@BO:    b81a@%  Moving through On-Line Help%@NL@%
      2.4.3%@BO:    b9ae@%  Leaving On-Line Help%@NL@%
2.5%@BO:    bc2e@%  The Microsoft Editor's Command Line%@NL@%
2.6%@BO:    cf04@%  Hints for Using the Editor%@NL@%
%@NL@%
%@AB@%Chapter 3%@BO:    d239@%  Command Syntax%@AE@%%@NL@%
3.1%@BO:    d5f7@%  Entering a Command%@NL@%
3.2%@BO:    df64@%  Naming Conventions for Functions%@NL@%
3.3%@BO:    e83e@%  Argument Types%@NL@%
3.4%@BO:    ef06@%  Text Arguments (numarg, markarg, textarg)%@NL@%
      3.4.1%@BO:    f671@%  The numarg Type%@NL@%
      3.4.2%@BO:    fa9b@%  The markarg Type%@NL@%
      3.4.3%@BO:    fec9@%  The textarg Type%@NL@%
3.5%@BO:   101fc@%  Highlighting a Text Argument%@NL@%
3.6%@BO:   10919@%  Cursor-Movement Arguments (linearg, boxarg, streamarg)%@NL@%
      3.6.1%@BO:   11355@%  The linearg Type%@NL@%
      3.6.2%@BO:   115ce@%  The boxarg Type%@NL@%
      3.6.3%@BO:   119d6@%  The streamarg Type%@NL@%
%@NL@%
%@AB@%Chapter 4%@BO:   120e2@%  A Survey of the Editor's Commands%@AE@%%@NL@%
4.1%@BO:   125dc@%  Basic File Operations%@NL@%
      4.1.1%@BO:   126c6@%  File Commands%@NL@%
      4.1.2%@BO:   1356e@%  Special Syntax for Setfile%@NL@%
      4.1.3%@BO:   13c6b@%  Pseudo Files%@NL@%
4.2%@BO:   14909@%  Moving through a File%@NL@%
      4.2.1%@BO:   1503c@%  Scrolling at the Screen's Edge%@NL@%
      4.2.2%@BO:   15496@%  Scrolling a Page at a Time%@NL@%
      4.2.3%@BO:   15a24@%  Moving to the Top or Bottom of the File%@NL@%
      4.2.4%@BO:   15c8d@%  Other File-Navigation Functions%@NL@%
4.3%@BO:   160c4@%  Inserting, Copying, and Deleting Text%@NL@%
      4.3.1%@BO:   162ea@%  Inserting and Deleting Text%@NL@%
      4.3.2%@BO:   16f75@%  Copying Text%@NL@%
      4.3.3%@BO:   177c9@%  Other Insert Commands%@NL@%
      4.3.4%@BO:   17e67@%  Reading a File into the Current File%@NL@%
4.4%@BO:   1839c@%  Using File Markers%@NL@%
      4.4.1%@BO:   18cab@%  Functions That Use Markers%@NL@%
      4.4.2%@BO:   193a1@%  Related Functions: Savecur and Restcur%@NL@%
4.5%@BO:   197b4@%  Searching and Replacing%@NL@%
      4.5.1%@BO:   1a2e0@%  Searching for a Pattern of Text%@NL@%
      4.5.2%@BO:   1a791@%  Searching the File Globally%@NL@%
      4.5.3%@BO:   1ab0e@%  Searching a Series of Files%@NL@%
      4.5.4%@BO:   1b1ae@%  Search-and-Replace Functions%@NL@%
4.6%@BO:   1bf47@%  Compiling%@NL@%
      4.6.1%@BO:   1c335@%  Invoking Compilers and Other Utilities%@NL@%
      4.6.2%@BO:   1d4d9@%  Viewing Error Output%@NL@%
      4.6.3%@BO:   1e543@%  Viewing the Dynamic-Compile Log%@NL@%
4.7%@BO:   1ebfe@%  Using Editing Windows%@NL@%
4.8%@BO:   1f30c@%  Working with Multiple Files%@NL@%
4.9%@BO:   1fc90@%  Printing a File%@NL@%
%@NL@%
%@AB@%Chapter 5%@BO:   206bc@%  Regular Expressions%@AE@%%@NL@%
5.1%@BO:   20e9f@%  Choosing the Syntax%@NL@%
5.2%@BO:   21359@%  UNIX(R) Regular-Expression Syntax%@NL@%
      5.2.1%@BO:   214d8@%  UNIX Regular Expressions as Simple Strings%@NL@%
      5.2.2%@BO:   21754@%  UNIX Special Characters%@NL@%
      5.2.3%@BO:   22c1f@%  Combining UNIX Special Characters%@NL@%
      5.2.4%@BO:   231bc@%  Tagged Expressions in the UNIX Search String%@NL@%
      5.2.5%@BO:   23b94@%  Tagged Expressions in the UNIX Replacement String%@NL@%
5.3%@BO:   2423b@%  M 1.0 Regular-Expression Syntax%@NL@%
      5.3.1%@BO:   2447a@%  M 1.0 Regular Expressions as Simple Strings%@NL@%
      5.3.2%@BO:   246e9@%  M 1.0 Special Characters%@NL@%
      5.3.3%@BO:   26544@%  Combining M 1.0 Special Characters%@NL@%
      5.3.4%@BO:   26bc3@%  M 1.0 Matching Method%@NL@%
      5.3.5%@BO:   27441@%  Tagged Expressions in the M 1.0 Search String%@NL@%
      5.3.6%@BO:   27df8@%  Tagged Expressions in the M 1.0 Replacement String%@NL@%
      5.3.7%@BO:   2885d@%  Predefined M 1.0 Regular Expressions%@NL@%
%@NL@%
%@AB@%Chapter 6%@BO:   28e3a@%  Function Assignments and Macros%@AE@%%@NL@%
6.1%@BO:   292f2@%  The Four Techniques for Customizing the Editor%@NL@%
6.2%@BO:   29ab0@%  Assigning Functions to Keystrokes%@NL@%
      6.2.1%@BO:   2a304@%  Making Function Assignments%@NL@%
      6.2.2%@BO:   2b13c@%  Viewing and Changing Function Assignments%@NL@%
      6.2.3%@BO:   2bbd2@%  Disabling a Keystroke%@NL@%
      6.2.4%@BO:   2c0ab@%  Making a Keystroke Literal%@NL@%
6.3%@BO:   2cc6a@%  Creating Macros within the Editor%@NL@%
      6.3.1%@BO:   2d250@%  Recording a Macro%@NL@%
      6.3.2%@BO:   2def3@%  Entering a Macro Directly%@NL@%
      6.3.3%@BO:   2eac6@%  Building the Macro List%@NL@%
      6.3.4%@BO:   2ff89@%  Executing a Macro List Directly%@NL@%
      6.3.5%@BO:   302f6@%  Building Macros from Other Macros%@NL@%
      6.3.6%@BO:   30928@%  Handling Prompts within Macros%@NL@%
      6.3.7%@BO:   31159@%  Macros That Take Arguments%@NL@%
      6.3.8%@BO:   320fc@%  Macros That Use Conditionals%@NL@%
%@NL@%
%@AB@%Chapter 7%@BO:   3396c@%  Switches, Assignments, and the TOOLS.INI File%@AE@%%@NL@%
7.1%@BO:   34011@%  Syntax for Switch Settings%@NL@%
7.2%@BO:   34b62@%  Using Switches to Configure the Editor%@NL@%
      7.2.1%@BO:   34f56@%  Changing Start-Up Conditions%@NL@%
      7.2.2%@BO:   35678@%  Changing Scrolling Behavior%@NL@%
      7.2.3%@BO:   35a6f@%  Setting Screen Colors with fgcolor%@NL@%
      7.2.4%@BO:   367cb@%  Setting Colors for Other Parts of the Screen%@NL@%
      7.2.5%@BO:   370ae@%  Changing the Look and Feel of Help%@NL@%
      7.2.6%@BO:   37eeb@%  Controlling Use of Tabs%@NL@%
      7.2.7%@BO:   39cc2@%  Changing How the Editor Handles Trailing Spaces%@NL@%
      7.2.8%@BO:   3a3f0@%  Changing Screen Height%@NL@%
7.3%@BO:   3a7a5@%  Special Syntax for Text Switches%@NL@%
      7.3.1%@BO:   3ab6d@%  Special Syntax for extmake and readonly%@NL@%
      7.3.2%@BO:   3b101@%  Special Syntax for load, markfile, and helpfiles%@NL@%
7.4%@BO:   3b535@%  Sample TOOLS.INI File%@NL@%
7.5%@BO:   3c086@%  The Structure of the TOOLS.INI File%@NL@%
      7.5.1%@BO:   3c8ac@%  Creating Sections with Tags%@NL@%
      7.5.2%@BO:   3dbb2@%  Using Comments%@NL@%
      7.5.3%@BO:   3dea7@%  Line Continuation%@NL@%
      7.5.4%@BO:   3e36a@%  Assignments and Macros%@NL@%
7.6%@BO:   3eb8b@%  Configuring On-Line Help%@NL@%
      7.6.1%@BO:   3f48a@%  Controlling Search Order%@NL@%
      7.6.2%@BO:   3f896@%  Default Help File Search%@NL@%
%@NL@%
%@AB@%Chapter 8%@BO:   3fbeb@%  Programming C Extensions%@AE@%%@NL@%
8.1%@BO:   4042f@%  Requirements%@NL@%
8.2%@BO:   4095b@%  How C Extensions Work%@NL@%
8.3%@BO:   41570@%  Writing a C Extension%@NL@%
      8.3.1%@BO:   41aca@%  Required Objects%@NL@%
      8.3.2%@BO:   41eff@%  The Switch Table%@NL@%
      8.3.3%@BO:   42a57@%  The Command Table%@NL@%
      8.3.4%@BO:   44776@%  The WhenLoaded Function%@NL@%
      8.3.5%@BO:   44a45@%  Defining the Editing Function%@NL@%
8.4%@BO:   45aeb@%  Programming Your Function%@NL@%
      8.4.1%@BO:   46181@%  Getting a File Handle%@NL@%
      8.4.2%@BO:   469d5@%  Interpreting the User-Defined Argument%@NL@%
      8.4.3%@BO:   470c5@%  The NOARG Type%@NL@%
      8.4.4%@BO:   4764d@%  The NULLARG Type%@NL@%
      8.4.5%@BO:   47ceb@%  The TEXTARG Type%@NL@%
      8.4.6%@BO:   48541@%  The LINEARG Type%@NL@%
      8.4.7%@BO:   48c3b@%  The STREAMARG Type%@NL@%
      8.4.8%@BO:   494b0@%  The BOXARG Type%@NL@%
      8.4.9%@BO:   49cca@%  Modifying the Current File%@NL@%
8.5%@BO:   4a7bb@%  Compiling and Linking%@NL@%
      8.5.1%@BO:   4ab20@%  Compiling and Linking for Real Mode%@NL@%
      8.5.2%@BO:   4b1b6@%  Compiling and Linking for Protected Mode%@NL@%
      8.5.3%@BO:   4b796@%  Loading Your Extension%@NL@%
8.6%@BO:   4d33a@%  A C-Extension Sample Program%@NL@%
8.7%@BO:   4fa83@%  Calling Library Functions%@NL@%
%@NL@%
%@AB@%Chapter 9%@BO:   50fea@%  C-Extension Functions%@AE@%%@NL@%
AddFile%@BO:   51608@%%@NL@%
BadArg%@BO:   51d7a@%%@NL@%
CopyBox%@BO:   5238e@%%@NL@%
CopyLine%@BO:   52d82@%%@NL@%
CopyStream%@BO:   5376c@%%@NL@%
DelBox%@BO:   53fde@%%@NL@%
DelFile%@BO:   546d9@%%@NL@%
DelLine%@BO:   54cad@%%@NL@%
DelStream%@BO:   55335@%%@NL@%
Display%@BO:   55abb@%%@NL@%
DoMessage%@BO:   55f94@%%@NL@%
fExecute%@BO:   563e5@%%@NL@%
FileLength%@BO:   56b4d@%%@NL@%
FileNameToHandle%@BO:   57001@%%@NL@%
FileRead%@BO:   577dc@%%@NL@%
FileWrite%@BO:   57f2d@%%@NL@%
GetCursor%@BO:   58886@%%@NL@%
GetLine%@BO:   58d95@%%@NL@%
KbHook%@BO:   595af@%%@NL@%
KbUnHook%@BO:   598b1@%%@NL@%
MoveCur%@BO:   59ead@%%@NL@%
pFileToTop%@BO:   5a4d2@%%@NL@%
PutLine%@BO:   5a976@%%@NL@%
ReadChar%@BO:   5b0be@%%@NL@%
ReadCmd%@BO:   5ba9c@%%@NL@%
RemoveFile%@BO:   5be9e@%%@NL@%
Replace%@BO:   5c466@%%@NL@%
SetKey%@BO:   5cc35@%%@NL@%
%@NL@%
%@AB@%Appendix A%@BO:   5d119@%  Reference Tables%@AE@%%@NL@%
A.1%@BO:   5d1c2@%  Categories of Editing Functions%@NL@%
A.2%@BO:   5ef37@%  Key Assignments for Editing Functions%@NL@%
A.3%@BO:   60b28@%  Comprehensive Listing of Editing Functions%@NL@%
A.4%@BO:   700be@%  Return Values of Editing Functions%@NL@%
A.5%@BO:   72116@%  Editor Switches%@NL@%
%@NL@%
%@AB@%Appendix B%@BO:   765d4@%  Support Programs for the Microsoft Editor%@AE@%%@NL@%
B.1%@BO:   76895@%  UNDEL.EXE%@NL@%
B.2%@BO:   76ad7@%  EXP.EXE%@NL@%
%@NL@%
%@AB@%Appendix C%@BO:   76d41@%  Microsoft Editor Messages%@AE@%%@NL@%
C.1%@BO:   77192@%  Messages Starting with Placeholders%@NL@%
C.2%@BO:   78741@%  Other Messages%@NL@%
%@NL@%
%@AB@%Glossary%@BO:   860fe@%%@AE@%%@NL@%
%@NL@%
%@AB@%Index%@BO:   88e6d@%%@AE@%%@NL@%
%@NL@%
%@NL@%
%@AB@%Listing of Tables%@AE@%%@NL@%
%@NL@%
Table 5.1%@BO:   28999@%  Predefined Expressions%@NL@%
Table 6.1%@BO:   324a9@%  Macro Conditionals%@NL@%
Table 7.1%@BO:   35f29@%  Colors and Numeric Values%@NL@%
Table 8.1%@BO:   435cc@%  Meaning of cmdTable Flags%@NL@%
Table 8.2%@BO:   505ed@%  Summary of Extension Functions by Category%@NL@%
Table A.1%@BO:   5d2a3@%  Summary of Editing Functions by Category%@NL@%
Table A.2%@BO:   5f038@%  Function Assignments%@NL@%
Table A.3%@BO:   60c4c@%  Comprehensive List of Functions%@NL@%
Table A.4%@BO:   701fe@%  Editor Functions and Return Values%@NL@%
Table A.5%@BO:   7225b@%  Editor Switches%@NL@%
%@NL@%
%@NL@%
%@CR:MSE10000@%%@1@%%@AB@%Chapter 1  Introduction%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@CR:MSE10001@%%@4@%The Microsoft(R) Editor is the first full-screen editor to run under both%@EH@%
OS/2 systems and DOS (Versions 2.1 and above). You can use the editor to
write programs, modify text files, and, under OS/2, run language translators
and other utilities in the background.%@NL@%
%@NL@%
%@CR:MSE10002@%%@4@%The Microsoft Editor was specially developed as a programmer's editor. It%@EH@%
offers an unsurpassed ability to work efficiently with many different files
in different directories, to interact with the environment, and to undo or
redo a whole series of commands. As a programmer, you can work faster and
more efficiently by using some of these features:%@NL@%
%@NL@%
%@CR:MSE10003@%  ■  %@AB@%Compile and link programs from within the editor%@AE@%%@NL@%
%@NL@%
     Improve your productivity. The Microsoft Editor is more than a text%@NL@%
     editor; it is a development environment. Develop programs more quickly%@NL@%
     by compiling from within the editor. If the compilation fails, view the%@NL@%
     errors, rewrite the program, and recompile──all without leaving the%@NL@%
     editor.%@NL@%
%@NL@%
  ■  %@AB@%Create new editing functions in C or assembly language%@AE@%%@NL@%
%@NL@%
     Extend the editor's power by writing new functions. If you know how to%@NL@%
     program in C or assembly language, you can quickly learn how to write%@NL@%
     new modules for the Microsoft Editor. These modules involve no%@NL@%
     preprocessing; they become part of the editor itself and therefore run%@NL@%
     as fast as standard editing commands.%@NL@%
%@NL@%
  ■  %@AB@%Customize the editor to suit your needs%@AE@%%@NL@%
%@NL@%
     Control how the editor behaves. The editor uses a special%@NL@%
     initialization file, TOOLS.INI, in which you can easily specify your%@NL@%
     own preferences for function keystrokes, screen colors, tabs, margins,%@NL@%
     and many other kinds of editor behavior. You can even specify%@NL@%
     preferences specific to type of file so that as you move between .C and%@NL@%
     .FOR files, the editor alters its settings.%@NL@%
%@NL@%
%@CR:MSE10004@%%@4@%This manual is a substantial revision of the %@AI@%Microsoft%@AE@% %@AI@%Editor User's Guide%@AE@%%@EH@%
for Version 1.0 of the editor. This manual has an expanded index, more
examples, detailed instructions for configuring the editor, and complete
documentation for writing editing functions in C.%@NL@%
%@NL@%
%@CR:MSE10010@%%@4@%%@AB@%A Note about Operating-System Terms%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE10011@%%@4@%Microsoft documentation uses the term "OS/2" to refer to the OS/2%@EH@%
systems──Microsoft Operating System/2 (MS(R) OS/2) and IBM(R) OS/2.
Similarly, the term "DOS" refers to both the MS-DOS(R) and IBM Personal
Computer DOS operating systems. The name of a specific operating system is
used when it is necessary to note features unique to that system.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE11000@%%@2@%%@AB@%1.1  Editing Capabilities%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE11001@%%@4@%Not only can the editor be customized, but it also supports many powerful%@EH@%
editing features:%@NL@%
%@NL@%
%@CR:MSE11002@%  ■  %@AB@%Use a full range of file-editing commands%@AE@%%@NL@%
%@NL@%
     The editor supports a comprehensive range of file operations. You can%@NL@%
     load, merge, or save files, with or without exiting. You can execute%@NL@%
     the DOS or OS/2 shell, send highlighted areas to the printer, or insert%@NL@%
     program output directly into a file. The editor also supports a wide%@NL@%
     range of pattern-search and replacement functions.%@NL@%
%@NL@%
  ■  %@AB@%Save time with powerful block operations%@AE@%%@NL@%
%@NL@%
     You can manipulate different kinds of text blocks. For example, you can%@NL@%
     insert or delete ordinary sequences of characters between two file%@NL@%
     positions. You can also insert or delete rectangular areas, called%@NL@%
     "boxes." Box-shaped regions are highly useful for indenting paragraphs%@NL@%
     or moving columns of text.%@NL@%
%@NL@%
  ■  %@AB@%Save typing effort with macros%@AE@%%@NL@%
%@NL@%
     The Microsoft Editor includes a convenient macro language. A macro is a%@NL@%
     command that performs a series of predefined actions; for example, a%@NL@%
     macro can insert a given phrase or word or perform an entire series of%@NL@%
     editing commands. Define a macro, then invoke it with one keystroke.%@NL@%
%@NL@%
  ■  %@AB@%Edit complex files with windows%@AE@%%@NL@%
%@NL@%
     When editing a large file, you may want to view different parts of the%@NL@%
     file simultaneously. With the Microsoft Editor, you can split up your%@NL@%
     screen into as many as eight windows──each displaying a different part%@NL@%
     of the file (or parts of different files).%@NL@%
%@NL@%
  ■  %@AB@%Handle multiple source files%@AE@%%@NL@%
%@NL@%
     A simple command switches you among the files you are working on──you%@NL@%
     never have to leave the editor and start it up again to work on a%@NL@%
     different file. As the editor moves between files, it saves the last%@NL@%
     cursor position and other relevant information.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE12000@%%@2@%%@AB@%1.2  System Requirements%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE12001@%%@4@%To use the Microsoft Editor, you need OS/2 1.0 or DOS 2.1 or later and at%@EH@%
least 128 kilobytes (K) of available memory. A minimum of 150K of available
memory is required to use the C extensions described in Chapter 8%@BO:   3fbeb@%.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE13000@%%@2@%%@AB@%1.3  Using This Manual%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE13001@%%@4@%The following list gives the chapter or section you should read to learn%@EH@%
about a particular topic:%@NL@%
%@CR:MSE13002@%%@NL@%
%@TH:   32   1434  2 37 39 @%
%@AB@%Topic                                Chapter or Section%@AE@%

Using the editor right away          Chapter 2%@BO:    7023@%, "Edit Now"

Starting the editor using options    Section 2.5%@BO:    bc2e@%, "The Microsoft
and file names                       Editor's Command Line"

Entering arguments to editing        Chapter 3%@BO:    d239@%, "Command Syntax"
functions

Using the most common editing        Chapter 4%@BO:   120e2@%, "A Survey of the
commands, including file             Editor's Commands"
operations, compiling, and
windows

Using regular expressions with       Chapter 5%@BO:   206bc@%, "Regular Expressions"
the editor

Customizing the editor by            Chapter 6%@BO:   28e3a@%, "Function Assignments
changing function-to-key             and Macros," and Chapter 7%@BO:   3396c@%,
assignments and basic conditions,    "Switches, Assignments, and the
such as screen colors                TOOLS.INI File"

Writing new editing functions in     Chapter 8%@BO:   3fbeb@%, "Programming C
C or assembly language               Extensions," and Chapter 9%@BO:   50fea@%,
                                     "C-Extension Functions"

Getting quick reference to           Appendix A, "Reference Tables,"
commands and switches                and the index

Using the accompanying utilities:    Appendix B, "Support Programs for
UNDEL and EXP                        the Microsoft Editor"
%@TE:   32   1434  2 37 39 @%
%@NL@%
%@NL@%
%@CR:MSE14000@%%@2@%%@AB@%1.4  Introducing the Microsoft(R) Editor%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE14001@%%@4@%You'll find the Microsoft Editor easy to use once you understand the%@EH@%
function-argument model it uses for executing commands. Each command
consists of a function that may or may not be given input in the form of an
"argument."%@NL@%
%@NL@%
%@CR:MSE14002@%%@4@%The Microsoft Editor uses a "reverse Polish" command structure. That is, you%@EH@%
specify the argument first, then give the command function. For example, if
you want to load a file, you first specify the file name, then invoke the
file loading function.%@NL@%
%@NL@%
%@CR:MSE14003@%%@4@%All Microsoft Editor functions work in this fashion. This arrangement is%@EH@%
different from that of conventional editors where you would choose the file
loading function first, then specify the desired file. This "argument first,
function second" sequence gives the Microsoft Editor unique advantages:%@NL@%
%@NL@%
%@CR:MSE14004@%  ■  A single function can process different types of arguments, such as%@NL@%
     high-lighted blocks of text, a word or number typed on the dialog line,%@NL@%
     or the word at the current cursor position. Almost all functions work%@NL@%
     with all data types, so there aren't too many arbitrary details to%@NL@%
     memorize.%@NL@%
%@NL@%
  ■  It's easy to write macros because almost every action can be expressed%@NL@%
     as a function name. Macros are likewise easy to understand──you won't%@NL@%
     have trouble understanding another person's macro, or a macro %@AI@%you%@AE@% wrote%@NL@%
     six months ago.%@NL@%
%@NL@%
%@CR:MSE14005@%%@4@%Function names follow a consistent pattern. For example, functions that%@EH@%
involve forward movement usually start with P (for "plus"). Functions that
involve backward movement usually start with M (for "minus").%@NL@%
%@NL@%
%@CR:MSE14006@%%@4@%Before using the Microsoft Editor, run the installation program for your%@EH@%
Microsoft language product. The installation program sets up the powerful
on-line Help, which provides on-line information for editing functions and
the standard C library. It is recommended that you select the default
keystroke configuration in order to work through the early chapters of this
manual.%@NL@%
%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@AI@%NOTE%@AE@%%@NL@%
   If you choose to customize the Microsoft Editor during installation, its%@NL@%
   function-key assignments will match those of BRIEF(R), Epsilon(TM), or%@NL@%
   the Microsoft "Quick" Environment. This book describes the uncustomized%@NL@%
   version of the Microsoft Editor, so the commands described will not%@NL@%
   always match those on your version of the editor.%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@NL@%
%@CR:MSE15000@%%@2@%%@AB@%1.5  Document Conventions%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE15001@%%@4@%The following document conventions are used throughout this manual and apply%@EH@%
in particular to syntax displays for commands and switches:%@NL@%
%@CR:MSE15002@%%@NL@%
%@TH:   78   4027  3 31 45 @%
%@AB@%Example of%@AE@%
%@AB@%Convention                     Description%@AE@%

%@AB@%AddFile%@AE@%                        Boldface type always marks
                               standard features of programming
                               languages (keywords, operators,
                               and functions) and editor
                               switches.

%@AS@%$INIT: tools.ini%@AE@%               This font is used to indicate all
                               example programs, user input, and
                               screen output.

%@AI@%placeholders%@AE@%                   Words in italics indicate a
                               Microsoft Editor function, a
                               field, or a general kind of
                               information; you must supply the
                               particular value. For example, %@AI@%%@AE@%
                               %@AI@%numarg%@AE@% represents a numerical
                               argument that you type in from
                               the keyboard. You could type in a
                               number, such as %@AS@%15%@AE@%, but you would
                               not type in the word%@AB@%%@AE@%"%@AI@%numarg%@AE@%"
                               itself.

Repeating elements...          Three dots following an item
                               indicate more items having the
                               same form may appear.

%@AS@%Program %@AE@%                       A column of three dots tells you
%@AS@%    . %@AE@%                         part of a program has been
%@AS@%    . %@AE@%                         intentionally omitted.
%@AS@%    .%@AE@%
%@AS@%Fragment%@AE@%

SHIFT                          Names of keys on the keyboard
                               appear in small capital letters.
                               Notice that a plus (+) indicates
                               a combination of keys. For
                               example, CTRL+E means to hold
                               down the CTRL key while pressing
                               the E key.

                               The names of the keys in this
                               manual correspond to the key
                               names printed on the IBM Personal
                               Computer keyboard. If you are
                               using a different machine, these
                               keys may have slightly different
                               names.

                               The cursor-movement keys
                               (sometimes called "arrow" keys)
                               located on the numeric keypad to
                               the right of the main keypad are
                               called the DIRECTION keys.
                               Individual DIRECTION keys are
                               called either by the direction of
                               the arrow on the key top (LEFT,
                               RIGHT, UP, DOWN) or the name on
                               the key top (PGUP, PGDN).

                               Some of the Microsoft Editor's
                               functions use the +, -, or number
                               keys on the numeric keypad rather
                               than the ones on the top row of
                               the main keyboard. At each
                               instance, the text notes the use
                               of keys from the numeric keypad.

                               The carriage-return key,
                               sometimes unnamed but marked with
                               a bent arrow, is called the ENTER
                               key.

"Commands"                     The first time a new term is
                               defined, it is enclosed in
                               quotation marks.
%@TE:   78   4027  3 31 45 @%
%@NL@%
%@NL@%
%@CR:MSE20000@%%@1@%%@AB@%Chapter 2  Edit Now%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@CR:MSE20001@%%@4@%This chapter shows you how to use the Microsoft Editor right away by%@EH@%
focusing on the functions you need to create a simple text file. "Functions"
are built-in editing capabilities you invoke to perform actions. Most of the
chapter consists of a tutorial that uses a specific example and features the
following functions:%@NL@%
%@NL@%
%@CR:MSE20002@%%@AB@%Function                              Default Keystroke%@AE@%%@NL@%
%@NL@%
Cursor movement                       DIRECTION keys, HOME, END%@NL@%
%@NL@%
%@AI@%Insertmode%@AE@%                            INS%@NL@%
%@AI@%Delete%@AE@%                                DEL%@NL@%
%@AI@%Arg%@AE@% (introduce argument)              ALT+A%@NL@%
%@AI@%Cancel%@AE@%                                ESC%@NL@%
%@AI@%Undo%@AE@%                                  ALT+BKSP%@NL@%
%@AI@%Paste%@AE@%                                 SHIFT+INS%@NL@%
%@AI@%Psearch%@AE@% (forward search)              F3%@NL@%
%@AI@%Linsert%@AE@% (insert new line)             CTRL+N%@NL@%
%@AI@%Exit%@AE@%                                  F8%@NL@%
%@AI@%Help%@AE@%                                  F1%@NL@%
%@NL@%
%@CR:MSE20003@%%@4@%You can use this tutorial either by starting the editor and typing in each%@EH@%
command as shown, or you can simply read along. Because the results are
explained at each stage, you can get a good understanding of the editor just
by reading.%@NL@%
%@NL@%
%@CR:MSE20004@%%@4@%The chapter ends by presenting the complete command line for the editor with%@EH@%
all the possible options you may use, a complete list of items on the status
line, and some hints for learning the editor.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE21000@%%@2@%%@AB@%2.1  Starting the Editor%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE21001@%%@4@%Copy the file M.EXE into your current directory or a directory listed in the%@EH@%
PATH environment variable. To run the editor in OS/2 protected mode, copy
the file MEP.EXE. (You may want to rename the file as M.EXE.) Then start the
editor with this command:%@NL@%
%@NL@%
     %@AS@%M NEW.TXT%@AE@%%@NL@%
%@NL@%
%@CR:MSE21002@%%@4@%The Microsoft Editor responds by asking if you want to create a new file%@EH@%
with this name. Press %@AS@%Y%@AE@% to indicate yes. The editor creates the file and
places it in the current directory. You are now ready to enter text.%@NL@%
%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@AI@%NOTE%@AE@%%@NL@%
   If the editor cannot start correctly, it reports an error message. If you%@NL@%
   receive an error message on start-up, consult the list of error messages%@NL@%
   in Appendix C%@BO:   76d41@%. This list of error messages provides explanations,%@NL@%
   along with suggestions for solving the problem.%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@CR:MSE21003@%%@4@%When you want to exit, press %@AS@%F8%@AE@%. Whenever you want to save your work without%@EH@%
exiting, type the following keystrokes:%@NL@%
%@NL@%
     %@AS@%ALT+A  ALT+A  F2%@AE@%%@NL@%
%@NL@%
%@NL@%
%@CR:MSE22000@%%@2@%%@AB@%2.2  The Microsoft Editor's Screen%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE22001@%%@4@%When starting the editor with a new file, you see a blank screen, as shown%@EH@%
in Figure 2.1%@FN@%
Figure 2.1 is found on page 9 in the printed version of this guide.%@EF@% below.%@NL@%
%@NL@%
%@CR:MSE22002@%%@4@%The cursor first appears at the upper-left corner of the screen. Even though%@EH@%
the file is empty, you can use the DIRECTION keys──denoted as UP, DOWN,
LEFT, and RIGHT──to move the cursor anywhere on the screen. (The DIRECTION
keys are the arrow keys on the numeric keypad. Newer keyboards may have an
additional set of arrow keys to the left of the numeric keypad.) Try
experimenting with cursor movement.%@NL@%
%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@AI@%NOTE%@AE@%%@NL@%
   The DIRECTION keys on the numeric keypad do not respond unless NUMLOCK is%@NL@%
   off. Press the NUMLOCK key to toggle the numeric keypad lock on and off.%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@CR:MSE22003@%%@4@%The next-to-bottom line is called the "dialog line," which is reserved for%@EH@%
displaying messages from the editor and letting you enter text arguments.
The bottom line is called the "status line." It always displays the
following fields:%@NL@%
%@NL@%
%@CR:MSE22004@%%@AB@%Field                       Description%@AE@%%@NL@%
%@NL@%
%@AS@%c:\m\new.txt%@AE@%                File name, with complete path%@NL@%
%@NL@%
%@AS@%(text)%@AE@%                      Type of file%@NL@%
%@NL@%
%@AS@%Length=1%@AE@%                    Length of file, in number of lines (minimum%@NL@%
                            value is 1)%@NL@%
%@NL@%
%@AS@%Window=(1,1)%@AE@%                Window or cursor position%@NL@%
%@NL@%
%@NL@%
%@CR:MSE22005@%%@4@%The field %@AS@%Window=(1,1)%@AE@% indicates that the upper-left corner of the screen%@EH@%
corresponds to the first row and column of the file. As you scroll through
files larger then one screen, the numbers in this field change. See Section
7.2.1%@BO:   34f56@%, "Changing Start-Up Conditions," to learn how to alter this field
so that it displays cursor position instead of window position.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE23000@%%@2@%%@AB@%2.3  Sample Session%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE23001@%%@4@%Once the Microsoft Editor is started, you can enter text immediately. Simply%@EH@%
start typing and press ENTER when you want to begin a new line. By default,
the editor starts in "overtype" mode, which means that anything you type
replaces the text at the cursor position.The editor also has an "insert"
mode for adding new material without replacing the current text. Insert mode
is explained in the next section.%@NL@%
%@NL@%
%@CR:MSE23002@%%@4@%To begin, type in the following text. There are some intentional errors%@EH@%
you'll correct in a few moments.%@NL@%
%@NL@%
     It's mind over matter.%@NL@%
     What is mind?%@NL@%
     No mat matter.%@NL@%
     Wh is matter?%@NL@%
     Mever mind.%@AH@% %@AE@%%@NL@%
%@NL@%
%@CR:MSE23003@%%@4@%The third, fourth, and fifth lines have errors near the beginning of each%@EH@%
line. To get to the beginning of the fifth line, you can press the LEFT key
until you move to the beginning of the line. However, you can get there
faster by pressing the HOME key. This key moves the cursor to the first
nonblank character in the line.%@NL@%
%@NL@%
%@CR:MSE23004@%%@4@%Now move the cursor to the beginning of the fifth line and correct the error%@EH@%
by typing the letter %@AS@%N%@AE@%:%@NL@%
%@NL@%
     N%@AH@%e%@AE@%ver mind.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE23100@%%@3@%%@AB@%2.3.1  Inserting Text with the Insertmode Function%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE23101@%%@4@%To insert text in this example, move the cursor to the third position in the%@EH@%
fourth line:%@NL@%
%@NL@%
     Wh%@AH@% %@AE@%is matter?%@NL@%
%@NL@%
%@CR:MSE23102@%%@4@%The letters %@AS@%at%@AE@% need to be inserted at the end of the first word. Press the%@EH@%
INS key to invoke the %@AI@%Insertmode%@AE@% function, which toggles between overtype
and insert mode. You'll see the word %@AS@%insert%@AE@% appear at the end of the status
line. Type the letters %@AS@%at%@AE@% to produce the following line:%@NL@%
%@NL@%
     What%@AH@% %@AE@%is matter?%@NL@%
%@NL@%
%@CR:MSE23103@%%@4@%To return to overtype mode, press INS again.%@EH@%%@NL@%
%@NL@%
%@NL@%
%@CR:MSE23200@%%@3@%%@AB@%2.3.2  Removing Text with the Delete Function%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE23201@%%@4@%So far, you've used editing functions to replace old text and insert new%@EH@%
text. The third line requires text deletion, so move the cursor to the
beginning of the second word in the third line:%@NL@%
%@NL@%
     No %@AH@%m%@AE@%at matter.%@NL@%
%@NL@%
%@CR:MSE23202@%%@4@%Invoke the %@AI@%Delete%@AE@% function by pressing the DEL key. Each time you press the%@EH@%
DEL key, the character at the cursor position is erased.%@NL@%
%@NL@%
%@CR:MSE23203@%%@4@%It is inconvenient to delete a large amount of text one character at a time.%@EH@%
The %@AI@%Delete%@AE@% function can also remove blocks of text that are specified as
arguments. The next section explains deleting a large block of text.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE23300@%%@3@%%@AB@%2.3.3  Using the Arg Function to Specify Text%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE23301@%%@4@%The %@AI@%Arg%@AE@% function is assigned to ALT+A; hold down the ALT key and press A to%@EH@%
invoke it. The %@AI@%Arg%@AE@% function does nothing by itself. Rather, it tells the
editor that you are about to introduce an argument that another function
will operate on. (An "argument" is input, such as text or highlighted
characters.)%@NL@%
%@NL@%
%@CR:MSE23302@%%@4@%In this example you'll use the %@AI@%Arg%@AE@% function to highlight the group of%@EH@%
characters you wish to delete. After pressing ALT+A, move the cursor to the
beginning of the third word, as shown in Figure 2.2%@FN@%
Figure 2.2 is found on page 11 in the printed version of this guide.%@EF@% below. Now press DEL,
and the high-lighted characters are removed.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE23400@%%@3@%%@AB@%2.3.4  Canceling and Undoing Commands%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE23401@%%@4@%If you pressed ALT+A at the wrong time but did not complete the command you%@EH@%
were typing, you can cancel the argument by pressing the ESC key. This
key-stroke invokes the %@AI@%Cancel%@AE@% function. The %@AI@%Cancel%@AE@% function lets you start a
command sequence over again.%@NL@%
%@NL@%
%@CR:MSE23402@%%@4@%If you complete an incorrect command, reverse it by pressing ALT+BKSP (hold%@EH@%
down the ALT key and then press the backspace key). This keystroke invokes
the %@AI@%Undo%@AE@% function. If you invoke %@AI@%Undo%@AE@% again, it reverses the next-to-last
editing command. Invoke %@AI@%Undo%@AE@% a third time, and it reverses the
second-to-last editing command, and so on. The number of commands that the
editor remembers is controlled by the %@AB@%undocount%@AE@% switch. The default number
of commands remembered is 10. See Chapter 7%@BO:   3396c@%, "Switches, Assignments, and
the TOOLS.INI File," for information on how to set switches.%@NL@%
%@NL@%
%@CR:MSE23403@%%@4@%The %@AI@%Meta%@AE@% function (F9) is a prefix, similar to %@AI@%r%@AE@%%@AI@% Arg%@AE@%, which reverses or%@EH@%
alters the effect of a function. You can cancel the effect of the %@AI@%Undo%@AE@%
function with the command sequence %@AI@%Meta%@AE@%%@AI@%Undo%@AE@%:%@NL@%
%@NL@%
     %@AS@%F9 ALT+BKSP%@AE@%%@NL@%
%@NL@%
%@CR:MSE23404@%%@4@%This variation on the %@AI@%Undo%@AE@% function is often called "Redo." If you undo a%@EH@%
series of commands, you can recall each of these commands by using %@AI@%Meta Undo%@AE@%
repeatedly. %@AI@%Undo%@AE@% walks backward through the history of the file (it restores
an earlier state); %@AI@%Meta Undo%@AE@% walks forward.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE23500@%%@3@%%@AB@%2.3.5  Using Delete to Move Text%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE23501@%%@4@%The %@AI@%Delete%@AE@% function can be used to move text as well as delete it. The last%@EH@%
text deleted is placed on the "Clipboard." The Clipboard holds text selected
by either the %@AI@%Copy%@AE@% or %@AI@%Delete%@AE@% function. Pressing SHIFT+INS invokes the %@AI@%Paste%@AE@%
function, which inserts the contents of the Clipboard into the file at the
present cursor position.%@NL@%
%@NL@%
%@CR:MSE23502@%%@4@%In this section, %@AI@%Delete%@AE@% will be used to move two complete lines of text.%@EH@%
Consider the current text:%@NL@%
%@NL@%
     It's mind over matter.%@NL@%
     What is mind?%@NL@%
     No matter.%@NL@%
     What is matter?%@NL@%
     Never mind.%@NL@%
%@NL@%
%@CR:MSE23503@%%@4@%Move the cursor to the beginning of the fourth line. Select the bottom two%@EH@%
lines by pressing ALT+A and then pressing the DOWN key twice. You should see
the bottom two lines highlighted, as shown in Figure 2.3%@FN@%
Figure 2.3 is found on page 13 in the printed version of this guide.%@EF@% below.%@NL@%
%@NL@%
%@CR:MSE23504@%%@4@%Now invoke the %@AI@%Delete%@AE@% function by pressing DEL. The two lines disappear. The%@EH@%
%@AI@%Delete%@AE@% function deletes the characters you highlight.%@NL@%
%@NL@%
%@CR:MSE23505@%%@4@%Having deleted a block of characters, you are ready to use the %@AI@%Paste%@AE@%%@EH@%
function (SHIFT+INS) to insert the deleted text at a new location. Move the
cursor to the beginning of the top line and press SHIFT+INS. You should see
the following text:%@NL@%
%@NL@%
     What is matter?%@NL@%
     Never mind.%@NL@%
     It's mind over matter.%@NL@%
     What is mind?%@NL@%
     No matter.%@NL@%
%@NL@%
%@CR:MSE23506@%%@4@%You can change the shape of the highlighted region by using the %@AI@%Boxstream%@AE@%%@EH@%
function (CTRL+B), which changes the region into a rectangular area. See
Chapter 3%@BO:    d239@% for more information.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE23600@%%@3@%%@AB@%2.3.6  Finding Strings with the Psearch Function%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE23601@%%@4@%The %@AI@%Psearch%@AE@% function takes different kinds of arguments but performs the%@EH@%
same general operation with each──searching for a string of text. The term
%@AI@%Psearch%@AE@% stands for "plus search," and means the same thing as "forward
search." This function, which is assigned to the F3 key, takes both text
arguments and cursor-movement arguments. You can ask the editor to locate
the next occurrence of the word %@AS@%mind%@AE@% by typing the word in as a text
argument. Move the cursor to the beginning of the file, then try the
following sequence of keystrokes:%@NL@%
%@NL@%
%@CR:MSE23602@%  1. Press ALT+A%@NL@%
  2. Type the following text: %@AS@%mind%@AE@%%@NL@%
  3. Press F3%@NL@%
%@NL@%
%@CR:MSE23603@%%@4@%As you type the word, it appears on the dialog line──the line just above the%@EH@%
status line at the bottom of the screen. As soon as you press ALT+A and type
the first character, the prompt %@AS@%Arg:%@AE@% appears on the dialog line. You can
retype  characters on the dialog line by pressing BKSP (the backspace key).%@NL@%
%@NL@%
%@CR:MSE23604@%%@4@%You can achieve the same result by moving the cursor to the beginning of the%@EH@%
word %@AS@%mind%@AE@% on the screen, then highlighting the word with the following
sequence of keystrokes:%@NL@%
%@NL@%
     %@AS@%ALT+A RIGHT RIGHT RIGHT RIGHT F3%@AE@%%@NL@%
%@NL@%
%@CR:MSE23606@%%@4@%An even easier way of selecting the word is to give the keystroke sequence%@EH@%
ALT+A F3, which selects the word at the current cursor location. This word
(all characters up to the first blank or new-line character) becomes the
search string.%@NL@%
%@NL@%
%@CR:MSE23607@%%@4@%Often when you use the %@AI@%Psearch%@AE@% function, you want to look repeatedly for%@EH@%
some text string. To search for the text string most recently specified,
press F3 by itself.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE23700@%%@3@%%@AB@%2.3.7  Inserting Spaces and Lines%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE23701@%%@4@%You'll sometimes need to insert blank lines. There are two ways to do this:%@EH@%%@NL@%
%@NL@%
%@CR:MSE23702@%  1. Press ENTER. When insert mode is on, pressing ENTER inserts a new-line%@NL@%
     character. (Recall that you turn insert mode on and off by pressing%@NL@%
     INS.) Any text to the right of the cursor moves down into the newly%@NL@%
     created line.%@NL@%
%@NL@%
  2. Invoke %@AI@%Linsert%@AE@% (line insert) by pressing CTRL+N. Regardless of cursor%@NL@%
     position, the %@AI@%Linsert%@AE@% function inserts a blank line directly above the%@NL@%
     current line.%@NL@%
%@NL@%
%@CR:MSE23703@%%@4@%%@AI@%Linsert%@AE@% also accepts an argument. Invoke %@AI@%Arg%@AE@% (ALT+A), move the cursor, and%@EH@%
then invoke %@AI@%Linsert%@AE@% (CTRL+N). %@AI@%Linsert%@AE@% inserts as many blank spaces in front
of the highlighted area as the number of characters you highlighted.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE23800@%%@3@%%@AB@%2.3.8  Exiting the Editor%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE23801@%%@4@%Press F8 to leave the editor. The F8 key sequence invokes the %@AI@%Exit%@AE@% function,%@EH@%
which automatically saves any changes you have made to the file and exits.
The sequence F9 F8 exits without saving, and the sequence ALT+A ALT+A F2
saves your most recent changes to the file without exiting.%@NL@%
%@NL@%
%@CR:MSE23802@%%@4@%See Section 4.1%@BO:   125dc@%, "Basic File Operations," for more information on%@EH@%
loading and saving files.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE24000@%%@2@%%@AB@%2.4  Getting Help%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE24001@%%@4@%One of the outstanding features of the editor is on-line Help. On-line Help%@EH@%
displays the information you need directly on the screen without your having
to exit the editor. You can quickly get information about any editing
function.%@NL@%
%@NL@%
%@CR:MSE24002@%%@4@%To use the basic on-line Help, you must first run the installation procedure%@EH@%
for the editor and follow all directions. The setup program for this
Microsoft language product should install the editor for you. Installing the
editor is important because it copies the Help files to your directories and
properly configures the editor's initialization file, TOOLS.INI.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE24100@%%@3@%%@AB@%2.4.1  Starting On-Line Help%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE24101@%%@4@%Press SHIFT+F1 to bring up the first Help screen. On-line Help is largely%@EH@%
self-explanatory. The first screen gives a list of the basic Help commands
and provides access to other parts of the Help system.%@NL@%
%@NL@%
%@CR:MSE24102@%%@4@%Press F1 for context-sensitive Help. "Context-sensitive Help" displays a%@EH@%
Help screen for the word at the current cursor position. The entire word is
used──even if the cursor is in the middle of the word. If the cursor is on a
space, the Help system uses the word immediately preceding the space. Thus
you can type a word, press F1, and get Help for that word.%@NL@%
%@NL@%
%@CR:MSE24103@%%@4@%The editor searches through its list of Help files for a screen%@EH@%
corresponding to the word at the cursor position. If no screen exists for
the topic, the editor displays the first Help screen.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE24200@%%@3@%%@AB@%2.4.2  Moving through On-Line Help%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE24201@%%@4@%The first Help screen explains how to move between Help screens on different%@EH@%
topics. To move around within a Help topic, use the same keys (DIRECTION
keys, HOME, END, F3) that you use to move through a file. You can use PGUP
and PGDN  to move up or down a page at a time.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE24300@%%@3@%%@AB@%2.4.3  Leaving On-Line Help%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE24301@%%@4@%By default, the editor splits the screen into two windows when you bring up%@EH@%
a Help screen. You can move between windows by pressing F6. Moving from the
Help window to the editing window lets you continue editing while still
viewing Help information. To close the Help window, press ESC.%@NL@%
%@NL@%
%@CR:MSE24302@%%@4@%Section 7.2.5%@BO:   370ae@%, "Changing the Look and Feel of Help," explains how to%@EH@%
use Help without splitting the screen. If you use this technique, you leave
Help by press-ing F2 or ESC.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE25000@%%@2@%%@AB@%2.5  The Microsoft Editor's Command Line%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE25001@%%@4@%Use the following command line to start up the editor (the options are case%@EH@%
sensitive):%@NL@%
%@NL@%
     M «/D» «/e %@AI@%command%@AE@%» «/t» «%@AI@%files%@AE@%»%@NL@%
%@NL@%
%@CR:MSE25002@%%@4@%Begin the command line with the base of the editor's actual file name. For%@EH@%
example, if you are using the protected-mode version, the editor's file name
is MEP.EXE. (However, you can rename this file to M.EXE.)%@NL@%
%@NL@%
%@CR:MSE25003@%%@4@%The /D option prevents the editor from examining TOOLS.INI for%@EH@%
initialization settings (see Chapter 7%@BO:   3396c@%, "Switches, Assignments, and the
TOOLS.INI File," for more information).%@NL@%
%@NL@%
%@CR:MSE25004@%%@4@%The /e option enables you to specify a command upon start-up. The %@AI@%command%@AE@%%@EH@%
argument is a string that follows the same syntax rules as those given for
macros in Chapter 6%@BO:   28e3a@%, "Function Assignments and Macros." If %@AI@%command%@AE@% contains
a space, the entire string should be enclosed in quotation marks. To
represent embedded quotation marks, precede each quotation mark by a
backslash (\"). To represent a literal backslash, use two backslashes (\\).
For example, the system-level command%@NL@%
%@NL@%
     M /e "arg \"search \\\" string\" psearch" FILE.TXT%@NL@%
%@NL@%
%@CR:MSE25005@%%@4@%causes the editor to start up and execute the following command:%@EH@%%@NL@%
%@NL@%
     arg "search \" string" psearch%@NL@%
%@NL@%
%@CR:MSE25006@%%@4@%The /t option specifies that the names of any files following this option%@EH@%
are not retained in the editor's information file when the session
terminates. When you use the %@AI@%Information%@AE@% command at the next editing session
to list the most recently edited files, these names will not appear.%@NL@%
%@NL@%
%@CR:MSE25007@%%@4@%If a single %@AI@%file%@AE@% is specified, the editor attempts to load the file. If the%@EH@%
file does not yet exist, the editor asks you if you want to create the file.
If you type Y (yes), the editor creates the file. If you type another
character, the editor does not create the file, but loads the most recently
edited file or (if no files have been previously edited) exits.%@NL@%
%@NL@%
%@CR:MSE25008@%%@4@%If multiple %@AI@%files%@AE@% are specified, the first file is loaded; then, when you%@EH@%
invoke the %@AI@%Exit%@AE@% function, the editor saves the current file and loads the
next file in the list. If no %@AI@%files%@AE@% are specified, the editor attempts to
load the file you were editing when you last exited the editor.%@NL@%
%@NL@%
%@CR:MSE25009@%%@4@%You can specify multiple %@AI@%files%@AE@% by either typing in different file names%@EH@%
explicitly or by using the DOS wildcard characters, ? and *. For example,
the following command line causes the editor to load every file in the
current directory with a .TXT extension:%@NL@%
%@NL@%
     M *.txt%@NL@%
%@NL@%
%@CR:MSE2500A@%%@4@%On start-up, the status line displays at least four fields. The status line%@EH@%
can display up to thirteen fields. The first four fields listed below are
always displayed:%@NL@%
%@NL@%
%@CR:MSE2500B@%  1. Name of the file being edited.%@NL@%
%@NL@%
  2. Type of file (based on extension).%@NL@%
%@NL@%
  3. The length of the file in lines.%@NL@%
%@NL@%
  4. Cursor position or window position of upper-left corner.%@NL@%
%@NL@%
  5. The word %@AS@%modified%@AE@% if the file has been changed.%@NL@%
%@NL@%
  6. The letters %@AS@%NL%@AE@% if no carriage returns were found when the file was%@NL@%
     loaded (that is, if the file did not contain carriage returns to denote%@NL@%
     the end of each line, but used only line feeds).%@NL@%
%@NL@%
  7. The word %@AS@%insert%@AE@% if you are in insert mode.%@NL@%
%@NL@%
  8. The word %@AS@%meta%@AE@% if you have invoked the %@AI@%Meta%@AE@% function.%@NL@%
%@NL@%
  9. The word %@AS@%No-Edit%@AE@% if the file cannot be changed at any time during the%@NL@%
     editing session. Some of the internal files created by the editor, such%@NL@%
     as <information> and <assign>, fall into this category.%@NL@%
%@NL@%
 1    . The word %@AS@%RO-File%@AE@% if the file has the read-only attribute. (This%@NL@%
     attribute is set outside of the editor.) The file can be modified, but%@NL@%
     after being modified, it can be saved only under a different file name.%@NL@%
%@NL@%
 11. The word %@AS@%cancel%@AE@% if you recently invoked the %@AI@%Cancel%@AE@% function.%@NL@%
%@NL@%
 12. The letters %@AS@%BC%@AE@% if a background compilation is in progress under OS/2%@NL@%
     protected mode (or %@AS@%XX%@AE@% if the background compilation failed to begin).%@NL@%
%@NL@%
 13. The letters %@AS@%REC%@AE@% while a macro is being recorded.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE26000@%%@2@%%@AB@%2.6  Hints for Using the Editor%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE26001@%%@CR:MSE26002@%%@4@%Here are two hints to keep in mind as you learn to use the editor:%@EH@%%@NL@%
%@NL@%
%@CR:MSE26003@%  1. The Microsoft Editor names functions in a consistent way. Section 3.2%@BO:    df64@%,%@NL@%
     "Naming Conventions for Functions," explains the conventions. Table A.1%@NL@%
     lists editing functions by category.%@NL@%
%@NL@%
  2. If you forget which keystroke is associated with a function, use%@NL@%
     on-line Help for quick reference. If Help is installed, you can get%@NL@%
     function assignments by pressing SHIFT+F1 and then choosing the Current%@NL@%
     Assignments screen. If Help is not installed, pressing F1 takes you%@NL@%
     directly to this screen.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE30000@%%@1@%%@AB@%Chapter 3  Command Syntax%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@CR:MSE30001@%%@4@%If you've worked through Chapter 2%@BO:    7023@%, you have seen the flexibility of%@EH@%
Microsoft Editor commands. Many of the functions accept a variety of
arguments──text arguments, cursor-movement arguments──or no argument at all.
This chapter describes each argument type in detail. The chapter also
presents the syntax and naming conventions used throughout the manual.%@NL@%
%@NL@%
%@CR:MSE30002@%%@4@%Topics are covered in the following order:%@EH@%%@NL@%
%@NL@%
%@CR:MSE30003@%  ■  Entering a command%@NL@%
  ■  Function naming conventions%@NL@%
  ■  Argument types%@NL@%
  ■  Text arguments (%@AI@%numarg, markarg, textarg%@AE@%)%@NL@%
  ■  Highlighting a text argument%@NL@%
  ■  Cursor-movement arguments (%@AI@%streamarg, linearg, boxarg%@AE@%)%@NL@%
%@NL@%
%@NL@%
%@CR:MSE31000@%%@2@%%@AB@%3.1  Entering a Command%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE31001@%%@4@%Commands take two basic forms. You can invoke a function by itself, or you%@EH@%
can introduce an argument and then invoke a function.%@NL@%
%@NL@%
%@CR:MSE31002@%%@4@%Use the %@AI@%Arg%@AE@% prefix to introduce an argument. By default, %@AI@%Arg%@AE@% is assigned to%@EH@%
ALT+A (hold down the ALT key and press A). You can then type characters or
move the cursor to highlight part of the screen.%@NL@%
%@NL@%
%@CR:MSE31003@%%@4@%Finally, invoke the function you want by pressing the corresponding%@EH@%
keystroke. If you forget the keystroke, you can look it up in on-line Help.%@NL@%
%@NL@%
%@CR:MSE31004@%%@4@%The two basic forms of a command are summarized below:%@EH@%%@NL@%
%@NL@%
     %@AI@%Function%@AE@%
     %@AI@%Arg argument Function%@AE@%%@NL@%
%@NL@%
%@CR:MSE31006@%%@4@%Some functions also let you form a command in one or more of the following%@EH@%
three ways:%@NL@%
%@NL@%
%@CR:MSE31007@%  1. Some functions accept %@AI@%Arg%@AE@% with no argument: %@AI@%Arg%@AE@%%@AI@%Function%@AE@%.%@NL@%
%@NL@%
  2. Some functions accept %@AI@%Arg Arg%@AE@% (press ALT+A twice). The sequence %@AI@%Arg Arg%@AE@%%@NL@%
     can introduce a function just as %@AI@%Arg%@AE@% does.%@NL@%
%@NL@%
  3. Some functions work differently when given the %@AI@%Meta%@AE@% prefix. You can%@NL@%
     toggle %@AI@%Meta%@AE@% on and off by pressing F9. When %@AI@%Meta%@AE@% is on, the word %@AS@%meta%@AE@%%@NL@%
     appears on the status line.%@NL@%
%@NL@%
%@CR:MSE31008@%%@4@%See Chapter 4%@BO:   120e2@%, "A Survey of the Editor's Commands," and Table A.3 for%@EH@%
information on what syntax is accepted by each function.%@NL@%
%@NL@%
%@CR:MSE31009@%%@4@%Once you begin entering a command, you can cancel %@AI@%Arg%@AE@% and any argument by%@EH@%
invoking the %@AI@%Cancel%@AE@% function (ESC). The Cancel function is also useful for
clearing the dialog line.%@NL@%
%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@AI@%NOTE%@AE@%%@NL@%
   Throughout this manual, function names are given in italics and are%@NL@%
   initial capped (for example: %@AI@%Paste%@AE@%). %@AI@%Argument%@AE@% types are given in italics%@NL@%
   and are lowercase (for example: %@AI@%textarg%@AE@%).%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@NL@%
%@CR:MSE32000@%%@2@%%@AB@%3.2  Naming Conventions for Functions%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE32001@%%@4@%The Microsoft Editor follows a consistent pattern of function names.%@EH@%
Function names often begin with the letters P, M, S, L, or Cur, which can
have the following meanings:%@NL@%
%@NL@%
%@CR:MSE32002@%%@AB@%Initial Letter(s)           Usage%@AE@%%@NL@%
%@NL@%
%@NL@%
P                           Plus. Indicates forward movement of some kind.%@NL@%
                            For example, %@AI@%Psearch%@AE@% is the forward-search%@NL@%
                            command, and %@AI@%Pword%@AE@% moves the cursor forward one%@NL@%
                            word.%@NL@%
%@NL@%
M                           Minus. Indicates backward movement of some kind.%@NL@%
                            For example, %@AI@%Msearch%@AE@% is the backward-search%@NL@%
                            command, and %@AI@%Mword%@AE@% moves the cursor backward one%@NL@%
                            word.%@NL@%
%@NL@%
S                           Stream. Indicates a stream-oriented,%@NL@%
                            block-of-text function. This category includes%@NL@%
                            %@AI@%Sinsert%@AE@%, which inserts spaces in the stream of%@NL@%
                            text between two cursor positions, and %@AI@%Sdelete%@AE@%,%@NL@%
                            which deletes the stream. Without an argument,%@NL@%
                            these functions insert or delete a single space.%@NL@%
%@NL@%
L                           Line. Indicates a line-and-box-oriented%@NL@%
                            function. This category includes %@AI@%Linsert%@AE@%, which%@NL@%
                            inserts spaces in the exact area highlighted on%@NL@%
                            screen, and %@AI@%Ldelete%@AE@%, which deletes it. Without%@NL@%
                            an argument, these functions insert or delete a%@NL@%
                            line.%@NL@%
%@NL@%
Cur                         Current. Indicates one of the special insertion%@NL@%
                            functions, such as %@AI@%Curdate%@AE@% (insert current date)%@NL@%
                            and %@AI@%Curfile%@AE@% (insert current file name).%@NL@%
%@NL@%
%@NL@%
%@CR:MSE33000@%%@2@%%@AB@%3.3  Argument Types%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE33001@%%@4@%There are two basic ways to enter arguments: you can enter text directly as%@EH@%
part of the command (text argument), or you can use cursor movement to
highlight characters on the screen (cursor-movement argument). Each of these
two methods has several variations, as shown in the following list:%@NL@%
%@NL@%
%@CR:MSE33002@%  1. Text argument. After you invoke %@AI@%Arg%@AE@% (ALT+A), continue to type%@NL@%
     characters. These characters appear on the dialog line (the line next%@NL@%
     to the bottom of the screen). You can give three different kinds of%@NL@%
     text arguments:%@NL@%
%@NL@%
     a.   A %@AI@%numarg%@AE@%, which consists of a string of digits.%@NL@%
%@NL@%
     b.   A %@AI@%markarg%@AE@%, which is a string containing the name of a previously%@NL@%
          defined file marker.%@NL@%
%@NL@%
     c.   A %@AI@%textarg%@AE@%, which is any text argument not recognized as a %@AI@%numarg%@AE@%%@NL@%
          or %@AI@%markarg%@AE@%.%@NL@%
%@NL@%
  2. Cursor-movement argument. After you invoke %@AI@%Arg%@AE@% (ALT+A), the current%@NL@%
     cursor position is highlighted. Highlight more characters by moving the%@NL@%
     cursor to a new position. You can give three different kinds of%@NL@%
     cursor-movement arguments:%@NL@%
%@NL@%
     a.   A %@AI@%linearg%@AE@%, in which the old and new cursor positions are in%@NL@%
          different lines but the same column.%@NL@%
%@NL@%
     b.   A %@AI@%boxarg%@AE@%, in which the old and new cursor positions are in%@NL@%
          different columns.%@NL@%
%@NL@%
     c.   A %@AI@%streamarg%@AE@%, which can consist of any cursor movement.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE34000@%%@2@%%@AB@%3.4  Text Arguments (numarg, markarg, textarg)%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE34001@%%@4@%After you invoke %@AI@%Arg%@AE@% (ALT+A), you can enter a text argument by typing any%@EH@%
printable characters, including blank spaces. The first time you invoke %@AI@%Arg%@AE@%,
the following characters appear on the dialog line (the line next to the
bottom of the screen):%@NL@%
%@NL@%
     %@AS@%Arg [1]%@AE@%%@NL@%
%@NL@%
%@CR:MSE34002@%%@4@%If you press ALT+A again, the number in the brackets changes. Any characters%@EH@%
you type appear on the dialog line after %@AS@%Arg [1]%@AE@%.%@NL@%
%@NL@%
%@CR:MSE34003@%%@4@%When entering a text argument, you can edit, move through, or modify the%@EH@%
text argument in the following ways:%@NL@%
%@NL@%
%@CR:MSE34004@%  1. Erase a character by pressing BKSP.%@NL@%
%@NL@%
  2. Erase the character at the current cursor position with the %@AI@%Sdelete%@AE@%%@NL@%
     function (DEL).%@NL@%
%@NL@%
  3. Move back and forth nondestructively with LEFT and RIGHT. If you use%@NL@%
     RIGHT to move past the end of current input, the editor inserts the%@NL@%
     character from the corresponding position in the previous text%@NL@%
     argument.%@NL@%
%@NL@%
  4. Insert a space at the cursor position with the %@AI@%Sinsert%@AE@% function%@NL@%
     (CTRL+J).%@NL@%
%@NL@%
  5. Move to the beginning of the text with %@AI@%Begline%@AE@% (HOME) and to the end of%@NL@%
     the text with %@AI@%Endline%@AE@% (END).%@NL@%
%@NL@%
  6. Clear characters from the current cursor position to the end of the%@NL@%
     line with the %@AI@%Arg%@AE@% function (ALT+A).%@NL@%
%@NL@%
%@CR:MSE34005@%%@4@%To repeat the most recently entered text argument, invoke the %@AI@%Lasttext%@AE@%%@EH@%
function, which by default is assigned to CTRL+O. When you use %@AI@%Lasttext%@AE@%, the
%@AI@%Arg%@AE@% prefix is unnecessary.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE34100@%%@3@%%@AB@%3.4.1  The numarg Type%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE34101@%%@4@%A %@AI@%numarg%@AE@% is a string of digits that you enter as a text argument. Each of%@EH@%
the three following examples is a %@AI@%numarg%@AE@%:%@NL@%
%@NL@%
     %@AS@%3%@AE@%%@NL@%
     %@AS@%11%@AE@%%@NL@%
     %@AS@%45%@AE@%%@NL@%
%@NL@%
%@CR:MSE34102@%%@4@%The number must be a valid decimal integer. A %@AI@%numarg%@AE@% is evaluated as a%@EH@%
number and not as literal text. Typically, it is used to indicate a range of
lines starting with the cursor position. For example, the following command
sequence deletes 10 lines starting with the cursor position:%@NL@%
%@NL@%
%@CR:MSE34103@%  1. Invoke %@AI@%Arg%@AE@% (press ALT+A)%@NL@%
%@NL@%
  2. Type the following text: %@AS@%10%@AE@%%@NL@%
%@NL@%
  3. Invoke %@AI@%Ldelete%@AE@% (press CTRL+Y)%@NL@%
%@NL@%
%@CR:MSE34104@%%@4@%Some functions accept text arguments but do not recognize a %@AI@%numarg%@AE@%. These%@EH@%
functions treat a %@AI@%numarg%@AE@% as an ordinary %@AI@%textarg%@AE@%.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE34200@%%@3@%%@AB@%3.4.2  The markarg Type%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE34201@%%@4@%A %@AI@%markarg%@AE@% is a file-marker name you have previously defined with the %@AI@%Mark%@AE@%%@EH@%
function (CTRL+M). See Section 4.4%@BO:   1839c@%, "Using File Markers," for information
about %@AI@%Mark%@AE@%.%@NL@%
%@NL@%
%@CR:MSE34202@%%@4@%Once defined, you can enter the marker name as a %@AI@%markarg%@AE@%. The name is not%@EH@%
treated as literal text, but is interpreted as an actual file position. For
example, the following command sequence copies all text between the cursor
position and the file position previously marked as %@AS@%P1%@AE@%:%@NL@%
%@NL@%
%@CR:MSE34203@%  1. Invoke %@AI@%Arg%@AE@% (press ALT+A)%@NL@%
%@NL@%
  2. Enter the following text: %@AS@%P1%@AE@%%@NL@%
%@NL@%
  3. Invoke %@AI@%Copy%@AE@%(press CTRL+INS)%@NL@%
%@NL@%
%@CR:MSE34204@%%@4@%Many functions accept text arguments but do not recognize a %@AI@%markarg%@AE@%. In%@EH@%
these cases, the %@AI@%markarg%@AE@% is treated as an ordinary %@AI@%textarg%@AE@%.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE34300@%%@3@%%@AB@%3.4.3  The textarg Type%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE34301@%%@4@%A %@AI@%textarg%@AE@% is similar to a %@AI@%numarg%@AE@% or %@AI@%markarg%@AE@%. The only difference is that the%@EH@%
%@AI@%textarg%@AE@% has no special meaning; it is interpreted by the function as literal
text. For example, the following sequence finds the next occurrence of the
string %@AS@%Happy%@AE@%%@AS@%New Year%@AE@%:%@NL@%
%@NL@%
%@CR:MSE34302@%  1. Invoke %@AI@%Arg%@AE@% (press ALT+A)%@NL@%
%@NL@%
  2. Type the following: %@AS@%Happy New Year%@AE@%%@NL@%
%@NL@%
  3. Invoke %@AI@%Psearch%@AE@% (press F3)%@NL@%
%@NL@%
%@CR:MSE34303@%%@4@%A %@AI@%textarg%@AE@% can either be typed in directly or highlighted on the screen. The%@EH@%
next section describes how to highlight a text argument.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE35000@%%@2@%%@AB@%3.5  Highlighting a Text Argument%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE35001@%%@4@%If the text argument already appears in the editing screen, you can save%@EH@%
typing by highlighting the text. You can highlight all or part of one line;
a text argument cannot consist of multiple lines.%@NL@%
%@NL@%
%@CR:MSE35002@%%@4@%To highlight a text argument:%@EH@%%@NL@%
%@NL@%
%@CR:MSE35003@%  1. Move the cursor to the first character in the text argument.%@NL@%
%@NL@%
  2. Invoke %@AI@%Arg%@AE@% (press ALT+A).%@NL@%
%@NL@%
     The current cursor position defines the "initial cursor position." As%@NL@%
     you move the cursor, characters between the initial cursor position and%@NL@%
     the new cursor position are highlighted.%@NL@%
%@NL@%
  3. Move the cursor to the right until all the desired text is highlighted.%@NL@%
%@NL@%
  4. Invoke the desired function. The editor passes the highlighted%@NL@%
     characters to this function, just as if you had directly typed in the%@NL@%
     highlighted characters.%@NL@%
%@NL@%
%@CR:MSE35004@%%@4@%For example, the highlighted area in Figure 3.1%@EH@%%@FN@%
Figure 3.1 is found on page 25 in the printed version of this guide.%@EF@% defines the text argument
%@AS@%pascal MoveCur%@AE@%.%@NL@%
%@NL@%
%@CR:MSE35005@%%@4@%Even if the highlighted text represents a legitimate %@AI@%numarg%@AE@% or %@AI@%markarg%@AE@%, it%@EH@%
will be interpreted by the function as a straight %@AI@%textarg%@AE@%. That is, a %@AI@%numarg%@AE@%
or %@AI@%markarg%@AE@% must be typed in on the status line; it cannot be selected from
the body of text.%@NL@%
%@NL@%
%@CR:MSE35006@%%@4@%Highlighting a %@AI@%textarg%@AE@% is a special case of a cursor-movement argument. The%@EH@%
next section discusses the other kinds of cursor-movement arguments.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE36000@%%@2@%%@AB@%3.6  Cursor-Movement Arguments (linearg, boxarg, streamarg)%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE36001@%%@4@%You enter a cursor-movement argument by invoking %@AI@%Arg%@AE@% (ALT+A) and moving the%@EH@%
cursor. When you invoke %@AI@%Arg%@AE@%, the current cursor position is marked with a
reverse-video highlight. This position is called the "initial cursor
position." As you move the cursor, characters between the initial cursor
position and the new cursor position are highlighted.%@NL@%
%@NL@%
%@CR:MSE36002@%%@4@%When the initial and new cursor positions are on different lines, you can%@EH@%
high-light regions by one of two different modes:%@NL@%
%@NL@%
%@CR:MSE36003@%  ■  In "box mode," the editor highlights either complete lines (if the new%@NL@%
     and initial cursor position are in the same column) or rectangular%@NL@%
     areas. In box mode, you can select complete lines, or highlight,%@NL@%
     delete, and insert columns without affecting the surrounding text. In%@NL@%
     box mode, a cursor-movement argument is either a %@AI@%linearg%@AE@% or %@AI@%boxarg%@AE@%, as%@NL@%
     explained in Sections 3.6.1%@BO:   11355@% and 3.6.2%@BO:   115ce@%.%@NL@%
%@NL@%
  ■  In "stream mode," the editor highlights text the way most text editors%@NL@%
     do. The highlighted region includes all text between the two positions,%@NL@%
     according to their sequence in the file. This region is usually not%@NL@%
     rectangular. In stream mode, a cursor-movement argument is always a%@NL@%
     %@AI@%streamarg%@AE@%, as explained in Section 3.6.3%@BO:   119d6@%, "The streamarg Type."%@NL@%
%@NL@%
%@CR:MSE36004@%%@4@%By default, the editor uses stream mode. You can toggle back and forth%@EH@%
between the two modes by invoking the %@AI@%Boxstream%@AE@% function (CTRL+B). You can
even invoke %@AI@%Boxstream%@AE@% while in the middle of creating a cursor-movement
argument──doing so changes the highlighting instantly.%@NL@%
%@NL@%
%@CR:MSE36005@%%@4@%To repeat the most recently entered cursor-movement argument, invoke the %@EH@%
%@AI@%Lastselect%@AE@% function, which by default is assigned to CTRL+U. When you use
%@AI@%Lastselect%@AE@%, the %@AI@%Arg%@AE@% prefix is unnecessary.%@NL@%
%@NL@%
%@CR:MSE36006@%%@4@%If you create a cursor-movement argument and then type a character, the%@EH@%
editor removes the highlighted area and replaces it with the character
typed. A similar result occurs when you create a cursor-movement argument
and then invoke the %@AI@%Paste%@AE@% function──the highlighted area is replaced by the
contents of the Clipboard.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE36100@%%@3@%%@AB@%3.6.1  The linearg Type%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE36101@%%@4@%A %@AI@%linearg%@AE@% is defined when the new cursor position is in the same column but%@EH@%
on a different line from the initial cursor position. The editor must be in
box mode. The editor responds by highlighting all lines between the two
cursor positions, including the lines that the cursor positions are on. For
example, the display in Figure 3.2%@FN@%
Figure 3.2 is found on page 26 in the printed version of this guide.%@EF@% is produced by invoking %@AI@%Arg%@AE@% (ALT+A) and
then pressing DOWN three times.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE36200@%%@3@%%@AB@%3.6.2  The boxarg Type%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE36201@%%@4@%A %@AI@%boxarg%@AE@% is a rectangular area on the screen. The two corners of the area%@EH@%
are determined by the initial and new cursor positions. A %@AI@%boxarg%@AE@% is defined
when the two positions are in different columns (and possibly different
lines). The editor must be in box mode.%@NL@%
%@NL@%
%@CR:MSE36202@%%@4@%After invoking %@AI@%Arg%@AE@% (ALT+A), you can move the cursor left or right. The left%@EH@%
edge of the box includes the leftmost of the two cursor positions. The right
edge of the box includes the column just to the left of other cursor
positions. The box contains parts of all lines, inclusive, between the two
positions.%@NL@%
%@NL@%
%@CR:MSE36203@%%@4@%For example, the display shown in Figure 3.3%@EH@%%@FN@%
Figure 3.3 is found on page 27 in the printed version of this manual.%@EF@% is produced by invoking %@AI@%Arg%@AE@%
and then moving the cursor 3 lines down and 16 columns over.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE36300@%%@3@%%@AB@%3.6.3  The streamarg Type%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE36301@%%@4@%A %@AI@%streamarg%@AE@% consists of text between the initial cursor and the new cursor%@EH@%
positions. When the editor is in stream mode, every cursor-movement argument
is a %@AI@%streamarg%@AE@%. You toggle between box and stream mode by invoking %@AI@%Boxstream%@AE@%
(CTRL+B).%@NL@%
%@NL@%
%@CR:MSE36302@%%@4@%After pressing ALT+A, you can move the cursor in any direction to create a %@EH@%
%@AI@%streamarg%@AE@%. The %@AI@%streamarg%@AE@% is shown as highlighted characters.%@NL@%
%@NL@%
%@CR:MSE36303@%%@4@%If you move the cursor forward (that is, to the right or down), the%@EH@%
%@AI@%streamarg%@AE@% includes the character at the initial cursor position. If you move
the cursor backward (that is, to the left or up), the %@AI@%streamarg%@AE@% does %@AI@%not%@AE@%
include the character at the initial cursor position; the %@AI@%streamarg%@AE@% starts
at the preceding character.%@NL@%
%@NL@%
%@CR:MSE36304@%%@4@%When a %@AI@%streamarg%@AE@% spans multiple lines, it includes some characters that a %@EH@%
%@AI@%boxarg%@AE@% does not. Specifically, a multiline %@AI@%streamarg%@AE@% includes the following:%@NL@%
%@NL@%
%@CR:MSE36305@%  1. All characters from the first cursor position to the end of the line%@NL@%
%@NL@%
  2. All characters on the lines between the two cursor positions%@NL@%
%@NL@%
  3. All characters on the line of the second cursor position, up to but not%@NL@%
     including the cursor position itself%@NL@%
%@NL@%
%@CR:MSE36306@%%@4@%For example, the display shown in Figure 3.4%@EH@%%@FN@%
Figure 3.4 is found on page 27 in the printed version of this guide.%@EF@% is produced with the same
cursor movement used in Figure 3.3, but with stream mode on.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE40000@%%@1@%%@AB@%Chapter 4  A Survey of the Editor's Commands%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@CR:MSE40001@%%@4@%The Microsoft Editor has all the standard features of a programmer's editor.%@EH@%
It lets you move quickly through a file, move blocks of text, search for
strings, and handle multiple files. In addition, the Microsoft Editor allows
you to use different windows for viewing more than one file or more than one
part of the same file. The Microsoft Editor can also invoke compilers and
assemblers, then display each compilation error.%@NL@%
%@NL@%
%@CR:MSE40002@%%@4@%This chapter expands on the editing topics introduced in Chapter 2%@BO:    7023@%. For a%@EH@%
complete list of the command syntax for every function, see Appendix A%@BO:   5d119@%,
"Reference Tables." This chapter covers topics in the following order:%@NL@%
%@NL@%
%@CR:MSE40003@%  ■  Basic file operations%@NL@%
  ■  Moving through a file%@NL@%
  ■  Inserting, copying, and deleting text%@NL@%
  ■  Using file markers%@NL@%
  ■  Searching and replacing%@NL@%
  ■  Compiling%@NL@%
  ■  Using editing windows%@NL@%
  ■  Working with multiple files%@NL@%
  ■  Printing all or part of a file%@NL@%
%@NL@%
%@NL@%
%@CR:MSE41000@%%@2@%%@AB@%4.1  Basic File Operations%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE41001@%%@4@%This section discusses how to work with files in general and how to use%@EH@%
internal files called "pseudo files."%@NL@%
%@NL@%
%@NL@%
%@CR:MSE41100@%%@3@%%@AB@%4.1.1  File Commands%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE41101@%%@4@%File operations are basic to all work with the editor. You use file%@EH@%
operations to save your work, load in a new text file, or completely exit
from the editor.%@NL@%
%@NL@%
%@CR:MSE41102@%%@4@%Chapter 2%@BO:    7023@% described how to save the current file and exit from the editor.%@EH@%
However, the Microsoft Editor supports a number of other file operations.
The list below shows how to use some of the most common file operations:%@NL@%
%@CR:MSE41103@%%@NL@%
%@TH:   24   1333  2 42 34 @%
%@AB@%Command     %@AE@%
%@AB@%(and Default Keystrokes)                  Description%@AE@%

%@AI@%Exit%@AE@% (F8)                                 Exits editor after saving current
                                          file

%@AI@%Meta Exit%@AE@% (F9  F8)                        Exits editor without saving

%@AI@%Arg Arg Setfile%@AE@% (ALT+A ALT+A F2)          Saves current file without exiting

%@AI@%Arg Arg textarg Setfile%@AE@%                   Saves current file under the file
(ALT+A ALT+A %@AI@%textarg%@AE@% F2)                  name (%@AI@%textarg%@AE@%) without exiting

%@AI@%Arg textarg Setfile%@AE@% (ALT+A %@AI@%textarg%@AE@% F2)    Loads another file (entered as
                                          %@AI@%textarg%@AE@%) into the editing window

%@AI@%Arg Arg textarg Paste%@AE@%                     Merges (copies) another file
(ALT+A ALT+A %@AI@%textarg%@AE@% SHIFT+INS)           (entered as%@AI@%textarg%@AE@%) into current
                                          file──the new file is inserted at
                                          the cursor position

%@AI@%Refresh%@AE@% (SHIFT+F7)                        Discards most recent changes to
                                          current file and rereads file from
                                          disk
%@TE:   24   1333  2 42 34 @%
%@NL@%
%@NL@%
%@CR:MSE41104@%%@4@%%@AB@%Example%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE41105@%%@4@%As explained in Chapter 3%@BO:    d239@%, a %@AI@%textarg%@AE@% is simply an argument you type in%@EH@%
directly. For example, to load the file SAMPLE.TXT, you would follow these
steps:%@NL@%
%@NL@%
%@CR:MSE41106@%  1. Invoke the %@AI@%Arg%@AE@% function (press ALT+A)%@NL@%
  2. Type the following file name: %@AS@%SAMPLE.TXT%@AE@%%@NL@%
  3. Invoke the %@AI@%Setfile%@AE@% function (press F2)%@NL@%
%@NL@%
%@CR:MSE41107@%%@4@%Each of the operations listed above is frequently useful, yet some should be%@EH@%
used with caution. For example, you should only exit without saving when you
have accidentally altered a file you do not want to change, or when you have
made many mistakes during the editing session. When you exit without saving,
all the work you did since the last save operation is discarded.%@NL@%
%@NL@%
%@CR:MSE41108@%%@4@%Conversely, you may wish to save without leaving the editor. This operation%@EH@%
is usually safe, unless the current file is one that should not be changed.
Saving a file writes all the changes you made out to the disk. If your
system is vulnerable to power failures or other kinds of system failure, it
is a good idea to save your work often.%@NL@%
%@NL@%
%@CR:MSE41109@%%@4@%Merging and loading a file are not the same. Merging a file copies the%@EH@%
contents of another file and inserts it into the current file. Loading a
file first saves the current file (assuming the %@AB@%autosave%@AE@% switch is on), then
restarts the editing session with a new file.%@NL@%
%@NL@%
%@CR:MSE4110A@%%@4@%The editor supports other variations of these operations described above.%@EH@%
See Table A.3, under the %@AI@%Exit%@AE@% and %@AI@%Setfile%@AE@% functions, for more information.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE41200@%%@3@%%@AB@%4.1.2  Special Syntax for Setfile%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE41201@%%@4@%A text argument passed to %@AI@%Setfile%@AE@% can take a number of different forms: a%@EH@%
file name, a file name with a DOS  wildcard character (* or ?), the name of
a directory, or the name of a disk drive. If the text argument is a
directory name, the editor changes the current directory. If the argument is
a drive name, the editor changes the current drive.%@NL@%
%@NL@%
%@CR:MSE41202@%%@4@%File names can be complete path names and can include environment variables%@EH@%
defined with the system-level SET command. The %@AI@%Setfile%@AE@% function interprets
an environment variables as a list of directories to search for a file. You
enter an environment variable using the syntax%@NL@%
%@NL@%
     %@AB@%$%@AE@%%@AI@%environ%@AE@%%@AB@%:%@AE@%%@AI@%filename%@AE@%%@NL@%
%@NL@%
%@CR:MSE41204@%%@4@%in which %@AI@%environ%@AE@% is the name of an environment variable. For example, the%@EH@%
following actions cause the editor to search the INIT environment variable
to find the TOOLS.INI file and load it:%@NL@%
%@NL@%
%@CR:MSE41205@%  1. Invoke the %@AI@%Arg%@AE@% function (press ALT+A)%@NL@%
  2. Type the following file name: %@AS@%$INIT:tools.ini%@AE@%%@NL@%
  3. Invoke the %@AI@%Setfile%@AE@% function (press F2)%@NL@%
%@NL@%
%@CR:MSE41206@%%@4@%You can also use the environment-variable syntax with the %@AI@%Paste%@AE@% function%@EH@%
when you use this function to merge a file.%@NL@%
%@NL@%
%@CR:MSE41207@%%@4@%Finally, you can switch to a recently edited file by using a short name. A%@EH@%
"short name" is a file name with no path or extension . The editor searches
its list of recently edited files to find a name that matches the short
name.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE41300@%%@3@%%@AB@%4.1.3  Pseudo Files%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE41301@%%@4@%A "pseudo file" is an internal editing file. It exists only in the%@EH@%
computer's memory and does not correspond to any disk file. The editor
treats a pseudo file just like any other file except for two important
differences:%@NL@%
%@NL@%
%@CR:MSE41302@%  1. The name of a pseudo file always appears in angle brackets (<>).%@NL@%
  2. A pseudo file may not be saved to disk under its own name.%@NL@%
%@NL@%
%@CR:MSE41303@%%@4@%Why use pseudo files? Pseudo files are useful for temporary storage. Pseudo%@EH@%
files are updated almost instantaneously because writing to RAM is much
faster than writing to disk. You can also insert the contents of a pseudo
file into the current file with the %@AI@%Paste%@AE@% command.%@NL@%
%@NL@%
%@CR:MSE41304@%%@4@%The editor creates several pseudo files of its own and gives them special%@EH@%
meaning. You can open these files just like any other with the %@AI@%Setfile%@AE@%
function.%@NL@%
%@CR:MSE41305@%%@NL@%
%@TH:   37   2148  1 28 48 @%
%@AB@%Pseudo File                 Description%@AE@%

<clipboard>                 Stores text selected by a copy or deletion. This
                            file can be modified; the modified file is then
                            inserted when you invoke %@AI@%Paste%@AE@%.

                            However, if you copy or delete text while
                            editing this file, the selected text is not
                            saved to the Clipboard but simply discarded.

<assign>                    Shows an updated list of function and switch
                            assignments. You can create new function and
                            switch assignments by directly modifying this
                            file; however, the assignments you make must
                            follow the syntax described in Chapter 6%@BO:   28e3a@%,
                            "Function Assignments and Macros."

<information-file>          Shows a list of files that have been previously
                            edited. This file cannot be modified. Each file
                            currently open for editing is listed along with
                            its length in lines.

<compile>                   Shows error messages from the last compilation
                            executed from within the editor. If the editor
                            is running under protected mode, the error
                            messages are dynamically updated while the
                            compilation is running.

<file-list>                 Shows a list of each file specified on the
                            editor's command line that has not yet been
                            opened. This file cannot be modified.

<record>                    Records each editing command when you record a
                            macro. The file is dynamic; it changes while you
                            view it. You cannot directly modify this file.
                            See Chapter 6%@BO:   28e3a@%, "Function Assignments and
                            Macros."
%@TE:   37   2148  1 28 48 @%
%@NL@%
%@CR:MSE42000@%%@2@%%@AB@%4.2  Moving through a File%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE42001@%%@4@%Chapter 2%@BO:    7023@%, "Edit Now," described how to the use DIRECTION keys to move%@EH@%
through a file one space at a time. The DIRECTION keys correspond to the
functions %@AI@%Up%@AE@%, %@AI@%Down%@AE@%, %@AI@%Right%@AE@%, and %@AI@%Left%@AE@%, to which you can assign different keys
if you wish. Chapter 2%@BO:    7023@% also presented the %@AI@%Begline%@AE@% function (HOME), which
moves the cursor to the first printable character in the current line.
Similar to the %@AI@%Begline%@AE@% function is the %@AI@%Endline%@AE@% function (END), which moves
the cursor just to the right of the last  printable character in the current
line.%@NL@%
%@NL@%
%@CR:MSE42002@%%@4@%Each of the four direction functions in the following list has a variation%@EH@%
that uses the %@AI@%Meta%@AE@% function as a prefix. Each function, when used in a
command with the %@AI@%Meta%@AE@% prefix, moves the cursor as far as possible within the
displayed screen (or window) without changing column position or causing the
screen to scroll.%@NL@%
%@NL@%
%@CR:MSE42003@%%@NL@%
%@AB@%Command     %@AE@%%@NL@%
%@AB@%(and Default Keystrokes)     Description%@AE@%%@NL@%
%@NL@%
%@AI@%Meta Up%@AE@% (F9  UP)             Moves the cursor to the top of the screen%@NL@%
%@NL@%
%@AI@%Meta Down%@AE@% (F9  DOWN)         Moves the cursor to the bottom of the screen%@NL@%
%@NL@%
%@AI@%Meta Left%@AE@% (F9  LEFT)         Moves the cursor to the left-most position on%@NL@%
                             the current line%@NL@%
%@NL@%
%@AI@%Meta Right%@AE@% (F9  RIGHT)       Moves the cursor to the right-most position on%@NL@%
                             the current line%@NL@%
%@NL@%
%@AI@%Meta Begline%@AE@% (F9  HOME)      Moves the cursor to column 1%@NL@%
%@NL@%
%@NL@%
%@CR:MSE42100@%%@3@%%@AB@%4.2.1  Scrolling at the Screen's Edge%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE42101@%%@4@%You can use the four direction functions (%@AI@%Up%@AE@%,  %@AI@%Down%@AE@%, %@AI@%Right%@AE@% , %@AI@%Left%@AE@%) to cause%@EH@%
scrolling. The screen (or current window) can scroll in all four
directions. Although the editor does not wrap lines that are wider than the
screen, you can have lines of text that are up to 250 characters wide. Use
the DIRECTION keys to scroll right and left when your text lines are wider
than the screen or current window.%@NL@%
%@NL@%
%@CR:MSE42102@%%@4@%Unlike some editors, the Microsoft Editor does not automatically scroll by%@EH@%
only one column or one line. Instead, the internal switches %@AB@%hscroll%@AE@%
(horizontal-scroll) and %@AB@%vscroll%@AE@% (vertical-scroll) control how fast the
editor scrolls. For example, if %@AB@%vscroll%@AE@% is set to 7, the editor advances the
screen position seven lines when you attempt to move the cursor off the
bottom of the screen. See Chapter 7%@BO:   3396c@% for more information on these switches.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE42200@%%@3@%%@AB@%4.2.2  Scrolling a Page at a Time%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE42201@%%@4@%The editor provides the %@AI@%Ppage%@AE@% (PGDN) and %@AI@%Mpage%@AE@% (PGUP) functions to move%@EH@%
through a file more quickly than you can by using the DIRECTION keys to move
one line or one column at a time.%@NL@%
%@NL@%
%@CR:MSE42202@%%@4@%The term "page" is defined as the amount of text that can be displayed in%@EH@%
the current window or screen. To advance one page forward through a file,
invoke the function %@AI@%Ppage%@AE@% (PGDN), which stands for "plus page."%@NL@%
%@NL@%
%@CR:MSE42203@%%@4@%The function %@AI@%Mpage%@AE@% (PGUP), which stands for "minus page," is the inverse of%@EH@%
%@AI@%Ppage%@AE@%, and it moves back through the file one page at a time.%@NL@%
%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@AI@%NOTE%@AE@%%@NL@%
   In Version 1.0 of the editor, the %@AI@%Ppage%@AE@% and %@AI@%Mpage%@AE@% functions took%@NL@%
   arguments. You can use them to help build a cursor-movement argument;%@NL@%
   they do not cancel the current argument. The editor also provides two new%@NL@%
   functions──%@AI@%Begfile%@AE@% and %@AI@%Endfile%@AE@%──that move to the beginning and end of the%@NL@%
   file. The next section describes these functions.%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@NL@%
%@CR:MSE42300@%%@3@%%@AB@%4.2.3  Moving to the Top or Bottom of the File%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE42301@%%@4@%The %@AI@%Begfile%@AE@% and %@AI@%Endfile%@AE@% functions provide the fastest cursor movement.%@EH@%%@NL@%
%@NL@%
%@CR:MSE42302@%%@4@%To move the cursor to the beginning of the file, invoke the %@AI@%Begfile%@AE@% function%@EH@%
by pressing CTRL+UP (the up-arrow key on the numeric keypad).%@NL@%
%@NL@%
%@CR:MSE42303@%%@4@%To move the cursor to the end of the file, invoke the %@AI@%Endfile%@AE@% function by%@EH@%
pressing CTRL+DOWN (the down-arrow key on the numeric keypad).%@NL@%
%@NL@%
%@NL@%
%@CR:MSE42400@%%@3@%%@AB@%4.2.4  Other File-Navigation Functions%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE42401@%%@4@%The following functions are useful for moving through a file:%@EH@%%@NL@%
%@NL@%
%@CR:MSE42402@%%@AB@%Function     %@AE@%%@NL@%
%@AB@%(and Default Keystrokes)    Description%@AE@%%@NL@%
%@NL@%
%@AI@%Pword%@AE@%  (CTRL+RIGHT)         Moves the cursor forward (plus) one word%@NL@%
%@NL@%
%@AI@%Mword%@AE@% (CTRL+LEFT)           Moves the cursor backward (minus) one word%@NL@%
%@NL@%
%@AI@%Ppara%@AE@%                       Moves the cursor forward (plus) one paragraph%@NL@%
%@NL@%
%@AI@%Mpara%@AE@%                       Moves the cursor backward (minus) one paragraph%@NL@%
%@NL@%
%@AI@%Mark%@AE@% (CTRL+M)               Defines or moves to a marker, or moves to a%@NL@%
                            specified line number%@NL@%
%@NL@%
%@CR:MSE42403@%%@4@%With the %@AI@%Mark%@AE@% function, you can define a marker or move to a marker. Markers%@EH@%
constitute a special topic that is discussed in Section 4.4%@BO:   1839c@%, "Using File
Markers."%@NL@%
%@NL@%
%@NL@%
%@CR:MSE43000@%%@2@%%@AB@%4.3  Inserting, Copying, and Deleting Text%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE43001@%%@4@%You may often need to move, copy, or delete blocks of text. The Microsoft%@EH@%
Editor is particularly powerful because it provides a variety of ways to
define a block of characters.%@NL@%
%@NL@%
%@CR:MSE43002@%%@4@%For example, you can delete a highlighted box, a range of lines, or a stream%@EH@%
of text between any two file positions. Sections 4.3.1%@BO:   162ea@%-4.3.4 discuss how to
work with blocks of text.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE43100@%%@3@%%@AB@%4.3.1  Inserting and Deleting Text%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE43101@%%@4@%Chapter 2%@BO:    7023@%, "Edit Now," described how to use the %@AI@%Paste%@AE@%, %@AI@%Insertmode%@AE@%, and%@EH@%
%@AI@%Delete%@AE@% functions to insert, move, and delete text.%@NL@%
%@NL@%
%@CR:MSE43102@%%@4@%The following list presents some of the most common commands that use the %@EH@%
%@AI@%Delete%@AE@% function:%@NL@%
%@NL@%
%@CR:MSE43103@%%@AB@%Command%@AE@%%@NL@%
%@AB@%(and Default Keystrokes)     Description%@AE@%%@NL@%
%@NL@%
%@AI@%Delete%@AE@% (DEL)                Deletes the character at the cursor position.%@NL@%
                            (This command does not join two lines of text,%@NL@%
                            even if the cursor is at the end of the line.)%@NL@%
%@NL@%
%@AI@%Arg Delete%@AE@% (ALT+A DEL)      Deletes all text from the cursor position to the%@NL@%
                            end of the line and joins the current line of%@NL@%
                            text with the next line.%@NL@%
%@NL@%
%@AI@%Arg cursor-movement%@AE@%         Deletes the highlighted area, whether it is a%@NL@%
%@AI@%Delete%@AE@% (ALT+A               %@AI@%linearg%@AE@%, %@AI@%streamarg%@AE@%, or %@AI@%boxarg%@AE@%. You can toggle%@NL@%
%@AI@%cursor-movement%@AE@% DEL)        between stream and box selection with the%@NL@%
                            %@AI@%Boxstream%@AE@% function (CTRL+B).%@NL@%
%@NL@%
%@CR:MSE43104@%%@4@%The %@AI@%Delete%@AE@% function copies all deleted text (except single-character%@EH@%
deletions) to the Clipboard. For any argument, the %@AI@%Meta Delete%@AE@% function
discards the text without copying it to the Clipboard.%@NL@%
%@NL@%
%@CR:MSE43105@%%@4@%To deal with whole lines of text, the Microsoft Editor provides the%@EH@%
following functions:%@NL@%
%@NL@%
%@CR:MSE43106@%%@AB@%Function%@AE@%%@NL@%
%@AB@%(and Default Keystrokes)    Description%@AE@%%@NL@%
%@NL@%
%@AI@%Ldelete%@AE@% (CTRL+Y)            Deletes a line of text or a %@AI@%boxarg%@AE@%%@NL@%
%@NL@%
%@AI@%Linsert%@AE@% (CTRL+N)            Inserts a line of text or a %@AI@%boxarg%@AE@%%@NL@%
%@NL@%
%@CR:MSE43107@%%@4@%You can use these functions in commands without an argument or prefix. These%@EH@%
functions also take cursor-movement arguments. They produce the same results
that %@AI@%Delete%@AE@% and %@AI@%Insert%@AE@% do, but they always act as if the editor were in box
mode.%@NL@%
%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@AI@%NOTE%@AE@%%@NL@%
   When you want to delete or copy large areas of text, you may find the%@NL@%
   DIRECTION keys move too slowly. However, you can define a highlighted%@NL@%
   area with any cursor-movement function that does not take an argument.%@NL@%
   Mpage (PGUP) and Ppage (PGDN) can be used this way. The Ppara and Mpara%@NL@%
   functions can also be used this way, but they do not have default key%@NL@%
   assignments.%@NL@%
%@NL@%
   To delete large amounts of text, you can also use a markarg or a numarg%@NL@%
   with a delete function. See Table A.3 for more information.%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@NL@%
%@CR:MSE43200@%%@3@%%@AB@%4.3.2  Copying Text%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE43201@%%@4@%To copy text without first deleting it, use the %@AI@%Copy%@AE@% function (CTRL+INS),%@EH@%
which copies a range of text into the <clipboard> pseudo file. Text in the
Clipboard is then inserted into the file when you invoke the %@AI@%Paste%@AE@% function.
The following list presents different commands that use the %@AI@%Copy%@AE@% function:%@NL@%
%@NL@%
%@CR:MSE43202@%%@AB@%Command     %@AE@%%@NL@%
%@AB@%(and Default Keystrokes)             Description%@AE@%%@NL@%
%@NL@%
%@AI@%Arg cursor-movementCopy%@AE@%              Copies the highlighted area into the%@NL@%
(ALT+A %@AI@%cursor-movement%@AE@% CTRL+INS)     Clipboard.%@NL@%
%@NL@%
%@AI@%Arg numarg Copy%@AE@%                      Copies the specified number of lines%@NL@%
(ALT+A %@AI@%numarg%@AE@% CTRL+INS)              into the Clipboard, beginning with the%@NL@%
                                     line that the cursor is on.%@NL@%
%@NL@%
%@AI@%Arg markarg Copy%@AE@%                     Copies the text between the specified%@NL@%
(ALT+A %@AI@%markarg%@AE@% CTRL+INS)             marker and the cursor into the%@NL@%
                                     Clipboard. The shape of this region%@NL@%
                                     changes depending on whether the editor%@NL@%
                                     is in box or stream mode.%@NL@%
%@NL@%
%@CR:MSE43203@%%@4@%The %@AI@%Paste%@AE@% function (SHIFT+INS) is useful both for moving and copying text.%@EH@%
To move text, first delete it and then invoke %@AI@%Paste%@AE@% after moving the cursor
to the destination.%@NL@%
%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@AI@%NOTE%@AE@%%@NL@%
   If you highlight an area on the screen and then invoke Paste, the editor%@NL@%
   deletes the highlighted area and replaces it with the contents of the%@NL@%
   Clipboard.%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@CR:MSE43204@%%@4@%See Section 4.4%@BO:   1839c@% for more information on markers.%@EH@%%@NL@%
%@NL@%
%@NL@%
%@CR:MSE43300@%%@3@%%@AB@%4.3.3  Other Insert Commands%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE43301@%%@4@%The following functions insert specific items at the current cursor position%@EH@%
(each function is a complete command). These functions do not have
preassigned keys; see Chapter 6%@BO:   28e3a@%, "Function Assignments and Macros," for
information on how to assign keys to functions.%@NL@%
%@NL@%
%@CR:MSE43302@%%@AB@%Function                     Description%@AE@%%@NL@%
%@NL@%
%@AI@%Curdate%@AE@%                     Inserts current date%@NL@%
%@NL@%
%@AI@%Curday%@AE@%                      Inserts current day of the week%@NL@%
%@NL@%
%@AI@%Curfile%@AE@%                     Inserts current file name%@NL@%
%@NL@%
%@AI@%Curfileext%@AE@%                  Inserts current file extension%@NL@%
%@NL@%
%@AI@%Curfilenam%@AE@%                  Inserts base name of current file%@NL@%
%@NL@%
%@AI@%Curtime%@AE@%                     Inserts current time%@NL@%
%@NL@%
%@CR:MSE43303@%%@4@%These functions all use time of execution, rather than time of editor%@EH@%
start-up, as the current time.%@NL@%
%@NL@%
%@CR:MSE43304@%%@4@%Although the functions above are not preassigned to any keystrokes, you can%@EH@%
assign them to keystrokes by using the technique described in Chapter 6%@BO:   28e3a@%.
You can also execute a function by giving its name as input to %@AI@%Execute%@AE@% (F7).%@NL@%
%@NL@%
%@CR:MSE43305@%%@4@%For example, the following sequence inserts the date at the cursor position:%@EH@%%@NL@%
%@NL@%
%@CR:MSE43306@%  1. Invoke %@AI@%Arg%@AE@% (press ALT+A)%@NL@%
  2. Type the following string: %@AS@%curdate%@AE@%%@NL@%
  3. Invoke %@AI@%Execute%@AE@% (press F7)%@NL@%
%@NL@%
%@NL@%
%@CR:MSE43400@%%@3@%%@AB@%4.3.4  Reading a File into the Current File%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE43401@%%@4@%The %@AI@%Paste%@AE@% function can be used in commands that read a file into the current%@EH@%
file, as shown below:%@NL@%
%@NL@%
%@CR:MSE43402@%
%@AB@%Command%@AE@%%@NL@%
%@AB@%(and Default Keystrokes)             Description%@AE@%%@NL@%
%@NL@%
%@AI@%Arg Arg textarg Paste%@AE@%                Reads the contents of the file%@NL@%
(ALT+A ALT+A %@AI@%textarg%@AE@% SHIFT+INS)      specified by the %@AI@%textarg%@AE@% and inserts%@NL@%
                                     these contents into the current file.%@NL@%
                                     The insertion occurs at the cursor%@NL@%
                                     position.%@NL@%
%@NL@%
%@AI@%Arg Arg %@AE@%%@AB@%!%@AE@%%@AI@%textarg Paste%@AE@%               Reads the output of the system-level%@NL@%
(ALT+A ALT+A %@AB@%!%@AE@%%@AI@%textarg%@AE@% SHIFT+INS)     command line given as the %@AI@%textarg%@AE@%. The%@NL@%
                                     output is inserted at the cursor%@NL@%
                                     position. For example, if the %@AI@%textarg%@AE@%%@NL@%
                                     is DIR, then a directory listing is%@NL@%
                                     inserted into the file.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE44000@%%@2@%%@AB@%4.4  Using File Markers%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE44001@%%@4@%File markers help you move back and forth through large files. Once you have%@EH@%
defined a file marker, you can move quickly to the location marked. You can
also use a file marker as input to certain commands. For example, instead of
moving the cursor to a marked location, you simply give the name of the
marker.%@NL@%
%@NL@%
%@CR:MSE44002@%%@4@%The Microsoft Editor allows you to create any number of file markers. You%@EH@%
identify each with a name consisting of alphanumeric characters.%@NL@%
%@NL@%
%@CR:MSE44003@%%@4@%Use the %@AI@%Mark%@AE@% function (CTRL+M) to create or go to a marker. The command %@AI@%Mark%@AE@%%@EH@%
(CTRL+M with no argument) takes you back to the beginning of the file, just
as %@AI@%Arg Mpage%@AE@% does. The command %@AI@%Arg Mark%@AE@% (ALT+A CTRL+M) moves you back to the
previous cursor position. This last use of %@AI@%Mark%@AE@% is useful for switching back
and forth quickly between two locations.%@NL@%
%@NL@%
%@CR:MSE44004@%%@4@%Some of the most powerful uses of the %@AI@%Mark%@AE@% function involve commands with%@EH@%
arguments, as shown below:%@NL@%
%@NL@%
%@CR:MSE44005@%%@AB@%Command     %@AE@%%@NL@%
%@AB@%(and Default Keystrokes)       Description%@AE@%%@NL@%
%@NL@%
%@AI@%Arg numarg Mark%@AE@%                Moves the cursor to the line that you%@NL@%
(ALT+A %@AI@%numarg%@AE@% CTRL+M)          specify. The Microsoft Editor numbers lines%@NL@%
                               beginning with the number 1, so the first%@NL@%
                               line of the file is line 1, the second is%@NL@%
                               line 2, and so forth.%@NL@%
%@NL@%
%@AI@%Arg Arg textarg Mark%@AE@%           Defines a marker at the current location.%@NL@%
(ALT+A ALT+A %@AI@%textarg%@AE@% CTRL+M)   This command sets a marker which in turn can%@NL@%
                               be used as input to other functions.%@NL@%
%@NL@%
%@AI@%Arg textarg Mark%@AE@%               Moves the cursor directly to a marker you%@NL@%
(ALT+A %@AI@%textarg%@AE@% CTRL+M)         have already defined as a %@AI@%textarg%@AE@%.%@NL@%
%@NL@%
%@CR:MSE44006@%%@4@%The marker name may include digits, but must include at least one nondigit%@EH@%
character as well.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE44100@%%@3@%%@AB@%4.4.1  Functions That Use Markers%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE44101@%%@4@%The following functions also make use of markers by accepting a previously%@EH@%
defined marker name (a %@AI@%markarg%@AE@%) as an argument. These functions all use the
area in the file defined by the cursor position and the marker. This area,
in turn, is interpreted as a stream argument, or %@AI@%linearg%@AE@% or %@AI@%boxarg%@AE@%,
depending on whether the editor is in stream mode or box mode. Recall that
the %@AI@%Boxstream%@AE@% function (CTRL+B) toggles between these two modes.%@NL@%
%@NL@%
%@CR:MSE44102@%%@AB@%Function     %@AE@%%@NL@%
%@AB@%(and Default Keystrokes)    Description%@AE@%%@NL@%
%@NL@%
%@AI@%Assign%@AE@% (ALT+=)              Executes all assignment statements in the%@NL@%
                            defined area (see Chapters 6%@BO:   28e3a@% and 7%@BO:   3396c@% for more%@NL@%
                            information)%@NL@%
%@NL@%
%@AI@%Copy%@AE@% (CTRL+INS)             Copies the defined area into the Clipboard%@NL@%
%@NL@%
%@AI@%Ldelete%@AE@% (CTRL+Y)            Deletes the defined area%@NL@%
%@NL@%
%@AI@%Linsert%@AE@% (CTRL+N)            Fills the defined area with spaces%@NL@%
%@NL@%
%@AI@%Qreplace%@AE@% (CTRL+\)           Executes search and replace over the defined%@NL@%
                            area, with query for confirmation%@NL@%
%@NL@%
%@AI@%Replace%@AE@% (CTRL+L)            Executes search and replace over the defined%@NL@%
                            area%@NL@%
%@NL@%
%@CR:MSE44103@%%@4@%If you specify a marker the editor cannot find, the editor automatically%@EH@%
checks the file listed in the %@AB@%markfile%@AE@% switch. See Table A.5 for more
information on the %@AB@%markfile%@AE@% switch.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE44200@%%@3@%%@AB@%4.4.2  Related Functions: Savecur and Restcur%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE44201@%%@4@%The %@AI@%Savecur%@AE@% and %@AI@%Restcur%@AE@%  functions are similar to %@AI@%Mark%@AE@% but do not take%@EH@%
arguments. Use %@AI@%Savecur%@AE@% to save the current cursor position and %@AI@%Restcur%@AE@% to
return to that position later. With these two functions, you can save only
one position at a time.%@NL@%
%@NL@%
%@CR:MSE44202@%%@4@%No keys are preassigned to %@AI@%Savecur%@AE@% or %@AI@%Restcur%@AE@%. See Chapter 6%@BO:   28e3a@%, "Function%@EH@%
Assignments and Macros," for information on how to assign keys. You can also
use %@AI@%Savecur%@AE@% and %@AI@%Restcur%@AE@% by giving them as input to the %@AI@%Arg textarg Execute%@AE@%
command, in which %@AI@%textarg%@AE@% is the name of the function to execute:%@NL@%
%@NL@%
%@CR:MSE44203@%  1. Invoke %@AI@%arg%@AE@% (press ALT + A)%@NL@%
  2. Type %@AI@%Savecur%@AE@% or %@AI@%Restcur%@AE@%%@NL@%
  3. Invoke %@AI@%Execute%@AE@% (press F7)%@NL@%
%@NL@%
%@NL@%
%@CR:MSE45000@%%@2@%%@AB@%4.5  Searching and Replacing%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE45001@%%@4@%The %@AI@%Psearch%@AE@% function (F3) directs the editor to conduct a forward search (a%@EH@%
"plus search") for the next occurrence of the specified string. All searches
take place from the current cursor position to the end of the file.%@NL@%
%@NL@%
%@CR:MSE45002@%%@4@%The most common uses of %@AI@%Psearch%@AE@% consist of the following commands:%@EH@%%@NL@%
%@NL@%
%@CR:MSE45003@%%@AB@%Command%@AE@%%@NL@%
%@AB@%(and Default Keystrokes)     Description%@AE@%%@NL@%
%@NL@%
%@AI@%Arg textarg Psearch%@AE@%         Directs the editor to look for the string given%@NL@%
(ALT+A %@AI@%textarg%@AE@% F3)          as %@AI@%textarg%@AE@%. The editor scrolls the screen, if%@NL@%
                            necessary, and moves the cursor to the next%@NL@%
                            occurrence of %@AI@%textarg%@AE@% in the file.%@NL@%
%@NL@%
%@AI@%Psearch%@AE@% (F3)                Directs the editor to look for the most recently%@NL@%
                            specified search string.%@NL@%
%@NL@%
%@AI@%Arg Psearch%@AE@% (ALT+A F3)      Directs the editor to take the word at the%@NL@%
                            current cursor position as the search string.%@NL@%
                            (In other words, the search string consists of%@NL@%
                            all charac-ters from the cursor to the first%@NL@%
                            blank or new line.)%@NL@%
%@NL@%
%@CR:MSE45004@%%@4@%You can search backward with %@AI@%Msearch%@AE@%  (a "minus search"). The %@AI@%Msearch%@AE@%%@EH@%
function (F4) uses syntax identical to %@AI@%Psearch%@AE@%. Backward searches take place
from the current cursor position to the beginning of the file. In addition,
%@AI@%Msearch%@AE@% with no argument assumes the same search string that was specified
with %@AI@%Psearch%@AE@%. Therefore, after searching forward for a string, you can
search backward for the same string just by pressing F4.%@NL@%
%@NL@%
%@CR:MSE45005@%%@4@%All versions of the %@AI@%Psearch%@AE@% and %@AI@%Msearch%@AE@% commands are affected by case%@EH@%
sensitivity. By default, case sensitivity is off, so the editor carries out
searches for strings without distinguishing between uppercase and lowercase
letters. How-ever, you can change this behavior by turning the %@AB@%case%@AE@% switch
on, using the syntax for switch settings explained in Chapter 7%@BO:   3396c@%, "Switches,
Assignments, and the TOOLS.INI File."%@NL@%
%@NL@%
%@CR:MSE45006@%%@4@%You can also temporarily reverse the setting of the %@AB@%case%@AE@% switch by turning%@EH@%
on the %@AI@%Meta%@AE@% prefix. Therefore, if case sensitivity is off, you can conduct a
case-sensitive search with the %@AI@%Meta%@AE@%%@AI@%Psearch%@AE@% (F9 F3) or %@AI@%Meta Msearch%@AE@% (F9 F4)
command.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE45100@%%@3@%%@AB@%4.5.1  Searching for a Pattern of Text%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE45101@%%@4@%The commands described above search for an exact match of the string you%@EH@%
specify. However, sometimes you may want to search for a set of different
strings: for example, any word that begins with "B" and ends with "ing."%@NL@%
%@NL@%
%@CR:MSE45102@%%@4@%You can search for a pattern of text by specifying a "regular expression." A%@EH@%
regular expression is a string that specifies a pattern of text by using
certain special characters. Chapter 5%@BO:   206bc@% describes how to specify regular
expressions.%@NL@%
%@NL@%
%@CR:MSE45103@%%@4@%The command %@AI@%Arg Arg textarg Psearch%@AE@% (ALT+A ALT+A %@AI@%textarg%@AE@% F3) searches%@EH@%
forward for a string that matches the regular expression specified as the
%@AI@%textarg%@AE@%. The command %@AI@%Arg Arg textarg Msearch%@AE@% (ALT+A ALT+A %@AI@%textarg%@AE@% F4)
searches backward for a string that matches the regular expression specified
as the %@AI@%textarg%@AE@%.%@NL@%
%@NL@%
%@CR:MSE45104@%%@4@%Regular-expression searches are affected by case sensitivity, as explained%@EH@%
in the previous section.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE45200@%%@3@%%@AB@%4.5.2  Searching the File Globally%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE45201@%%@4@%The %@AI@%Searchall%@AE@% function (SHIFT+F6) takes the same syntax that %@AI@%Psearch%@AE@% does,%@EH@%
but instead of finding the next occurrence of a string, the %@AI@%Searchall%@AE@%
function high-lights every string in the file that matches the search
string. For example, to highlight every occurrence of the word %@AS@%float%@AE@% in a
file, follow these steps:%@NL@%
%@NL@%
%@CR:MSE45202@%  1. Invoke %@AI@%Arg%@AE@% (press ALT+A)%@NL@%
  2. Type the following search string: %@AS@%float%@AE@%%@NL@%
  3. Invoke %@AI@%Searchall%@AE@% by pressing SHIFT+F6%@NL@%
%@NL@%
%@CR:MSE45203@%%@4@%Any action other than cursor movement removes the highlight. The color of%@EH@%
the highlight is normally different from the highlight color in
cursor-movement arguments.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE45300@%%@3@%%@AB@%4.5.3  Searching a Series of Files%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE45301@%%@4@%You can search a series of files without leaving the editor. The %@AI@%Mgrep%@AE@%%@EH@%
command takes the same syntax that %@AI@%Psearch%@AE@% and %@AI@%Msearch%@AE@% do. For example, the
command %@AI@%Arg Arg textarg Mgrep%@AE@% searches for a regular expression. The editor
responds to %@AI@%Mgrep%@AE@% by placing all strings found in the <compile> pseudo file.
You can look at the file by using %@AI@%Setfile%@AE@% or invoking the %@AI@%Nextmsg%@AE@% function.%@NL@%
%@NL@%
%@CR:MSE45302@%%@4@%Before using %@AI@%Mgrep%@AE@%, place the list of files to search in a macro named%@EH@%
%@AS@%mgreplist%@AE@%. This list can contain DOS wildcards and environment variables.
For example, the following steps direct %@AI@%Mgrep%@AE@% to search the following files:
the file JUNK.TXT; files that have a .C extension and are in the current
directory; and files that have a .H extension and are in any directory
listed in the INCLUDE environment varible:%@NL@%
%@NL@%
%@CR:MSE45303@%  1. Invoke %@AI@%Arg%@AE@% (press ALT+A)%@NL@%
%@NL@%
  2. Define the value of %@AS@%mgreplist%@AE@% by typing the following:%@NL@%
%@NL@%
       %@AS@%mgreplist:="JUNK.TXT *.C $INCLUDE:*.H"%@AE@%%@NL@%
%@NL@%
  3. Invoke %@AI@%Assign%@AE@% by pressing ALT+= (hold down the ALT key and press the%@NL@%
     equals sign)%@NL@%
%@NL@%
%@CR:MSE45304@%%@4@%You refer to an environment variable with the following syntax, in which%@EH@%
%@AI@%ENVAR%@AE@% is the name of the variable. The name must be entered in uppercase
characters:%@NL@%
%@NL@%
     %@AB@%$%@AE@%%@AI@%ENVAR%@AE@%%@AB@%:%@AE@%%@NL@%
%@NL@%
%@NL@%
%@CR:MSE45400@%%@3@%%@AB@%4.5.4  Search-and-Replace Functions%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE45401@%%@4@%To replace repeated occurrences of one text string by another, use the%@EH@%
search-and-replace function %@AI@%Replace%@AE@% (CTRL+L). By default, the replacement
happens from the cursor position to the end of the file. However, as
described below, you can restrict the range over which the replacement
happens.%@NL@%
%@NL@%
%@CR:MSE45402@%%@4@%No matter what command syntax you use with %@AI@%Replace%@AE@%, the editor reacts by%@EH@%
prompting you for a search string and a replacement string, and then
executing the search and replace. If you have used %@AI@%Replace%@AE@% or %@AI@%Qreplace%@AE@%
("query replace") before, the previous value of the search or replace string
appears on the dialog line. To use the string displayed, press ENTER.%@NL@%
%@NL@%
%@CR:MSE45403@%%@4@%The identical commands %@AI@%Replace%@AE@% and %@AI@%Arg Replace%@AE@% execute replacement from the%@EH@%
current cursor position to the end of the file. You can also specify a range
for the replacement by using one of the following commands:%@NL@%
%@NL@%
%@CR:MSE45404@%%@AB@%Command                     Default Keystrokes%@AE@%%@NL@%
%@NL@%
%@AI@%Arg linearg Replace%@AE@%         ALT+A %@AI@%linearg%@AE@% CTRL+L%@NL@%
%@NL@%
%@AI@%Arg numarg Replace%@AE@%          ALT+A %@AI@%numarg%@AE@% CTRL+L%@NL@%
%@NL@%
%@AI@%Arg boxarg Replace%@AE@%          ALT+A %@AI@%boxarg%@AE@% CTRL+L%@NL@%
%@NL@%
%@AI@%Arg streamarg Replace%@AE@%       ALT+A %@AI@%streamarg%@AE@% CTRL+L%@NL@%
%@NL@%
%@AI@%Arg markarg Replace%@AE@%         ALT+A %@AI@%markarg%@AE@% CTRL+L%@NL@%
%@NL@%
%@CR:MSE45405@%%@4@%If you specify a %@AI@%numarg%@AE@%, the replacement operation is limited to the%@EH@%
specified number of lines, beginning with the current line. If you specify a
%@AI@%linearg%@AE@%, %@AI@%streamarg%@AE@%, or %@AI@%boxarg%@AE@%, the replacement occurs only within the
highlighted area. If you specify a %@AI@%markarg%@AE@%, the replacement occurs in the
region of text between the cursor position and the marker. The shape of the
region changes depending on whether the editor is in box mode or stream
mode.%@NL@%
%@NL@%
%@CR:MSE45406@%%@4@%The %@AI@%Replace%@AE@% function is most efficient when you are sure you want the%@EH@%
replacement to be executed in every case. If you want to regulate how often
the replacement occurs, use %@AI@%Qreplace%@AE@% (CTRL+\). This function takes the same
syntax as %@AI@%Replace%@AE@%, but prompts you for confirmation before each replacement.
%@AI@%Qreplace%@AE@% asks you to press Y for yes, N for no, or A for all, which causes
replacement to proceed without further confirmation. Pressing Q (quit)
terminates replacement.%@NL@%
%@NL@%
%@CR:MSE45407@%%@4@%The %@AI@%Replace%@AE@% and %@AI@%Qreplace%@AE@% functions both take regular expressions as search%@EH@%
strings when you introduce the argument with %@AI@%Arg Arg%@AE@% instead of %@AI@%Arg%@AE@%. (See
Chapter 5%@BO:   206bc@% for information on regular expressions.) Otherwise, syntax is
identical, and the functions accept the same arguments.%@NL@%
%@NL@%
%@CR:MSE45408@%%@4@%Search and replacing is affected by case sensitivity, as explained in%@EH@%
Section 4.5.1.%@BO:   1a2e0@%%@NL@%
%@NL@%
%@CR:MSE45409@%%@4@%You can use the %@AI@%Mreplace%@AE@% function to execute replacements throughout a%@EH@%
series of files. See Appendix A, "Reference Tables," for more information.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE46000@%%@2@%%@AB@%4.6  Compiling%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE46001@%%@4@%One of the strengths of the Microsoft Editor is its capability as a%@EH@%
development environment. You can write a program and compile (or assemble)
from within the editor. If the compilation fails, you can make corrections
to the source file when you view the errors and then compile again.%@NL@%
%@NL@%
%@CR:MSE46002@%%@4@%Ordinarily, a compiler sends error messages directly to the screen while you%@EH@%
are outside the editor. When you compile from within the Microsoft Editor,
however, the error messages are displayed on the dialog line. The %@AI@%Nextmsg%@AE@%
function (SHIFT+F3) displays the error messages in sequence and positions
the cursor at the beginning of the line with the next error. You can make
corrections immediately.%@NL@%
%@NL@%
%@CR:MSE46003@%%@4@%The %@AI@%Compile%@AE@% function (CTRL+F3) appears in a variety of commands, as shown in%@EH@%
Section 4.6.1.%@BO:   1c335@%%@NL@%
%@NL@%
%@NL@%
%@CR:MSE46100@%%@3@%%@AB@%4.6.1  Invoking Compilers and Other Utilities%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE46101@%%@4@%When you run the protected-mode version of the editor under OS/2,%@EH@%
compilations run in the background and the editor beeps when the compilation
is completed. (While a background compilation is running, the letters %@AS@%BP%@AE@%
appear on the status line.) When running the real-mode version of the editor
(under DOS or the OS/2 3.%@AI@%x%@AE@% compatibility box), you cannot edit again until
the compilation has completed.%@NL@%
%@NL@%
%@CR:MSE46102@%%@4@%With the Microsoft Editor's compilation capability, you can invoke any%@EH@%
program or utility and specify any command-line options. To invoke a program
directly, use one of the following commands:%@NL@%
%@NL@%
%@CR:MSE46103@%%@AB@%Command     %@AE@%%@NL@%
%@AB@%(and Default Keystrokes)             Description%@AE@%%@NL@%
%@NL@%
%@AI@%Arg Arg textarg Compile%@AE@%              Runs the system-level command described%@NL@%
(ALT+A ALT+A %@AI@%textarg%@AE@% CTRL+F3)        by %@AI@%textarg%@AE@%. Typically, this command%@NL@%
                                     runs the compiler.%@NL@%
%@NL@%
%@AI@%Arg Compile%@AE@%                          Runs a compilation according to the%@NL@%
(ALT+A CTRL+F3)                      %@AB@%extmake%@AE@% switch.%@NL@%
%@NL@%
%@AI@%Arg textarg Compile%@AE@%                  Runs a compilation according to the%@NL@%
(ALT+A CTRL+F3)                      "text" setting of the %@AB@%extmake%@AE@% switch.%@NL@%
                                     This version of the command is%@NL@%
                                     typically used with the NMAKE utility.%@NL@%
%@NL@%
%@AI@%Arg Meta Compile%@AE@%                     Kills any compilation running in the%@NL@%
(ALT+A F9 CTRL+F3)                   background after prompting for%@NL@%
                                     confirmation (OS/2 only).%@NL@%
%@NL@%
%@CR:MSE46104@%%@4@%Usually, it is more convenient to set your compile command once by setting%@EH@%
the %@AB@%extmake%@AE@% switch and giving the %@AI@%Arg Compile%@AE@% command each time you compile.%@NL@%
%@NL@%
%@CR:MSE46105@%%@4@%A "switch" is a variable that you can set to control the editor's behavior.%@EH@%
See Chapter 7%@BO:   3396c@%, "Switches, Assignments, and the TOOLS.INI File," for more
information on switches and how to set them.%@NL@%
%@NL@%
%@CR:MSE46106@%%@4@%The %@AI@%Arg Compile%@AE@% command examines the file extension of the current file and%@EH@%
executes the corresponding %@AB@%extmake%@AE@% setting. The %@AB@%extmake%@AE@% switch can have a
different setting for each file extension. The general form of an %@AB@%extmake%@AE@%
assignment is%@NL@%
%@NL@%
     %@AB@%extmake:%@AE@%%@AI@%ext command-line%@AE@%%@NL@%
%@NL@%
%@CR:MSE46108@%%@4@%in which %@AI@%ext%@AE@% is a file extension and %@AI@%command-line%@AE@% is the compile command to%@EH@%
invoke for files with this extension. For example, suppose you want to
invoke the following compile command for use with .C files:%@NL@%
%@NL@%
     cl /AL /Zi /Ox %s%@NL@%
%@NL@%
%@CR:MSE46109@%%@4@%The characters %@AS@%%s%@AE@% represent the name of the current file. To automatically%@EH@%
invoke this compile command with %@AI@%Arg Compile%@AE@%, you would first follow these
steps to set the %@AB@%extmake%@AE@% switch:%@NL@%
%@NL@%
%@CR:MSE4610A@%  1. Invoke %@AI@%Arg%@AE@% (press ALT+A)%@NL@%
%@NL@%
  2. Type the following text: %@AS@%extmake:c cl /AL /Zi /Ox %s%@AE@%%@NL@%
%@NL@%
  3. Press ALT+= to invoke %@AI@%Assign%@AE@% (hold down the ALT key and press the%@NL@%
     equals sign)%@NL@%
%@NL@%
%@CR:MSE4610B@%%@4@%The editor then invokes the desired command line whenever you give the %@AI@%Arg%@AE@%%@EH@%
%@AI@%Compile%@AE@% command and are editing a .C file.%@NL@%
%@NL@%
%@CR:MSE4610C@%%@4@%To use the %@AI@%Arg textarg Compile%@AE@% command, first set %@AB@%extmake%@AE@% with a %@AB@%text%@AE@%%@EH@%
extension:%@NL@%
%@NL@%
     %@AB@%extmake:text%@AE@% %@AI@%command-line%@AE@%%@NL@%
%@NL@%
%@CR:MSE4610E@%%@4@%If the symbol %@AS@%%s%@AE@% appears in %@AI@%command-line%@AE@%, it is replaced with the text%@EH@%
argument to %@AI@%Compile%@AE@%. For example, if %@AB@%extmake%@AE@% has the setting%@NL@%
%@NL@%
     extmake:text nmake %s%@NL@%
%@NL@%
%@CR:MSE4610F@%%@4@%and you pass the text argument %@AS@%projectx%@AE@% to the %@AI@%Compile%@AE@% function, the editor%@EH@%
executes the following system-level command:%@NL@%
%@NL@%
     nmake projectx%@NL@%
%@NL@%
%@NL@%
%@CR:MSE46200@%%@3@%%@AB@%4.6.2  Viewing Error Output%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE46201@%%@4@%To generate error output that you can view from within the editor, the%@EH@%
compiler or assembler must output errors in one of the following formats:%@NL@%
%@NL@%
     %@AI@%filename row column%@AE@%%@AB@%:%@AE@%%@AI@% message%@AE@%%@NL@%
     %@AI@%filename%@AE@% %@AB@%(%@AE@%%@AI@%row%@AE@%%@AB@%,%@AE@% %@AI@%column%@AE@%%@AB@%):%@AE@% %@AI@%message%@AE@%%@NL@%
     %@AI@%filename%@AE@% %@AB@%(%@AE@%%@AI@%row%@AE@%%@AB@%):%@AE@%%@AI@%message%@AE@%%@NL@%
     %@AI@%filename%@AE@%%@AB@%:%@AE@% %@AI@%row%@AE@%%@AB@%:%@AE@% %@AI@%message%@AE@%%@NL@%
     %@AB@%"%@AE@%%@AI@%filename%@AE@%%@AB@%",%@AE@% %@AI@%row%@AE@% %@AI@%column%@AE@%%@AB@%:%@AE@% %@AI@%message%@AE@%%@NL@%
%@NL@%
%@CR:MSE46203@%%@4@%The Microsoft Editor, in turn, reads the error output directly and responds%@EH@%
by moving the cursor to each location where an error was reported while
displaying the %@AI@%message%@AE@% on the dialog line. (The method for moving between
error locations is described below.) The following programs output error
messages in a format readable by the Microsoft Editor:%@NL@%
%@NL@%
%@CR:MSE46204@%  ■  Microsoft C Optimizing Compiler%@NL@%
  ■  Microsoft Macro Assembler%@NL@%
  ■  Microsoft Pascal Compiler 4.0%@NL@%
  ■  Microsoft BASIC Compiler 6.0%@NL@%
  ■  Microsoft FORTRAN Optimizing Compiler 4.1%@NL@%
%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@AI@%NOTE%@AE@%%@NL@%
   With the Pascal and BASIC compilers, you must use the /Z command-line%@NL@%
   option with either the PL or BC driver to generate error output that the%@NL@%
   Microsoft Editor can read. (The %@AI@%extmake%@AE@% switch, discussed in Chapter 7%@BO:   3396c@%,%@NL@%
   uses the /Z option by default.)%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@CR:MSE46205@%%@4@%When a compilation fails in real mode, the editor displays the first error%@EH@%
message and positions the cursor at the line with the error. The %@AI@%Nextmsg%@AE@%
function (SHIFT+F3) displays the next error message and repositions the
cursor at the appropriate line.  %@AI@%;Nextmsg%@AE@%%@NL@%
%@NL@%
%@CR:MSE46206@%%@4@%When a compilation fails in protected mode, the editor beeps rather than%@EH@%
interrupts your current activity. If you had previously viewed the results
of an earlier compilation, give the %@AI@%Arg Meta Nextmsg%@AE@% command (ALT+A  F9
SHIFT+F3) to advance to the current set of error messages. Then, regardless
of how many compilations you are running, press SHIFT+F3 to display the
first error message and move the cursor to the line with that error.%@NL@%
%@NL@%
%@CR:MSE46207@%%@4@%Some common ways to use the %@AI@%Nextmsg%@AE@% function are shown below:%@EH@%%@NL@%
%@NL@%
%@CR:MSE46208@%%@AB@%Command%@AE@%%@NL@%
%@AB@%(and Default Keystrokes)    Description%@AE@%%@NL@%
%@NL@%
%@AI@%Nextmsg%@AE@% (SHIFT+F3)          Moves cursor to location of next error message%@NL@%
                            and displays text of error message on the dialog%@NL@%
                            line.%@NL@%
%@NL@%
%@AI@%Arg numarg Nextmsg%@AE@%          Moves forward or backward by %@AI@% %@AE@%%@AI@%numarg%@AE@% error%@NL@%
(ALT+A %@AI@%numarg%@AE@% SHIFT+F3)     messages. For example, if %@AI@%numarg%@AE@% is %@AS@%-1%@AE@%, moves%@NL@%
                            the cursor to the previous error message.%@NL@%
%@NL@%
%@AI@%Arg Meta Nextmsg%@AE@%            OS/2 only. Advances to next set of error%@NL@%
(ALT+A A SHIFT+F3)          messages. Under OS/2, the editor maintains error%@NL@%
                            messages for all compilations. This command%@NL@%
                            directs the editor to advance to the error%@NL@%
                            messages for the subsequent compilation.%@NL@%
%@NL@%
                            This feature supports simultaneous background%@NL@%
                            compilations. No matter how many compilations%@NL@%
                            you exe-cuted, you can view every set of error%@NL@%
                            messages.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE46300@%%@3@%%@AB@%4.6.3  Viewing the Dynamic-Compile Log%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE46301@%%@4@%Reviewing error messages as described in the previous section is useful when%@EH@%
each error message corresponds to a location in your source file. However,
some messages (such as linker errors) do not correspond to specific lines of
code. To review these errors, as well as general compilation errors, you may
want to view the actual error-message text.%@NL@%
%@NL@%
%@CR:MSE46302@%%@4@%The editor keeps the complete error output of each compilation──including%@EH@%
output from any utilities that were invoked──in the <compile> pseudo file.
If the editor is running in real mode, you can view the <compile> pseudo
file after a compilation is complete by following these steps:%@NL@%
%@NL@%
%@CR:MSE46303@%  1. Invoke %@AI@%Arg%@AE@% (press ALT+A)%@NL@%
  2. Type the following text: %@AS@%<compile>%@AE@%%@NL@%
  3. Invoke %@AI@%Setfile%@AE@% (press F2)%@NL@%
%@NL@%
%@CR:MSE46304@%%@4@%If the editor is running in OS/2 protected mode, you can view the  error%@EH@%
output in the same manner described above. You can also view the <compile>
pseudo file as the compilation is running. Under protected mode, the
<compile> pseudo file is updated dynamically; as each error message is
produced by the compiler or utility, the editor adds the message to the end
of this file.%@NL@%
%@NL@%
%@CR:MSE46305@%%@4@%Using the techniques described in the next section, you can open <compile>%@EH@%
as a separate window. This lets you continue to edit your source file while
watching error messages appear the instant an error is detected. The command
%@AI@%Arg Meta Compile%@AE@% kills the compilation.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE47000@%%@2@%%@AB@%4.7  Using Editing Windows%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE47001@%%@4@%An "editing window" is a division of the screen that functions independently%@EH@%
from other portions of the screen. When you have two or more windows
present, each functions as a miniature screen. For example, one window can
view lines 5-15 while another window views lines 90-97. You can even use
windows to view two or more files simultaneously.%@NL@%
%@NL@%
%@CR:MSE47002@%%@4@%Although windows are tiled, they can view overlapping areas of text. Changes%@EH@%
and highlighting are reflected simultaneously in all windows that view the
area of altered text.%@NL@%
%@NL@%
%@CR:MSE47003@%%@4@%You can have up to eight windows on the screen and create either horizontal%@EH@%
or vertical divisions between windows. The command %@AI@%Window%@AE@% (F6 with no
arguments) moves the cursor between windows.To create or merge a window,
move the cursor to the row or column at which you want to create a new
division, and give one of the following commands:%@NL@%
%@NL@%
%@CR:MSE47004@%%@AB@%Command%@AE@%%@NL@%
%@AB@%(and Default Keystrokes)      Description%@AE@%%@NL@%
%@NL@%
%@AI@%Arg Window%@AE@%                    Creates a horizontal window (split at the%@NL@%
(ALT+A F6)                    cursor row)%@NL@%
%@NL@%
%@AI@%Arg Arg Window%@AE@%                Creates a vertical window (split at the%@NL@%
(ALT+A ALT+A F6)              cursor column)%@NL@%
%@NL@%
%@AI@%Meta Window%@AE@%                   Closes the current window by merging it with%@NL@%
(F9 F6)                       the window to the right or below%@NL@%
%@NL@%
%@CR:MSE47005@%%@4@%Each window must have a minimum of 5 lines and 10 columns. If you try to%@EH@%
create a window of a smaller size, the command fails.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE48000@%%@2@%%@AB@%4.8  Working with Multiple Files%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE48001@%%@4@%You can load a new file in the screen or current window with the %@AI@%Setfile%@AE@%%@EH@%
function.%@NL@%
%@NL@%
%@CR:MSE48002@%%@AB@%Command     %@AE@%%@NL@%
%@AB@%(and Default Keystrokes)     Description%@AE@%%@NL@%
%@NL@%
%@AI@%Arg textarg Setfile%@AE@%         Loads the file specified in the %@AI@%textarg%@AE@%.%@NL@%
(ALT+A %@AI@%textarg%@AE@% F2)%@NL@%
%@NL@%
%@AI@%Setfile%@AE@% (F2)                Loads the previous file. You can use %@AI@%Setfile%@AE@% to%@NL@%
                            move back and forth between two files.%@NL@%
%@NL@%
%@CR:MSE48003@%%@4@%You can also use %@AI@%Setfile%@AE@% by following these steps:%@EH@%%@NL@%
%@NL@%
%@CR:MSE48004@%  1. Bring up the information file with the %@AI@%Information%@AE@% function  (press%@NL@%
     F10).%@NL@%
%@NL@%
  2. Move the cursor to the beginning of the name of a file.%@NL@%
%@NL@%
  3. Select the file that the cursor is on by giving the command %@AI@%Arg Setfile%@AE@%%@NL@%
     (press ALT+A F2).%@NL@%
%@NL@%
%@CR:MSE48005@%%@4@%The information file contains the names of all files that you have edited%@EH@%
before, up to the limit specified by the %@AB@%tmpsav%@AE@% switch. (See Table A.5 for
more information on switches.) Active files──files that have been edited
during this session──are listed with their current lengths. This file also
tells whether the text in the Clipboard was copied in line (box) or stream
mode.%@NL@%
%@NL@%
%@CR:MSE48006@%%@4@%When an old file is reloaded, the editor remembers cursor and window%@EH@%
information from the last time you edited the file. The editor stores this
information in the file M.TMP (or MEP.TMP, if the editor is named MEP).%@NL@%
%@NL@%
%@CR:MSE48007@%%@4@%The %@AI@%Arg textarg Setfile%@AE@% command accepts wild-card characters (%@AB@%?%@AE@% matches any%@EH@%
character and %@AB@%*%@AE@% matches any string) in the %@AI@%textarg%@AE@%. The command responds by
displaying a list of files that match the %@AI@%textarg%@AE@%. You can then select a
file by using the steps outlined above. For example, the following sequence
causes the editor to list all files with a .C extension:%@NL@%
%@NL@%
%@CR:MSE48008@%  1. Invoke the %@AI@%Arg%@AE@% function (press ALT+A)%@NL@%
  2. Type the following: %@AS@%*.c%@AE@%%@NL@%
  3. Invoke the %@AI@%Setfile%@AE@% function (press F2)%@NL@%
%@NL@%
%@NL@%
%@CR:MSE49000@%%@2@%%@AB@%4.9  Printing a File%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE49001@%%@4@%You can print a file without leaving the Microsoft Editor. You can also%@EH@%
print a highlighted area or a series of files. Use the %@AI@%Print%@AE@% function
(CTRL+F8) to perform each of these actions:%@NL@%
%@NL@%
%@CR:MSE49002@%%@AB@%Command%@AE@%%@NL@%
%@AB@%(and Default Keystrokes)          Description%@AE@%%@NL@%
%@NL@%
%@AI@%Print%@AE@% (CTRL+F8)                   Prints all of the current file.%@NL@%
%@NL@%
%@AI@%Arg cursor-movement Print%@AE@%         Prints the highlighted area.%@NL@%
(ALT+A %@AI@%cursor-movement%@AE@% CTRL+F8)%@NL@%
%@NL@%
%@AI@%Arg textarg Print%@AE@%                 Prints the file or files specified in%@NL@%
(ALT+A %@AI@%textarg%@AE@% CTRL+F8)           %@AI@%textarg%@AE@%. If there is more than one file,%@NL@%
                                  separate them with a space.%@NL@%
%@NL@%
%@CR:MSE49003@%%@4@%By default, the %@AI@%Print%@AE@% function responds by sending the specified output to%@EH@%
the LPT1 device. However, you can specify a different print command by
setting the %@AB@%printcmd%@AE@% switch.%@NL@%
%@NL@%
%@CR:MSE49004@%%@4@%For example, suppose you want to print a file by using the following%@EH@%
command:%@NL@%
%@NL@%
     COPY %s LPT2%@NL@%
%@NL@%
%@CR:MSE49005@%%@4@%The characters %@AS@%%s%@AE@% represent the file name (in the case of highlighted%@EH@%
regions, the editor creates a temporary file). To invoke this command each
time you use the %@AI@%Print%@AE@% function, you first follow these steps to set the
%@AB@%printcmd%@AE@% switch:%@NL@%
%@NL@%
%@CR:MSE49006@%  1. Invoke %@AI@%Arg%@AE@% (press ALT+A)%@NL@%
%@NL@%
  2. Type the following text: %@AS@%printcmd:COPY %s LPT2%@AE@%%@NL@%
%@NL@%
  3. Press ALT+= to invoke %@AI@%Assign%@AE@% (hold down the ALT key and type the equals%@NL@%
     sign)%@NL@%
%@NL@%
%@CR:MSE49007@%%@4@%When printing from within the protected-mode editor under OS/2, the printing%@EH@%
occurs as a background operation and %@AS@%BP%@AE@% is displayed at the lower-right-hand
corner of the screen. The <print> pseudo file maintains a log of the printed
output.%@NL@%
%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@AI@%NOTE%@AE@%%@NL@%
   A "switch" is a variable you can set to control the editor's behavior.%@NL@%
   See Chapter 7%@BO:   3396c@%, "Switches, Assignments, and the TOOLS.INI File," for more%@NL@%
   information on switches and how to set them.%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@NL@%
%@CR:MSE50000@%%@1@%%@AB@%Chapter 5  Regular Expressions%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@CR:MSE50001@%%@4@%A "regular expression" is a special search string that matches a %@AI@%pattern%@AE@% of%@EH@%
text rather than a specific sequence of characters. With regular
expressions, you can search for such targets as every five-digit number, or
every string in quotes, without having to specify the exact text to search
for.%@NL@%
%@NL@%
%@CR:MSE50002@%%@4@%In a regular expression, certain characters lose their literal meaning,%@EH@%
becoming symbols or placeholders that specify the text pattern you want to
match. In a regular expression such as %@AS@%a[123]%@AE@%, the %@AS@%a%@AE@% is still the literal
character "a". The brackets, however, are not search targets. Rather, they
enclose a set of characters, any one of which is a match. Therefore, the
regular expression %@AS@%a[123]%@AE@% matches any of these strings:%@NL@%
%@NL@%
     %@AS@%a1%@AE@%%@NL@%
     %@AS@%a2%@AE@%%@NL@%
     %@AS@%a3%@AE@%%@NL@%
%@NL@%
%@CR:MSE50004@%%@4@%The Microsoft Editor supports two versions of regular-expression syntax:%@EH@%
UNIX(R) and M 1.0. The UNIX syntax provides compatibility with the syntax
used by programming utilities for the UNIX and XENIX(R) operating systems
and CodeView(R). M 1.0 syntax does not provide this compatibility; however,
it offers more power.%@NL@%
%@NL@%
%@CR:MSE50005@%%@4@%This chapter examines three aspects of regular-expression syntax:%@EH@%%@NL@%
%@NL@%
%@CR:MSE50006@%  ■  Choosing the syntax%@NL@%
  ■  Using UNIX syntax%@NL@%
  ■  Using M 1.0 syntax%@NL@%
%@NL@%
%@CR:MSE50007@%%@4@%You can use regular expressions with the search functions (%@AI@%Psearch%@AE@%, %@AI@%Msearch%@AE@%,%@EH@%
%@AI@%Replace%@AE@%, and %@AI@%Qreplace%@AE@%). Each of these functions recognizes a regular
expression (rather than an ordinary text string) when you use %@AI@%Arg Arg%@AE@% to
introduce the string.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE51000@%%@2@%%@AB@%5.1  Choosing the Syntax%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE51001@%%@4@%The Microsoft Editor supports two forms of regular-expression syntax: the%@EH@%
M 1.0 form and the UNIX standard. If you know the UNIX standard, you can use
it immediately. However, the slightly different M 1.0 syntax of the
Microsoft Editor is more powerful.%@NL@%
%@NL@%
%@CR:MSE51002@%%@4@%By default, the editor recognizes the UNIX syntax for regular expressions.%@EH@%
To use the M 1.0 syntax instead, follow these steps:%@NL@%
%@NL@%
%@CR:MSE51003@%  1. Invoke %@AI@%Arg%@AE@% (press ALT+A)%@NL@%
  2. Type the following: %@AS@%unixre:no%@AE@%%@NL@%
  3. Invoke %@AI@%Assign%@AE@% (press ALT+=)%@NL@%
%@NL@%
%@CR:MSE51004@%%@4@%To enable the standard UNIX syntax, follow the same steps but type %@AS@%unixre:%@AE@%%@EH@%
instead of %@AS@%unixre:no%@AE@%.%@NL@%
%@NL@%
%@CR:MSE51005@%%@4@%If you would like the editor to run automatically in M 1.0 mode, rather than%@EH@%
having to manually invoke the %@AI@%Assign%@AE@% function, add a %@AS@%unixre:no%@AE@% entry to the
TOOLS.INI file. See Chapter 7%@BO:   3396c@%, "Switches, Assignments, and the TOOLS.INI
File," for more information.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE52000@%%@2@%%@AB@%5.2  UNIX(R) Regular-Expression Syntax%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE52001@%%@4@%The UNIX regular-expression syntax is compatibile with UNIX utilities and%@EH@%
CodeView. By default, the editor uses UNIX syntax for regular expressions.
The M 1.0 syntax offers the same capabilities as the UNIX syntax, plus a few
additional features.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE52100@%%@3@%%@AB@%5.2.1  UNIX Regular Expressions as Simple Strings%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE52101@%%@4@%The power of regular expressions comes from the use of the special%@EH@%
characters and character sequences listed below. A regular expression that
does not contain these special characters or character sequences acts as a
literal text string:%@NL@%
%@NL@%
     %@AB@%\(  \)  [  ]  !  .  ^  $  *%@AE@%%@NL@%
%@NL@%
%@CR:MSE52103@%%@4@%For example, the regular expression %@AS@%match me precisely%@AE@% matches only a%@EH@%
literal occurrence of itself because it contains no special characters.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE52200@%%@3@%%@AB@%5.2.2  UNIX Special Characters%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE52201@%%@4@%The UNIX operators offer the standard pattern-matching capabilities found in%@EH@%
many other editors and utilities that use regular expressions.%@NL@%
%@NL@%
%@CR:MSE52202@%%@4@%The list below describes the special characters that have a simple usage.%@EH@%
The term %@AI@%class%@AE@% has a special meaning defined below. All other characters
should be interpreted literally.%@NL@%
%@NL@%
%@CR:MSE52203@%%@AB@%Expression                  Description%@AE@%%@NL@%
%@NL@%
%@AB@%\%@AE@%                           Escape. Causes the editor to ignore the special%@NL@%
                            meaning of the next character. For example, the%@NL@%
                            expression %@AS@%\.%@AE@% matches %@AS@%.%@AE@% in the text file; the%@NL@%
                            expression %@AS@%\^%@AE@% matches %@AS@% %@AE@%%@AS@%^%@AE@%; and the expression %@AS@%\\%@AE@%%@NL@%
                            matches %@AS@%\%@AE@%.%@NL@%
%@NL@%
%@AB@%.%@AE@%                           Wildcard. Matches any single character. For%@NL@%
                            example, the expression %@AS@%a.a%@AE@% matches %@AS@%aaa%@AE@%, %@AS@%aBa%@AE@%,%@NL@%
                            and %@AS@%a1a%@AE@%, but not %@AS@%aBBBa%@AE@%.%@NL@%
%@NL@%
%@AB@%^%@AE@%                           Beginning of line. For example, %@AS@%^The%@AE@% matches the%@NL@%
                            word %@AS@%The%@AE@% only when it occurs at the beginning of%@NL@%
                            a line.%@NL@%
%@NL@%
%@AB@%$%@AE@%                           End of line. For example, %@AS@%end$%@AE@% matches the word %@AS@%%@AE@%%@NL@%
                            %@AS@%end%@AE@% only when it occurs at the end of a line.%@NL@%
%@NL@%
%@AB@%[%@AE@%%@AI@%class%@AE@%%@AB@%]%@AE@%                     Character class. Matches any one character in%@NL@%
                            the class. Use a dash (%@AB@%-%@AE@%) to specify a%@NL@%
                            contiguous range of ASCII values. For example,%@NL@%
                            %@AS@%[a-zA-Z0-9]%@AE@% matches any letter or digit, and%@NL@%
                            %@AS@%[abc] %@AE@%%@AS@%%@AE@% matches %@AS@%a%@AE@%, %@AS@%b%@AE@%, or %@AS@%c%@AE@%.%@NL@%
%@NL@%
%@AB@%[^%@AE@%%@AI@%class%@AE@%%@AB@%]%@AE@%                    Inverse of character class. Matches any%@NL@%
                            character not specified in the class.%@NL@%
%@NL@%
%@CR:MSE52204@%%@4@%The special characters with more complex usage are described in the%@EH@%
following list. The expression %@AI@%X%@AE@% is a placeholder representing a regular
expression that is either a single character, a group of characters enclosed
in brackets (%@AB@%[]%@AE@%), or the regular-expression delimiters %@AB@%\(%@AE@% and %@AB@%\)%@AE@%. The letter
%@AI@%n%@AE@% represents a one-digit number.%@NL@%
%@NL@%
%@CR:MSE52205@%%@AB@%Expression                  Description%@AE@%%@NL@%
%@NL@%
%@AI@%X%@AE@%%@AB@%*%@AE@%                          Repeat operator. Matches zero or more%@NL@%
                            occurrences of %@AI@%X%@AE@%. For example, the regular%@NL@%
                            expression %@AS@%ba*b%@AE@% matches %@AS@%baaab%@AE@%, %@AS@%bab%@AE@%, and %@AS@%bb%@AE@%. This%@NL@%
                            operator always matches as many characters as%@NL@%
                            possible.%@NL@%
%@NL@%
%@AB@%\(%@AE@% ... %@AB@%\)%@AE@%                   Tagged expression. A marked substring which you%@NL@%
                            can refer to elsewhere in the search string, or%@NL@%
                            in a replacement string, as %@AB@%\%@AE@%%@AI@%n%@AE@%. When a tagged%@NL@%
                            expression is referred to in a search string,%@NL@%
                            the editor finds text with the tagged expression%@NL@%
                            repeated. When a tagged expression is referred%@NL@%
                            to in a replacement string, the editor reuses%@NL@%
                            part of the text it is replacing.%@NL@%
%@NL@%
                            The exact use of tags is explained in Sections%@NL@%
                            5.2.4%@BO:   231bc@% and 5.2.5%@BO:   23b94@%. Characters falling between %@NL@%
                            %@AB@%\(%@AE@% and %@AB@%\)%@AE@% are treated as a group.%@NL@%
%@NL@%
%@AB@%\%@AE@%%@AI@%n%@AE@%                          Reference to the characters matched by a tagged%@NL@%
                            expression. The number %@AI@%n%@AE@% indicates which%@NL@%
                            expression. The first tagged expression is%@NL@%
                            represented as %@AB@%\%@AE@%1, the second as %@AB@%\%@AE@%2, and so%@NL@%
                            on.%@NL@%
%@NL@%
%@CR:MSE52206@%%@4@%The procedure below uses some of the special characters presented in this%@EH@%
section. To find the next occurrence of a number (that is, a string of
digits) beginning with a digit 1 or 2, perform the following sequence of
keystrokes:%@NL@%
%@NL@%
%@CR:MSE52207@%  1. Invoke %@AI@%Arg%@AE@% twice (press ALT+A twice)%@NL@%
  2. Type the following characters: %@AS@%[12][0-9]*%@AE@%%@NL@%
  3. Invoke %@AI@%Psearch%@AE@% (press F3)%@NL@%
%@NL@%
%@NL@%
%@CR:MSE52300@%%@3@%%@AB@%5.2.3  Combining UNIX Special Characters%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE52301@%%@4@%Special characters are most powerful when used in combination. For example,%@EH@%
the wildcard (%@AS@%.%@AE@%) and repeat (%@AS@%*%@AE@%) characters are often used together:%@NL@%
%@NL@%
     %@AS@%.*%@AE@%%@NL@%
%@NL@%
%@CR:MSE52302@%%@4@%The expression above means "match any string of characters." Although this%@EH@%
expression is not useful by itself, it is quite useful when part of a larger
expression. For example,%@NL@%
%@NL@%
     %@AS@%B.*ing%@AE@%%@NL@%
%@NL@%
%@CR:MSE52303@%%@4@%means "match any string beginning with %@AS@%B%@AE@% and ending with %@AS@%ing%@AE@%".%@EH@%%@NL@%
%@NL@%
%@CR:MSE52304@%%@4@%In cases where a single character is surrounded by two operators, regular%@EH@%
expressions are interpreted from left to right. For example, suppose the
following is part of a regular expression:%@NL@%
%@NL@%
     %@AS@%\1*%@AE@%%@NL@%
%@NL@%
%@CR:MSE52305@%%@4@%In the expression above, the repeat operator (%@AS@%*%@AE@%) applies to the characters%@EH@%
%@AS@%\1%@AE@% as a single unit.%@NL@%
%@NL@%
%@CR:MSE52306@%%@4@%If you want the repeat operator to apply to a group, enclose the group%@EH@%
inside the symbols %@AB@%\%@AE@%( and %@AB@%\%@AE@%). These characters tag an expression (as
explained in the next section) and are useful for treating a series of
characters as a group.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE52400@%%@3@%%@AB@%5.2.4  Tagged Expressions in the UNIX Search String%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE52401@%%@4@%A "tagged expression" is a substring delimited by the symbols %@AB@%\%@AE@% (and %@AB@%\%@AE@%). You%@EH@%
can enter any regular-expression characters between these delimiters. Tagged
expressions are used to specify text patterns that contain repeated elements
and to mark a string for reuse.%@NL@%
%@NL@%
%@CR:MSE52402@%%@4@%The editor first searches for a character string that matches the entire%@EH@%
regular expression. It then tags each substring specified in a tagged
expression. Up to nine substrings at a time may be tagged.%@NL@%
%@NL@%
%@CR:MSE52403@%%@4@%Once a tagged expression has been matched, you can refer to the specific%@EH@%
string of characters that matched that expression. Use the syntax%@NL@%
%@NL@%
     %@AS@%\%@AE@%%@AI@%n%@AE@%%@NL@%
%@NL@%
%@CR:MSE52405@%%@4@%in which %@AI@%n%@AE@% is a number that selects the expression. The symbol %@AS@%\1%@AE@%%@EH@%
represents the first tagged expression, the symbol %@AB@%\%@AE@%2 represents the second
tagged expression, and so on. The use of %@AB@%\%@AE@%%@AI@%n%@AE@% does not search for a new match
for the tagged expression. Rather, it matches only an occurrence of the same
characters that the tagged expression itself matched.%@NL@%
%@NL@%
%@CR:MSE52406@%%@4@%For example, consider the following expression:%@EH@%%@NL@%
%@NL@%
     %@AS@%\(.\)\1\1%@AE@%%@NL@%
%@NL@%
%@CR:MSE52407@%%@4@%The expression above means, "match any character, then see if it's followed%@EH@%
by two occurrences of the same character." The following strings all satisfy
this requirement:%@NL@%
%@NL@%
     %@AS@%aaa%@AE@%%@NL@%
     %@AS@%XXX%@AE@%%@NL@%
     %@AS@%111%@AE@%%@NL@%
%@NL@%
%@CR:MSE52409@%%@4@%Note that this regular expression is not equivalent to %@AS@%...%@AE@% (three wild%@EH@%
cards).  The expression %@AS@%...%@AE@% matches any three characters; the characters do
not need to be the same.%@NL@%
%@NL@%
%@CR:MSE5240A@%%@4@%The next expression is more complex:%@EH@%%@NL@%
%@NL@%
     %@AS@%\([A-Za-z]*\)==\1%@AE@%%@NL@%
%@NL@%
%@CR:MSE5240B@%%@4@%This expression means "match any number of letters, then see if the letters%@EH@%
are followed by two equals signs (%@AB@%==%@AE@%) and a repetition of the original
group." This expression matches the first two strings below but not the
third:%@NL@%
%@NL@%
     %@AS@%ABCxyz==ABCxyz%@AE@%%@NL@%
     %@AS@%i==i%@AE@%%@NL@%
     %@AS@%ABCxyz==KBCxjj%@AE@%%@NL@%
%@NL@%
%@NL@%
%@CR:MSE52500@%%@3@%%@AB@%5.2.5  Tagged Expressions in the UNIX Replacement String%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE52501@%%@4@%You can refer to tagged expressions in replacement strings as well as in%@EH@%
search strings. Parts of the string to be replaced may be reused by
referring to the tagged expressions that originally matched those parts. Use
the syntax described in the previous section.%@NL@%
%@NL@%
%@CR:MSE52502@%%@4@%For example, suppose you want to find all occurrences of %@AI@%hexdigits%@AE@%%@AB@%H%@AE@% and%@EH@%
replace them with strings of the form %@AB@%16#%@AE@%%@AI@%hexdigits%@AE@%. You can search for
strings of the form %@AI@%hexdigits%@AE@%%@AB@%H%@AE@% by specifying the regular expression%@NL@%
%@NL@%
     %@AS@%\([0-9a-fA-F]*\)H%@AE@%%@NL@%
%@NL@%
%@CR:MSE52503@%%@4@%and then specifying the following replacement string:%@EH@%%@NL@%
%@NL@%
     %@AS@%16#\1%@AE@%%@NL@%
%@NL@%
%@CR:MSE52504@%%@4@%The result is that the Microsoft Editor searches for any occurrence of one%@EH@%
or more hexadecimal digits (digits 0-9 and the letters a-f) followed by the
letter %@AB@%H%@AE@%. Each matching string is replaced by a new string that consists of
the original digits (which were tagged so they could be reused) and the
prefix %@AB@%16#%@AE@%. For example, the string %@AS@%1a000H%@AE@% is replaced with the string
%@AS@%16#1a000%@AE@%.%@NL@%
%@NL@%
%@CR:MSE52505@%%@4@%Use two backslashes (%@AB@%\\%@AE@%) to represent a literal backslash (%@AB@%\%@AE@%). Within%@EH@%
replacement strings, all characters except the backslashes are literals. The
backslash is considered to be the first character of a regular-expression
reference, such as %@AS@%\4%@AE@%.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE53000@%%@2@%%@AB@%5.3  M 1.0 Regular-Expression Syntax%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE53001@%%@4@%The M 1.0 syntax is fully compatible with the regular-expression syntax used%@EH@%
by Version 1.0 of the Microsoft Editor. This syntax offers all the features
of UNIX regular-expression syntax (though sometimes using different
characters), plus additional features.%@NL@%
%@NL@%
%@CR:MSE53002@%%@4@%To choose M 1.0 syntax, you must set the %@AB@%unixre%@AE@% switch to off, as described%@EH@%
in Section 5.1%@BO:   20e9f@%, "Choosing the Syntax."%@NL@%
%@NL@%
%@NL@%
%@CR:MSE53100@%%@3@%%@AB@%5.3.1  M 1.0 Regular Expressions as Simple Strings%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE53101@%%@4@%The power of regular expressions comes from the use of the special%@EH@%
characters listed below. A regular expression that does not contain these
special characters acts as if it were a literal text string:%@NL@%
%@NL@%
     %@AB@%\  {  }  (  )  [  ]  !  ~  :  ?  ^  $  +  *  @  #%@AE@%%@NL@%
%@NL@%
%@CR:MSE53103@%%@4@%For example, the regular expression %@AS@%match me precisely%@AE@% matches only a%@EH@%
literal occurrence of itself because it contains no special characters.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE53200@%%@3@%%@AB@%5.3.2  M 1.0 Special Characters%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE53201@%%@4@%The M 1.0 syntax offers a rich set of pattern-matching capabilities. Most of%@EH@%
the special characters described below have analogs in other editors and
utilities that use regular expressions.%@NL@%
%@NL@%
%@CR:MSE53202@%%@4@%The list below describes the special characters that have a simple usage.%@EH@%
The term %@AI@%class%@AE@% has a special meaning defined below. All other characters
should be interpreted literally.%@NL@%
%@NL@%
%@CR:MSE53203@%%@AB@%Expression                  Description%@AE@%%@NL@%
%@NL@%
%@AB@%\%@AE@%                           Escape. Causes the editor to ignore the special%@NL@%
                            meaning of the next character. For example, the%@NL@%
                            expression %@AS@%\?%@AE@% matches %@AS@%?%@AE@% in the text file; the%@NL@%
                            expression %@AS@%\^%@AE@% matches %@AS@% %@AE@%%@AS@%^%@AE@%; and the expression %@AS@%\\%@AE@%%@NL@%
                            matches %@AS@%\%@AE@%.%@NL@%
%@NL@%
%@AB@%?%@AE@%                           Wildcard. Matches any single character. For%@NL@%
                            example, the expression %@AS@%a?a%@AE@% matches %@AS@%aaa%@AE@%, %@AS@%aBa%@AE@%,%@NL@%
                            and %@AS@%a1a%@AE@%, but not %@AS@%aBBBa%@AE@%.%@NL@%
%@NL@%
%@AB@%^%@AE@%                           Beginning of line. For example, %@AS@%^The%@AE@% matches the%@NL@%
                            word %@AS@%The%@AE@% only when it occurs at the beginning of%@NL@%
                            a line.%@NL@%
%@NL@%
%@AB@%$%@AE@%                           End of line. For example, %@AS@%end$%@AE@% matches the word %@AS@%%@AE@%%@NL@%
                            %@AS@%end%@AE@% only when it occurs at the end of a line.%@NL@%
%@NL@%
%@AB@%[%@AE@%%@AI@%class%@AE@%%@AB@%]%@AE@%                     Character class. Matches any one character in%@NL@%
                            the class. Use a dash (%@AB@%-%@AE@%) to specify ranges. For%@NL@%
                            example, %@AS@%[a-zA-Z0-9]%@AE@% matches any character or%@NL@%
                            digit, and %@AS@%[abc]%@AE@% matches %@AS@%a%@AE@%, %@AS@%b%@AE@%, or %@AS@%c%@AE@%.%@NL@%
%@NL@%
%@AB@%[~%@AE@%%@AI@%class%@AE@%%@AB@%]%@AE@%                    Noncharacter class. Matches any character not%@NL@%
                            specified in the class.%@NL@%
%@NL@%
%@CR:MSE53204@%%@4@%The special characters with more complex usage are described in the%@EH@%
following list. The expression %@AI@%X%@AE@% is a placeholder representing a regular
expression that is either a single character or a group of characters
enclosed in parentheses (%@AB@%()%@AE@%), brackets (%@AB@%[]%@AE@%), or braces (%@AB@%{}%@AE@%). The
placeholders %@AI@%X1%@AE@%, %@AI@%X2%@AE@%, and so on, represent any regular expression.%@NL@%
%@NL@%
%@CR:MSE53205@%%@AU@%Expression                  Description%@AE@%%@NL@%
%@NL@%
%@AI@%X%@AE@%%@AB@%*%@AE@%                          Minimal matching. Matches zero or more%@NL@%
                            occurrences of %@AI@%X%@AE@%. For example: the regular%@NL@%
                            expression %@AS@%ba*b%@AE@% matches %@AS@%baaab%@AE@%, %@AS@%bab%@AE@%, and %@AS@%bb%@AE@%.%@NL@%
%@NL@%
%@AI@%X%@AE@%%@AB@%+%@AE@%                          Minimal matching plus (shorthand for %@AI@%XX%@AE@%%@AB@%*%@AE@%).%@NL@%
                            Matches one or more occurrences of %@AI@%X%@AE@%. The%@NL@%
                            regular expression %@AS@%ba+b%@AE@% matches %@AS@%baab%@AE@% and %@AS@%bab%@AE@%%@NL@%
                            but not %@AS@%bb%@AE@%.%@NL@%
%@NL@%
%@AI@%X%@AE@%%@AB@%@%@AE@%                          Maximal matching. Identical to %@AI@%X%@AE@%%@AB@%*%@AE@%, except for%@NL@%
                            differences in matching method explained in%@NL@%
                            Section 5.3.4.%@BO:   26bc3@%%@NL@%
%@NL@%
%@AI@%X%@AE@%%@AB@%#%@AE@%                          Maximal matching plus. Identical to %@AI@%X%@AE@%%@AB@%+%@AE@%, except%@NL@%
                            for differences in matching method explained in%@NL@%
                            Section 5.3.4.%@BO:   26bc3@%%@NL@%
%@NL@%
%@AB@%(%@AE@%%@AI@%X1%@AE@%%@AB@%!%@AE@%%@AI@%X2%@AE@%%@AB@%!%@AE@%...%@AB@%!%@AE@%%@AI@%Xn%@AE@%%@AB@%)%@AE@%              Alternation. Matches either %@AI@%X1%@AE@%, %@AI@%X2%@AE@%, and so%@NL@%
                            forth. It tries to match them in that order and%@NL@%
                            switches from %@AI@%Xi%@AE@% to %@AI@%Xi+1%@AE@% only if the rest of the%@NL@%
                            expression fails to match. For example, the%@NL@%
                            regular expression %@AS@%(ww!xx!xxyy)zz%@AE@% matches %@AS@%xxzz%@AE@%%@NL@%
                            on the second alternative and %@AS@%xxyyzz%@AE@% on the%@NL@%
                            third.%@NL@%
%@NL@%
%@AB@%~%@AE@%%@AI@%X%@AE@%                          Not function. Matches nothing, but checks to see%@NL@%
                            if the string matches %@AI@%X%@AE@% at this point and fails%@NL@%
                            if it does. For example, %@AS@%^~(if!while)?*$%@AE@% matches%@NL@%
                            all lines that do not begin with %@AS@%if%@AE@% or %@AS@%while%@AE@%.%@NL@%
%@NL@%
%@AI@%X%@AE@%%@AB@%^%@AE@%%@AI@%n%@AE@%                         Power function. Matches exactly %@AI@%n%@AE@% copies of %@AI@%X%@AE@%.%@NL@%
                            For example, %@AS@%w^4%@AE@% matches %@AS@%wwww%@AE@% and %@AS@%(a?)^3%@AE@% matches%@NL@%
                            %@AS@%a#aba5%@AE@%.%@NL@%
%@NL@%
%@AB@%{%@AE@%...%@AB@%}%@AE@%                       Tagged expression, which is a string of%@NL@%
                            characters you identify so that you can refer to%@NL@%
                            them elsewhere, as %@AB@%$%@AE@%%@AI@%n%@AE@%. By referring to a tagged%@NL@%
                            expression in a search string, you cause the%@NL@%
                            editor to look for patterns involving%@NL@%
                            duplication. By referring to a tagged expression%@NL@%
                            in a replacement string, you cause the editor to%@NL@%
                            reuse part of the text that it is replacing.%@NL@%
%@NL@%
                            The exact use of tags is explained in Sections%@NL@%
                            5.3.5%@BO:   27441@% and 5.3.6%@BO:   27df8@%. Characters within braces are%@NL@%
                            treated as a group.%@NL@%
%@NL@%
%@AB@%$%@AE@%%@AI@%n%@AE@%                          Reference to a previously tagged substring. The%@NL@%
                            number %@AI@%n%@AE@% indicates which substring. The first%@NL@%
                            tagged substring is represented as %@AB@%$%@AE@% 1, the%@NL@%
                            second as %@AB@%$%@AE@% 2, and so on. %@AB@%$%@AE@% 0 represents the%@NL@%
                            entire matched string.%@NL@%
%@NL@%
%@AB@%:%@AE@%%@AI@%letter%@AE@%                     Predefined string. The list of predefined%@NL@%
                            strings is given in Section 5.3.7.%@BO:   2885d@%%@NL@%
%@NL@%
%@CR:MSE53206@%%@4@%The procedure below uses some of the special characters presented in this%@EH@%
section. To find the next occurrence of a number (that is, a string of
digits) beginning with a digit 1 or 2, perform the following sequence of
keystrokes:%@NL@%
%@NL@%
%@CR:MSE53207@%  1. Invoke %@AI@%Arg%@AE@% twice(press ALT + A twice)%@NL@%
  2. Type the following characters: %@AS@%[12][0-9]*%@AE@%%@NL@%
  3. Invoke %@AI@%Psearch%@AE@% (press F3)%@NL@%
%@NL@%
%@NL@%
%@CR:MSE53300@%%@3@%%@AB@%5.3.3  Combining M 1.0 Special Characters%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE53301@%%@4@%Special characters are most powerful when used in combination. For example,%@EH@%
the %@AS@%?%@AE@% and %@AS@%*%@AE@% characters are often used together:%@NL@%
%@NL@%
     %@AS@%?*%@AE@%%@NL@%
%@NL@%
%@CR:MSE53302@%%@4@%The expression above means "match any string of characters." Although this%@EH@%
expression is not useful by itself, it is quite useful when part of a larger
expression. For example,%@NL@%
%@NL@%
     %@AS@%B?*ing%@AE@%%@NL@%
%@NL@%
%@CR:MSE53303@%%@4@%means "match any characters beginning with %@AS@%B%@AE@% and ending with %@AS@%ing%@AE@%".%@EH@%%@NL@%
%@NL@%
%@CR:MSE53304@%%@4@%Many of the special characters in the previous section (such as + and *) are%@EH@%
%@AI@%operators%@AE@%; they work with other characters to form expressions. These
operators usually apply to the previous character or an expression enclosed
in braces, brackets, or parentheses. However, it is possible to find
exceptions to this rule. For example, the following expression is
meaningful:%@NL@%
%@NL@%
     %@AS@%S^2+%@AE@%%@NL@%
%@NL@%
%@CR:MSE53305@%%@4@%The plus sign (%@AS@%+%@AE@%) applies to the entire expression %@AS@%S^2%@AE@%. In effect, this%@EH@%
expression means, "match any even number of occurrences of the letter S."
Therefore, this expression means the same as this:%@NL@%
%@NL@%
     %@AS@%(S^2)+%@AE@%%@NL@%
%@NL@%
%@CR:MSE53306@%%@4@%Precedence is left to right in cases where a single character is surrounded%@EH@%
by two operators. If there is any doubt about the precedence of operators,
use parentheses.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE53400@%%@3@%%@AB@%5.3.4  M 1.0 Matching Method%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE53401@%%@4@%The matching method you use is significant only when you use a%@EH@%
search-and-replace function. The term "matching method" refers to the
technique used to match repeated expressions. For example, does %@AS@%a*%@AE@% match as
few or as many characters as it can? The answer depends on the matching
method. There are two matching methods:%@NL@%
%@NL@%
%@CR:MSE53402@%%@AB@%Method                      Description%@AE@%%@NL@%
%@NL@%
Minimal                     The minimal method matches as few characters as%@NL@%
                            possible in order to find a match. For example,%@NL@%
                            %@AS@%a+%@AE@% matches only the first character in %@AS@%aaaaaa%@AE@%.%@NL@%
                            However, %@AS@%ba+b%@AE@% matches the entire string%@NL@%
                            %@AS@%baaaaaab%@AE@%, since it is necessary to match every%@NL@%
                            occurrence of %@AS@%a%@AE@% in order to match both%@NL@%
                            occurrences of %@AS@%b%@AE@%.%@NL@%
%@NL@%
Maximal                     The maximal method always matches as many%@NL@%
                            characters as it can. For example, %@AS@%a#%@AE@% matches%@NL@%
                            the entire string %@AS@%aaaaaa%@AE@%.%@NL@%
%@NL@%
%@CR:MSE53403@%%@4@%The significance of these two methods may not be apparent until you use%@EH@%
search and replace. For example, if %@AS@%a+%@AE@% (minimal matching plus) is the search
string and %@AS@%EE%@AE@% is the replacement string,%@NL@%
%@NL@%
     %@AS@%aaaaa%@AE@%%@NL@%
%@NL@%
%@CR:MSE53404@%%@4@%is replaced with%@EH@%%@NL@%
%@NL@%
     %@AS@%EEEEEEEEEE%@AE@%%@NL@%
%@NL@%
%@CR:MSE53405@%%@4@%because each occurrence of %@AS@%a%@AE@% is immediately replaced by %@AS@%EE%@AE@%. However, if %@AS@%a#%@AE@%%@EH@%
(maximal matching plus) is the search string, the same string is replaced
with%@NL@%
%@NL@%
     %@AS@%EE%@AE@%%@NL@%
%@NL@%
%@CR:MSE53406@%%@4@%because the entire string %@AS@%aaaaa%@AE@% is matched at once and replaced with %@AS@%EE%@AE@%.%@EH@%%@NL@%
%@NL@%
%@NL@%
%@CR:MSE53500@%%@3@%%@AB@%5.3.5  Tagged Expressions in the M 1.0 Search String%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE53501@%%@4@%A "tagged expression" is a substring delimited by curly braces (%@AB@%{ }%@AE@%). You%@EH@%
can enter any regular-expression characters between these delimiters. Tagged
expressions are used to specify text patterns that contain repeated elements
and to mark a string for reuse.%@NL@%
%@NL@%
%@CR:MSE53502@%%@4@%The editor first searches for a character string that matches the entire%@EH@%
regular expression. It then tags each substring specified in a tagged
expression. Up to nine substrings at a time may be tagged.%@NL@%
%@NL@%
%@CR:MSE53503@%%@4@%Once an expression is tagged, you can refer to the specific string of%@EH@%
characters that matched the expression. Use the syntax%@NL@%
%@NL@%
     %@AB@%$%@AE@%%@AI@%n%@AE@%%@NL@%
%@NL@%
%@CR:MSE53505@%%@4@%in which %@AI@%n%@AE@% is a number that selects the expression. The symbol %@AB@%$1%@AE@%%@EH@%
represents the first tagged expression, the symbol %@AB@%$2%@AE@% represents the second
tagged expression, and so on. The use of %@AB@%$%@AE@%%@AI@%n%@AE@% does not search for a new match
for the tagged expression. Rather, it matches only an occurrence of the same
characters that the tagged expression itself matched.%@NL@%
%@NL@%
%@CR:MSE53506@%%@4@%For example, consider the following expression:%@EH@%%@NL@%
%@NL@%
     %@AS@%{?}$1$1%@AE@%%@NL@%
%@NL@%
%@CR:MSE53507@%%@4@%The expression above means, "match any character, then see if it's followed%@EH@%
by two occurrences of the same character." The following strings all satisfy
this requirement:%@NL@%
%@NL@%
     %@AS@%aaa%@AE@%%@NL@%
     %@AS@%XXX%@AE@%%@NL@%
     %@AS@%111%@AE@%%@NL@%
%@NL@%
%@CR:MSE53509@%%@4@%Note that this regular expression is not equivalent to %@AS@%???%@AE@% (three wild%@EH@%
cards). The expression %@AS@%???%@AE@% matches any three characters; the characters do
not need to be the same.%@NL@%
%@NL@%
%@CR:MSE5350A@%%@4@%The next expression is more complex:%@EH@%%@NL@%
%@NL@%
     %@AS@%{[A-Za-z]*}==$1%@AE@%%@NL@%
%@NL@%
%@CR:MSE5350B@%%@4@%This expression means "match any number of letters, then see if the letters%@EH@%
are followed by two equals signs (%@AS@%==%@AE@%) and a repetition of the original
group." This expression matches the first two strings below but not the
third:%@NL@%
%@NL@%
     %@AS@%ABCxyz==ABCxyz%@AE@%%@NL@%
     %@AS@%i==i%@AE@%%@NL@%
     %@AS@%ABCxyz==KBCxjj%@AE@%%@NL@%
%@NL@%
%@NL@%
%@CR:MSE53600@%%@3@%%@AB@%5.3.6  Tagged Expressions in the M 1.0 Replacement String%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE53601@%%@4@%You can refer to tagged expressions in replacement strings as well as in%@EH@%
search strings. Parts of the string to be replaced may be reused by
referring to the tagged expressions that originally matched those parts. Use
the syntax described in the previous section.%@NL@%
%@NL@%
%@CR:MSE53602@%%@4@%For example, suppose you want to find all occurrences of %@AI@%hexdigits%@AE@%%@AB@%H%@AE@% and%@EH@%
replace them with strings of the form %@AB@%16#%@AE@%%@AI@%hexdigits%@AE@%. You can search for
strings of the form %@AI@%hexdigits%@AE@%%@AB@%H%@AE@% by specifying the regular expression%@NL@%
%@NL@%
     %@AS@%{[0-9a-fA-F]+}H%@AE@%%@NL@%
%@NL@%
%@CR:MSE53603@%%@4@%and then specifying the following replacement string:%@EH@%%@NL@%
%@NL@%
     %@AS@%16#$1%@AE@%%@NL@%
%@NL@%
%@CR:MSE53604@%%@4@%The result is that the Microsoft Editor searches for any occurrence of one%@EH@%
or more hexadecimal digits (digits 0-9 and the letters a-f) followed by the
letter %@AB@%H%@AE@%. Each matching string is replaced by a new string that consists of
the original digits (which were tagged so they could be reused) and the
prefix %@AB@%16#%@AE@%. For example, the string %@AS@%1a000H%@AE@% is replaced with the string
%@AS@%16#1a000%@AE@%.%@NL@%
%@NL@%
%@CR:MSE53605@%%@4@%The editor recognizes six special characters──%@AB@%$  (  ,  )  -%@AE@%%@AB@%\%@AE@%──within%@EH@%
replacement strings. Each of these characters should be preceded by a
backslash (%@AB@%\%@AE@%) if you want to use a literal occurrence of one of them in a
replacement string. The %@AS@%#%@AE@% sign in the replacement string shown above is not
treated as a regular-expression character.%@NL@%
%@NL@%
%@CR:MSE53606@%%@4@%You can also use the expression%@EH@%%@NL@%
%@NL@%
     %@AB@%$(%@AE@%%@AI@%w%@AE@%%@AB@%,%@AE@%%@AI@%n%@AE@%%@AB@%)%@AE@%%@NL@%
%@NL@%
%@CR:MSE53608@%%@4@%in which %@AI@%w%@AE@% is a field length. This number can be positive or negative. A%@EH@%
negative number indicates left justification.%@NL@%
%@NL@%
%@CR:MSE53609@%%@4@%If %@AI@%w%@AE@% is greater than the length of the tagged expression, the editor right%@EH@%
justifies the tagged expression within the field and pads the field with
leading spaces. If %@AI@%w%@AE@% is greater than the length of the expression but is
preceded by a negative sign, the editor left justifies the expression and
pads the field with trailing spaces. If %@AI@%w%@AE@% is equal or less than the length
of the expression, the editor prints the whole expression but does not pad
with spaces.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE53700@%%@3@%%@AB@%5.3.7  Predefined M 1.0 Regular Expressions%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE53701@%%@4@%Several M 1.0 regular expressions are defined in Table 5.1%@BO:   28999@% for your%@EH@%
convenience. You can use them by entering %@AB@%:%@AE@%%@AI@%letter%@AE@% in a regular expression.%@NL@%
%@NL@%
%@CR:MSE5T100@%%@4@%%@AU@%Table 5.1  Predefined Expressions%@AE@%%@EH@%%@NL@%
%@TH:   25   1060  1 12 42 22 @%
%@AB@%Letter      Meaning                                   Description%@AE@%

%@AB@%:a%@AE@%          [a-zA-Z0-9]                               Alphanumeric

%@AB@%:b%@AE@%          ([\t]#)                                   White space

%@AB@%:c%@AE@%          [a-zA-Z]                                  Alphabetic

%@AB@%:d%@AE@%          [0-9]                                     Digit

%@AB@%:f%@AE@%          ([~"\[\]\:<|>+=;,.\\/]#)                  Portion of a file name

%@AB@%:h%@AE@%          ([0-9a-fA-F]#)                            Hexadecimal number

%@AB@%:i%@AE@%          ([a-zA-Z_$][a-zA-Z0-9_$]@)                C-language identifier

%@AB@%:n%@AE@%          ([0-9]#[0-9]@![0-9]@.[0-9]#![0-9]#)       Number

%@AB@%:p%@AE@%          (([a-z]\:!)(\\!)(:f(:f!)\\)@:f(.:f!))     Path

%@AB@%:q%@AE@%          ("[~"]@"!'[~']@')                         Quoted string

%@AB@%:w%@AE@%          ([a-zA-Z]#)                               Word

%@AB@%:z%@AE@%          ([0-9]#)                                  Integer
%@TE:   25   1060  1 12 42 22 @%
%@NL@%
%@NL@%
%@CR:MSE60000@%%@1@%%@AB@%Chapter 6  Function Assignments and Macros%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@CR:MSE60001@%%@4@%One of the strengths of the Microsoft Editor is you can customize it to your%@EH@%
own needs. You can change screen characteristics, select default behavior,
and specify which functions are connected to which keystrokes. You can also
create new editing functions. The editor supports four techniques for
customization, described in Section 6.1.%@BO:   292f2@%%@NL@%
%@NL@%
%@CR:MSE60002@%%@4@%This chapter discusses two of those techniques: function assignments and%@EH@%
macros. Function assignments alter the action of keystrokes. Macros are
editing commands that you create using a simple syntax. The other two
methods for customizing the editor, switch settings and C extensions, are
described in Chapters 7%@BO:   3396c@%, 8%@BO:   3fbeb@%, and 9%@BO:   50fea@%.%@NL@%
%@NL@%
%@CR:MSE60003@%%@4@%This chapter covers the following topics:%@EH@%%@NL@%
%@NL@%
%@CR:MSE60004@%  ■  Techniques for customizing the editor%@NL@%
  ■  Assigning functions to keystrokes%@NL@%
  ■  Creating macros%@NL@%
%@NL@%
%@NL@%
%@CR:MSE61000@%%@2@%%@AB@%6.1  The Four Techniques for Customizing the Editor%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE61001@%%@4@%Each of the four techniques for customizing the editor has a distinct%@EH@%
purpose. Yet you can use these techniques in combination. For example, an
extension can execute a macro, and a macro can make an assignment. Each
technique is described below:%@NL@%
%@NL@%
%@CR:MSE61002@%%@AB@%Technique                   Description%@AE@%%@NL@%
%@NL@%
Function assignment         Assigns a function to a particular keystroke.%@NL@%
                            This capability lets you control the meaning of%@NL@%
                            all recognized keystrokes.%@NL@%
%@NL@%
Macro assignment            Creates a new editing command out of strings of%@NL@%
                            text and existing editing functions. Macros use%@NL@%
                            a simple syntax and can be created very fast.%@NL@%
                            Use macros when you need to quickly define a new%@NL@%
                            command or repetitive activity.%@NL@%
%@NL@%
Switch assignment           Alters a specific editor condition, for example,%@NL@%
                            screen colors, screen height, scrolling%@NL@%
                            behavior, tab behavior, and many other%@NL@%
                            conditions. These conditions are adjusted by%@NL@%
                            setting various editing "switches," as explained%@NL@%
                            in Chapter 7%@BO:   3396c@%.%@NL@%
%@NL@%
C extension                 Generates a new editing function compiled with%@NL@%
                            Microsoft C or assembled with the Macro%@NL@%
                            Assembler. Extensions take longer to create than%@NL@%
                            macros, but they run faster and are more%@NL@%
                            flexible. See Chapter 8%@BO:   3fbeb@% for more information.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE62000@%%@2@%%@AB@%6.2  Assigning Functions to Keystrokes%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE62001@%%@4@%A function assignment lets you alter the meaning of any keystroke. In this%@EH@%
context, a "keystroke" is any recognized function key, special key, or ALT+,
SHIFT+, or CTRL+key combination. You can also alter the meaning of
alphanumeric keys, but doing so can interfere with your ability to type
characters.%@NL@%
%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@AI@%NOTE%@AE@%%@NL@%
   Any editing function, macro, or extension function can be assigned to a%@NL@%
   keystroke as described in this chapter.%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@CR:MSE62002@%%@4@%When a new assignment has been made, you can use that keystroke to invoke%@EH@%
the function at any time during the editing session. Take into account the
following points when assigning functions to keystrokes:%@NL@%
%@NL@%
%@CR:MSE62003@%  1. The function assignments you make during the editing session are lost%@NL@%
     when you exit the editor. See Chapter 7%@BO:   3396c@%, "Switches, Assignments, and%@NL@%
     the TOOLS.INI File," for information on making assignments that are%@NL@%
     automatically recognized in each editing session.%@NL@%
%@NL@%
     When using the assignments screen to view and alter assignments, you%@NL@%
     have the option of automatically saving your changes. See Section%@NL@%
     6.2.2%@BO:   2b13c@%, "Viewing and Changing Function Assignments," for more%@NL@%
     information.%@NL@%
%@NL@%
  2. A function can be assigned to more than one keystroke at the same time.%@NL@%
%@NL@%
  3. Each keystroke can have only one function assigned to it at any one%@NL@%
     time. Therefore, a new function assignment to a given keystroke cancels%@NL@%
     any previous meaning the keystroke may have had. Assigning the%@NL@%
     %@AI@%Unassigned%@AE@% function, as explained in Section 6.2.3%@BO:   2bbd2@%, cancels the%@NL@%
     keystroke's previous meaning without substituting a new meaning.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE62100@%%@3@%%@AB@%6.2.1  Making Function Assignments%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE62101@%%@4@%There are two ways to make a function assignment. You can use the %@AI@%Assign%@AE@%%@EH@%
function, or edit the assignments screen as described in the next section.%@NL@%
%@NL@%
%@CR:MSE62102@%%@4@%To assign a function to a keystroke with the %@AI@%Assign%@AE@% command, issue the %@AI@%Arg%@AE@%%@EH@%
%@AI@%textarg Assign%@AE@% command (ALT+A %@AI@%textarg%@AE@% ALT+=), where %@AI@%textarg%@AE@% uses the
following syntax:%@NL@%
%@NL@%
     %@AI@%functionname%@AE@%%@AB@%:%@AE@%%@AI@%keystroke%@AE@%%@NL@%
%@NL@%
%@CR:MSE62104@%%@4@%Here, %@AI@%keystroke%@AE@% may be any of the following:%@EH@%%@NL@%
%@NL@%
%@CR:MSE62105@%  1. Numeric keys: 0 through 9%@NL@%
%@NL@%
  2. Lowercase letter keys: a through z%@NL@%
%@NL@%
  3. Uppercase letter keys: A through Z%@NL@%
%@NL@%
  4. Function keys: F1 through F10 (F11 and F12 recognized for enhanced%@NL@%
     keyboards)%@NL@%
%@NL@%
  5. Lowercase punctuation: ` - = [ ] \ ; ' , . /%@NL@%
%@NL@%
  6. Uppercase punctuation: ~ ! @ # $ % ^ & * ( ) _ + { } | : " ?%@NL@%
%@NL@%
  7. Numeric-keypad white keys when NUMLOCK is turned off: HOME, END, LEFT,%@NL@%
     RIGHT, UP, DOWN, PGUP, PGDN, INS, and GOTO, which corresponds to the%@NL@%
     numeric-keypad 5 key.%@NL@%
%@NL@%
  8. Numeric-keypad white keys when NUMLOCK is turned on: 0 through 9. To%@NL@%
     assign a function to the 4 key on the numeric keypad, enter the%@NL@%
     following as the %@AI@%keystroke%@AE@%:%@NL@%
%@NL@%
         %@AS@%NUM4%@AE@%%@NL@%
%@NL@%
  9. Numeric-keypad gray keys: NUM-, NUM+, and NUM*%@NL@%
%@NL@%
 10. Other named keys: BKSP, TAB, ESC, SPACEBAR, and ENTER%@NL@%
%@NL@%
 11. Combinations:%@NL@%
%@NL@%
     a.   ALT+ followed by items 1, 2, 4, 5, 9, or 10%@NL@%
     b.   CTRL+ followed by items 2, 4, 7, 8, 9, or 10%@NL@%
     c.   SHIFT+ followed by items 4, 7, 8, 9, or 10%@NL@%
%@NL@%
%@CR:MSE62106@%%@4@%If you have a Tandy(R) 1000, the following additional keystrokes are%@EH@%
recognized:%@NL@%
%@NL@%
%@CR:MSE62107@%  1. Function keys: F11 and F12%@NL@%
%@NL@%
  2. CTRL+ followed by UP and DOWN%@NL@%
%@NL@%
  3. ALT+ followed by UP, DOWN, LEFT, and RIGHT%@NL@%
%@NL@%
  4. SHIFT+ followed by UP, DOWN, LEFT, and RIGHT%@NL@%
%@NL@%
%@CR:MSE62108@%%@4@%If you have a 101-key enhanced keyboard, all the keystrokes recognized for%@EH@%
the Tandy 1000 are supported, as well as the following: NUMENTER, NUM\, and
all CTRL, ALT, and SHIFT combinations of these two keys. In addition, the
enhanced keyboard has a duplicate set of item 7 above, which is not affected
by the state of NUMLOCK. All CTRL, ALT, and SHIFT combinations of these keys
are recognized.%@NL@%
%@NL@%
%@CR:MSE62109@%%@4@%%@AB@%Example%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE6210A@%%@4@%For example, the function %@AI@%Savecur%@AE@% is assigned to the keystroke CTRL+B in%@EH@%
this manner:%@NL@%
%@NL@%
%@CR:MSE6210B@%  1. Invoke the %@AI@%Arg%@AE@% function (press ALT+A)%@NL@%
%@NL@%
  2. Enter the function and keystroke as the %@AI@%textarg%@AE@% by typing the%@NL@%
     following:%@NL@%
%@NL@%
         %@AS@%savecur:CTRL+W%@AE@%%@NL@%
%@NL@%
  3. Invoke the %@AI@%Assign%@AE@% function (press ALT+=)%@NL@%
%@NL@%
     Note that function names are not case-sensitive, so you can enter them%@NL@%
     as all lowercase.%@NL@%
%@NL@%
%@CR:MSE6210C@%%@4@%From this point on, pressing CTRL+W invokes the %@AI@%Savecur%@AE@% function and saves%@EH@%
the current cursor position. You can make this assignment automatic by
placing it in the TOOLS.INI file, as explained in Chapter 7%@BO:   3396c@%.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE62200@%%@3@%%@AB@%6.2.2  Viewing and Changing Function Assignments%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE62201@%%@4@%The <assign> pseudo file shows you what function assignments and switch%@EH@%
values are in effect at any time during the editing session. This file lists
all functions in alphabetical order along with the keys to which they are
assigned. Use any of the following methods to get to this screen:%@NL@%
%@NL@%
%@CR:MSE62202@%  ■  Press SHIFT+F1 to get the initial Help screen. Then select Current%@NL@%
     Assignments.%@NL@%
%@NL@%
  ■  Use the %@AI@%Setfile%@AE@% function (F2), giving %@AS@%<assign>%@AE@% as a text argument.%@NL@%
%@NL@%
  ■  Give the %@AI@%Assign%@AE@% command (ALT+A), entering a question mark (%@AS@%?%@AE@%) as a text%@NL@%
     argument.%@NL@%
%@NL@%
%@CR:MSE62203@%%@4@%Once you get to the assignments screen, you can scroll through the%@EH@%
information as you would through any file.  Use the %@AI@%Setfile%@AE@% function (F2) to
return to your original file.%@NL@%
%@NL@%
%@CR:MSE62204@%%@4@%You can also change assignments from within this file by following these%@EH@%
steps:%@NL@%
%@NL@%
%@CR:MSE62205@%  1. Move the cursor to the line that contains the function assignment you%@NL@%
     wish to change.%@NL@%
%@NL@%
  2. Edit the line so that it contains a new function assignment.%@NL@%
%@NL@%
  3. Move the cursor to a different line. If the assignment you entered is%@NL@%
     syntactically correct, the editor highlights the line to show that the%@NL@%
     new assignment was accepted. If the assignment was incorrect, the%@NL@%
     editor restores the line to its previous state and reports an error%@NL@%
     message.%@NL@%
%@NL@%
%@CR:MSE62206@%%@4@%You can execute a save operation while in the <assign> pseudo file by giving%@EH@%
the %@AI@%Arg Arg Setfile%@AE@% command. This command (which normally saves a file to
disk under its own name) directs the editor to write any new assignments you
have made to the TOOLS.INI file. Each time it starts, the editor
automatically recognizes function assignments placed in this file. See
Chapter 7%@BO:   3396c@%, "Switches, Assignments, and the TOOLS.INI File," for more
information about TOOLS.INI.%@NL@%
%@NL@%
%@CR:MSE62207@%%@4@%The %@AI@%Tell%@AE@% function (CTRL+T) gives you an alternative way of seeing what%@EH@%
function is assigned to any given keystroke. Give the command %@AI@%Arg Tell%@AE@%
(ALT+A CTRL+T), then enter a keystroke. The editor prints the name of the
function assigned to this keystroke on the dialog line.%@NL@%
%@NL@%
%@CR:MSE62208@%%@4@%For more information on the %@AI@%Tell%@AE@% function, see Appendix A%@BO:   5d119@%, "Reference%@EH@%
Tables."%@NL@%
%@NL@%
%@NL@%
%@CR:MSE62300@%%@3@%%@AB@%6.2.3  Disabling a Keystroke%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE62301@%%@4@%To disable a keystroke so it invokes no function at all, assign the function%@EH@%
%@AI@%Unassigned%@AE@% to the keystroke. As with other function assignments, use the
%@AI@%Arg textarg Assign%@AE@% command. The argument %@AI@%textarg%@AE@% uses the following syntax:%@NL@%
%@NL@%
     %@AI@%unassigned%@AE@%%@AB@%:%@AE@%%@AI@%key%@AE@%%@NL@%
%@NL@%
%@CR:MSE62303@%%@4@%Here, %@AI@%key%@AE@% is the keystroke you want to remove.%@EH@%%@NL@%
%@NL@%
%@CR:MSE62304@%%@4@%For example, to disable the keystroke CTRL+A, perform the following steps:%@EH@%%@NL@%
%@NL@%
%@CR:MSE62305@%  1. Invoke the %@AI@%Arg%@AE@% function (press ALT+A)%@NL@%
%@NL@%
  2. Enter the function name as %@AI@%Unassigned%@AE@% and the keystroke by typing the%@NL@%
     following:%@AS@% unassigned:CTRL+A%@AE@%%@NL@%
%@NL@%
  3. Invoke the %@AI@%Assign%@AE@% function (press ALT+=)%@NL@%
%@NL@%
%@CR:MSE62306@%%@4@%After these steps are carried out, pressing CTRL+A does not invoke any%@EH@%
functions. (Disabling a keystroke is temporary if you have set the key
assignment in the TOOLS.INI file. For permanent results, change the
TOOLS.INI file.)%@NL@%
%@NL@%
%@NL@%
%@CR:MSE62400@%%@3@%%@AB@%6.2.4  Making a Keystroke Literal%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE62401@%%@4@%Many text editors allow you to enter only alphanumeric characters and%@EH@%
punctuation into a file. However, the Microsoft Editor makes it easy for you
to insert special characters.%@NL@%
%@NL@%
%@CR:MSE62402@%%@4@%Each keystroke corresponds to an ASCII value. When a keystroke is considered%@EH@%
a "literal" or "graphic," pressing the key causes the editor to place the
corresponding value into the file.  For example, if you make the keystroke
CTRL+D a literal key, the editor places a character with the decimal value 4
into the file each time you press CTRL+D.%@NL@%
%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@AI@%NOTE%@AE@%%@NL@%
   When you use a special keystroke (such as %@AI@%F1%@AE@% or %@AI@%ALT+A%@AE@%) as a literal, it%@NL@%
   loses any special meaning it would otherwise have and will not invoke a%@NL@%
   function. If the special value is one that can be printed (for example,%@NL@%
   if it is a printable extended-ASCII character), the editor displays the%@NL@%
   corresponding character on the screen.%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@CR:MSE62403@%%@4@%The Microsoft Editor provides two methods for converting a keystroke to a%@EH@%
literal character. The first method is to use the %@AI@%Quote%@AE@% function. When you
invoke the %@AI@%Quote%@AE@% function (CTRL+P),  the next key that you press──regardless
of what-ever special meaning it may otherwise have──is regarded as a literal
character.%@NL@%
%@NL@%
%@CR:MSE62404@%%@4@%The second method is to assign the %@AI@%Graphic%@AE@% function to the keystroke.  This%@EH@%
uses the same syntax as any other function assignment: %@AI@%Arg textarg Assign%@AE@%.
Assigning %@AI@%Graphic%@AE@% cancels any previous assignment to the keystroke, and
causes the editor to consider the keystroke a literal character. For
example, to insert a form-feed character in the file whenever CTRL+L is
pressed, first follow these steps:%@NL@%
%@NL@%
%@CR:MSE62405@%  1. Invoke the %@AI@%Arg%@AE@% function (press ALT+A)%@NL@%
%@NL@%
  2. Enter the function %@AI@%Graphic%@AE@% and the keystroke as the %@AI@%textarg%@AE@% by typing%@NL@%
     the following: %@AS@%graphic:CTRL+L%@AE@%%@NL@%
%@NL@%
  3. Invoke the %@AI@%Assign%@AE@% function (press ALT+=)%@NL@%
%@NL@%
%@CR:MSE62406@%%@4@%The choice between assigning the %@AI@%Graphic%@AE@% function or invoking the %@AI@%Quote%@AE@%%@EH@%
function depends on the situation. If you want to enter a special value into
the file repeatedly, it is often easier to assign the %@AI@%Graphic%@AE@% function to
the keystroke──since you only need to do it once. However, use of the %@AI@%Quote%@AE@%
function provides you with more control.%@NL@%
%@NL@%
%@CR:MSE62407@%%@4@%By default, the %@AI@%Graphic%@AE@% function is assigned to all alphanumeric characters.%@EH@%%@NL@%
%@NL@%
%@NL@%
%@CR:MSE63000@%%@2@%%@AB@%6.3  Creating Macros within the Editor%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE63001@%%@4@%The fastest way to create a new editing function for the Microsoft Editor is%@EH@%
to create a macro. This editing function can be as simple as inserting a
long word or phrase, or it can involve complex operations.%@NL@%
%@NL@%
%@CR:MSE63002@%%@4@%There are two ways to create a macro. The easiest is to use the %@AI@%Record%@AE@%%@EH@%
function to automatically record a series of actions. You can also enter a
macro directly. The second method requires more knowledge of syntax, but
allows you to use sophisticated features, such as conditionals.%@NL@%
%@NL@%
%@CR:MSE63003@%%@4@%After you have used the editor for awhile, you may want to use both methods.%@EH@%
You can create a simple function by recording a macro, then increase the
macro's power by editing it directly, using the techniques described in
Sections 6.3.2%@BO:   2def3@%-6.3.8.%@NL@%
%@NL@%
%@CR:MSE63004@%%@4@%Once a macro is defined and assigned to a keystroke, you can see how the%@EH@%
macro is defined by using the %@AI@%Tell%@AE@% function. Give the %@AI@%Arg%@AE@%%@AI@%textarg Tell%@AE@%
command (ALT+A %@AI@%textarg%@AE@% CTRL+T), in which %@AI@%textarg%@AE@% is the name of the macro.
For more information on the %@AI@%Tell%@AE@% function, see Appendix A%@BO:   5d119@%, "Reference
Tables."%@NL@%
%@NL@%
%@CR:MSE63005@%%@4@%The maximum number of macros that can be defined at one time is 1,024.%@EH@%%@NL@%
%@NL@%
%@NL@%
%@CR:MSE63100@%%@3@%%@AB@%6.3.1  Recording a Macro%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE63101@%%@4@%Much like a tape recorder, the %@AI@%Record%@AE@% (ALT+R) function tells the editor,%@EH@%
"make a record of all editing commands until I tell you to stop." After you
stop the recording, the editor creates a macro function consisting of all
the editing commands you just gave. When you invoke this macro, the editor
plays back these commands in the order you gave them.%@NL@%
%@NL@%
%@CR:MSE63102@%%@4@%While the editor is recording commands, the letters %@AS@%REC%@AE@% appear at the end of%@EH@%
the status line.%@NL@%
%@NL@%
%@CR:MSE63103@%%@4@%The %@AI@%Record%@AE@% function starts a recording and gives the macro the default name %@EH@%
%@AB@%recordvalue%@AE@% when the recording is done. Invoking %@AI@%Record%@AE@% again turns the
recording off.%@NL@%
%@NL@%
%@CR:MSE63104@%%@4@%The following steps are the quickest way to create a macro:%@EH@%%@NL@%
%@NL@%
%@CR:MSE63105@%  1. Invoke the %@AI@%Record%@AE@% function (ALT+R) to start the recording.%@NL@%
%@NL@%
  2. Execute the series of actions you wish to record.%@NL@%
%@NL@%
  3. Turn off the recording by invoking %@AI@%Record%@AE@% (ALT+R) again.%@NL@%
%@NL@%
  4. If %@AB@%recordvalue%@AE@% is not already assigned, assign it to a keystroke as%@NL@%
     described in Section 6.2%@BO:   29ab0@%, "Assigning Functions to Keystrokes."%@NL@%
%@NL@%
%@CR:MSE63106@%%@4@%After you complete these steps, the editor associates the new macro with the%@EH@%
keystroke that %@AB@%recordvalue%@AE@% is assigned to. Whenever you press this key, the
editor plays back the editing commands you gave in Step 2 above.%@NL@%
%@NL@%
%@CR:MSE63107@%%@4@%Other variations of the %@AI@%Record%@AE@% function are shown below:%@EH@%%@NL@%
%@NL@%
%@CR:MSE63108@%%@AB@%Command     %@AE@%%@NL@%
%@AB@%(and Default Keystrokes)    Description%@AE@%%@NL@%
%@NL@%
%@AI@%Arg textarg Record%@AE@%          Turns on a recording. When the recording is%@NL@%
(ALT+A %@AI@%textarg%@AE@% ALT+R)       finished, the macro is given the name specified%@NL@%
                            in the text argument.%@NL@%
%@NL@%
%@AI@%Meta Record%@AE@% (F9 ALT+R)      Turns on a recording in which commands you give%@NL@%
                            are recorded but not executed. This is in effect%@NL@%
                            a silent recording.%@NL@%
%@NL@%
%@AI@%Arg Arg textarg Record%@AE@%      Turns on a recording, but if the specified macro%@NL@%
(ALT+A ALT+A %@AI@%textarg%@AE@%        already exists, the editor appends editing%@NL@%
ALT+R)                      commands to the macro instead of replacing it.%@NL@%
%@NL@%
%@CR:MSE63109@%%@4@%By using the window and file commands described in Chapter 4%@BO:   120e2@%, you can open%@EH@%
a second window and load the <record> pseudo file. This file dynamically
displays the value of the current recording.%@NL@%
%@NL@%
%@CR:MSE6310A@%%@4@%By opening the <record> pseudo file in a separate window, you can watch the%@EH@%
editor record the macro as you create it. The macro writes out the actual
name of each editing command you give. As a result, the editor displays a
macro definition using the syntax described in the next section.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE63200@%%@3@%%@AB@%6.3.2  Entering a Macro Directly%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE63201@%%@4@%A macro is nothing more than a predefined series of functions and/or literal%@EH@%
text. This fact makes the syntax of most macros almost self-evident: you
build a macro by using the same syntax used throughout this manual. The most
advanced macros, however, use the return value of functions to alter control
flow. This special feature is presented in Section 6.3.8%@BO:   320fc@%, "Macros That Use
Conditionals."%@NL@%
%@NL@%
%@CR:MSE63202@%%@4@%To define a macro directly, follow these steps:%@EH@%%@NL@%
%@NL@%
%@CR:MSE63203@%  1. Choose a name. The name should not be a macro or function name already%@NL@%
     in use.%@NL@%
%@NL@%
  2. Enter the macro definition by using the %@AI@%Arg textarg Assign%@AE@% command%@NL@%
     (ALT+A %@AI@%textarg%@AE@% ALT+=), in which %@AI@%textarg%@AE@% has the following syntax:%@NL@%
%@NL@%
     %@AI@%macroname%@AE@%%@AB@%:=%@AE@%%@AI@%list%@AE@%%@NL@%
%@NL@%
     No spaces should separate %@AI@%macroname%@AE@% from the definition symbol (%@AB@%:=%@AE@%).%@NL@%
     The %@AI@%list%@AE@% contains function names and text strings enclosed in double%@NL@%
     quotes, as explained in the next section.%@NL@%
%@NL@%
  3. Assign the macro with the command %@AI@%Arg textarg Assign%@AE@%, in which the%@NL@%
     %@AI@%textarg%@AE@% has the following form:%@NL@%
%@NL@%
     %@AI@%macroname%@AE@%%@AB@%:%@AE@%%@AI@%keystroke%@AE@%%@NL@%
%@NL@%
%@CR:MSE63204@%%@4@%The last step is optional. If you want to build a nested macro as described%@EH@%
in Section 6.3.5%@BO:   302f6@%, only the last macro defined needs to be assigned to a
keystroke.%@NL@%
%@NL@%
%@CR:MSE63205@%%@4@%Instead of assigning a macro to a keystroke, you can execute the macro by%@EH@%
giving its name as input to the %@AI@%Execute%@AE@% function, as explained in Section
6.3.4%@BO:   2ff89@%.%@NL@%
%@NL@%
%@CR:MSE63206@%%@4@%%@AB@%Example%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE63207@%%@4@%The following sequence of actions defines a macro called %@AS@%InsPhrase%@AE@%, which%@EH@%
inserts a certain sentence. The simplest macros insert a fixed string of
text──these macros are useful because they can save you a lot of typing.
This macro is then assigned to the key CTRL+F10. After you do the following
action, the editor inserts the words "This is a sentence." at the current
cursor position, every time you press CTRL+F10.%@NL@%
%@NL@%
%@CR:MSE63208@%  1. Invoke the %@AI@%Arg%@AE@% function (press ALT+A)%@NL@%
%@NL@%
  2. Enter the macro name and definition by typing the following:%@NL@%
%@NL@%
        %@AS@%InsPhrase:="This is a sentence."%@AE@%%@NL@%
%@NL@%
  3. Invoke the %@AI@%Assign%@AE@% function (press ALT+=)%@NL@%
%@NL@%
  4. Invoke the %@AI@%Arg%@AE@% function (press ALT+A)%@NL@%
%@NL@%
  5. Assign this macro to a keystroke by typing the following:%@NL@%
%@NL@%
        %@AS@%InsPhrase:CTRL+F10%@AE@%%@NL@%
%@NL@%
  6. Invoke the %@AI@%Assign%@AE@% function (press ALT+=)%@NL@%
%@NL@%
%@NL@%
%@CR:MSE63300@%%@3@%%@AB@%6.3.3  Building the Macro List%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE63301@%%@4@%Each item in a macro-definition list is either a function name or a string%@EH@%
of text. The function names are the same as used throughout this manual but
are not case sensitive. You can enter them all lowercase, all uppercase, or
any combination.%@NL@%
%@NL@%
%@CR:MSE63302@%%@4@%Each string of text must be enclosed in quotes. Embedded quote marks are%@EH@%
represented as \", and embedded backslashes are represented as \\.%@NL@%
%@NL@%
%@CR:MSE63303@%%@4@%%@AB@%Example%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE63304@%%@4@%The following text arguments are all valid macro definitions:%@EH@%%@NL@%
%@NL@%
     Callfun:="x = QuadCalc(a, b, c);"%@NL@%
     Callfun2:=linsert begline "x = QuadCalc(a, b, c);"%@NL@%
     Movedown:=arg "15" plines%@NL@%
     Putcomm:=begline "/*  " endline " */"%@NL@%
     Join:=endline right arg sdelete%@NL@%
     Del3:=arg right right right ldelete%@NL@%
     Join2:=savecur endline right arg sdelete restcur%@NL@%
     endword:=arg arg "( !.!$!\\:!;!\\)!\\(!,)" psearch%@NL@%
%@NL@%
%@CR:MSE63305@%%@4@%The rest of this section examines each of these macro definitions.%@EH@%%@NL@%
%@NL@%
     Callfun:="x = QuadCalc(a, b, c);"%@NL@%
%@NL@%
%@CR:MSE63306@%%@4@%The example above defines a macro that inserts the text "x = QuadCalc(a, b,%@EH@%
c);" whenever invoked. This macro is simple, yet useful. It replaces the
typing of a phrase with a single editing function.%@NL@%
%@NL@%
%@CR:MSE63307@%%@4@%Executing this macro has the same effect as typing the phrase. The precise%@EH@%
effect of this macro therefore depends on whether insert mode is on or off.%@NL@%
%@NL@%
     Callfun2:=linsert begline "x = QuadCalc(a, b, c);"%@NL@%
%@NL@%
%@CR:MSE63308@%%@4@%The example above uses both function names and text to define a new editing%@EH@%
function. The effect of invoking this macro is precisely the same as the
effect of invoking %@AI@%Linsert%@AE@%, invoking %@AI@%Begline%@AE@%, and then typing the text
inside the quotes. The macro inserts a new line and places the text at the
beginning of this line.%@NL@%
%@NL@%
     Movedown:=arg "15" plines%@NL@%
%@NL@%
%@CR:MSE63309@%%@4@%Like the example before it, the example above uses a combination of%@EH@%
functions and a string of text. However, because the %@AI@%Arg%@AE@% function precedes
the text, the text does not appear on screen. Instead, the text becomes an
argument to the %@AI@%Plines%@AE@% function. This macro moves the window down 15 lines.%@NL@%
%@NL@%
     Putcomm:=begline "/*  " endline " */"%@NL@%
%@NL@%
%@CR:MSE6330A@%%@4@%The example above uses a combination of functions and text to insert%@EH@%
C-language comment marks at the beginning and end of a line.%@NL@%
%@NL@%
     Join:=endline right arg sdelete%@NL@%
%@NL@%
%@CR:MSE6330B@%%@4@%The example above defines a macro that joins the current line to the next%@EH@%
line. Recall that the sequence %@AI@%Arg Sdelete%@AE@% deletes all text to the right of
the cursor, then joins lines.  This macro does not delete any text. First,
it moves the cursor to the end of the line. Next, it moves one space to the
right to leave a space before the next line. It then executes %@AI@%Arg Sdelete%@AE@%.%@NL@%
%@NL@%
%@CR:MSE6330C@%%@4@%You can use the cursor-movement functions (%@AI@%Up%@AE@%, %@AI@%Down%@AE@%, %@AI@%Right%@AE@%, %@AI@%Left%@AE@%) within%@EH@%
macros.  The next macro uses these functions to build an on-screen argument.%@NL@%
%@NL@%
     Del3:=arg right right right ldelete%@NL@%
%@NL@%
%@CR:MSE6330D@%%@4@%The example above deletes three characters. The middle three arguments%@EH@%
create a cursor-movement argument that is passed to the %@AI@%Ldelete%@AE@% function.%@NL@%
%@NL@%
     Join2:=savecur endline right arg sdelete restcur%@NL@%
%@NL@%
%@CR:MSE6330E@%%@4@%The example above performs almost the same activity as the %@AS@%Join%@AE@% macro%@EH@%
presented earlier. However, this macro begins by saving the cursor position
with %@AI@%Savecur%@AE@%. After the lines are joined, the macro restores the original
cursor position by executing %@AI@%Restcur%@AE@%. This macro works even if %@AI@%Savecur%@AE@% and
%@AI@%Restcur%@AE@% have not been assigned to keystrokes.%@NL@%
%@NL@%
     endword:=arg arg "( !.!$!\\:!;!\\)!\\(!,)" psearch%@NL@%
%@NL@%
%@CR:MSE6330F@%%@4@%This last example uses the regular-expression syntax described in Chapter%@EH@%
5%@BO:   206bc@%. The %@AI@%Arg Arg%@AE@% syntax directs the %@AI@%Psearch%@AE@% function to treat the text
argument as a regular-expression pattern. This pattern, in turn, causes the
editor to find the next space, period (.), end of line ($), colon (:),
semicolon (;), right parenthesis ()), left parenthesis ((), or comma (,).
Some characters must be preceded by a backslash (\) in order to be
interpreted literally. Furthermore, when you give a text argument inside a
macro list, you must use two backslashes in a row (\\) to indicate a single
backslash.%@NL@%
%@NL@%
%@CR:MSE6330G@%%@4@%The effect of this macro is to go to the end of the current word. By%@EH@%
rewriting the regular expression, you control what constitutes the end of a
word. This macro can be especially useful when nested inside other macros,
as described in Section 6.3.5.%@BO:   302f6@%%@NL@%
%@NL@%
%@NL@%
%@CR:MSE63400@%%@3@%%@AB@%6.3.4  Executing a Macro List Directly%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE63401@%%@4@%Instead of defining a macro and then assigning it to a keystroke, you can%@EH@%
execute a macro-definition list directly, by using the %@AI@%Execute%@AE@% function.
This function, which by default is assigned to F7, takes a function name,
macro name, or macro-definition command list as a text argument.%@NL@%
%@NL@%
%@CR:MSE63402@%%@4@%For example, the following sequence finds the next occurrence of the word%@EH@%
%@AS@%fluke%@AE@%:%@NL@%
%@NL@%
%@CR:MSE63403@%  1. Invoke %@AI@%Arg%@AE@% (press ALT+A)%@NL@%
  2. Type the following string: %@AS@%arg "fluke" psearch%@AE@%%@NL@%
  3. Invoke %@AI@%Execute%@AE@% (press F7)%@NL@%
%@NL@%
%@CR:MSE63404@%%@4@%You can also give the name of a macro as input to the %@AI@%Execute%@AE@% command.%@EH@%%@NL@%
%@NL@%
%@NL@%
%@CR:MSE63500@%%@3@%%@AB@%6.3.5  Building Macros from Other Macros%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE63501@%%@4@%Macros can contain references to previously defined macros.  Since a macro%@EH@%
definition must be contained on one line (except in the TOOLS.INI file,
where you can use a line-continuation character), you may need to break up a
macro definition into several smaller macros as shown in the example below.
Only the final macro definition need be assigned to a keystroke. Each of the
following lines is entered one at a time using the %@AI@%Arg textarg Assign%@AE@%
command:%@NL@%
%@NL@%
     head1:=arg "3" linsert "/************************"%@NL@%
     head2:=newline "** Routine:"%@NL@%
     head3:=newline "*************************/"%@NL@%
     header:=head1 head2 head3%@NL@%
     header:alt+h%@NL@%
%@NL@%
%@CR:MSE63502@%%@4@%The example above inserts three blank lines (by passing the argument 3 to%@EH@%
the %@AI@%Linsert%@AE@% function), and then inserts the given strings of text. The macro
is then assigned to ALT+H. This macro is an example of one that automates
the creation of comment blocks for C programs.%@NL@%
%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@AI@%NOTE%@AE@%%@NL@%
   Nested macros are cumbersome to enter while running the editor. Usually,%@NL@%
   you'll want to enter them once in your TOOLS.INI file so that they are%@NL@%
   available automatically, as explained in Chapter 7%@BO:   3396c@%.%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@NL@%
%@CR:MSE63600@%%@3@%%@AB@%6.3.6  Handling Prompts within Macros%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE63601@%%@4@%Some commands prompt the user for confirmation. For example, the %@AI@%Meta%@AE@%%@AI@%Exit%@AE@%%@EH@%
command (exit without saving) asks the user if he really wants to exit.
These questions take the answer yes (Y) or no (N).%@NL@%
%@NL@%
%@CR:MSE63602@%%@4@%By default, macros assume an answer of yes. For example, if you assigned%@EH@%
%@AI@%Meta Exit%@AE@% to a macro and then executed the macro, the editor would not
prompt for confirmation. Instead, the editor would assume an answer of yes
and proceed to exit without saving.%@NL@%
%@NL@%
%@CR:MSE63603@%%@4@%You can control the answers to prompts within macros by using the following%@EH@%
operators, each of which applies to the immediately preceding function:%@NL@%
%@NL@%
%@CR:MSE63604@%%@AB@%Operator                    Description%@AE@%%@NL@%
%@NL@%
%@AB@%<%@AE@%                           Asks the user for confirmation. (If not followed%@NL@%
                            by another %@AB@%<%@AE@% character, prompts user for all%@NL@%
                            further questions.)%@NL@%
%@NL@%
%@AB@%<Y%@AE@%                          Assumes an answer of yes.%@NL@%
%@NL@%
%@AB@%<N%@AE@%                          Assumes an answer of no.%@NL@%
%@NL@%
%@CR:MSE63605@%%@4@%You can use a series of operators. For example, consider the following%@EH@%
macro:%@NL@%
%@NL@%
     newfile:=arg "newfile.txt" setfile <y <n%@NL@%
%@NL@%
%@CR:MSE63606@%%@4@%The macro %@AS@%newfile%@AE@% assumes an answer of yes for the first prompt, and no for%@EH@%
the second. If %@AS@%newfile%@AE@% requires only one prompt, it ignores the second
operator, %@AS@%<n%@AE@%.%@NL@%
%@NL@%
%@CR:MSE63607@%%@4@%If the last prompt character that appears is %@AS@%<%@AE@%, the editor prompts the user%@EH@%
directly for all remaining yes/no questions.%@NL@%
%@NL@%
%@CR:MSE63608@%%@4@%You can use the prompt characters throughout your macro. For example:%@EH@%%@NL@%
%@NL@%
     newfile:=refresh < arg "newfile.txt" setfile <y <n <%@NL@%
%@NL@%
%@NL@%
%@CR:MSE63700@%%@3@%%@AB@%6.3.7  Macros That Take Arguments%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE63701@%%@4@%Macros have no explicit syntax for accepting user-defined arguments.%@EH@%
However, if you enter an argument and then invoke a macro, the argument is
passed to the first function that accepts an argument:%@NL@%
%@NL@%
     tripleit:=copy paste paste%@NL@%
%@NL@%
%@CR:MSE63702@%%@4@%In the example above, you can invoke %@AI@%Arg%@AE@% and use cursor movement to%@EH@%
highlight an argument. Then invoke %@AS@%tripleit%@AE@%. Your highlighted argument is
passed to the %@AI@%Copy%@AE@% function, which copies the argument to the Clipboard. The
macro then executes the %@AI@%Paste%@AE@% function two times. As a result, two
additional copies of the argument are added to the file.%@NL@%
%@NL@%
%@CR:MSE63703@%%@4@%If you do not highlight an argument before invoking %@AS@%tripleit%@AE@%, the macro%@EH@%
responds by printing two more copies of the current line. By default,
%@AS@%tripleit%@AE@% works on the current line because %@AI@%Copy%@AE@% selects the current line
when no argument is given.%@NL@%
%@NL@%
%@CR:MSE63704@%%@4@%When you execute the %@AI@%Copy%@AE@% or %@AI@%Delete%@AE@% function at the beginning of a macro,%@EH@%
the highlighted argument is stored in the Clipboard. You can then load the
<clipboard> pseudo file and manipulate the argument itself, as in the
following macro:%@NL@%
%@NL@%
     addto1:=copy arg "<clipboard>" setfile%@NL@%
     addto2:=arg arg "TMP.TXT" setfile%@NL@%
     addto3:=arg "type TMP.TXT >>> BIG.TXT" shell%@NL@%
     addto4:=arg "del TMP.TXT" shell setfile%@NL@%
     addto:=addto1 addto2 addto3 addto4%@NL@%
%@NL@%
%@CR:MSE63705@%%@4@%The %@AS@%addto%@AE@% macro appends the highlighted argument to the file BIG.TXT. If you%@EH@%
do not give an argument, the macro appends the current line. The %@AS@%addto%@AE@% macro
works by executing %@AS@%addto1%@AE@%, %@AS@%addto2%@AE@%, %@AS@%addto3%@AE@%, and %@AS@%addto4%@AE@%, each of which does
some of the work of adding to the highlighted area. The following list
describes the steps of the %@AS@%addto%@AE@% macro:%@NL@%
%@NL@%
%@CR:MSE63706@%  1. Copy argument to the Clipboard, then load the <clipboard> pseudo file.%@NL@%
%@NL@%
  2. Save the contents of the current file (which is now <clipboard>) to the%@NL@%
     file TMP.TXT.%@NL@%
%@NL@%
  3. Execute a DOS shell that appends TMP.TXT to BIG.TXT.%@NL@%
%@NL@%
  4. Execute a DOS shell that deletes TMP.TXT, then use %@AI@%Setfile%@AE@% to return to%@NL@%
     the original file.%@NL@%
%@NL@%
%@CR:MSE63707@%%@4@%Another way to respond to an argument is to put the %@AI@%Replace%@AE@% function at the%@EH@%
beginning of your macro. Replacements then take place throughout the
highlighted area. For example, the following macro replaces each occurrence
of the period (.) with a blank space:%@NL@%
%@NL@%
     blankout:=replace "." newline " " newline%@NL@%
%@NL@%
%@CR:MSE63708@%%@4@%The %@AI@%Newline%@AE@% function is necessary because the %@AI@%Replace%@AE@% function prompts for%@EH@%
search-and-replace strings.%@NL@%
%@NL@%
%@CR:MSE63709@%%@4@%To use the macro above in a practical way, invoke %@AI@%Arg%@AE@% twice to enable%@EH@%
regular expressions, highlight an area of text, and then execute %@AS@%blankout%@AE@%.
Assuming that the editor is using Unix regular-expression syntax, the effect
is that each character in the highlighted area is replaced by a blank space.
The effect is different from %@AI@%Delete%@AE@% because the space occupied by the text
is not removed, simply replaced with blanks.%@NL@%
%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@AI@%WARNING%@AE@%%@NL@%
   Using %@AI@%Arg%@AE@% twice and then executing %@AS@%blankout%@AE@% without a highlighted region%@NL@%
   replaces the rest of your file with blank spaces. Make sure you use a%@NL@%
   highlighted argument.%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@NL@%
%@CR:MSE63800@%%@3@%%@AB@%6.3.8  Macros That Use Conditionals%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE63801@%%@4@%You can write macros that execute different actions depending on certain%@EH@%
conditions. These macros take advantage of function return values. A "return
value" is simply a piece of information that a function passes back after it
is executed. Editing functions always return the value TRUE (nonzero) or
FALSE (zero).%@NL@%
%@NL@%
%@CR:MSE63802@%%@4@%Each editing function has different criteria for determining what to return,%@EH@%
but usually an editing function returns TRUE if the function is successful,
or FALSE if it fails. For example, a cursor-movement function fails if the
cursor does not move.%@NL@%
%@NL@%
%@CR:MSE63803@%%@4@%Table A.4%@BO:   701fe@%, in Appendix A, gives a complete list of function return values.%@EH@%
You use these return values with the syntax described in Table 6.1%@BO:   324a9@%.%@NL@%
%@NL@%
%@CR:MSE6T100@%%@4@%%@AU@%Table 6.1  Macro Conditionals%@AE@%%@EH@%%@NL@%
%@TH:   15    844  1 18 68 @%
%@AB@%Conditional       Description%@AE@%

%@AB@%:>%@AE@%%@AI@%label%@AE@%           Defines a label that can be referenced by other macro
                  conditionals.

%@AB@%=>%@AE@%%@AI@%label%@AE@%           Causes a direct transfer to %@AI@%label%@AE@%. If %@AI@%label%@AE@% is omitted,
                  then the current macro exits.

%@AB@%->%@AE@%%@AI@%label%@AE@%           Causes a direct transfer to %@AI@%label%@AE@% if the previous function
                  returns FALSE. If %@AI@%label%@AE@% is omitted, then the current macro
                  exits on FALSE.

%@AB@%+>%@AE@%%@AI@%label%@AE@%           Causes a direct transfer to %@AI@%label%@AE@% if the previous function
                  returns TRUE. If %@AI@%label%@AE@% is omitted, then the current macro
                  exits on TRUE.
%@TE:   15    844  1 18 68 @%
%@NL@%
%@CR:MSE63804@%%@4@%The table above refers to a macro exiting. In this context, exiting a macro%@EH@%
only affects the current macro. If macro %@AS@%doall%@AE@% executes macro %@AS@%submacro%@AE@%, when
%@AS@%submacro%@AE@% exits, control returns to %@AS@%doall%@AE@%, which continues execution.%@NL@%
%@NL@%
%@CR:MSE63805@%%@4@%%@AB@%Examples%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE63806@%%@4@%The first example turns insert mode on. The only function that turns insert%@EH@%
mode on or off is the %@AI@%Insertmode%@AE@% function. This function toggles between the
on and off condition, and returns the new state of insert mode:%@NL@%
%@NL@%
%@AB@%Initial state               Effect of Insertmode%@AE@%%@NL@%
%@NL@%
Off                         Turn insert mode on; return TRUE.%@NL@%
%@NL@%
On                          Turn insert mode off; return FALSE.%@NL@%
%@NL@%
%@CR:MSE63808@%%@4@%Unfortunately, testing the state of insert mode may turn insert mode off,%@EH@%
even though the goal is to leave it on. Fortunately, a conditional macro can
turn insert mode back on again as appropriate:%@NL@%
%@NL@%
     turnon:=insertmode +> insertmode%@NL@%
%@NL@%
%@CR:MSE63809@%%@4@%This macro consists of three simple steps:%@EH@%%@NL@%
%@NL@%
%@CR:MSE6380A@%  1. %@AS@%insertmode%@AE@% toggles the state of insert mode. This function returns TRUE%@NL@%
     if insert mode is now on.%@NL@%
%@NL@%
  2. The %@AS@%+>%@AE@% operator exits the macro if the last function executed returned%@NL@%
     TRUE. In this case, a return value of TRUE indicates that insert mode%@NL@%
     is now on, so the macro exits on TRUE.%@NL@%
%@NL@%
  3. If the last function returned FALSE, the macro continues to the last%@NL@%
     step, which executes %@AS@%insertmode%@AE@% again. If the macro reaches this step,%@NL@%
     insert mode was initially on but the first step turned it off. This%@NL@%
     step turns insert mode back on again.%@NL@%
%@NL@%
%@CR:MSE6380B@%%@4@%The macro defined above, %@AS@%turnon%@AE@%, is highly useful when used within nested%@EH@%
macros. Define %@AS@%turnon%@AE@% first. Then place %@AS@%turnon%@AE@% at the beginning of a macro
definition whenever the macro needs to assume that insert mode is on.%@NL@%
%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@AI@%NOTE%@AE@%%@NL@%
   In the next chapter, you'll learn how to use the %@AI@%enterinsmode%@AE@% switch to%@NL@%
   achieve the same result as the macro defined above.%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@CR:MSE6380C@%%@4@%The next example turns insert mode on temporarily, executes the predefined%@EH@%
macro %@AS@%cmd%@AE@%, and then leaves the editor in the same state that it was in
before the macro was executed.%@NL@%
%@NL@%
     icmd:=insertmode +>on insertmode cmd => :>on cmd insertmode%@NL@%
%@NL@%
%@CR:MSE6380D@%%@4@%The macro executes the commands in the following order:%@EH@%%@NL@%
%@NL@%
%@CR:MSE6380E@%  1. %@AS@%insertmode%@AE@% toggles the state of insert mode, so if insert mode was off,%@NL@%
     it is now on, and vice versa. This function returns TRUE if insert mode%@NL@%
     is on after the function is executed, and FALSE otherwise.%@NL@%
%@NL@%
  2. %@AS@%+>on%@AE@% transfers control to the label %@AS@%on%@AE@% if the previous function%@NL@%
     returned TRUE──in other words, if insert mode is now on.%@NL@%
%@NL@%
  3. %@AS@%insertmode%@AE@% turns insert on. If the macro reaches this point, insert%@NL@%
     mode was originally on but the first step turned it off and returned%@NL@%
     FALSE. This step turns insert mode back on.%@NL@%
%@NL@%
  4. %@AS@%cmd%@AE@% executes the predefined macro.%@NL@%
%@NL@%
  5. %@AS@%=>%@AE@% exits the macro. Insert mode was on when the macro started, it is%@NL@%
     now back on, and %@AS@%cmd%@AE@% has been executed. Therefore the macro is done.%@NL@%
%@NL@%
  6. %@AS@%:>on%@AE@% defines a label. Execution transfers here directly from the item%@NL@%
     %@AS@%+>on%@AE@% if insert mode was turned on.%@NL@%
%@NL@%
  7. %@AS@%cmd%@AE@% executes the predefined macro.%@NL@%
%@NL@%
  8. %@AS@%insertmode%@AE@% turns insert mode back off. Since execution flowed through%@NL@%
     to this point, insert mode must have been off when the macro%@NL@%
     began──insert mode is turned back off now.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE70000@%%@1@%%@AB@%Chapter 7  Switches, Assignments, and the TOOLS.INI File%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@CR:MSE70001@%%@4@%A "switch" is a variable that controls some condition of the editor. For%@EH@%
example, changing the %@AB@%fgcolor%@AE@% switch alters the foreground color of the
editor, and changing the %@AB@%height%@AE@% switch alters the number of lines on the
screen. Although switches come in three varieties (numeric, text, and
Boolean), all three kinds of switches can be controlled with the %@AI@%Assign%@AE@%
function.%@NL@%
%@NL@%
%@CR:MSE70002@%%@4@%Usually, the most convenient way to work with switches is to set them in the%@EH@%
initialization file, named TOOLS.INI. This file contains switch values,
function assignments, and macros for the Microsoft Editor to automatically
assume at the beginning of each session. This file can be used to initialize
settings for other products. Therefore, all the settings for the editor have
to be put under a special heading called a "tag."%@NL@%
%@NL@%
%@CR:MSE70003@%%@4@%If you are interested in using TOOLS.INI right away to make the editor%@EH@%
automatically start up with your own function assignments and macros, turn
to Section 7.4%@BO:   3b535@%, "Sample TOOLS.INI File."%@NL@%
%@NL@%
%@CR:MSE70004@%%@4@%This chapter covers the following topics:%@EH@%%@NL@%
%@NL@%
%@CR:MSE70005@%  ■  Syntax for switch settings%@NL@%
  ■  Using switches to configure the editor%@NL@%
  ■  Special syntax for text switches%@NL@%
  ■  Sample TOOLS.INI file%@NL@%
  ■  The structure of the TOOLS.INI file%@NL@%
  ■  Configuring on-line Help%@NL@%
%@NL@%
%@NL@%
%@CR:MSE71000@%%@2@%%@AB@%7.1  Syntax for Switch Settings%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE71001@%%@4@%To change the behavior of the editor, set a switch with the %@AI@%Assign%@AE@% function%@EH@%
or in the TOOLS.INI file. You set a switch differently depending on the type
of the switch. Each switch is one of three types: numeric, text, or Boolean.%@NL@%
%@NL@%
%@CR:MSE71002@%%@4@%To set a numeric or text switch, give the assignment%@EH@%%@NL@%
%@NL@%
     %@AI@%switch%@AE@%%@AB@%:%@AE@%%@AI@%value%@AE@%%@NL@%
%@NL@%
%@CR:MSE71004@%%@4@%in which %@AI@%switch%@AE@% is the name of the switch and %@AI@%value%@AE@% is either a string of%@EH@%
digits (in the case of a numeric switch), or any string of text (in the case
of a text switch). Most numeric switches use decimal digits. However, the
color switches use hexadecimal digits, as described in Section 7.2.3%@BO:   35a6f@%.%@NL@%
%@NL@%
%@CR:MSE71005@%%@4@%Boolean switches can be off or on. To turn a Boolean switch on, give either%@EH@%
of the following assignments:%@NL@%
%@NL@%
     %@AI@%switch%@AE@%%@AB@%:%@AE@%%@NL@%
     %@AI@%switch%@AE@%%@AB@%:yes%@AE@%%@NL@%
%@NL@%
%@CR:MSE71007@%%@4@%To turn a Boolean switch off, prefix the letters %@AB@%no%@AE@% to the assignment or%@EH@%
type %@AB@%no%@AE@% after the colon:%@NL@%
%@NL@%
     %@AB@%no%@AE@%%@AI@%switch%@AE@%%@AB@%:%@AE@%%@NL@%
     %@AI@%switch%@AE@%%@AB@%:no%@AE@%%@NL@%
%@NL@%
%@CR:MSE71009@%%@4@%A switch assignment looks similar to a function assignment.  However, a%@EH@%
switch assignment has a different effect. A function assignment changes the
meaning of a keystroke, whereas a switch assignment alters a basic
condition, such as screen color.%@NL@%
%@NL@%
%@CR:MSE7100A@%%@4@%%@AB@%Examples%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE7100B@%%@4@%The following examples show a numeric, text, and four Boolean assignments,%@EH@%
respectively:%@NL@%
%@NL@%
     tabstops:8%@NL@%
     backup:none%@NL@%
     case:%@NL@%
     nocase:%@NL@%
     case:yes%@NL@%
     case:no%@NL@%
%@NL@%
%@CR:MSE7100C@%%@4@%You could make any of these assignments by placing them in the TOOLS.INI%@EH@%
file, or by using the %@AI@%Arg textarg Assign%@AE@% command. For example, to set
%@AB@%tabstops%@AE@% to 8, follow these steps:%@NL@%
%@NL@%
%@CR:MSE7100D@%  1. Invoke the %@AI@%Arg%@AE@% function (press ALT+A)%@NL@%
  2. Type the following switch assignment: %@AS@%tabstops:8%@AE@%%@NL@%
  3. Invoke the %@AI@%Assign%@AE@% function (press ALT+= )%@NL@%
%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@AI@%NOTE%@AE@%%@NL@%
   Some text switches recognize special characters. These characters are%@NL@%
   never required, but can be convenient. See Section 7.3%@BO:   3a7a5@%, "Special Syntax%@NL@%
   for Text Switches," for more information.%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@NL@%
%@CR:MSE72000@%%@2@%%@AB@%7.2  Using Switches to Configure the Editor%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE72001@%%@4@%This section explains how to use some of the more common switches. You can%@EH@%
follow the instructions to get a feel for how to adjust conditions within
the editor. For example, you may want to change screen colors, screen
height, or tab behavior. Sections 7.4%@BO:   3b535@% and 7.5%@BO:   3c086@% explain how to make these
settings automatic by placing them in the TOOLS.INI file.%@NL@%
%@NL@%
%@CR:MSE72002@%%@4@%Sections 7.2.1%@BO:   34f56@%-7.2.8 cover the following topics:%@EH@%%@NL@%
%@NL@%
%@CR:MSE72003@%  ■  Changing start-up conditions%@NL@%
  ■  Changing scrolling behavior%@NL@%
  ■  Setting screen colors with %@AB@%fgcolor%@AE@%%@NL@%
  ■  Setting colors for other parts of the screen%@NL@%
  ■  Changing the look and feel of Help%@NL@%
  ■  Controlling use of tabs%@NL@%
  ■  Changing how the editor handles trailing spaces%@NL@%
  ■  Changing screen height%@NL@%
%@NL@%
%@NL@%
%@CR:MSE72100@%%@3@%%@AB@%7.2.1  Changing Start-Up Conditions%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE72101@%%@4@%By default, the editor starts with insert mode off and status line%@EH@%
displaying window position (rather than cursor position). To start with
insert mode on, place the following statement in the [M] section of your
TOOLS.INI file:%@NL@%
%@NL@%
     enterinsmode:%@NL@%
%@NL@%
%@CR:MSE72102@%%@4@%You can also set this switch by executing these steps:%@EH@%%@NL@%
%@NL@%
%@CR:MSE72103@%  1. Invoke the %@AI@%Arg%@AE@% function (press ALT+A)%@NL@%
  2. Type the following switch assignment: %@AS@%enterinsmode:%@AE@%%@NL@%
  3. Invoke the %@AI@%Assign%@AE@% function (press ALT+=)%@NL@%
%@NL@%
%@CR:MSE72104@%%@4@%Setting this switch while in an editing session turns insert mode on%@EH@%
regardless of the current state of insert mode.%@NL@%
%@NL@%
%@CR:MSE72105@%%@4@%The status line at the bottom of the screen displays window position by%@EH@%
default. The window position gives the file coordinates (by line and column)
of the top left corner. To change this field so that it displays cursor
position instead, follow these steps:%@NL@%
%@NL@%
%@CR:MSE72106@%  1. Invoke the %@AI@%Arg%@AE@% function (press ALT+A)%@NL@%
  2. Type the following switch assignment: %@AS@%displaycursor:%@AE@%%@NL@%
  3. Invoke the %@AI@%Assign%@AE@% function (press ALT+=)%@NL@%
%@NL@%
%@CR:MSE72107@%%@4@%The editor numbers rows and columns beginning with the number one. Cursor%@EH@%
position is (1,1) when the cursor is at the very beginning of the file.%@NL@%
%@NL@%
%@CR:MSE72108@%%@4@%The %@AB@%enterinsmode%@AE@% and %@AB@%displaycursor%@AE@% switches are both examples of Boolean%@EH@%
switches. To turn these switches off, follow the directions above but
precede the switch with the word %@AB@%no%@AE@%.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE72200@%%@3@%%@AB@%7.2.2  Changing Scrolling Behavior%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE72201@%%@4@%Two switches control scrolling behavior in the Microsoft Editor: %@AB@%vscroll%@AE@% and%@EH@%
%@AB@%hscroll%@AE@%. Each time you attempt to move the cursor off the top or bottom of
the screen, the editor moves the editing window up or down a certain
distance. This distance is set by the value of %@AB@%vscroll%@AE@%.%@NL@%
%@NL@%
%@CR:MSE72202@%%@4@%For smooth vertical scrolling, set %@AB@%vscroll%@AE@% to 1:%@EH@%%@NL@%
%@NL@%
%@CR:MSE72203@%  1. Invoke the %@AI@%Arg%@AE@% function (press ALT+A)%@NL@%
  2. Type the following switch assignment: %@AS@%vscroll:1%@AE@%%@NL@%
  3. Invoke the %@AI@%Assign%@AE@% function (press ALT+=)%@NL@%
%@NL@%
%@CR:MSE72204@%%@4@%For smooth horizontal scrolling, set %@AB@%hscroll%@AE@% to 1. Give the %@AI@%Arg textarg%@AE@%%@EH@%
%@AI@%Assign%@AE@% command (ALT+A %@AI@%textarg%@AE@% ALT+=), in which %@AI@%textarg%@AE@% is %@AS@%hscroll:1%@AE@%.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE72300@%%@3@%%@AB@%7.2.3  Setting Screen Colors with fgcolor%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE72301@%%@4@%The %@AB@%fgcolor%@AE@% switch controls the most important screen colors: background%@EH@%
and foreground colors of editing windows. The background color is the
primary color of a region of the screen. The foreground color is the color
of characters that appear in this region.%@NL@%
%@NL@%
%@CR:MSE72302@%%@4@%The %@AB@%fgcolor%@AE@% switch uses one numeric value to control both background and%@EH@%
foreground colors. The other color switches (%@AB@%errcolor%@AE@%, %@AB@%hgcolor%@AE@%, %@AB@%infcolor%@AE@%,
and %@AB@%stacolor%@AE@%) all work in the same way: each sets a background and
foreground color according to a single numeric value.%@NL@%
%@NL@%
%@CR:MSE72303@%%@4@%The editor reads a color switch as a two-digit hexadecimal number. The first%@EH@%
digit sets the background color; the second sets the foreground color. Table
7.1%@BO:   35f29@% states the digits that correspond to each color.%@NL@%
%@NL@%
%@CR:MSE72304@%%@4@%In the case of background colors, the digits 8-F correspond to the digits%@EH@%
0-7, except that they make the foreground text blink on and off.%@NL@%
%@NL@%
%@CR:MSE7T100@%%@4@%%@AU@%Table 7.1  Colors and Numeric Values%@AE@%%@EH@%%@NL@%
%@TH:   33    504  1 24 52 @%
%@AB@%Color                   Value%@AE@%

Black                   0

Blue                    1

Green                   2

Cyan                    3

Red                     4

Magenta                 5

Brown                   6

Light Gray              7

Dark Gray               8

Light Blue              9

Light Green             A

Light Cyan              B

Light Red               C

Light Magenta           D

Light Yellow            E

White                   F
%@TE:   33    504  1 24 52 @%
%@NL@%
%@CR:MSE72305@%%@4@%Each two-digit number describes some combination of background and%@EH@%
foreground colors. The list below gives a few examples:%@NL@%
%@NL@%
%@CR:MSE72306@%%@AB@%Number                      Meaning%@AE@%%@NL@%
%@NL@%
17                          Blue (1) background, light gray (7) foreground%@NL@%
%@NL@%
07                          Black (0) background, light gray (7) foreground%@NL@%
%@NL@%
2F                          Green (2) background, white (F) foreground%@NL@%
%@NL@%
24                          Green (2) background, red (4) foreground%@NL@%
%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@AI@%NOTE%@AE@%%@NL@%
   Only color adapter cards support all the colors listed above. If you have%@NL@%
   a monochrome adapter or monochrome monitor, the only colors available are%@NL@%
   white (F), black (0), and light gray (7). All other colors are treated as%@NL@%
   white.%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@CR:MSE72307@%%@4@%%@AB@%Example%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE72308@%%@4@%At any time during the editing session, you can set new screen colors%@EH@%
(although to set these colors permanently, you should use TOOLS.INI). To set
a blue background with a light gray foreground, execute the following steps:%@NL@%
%@NL@%
%@CR:MSE72309@%  1. Invoke the %@AI@%Arg%@AE@% function (press ALT+A)%@NL@%
  2. Type the following switch assignment: %@AS@%fgcolor:17%@AE@%%@NL@%
  3. Invoke the %@AI@%Assign%@AE@% function (press ALT+=)%@NL@%
%@NL@%
%@NL@%
%@CR:MSE72400@%%@3@%%@AB@%7.2.4  Setting Colors for Other Parts of the Screen%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE72401@%%@4@%All color switches interpret digits in the same way. However, each color%@EH@%
switch controls a different region of the screen, as described in the list
below:%@NL@%
%@CR:MSE72402@%%@NL@%
%@TH:   26   1482  2 28 48 @%
%@AB@%Switch                      Description%@AE@%

%@AB@%errcolor%@AE@%                    Controls the colors used to display error
                            messages on the dialog line.

%@AB@%hgcolor%@AE@%                     Controls the colors in a region of text
                            highlighted by a search command.

%@AB@%infcolor%@AE@%                    Controls the colors used for informative text:
                            messages (other than error messages) that the
                            editor displays on the dialog line, as well as
                            strings to be replaced that are located by
                            %@AI@%Qreplace%@AE@%. The editor displays messages after
                            executing an operation, such as saving a file or
                            loading a new file. These colors provide the
                            default background for the dialog line, and also
                            control the color of "insert" and "meta" when
                            they appear on the status line.

%@AB@%selcolor%@AE@%                    Controls the color of text that the user
                            highlights as a cursor-movement argument.

%@AB@%stacolor%@AE@%                    Controls the colors of most items on the status
                            line.

%@AB@%wdcolor%@AE@%                     Controls the color used to draw window borders.
%@TE:   26   1482  2 28 48 @%
%@NL@%
%@CR:MSE72403@%%@4@%The following procedure sets a black (0) background for error messages,%@EH@%
combined with a red (4) foreground. Error messages will appear in red
letters against a black background:%@NL@%
%@NL@%
%@CR:MSE72404@%  1. Invoke the %@AI@%Arg%@AE@% function (press ALT+A)%@NL@%
  2. Type the following switch assignment: %@AS@%errcolor:04%@AE@%%@NL@%
  3. Invoke the %@AI@%Assign%@AE@% function (press ALT+=)%@NL@%
%@NL@%
%@NL@%
%@CR:MSE72500@%%@3@%%@AB@%7.2.5  Changing the Look and Feel of Help%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE72501@%%@4@%The information in this section applies only to systems configured to use%@EH@%
the powerful Microsoft Help engine. If Help is not installed when you press
SHIFT+F1, a message appears saying that you have not installed Help yet. Run
the installation program for your Microsoft language, or follow the
directions in Section 7.6%@BO:   3eb8b@%, "Configuring On-Line Help."%@NL@%
%@NL@%
%@CR:MSE72502@%%@4@%By default, Help splits the screen and displays Help information in a%@EH@%
separate window. This behavior has the advantage of letting you view both
the current file and Help information at the same time. You can move the
cursor between windows by pressing F6. You can also copy examples from the
Help window and paste them into an editing window.%@NL@%
%@NL@%
%@CR:MSE72503@%%@4@%You can change the behavior of Help so that it does not split the screen.%@EH@%
Instead, Help will save the current file (if the %@AB@%autosave%@AE@% switch is on) and
load Help information into the current editing window. This behavior has the
advantage of using more room to display Help information.%@NL@%
%@NL@%
%@CR:MSE72504@%%@4@%The split-screen behavior is controlled by the %@AB@%helpwindow%@AE@% switch. This%@EH@%
switch is a Boolean switch; it can be either on or off. Turning the switch
off prevents the editor from splitting the screen to display Help
information:%@NL@%
%@NL@%
%@CR:MSE72505@%  1. Invoke %@AI@%Arg%@AE@% (press ALT+A)%@NL@%
%@NL@%
  2. Type the following switch assignment: %@AS@%nohelpwindow:%@AE@%%@NL@%
%@NL@%
  3. Invoke the %@AI@%Assign%@AE@% function (press ALT+=)%@NL@%
%@NL@%
%@CR:MSE72506@%%@4@%Conversely, to turn the split-screen behavior back on, give the %@AI@%Arg textarg%@AE@%%@EH@%
%@AI@%Assign%@AE@% command, in which %@AI@%textarg%@AE@% is %@AS@%helpwindow:%@AE@%.%@NL@%
%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@AI@%NOTE%@AE@%%@NL@%
   When %@AI@%helpwindow%@AE@% is on, use the %@AI@%Cancel%@AE@% function (ESC) to close the Help%@NL@%
   window. When %@AI@%helpwindow%@AE@% is off, use the %@AI@%Cancel%@AE@% function (ESC) to return%@NL@%
   to the previous file.%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@CR:MSE72507@%%@4@%You can also control the colors used in the Help window. The writer of a%@EH@%
help file can designate text as foreground, bold, italicized, underlined, or
as warning text. You cannot change these designations. However, you can
easily change the choice of colors used to illustrate each kind of text:%@NL@%
%@NL@%
%@CR:MSE72508@%%@AB@%Switch                      Meaning%@AE@%%@NL@%
%@NL@%
%@AB@%fgcolor%@AE@%                     Foreground color, which controls the color of%@NL@%
                            normal text. This switch also controls the%@NL@%
                            foreground color of editing windows.%@NL@%
%@NL@%
%@AB@%helpboldcolor%@AE@%               Color of text designated as bold.%@NL@%
%@NL@%
%@AB@%helpitalcolor%@AE@%               Color of text designated as italicized.%@NL@%
%@NL@%
%@AB@%helpundcolor%@AE@%                Color of text designated as underlined.%@NL@%
%@NL@%
%@AB@%helpwarncolor%@AE@%               Color of text used for a "warning" note. Also%@NL@%
                            controls color of highlighted cross-references.%@NL@%
%@NL@%
%@CR:MSE72509@%%@4@%All of the switches above are set the same way the %@AB@%fgcolor%@AE@% switch is, as%@EH@%
explained in Section 7.2.3.%@BO:   35a6f@%%@NL@%
%@NL@%
%@NL@%
%@CR:MSE72600@%%@3@%%@AB@%7.2.6  Controlling Use of Tabs%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE72601@%%@4@%The Microsoft Editor provides two basic ways of working with tab characters:%@EH@%
you can either treat tabs as real characters, or you can have the editor
convert each tab into a series of spaces. This behavior is controlled by the
%@AB@%realtabs%@AE@% switch.%@NL@%
%@NL@%
%@CR:MSE72602@%%@4@%The %@AB@%realtabs%@AE@% switch is a Boolean switch that by default is on, causing the%@EH@%
editor to treat each tab (ASCII 9) as an independent character. Unlike other
characters, a tab may correspond to several positions on the screen. If you
place the cursor on a tab character and press RIGHT, the cursor jumps to the
next tab column. Tab columns occur at regular intervals, as determined by
the %@AB@%filetab%@AE@% switch.%@NL@%
%@NL@%
%@CR:MSE72603@%%@4@%As you add and delete characters, the editor maintains the tab-column%@EH@%
alignment of the text.%@NL@%
%@NL@%
%@CR:MSE72604@%%@4@%Whether or not %@AB@%realtabs%@AE@% is on, the %@AI@%Tab%@AE@% function is simply a movement%@EH@%
function, and it does not insert tabs into a file. To use the TAB key to
directly insert tabs, put the following assignment in your TOOLS.INI file,
or give it as input to the %@AI@%Assign%@AE@% command:%@NL@%
%@NL@%
     graphic:tab%@NL@%
%@NL@%
%@CR:MSE72605@%%@4@%This assignment makes the TAB key a graphic character. Each time you press%@EH@%
TAB, you directly place an actual tab character into the file.%@NL@%
%@NL@%
%@CR:MSE72606@%%@4@%If you turn the %@AB@%realtabs%@AE@% switch off, the Microsoft Editor translates tab%@EH@%
characters into spaces. This behavior only affects the individual lines that
you modify. If you read a file but make no changes, the tab-to-space
conversion does not alter the file on disk, even if you execute a save
operation.%@NL@%
%@NL@%
%@CR:MSE72607@%%@4@%The editor may also convert spaces to tabs, according to the setting of the%@EH@%
%@AB@%entab%@AE@% switch, described below. This behavior also only affects the
individual lines that you modify.%@NL@%
%@NL@%
%@CR:MSE72608@%%@4@%The %@AB@%tabdisp%@AE@% switch is useful for viewing the effect of writing to a disk%@EH@%
file. If you set %@AB@%tabdisp%@AE@% to a number other than 0 or 32, the editor shows
you which spaces will be compressed into a tab character at the next write
to the disk file. All such spaces are displayed as the ASCII equivalent of
the value of %@AB@%tabdisp%@AE@%.%@NL@%
%@NL@%
%@CR:MSE72609@%%@4@%If %@AB@%realtabs%@AE@% is on, each position in a tab field displays this same%@EH@%
character.%@NL@%
%@NL@%
%@CR:MSE7260A@%%@4@%For example, the following steps set %@AB@%tabdisp%@AE@% to 249:%@EH@%%@NL@%
%@NL@%
%@CR:MSE7260B@%  1. Invoke %@AI@%Arg%@AE@% (press ALT+A)%@NL@%
  2. Type the following switch assignment: %@AS@%tabdisp:249%@AE@%%@NL@%
  3. Invoke the %@AI@%Assign%@AE@% function (press ALT+=)%@NL@%
%@NL@%
%@CR:MSE7260C@%%@4@%After you carry out these steps, the editor displays the ASCII equivalent of%@EH@%
249 in place of each position in a tab field.%@NL@%
%@NL@%
%@CR:MSE7260D@%%@4@%The following list describes the meaning of the four tab-handling switches:%@EH@%%@NL@%
%@CR:MSE7260E@%%@NL@%
%@TH:   67   4383 02 28 48 @%
%@AB@%Switch                      Description%@AE@%

%@AB@%realtabs%@AE@%                    Controls whether or not tabs are treated as real
                            characters, as described above. If on, tab
                            columns are aligned according to the %@AB@%filetab%@AE@%
                            switch. If %@AB@%realtabs%@AE@% is off, every tab read is
                            treated as a series of spaces, according to the
                            %@AB@%filetab%@AE@% switch.

%@AB@%entab%@AE@%                       Controls the extent to which the editor converts
                            a series of tabs and spaces to tabs when saving
                            a file. Only the lines you modify during the
                            editing session are affected by space-to-tab
                            conversion.

                            A value of 0 means the editor does not replace
                            spaces by tabs. A value of 1 (the default) means
                            the editor can replace a series of tabs and
                            spaces by tabs when the spaces fall outside of
                            quoted strings. A value of 2 means all series of
                            tabs and spaces can be replaced by tabs.

                            The %@AB@%entab%@AE@% switch determines what kind of
                            space-to-tab replacements are possible. Whether
                            a replacement is made in any given case depends
                            on the position of the spaces, and on the
                            %@AB@%filetab%@AE@% switch, described next.

%@AB@%filetab%@AE@%                     Controls the physical (disk-file) meaning of tab
                            characters. If %@AB@%realtabs%@AE@% is on, the %@AB@%filetab%@AE@%
                            switch determines tab alignment. If%@AB@%realtabs%@AE@% is
                            off, the %@AB@%filetab%@AE@% switch determines how the
                            editor translates tab characters to spaces when
                            a line of text is modified. If %@AB@%entab%@AE@% is set to 1
                            or 2, %@AB@%filetab%@AE@% also determines how the editor
                            translates spaces to tabs when you save the file
                            to disk. (Only modified lines are affected.)

                            The value of the switch gives the number of
                            spaces associated with each tab column. For
                            example, the setting "filetab:4" assumes a tab
                            column every 4 positions on each line. Every
                            time the editor finds a tab character (ASCII 9),
                            it loads the buffer with the number of spaces
                            necessary to get to the next tab column. The
                            default value of %@AB@%filetab%@AE@% is 8.

%@AB@%tabalign%@AE@%                    If %@AB@%realtabs%@AE@% and %@AB@%tabalign%@AE@% are both set, the
                            cursor automatically moves to the first column
                            position of a tab character when it is placed
                            anywhere within a tab character. Cursor movement
                            corresponds to the actual characters in the
                            file.

                            When not set (the default), the cursor may be
                            placed anywhere in any column of a tab
                            character. If a character is typed at this
                            position, sufficient leading blanks will be
                            inserted to assure that the character actually
                            appears in this column position. Cursor movement
                            is independent of the actual characters in the
                            file.

%@AB@%tabstops%@AE@%                    Determines the size of columns associated with
                            the %@AI@%Tab%@AE@% and %@AI@%Backtab%@AE@% cursor-movement functions.
                            It has no affect on actual tab characters. The
                            default value of %@AB@%tabstops%@AE@% is 4.
%@TE:   67   4383 02 28 48 @%
%@NL@%
%@CR:MSE72700@%%@3@%%@AB@%7.2.7  Changing How the Editor Handles Trailing Spaces%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE72701@%%@4@%A "trailing space" is a space character located to the right of the last%@EH@%
printable character on a line. A trailing space is normally invisible. By
default, the editor deletes all trailing spaces on each line you modify.%@NL@%
%@NL@%
%@CR:MSE72702@%%@4@%However, you can change this behavior by resetting the value of the%@EH@%
%@AB@%trailspace%@AE@% switch. This switch is Boolean switch; it can be either on or
off. To turn this switch on, give the %@AI@%Arg textarg Assign%@AE@% command (ALT+A
%@AI@%textarg%@AE@% ALT+=), in which %@AS@%trailspace:%@AE@% is the %@AI@%textarg%@AE@%. When you wish to turn
this switch off, give the %@AI@%Arg textarg Assign%@AE@% command, in which %@AS@%notrailspace:%@AE@%
is the %@AI@%textarg%@AE@%.%@NL@%
%@NL@%
%@CR:MSE72703@%%@4@%When this switch is on, any space you type at the end of a line remains in%@EH@%
the file as a trailing space. You can verify the existence of trailing
spaces by invoking the %@AI@%Endline%@AE@% function (press END). If the cursor moves
past the last printable character when you invoke %@AI@%Endline%@AE@%, the line contains
trailing spaces.%@NL@%
%@NL@%
%@CR:MSE72704@%%@4@%To display trailing spaces, set the %@AB@%traildisp%@AE@% switch to a number greater%@EH@%
than 0. The editor displays the ASCII-character equivalent of the number you
choose, in place of each trailing space. For example, invoke the %@AI@%Arg textarg%@AE@%
%@AI@%Assign%@AE@% command in which %@AI@%textarg%@AE@% is %@AS@%traildisp:1%@AE@%.%@NL@%
%@NL@%
%@CR:MSE72705@%%@4@%The example above displays the ASCII equivalent of the number 1 in place of%@EH@%
each trailing space. To restore normal display, set %@AB@%traildisp%@AE@% back to 0.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE72800@%%@3@%%@AB@%7.2.8  Changing Screen Height%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE72801@%%@4@%Change the screen height by setting the %@AB@%height%@AE@% switch. This switch takes%@EH@%
only a few values that are limited by the kind of graphics adapter card you
are using:%@NL@%
%@NL@%
%@CR:MSE72802@%%@AB@%Graphics Card               Legal Values%@AE@%%@NL@%
%@NL@%
CGA or monochrome           23  (25-line mode)%@NL@%
%@NL@%
EGA                         23  (25-line mode) 41  (43-line mode)%@NL@%
%@NL@%
VGA                         23  (25-line mode) 41  (43-line mode) 48%@NL@%
                            (50-line mode)%@NL@%
%@NL@%
%@CR:MSE72803@%%@4@%Note that you assign to %@AB@%height%@AE@% a number two less than the desired mode. That%@EH@%
is because %@AB@%height%@AE@% refers to the height of the editing window, not the full
screen. (Two lines at the bottom of the screen are reserved for dialog and
status.)%@NL@%
%@NL@%
%@NL@%
%@CR:MSE73000@%%@2@%%@AB@%7.3  Special Syntax for Text Switches%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE73001@%%@4@%The following text switches recognize special characters for referring to%@EH@%
file names or directories:%@NL@%
%@NL@%
%@CR:MSE73002@%  ■  %@AB@%extmake%@AE@%, which can be repeatedly assigned to different compilation%@NL@%
     commands%@NL@%
%@NL@%
  ■  %@AB@%readonly%@AE@%, which gives a system-level command, executed whenever you%@NL@%
     attempt to overwrite a read-only file%@NL@%
%@NL@%
  ■  %@AB@%load%@AE@%, which loads a C extension as described in Chapter 8%@BO:   3fbeb@%%@NL@%
%@NL@%
  ■  %@AB@%markfile%@AE@%, which loads file markers from a specially prepared file%@NL@%
%@NL@%
  ■  %@AB@%helpfiles%@AE@%, which specifies which .HLP files should be used by on-line%@NL@%
     Help%@NL@%
%@NL@%
%@CR:MSE73003@%%@4@%This syntax presented in the next two sections is never required, but is%@EH@%
provided for convenience.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE73100@%%@3@%%@AB@%7.3.1  Special Syntax for extmake and readonly%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE73101@%%@4@%The text switches %@AB@%extmake%@AE@% and %@AB@%readonly%@AE@% each interpret the following%@EH@%
characters as the name of the current file:%@NL@%
%@NL@%
     %@AB@%%s%@AE@%%@NL@%
%@NL@%
%@CR:MSE73103@%%@4@%You can also use a more comprehensive syntax that lets you specify drive,%@EH@%
file name, base name, or file extension. The syntax consists of the
characters%@NL@%
%@NL@%
     %@AB@%%|%@AE@%%@AI@%letters%@AE@%%@AB@%F%@AE@%%@NL@%
%@NL@%
%@CR:MSE73105@%%@4@%where %@AI@%letters%@AE@% consists of any of the following: p for path, d for drive, f%@EH@%
for file base name, or e for file extension. For example, if you are editing
the file c:\dir1\sample.c, and you make the switch assignment%@NL@%
%@NL@%
     extmake:c cl /Fod:%|pfF %|dfeF%@NL@%
%@NL@%
%@CR:MSE73106@%%@4@%then each time you give the command %@AI@%Arg Compilation%@AE@%, the editor performs the%@EH@%
following system-level command:%@NL@%
%@NL@%
     cl /Fod:\dir1\sample c:sample.c%@NL@%
%@NL@%
%@CR:MSE73107@%%@4@%The expression %@AS@%%s%@AE@% is equivalent to %@AS@%%|feF%@AE@% except that the former is only%@EH@%
accepted once in each assignment, whereas the latter can appear any number
of times in the %@AB@%extmake%@AE@% switch assignment. The expression %@AS@%%|F%@AE@% is equivalent
to %@AS@%%|dpfeF%@AE@%.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE73200@%%@3@%%@AB@%7.3.2  Special Syntax for load, markfile, and helpfiles%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE73201@%%@4@%The %@AB@%load%@AE@%, %@AB@%markfile%@AE@%, and %@AB@%helpfiles%@AE@% switches each search for a file. These%@EH@%
switches can also take the syntax%@NL@%
%@NL@%
     %@AB@%$%@AE@%%@AI@%environ%@AE@%%@AB@%:%@AE@%%@NL@%
%@NL@%
%@CR:MSE73203@%%@4@%in which %@AI@%environ%@AE@% is the name of an environment variable recognized by the%@EH@%
operating system. The editor will search directories listed in the
environment variable to find the file. Environment variables are created
with the system-level SET command. See your operating-system documentation
for more information on the SET command.%@NL@%
%@NL@%
%@CR:MSE73204@%%@4@%For example, the following assignment causes the editor to search%@EH@%
directories in the INIT environment variable for the file MARKERS.DAT:%@NL@%
%@NL@%
     markfile:$INIT:markers.dat%@NL@%
%@NL@%
%@CR:MSE73205@%%@4@%Note that the environment variable should be entered in uppercase letters.%@EH@%%@NL@%
%@NL@%
%@NL@%
%@CR:MSE74000@%%@2@%%@AB@%7.4  Sample TOOLS.INI File%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE74001@%%@4@%Each time you start the editor, it checks the [M] section of the TOOLS.INI%@EH@%
file for any function assignments, switch assignments, and macro definitions
you have placed there. (However, the editor may check a different section if
the editor is not named M.EXE.)%@NL@%
%@NL@%
%@CR:MSE74002@%%@4@%You can change these settings at any time during the editing session by%@EH@%
using the %@AI@%Assign%@AE@% command. However, using TOOLS.INI is more convenient for
settings you want to use every time. Use TOOLS.INI to make the editor
automatically start up with all the screen colors, tab behavior, function
assignments, and special editing functions you want to make available for
all editing sessions.%@NL@%
%@NL@%
%@CR:MSE74003@%%@4@%The editor loads settings from TOOLS.INI when it starts and when you invoke%@EH@%
the %@AI@%Initialize%@AE@% function (SHIFT+F8) during the editing session. By giving a
text argument, you can also use %@AI@%Initialize%@AE@% to load specific sections within
TOOLS.INI.%@NL@%
%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@AI@%NOTE%@AE@%%@NL@%
   The editor checks the directories listed in the INIT environment variable%@NL@%
   for the location of the TOOLS.INI file. For example, if the TOOLS.INI%@NL@%
   file is in the directory %@AI@%C:\BIN%@AE@%, place the following statement in your%@NL@%
   AUTOEXEC.BAT file: %@AS@%SET INIT=C:\BIN.%@AE@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@CR:MSE74004@%%@4@%The example below shows a sample TOOLS.INI file. The next section explains%@EH@%
each section of this file in depth. Note that text following the semicolon
(;) is a comment.%@NL@%
%@NL@%
     [M MEP]                       %@AI@%; Settings for both M and MEP%@AE@%%@NL@%
%@NL@%
             enterinsmode:         %@AI@%; Start up in insert mode%@AE@%%@NL@%
             backup:none           %@AI@%; Perform no backup%@AE@%%@NL@%
             displaycursor:        %@AI@%; Display cursor on status line%@AE@%%@NL@%
             fgcolor:17            %@AI@%; Set primary and error colors%@AE@%%@NL@%
             errcolor:04%@NL@%
%@NL@%
             join:=savecur endline right arg sdelete savecur   %@AI@%; Macro%@AE@%%@NL@%
%@NL@%
             savecur:ctrl+f5       %@AI@%; Assignments to keys%@AE@%%@NL@%
             restcur:ctrl+f6%@NL@%
             join:alt+j%@NL@%
%@NL@%
     [M-C MEP-C]                   %@AI@%; C specific section - enable with Initialize%@AE@%%@NL@%
%@NL@%
             tabstops:3            %@AI@%; Tab columns 3 wide within editor%@AE@%%@NL@%
             case:                 %@AI@%; Case-sensitive searches%@AE@%%@NL@%
%@NL@%
     [NMAKE]%@NL@%
%@NL@%
     #  This is a comment line recognized by NMAKE%@NL@%
%@NL@%
%@NL@%
%@CR:MSE75000@%%@2@%%@AB@%7.5  The Structure of the TOOLS.INI File%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE75001@%%@4@%To create a TOOLS.INI file for the editor, you need to follow a few simple%@EH@%
rules:%@NL@%
%@NL@%
%@CR:MSE75002@%  1. You must precede your editor settings by a tag, or they will not be%@NL@%
     recognized. A "tag" is a heading within the TOOLS.INI file that divides%@NL@%
     the file into sections.%@NL@%
%@NL@%
     For example, you can use tags to create a section for the editor ([M]%@NL@%
     or [MEP], unless you have renamed the editor) and a section for another%@NL@%
     utility such as NMAKE, which looks for a section headed by the [NMAKE]%@NL@%
     tag. Each utility has its own syntax for interpreting TOOLS.INI%@NL@%
     statements, but all utilities must recognize tags. See the %@AI@%Microsoft%@AE@%%@NL@%
     %@AI@%CodeView and Utilities User's Guide%@AE@% for more information on NMAKE.%@NL@%
%@NL@%
  2. A semicolon (%@AB@%;%@AE@%) indicates that all text from the semicolon to the end%@NL@%
     of the line is a comment, and is ignored by the editor. To mark the%@NL@%
     beginning of a comment, a semicolon must either appear at the beginning%@NL@%
     of a line or be preceded by a space.%@NL@%
%@NL@%
  3. All macro definitions, function assignments, and switch assignments use%@NL@%
     exactly the same syntax used with the %@AI@%Assign%@AE@% command.%@NL@%
%@NL@%
     However, you do not invoke %@AI@%Arg%@AE@% or %@AI@%Assign%@AE@%; simply enter the assignment%@NL@%
     itself. (See the sample TOOLS.INI file for clarification.)%@NL@%
%@NL@%
  4. You can use the backslash (%@AB@%\%@AE@%) as a line-continuation character to%@NL@%
     continue  statements too long for one line. The backslash must be%@NL@%
     preceded by a space and can be followed only by trailing spaces and an%@NL@%
     optional comment. Normally, you should precede the backslash by two%@NL@%
     spaces.%@NL@%
%@NL@%
%@CR:MSE75003@%%@4@%The next few sections explain each part of the file──tags, comments, and%@EH@%
assignments.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE75100@%%@3@%%@AB@%7.5.1  Creating Sections with Tags%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE75101@%%@4@%Tags divide the TOOLS.INI file into sections.  All statements are associated%@EH@%
only with the tag they immediately follow. This feature allows programs
other than the Microsoft Editor to use this file for configuration
information. The most common way to use a tag is to simply include all
assignments and macro definitions after an M or MEP tag (depending on the
name of the editor):%@NL@%
%@NL@%
     [M]%@NL@%
%@NL@%
%@CR:MSE75103@%%@4@%When you run the Microsoft Editor under DOS 2.%@AI@%x%@AE@%, the editor always responds%@EH@%
to the tag [M]. Otherwise, the tag should use the base file name of the
editor. If the editor is named MEP.EXE, use the tag [MEP]. Use [M MEP] if
you have both M.EXE and MEP.EXE.%@NL@%
%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@AI@%IMPORTANT%@AE@%%@NL@%
   The name you use for the main editor tag should appear in all other%@NL@%
   editor tags as well. For example, if the main editor tag is [EDIT]%@NL@%
   (because you renamed the editor to EDIT.EXE), all editor tags should%@NL@%
   begin with the word EDIT. Instead of using [M-3.20], you would use%@NL@%
   [EDIT-3.20].%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@CR:MSE75104@%%@4@%When the Microsoft Editor is started, the tagged sections are loaded in the%@EH@%
following order:%@NL@%
%@NL@%
%@CR:MSE75105@%  1. Information used for all editing sessions.%@NL@%
%@NL@%
     All of the statements in the [M] section are loaded. Remember to use a%@NL@%
     different tag if you rename the editor.%@NL@%
%@NL@%
  2. Information specific to the operating system.%@NL@%
%@NL@%
     Depending upon the operating system you are running, one of the%@NL@%
     following tagged sections is loaded (if present):%@NL@%
%@NL@%
       ■  [M-3.20] (MS-DOS)%@NL@%
       ■  [M-10.0] (OS/2 protected mode)%@NL@%
       ■  [M-10.0R] (OS/2 real mode)%@NL@%
%@NL@%
     With the DOS or OS/2 version tag, you should insert the version number%@NL@%
     you are using. (OS/2 1.10 uses the tag 10.10.) You can combine%@NL@%
     operating-system tags by grouping them together within the brackets:%@NL@%
%@NL@%
          [M-3.20 M-3.30]                      %@AI@%; For DOS versions%@AE@%%@NL@%
          [MEP-10.0 MEP-10.10]                 %@AI@%; For OS/2 versions%@AE@%%@NL@%
          [M-3.20 M-3.30 M-10.0R M-10.10R]     %@AI@%; For real mode%@AE@%%@NL@%
%@NL@%
  3. Information specific to the display.%@NL@%
%@NL@%
     Depending on the video display you are using, one of the following%@NL@%
     tagged sections is loaded (if present):%@NL@%
%@NL@%
       ■  [M-mono]%@NL@%
       ■  [M-cga]%@NL@%
       ■  [M-ega]%@NL@%
       ■  [M-vga]%@NL@%
%@NL@%
     You can also put statements for setting the screen dimensions and%@NL@%
     colors in these tagged sections.%@NL@%
%@NL@%
     All tags can be combined so one section of statements applies to more%@NL@%
     than one tag:%@NL@%
%@NL@%
        %@AS@%[M-mono M-cga MEP-mono MEP-cga]%@AE@%%@NL@%
%@NL@%
     The example above begins a section that is loaded if your computer has%@NL@%
     either a monochrome adapter or a CGA adapter.%@NL@%
%@NL@%
%@CR:MSE75106@%%@4@%You can also create a tag with statements specific to a file extension. The%@EH@%
form is%@NL@%
%@NL@%
     [M-%@AI@%.ext%@AE@%]%@NL@%
%@NL@%
%@CR:MSE75107@%%@4@%where .%@AI@%ext%@AE@% is an extension of up to three characters. Whenever you load a%@EH@%
new file, or switch to editing a different file, the editor automatically
searches TOOLS.INI for a tag that matches the new file extension. If it
finds a matching tag, the statements following that tag are executed. If
not, the existing configuration is retained.%@NL@%
%@NL@%
%@CR:MSE75108@%%@4@%This feature can be used to create operating environments that are specific%@EH@%
to a particular type of text file or programming language. For example, the
tag %@AS@%[M-.FOR]%@AE@% could precede a set of statements for editing .FOR (FORTRAN)
files:  a blue background, the right margin at column 72, and tabs set every
three columns. C-language files with the .C extension could have their own
set of statements following a %@AS@%[M-.C]%@AE@% tag: a magenta background, the right
margin at column 128, and tabs set every five columns.%@NL@%
%@NL@%
%@CR:MSE7510A@%%@4@%You can also use a tag to create a special section that is loaded manually%@EH@%
with the %@AI@%Arg textarg Initialize%@AE@% command. These tags use the following
syntax:%@NL@%
%@NL@%
     [M-%@AI@%textarg%@AE@%]%@NL@%
%@NL@%
%@CR:MSE7510C@%%@4@%This feature lets you make special key assignments, load rarely used macros,%@EH@%
or switch the operating environment to a special configuration, only when
required.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE75200@%%@3@%%@AB@%7.5.2  Using Comments%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE75201@%%@4@%The Microsoft Editor considers text from a semicolon (;) to the end of a%@EH@%
line to be a comment. Comments are for documentation purposes only and are
ignored by the editor.%@NL@%
%@NL@%
%@CR:MSE75202@%%@4@%To be considered part of a comment, the semicolon must either appear at the%@EH@%
beginning of a line or else be preceded by a space. Thus, in the following
line, the first semicolon is considered part of a command, and the second
begins a comment:%@NL@%
%@NL@%
     extmake:asm masm /Zi /MX %s; %@AI@%; "Compile" setting for MASM%@AE@%%@NL@%
%@NL@%
%@CR:MSE75203@%%@4@%Semicolons inside a quoted string do not begin a comment.%@EH@%%@NL@%
%@NL@%
%@NL@%
%@CR:MSE75300@%%@3@%%@AB@%7.5.3  Line Continuation%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE75301@%%@4@%Use the backslash (%@AB@%\%@AE@%) to continue a long macro definition to the next line.%@EH@%
To be interpreted as the line-continuation character, the backslash must be
preceded by a space. It should be the last character on the line except for
spaces and comments. The editor does not interpret the backslash as the
line-continuation char-acter in the following statement:%@NL@%
%@NL@%
     qreplace:ctrl+\%@NL@%
%@NL@%
%@CR:MSE75302@%%@4@%The following statement illustrates valid use of line continuation:%@EH@%%@NL@%
%@NL@%
     findswitch:=psearch ->skip arg mark :>skip arg "<assign>"  \%@NL@%
                 setfile begfile psearch%@NL@%
%@NL@%
%@CR:MSE75303@%%@4@%Note that the backslash should be followed by at least two spaces, unless%@EH@%
you want the end of one line to be concatenated without a break to the
beginning of the next. In the example above, two spaces are necessary to
prevent the editor from viewing %@AS@%"<assign>"setfile%@AE@% as one item.%@NL@%
%@NL@%
%@CR:MSE75304@%%@4@%You can use line continuation to extend a single assignment statement over%@EH@%
several lines.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE75400@%%@3@%%@AB@%7.5.4  Assignments and Macros%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE75401@%%@4@%Function assignments, switch assignments, and macro definitions all use the%@EH@%
same syntax within the TOOLS.INI file as they do with the %@AI@%Arg textarg Assign%@AE@%
command. The only difference is you do not need to invoke the %@AI@%Arg%@AE@% or %@AI@%Assign%@AE@%
functions.%@NL@%
%@NL@%
%@CR:MSE75402@%%@4@%The TOOLS.INI file is convenient for defining complicated macros, especially%@EH@%
nested macros. By placing macro definitions in the TOOLS.INI file, you can
view how you wrote a macro. Furthermore, you can easily modify a macro that
doesn't work correctly by loading the TOOLS.INI file, making changes to your
macro definitions, and reinitializing.%@NL@%
%@NL@%
%@CR:MSE75403@%%@4@%If you customized your copy of the Microsoft Editor when you installed it, a%@EH@%
special TOOLS.INI was created that contains the special key assignments.
This TOOLS.INI file also contains a number of useful macros from the
TOOLS.PRE file. You may want to study TOOLS.PRE to see how macros are
entered and which macros might be useful to you.%@NL@%
%@NL@%
%@CR:MSE75404@%%@4@%Use the %@AI@%Initialize%@AE@% function (SHIFT+F8) to reload your TOOLS.INI settings.%@EH@%
When you give the %@AI@%Initialize%@AE@% function a %@AI@%textarg%@AE@%, it attempts to use settings
from the following section:%@NL@%
%@NL@%
     [M-%@AI@%textarg%@AE@%]%@NL@%
%@NL@%
%@CR:MSE75406@%%@4@%However, when you invoke %@AI@%Initialize%@AE@% with no argument, the editor reloads%@EH@%
settings in the TOOLS.INI file in the same way that it does on start-up.%@NL@%
%@NL@%
%@CR:MSE75407@%%@4@%You can create a macro to be executed whenever the editor starts up. Simply%@EH@%
define a macro and assign it the name %@AS@%autostart%@AE@%. For example, when you place
the following macro in the [M] section of the TOOLS.INI file, the editor
transfers to the Clipboard and returns, thus making the Clipboard the
previous file:%@NL@%
%@NL@%
     autostart:=arg "<clipboard>" setfile setfile%@NL@%
%@NL@%
%@NL@%
%@CR:MSE76000@%%@2@%%@AB@%7.6  Configuring On-Line Help%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE76001@%%@4@%The installation program for your Microsoft language is the recommended%@EH@%
method for configuring on-line Help. The procedure varies, depending on
whether you use OS/2 (supporting protected mode and real mode) or DOS (real
mode only).%@NL@%
%@NL@%
%@CR:MSE76002@%  1. If you are running under DOS or real-mode OS/2 only, copy the M.HLP and%@NL@%
     MHELP.MXT files to any directory specified in the PATH environment%@NL@%
     variable in your AUTOEXEC.BAT file (DOS) or STARTUP.CMD file (OS/2).%@NL@%
%@NL@%
  2. If you are running under protected-mode OS/2 only, copy the M.HLP and%@NL@%
     MHELP.PXT files to any directory specified in the PATH environment%@NL@%
     variable. Also copy MSHELP.DLL to any directory listed in the LIBPATH%@NL@%
     variable in the CONFIG.SYS file. MHELP.DLL is an extension to the%@NL@%
     editor. MSHELP.DLL is a support library that implements the standard%@NL@%
     Microsoft Help engine.%@NL@%
%@NL@%
  3. If you are setting up for both real- and protected-mode OS/2, perform%@NL@%
     both the preceding steps.%@NL@%
%@NL@%
%@CR:MSE76003@%%@4@%Other Microsoft products include .HLP files that the Microsoft Editor can%@EH@%
read. If you want to add additional .HLP files to Help, you need to include
the following tagged section in your TOOLS.INI file:%@NL@%
%@NL@%
     [M-MHELP.MXT MEP-MHELP.MXT]%@NL@%
     helpfiles:%@AI@%path%@AE@%\%@AI@%file.hlp%@AE@%%@NL@%
%@NL@%
%@CR:MSE76004@%%@4@%in which %@AI@%path%@AE@% is the directory of the Help file. The tag [M-MHELP.MXT%@EH@%
MEP-MHELP.MXT] is the heading for the section in the TOOLS.INI file executed
whenever Help is loaded. If this section is missing, the editor looks for
the file M.HLP in your PATH directories. To install more than one Help file,
you must have this tagged section in TOOLS.INI.%@NL@%
%@NL@%
%@CR:MSE76005@%%@4@%Whenever you use context-sensitive Help, the editor searches the files%@EH@%
specified in the %@AB@%helpfiles%@AE@% switch in the order listed. The search is slower
if the topics you most often inquire about are in files at the end of the
list. You can alter the %@AB@%helpfiles%@AE@% switch at any time with the %@AI@%Assign%@AE@%
command.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE76100@%%@3@%%@AB@%7.6.1  Controlling Search Order%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE76101@%%@4@%Context-sensitive Help searches all the Help files for the selected topic.%@EH@%
The order in which files are searched is important. Two different Help files
may have an entry for the same topic. Furthermore, searching the appropriate
file first speeds up Help.%@NL@%
%@NL@%
%@CR:MSE76102@%%@4@%You can use the file extension of the current file to change the order in%@EH@%
which .HLP files are searched. Precede files specified in the %@AB@%helpfiles%@AE@%
switch by a file extension and a colon (:):%@NL@%
%@NL@%
     helpfiles: M.HLP .BAS:QB.HLP .C.H:C.HLP .ASM:OS2.HLP%@NL@%
%@NL@%
%@CR:MSE76103@%%@4@%In the example above, Help searches QB.HLP first when the current file has a%@EH@%
.BAS extension, C.HLP when the current file has a .C or .H extension, and
OS2.HLP when the current file has a .ASM extension. In all cases, all of the
files listed are searched before Help concludes it cannot find a topic.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE76200@%%@3@%%@AB@%7.6.2  Default Help File Search%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE76201@%%@4@%The editor looks for .HLP files according to the following rules:%@EH@%%@NL@%
%@NL@%
%@CR:MSE76202@%  1. If the %@AB@%helpfiles%@AE@% switch is set, the editor uses the files specified in%@NL@%
     this switch.%@NL@%
%@NL@%
  2. If %@AB@%helpfiles%@AE@% is not set, the editor checks next to see if the HELPFILES%@NL@%
     environment variable is set. If it is, this environment variable is%@NL@%
     evaluated the same way the %@AB@%helpfiles%@AE@% switch is.%@NL@%
%@NL@%
  3. If neither the %@AB@%helpfiles%@AE@% switch nor the HELPFILES environment variable%@NL@%
     is set, the editor searches for the file M.HLP. The editor finds M.HLP%@NL@%
     if this file is in a directory listed in the PATH environment variable.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE80000@%%@1@%%@AB@%Chapter 8  Programming C Extensions%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@CR:MSE80001@%%@4@%C extensions provide the most powerful means of customizing the Microsoft%@EH@%
Editor. A "C extension" is a C-language module containing new editing
functions you program. Your functions can be attached to a key, given
arguments, or used in macros just as standard editing functions are. The
module can also define new switches. The user can adjust these switches to
modify the behavior of your functions.%@NL@%
%@NL@%
%@CR:MSE80002@%%@4@%With C extensions, you can use the power of the C language──data structures,%@EH@%
control-flow structures, and C operators. Furthermore, C extensions are much
faster than macros because they are compiled.%@NL@%
%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@AI@%NOTE%@AE@%%@NL@%
   This chapter assumes you already know how to program in C. Before you%@NL@%
   read the chapter, make sure you understand the following C-language%@NL@%
   programming concepts: functions, pointers, structures, and unions. You%@NL@%
   also need to know how to compile and link a C source file.%@NL@%
   You can also write extensions with the Microsoft Macro Assembler if you%@NL@%
   simulate the C memory model specified in Section 8.5.1%@BO:   4ab20@%, "Compiling and%@NL@%
   Linking in Real Mode." However, this chapter is primarily addressed to C%@NL@%
   programmers.%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@CR:MSE80003@%%@4@%This chapter gradually develops concepts for writing C extensions. The first%@EH@%
time you read the chapter, read the sections in order. The chapter first
describes requirements for writing C extensions and explains how C
extensions work. It then explains how to create the required objects in a C
extension, to program your editing functions, to compile and link your
module, and to use the editor's low-level functions to read and write to
files.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE81000@%%@2@%%@AB@%8.1  Requirements%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE81001@%%@4@%To create C extensions, you need to have the following files and software%@EH@%
present in your current directory (or directories listed in the PATH or
INCLUDE environment variables, as appropriate):%@NL@%
%@NL@%
%@CR:MSE81002@%  ■  The Microsoft C Optimizing Compiler, Version 5.1 or later. You can use%@NL@%
     Version 4.0 or 5.0 of the compiler, but the files you need are provided%@NL@%
     with Version 5.1 and later. You also get these files with the Microsoft%@NL@%
     Macro Assembler, Version 5.1 and later.%@NL@%
%@NL@%
  ■  The Microsoft Overlay Linker, Version 3.60 or later; the OS/2 version%@NL@%
     of the linker; or the Microsoft Segmented-Executable Linker, Version%@NL@%
     5.01.%@NL@%
%@NL@%
  ■  EXTHDR.OBJ (supplied with the C compiler) or EXTHDRP.OBJ (a file%@NL@%
     supplied with the C compiler for creating protected-mode extensions).%@NL@%
%@NL@%
  ■  EXT.H (supplied with the C compiler).%@NL@%
%@NL@%
  ■  SKEL.C (a template supplied with the C compiler you can replace with%@NL@%
     your own code).%@NL@%
%@NL@%
%@CR:MSE81003@%%@4@%You need a minimum of 220K of available memory for the editor to load a C%@EH@%
extension at run time, plus the size of the extension itself.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE82000@%%@2@%%@AB@%8.2  How C Extensions Work%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE82001@%%@4@%A C-extension module is similar in the following respects to an OS/2 or%@EH@%
Windows dynamic-link library:%@NL@%
%@NL@%
%@CR:MSE82002@%  ■  There is no function called %@AB@%main%@AE@% in your module. Instead, you use%@NL@%
     certain names and structures the editor recognizes.%@NL@%
%@NL@%
  ■  You compile and link to create an executable file, but this executable%@NL@%
     file is separate from the "main program," M.EXE or MEP.EXE.%@NL@%
%@NL@%
  ■  The editor loads your executable file into memory at run time and uses%@NL@%
     a table-driven method for enabling your module to call functions within%@NL@%
     the editor.%@NL@%
%@NL@%
%@CR:MSE82003@%%@4@%Once your executable file is loaded, it resides in memory along with the%@EH@%
editor. The editor can call your functions, and your functions can call the
Microsoft Editor's low-level functions that perform input and output
operations.%@NL@%
%@NL@%
%@CR:MSE82004@%%@4@%The following list summarizes the process of developing and using a C%@EH@%
extension:%@NL@%
%@NL@%
%@CR:MSE82005@%  1. Compile a C module with a special memory-model option, then link the%@NL@%
     resulting object file to create an executable file.%@NL@%
%@NL@%
     You also link in the object file EXTHDR.OBJ  (or EXTHDRP.OBJ, if%@NL@%
     linking for protected mode) to the beginning of your executable file.%@NL@%
     This object file contains a special table that enables your functions%@NL@%
     to effectively call functions within the editor.%@NL@%
%@NL@%
  2. Start up the Microsoft Editor. Set the %@AB@%load%@AE@% switch  to look for the%@NL@%
     executable file you created. (As discussed in Chapter 7%@BO:   3396c@%, the %@AB@%load%@AE@%%@NL@%
     switch can be set in the TOOLS.INI file or manually with the %@AI@%Assign%@AE@%%@NL@%
     function.)%@NL@%
%@NL@%
     The editor loads your executable file into memory.%@NL@%
%@NL@%
  3. As soon as the executable file is loaded, the Microsoft Editor calls%@NL@%
     the function %@AB@%WhenLoaded%@AE@%──a special function your module must define.%@NL@%
     At the same time, the editor examines the table %@AB@%cmdTable%@AE@%, which is an%@NL@%
     array of structures your module must declare. The editor examines this%@NL@%
     table to recognize the editing functions you created. The table%@NL@%
     contains function names and pointers to functions.%@NL@%
%@NL@%
  4. You can assign keys to call your functions. Assign a key manually or in%@NL@%
     the %@AB@%WhenLoaded%@AE@% function, then press the assigned key. You can also call%@NL@%
     an editing function indirectly by placing it in a macro and calling the%@NL@%
     macro.%@NL@%
%@NL@%
  5. When you invoke a C-extension function, the editor responds by calling%@NL@%
     your module.%@NL@%
%@NL@%
  6. Your editing function is executed. It calls the Microsoft Editor's%@NL@%
     low-level functions to read from the text file, read output to the text%@NL@%
     file, and print messages.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE83000@%%@2@%%@AB@%8.3  Writing a C Extension%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE83001@%%@4@%To create a successful C extension, you need to follow these guidelines:%@EH@%%@NL@%
%@NL@%
%@CR:MSE83002@%  1. Include the file EXT.H.%@NL@%
%@NL@%
     This file declares all structures and types required to establish an%@NL@%
     interface to the editor.%@NL@%
%@NL@%
  2. Include the standard items that are described in Section 8.3.1%@BO:   41aca@%,%@NL@%
     "Required Objects," and write your functions by following the steps in%@NL@%
     Section 8.4%@BO:   45aeb@%, "Programming Your Function." Then compile and link as%@NL@%
     directed in Section 8.5%@BO:   4a7bb@%, "Compiling and Linking."%@NL@%
%@NL@%
  3. Call the low-level extension functions to do most any operation with%@NL@%
     files, such as read from a file, write to a file, delete or add files,%@NL@%
     and move the cursor. These functions are completely described in%@NL@%
     Chapter 9%@BO:   50fea@%, "C-Extension Functions," (an alphabetical reference), and%@NL@%
     summarized by topic at the end of this chapter.%@NL@%
%@NL@%
     Do not call functions from the C library routine, except for the ones%@NL@%
     specifically listed in Section 8.7%@BO:   4fa83@%, "Calling Library Functions."%@NL@%
     Futhermore, floating-point arithmetic is not supported.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE83100@%%@3@%%@AB@%8.3.1  Required Objects%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE83101@%%@4@%A C-extension module must have at minimum the three objects described below:%@EH@%%@NL@%
%@NL@%
%@CR:MSE83102@%%@AB@%Object Name                 Description%@AE@%%@NL@%
%@NL@%
%@AB@%swiTable%@AE@%                    An array of structures that declares internal%@NL@%
                            switches you wish to create%@NL@%
%@NL@%
%@AB@%cmdTable%@AE@%                    An array of structures that declares editing%@NL@%
                            functions you have coded%@NL@%
%@NL@%
%@AB@%WhenLoaded%@AE@%                  A function that the editor calls as soon as the%@NL@%
                            C-extension module is loaded%@NL@%
%@NL@%
%@CR:MSE83103@%%@4@%Each of these items can be as short or long as you wish. Each table can be%@EH@%
as short as a single row of entries. The %@AB@%WhenLoaded%@AE@% function can return
immediately, or it can perform useful initialization tasks, such as
assigning keys to functions or printing a message.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE83200@%%@3@%%@AB@%8.3.2  The Switch Table%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE83201@%%@4@%The switch table, %@AB@%swiTable%@AE@%, consists of a series of structures in which each%@EH@%
structure describes a switch you wish to create. The table ends with a
structure that has all null (all zero) values. Though you may choose not to
create any switches, the table must still be present. The simplest table
allowed is therefore%@NL@%
%@NL@%
     struct swiDesc swiTable[] =%@NL@%
     {%@NL@%
          { (void *) 0, (void *) 0, 0 }%@NL@%
     };%@NL@%
%@NL@%
%@CR:MSE83202@%%@4@%The structure type %@AB@%swiDesc%@AE@% is defined in EXT.H. This structure contains the%@EH@%
following three fields that define a switch for the editor to recognize:%@NL@%
%@NL@%
%@CR:MSE83203@%  1. A pointer to the name of the switch.%@NL@%
%@NL@%
  2. A pointer to the switch itself or to a function. If the switch is%@NL@%
     Boolean, this field must point to the switch (an integer which assumes%@NL@%
     the value -1 or 0). If the switch is text, this field must point to a%@NL@%
     function, as explained below. If the switch is numeric, this field%@NL@%
     points to switch itself──an integer.%@NL@%
%@NL@%
  3. A flag that indicates the type of switch: either %@AB@%SWI_BOOLEAN%@AE@%,%@NL@%
     %@AB@%SWI_NUMERIC%@AE@%, or %@AB@%SWI_SPECIAL%@AE@%.%@NL@%
%@NL@%
%@CR:MSE83204@%%@4@%If the third field has value %@AB@%SWI_NUMERIC%@AE@%, you must combine it with the value%@EH@%
%@AB@%RADIX10%@AE@% or %@AB@%RADIX16%@AE@% by using binary or (%@AB@%|%@AE@%). (See the second example below.)
If you specify %@AB@%RADIX10%@AE@%, the editor interprets user-assigned values as
decimal digits. If you specify %@AB@%RADIX16%@AE@%, the editor interprets these values
as hexadecimal.%@NL@%
%@NL@%
%@CR:MSE83205@%%@4@%If the third field has value %@AB@%SWI_SPECIAL%@AE@%, the second field must be a pointer%@EH@%
to a function of type %@AB@%int far pascal%@AE@%. You define this function in your code.
Each time the value of the switch changes, the editor calls your function
and passes the updated value in a character string. Your function should
declare exactly one parameter: a far pointer to a character string.
Typically, this function might set a global variable:%@NL@%
%@NL@%
     char globalstr[BUFLEN];%@NL@%
%@NL@%
     int far pascal setstr (char far *p)%@NL@%
     {%@NL@%
          strcpy (globalstr, p);%@NL@%
     }%@NL@%
%@NL@%
%@CR:MSE83206@%%@4@%The table may have any number of rows (each row being a structure), and must%@EH@%
at least include the final row of all null values. Here is an example of a
table that creates a numeric switch with a default value of 27:%@NL@%
%@NL@%
     int n = 27;%@NL@%
%@NL@%
     struct swiDesc swiTable [] =%@NL@%
     {%@NL@%
          { "newswitch", &n, SWI_NUMERIC|RADIX10  } ,%@NL@%
          { (void *) 0, (void *) 0, 0 }%@NL@%
     }%@NL@%
%@NL@%
%@NL@%
%@CR:MSE83300@%%@3@%%@AB@%8.3.3  The Command Table%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE83301@%%@4@%The command table, %@AB@%cmdTable%@AE@%, is similar to the switch table, %@AB@%swiTable%@AE@%, in%@EH@%
its construction. Each "row" of the table consists of a structure that
describes an editing function you want the editor to recognize. The last row
must contain all null values. The simplest table allowed is the following:%@NL@%
%@NL@%
     struct cmdDesc cmdTable[] =%@NL@%
     {%@NL@%
          { (void *) 0, (void *) 0, 0, 0 }%@NL@%
     }%@NL@%
%@NL@%
%@CR:MSE83302@%%@4@%Usually you'll want to declare at least one new editing function. The%@EH@%
structure type %@AB@%cmdDesc%@AE@% is defined in EXT.H. This structure contains the
following four fields that make an editing function recognizable to the
editor:%@NL@%
%@NL@%
%@CR:MSE83303@%  1. A pointer to the name of the function, in ASCII format. This name could%@NL@%
     appear in assignments and macros.%@NL@%
%@NL@%
  2. The address of the function itself. Give the function name but do not%@NL@%
     follow it with parentheses.%@NL@%
%@NL@%
  3. A field used internally by the editor. Always declare this field as%@NL@%
     null.%@NL@%
%@NL@%
  4. Flags indicating the type of the function. Function types are described%@NL@%
     below and define what type of argument the function will accept.%@NL@%
%@NL@%
%@CR:MSE83304@%%@4@%Here is an example of a command table declaring a function that takes no%@EH@%
arguments and a second function that takes either a %@AI@%linearg%@AE@% or a %@AI@%boxarg%@AE@% or
can be entered without arguments:%@NL@%
%@NL@%
     struct cmdDesc cmdTable[] =%@NL@%
     {%@NL@%
          { "newfun", newfun, 0, NOARG } ,%@NL@%
          { "fun2",  fun2,     0, LINEARG | BOXARG | NOARG } ,%@NL@%
          { (void *) 0, (void *) 0, 0, 0 }%@NL@%
     }%@NL@%
%@NL@%
%@CR:MSE83305@%%@4@%In the fourth field of the command table, use one or more of the values%@EH@%
described in Table 8.1%@BO:   435cc@% below.%@NL@%
%@NL@%
%@CR:MSE83306@%%@4@%The first column of Table 8.1%@BO:   435cc@% contains a flag you can enter in the fourth%@EH@%
field of %@AB@%cmdTable%@AE@%. The second column describes the associated behavior. The
third column indicates which of the six data formats the editor uses to pass
information. Your function determines the format at run time by testing the
value of pArg->argType. Sections 8.4.3%@BO:   470c5@%-8.4.8 give complete descriptions of
these formats.%@NL@%
%@NL@%
%@CR:MSE83307@%%@4@%Many of the descriptions below state that the editor responds by passing%@EH@%
certain information. However, these responses only apply when the editor
detects the associated condition. For example, the %@AB@%BOXARG%@AE@% flag controls the
editor's behavior only when a %@AI@%boxarg%@AE@% is detected. However, %@AB@%KEEPMETA%@AE@%,
%@AB@%MODIFIES%@AE@%, and %@AB@%CURSORFUNC%@AE@% apply regardless of argument type.%@NL@%
%@CR:MSE8T100@%%@NL@%
%@4@%%@AU@%Table 8.1  Meaning of cmdTable Flags%@AE@%%@EH@%%@NL@%
%@TH:   68   3808  3 14 51 11 @%
%@AB@%cmdTable                                                         argType%@AE@%
%@AB@%Flag          Behavior                                           Format%@AE@%

%@AB@%KEEPMETA%@AE@%      Preserves the state of the %@AI@%Meta%@AE@% prefix, which is   Not
              normally reset upon completion of the function.    applicable

%@AB@%MODIFIES%@AE@%      Prevents execution of the function when the        Not
              current file is No-Edit.                           applicable

%@AB@%WINDOWFUNC%@AE@%    Does not cancel highlight resulting from a         Not
              previous command, such as %@AI@%Psearch%@AE@%. This flag is    applicable
              useful for window-movement functions.

%@AB@%CURSORFUNC%@AE@%    Does not recognize or cancel %@AI@%Arg%@AE@% prefix. The       %@AB@%NOARG%@AE@%
              function is useful for helping define
              cursor-movement arguments, since it preserves the
              preexisting argument. Conflicts with all flags
              except %@AB@%KEEPMETA%@AE@% and %@AB@%MODIFIES%@AE@%.

%@AB@%NOARG%@AE@%         Accepts absence of the %@AI@%Arg%@AE@% prefix. The editor      %@AB@%NOARG%@AE@%
              passes location of the cursor.

%@AB@%NULLARG%@AE@%       Accepts %@AI@%Arg%@AE@% without an argument. The editor        %@AB@%NULLARG%@AE@%
              passes location of the cursor. Conflicts with
              %@AB@%NULLEOL%@AE@% and %@AB@%NULLEOW%@AE@%.

%@AB@%NULLEOL%@AE@%       Accepts %@AI@%Arg%@AE@% without an argument. The editor        %@AB@%TEXTARG%@AE@%
              passes the string of text from the cursor
              position up to the end of the line. Conflicts
              with %@AB@%NULLARG%@AE@% and %@AB@%NULLEOW%@AE@%.

%@AB@%NULLEOW%@AE@%       Accepts %@AI@%Arg%@AE@% without an argument. The editor        %@AB@%TEXTARG%@AE@%
              passes the string of text from the cursor
              position up to the next white space. Conflicts
              with %@AB@%NULLARG%@AE@% and %@AB@%NULLEOL%@AE@%.

%@AB@%TEXTARG%@AE@%       Accepts a text argument that the user types in     %@AB@%TEXTARG%@AE@%
              directly.

%@AB@%BOXSTR%@AE@%        Accepts a one-line box argument. The editor        %@AB@%TEXTARG%@AE@%
              passes the highlighted string as a text argument.

%@AB@%LINEARG%@AE@%       Accepts a %@AI@%linearg%@AE@%. The editor passes location of   %@AB@%LINEARG%@AE@%
              first and last lines.

%@AB@%BOXARG%@AE@%        Accepts a %@AI@%boxarg%@AE@%. The editor passes location of    %@AB@%BOXARG%@AE@%
              the four edges of the box.

%@AB@%STREAMARG%@AE@%     Interprets any cursor-movement argument as a       %@AB@%STREAMARG%@AE@%
              stream of text. The stream may span more than one
              line. The editor passes location of beginning and
              ending points.

%@AB@%NUMARG%@AE@%        Interprets a numeric text argument as a file       Any cursor-
              position exactly %@AI@%numarg%@AE@% lines down from the        movement
              cursor. This position and the cursor position      type
              then define a region in the file. (The two
              positions form the end points of the region.) Use
              this flag in conjunction with other
              cursor-movement-argument flags, especially
              %@AB@%LINEARG%@AE@%.

%@AB@%MARKARG%@AE@%       Interprets a valid file-marker name as a file      Any cursor-
              position. This position and the cursor position    movement
              then define a region in the file. (The two         type
              positions form the end points of the region.) Use
              this flag in conjunction with other
              cursor-movement-argument flags.
%@TE:   68   3808  3 14 51 11 @%
%@NL@%
%@CR:MSE83308@%%@4@%The descriptions also refer to the passing of information to the function;%@EH@%
you'll see how the function receives information in Section 8.3.5%@BO:   44a45@%,
"Defining the Editing Function."%@NL@%
%@NL@%
%@CR:MSE83309@%%@4@%The flags are bit masks; each turns a specific bit within an unsigned%@EH@%
integer. You can combine these bit masks with binary or ( %@AB@%|%@AE@% ). For example,
you can specify a function that accepts a %@AI@%boxarg%@AE@%, %@AI@%linearg%@AE@%, or %@AI@%numarg%@AE@% as:%@NL@%
%@NL@%
     BOXARG | LINEARG | NUMARG%@NL@%
%@NL@%
%@NL@%
%@CR:MSE83400@%%@3@%%@AB@%8.3.4  The WhenLoaded Function%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE83401@%%@4@%The function %@AB@%WhenLoaded%@AE@% takes no arguments and can return immediately.%@EH@%
However, you must include the function because the editor expects it to be
present. The simplest version of %@AB@%WhenLoaded%@AE@% is this:%@NL@%
%@NL@%
     WhenLoaded()%@NL@%
     {%@NL@%
          return TRUE;%@NL@%
     }%@NL@%
%@NL@%
%@CR:MSE83402@%%@4@%In Section 8.7%@BO:   4fa83@%, "Calling Library Functions," you'll learn how to call%@EH@%
functions that assign keys to functions and print a message on the message
line. These functions are often useful to call from within %@AB@%WhenLoaded%@AE@%.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE83500@%%@3@%%@AB@%8.3.5  Defining the Editing Function%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE83501@%%@4@%This section describes how to define an editing function. The section also%@EH@%
gives an overview of the information the editor passes to every function.
Section 8.4%@BO:   45aeb@%, "Programming Your Function," gives specific information on how
to interpret user-defined arguments.%@NL@%
%@NL@%
%@CR:MSE83502@%%@4@%The editing function must be declared %@AB@%flagType pascal EXPORT%@AE@%. The %@AB@%flagType%@AE@%%@EH@%
declaration indicates that your function returns one of two values: TRUE
(nonzero) or FALSE (zero). (Returning a value is recommended, because once
loaded, your function can be used within a macro. However, returning a value
is not a strict requirement.) The %@AB@%pascal%@AE@% keyword indicates that your
function uses the Pascal calling convention. Finally, your function must be
of type %@AB@%EXPORT%@AE@% to be properly accessed through the editor's dynamic-link
calls.%@NL@%
%@NL@%
%@CR:MSE83503@%%@4@%The sample function %@AS@%Skel%@AE@% is declared as follows:%@EH@%%@NL@%
%@NL@%
     #define TRUE  -1%@NL@%
     #define FALSE 0%@NL@%
%@NL@%
     flagType pascal EXPORT Skel (argData, pArg, fMeta)%@NL@%
     unsigned int argData;%@NL@%
     ARG far *pArg;%@NL@%
     flagType fMeta;%@NL@%
     {%@NL@%
          return TRUE;%@NL@%
     }%@NL@%
%@NL@%
%@CR:MSE83504@%%@4@%Replace the name %@AS@%Skel%@AE@% by the name of your function. This same name should%@EH@%
appear in the second field of the %@AB@%cmdTable%@AE@% data structure.%@NL@%
%@NL@%
%@CR:MSE83505@%%@4@%The parameter list is described below:%@EH@%%@NL@%
%@NL@%
%@CR:MSE83506@%%@AB@%Parameter                   Description%@AE@%%@NL@%
%@NL@%
%@AB@%argData%@AE@%                     The value of the keystroke used to invoke the%@NL@%
                            function. This parameter is generally not used.%@NL@%
%@NL@%
%@AB@%pArg%@AE@%                        A pointer to a structure that contains almost%@NL@%
                            all the information passed by the editor. This%@NL@%
                            structure is discussed in detail below.%@NL@%
%@NL@%
%@AB@%fMeta%@AE@%                       An integer that describes whether or not a %@AI@%Meta%@AE@%%@NL@%
                            prefix is present. This integer has value true%@NL@%
                            (nonzero) if %@AI@%Meta%@AE@% is present and value false (0)%@NL@%
                            if not.%@NL@%
%@NL@%
%@CR:MSE83507@%%@4@%The parameter %@AB@%pArg%@AE@% points to a structure whose first member is %@AB@%argType%@AE@%. This%@EH@%
variable contains one of six values: %@AB@%NOARG%@AE@%, %@AB@%TEXTARG%@AE@%, %@AB@%NULLARG%@AE@%, %@AB@%LINEARG%@AE@%,
%@AB@%STREAMARG%@AE@%, or %@AB@%TEXTARG%@AE@%. Each of these values is defined in Section 8.3.3%@BO:   42a57@%,
"The Command Table." For example, you could test for the presence of a
%@AI@%boxarg%@AE@% with the following code:%@NL@%
%@NL@%
     if( pArg->argType == BOXARG )%@NL@%
     {%@NL@%
         %@AI@%/* take appropriate action for boxarg */%@AE@%%@NL@%
     }%@NL@%
%@NL@%
%@CR:MSE83508@%%@4@%The rest of the structure consists of a union of smaller structures. The C%@EH@%
%@AB@%union%@AE@% type is necessary here; it enables the editor to pass data in a
variety of formats. The choice of format depends on what kind of argument
the user defined.%@NL@%
%@NL@%
%@CR:MSE83509@%%@4@%The declaration of the %@AB@%ARG%@AE@% structure is:%@EH@%%@NL@%
%@NL@%
     struct argType%@NL@%
     {%@NL@%
         int   argType;%@NL@%
         union%@NL@%
         {%@NL@%
             struct  noargType      noarg;%@NL@%
             struct  textargType    textarg;%@NL@%
             struct  nullargType    nullarg;%@NL@%
             struct  lineargType    linearg;%@NL@%
             struct  streamargType  streamarg;%@NL@%
             struct  boxargType     boxarg;%@NL@%
         } arg;%@NL@%
     }%@NL@%
%@NL@%
     typedef struct argType ARG;%@NL@%
%@NL@%
%@CR:MSE8350A@%%@4@%The editor returns argument information in one of the nested structures. The%@EH@%
next section describes the contents of each of these structures and provides
examples showing how to use each data format.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE84000@%%@2@%%@AB@%8.4  Programming Your Function%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE84001@%%@4@%When you write an editing function, you have two basic tasks. First, you%@EH@%
interpret information that the editor passes you. Second, you call the
editor's lower-level functions to execute basic editing tasks.%@NL@%
%@NL@%
%@CR:MSE84002@%%@4@%This section focuses on the most typical class of editing functions:%@EH@%
functions that analyze the user-defined argument and modify only the current
file. This class of functions, although huge in scope, depends on only a few
lower-level functions. Once you learn how to write these functions, you can
progress to more advanced operations──such as working on several files at
once or reading keyboard input. Chapter 9%@BO:   50fea@% describes the whole range of
low-level functions available.%@NL@%
%@NL@%
%@CR:MSE84003@%%@4@%A typical editing function might execute the following sequence of steps:%@EH@%%@NL@%
%@NL@%
%@CR:MSE84004@%  1. Get a handle to the current file by calling %@AB@%FileNameToHandle%@AE@%.%@NL@%
%@NL@%
  2. Use information about the user-defined argument to initialize local%@NL@%
     variables.%@NL@%
%@NL@%
  3. Process the argument. Modify the current file by calling %@AB@%GetLine%@AE@% and%@NL@%
     %@AB@%Putline%@AE@%.%@NL@%
%@NL@%
  4. Return TRUE or FALSE.%@NL@%
%@NL@%
%@CR:MSE84005@%%@4@%The order above is recommended, but you do not have to follow it strictly.%@EH@%
You can perform Step 2 before Step 1. However, you must get a handle to the
current file before you can modify it.%@NL@%
%@NL@%
%@CR:MSE84006@%%@4@%Sections 8.4.1%@BO:   46181@%-8.4.9 discuss each step.%@EH@%%@NL@%
%@NL@%
%@NL@%
%@CR:MSE84100@%%@3@%%@AB@%8.4.1  Getting a File Handle%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE84101@%%@4@%The Microsoft Editor has its own file system. A "file system" is a group of%@EH@%
integrated structures and function calls for modifying files. The editor's
file system is not compatible with that of the C library.%@NL@%
%@NL@%
%@CR:MSE84102@%%@4@%The editor has its own file-handle type, %@AB@%PFILE%@AE@%. This type, along with other%@EH@%
types needed for extensions, is defined in the include file EXT.H. For
example, you can create a file handle %@AS@%pFile%@AE@% with the declaration:%@NL@%
%@NL@%
     PFILE   pFile;%@NL@%
%@NL@%
%@CR:MSE84103@%%@4@%Usually, your editing work involves the current file; that is, the file that%@EH@%
now appears in the current editing window. Because the current file is
already open for editing, you do not need to open or initialize the current
file in any way. You simply assign the existing file handle to one of your
own variables.%@NL@%
%@NL@%
%@CR:MSE84104@%%@4@%The %@AB@%FileNameToHandle%@AE@% function returns a handle to a file that is already%@EH@%
open for editing. (More than one file may be open for editing, particularly
if the user has worked on more than one file during the editing session.)%@NL@%
%@NL@%
%@CR:MSE84105@%%@4@%To get a handle to the current file, simply pass two empty strings to the%@EH@%
function:%@NL@%
%@NL@%
     pFile = FileNameToHandle( "", "" );%@NL@%
%@NL@%
%@CR:MSE84106@%%@4@%The first argument to %@AB@%FileNameToHandle%@AE@% takes a file name. The second%@EH@%
argument takes a "short name," which is a base name the editor searches for
in its list of open files. If the first string is empty, the function
returns a handle to the current file.%@NL@%
%@NL@%
%@CR:MSE84107@%%@4@%The %@AB@%AddFile%@AE@% function is the other function that returns a file handle.%@EH@%
%@AB@%AddFile%@AE@% causes the editor to open a file for editing──either a new file or a
file that exists on disk but is not yet open for editing.%@NL@%
%@NL@%
%@CR:MSE84108@%%@4@%See Chapter 9%@BO:   50fea@% for complete information on each function.%@EH@%%@NL@%
%@NL@%
%@NL@%
%@CR:MSE84200@%%@3@%%@AB@%8.4.2  Interpreting the User-Defined Argument%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE84201@%%@4@%After getting a handle to the current file, you need to interpret the%@EH@%
user-defined argument.%@NL@%
%@NL@%
%@CR:MSE84202@%%@4@%You determine the type of the user's argument by testing the value of%@EH@%
pArg->argType. If you declare a function that takes only one type of
argument, testing pArg->argType is not necessary. You know in advance what
kind of argument was given, since the editor rejects invalid arguments.
Table 8.1%@BO:   435cc@%, "Meaning of cmdTable Flags," explains how to declare what
arguments your function accepts.%@NL@%
%@NL@%
%@CR:MSE84203@%%@4@%If your function accepts more than one kind of argument, you can use either%@EH@%
if-then-else blocks or switch-case statements to evaluate the user's
argument:%@NL@%
%@NL@%
     switch( pArg->argType )%@NL@%
     {%@NL@%
        case( NULLARG ):    %@AI@%/* Take action for empty arg */%@AE@%%@NL@%
        .%@NL@%
        .%@NL@%
        .%@NL@%
        case( BOXARG ):     %@AI@%/* Take action for boxarg */%@AE@%%@NL@%
        .%@NL@%
        .%@NL@%
        .%@NL@%
        case( LINEARG ):   %@AI@%/* Take action for linearg */%@AE@%%@NL@%
        .%@NL@%
        .%@NL@%
        .%@NL@%
     }%@NL@%
%@NL@%
%@CR:MSE84204@%%@4@%The value of pArg->argType is always equal to one of six values:%@EH@%%@NL@%
%@NL@%
%@CR:MSE84205@%  ■  %@AB@%NOARG%@AE@%%@NL@%
  ■  %@AB@%NULLARG%@AE@%%@NL@%
  ■  %@AB@%TEXTARG%@AE@%%@NL@%
  ■  %@AB@%LINEARG%@AE@%%@NL@%
  ■  %@AB@%STREAMARG%@AE@%%@NL@%
  ■  %@AB@%BOXARG%@AE@%%@NL@%
%@NL@%
%@CR:MSE84206@%%@4@%The next six sections consider each of these argument types in detail,%@EH@%
giving declarations and examples for each.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE84300@%%@3@%%@AB@%8.4.3  The NOARG Type%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE84301@%%@4@%When pArg->argType is equal to %@AB@%NOARG%@AE@%, the editor passes information in the%@EH@%
pArg->arg.noarg structure, which has the format:%@NL@%
%@NL@%
     struct  noargType%@NL@%
     {%@NL@%
         LINE    y;   %@AI@%/* Line number of cursor */%@AE@%%@NL@%
         COL     x;   %@AI@%/* Column of cursor */%@AE@%%@NL@%
     };%@NL@%
%@NL@%
%@CR:MSE84302@%%@4@%%@AB@%Description%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE84303@%%@4@%The %@AB@%NOARG%@AE@% type indicates that the user did not invoke the %@AI@%Arg%@AE@% prefix, and%@EH@%
therefore did not enter an argument. The cursor coordinates are zero-based;
in other words, the start of the file is position (0,0).%@NL@%
%@NL@%
%@CR:MSE84304@%%@4@%This argument type is possible if you declared your function with the flag%@EH@%
%@AB@%NOARG%@AE@% or %@AB@%CURSORFUNC%@AE@%.%@NL@%
%@NL@%
%@CR:MSE84305@%%@4@%%@AB@%Example%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE84306@%%@4@%The following example initializes the coordinates (%@AS@%yCur%@AE@%, %@AS@%xCur%@AE@%) with the row%@EH@%
and column of the cursor position:%@NL@%
%@NL@%
     COL   xCur;%@NL@%
     LINE  yCur;%@NL@%
     .%@NL@%
     .%@NL@%
     .%@NL@%
     if( pArg->argType == NOARG )%@NL@%
     {%@NL@%
          xCur = pArg->arg.noarg.x;%@NL@%
          yCur = pArg->arg.noarg.y;%@NL@%
     }%@NL@%
%@NL@%
%@NL@%
%@CR:MSE84400@%%@3@%%@AB@%8.4.4  The NULLARG Type%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE84401@%%@4@%When pArg->argType is equal to %@AB@%NULLARG%@AE@%, the editor passes information in the%@EH@%
pArg->arg.nullarg structure, which has the format:%@NL@%
%@NL@%
     struct  nullargType%@NL@%
     {%@NL@%
         int     cArg;   %@AI@%/* Number of times Arg was invoked */%@AE@%%@NL@%
         LINE    y;      %@AI@%/* Line number of cursor */%@AE@%%@NL@%
         COL     x;      %@AI@%/* Column of cursor */%@AE@%%@NL@%
     };%@NL@%
%@NL@%
%@CR:MSE84402@%%@4@%%@AB@%Description%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE84403@%%@4@%The %@AB@%NULLARG%@AE@% type indicates that the user invoked the %@AI@%Arg%@AE@% prefix but did not%@EH@%
enter an argument. The argument is therefore empty, or null. The cursor
coordinates are zero-based; in other words, the start of the file is
position (0,0).%@NL@%
%@NL@%
%@CR:MSE84404@%%@4@%This argument type is possible if you declared your function with the flag%@EH@%
%@AB@%NULLARG%@AE@%.%@NL@%
%@NL@%
%@CR:MSE84405@%%@4@%%@AB@%Example%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE84406@%%@4@%The following example initializes the coordinates (%@AS@%yCur%@AE@%, %@AS@%xCur%@AE@%) with the row%@EH@%
and column of the cursor position, and sets %@AS@%cArg%@AE@% equal to the number of
times that the user invoked the %@AI@%Arg%@AE@% prefix:%@NL@%
%@NL@%
     COL   xCur;%@NL@%
     LINE  yCur;%@NL@%
     int   cArg;%@NL@%
     .%@NL@%
     .%@NL@%
     .%@NL@%
     if( pArg->argType == NULLARG )%@NL@%
     {%@NL@%
          xCur = pArg->arg.nullarg.x;%@NL@%
          yCur = pArg->arg.nullarg.y;%@NL@%
          cArg = pArg->arg.nullarg.cArg;%@NL@%
     }%@NL@%
%@NL@%
%@NL@%
%@CR:MSE84500@%%@3@%%@AB@%8.4.5  The TEXTARG Type%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE84501@%%@4@%When pArg->argType is equal to %@AB@%TEXTARG%@AE@%, the editor passes information in the%@EH@%
pArg->arg.textarg structure, which has the format:%@NL@%
%@NL@%
     struct  textargType%@NL@%
     {%@NL@%
         int     cArg;   %@AI@%/* Number of times Arg was invoked */%@AE@%%@NL@%
         LINE    y;      %@AI@%/* Line number of cursor */%@AE@%%@NL@%
         COL     x;      %@AI@%/* Column of cursor */%@AE@%%@NL@%
         char far *pText %@AI@%/* Pointer to textarg string */%@AE@%%@NL@%
     };%@NL@%
%@NL@%
%@CR:MSE84502@%%@4@%%@AB@%Description%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE84503@%%@4@%The %@AB@%TEXTARG%@AE@% type indicates that the user's argument defined a string of%@EH@%
text. The cursor coordinates are zero-based, and %@AS@%pText%@AE@% points to a
null-terminated string.%@NL@%
%@NL@%
%@CR:MSE84504@%%@4@%This argument type is possible if you declared your function with the flag%@EH@%
%@AB@%TEXTARG%@AE@%, %@AB@%BOXSTR%@AE@%, %@AB@%NULLEOL%@AE@%, or %@AB@%NULLEOW%@AE@%. Each of these argument types selects a
string of text in a different way (for example, %@AB@%BOXSTR%@AE@% uses a
cursor-movement argument); however, the format used for all these cases is
the same.%@NL@%
%@NL@%
%@CR:MSE84505@%%@4@%%@AB@%Example%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE84506@%%@4@%The following example initializes the coordinates (%@AS@%yCur%@AE@%, %@AS@%xCur%@AE@%) with the row%@EH@%
and column of the cursor position, and sets %@AS@%cArg%@AE@% equal to the number of
times that the user invoked the %@AI@%Arg%@AE@% prefix. Finally, the user-defined
%@AI@%textarg%@AE@% is copied into the character array %@AS@%buf%@AE@%.%@NL@%
%@NL@%
     COL   xCur;%@NL@%
     LINE  yCur;%@NL@%
     int   cArg;%@NL@%
     char  buf[BUFLEN]; .%@NL@%
     .%@NL@%
     .%@NL@%
     if( pArg->argType == TEXTARG )%@NL@%
     {%@NL@%
          xCur = pArg->arg.textarg.x;%@NL@%
          yCur = pArg->arg.textarg.y;%@NL@%
          cArg = pArg->arg.textarg.cArg;%@NL@%
          strcpy (buf, pArg->arg.textarg.pText);%@NL@%
     }%@NL@%
%@NL@%
%@NL@%
%@CR:MSE84600@%%@3@%%@AB@%8.4.6  The LINEARG Type%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE84601@%%@4@%When pArg->argType is equal to %@AB@%LINEARG%@AE@%, the editor passes information in the%@EH@%
pArg->arg.linearg structure, which has the format:%@NL@%
%@NL@%
     struct  lineargType%@NL@%
     {%@NL@%
         int     cArg;   %@AI@%/* Number of times Arg was invoked */%@AE@%%@NL@%
         LINE    yStart; %@AI@%/* Line number of first line */%@AE@%%@NL@%
         LINE    yEnd;   %@AI@%/* Line number of last line */%@AE@%%@NL@%
     };%@NL@%
%@NL@%
%@CR:MSE84602@%%@4@%%@AB@%Description%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE84603@%%@4@%The %@AB@%LINEARG%@AE@% type indicates that the user defined a range of lines by%@EH@%
aligning the cursor and arg position in the same column but different rows.
The range of lines includes %@AS@%yStart%@AE@% and %@AS@%yEnd%@AE@%, as well as all lines in
between. Line numbers are zero-based, so that line 0 is the first line in
the file.%@NL@%
%@NL@%
%@CR:MSE84604@%%@4@%This argument type is possible if you declared your function with the flag%@EH@%
%@AB@%LINEARG%@AE@%.%@NL@%
%@NL@%
%@CR:MSE84605@%%@4@%%@AB@%Example%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE84606@%%@4@%The following example sets %@AS@%cArg%@AE@% equal to the number of times that the user%@EH@%
invoked the %@AI@%Arg%@AE@% prefix, and sets %@AS@%yStart%@AE@% and %@AS@%yEnd%@AE@% equal to the line numbers
of the first and last lines:%@NL@%
%@NL@%
     int   cArg;%@NL@%
     LINE  yStart;%@NL@%
     LINE  yEnd;%@NL@%
     .%@NL@%
     .%@NL@%
     .%@NL@%
     if( pArg->argType == LINEARG )%@NL@%
     {%@NL@%
          cArg   = pArg->arg.linearg.cArg;%@NL@%
          yStart = pArg->arg.linearg.yStart;%@NL@%
          yEnd   = pArg->arg.linearg.yEnd;%@NL@%
     }%@NL@%
%@NL@%
%@NL@%
%@CR:MSE84700@%%@3@%%@AB@%8.4.7  The STREAMARG Type%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE84701@%%@4@%When pArg->argType is equal to %@AB@%STREAMARG%@AE@%, the editor passes information in%@EH@%
the pArg->arg.linearg structure, which has the format:%@NL@%
%@NL@%
     struct streamargType%@NL@%
     {%@NL@%
         int   cArg;     %@AI@%/* Number of times Arg was invoked */%@AE@%%@NL@%
         LINE  yStart;   %@AI@%/* Coordinates of first byte in */%@AE@%%@NL@%
         COL   xStart;   %@AI@%/*   the stream of text */%@AE@%%@NL@%
         LINE  yEnd;     %@AI@%/* Coordinates of byte just after */%@AE@%%@NL@%
         COL   xEnd;     %@AI@%/*   the last byte of the stream */%@AE@%%@NL@%
     };%@NL@%
%@NL@%
%@CR:MSE84702@%%@4@%%@AB@%Description%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE84703@%%@4@%The %@AB@%STREAMARG%@AE@% type indicates that the user defined a cursor-movement%@EH@%
argument, which the function interprets as a stream of text rather than as a
%@AI@%boxarg%@AE@% or %@AI@%linearg%@AE@%. The stream of text includes %@AS@%yStart%@AE@% and %@AS@%xStart%@AE@% but not
%@AS@%yEnd%@AE@% and %@AS@%xEnd%@AE@%, which gives the location of the character just to the right
of the last character in the stream.%@NL@%
%@NL@%
%@CR:MSE84704@%%@4@%This argument type is possible if you declared your function with the flag%@EH@%
%@AB@%STREAMARG%@AE@%.%@NL@%
%@NL@%
%@CR:MSE84705@%%@4@%%@AB@%Example%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE84706@%%@4@%The following example sets %@AS@%cArg%@AE@% equal to the number of times that the user%@EH@%
invoked the %@AI@%Arg%@AE@% prefix. Then the example initializes variables for the
beginning and end of the stream.%@NL@%
%@NL@%
     int   cArg;%@NL@%
     LINE  yStart;%@NL@%
     COL   xStart;%@NL@%
     LINE  yEnd;%@NL@%
     COL   xEnd;%@NL@%
     .%@NL@%
     .%@NL@%
     .%@NL@%
     if( pArg-argType == LINEARG )%@NL@%
     {%@NL@%
          cArg   = pArg->arg.streamarg.cArg;%@NL@%
          yStart = pArg->arg.streamarg.yStart;%@NL@%
          xStart = pArg->arg.streamarg.xStart;%@NL@%
          yEnd   = pArg->arg.streamarg.yEnd;%@NL@%
          xEnd   = pArg->arg.streamarg.xEnd;%@NL@%
     }%@NL@%
%@NL@%
%@NL@%
%@CR:MSE84800@%%@3@%%@AB@%8.4.8  The BOXARG Type%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE84801@%%@4@%When pArg->argType is equal to %@AB@%BOXARG%@AE@%, the editor passes information in the%@EH@%
pArg->arg.boxarg structure, which has the format:%@NL@%
%@NL@%
     struct  boxargType%@NL@%
     {%@NL@%
         int     cArg;        %@AI@%/* Number of times Arg was invoked */%@AE@%%@NL@%
         LINE    yTop;        %@AI@%/* Line number of first line */%@AE@%%@NL@%
         LINE    yBottom;     %@AI@%/* Line number of last line */%@AE@%%@NL@%
         COL     xLeft;       %@AI@%/* Leftmost column in box */%@AE@%%@NL@%
         COL     xRight;      %@AI@%/* Rightmost column in box */%@AE@%%@NL@%
     };%@NL@%
%@NL@%
%@CR:MSE84802@%%@4@%%@AB@%Description%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE84803@%%@4@%The %@AB@%BOXARG%@AE@% type indicates that the user defined a rectangular area on the%@EH@%
screen. Row and column numbers are zero-based; in other words, the start of
the file is position (0,0). The lines and column edges, %@AS@%yTop%@AE@%, %@AS@%yBottom%@AE@%,
%@AS@%xLeft%@AE@%, and %@AS@%xRight%@AE@%, are all included in the area itself.%@NL@%
%@NL@%
%@CR:MSE84804@%%@4@%This argument type is possible if you declared your function with the flag %@EH@%
%@AB@%BOXARG%@AE@%.%@NL@%
%@NL@%
%@CR:MSE84805@%%@4@%%@AB@%Example%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE84806@%%@4@%The following example sets %@AS@%cArg%@AE@% equal to the number of times that the user%@EH@%
invoked the %@AI@%Arg%@AE@% prefix. Then the example initializes variables for the four
borders of the box.%@NL@%
%@NL@%
     int   cArg;%@NL@%
     LINE  yTop;%@NL@%
     LINE  yBottom;%@NL@%
     COL   xLeft;%@NL@%
     COL   xRight;%@NL@%
     .%@NL@%
     .%@NL@%
     .%@NL@%
     if( pArg-argType == LINEARG )%@NL@%
     {%@NL@%
          cArg    = pArg->arg.boxarg.cArg;%@NL@%
          yTop    = pArg->arg.boxarg.yTop;%@NL@%
          yBottom = pArg->arg.boxarg.yBottom;%@NL@%
          xLeft   = pArg->arg.boxarg.xLeft;%@NL@%
          xRight  = pArg->arg.boxarg.xRight;%@NL@%
     }%@NL@%
%@NL@%
%@NL@%
%@CR:MSE84900@%%@3@%%@AB@%8.4.9  Modifying the Current File%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE84901@%%@4@%This section deals with the core of an editing function──reading and%@EH@%
altering the file.%@NL@%
%@NL@%
%@CR:MSE84902@%%@4@%After you have analyzed the user's argument and got a handle to the current%@EH@%
file, you are ready to work on the file. At this stage, two functions are
most relevant: %@AB@%GetLine%@AE@% and %@AB@%Putline%@AE@%.%@NL@%
%@NL@%
%@CR:MSE84903@%%@4@%The %@AB@%GetLine%@AE@% function reads one line from the file:%@EH@%%@NL@%
%@NL@%
     len = GetLine (yStart, buffer, pFile);%@NL@%
%@NL@%
%@CR:MSE84904@%%@4@%The first argument is a line number, the second a pointer to a buffer, and%@EH@%
the third a file handle. With extension functions, line numbers are
consistently indexed (they are all zero-based so that the first line in the
file is numbered 0), so you can use a line number previously passed by the
editor. The buffer is a previously declared string of characters. %@AB@%GetLine%@AE@%
fills this string with characters and a terminating null byte. Since you are
working on the current file, pass the file handle you received when you
called %@AB@%FileNameToHandle%@AE@%.%@NL@%
%@NL@%
%@CR:MSE84905@%%@4@%Finally, %@AB@%GetLine%@AE@% returns the length of the line copied.%@EH@%%@NL@%
%@NL@%
%@CR:MSE84906@%%@4@%The %@AB@%PutLine%@AE@% function is the flip side of %@AB@%GetLine%@AE@% and takes almost exactly%@EH@%
the same arguments:%@NL@%
%@NL@%
     PutLine (yStart, buffer, pFile);%@NL@%
%@NL@%
%@CR:MSE84907@%%@4@%The first argument is a zero-based line number. The second argument points%@EH@%
to a buffer containing text that you want to write to the file. The third
argument is a file handle. Again, you can use a handle to the current file.%@NL@%
%@NL@%
%@CR:MSE84908@%%@4@%Both %@AB@%GetLine%@AE@% and %@AB@%PutLine%@AE@% deal with null-terminated strings. You should not%@EH@%
add a new-line character to the string you pass to %@AB@%PutLine%@AE@%. The editor adds
or strips new-line characters as appropriate.%@NL@%
%@NL@%
%@CR:MSE84909@%%@4@%The following section of code demonstrates the use of %@AB@%GetLine%@AE@% and %@AB@%PutLine%@AE@% in%@EH@%
a loop that numbers the lines %@AS@%yStart%@AE@% to %@AS@%yEnd%@AE@%:%@NL@%
%@NL@%
     for( curLine = yStart, i = 1; curLine <= yEnd; curLine++, i++ )%@NL@%
     {%@NL@%
         GetLine( curLine, buffer, pFile ); %@AI@%/* Get line */%@AE@%%@NL@%
%@NL@%
         itoa( i, digits, 10 );             %@AI@%/* Convert i to digit string */%@AE@%%@NL@%
         strcat( digits, ". " );%@NL@%
         strcat( digits, buffer );          %@AI@%/* Prefix buffer with digits */%@AE@%%@NL@%
%@NL@%
         PutLine( curLine, digits, pFile ); %@AI@%/* Put line back */%@AE@%%@NL@%
     }%@NL@%
%@NL@%
%@NL@%
%@CR:MSE85000@%%@2@%%@AB@%8.5  Compiling and Linking%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE85001@%%@4@%After writing your C module, you're ready to compile and link. The%@EH@%
procedures for compiling and linking in protected mode are slightly
different from compiling and linking in real mode. Sections 8.5.1%@BO:   4ab20@% and
8.5.2%@BO:   4b1b6@% consider both environments.%@NL@%
%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@AI@%NOTE%@AE@%%@NL@%
   If you created C-extension modules for Version 1.0 of the Microsoft%@NL@%
   Editor, you do not have to recompile or relink your C extensions.%@NL@%
   However, if you do recompile your extensions, make sure that you use the%@NL@%
   new version of the EXT.H include file.%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@NL@%
%@CR:MSE85100@%%@3@%%@AB@%8.5.1  Compiling and Linking for Real Mode%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE85101@%%@4@%To create a C extension for real mode (DOS or the OS/2 3.%@AI@%x%@AE@% compability box),%@EH@%
follow these steps:%@NL@%
%@NL@%
%@CR:MSE85102@%  1. Compile with command line options /Gs and /Asfu. These mandatory%@NL@%
     options establish the proper memory model and calling convention. (If%@NL@%
     you are programming in the Microsoft Macro Assembler (MASM), use near%@NL@%
     code and far data segments, in which SS is not assumed equal to DS.)%@NL@%
     For example:%@NL@%
%@NL@%
         %@AS@%CL /c /Gs /Asfu myext.c%@AE@%%@NL@%
%@NL@%
  2. Link the file EXTHDR.OBJ to your extension. The EXTHDR.OBJ file must be%@NL@%
     the first object module on the command line:%@NL@%
%@NL@%
         %@AS@%CL /AC /Femyext.mxt exthdr myext%@AE@%%@NL@%
%@NL@%
     Use the /AC option if your extension calls C library functions. The /AC%@NL@%
     option directs the linker to use the compact-model library.%@NL@%
%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@AI@%IMPORTANT%@AE@%%@NL@%
   Strictly speaking, the .MXT file extension is not required; the editor%@NL@%
   can load modules with any file extension name. However, using a file%@NL@%
   extension of .MXT is strongly recommended so that your extensions are not%@NL@%
   confused with true executable (.EXE) files, which can be run directly%@NL@%
   from DOS. Trying to execute an extension as if it were an .EXE file will%@NL@%
   bring the system to its knees.%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@NL@%
%@CR:MSE85200@%%@3@%%@AB@%8.5.2  Compiling and Linking for Protected Mode%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE85201@%%@4@%To create a C extension for protected mode, follow these steps:%@EH@%%@NL@%
%@NL@%
%@CR:MSE85202@%  1. Compile with command-line options /Gs and /Asfu. These mandatory%@NL@%
     options establish the proper memory model and calling convention. (If%@NL@%
     you are programming in MASM, use near code and far data segments in%@NL@%
     which SS is not assumed equal to DS.) For example:%@NL@%
%@NL@%
          %@AS@%CL /c /Gs /Asfu myext.c%@AE@%%@NL@%
%@NL@%
     The same object module can be used for both real and protected mode, so%@NL@%
     you do not have to recompile if you want an extension for both modes.%@NL@%
     However, you do have to relink, as explained below.%@NL@%
%@NL@%
  2. Link with the file EXTHDRP.OBJ to your extension along with a%@NL@%
     module-definitions file. The EXTHDRP.OBJ file must be the first object%@NL@%
     module on the command line:%@NL@%
%@NL@%
          %@AS@%LINK /NOI exthdrp myext, myext.dll,, doscalls, myext.def;%@AE@%%@NL@%
%@NL@%
     If your extension calls C library functions, link in the compact-model%@NL@%
     library. Link with the /NOI option, since the OS/2 loader is%@NL@%
     case-sensitive.%@NL@%
%@NL@%
%@CR:MSE85203@%%@4@%The file MYEXT.DEF can be created by copying the file SKEL.DEF (provided%@EH@%
with the editor). No modification is necessary. You can also link with
SKEL.DEF itself.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE85300@%%@3@%%@AB@%8.5.3  Loading Your Extension%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE85301@%%@4@%Compiling and linking your module with the correct options produces an .MXT%@EH@%
file (for real mode) or a .DLL file (for OS/2 protected mode) the editor can
load and execute on demand.%@NL@%
%@NL@%
%@CR:MSE85302@%%@4@%To use a real-mode extension, set the %@AB@%load%@AE@% switch with the full path name%@EH@%
for your C extension. For example, after you have created the file
MYEXT.MXT, you could place the following statement in the TOOLS.INI file:%@NL@%
%@NL@%
     load:%@AI@%path%@AE@%\myext.mxt%@NL@%
%@NL@%
%@CR:MSE85303@%%@4@%in which %@AI@%path%@AE@% is the location of the extension. The editor responds by%@EH@%
automatically loading your C-extension module into memory upon start-up. You
can also set the %@AB@%load%@AE@% switch with the %@AI@%Assign%@AE@% command.%@NL@%
%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@AI@%NOTE%@AE@%%@NL@%
   The load switch can be assigned a number of times, each assignment%@NL@%
   causing the editor to load another extension. All of the extensions%@NL@%
   reside in memory together; no extension is removed from memory until the%@NL@%
   editor terminates.%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@CR:MSE85304@%%@4@%The load switch can accept an environment variable as described in Section%@EH@%
7.3%@BO:   3a7a5@%, "Special Syntax for Text Switches."%@NL@%
%@NL@%
%@CR:MSE85305@%%@4@%To use a protected-mode extension, place your .DLL file in a directory%@EH@%
specified in the LIBPATH variable. You can set the load switch in the same
way described above; however, when running under protected mode, the editor
ignores the %@AI@%path%@AE@% and the file extension. Therefore, for protected-mode-only
extensions, the only declaration you need is the following:%@NL@%
%@NL@%
     load:myext%@NL@%
%@NL@%
%@CR:MSE85306@%%@4@%To load an extension for both real and protected modes, follow these steps:%@EH@%%@NL@%
%@NL@%
%@CR:MSE85307@%  1. Compile the source file once.%@NL@%
%@NL@%
  2. Link two times, once for real mode and once for protected mode.%@NL@%
%@NL@%
  3. Place the protected-mode module (a .DLL file) in a LIBPATH directory.%@NL@%
%@NL@%
  4. Use the real-mode %@AB@%load%@AE@% setting. The editor uses the full text of the%@NL@%
     switch setting when in real mode, but ignores the path and file%@NL@%
     extension when in protected mode.%@NL@%
%@NL@%
%@CR:MSE85308@%%@4@%Whenever the editor successfully loads an extension, it checks the TOOLS.INI%@EH@%
file for the tag%@NL@%
%@NL@%
     %@AB@%[M-%@AE@%%@AI@%mxt%@AE@%%@AB@%]%@AE@%%@NL@%
%@NL@%
%@CR:MSE8530A@%%@4@%in which %@AI@%mxt%@AE@% is the base name of the extension. If the tag exists, the%@EH@%
editor recognizes the settings immediately following the tag.%@NL@%
%@NL@%
%@CR:MSE85310@%%@4@%%@AB@%Special Considerations for OS/2%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE85311@%%@4@%Under OS/2 Version 1.1 and later, protected-mode editor extensions may have%@EH@%
file extensions other than .DLL and may be placed in directories other than
those specified in LIBPATH. The editor searches for the extensions specified
in the %@AB@%load%@AE@% statement in the following sequence:%@NL@%
%@NL@%
%@CR:MSE85312@%  1. If an environment variable or a full path is specified, the editor%@NL@%
     searches the appropriate directories, as in the following examples:%@NL@%
%@NL@%
         load:$LIB:yourext.mxt%@NL@%
%@NL@%
         load:drive:\dir\ yourext.mxt%@NL@%
%@NL@%
     The editor searches the current directory if there is no environment%@NL@%
     variable or full-path specification.%@NL@%
%@NL@%
  2. If the desired extension is not found, and its name is only a base name%@NL@%
     without a file extension, the editor appends the appropriate file%@NL@%
     extension (.MXT for real mode, .PXT for protected mode) and repeats%@NL@%
     Step 1.%@NL@%
%@NL@%
  3. If the editor extension still cannot be located, the editor searches%@NL@%
     for %@AI@%basename%@AE@%.DLL in the directories specified in LIBPATH, where%@NL@%
     %@AI@%basename%@AE@% is the base name of the extension.%@NL@%
%@NL@%
%@CR:MSE85313@%%@4@%In real mode (DOS or the OS/2 3.%@AI@%x%@AE@% compatibility box), only Steps 1 and 2 are%@EH@%
preformed. Under OS/2 Version 1.0, only Step 3 is performed.%@NL@%
%@NL@%
%@CR:MSE85314@%%@4@%Within TOOLS.INI tag declarations, only the base name is significant, not%@EH@%
the file extension. For example, the statements following%@NL@%
%@NL@%
     [M-YOUREXT]%@NL@%
%@NL@%
%@CR:MSE85315@%%@4@%would always be used, regardless of the file extension that was used to%@EH@%
locate YOUREXT.%@NL@%
%@NL@%
%@CR:MSE85316@%%@4@%The "autoload" feature automatically loads extensions without a %@AB@%load%@AE@%%@EH@%
statement in TOOLS.INI. The editor searches the directories in the PATH
environment variable for file names with the following patterns, and loads
as many of them as it finds:%@NL@%
%@NL@%
%@CR:MSE85317@%%@AB@%Operating System            Extension Autoloaded%@AE@%%@NL@%
%@NL@%
DOS or OS/2 real mode       M*.MXT%@NL@%
%@NL@%
OS/2 protected mode         M*.PXT%@NL@%
%@NL@%
%@CR:MSE85318@%%@4@%The file names for the on-line Help extensions supplied with this version of%@EH@%
the Microsoft Editor have the correct form for autoloading. Therefore, they
only need to be placed in any directory in the PATH environment variable;
you do not have to add a %@AB@%load%@AE@% statement to TOOLS.INI.%@NL@%
%@NL@%
%@CR:MSE85319@%%@4@%Autoloading occurs after TOOLS.INI has been read, so any extension-specific%@EH@%
sections still take effect.%@NL@%
%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@AI@%NOTE%@AE@%%@NL@%
   Autoloading does not work under OS/2 Version 1.0.%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@CR:MSE8531A@%%@4@%You can load extensions in both real and protected mode by using a single%@EH@%
%@AB@%load%@AE@% statement of the following form:%@NL@%
%@NL@%
     load:$PATH:%@AI@%basename%@AE@%%@NL@%
%@NL@%
%@CR:MSE8531B@%%@4@%The extensions must have the same %@AI@%basename%@AE@% and the default extension (.MXT%@EH@%
for DOS or OS/2 real mode, .PXT for OS/2 protected mode) for the appropriate
operating system. The extensions can go anywhere in the specified path.
Since the file extension is omitted in this %@AB@%load%@AE@% statement, the editor will
append the appropriate extension to %@AI@%basename%@AE@% (be sure the name has no
trailing period) and load the correct file.%@NL@%
%@NL@%
%@CR:MSE8531C@%%@4@%You can also give your extension a name of the form M*.MXT or M*.PXT%@EH@%
(according to the operating system). The extension will be autoloaded
without requiring a %@AB@%load%@AE@% statement in TOOLS.INI. It is also possible to
specify the editor extension for one mode in a %@AB@%load%@AE@% statement, while giving
the extension for the other mode an autoload default name.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE86000@%%@2@%%@AB@%8.6  A C-Extension Sample Program%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE86001@%%@4@%The following C-extension sample program features a function named %@AS@%tglcase%@AE@%.%@EH@%
This function converts uppercase letters to lowercase, and lowercase letters
to uppercase. It acts on the file according to the argument type:%@NL@%
%@NL@%
%@CR:MSE86002@%%@AB@%Argument                    Effect%@AE@%%@NL@%
%@NL@%
%@AB@%NOARG%@AE@%                       Acts on entire current line.%@NL@%
%@NL@%
%@AB@%NULLARG%@AE@%                     Acts on current line, from the cursor position%@NL@%
                            (inclusive) up to the end of the line.%@NL@%
%@NL@%
%@AB@%BOXARG%@AE@%                      Acts on the highlighted region.%@NL@%
%@NL@%
%@AB@%LINEARG%@AE@%                     Acts on the highlighted region (containing a%@NL@%
                            range of complete lines).%@NL@%
%@NL@%
%@AB@%TEXTARG%@AE@%                     Argument not accepted.%@NL@%
%@NL@%
%@AB@%STREAMARG%@AE@%                   Not recognized. The argument is treated as %@AB@%%@AE@%%@NL@%
                            %@AB@%BOXARG%@AE@% or %@AB@%LINEARG%@AE@%.%@NL@%
%@NL@%
%@CR:MSE86003@%%@4@%In each case, the function responds to the argument by initializing the%@EH@%
limits of an imaginary box. In the case of a %@AB@%LINEARG%@AE@%, the column limits are
set at 0 and BUFLEN (the maximum length of a text line in M). %@AB@%NOARG%@AE@% and
%@AB@%NULLARG%@AE@% are handled in a similar fashion. Once the limits of the area are
initialized, one small section of code does the actual work. This section
calls %@AB@%GetLine%@AE@% and %@AB@%PutLine%@AE@% repeatedly to read and replace lines in the
current file.%@NL@%
%@NL@%
%@CR:MSE86004@%%@4@%This extension calls C library functions. To successfully link this%@EH@%
extension, include the compact-model library.%@NL@%
%@NL@%
     %@AI@%/*** tglcase.c - case toggling editor extension%@AE@%%@NL@%
     %@AI@%*/%@AE@%%@NL@%
     #define ID      " tglcase ver 1.00 "##__DATE__##" "##__TIME__%@NL@%
     #define NULL    ((void *) 0)%@NL@%
%@NL@%
     #include <stdlib.h>                     %@AI@%/* min macro definition */%@AE@%%@NL@%
     #include <string.h>                     %@AI@%/* prototypes for string fcns*/%@AE@%%@NL@%
     #include "ext.h"%@NL@%
     %@AI@%/*%@AE@%%@NL@%
     %@AI@%** Internal function prototypes%@AE@%%@NL@%
     %@AI@%*/%@AE@%%@NL@%
     void     pascal          id         (char *);%@NL@%
     void     WhenLoaded (void);%@NL@%
     flagType pascal EXPORT tglcase    (unsigned int, ARG far *, flagType);%@NL@%
%@NL@%
     %@AI@%/********************************************************************%@AE@%%@NL@%
     %@AI@%**%@AE@%%@NL@%
     %@AI@%** tglcase%@AE@%%@NL@%
     %@AI@%** Toggle the case of alphabetics contained within the selected argument:%@AE@%%@NL@%
     %@AI@%**%@AE@%%@NL@%
     %@AI@%**  NOARG       - Toggle case of entire current line%@AE@%%@NL@%
     %@AI@%**  NULLARG     - Toggle case of current line from cursor to end of line%@AE@%%@NL@%
     %@AI@%**  LINEARG     - Toggle case of range of lines%@AE@%%@NL@%
     %@AI@%**  BOXARG      - Toggle case of characters with the selected box%@AE@%%@NL@%
     %@AI@%**  NUMARG      - Converted to LINEARG before extension is called%@AE@%%@NL@%
     %@AI@%**  MARKARG     - Converted to Appropriate ARG form above before extension is%@AE@%%@NL@%
     %@AI@%**                called%@AE@%%@NL@%
     %@AI@%**%@AE@%%@NL@%
     %@AI@%**  STREAMARG   - Not Allowed; treated as BOXARG%@AE@%%@NL@%
     %@AI@%**  TEXTARG     - Not Allowed%@AE@%%@NL@%
     %@AI@%**%@AE@%%@NL@%
     %@AI@%*/%@AE@%%@NL@%
     flagType pascal EXTERNAL tglcase (argData, pArg, fMeta)%@NL@%
     unsigned int argData;                   %@AI@%/* keystroke invoked with */%@AE@%%@NL@%
     ARG far *pArg;                          %@AI@%/* argument data */%@AE@%%@NL@%
     flagType fMeta;                         %@AI@%/* indicates preceded by meta */%@AE@%%@NL@%
     {%@NL@%
         PFILE   pFile;                  %@AI@%/* file handle of current file */%@AE@%%@NL@%
         COL     xStart;                 %@AI@%/* left border of arg area */%@AE@%%@NL@%
         LINE    yStart;                 %@AI@%/* starting line of arg area */%@AE@%%@NL@%
         COL     xEnd;                   %@AI@%/* right border of arg area */%@AE@%%@NL@%
         LINE    yEnd;                   %@AI@%/* ending line of arg area */%@AE@%%@NL@%
         int     cbLine;                 %@AI@%/* byte count of current line */%@AE@%%@NL@%
         COL     xCur;                   %@AI@%/* current column being toggled */%@AE@%%@NL@%
         char    buf[BUFLEN];            %@AI@%/* buffer for line being toggled*/%@AE@%%@NL@%
         register char c;                %@AI@%/* character being analyzed */%@AE@%%@NL@%
%@NL@%
         id( "" );%@NL@%
         pFile = FileNameToHandle( "", NULL );%@NL@%
         switch( pArg->argType )%@NL@%
         {%@NL@%
     %@AI@%/*%@AE@%%@NL@%
     %@AI@%** For the various argument types, set up a box%@AE@%%@NL@%
     %@AI@%** (xStart, yStart) - (xEnd, yEnd)%@AE@%%@NL@%
     %@AI@%** over which the case conversion code below can operate%@AE@%%@NL@%
     %@AI@%*/%@AE@%%@NL@%
             case NOARG:                         %@AI@%/* case switch entire line */%@AE@%%@NL@%
                 xStart = 0;%@NL@%
                 xEnd = BUFLEN;%@NL@%
                 yStart = yEnd = pArg->arg.noarg.y;%@NL@%
                 break;%@NL@%
%@NL@%
             case NULLARG:                       %@AI@%/* case switch to EOL */%@AE@%%@NL@%
                 xStart = pArg->arg.nullarg.x;%@NL@%
                 xEnd = BUFLEN;%@NL@%
                 yStart = yEnd = pArg->arg.nullarg.y;%@NL@%
                 break;%@NL@%
%@NL@%
             case LINEARG:                       %@AI@%/* case switch line range */%@AE@%%@NL@%
                 xStart = 0;%@NL@%
                 xEnd = BUFLEN;%@NL@%
                 yStart = pArg->arg.linearg.yStart;%@NL@%
                 yEnd = pArg->arg.linearg.yEnd;%@NL@%
                 break;%@NL@%
%@NL@%
             case BOXARG:                        %@AI@%/* case switch box */%@AE@%%@NL@%
                 xStart = pArg->arg.boxarg.xLeft;%@NL@%
                 xEnd   = pArg->arg.boxarg.xRight;%@NL@%
                 yStart = pArg->arg.boxarg.yTop;%@NL@%
                 yEnd   = pArg->arg.boxarg.yBottom;%@NL@%
                 break;%@NL@%
         }%@NL@%
     %@AI@%/*%@AE@%%@NL@%
     %@AI@%** Within range of lines yStart to yEnd, get each line, and if non-null,%@AE@%%@NL@%
     %@AI@%** check each character. If alphabetic, replace with its case-converted%@AE@%%@NL@%
     %@AI@%** value. After all characters have been checked, replace line in file.%@AE@%%@NL@%
     %@AI@%*/%@AE@%%@NL@%
         while( yStart <= yEnd )%@NL@%
         {%@NL@%
          if( cbLine = GetLine( yStart, buf, pFile ))%@NL@%
             {%@NL@%
              for( xCur = xStart; (xCur <= min( cbLine, xEnd )); xCur++ )%@NL@%
                 {%@NL@%
                     c = buf[xCur];%@NL@%
               if( (c >= 'A' ) && (c <= 'Z'))%@NL@%
                         c += 'a'-'A';%@NL@%
               else if( (c >= 'a' ) && (c <= 'z'))%@NL@%
                         c += 'A'-'a';%@NL@%
                     buf[xCur] = c;%@NL@%
                 }%@NL@%
              PutLine( yStart++, buf, pFile );%@NL@%
             }%@NL@%
         }%@NL@%
         return 1;%@NL@%
     }%@NL@%
     %@AI@%/*************************************************************************%@AE@%%@NL@%
     %@AI@%**%@AE@%%@NL@%
     %@AI@%** WhenLoaded%@AE@%%@NL@%
     %@AI@%** Executed when extension gets loaded. Identify self & assign default%@AE@%%@NL@%
     %@AI@%** keystroke.%@AE@%%@NL@%
     %@AI@%**%@AE@%%@NL@%
     %@AI@%** Entry:%@AE@%%@NL@%
     %@AI@%**  none%@AE@%%@NL@%
     %@AI@%*/%@AE@%%@NL@%
     void WhenLoaded ()%@NL@%
     {%@NL@%
     id("case conversion extension:");%@NL@%
     SetKey ("tglcase",  "alt+c");%@NL@%
     } %@AI@%/* end WhenLoaded */%@AE@%%@NL@%
%@NL@%
     %@AI@%/*************************************************************************%@AE@%%@NL@%
     %@AI@%**%@AE@%%@NL@%
     %@AI@%** id%@AE@%%@NL@%
     %@AI@%** identify ourselves, along with any passed informative message%@AE@%%@NL@%
     %@AI@%**%@AE@%%@NL@%
     %@AI@%** Entry:%@AE@%%@NL@%
     %@AI@%**  pszMsg      = Pointer to asciiz message to which the extension name%@AE@%%@NL@%
     %@AI@%**                and version are appended prior to display%@AE@%%@NL@%
     %@AI@%*/%@AE@%%@NL@%
     void pascal id (pszFcn)%@NL@%
     char *pszFcn;                                   %@AI@%/* function name */%@AE@%%@NL@%
     {%@NL@%
         char    buf[80];                                %@AI@%/* message buffer */%@AE@%%@NL@%
%@NL@%
         strcpy (buf,pszFcn);                    %@AI@%/* start with message */%@AE@%%@NL@%
         strcat (buf,ID);                                %@AI@%/* append version */%@AE@%%@NL@%
         DoMessage (buf);%@NL@%
     } %@AI@%/* end id */%@AE@%%@NL@%
%@NL@%
%@NL@%
     %@AI@%/*************************************************************************%@AE@%%@NL@%
     %@AI@%**%@AE@%%@NL@%
     %@AI@%** Switch communication table to the editor%@AE@%%@NL@%
     %@AI@%** This extension defines no switches%@AE@%%@NL@%
     %@AI@%*/%@AE@%%@NL@%
     struct swiDesc  swiTable[] =%@NL@%
     {%@NL@%
         { NULL, NULL, 0 }%@NL@%
     };%@NL@%
%@NL@%
     %@AI@%/*************************************************************************%@AE@%%@NL@%
     %@AI@%**%@AE@%%@NL@%
     %@AI@%** Command communication table to the editor%@AE@%%@NL@%
     %@AI@%** Defines the name, location and acceptable argument types%@AE@%%@NL@%
     %@AI@%*/%@AE@%%@NL@%
     struct cmdDesc  cmdTable[] =%@NL@%
     {%@NL@%
         {"tglcase",tglcase,0, KEEPMETA | NOARG | BOXARG | NULLARG | LINEARG%@NL@%
     |%@NL@%
                               MARKARG | NUMARG | MODIFIES},%@NL@%
         { NULL, NULL, 0, 0 }%@NL@%
     };%@NL@%
%@NL@%
%@NL@%
%@CR:MSE87000@%%@2@%%@AB@%8.7  Calling Library Functions%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE87001@%%@4@%This section lists compatible C library functions as well as low-level%@EH@%
extension functions you can call.%@NL@%
%@NL@%
%@CR:MSE87002@%%@4@%You should call the editor's own low-level functions in preference to%@EH@%
functions in the standard C library whenever possible. Using the editor's
low-level functions guarantees that all file operations are compatible with
the editor.%@NL@%
%@NL@%
%@CR:MSE87003@%%@4@%Furthermore, not all functions in the C library are compatible with%@EH@%
extensions. The following list summarizes which functions from the
compact-model library should work when called by a C-extension module. Link
with a compact-memory-model C library if you want to call these functions.
The list refers to the function categories from Chapter 4%@BO:   120e2@% of the %@AI@%Microsoft C%@AE@%
%@AI@%Optimizing Compiler Run-Time Library Reference%@AE@% (Version 4.0 or later).%@NL@%
%@NL@%
%@CR:MSE87004@%%@4@%Note that floating-point arithmetic is not supported because it involves%@EH@%
calls to low-level, floating-point math routines.%@NL@%
%@CR:MSE87005@%%@NL@%
%@TH:   42   1423  2 28 48 @%
%@AB@%Category                    Compatible Functions%@AE@%

Buffer manipulation         All functions can be called.

Character                   All functions can be called.
classification and
conversion

Data conversion             All functions can be called except %@AB@%strtod%@AE@%.

Directory control           All functions can be called except %@AB@%getcwd%@AE@%.

Graphics                    None.

File handling               All functions can be called.

Stream routines             None.

Low-level I/O routines      None.

Console and port I/O        All functions can be called except %@AB@%cgets%@AE@%,
                            %@AB@%cprintf%@AE@%, and %@AB@%cscanf%@AE@%.

Math                        None.

Memory allocation           None.

Process control             None.

Searching and sorting       All functions can be called except %@AB@%qsort%@AE@%.

String manipulation         All functions can be called except %@AB@%strdup%@AE@%.

BIOS interface              All functions can be called.

MS-DOS interface            All functions can be called except %@AB@%int86%@AE@% and
                            %@AB@%int86x%@AE@%.

Time                        None.

Miscellaneous               All functions can be called except %@AB@%assert%@AE@%,
                            %@AB@%getenv%@AE@%, %@AB@%perror%@AE@%, %@AB@%putenv%@AE@%, and %@AB@%_searchenv%@AE@%.
%@TE:   42   1423  2 28 48 @%
%@NL@%
%@CR:MSE87006@%%@4@%Table 8.2%@BO:   505ed@% lists the low-level extension functions by category. Your%@EH@%
extension can call any of these functions. The next chapter gives an
alphabetical reference to all of the functions, including declarations and
examples.%@NL@%
%@NL@%
%@CR:MSE8T200@%%@4@%%@AU@%Table 8.2  Summary of Extension Functions by Category%@AE@%%@EH@%%@NL@%
%@NL@%
%@TH:   38   2405  1 19 20 37 @%
%@AB@%Category           Functions           Description%@AE@%

File Handle        AddFile             Opens new file and gets file handle
                   %@AB@%FileNameToHandle%@AE@%    Gets handle to already opened file
                   %@AB@%Remove File%@AE@%         Removes file structure from memory

Line-Oriented      %@AB@%FileLength%@AE@%          Returns number of lines in file
                   %@AB@%GetLine%@AE@%             Gets contents of one line
                   %@AB@%PutLine%@AE@%             Replaces a line

Cursor             %@AB@%GetCursor%@AE@%           Gets cursor position
                   %@AB@%MoveCur%@AE@%             Moves cursor to new location

Display            %@AB@%BadArg%@AE@%              Reports that argument was invalid
                   %@AB@%Display%@AE@%             Forces immediate update of screen
                   %@AB@%DoMessage%@AE@%           Puts message on the dialog line

File-Oriented      %@AB@%DelFile%@AE@%             Deletes contents of a file buffer
                   %@AB@%FileRead%@AE@%            Copies disk file to file buffer
                   %@AB@%FileWrite%@AE@%           Copies file buffer to disk file
                   %@AB@%pFileToTop%@AE@%          Makes specified file the current file

Block Operations   %@AB@%CopyBox%@AE@%             Inserts rectangular area
                   %@AB@%CopyLine%@AE@%            Inserts range of lines
                   %@AB@%CopyStream%@AE@%          Inserts stream of text
                   %@AB@%DelBox%@AE@%              Deletes rectangular area
                   %@AB@%DelLine%@AE@%             Deletes range of lines
                   %@AB@%DelStream%@AE@%           Deletes stream of text

Keyboard           %@AB@%KbHook%@AE@%              Restores keyboard control to M
                   %@AB@%KbUnHook%@AE@%            Removes keyboard control from M
                   %@AB@%ReadChar%@AE@%            Returns information on next keystroke
                   %@AB@%ReadCmd%@AE@%             Returns keystroke info in %@AB@%CmdDesc%@AE@%
                                       format

Miscellaneous      %@AB@%fExecute%@AE@%            Executes a macro
                   %@AB@%Replace%@AE@%             Replaces one character in a file
                   %@AB@%SetKey%@AE@%              Assigns a function to a keystroke
%@TE:   38   2405  1 19 20 37 @%
%@NL@%
%@NL@%
%@CR:MSE90000@%%@1@%%@AB@%Chapter 9  C-Extension Functions%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@CR:MSE90001@%%@4@%Most of the real work of an extension is done by the editor. Your extension%@EH@%
provides program logic and decision making. Yet it relies on the editor to
interact with the environment. Specifically, an extension calls low-level
functions within the editor itself to alter a file, update the screen, read
keyboard input, and perform many other useful functions.%@NL@%
%@NL@%
%@CR:MSE90002@%%@4@%This chapter describes these low-level functions in alphabetical order. Most%@EH@%
descriptions contain a summary, description, return value, cross-reference
("See Also"), and example. The summary is a description of syntax, showing
you the number and type of arguments to give when calling the function. The
description explains the effects of the function and gives further
information about arguments. The return value typically indicates whether or
not the function was successful. In addition, some functions return a file
handle or a length.%@NL@%
%@NL@%
%@CR:MSE90003@%%@4@%Finally, the cross-reference refers you to other functions that you may need%@EH@%
to use in combination with the function described. For example, many
functions cannot be performed unless you first call the %@AB@%FileNameToHandle%@AE@%
function.%@NL@%
%@NL@%
%@CR:MSE90004@%%@4@%For a topical listing of these functions, see Table 8.2%@BO:   505ed@% in the previous%@EH@%
chapter.%@NL@%
%@NL@%
%@NL@%
%@CR:MSE9R010@%%@3@%%@AB@%AddFile%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Summary%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R011@%%@AB@%#include <ext.h>%@AE@%%@NL@%
%@NL@%
     %@AB@%PFILE pascal AddFile%@AE@% (%@AI@%p%@AE@%)%@NL@%
     %@AB@%char far%@AE@% *%@AI@%p%@AE@%;%@NL@%
%@NL@%
%@4@%%@AB@%■  Description%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R012@%%@4@%The %@AB@%AddFile%@AE@% function opens a file for editing. The parameter %@AI@%p%@AE@% points to a%@EH@%
null-terminated string of text containing the name of the file to open.%@NL@%
%@NL@%
%@CR:MSE9R013@%%@4@%The file can be new or one that currently exists on disk; however, the file%@EH@%
should not already be open for editing. Therefore, to open an existing file,
first check to see if it is already open by calling %@AB@%FileNameToHandle%@AE@%.%@NL@%
%@NL@%
%@CR:MSE9R014@%%@4@%After you open an existing file, you should immediately call the %@AB@%FileRead%@AE@%%@EH@%
function to properly initialize the internal file buffer. If you open a new
file, the file will not be added to the disk until you call %@AB@%FileWrite%@AE@%.%@NL@%
%@NL@%
%@4@%%@AB@%■  Return value%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R015@%%@4@%The function returns a handle to the file.%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  See also%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R016@%%@4@%%@AB@%FileNameToHandle%@AE@%, %@AB@%FileRead%@AE@%, %@AB@%FileWrite%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Example%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R017@%%@4@%The following example checks to see if the file MYDATA.FIL is currently open%@EH@%
for editing; if not, %@AB@%AddFile%@AE@% is called to open the file. In either case, the
file handle is assigned to pFile.%@NL@%
%@NL@%
     char *p = "MYDATA.FIL";%@NL@%
%@NL@%
     if( (pFile = FileNameToHandle( p, NULL )) == 0 )%@NL@%
     {%@NL@%
          pFile = AddFile( p );%@NL@%
          FileRead( p, pFile );%@NL@%
     }%@NL@%
%@NL@%
%@NL@%
%@CR:MSE9R020@%%@3@%%@AB@%BadArg%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Summary%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R021@%%@AB@%#include <ext.h>%@AE@%%@NL@%
%@NL@%
     %@AB@%flagType pascal BadArg%@AE@% (%@AB@%void%@AE@%)%@NL@%
%@NL@%
%@4@%%@AB@%■  Description%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R022@%%@4@%The %@AB@%BadArg%@AE@% function reports an error message stating that the user's%@EH@%
argument is invalid. Usually you do not need to call this function because
the editor looks at the type of your function as declared in %@AB@%cmdTable%@AE@% and
rejects commands with the wrong argument type.%@NL@%
%@NL@%
%@CR:MSE9R023@%%@4@%This function is primarily useful if your editing function does some%@EH@%
additional tests for valid input, beyond argument type. For example, you may
want to exclude each %@AI@%numarg%@AE@% larger than a certain value.%@NL@%
%@NL@%
%@4@%%@AB@%■  Return value%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R024@%%@4@%The function does not return a value.%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  See also%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R025@%%@AB@%DoMessage%@AE@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Example%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R026@%%@4@%The following example causes the editor to report an invalid-argument%@EH@%
message if the range of lines is greater than 10. Normally this condition is
not an error, but you may want to write a function that restricts the size
of an argument.%@NL@%
%@NL@%
     if( yEnd > yStart == 10 )%@NL@%
     {%@NL@%
         BadArg( );%@NL@%
         return 0;%@NL@%
     }%@NL@%
%@NL@%
%@NL@%
%@CR:MSE9R030@%%@3@%%@AB@%CopyBox%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Summary%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R031@%%@AB@%#include <ext.h>%@AE@%%@NL@%
%@NL@%
     %@AB@%void pascal CopyBox%@AE@% (%@AI@%pFileSrc%@AE@%, %@AI@%pFileDst%@AE@%, %@AI@%xLeft%@AE@%, %@AI@%yTop%@AE@%, %@AI@%xRight%@AE@%, %@AI@%yBottom%@AE@%, %@AI@%xDst%@AE@%, %@AI@%yDst%@AE@%)%@NL@%
     %@AB@%PFILE%@AE@% %@AI@%pFileSrc%@AE@%, %@AI@%pFileDst%@AE@%;%@NL@%
     %@AB@%COL%@AE@% %@AI@%xLeft%@AE@%, %@AI@%xRight%@AE@%, %@AI@%xDst%@AE@%;%@NL@%
     %@AB@%LINE%@AE@% %@AI@%yTop%@AE@%, %@AI@%yBottom%@AE@%, %@AI@%yDst%@AE@%;%@NL@%
%@NL@%
%@4@%%@AB@%■  Description%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R032@%%@4@%The %@AB@%CopyBox%@AE@% function copies the box delimited by the edges %@AI@%xLeft%@AE@%, %@AI@%yTop%@AE@%,%@EH@%
%@AI@%xRight%@AE@%, and %@AI@%yBottom%@AE@% in the source file and inserts this box just before
position (%@AI@%xDst%@AE@%, %@AI@%yDst%@AE@%) in the destination file. If the %@AI@%pFileSrc%@AE@% is null (0),
the function inserts a box of blank spaces of the size implied by the
coordinate parameters.%@NL@%
%@NL@%
%@CR:MSE9R033@%%@4@%The parameters %@AI@%pFileSrc%@AE@% and %@AI@%pFileDst%@AE@% are handles to the source and%@EH@%
destination files. The parameters %@AI@%xLeft%@AE@%, %@AI@%xRight%@AE@%, %@AI@%yTop,%@AE@% and %@AI@%yBottom%@AE@% specify
the boundaries of the box, inclusive, of the text to be copied. The text is
inserted into the destination file just before the location specified by
%@AI@%xDst, yDst%@AE@%.%@NL@%
%@NL@%
%@CR:MSE9R034@%%@4@%The same file can serve as source and destination. However, in that case the%@EH@%
source and destination regions must not overlap.%@NL@%
%@NL@%
%@CR:MSE9R035@%%@4@%All coordinates in lower-level functions are zero based.%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Return value%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R036@%%@4@%The function does not return a value.%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  See also%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R037@%%@4@%%@AB@%CopyBox%@AE@%, %@AB@%CopyLine%@AE@%, %@AB@%CopyStream%@AE@%, %@AB@%FileNameToHandle%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Example%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R038@%%@4@%The following example copies a box from the file A.TXT and inserts this%@EH@%
region into the file B.TXT:%@NL@%
%@NL@%
     pAFILE = FileNameToHandle( "A.TXT", NULL );%@NL@%
     pBFILE = FileNameToHandle( "B.TXT", NULL );%@NL@%
     .%@NL@%
     .%@NL@%
     .%@NL@%
     CopyBox( pAFILE, pBFILE, Left, Top, Right, End, xBFILE, yBFILE );%@NL@%
%@NL@%
%@NL@%
%@CR:MSE9R040@%%@3@%%@AB@%CopyLine%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Summary%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R041@%%@AB@%#include <ext.h>%@AE@%%@NL@%
%@NL@%
     %@AB@%void pascal CopyLine%@AE@% (%@AI@%pFileSrc%@AE@%, %@AI@%pFileDst%@AE@%, %@AI@%yStart%@AE@%, %@AI@%yEnd%@AE@%, %@AI@%yDst%@AE@%)%@NL@%
     %@AB@%PFILE%@AE@% %@AI@%pFileSrc%@AE@%, %@AI@%pFileDst%@AE@%;%@NL@%
     %@AB@%LINE%@AE@% %@AI@%yStart%@AE@%, %@AI@%yEnd%@AE@%, %@AI@%yDst%@AE@%;%@NL@%
%@NL@%
%@4@%%@AB@%■  Description%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R042@%%@4@%The %@AB@%CopyLine%@AE@% function can be used either to copy a group of lines from one%@EH@%
region to another or to insert a blank line.%@NL@%
%@NL@%
%@CR:MSE9R043@%%@4@%The %@AI@%pFileSrc%@AE@% and %@AI@%pFileDst%@AE@% parameters are handles to the source and%@EH@%
destination files. If %@AI@%pFileSrc%@AE@% is null (0), the function inserts one or more
blanks lines, the number of lines being determined by the relative values of
%@AI@%yStart%@AE@% and%@AI@%yEnd%@AE@%. (The number of blank lines is equal to the difference
between %@AI@%yStart%@AE@% and %@AI@%yEnd%@AE@% plus one.) Otherwise, the function copies the lines
from %@AI@%yStart%@AE@% to %@AI@%yEnd%@AE@%, inclusive, in the destination file. Lines are inserted
directly before line %@AI@%yDst%@AE@% in the destination file.%@NL@%
%@NL@%
%@CR:MSE9R044@%%@4@%The %@AB@%CopyLine%@AE@% function should not be confused with the %@AB@%PutLine%@AE@% function.%@EH@%
%@AB@%PutLine%@AE@% replaces a line and does not affect the total number of lines.
%@AB@%CopyLine%@AE@% inserts one or more lines and therefore increases the length of the
file.%@NL@%
%@NL@%
%@CR:MSE9R045@%%@4@%The same file cannot serve as both source and destination. To copy text from%@EH@%
one part of the file to another, copy to a temporary file, such as
<clipboard>.%@NL@%
%@NL@%
%@CR:MSE9R046@%%@4@%All line numbers in low-level functions are zero based.%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Return value%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R047@%%@4@%The function does not return a value.%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  See also%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R048@%%@4@%%@AB@%CopyBox%@AE@%, %@AB@%CopyStream%@AE@%, %@AB@%FileNameToHandle%@AE@%, %@AB@%PutLine%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Example%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R049@%%@4@%The following code inserts a blank line at the beginning of the file:%@EH@%%@NL@%
%@NL@%
     cfile = FileNameToHandle( "", NULL );%@NL@%
     CopyLines( NULL, cfile, 0, 0, 0 );%@NL@%
%@NL@%
%@NL@%
%@CR:MSE9R050@%%@3@%%@AB@%CopyStream%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Summary%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R051@%%@AB@%#include <ext.h>%@AE@%%@NL@%
%@NL@%
     %@AB@%void pascal CopyStream%@AE@% (%@AI@%pFileSrc%@AE@%, %@AI@%pFileDst%@AE@%, %@AI@%xStart%@AE@%,%@AI@%yStart%@AE@%, %@AI@%xEnd%@AE@%, %@AI@%yEnd%@AE@%, %@AI@%xDst%@AE@%, %@AI@%yDst%@AE@%)%@NL@%
     %@AB@%PFILE%@AE@% %@AI@%pFileSrc%@AE@%, %@AI@%pFileDst%@AE@%;%@NL@%
     %@AB@%COL%@AE@% %@AI@%xStart%@AE@%, %@AI@%xEnd%@AE@%, %@AI@%xDst%@AE@%;%@NL@%
     %@AB@%LINE%@AE@% %@AI@%yStart%@AE@%, %@AI@%yEnd%@AE@%, %@AI@%yDst%@AE@%;%@NL@%
%@NL@%
%@4@%%@AB@%■  Description%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R052@%%@4@%The %@AB@%CopyStream%@AE@% function copies the stream of text (including new lines)%@EH@%
beginning at position (%@AI@%xStart, yStart%@AE@%), up to but not including position
(%@AI@%xEnd, yEnd%@AE@%).  The stream of text is inserted into the destination file just
before position (%@AI@%xDst,%@AE@%%@AI@%yDst%@AE@%).  If %@AI@%pFileSrc%@AE@% is null (0), a blank space is
inserted.%@NL@%
%@NL@%
%@CR:MSE9R053@%%@4@%The %@AI@%pFileSrc%@AE@% and %@AI@%pFileDst%@AE@% parameters are file handles to the source and%@EH@%
destination files.%@NL@%
%@NL@%
%@CR:MSE9R054@%%@4@%The same file cannot serve as both source and destination. To copy text from%@EH@%
one part of the file to another, copy to a temporary file, such as
<clipboard>.%@NL@%
%@NL@%
%@4@%%@AB@%■  Return value%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R055@%%@4@%The function does not return a value.%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  See also%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R056@%%@4@%%@AB@%CopyBox%@AE@%, %@AB@%CopyLine%@AE@%, %@AB@%FileNameToHandle%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Example%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R057@%%@4@%The following example copies a stream from the file A.TXT and inserts this%@EH@%
region into the file B.TXT:%@NL@%
%@NL@%
     pAFILE = FileNameToHandle( "A.TXT", "" );%@NL@%
     pBFILE = FileNameToHandle( "B.TXT", "" );%@NL@%
     .%@NL@%
     .%@NL@%
     .%@NL@%
     CopyStream( pAFILE, pBFILE, xStart, yStart, xEnd, yEnd, xBFILE, yBFILE );%@NL@%
%@NL@%
%@NL@%
%@CR:MSE9R060@%%@3@%%@AB@%DelBox%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Summary%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R061@%%@AB@%#include <ext.h>%@AE@%%@NL@%
%@NL@%
     %@AB@%void pascal DelBox%@AE@% (%@AI@%pFile%@AE@%, %@AI@%xLeft%@AE@%, %@AI@%yTop%@AE@%, %@AI@%xRight%@AE@%, %@AI@%yBottom%@AE@%)%@NL@%
     %@AB@%PFILE%@AE@% %@AI@%pFile%@AE@%;%@NL@%
     %@AB@%COL%@AE@% %@AI@%xLeft%@AE@%, %@AI@%xRight%@AE@%;%@NL@%
     %@AB@%LINE%@AE@% %@AI@%yTop%@AE@%, %@AI@%yBottom%@AE@%;%@NL@%
%@NL@%
%@4@%%@AB@%■  Description%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R062@%%@4@%The %@AB@%DelBox%@AE@% function deletes all spaces in the box delimited by the positions%@EH@%
(%@AI@%xLeft%@AE@%, %@AI@%yTop%@AE@%) and (%@AI@%xRight%@AE@%, %@AI@%yBottom%@AE@%). The box includes all four edges in the
parameter list. The %@AI@%pFile%@AE@% parameter is a handle to the file to be modified.%@NL@%
%@NL@%
%@CR:MSE9R063@%%@4@%All line and column coordinates are zero based.%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Return value%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R064@%%@4@%The function does not return a value.%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  See also%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R065@%%@4@%%@AB@%DelLine%@AE@%, %@AB@%DelStream%@AE@%, %@AB@%FileNameToHandle%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Example%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R066@%%@4@%The following example deletes the user-defined box argument:%@EH@%%@NL@%
%@NL@%
     pFile = FileNameToHandle( "", NULL );%@NL@%
     .%@NL@%
     .%@NL@%
     .%@NL@%
     Left   = pArg->arg.boxarg.xLeft;%@NL@%
     Right  = pArg->arg.boxarg.xRight;%@NL@%
     Top    = pArg->arg.boxarg.yTop;%@NL@%
     Bottom = pArg->arg.boxarg.yBottom;%@NL@%
     .%@NL@%
     .%@NL@%
     .%@NL@%
     DelBox( pFile, Left, Top, Right, Bottom );%@NL@%
%@NL@%
%@NL@%
%@CR:MSE9R070@%%@3@%%@AB@%DelFile%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Summary%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R071@%%@AB@%#include <ext.h>%@AE@%%@NL@%
%@NL@%
     %@AB@%void pascal DelFile%@AE@% (%@AI@%pFile%@AE@%)%@NL@%
     %@AB@%PFILE%@AE@% %@AI@%pFile%@AE@%;%@NL@%
%@NL@%
%@4@%%@AB@%■  Description%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R072@%%@4@%The %@AI@%DelFile%@AE@% function deletes the entire contents of an internal file buffer.%@EH@%
The effect of deleting contents can be made permanent by calling the
%@AB@%FileWrite%@AE@% function, which replaces the contents of the file on disk with the
contents of the internal file buffer.%@NL@%
%@NL@%
%@CR:MSE9R073@%%@4@%The  parameter %@AI@%pFile%@AE@% is the handle of the file to be cleared.%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Return value%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R074@%%@4@%The function does not return a value.%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  See also%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R075@%%@4@%%@AB@%AddFile%@AE@%, %@AB@%FileNameToHandle%@AE@%, %@AB@%FileWrite%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Example%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R076@%%@4@%The following example deletes the contents of the file JUNK.TXT, then calls%@EH@%
%@AB@%FileWrite%@AE@% to make the change permanent:%@NL@%
%@NL@%
     if( (pFile = FileNameToHandle( "JUNK.TXT", NULL)) == 0 )%@NL@%
          pFile = AddFile(  "JUNK.TXT"  );%@NL@%
%@NL@%
     DelFile( pFile );%@NL@%
     FileWrite( "JUNK.TXT", pFile );%@NL@%
%@NL@%
%@NL@%
%@CR:MSE9R080@%%@3@%%@AB@%DelLine%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Summary%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R081@%%@4@%%@AB@%#include <ext.h>%@EH@%%@AE@%%@NL@%
%@NL@%
     %@AB@%void pascal DelLine%@AE@% (%@AI@%pFile%@AE@%, %@AI@%yStart%@AE@%, %@AI@%yEnd%@AE@%)%@NL@%
     %@AB@%PFILE%@AE@% %@AI@%pFile%@AE@%;%@NL@%
     %@AB@%LINE%@AE@% %@AI@%yStart%@AE@%, %@AI@%yEnd%@AE@%;%@NL@%
%@NL@%
%@4@%%@AB@%■  Description%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R082@%%@4@%The %@AB@%DelLine%@AE@% function deletes lines %@AI@%yStart%@AE@% through %@AI@%yEnd%@AE@%, inclusive, in the%@EH@%
file %@AI@%pFile%@AE@%.%@NL@%
%@NL@%
%@CR:MSE9R083@%%@4@%The %@AI@%pFile%@AE@% parameter is a handle to a file from which lines are to be%@EH@%
deleted. %@AI@%yStart%@AE@% is the first line to be deleted, and %@AI@%yEnd%@AE@% is the last line
to be deleted.%@NL@%
%@NL@%
%@CR:MSE9R084@%%@4@%All line coordinates for low-level functions are zero based.%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Return value%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R085@%%@4@%The function does not return a value.%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  See also%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R086@%%@4@%%@AB@%DelBox%@AE@%, %@AB@%DelStream%@AE@%, %@AB@%FileNameToHandle%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Example%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R087@%%@4@%The following example deletes the user-defined line argument:%@EH@%%@NL@%
%@NL@%
     cfile = FileNameToHandle( "", NULL );%@NL@%
     .%@NL@%
     .%@NL@%
     .%@NL@%
     Start  = pArg->arg.linearg.xStart;%@NL@%
     End    = pArg->arg.linearg.xEnd;%@NL@%
     .%@NL@%
     .%@NL@%
     .%@NL@%
     DelLine( cfile, Start, End );%@NL@%
%@NL@%
%@NL@%
%@CR:MSE9R090@%%@3@%%@AB@%DelStream%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Summary%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R091@%%@AB@%#include <ext.h>%@AE@%%@NL@%
%@NL@%
     %@AB@%void pascal DelStream%@AE@% (%@AI@%pFile%@AE@%, %@AI@%xStart%@AE@%, %@AI@%yStart%@AE@%, %@AI@%xEnd%@AE@%, %@AI@%yEnd%@AE@%)%@NL@%
     %@AB@%PFILE%@AE@% %@AI@%pFile%@AE@%;%@NL@%
     %@AB@%COL%@AE@% xStart, x%@AI@%End%@AE@%%@NL@%
     %@AB@%LINE%@AE@% %@AI@%yStart%@AE@%, %@AI@%yEnd%@AE@%;%@NL@%
%@NL@%
%@4@%%@AB@%■  Description%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R092@%%@4@%The %@AB@%DelStream%@AE@% function deletes a stream of text beginning with a starting%@EH@%
coordinate up to but not including the ending coordinate.%@NL@%
%@NL@%
%@CR:MSE9R093@%%@4@%The %@AI@%xStart%@AE@% and %@AI@%yStart%@AE@% parameters give the coordinates of the beginning of%@EH@%
the stream. The %@AI@%xEnd%@AE@% and %@AI@%yEnd%@AE@% parameters give the coordinates of the byte
just after the end of the stream.%@NL@%
%@NL@%
%@CR:MSE9R094@%%@4@%All column and line coordinates for low-level functions are zero based.%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Return value%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R095@%%@4@%The function does not return a value.%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  See also%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R096@%%@4@%%@AB@%DelBox%@AE@%, %@AB@%DelLine%@AE@%, %@AB@%FileNameToHandle%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Example%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R097@%%@4@%The following example deletes the user-defined stream of text:%@EH@%%@NL@%
%@NL@%
     cfile = FileNameToHandle( "", NULL );%@NL@%
     .%@NL@%
     .%@NL@%
     .%@NL@%
     xStart = pArg->arg.streamarg.xStart;%@NL@%
     yStart = pArg->arg.streamarg.yStart;%@NL@%
     xEnd   = pArg->arg.streamarg.xEnd;%@NL@%
     yEnd   = pArg->arg.streamarg.yEnd;%@NL@%
     .%@NL@%
     .%@NL@%
     .%@NL@%
     DelStream( cfile, xStart, yStart, xEnd, yEnd );%@NL@%
%@NL@%
%@NL@%
%@CR:MSE9R100@%%@3@%%@AB@%Display%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Summary%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R101@%%@AB@%#include <ext.h>%@AE@%%@NL@%
%@NL@%
     %@AB@%void pascal Display%@AE@% ()%@NL@%
%@NL@%
%@4@%%@AB@%■  Description%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R102@%%@4@%The %@AB@%Display%@AE@% function refreshes the screen by examining editing changes and%@EH@%
making the minimum screen changes necessary. A keystroke interrupts the
function and causes immediate return.%@NL@%
%@NL@%
%@CR:MSE9R103@%%@4@%The editor normally updates the display whenever the editing session is%@EH@%
"idle"; that is, when the editor is waiting for the next command from the
user. Therefore, it is usually not necessary to call the %@AB@%Display%@AE@% function.
However, if your function runs for an extended period of time, call %@AB@%Display%@AE@%
periodically to show the user the stage of any intermediate changes.
Otherwise, the results of these changes are not displayed until completion
of the function.%@NL@%
%@NL@%
%@4@%%@AB@%■  Return value%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R104@%%@4@%The function does not return a value.%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Example%@AE@%%@EH@%%@NL@%
%@NL@%
     Display();%@NL@%
%@NL@%
%@NL@%
%@CR:MSE9R110@%%@3@%%@AB@%DoMessage%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Summary%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R111@%%@AB@%#include <ext.h>%@AE@%%@NL@%
%@NL@%
     %@AB@%int pascal DoMessage%@AE@% (%@AI@%pStr%@AE@%)%@NL@%
     %@AB@%char far%@AE@% *%@AI@%pStr%@AE@%;%@NL@%
%@NL@%
%@4@%%@AB@%■  Description%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R112@%%@4@%The %@AB@%DoMessage%@AE@% function writes a message to the dialog line. The %@AI@%pStr%@AE@%%@EH@%
parameter points to a null-terminated string of text containing the message
to be written.%@NL@%
%@NL@%
%@4@%%@AB@%■  Return value%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R113@%%@4@%The function returns the number of characters written.%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Example%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R114@%%@4@%The following example outputs a message on the dialog line as part of the%@EH@%
initialization procedure %@AB@%WhenLoaded%@AE@%:%@NL@%
%@NL@%
     WhenLoaded ()%@NL@%
     {%@NL@%
          .%@NL@%
          .%@NL@%
          .%@NL@%
%@NL@%
             DoMessage( "My extension now loaded" );%@NL@%
     }%@NL@%
%@NL@%
%@NL@%
%@CR:MSE9R120@%%@3@%%@AB@%fExecute%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Summary%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R121@%%@AB@%#include <ext.h>%@AE@%%@NL@%
%@NL@%
     %@AB@%flagType pascal fExecute%@AE@% %@AI@%(pStr)%@AE@%%@NL@%
     %@AB@%char far%@AE@% %@AI@%*pStr%@AE@%;%@NL@%
%@NL@%
%@4@%%@AB@%■  Description%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R122@%%@4@%The %@AB@%fExecute%@AE@% function executes a macro, using the standard rules for macro%@EH@%
execution. The pointer %@AI@%pStr%@AE@% points to a null-terminated string of text
containing the macro to be executed.%@NL@%
%@NL@%
%@CR:MSE9R123@%%@4@%You may sometimes find it convenient to invoke a predefined editing function%@EH@%
by calling %@AB@%fExecute%@AE@%. For example, to search for the next occurrence of a
given string, you can either write a loop that examines each line in the
file, or simply invoke %@AI@%Psearch%@AE@% by calling %@AB@%fExecute%@AE@%. Macros are especially
convenient when you want to look for a regular expression.%@NL@%
%@NL@%
%@4@%%@AB@%■  Return value%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R124@%%@4@%The function passes along the value TRUE (nonzero) or FALSE (zero) returned%@EH@%
by the last function the macro executed.%@NL@%
%@NL@%
%@4@%%@AB@%■  Example%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R125@%%@4@%The following example invokes a macro in order to search for the next%@EH@%
occurrence of the regular expression %@AS@%RegEx%@AE@%:%@NL@%
%@NL@%
     strcpy( buf, "arg arg \"" );%@NL@%
     strcat( buf, RegEx );%@NL@%
     strcat( buf, "\" psearch" );%@NL@%
%@NL@%
     if( fExecute (buf) )%@NL@%
     {%@NL@%
         GetCursor( xCur, yCur );    %@AI@%/* Get new coordinates */%@AE@%%@NL@%
     }%@NL@%
     else%@NL@%
     {%@NL@%
     .%@NL@%
     .%@NL@%
     .%@NL@%
      %@AI@%/* Take action for item not found */%@AE@%%@NL@%
     .%@NL@%
     .%@NL@%
     .%@NL@%
     }%@NL@%
%@NL@%
%@NL@%
%@CR:MSE9R130@%%@3@%%@AB@%FileLength%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Summary%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R131@%%@AB@%#include <ext.h>%@AE@%%@NL@%
%@NL@%
     %@AB@%LINE pascal FileLength%@AE@% %@AI@%(pFile)%@AE@%%@NL@%
     %@AB@%PFILE%@AE@% %@AI@%pFile%@AE@%;%@NL@%
%@NL@%
%@4@%%@AB@%■  Description%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R132@%%@4@%The %@AB@%FileLength%@AE@% function determines the length of the file pointed to by%@EH@%
%@AI@%pFile%@AE@%.%@NL@%
%@NL@%
%@CR:MSE9R133@%%@4@%This function is useful for global operations in which it is necessary to%@EH@%
know when you have reached the end of the file.%@NL@%
%@NL@%
%@4@%%@AB@%■  Return value%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R134@%%@4@%The function returns the number of lines in the given file.%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  See also%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R135@%%@AB@%FileNameToHandle%@AE@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Example%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R136@%%@4@%The following example determines the number of lines in the current file:%@EH@%%@NL@%
%@NL@%
     LINE fileLen;%@NL@%
%@NL@%
     cfile = FileNameToHandle( "", NULL );%@NL@%
     fileLen = FileLength( cfile );%@NL@%
%@NL@%
%@NL@%
%@CR:MSE9R140@%%@3@%%@AB@%FileNameToHandle%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Summary%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R141@%%@AB@%#include <ext.h>%@AE@%%@NL@%
%@NL@%
     %@AB@%PFILE pascal FileNameToHandle%@AE@% (%@AI@%pname%@AE@%, %@AI@%pShortName%@AE@%) %@NL@%
     %@AB@%char%@AE@% *%@AI@%pname%@AE@%, *%@AI@%pShortName%@AE@%;%@NL@%
%@NL@%
%@4@%%@AB@%■  Description%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R142@%%@4@%The %@AB@%FileNameToHandle%@AE@% function returns the handle of a file already opened%@EH@%
for editing.%@NL@%
%@NL@%
%@CR:MSE9R143@%%@4@%The %@AI@%pname%@AE@% parameter points to a null-terminated string of text containing a%@EH@%
complete file name. %@AB@%FileNameToHandle%@AE@% looks for an exact match in its list of
open files. The full path name must match. If the string does not specify a
path to a directory, the current directory is assumed.%@NL@%
%@NL@%
%@CR:MSE9R144@%%@4@%If the function cannot find a match to %@AI@%pname%@AE@%, it attempts to match the%@EH@%
%@AI@%pShortName%@AE@% parameter. This parameter points to a null-terminated string of
text containing only a base file name──the function ignores any path name or
extension in the short name. The editor selects the first file name with a
base name matching the short name.%@NL@%
%@NL@%
%@CR:MSE9R145@%%@4@%If the first string is empty, the function returns a handle to the current%@EH@%
file. The editor does not try to match a short name if the second parameter
is a null pointer or points to an empty string.%@NL@%
%@NL@%
%@4@%%@AB@%■  Return value%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R146@%%@4@%The %@AB@%FileNameToHandle%@AE@% function returns the handle to the given file. If the%@EH@%
given file is not open for editing, the function returns NULL.%@NL@%
%@NL@%
%@4@%%@AB@%■  Example%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R147@%%@4@%The following example returns a handle to the current file:%@EH@%%@NL@%
%@NL@%
     PFILE  curfile;%@NL@%
%@NL@%
     curfile = FileNameToHandle( "", NULL );%@NL@%
%@NL@%
%@NL@%
%@CR:MSE9R150@%%@3@%%@AB@%FileRead%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Summary%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R151@%%@AB@%#include <ext.h>%@AE@%%@NL@%
%@NL@%
     %@AB@%flagType pascal FileRead%@AE@% %@AI@%(name, pFile)%@AE@%%@NL@%
     %@AB@%char far *name%@AE@%;
     %@AB@%PFILE%@AE@% %@AI@%pFile%@AE@%;%@NL@%
%@NL@%
%@4@%%@AB@%■  Description%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R152@%%@4@%The %@AB@%FileRead%@AE@% function reads the contents of the specified disk file and%@EH@%
stores them in the internal file buffer specified by the %@AI@%pFile%@AE@%. The old
contents of the file buffer are lost.%@NL@%
%@NL@%
%@CR:MSE9R153@%%@4@%The parameter %@AI@%name%@AE@% is a pointer to a null-terminated string containing the%@EH@%
name of the disk file to be read. The %@AI@%pFile%@AE@% parameter is the handle of the
internal file buffer to write the data to.%@NL@%
%@NL@%
%@CR:MSE9R154@%%@4@%When you open a file for editing with %@AB@%AddFile%@AE@%, the file buffer is initially%@EH@%
empty. Call %@AB@%FileRead%@AE@% to initialize the buffer with the current contents of
the file.%@NL@%
%@NL@%
%@4@%%@AB@%■  Return value%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R155@%%@4@%The function returns TRUE (nonzero) if the copy is successful and FALSE%@EH@%
(zero) if not.%@NL@%
%@NL@%
%@4@%%@AB@%■  See also%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R156@%%@4@%%@AB@%AddFile%@AE@%, %@AB@%FileWrite%@AE@%, %@AB@%FileNameToHandle%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Example%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R157@%%@4@%The following example opens the file MYTEXT.FIL for editing and then%@EH@%
initializes the buffer with the current contents of the file:%@NL@%
%@NL@%
     if( (pFile = FileNameToHandle("MYTEXT.FIL",NULL)) == 0 )%@NL@%
     {%@NL@%
          pFile = AddFile( "MYTEXT.FIL" );%@NL@%
          FileRead( "MYTEXT.FIL", pFile );%@NL@%
     }%@NL@%
%@NL@%
%@NL@%
%@CR:MSE9R160@%%@3@%%@AB@%FileWrite%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Summary%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R161@%%@AB@%#include <ext.h>%@AE@%%@NL@%
%@NL@%
     %@AB@%flagType pascal FileWrite%@AE@%%@AI@% (savename, pFile)%@AE@%%@NL@%
     %@AB@%char far *savename%@AE@%;%@NL@%
     %@AB@%PFILE%@AE@%%@AI@% pFile%@AE@%;%@NL@%
%@NL@%
%@4@%%@AB@%■  Description%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R162@%%@4@%The %@AB@%FileWrite%@AE@% function writes the contents of the specified file buffer out%@EH@%
to a disk file.%@NL@%
%@NL@%
%@CR:MSE9R163@%%@4@%The %@AI@%pFile%@AE@% parameter is the handle to the file buffer. The %@AI@%savename%@AE@% parameter%@EH@%
points to the name of the disk file. If %@AI@%savename%@AE@% points to an empty string,
the function writes to the disk file with the name as the file %@AI@%pFile%@AE@%. (Note
that a file handle points to an internal structure that contains the name of
the file as well as other data.)%@NL@%
%@NL@%
%@CR:MSE9R164@%%@4@%The function first writes contents to a temporary file. If the write%@EH@%
operation is successful, the temporary file is renamed to the destination
file.%@NL@%
%@NL@%
%@CR:MSE9R165@%%@4@%You need not use %@AB@%FileWrite%@AE@% with the current file. Since the user is%@EH@%
currently editing this file, you can let the user decide when to save the
file to disk. However,%@AB@%FileWrite%@AE@% should be used with other files that you
open for editing.%@NL@%
%@NL@%
%@4@%%@AB@%■  Return value%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R166@%%@4@%The function returns TRUE (nonzero) if the copy was successful and FALSE%@EH@%
(zero) if not.%@NL@%
%@NL@%
%@4@%%@AB@%■  See also%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R167@%%@4@%%@AB@%AddFile%@AE@%, %@AB@%FileRead%@AE@%, %@AB@%FileNameToHandle%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Example%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R168@%%@4@%The following example alters the contents of the file JUNK.TXT, then makes%@EH@%
the deletion permanent by calling %@AB@%FileWrite%@AE@%:%@NL@%
%@NL@%
     char *p = "JUNK.TXT";%@NL@%
%@NL@%
     if( (pFile = FileNameToHandle(p, NULL)) == 0 )%@NL@%
     {%@NL@%
         pFile = AddFile( p );%@NL@%
         FileRead( p, pFile );%@NL@%
     }%@NL@%
     .%@NL@%
     .%@NL@%
     .%@NL@%
     %@AI@%/* Manipulate data in the file *%@AE@%/%@NL@%
     .%@NL@%
     .%@NL@%
     .%@NL@%
     FileWrite( p, pFile );%@NL@%
%@NL@%
%@NL@%
%@CR:MSE9R170@%%@3@%%@AB@%GetCursor%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Summary%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R171@%%@AB@%#include <ext.h>%@AE@%%@NL@%
%@NL@%
     %@AB@%void pascal GetCursor%@AE@% %@AI@%(px, py)%@AE@%;%@NL@%
     %@AB@%COL far%@AE@% %@AI@%*px%@AE@%;%@NL@%
     %@AB@%LINE far%@AE@% %@AI@%*py%@AE@%;%@NL@%
%@NL@%
%@4@%%@AB@%■  Description%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R172@%%@4@%The %@AB@%GetCursor%@AE@% function indicates current cursor position by modifying the%@EH@%
variables to which %@AI@%px%@AE@% and %@AI@%py%@AE@% point. The function sets %@AI@%*px%@AE@% to the current
cursor column, and %@AI@%*py%@AE@% to the current cursor line.%@NL@%
%@NL@%
%@CR:MSE9R173@%%@4@%Upon return, the numbers pointed to by %@AI@%px%@AE@% and %@AI@%py%@AE@% indicate the column and%@EH@%
row, respectively, of the current cursor position.%@NL@%
%@NL@%
%@4@%%@AB@%■  Return value%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R174@%%@4@%The function does not return a value.%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  See also%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R175@%%@AB@%MoveCur%@AE@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Example%@AE@%%@EH@%%@NL@%
%@NL@%
     LINE  yCur;%@NL@%
     COL   xCur;%@NL@%
     .%@NL@%
     .%@NL@%
     .%@NL@%
          GetCursor( &xCur, &yCur );%@NL@%
%@NL@%
%@NL@%
%@CR:MSE9R180@%%@3@%%@AB@%GetLine%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Summary%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R181@%%@AB@%#include <ext.h>%@AE@%%@NL@%
%@NL@%
     %@AB@%int pascal GetLine%@AE@% (%@AI@%line%@AE@%, %@AI@%buf%@AE@%, %@AI@%pFile%@AE@%)%@NL@%
     %@AB@%LINE%@AE@% %@AI@%line%@AE@%;%@NL@%
     %@AB@%char far *%@AE@%%@AI@%buf%@AE@%%@NL@%
     %@AB@%PFILE%@AE@% %@AI@%pFile%@AE@%;%@NL@%
%@NL@%
%@4@%%@AB@%■  Description%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R182@%%@4@%The %@AB@%GetLine%@AE@% function is the principal means for reading text from a file%@EH@%
buffer.%@NL@%
%@NL@%
%@CR:MSE9R183@%%@4@%The function reads a specified line of text and copies the line into a%@EH@%
character string pointed to by %@AI@%buf%@AE@%. The editor terminates the string with a
null value. The %@AI@%line%@AE@% parameter contains a line number to read. In
extensions, line numbers are always zero based. The %@AI@%pFile%@AE@% parameter is the
handle to the file.%@NL@%
%@NL@%
%@CR:MSE9R184@%%@4@%If the %@AB@%realtabs%@AE@% switch is off, the function expands tabs to spaces (as%@EH@%
indicated by the %@AB@%entab%@AE@% and %@AB@%filetab%@AE@% switches) before copying the text to %@AI@%buf%@AE@%.%@NL@%
%@NL@%
%@4@%%@AB@%■  Return value%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R185@%%@4@%The function returns the number of characters in the line after any tab%@EH@%
conversion.%@NL@%
%@NL@%
%@4@%%@AB@%■  See also%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R186@%%@4@%%@AB@%CopyLine%@AE@%, %@AB@%PutLine%@AE@%, %@AB@%FileNameToHandle%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Example%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R187@%%@4@%The following example reads the line of text that includes the initial%@EH@%
cursor position and copies it into %@AI@%buf%@AE@%:%@NL@%
%@NL@%
     PFILE cfile;%@NL@%
     LINE  yCur;%@NL@%
     COL   xCur;%@NL@%
      char  buf[BUFLEN];%@NL@%
     int   len; .%@NL@%
     .%@NL@%
     .%@NL@%
         cfile = FileNameToHandle( "", NULL );%@NL@%
         GetCursor( &xCur, &yCur );%@NL@%
         len = GetLine( yCur, buf, cfile );%@NL@%
%@NL@%
%@NL@%
%@CR:MSE9R190@%%@3@%%@AB@%KbHook%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Summary%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R191@%%@AB@%#include <ext.h>%@AE@%%@NL@%
%@NL@%
     %@AB@%void pascal KbHook%@AE@%();%@NL@%
%@NL@%
%@4@%%@AB@%■  Description%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R192@%%@4@%The %@AB@%KbHook%@AE@% function reverses the effect of the %@AB@%KbUnHook%@AE@% function and%@EH@%
restores normal keyboard-input reading by the editor.%@NL@%
%@NL@%
%@4@%%@AB@%■  Return value%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R193@%%@4@%The function does not return a value.%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  See also%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R194@%%@AB@%KhUnHook%@AE@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Example%@AE@%%@EH@%%@NL@%
%@NL@%
     KbHook( );%@NL@%
%@NL@%
%@NL@%
%@CR:MSE9R200@%%@3@%%@AB@%KbUnHook%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Summary%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R201@%%@AB@%#include <ext.h>%@AE@%%@NL@%
%@NL@%
     %@AB@%void pascal KbUnHook%@AE@%();%@NL@%
%@NL@%
%@4@%%@AB@%■  Descripti on%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R202@%%@4@%The %@AB@%KbUnHook%@AE@% function changes the focus of the keyboard so that keyboard%@EH@%
input is no longer read by the editor.  When attempting to use system-level
calls to read from the keyboard, it is necessary to first call this
function.%@NL@%
%@NL@%
%@CR:MSE9R203@%%@4@%In particular, it is necessary to call the %@AB@%KbUnHook%@AE@% function before%@EH@%
transferring control to a program that reads directly from the keyboard by
using operating-system or BIOS calls, or by working directly with hardware.%@NL@%
%@NL@%
%@CR:MSE9R204@%%@4@%You normally do not need to call this function. For most work with the%@EH@%
keyboard, use the %@AB@%ReadChar%@AE@% function. %@AB@%ReadChar%@AE@% lets the editor read the
keyboard for you, but allows you to intercept the keystroke and evaluate it
in any way you choose. Use %@AB@%KbUnHook%@AE@% only for situations that %@AB@%ReadChar%@AE@% cannot
accommodate.%@NL@%
%@NL@%
%@4@%%@AB@%■  Return value%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R205@%%@4@%The function does not return a value.%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  See also%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R206@%%@AB@%KbHook%@AE@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Example%@AE@%%@EH@%%@NL@%
%@NL@%
     KbUnHook( );%@NL@%
%@NL@%
%@NL@%
%@CR:MSE9R210@%%@3@%%@AB@%MoveCur%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Summary%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R211@%%@AB@%#include <ext.h>%@AE@%%@NL@%
%@NL@%
     %@AB@%void pascal MoveCur%@AE@% (%@AI@%x%@AE@%, %@AI@%y%@AE@%)%@NL@%
     %@AB@%COL%@AE@% %@AI@%x%@AE@%;%@NL@%
     %@AB@%LINE%@AE@% %@AI@%y%@AE@%;%@NL@%
%@NL@%
%@4@%%@AB@%■  Description%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R212@%%@4@%The %@AB@%MoveCur%@AE@% function moves the cursor to the specified position within the%@EH@%
current file. If the cursor is within the same window, no window movement
occurs. Otherwise, the window scrolls as needed, and the cursor is placed at
a common position specified by the numeric switch %@AB@%hike.%@AE@%%@NL@%
%@NL@%
%@CR:MSE9R213@%%@4@%After the function is called, the cursor moves to column %@AI@%x%@AE@%, line %@AI@%y%@AE@% of the%@EH@%
current file. The editing window scrolls, if necessary, to display this
position within the window.%@NL@%
%@NL@%
%@4@%%@AB@%■  Return value%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R214@%%@4@%The function does not return a value.%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  See also%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R215@%%@AB@%GetCursor%@AE@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Example%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R216@%%@4@%The following example edits the file but restores the initial cursor%@EH@%
position:%@NL@%
%@NL@%
     GetCursor( &xCur, &yCur );%@NL@%
     .%@NL@%
     .%@NL@%
     .%@NL@%
     %@AI@%/* Modify the file */%@AE@%%@NL@%
     .%@NL@%
     .%@NL@%
     .%@NL@%
     MoveCur( xCur, yCur );%@NL@%
%@NL@%
%@NL@%
%@CR:MSE9R220@%%@3@%%@AB@%pFileToTop%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Summary%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R221@%%@AB@%#include <ext.h>%@AE@%%@NL@%
%@NL@%
     %@AB@%void pascal pFileToTop%@AE@%%@AI@% (pFileTmp)%@AE@%%@NL@%
     %@AB@%PFILE%@AE@% %@AI@%pFileTmp%@AE@%;%@NL@%
%@NL@%
%@4@%%@AB@%■  Description%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R222@%%@4@%The %@AB@%pFileToTop%@AE@% function selects a file as the current file and makes it%@EH@%
visible in the current window.  The function accomplishes this operation by
moving the specified file handle to the top of the file list for the current
window. (This list is stored in the <information-file> pseudo file.)%@NL@%
%@NL@%
%@CR:MSE9R223@%%@4@%The parameter %@AI@%pFileTmp%@AE@% is the file handle to move to the top of the file%@EH@%
list.%@NL@%
%@NL@%
%@4@%%@AB@%■  Return value%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R224@%%@4@%The function does not return a value.%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  See also%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R225@%%@4@%%@AB@%AddFile%@AE@%, %@AB@%FileNameToHandle%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Example%@AE@%%@EH@%%@NL@%
%@NL@%
     pFileToTop( pFile );%@NL@%
%@NL@%
%@NL@%
%@CR:MSE9R230@%%@3@%%@AB@%PutLine%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Summary%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R231@%%@AB@%#include <ext.h>%@AE@%%@NL@%
%@NL@%
     %@AB@%void pascal PutLine%@AE@% (%@AI@%line%@AE@%, %@AI@%buf%@AE@%, %@AI@%pFile%@AE@%)%@NL@%
     %@AB@%LINE%@AE@% %@AI@%line%@AE@%;%@NL@%
     %@AB@%char far *%@AE@%%@AI@%buf%@AE@%;%@NL@%
     %@AB@%PFILE%@AE@% %@AI@%pFile%@AE@%;%@NL@%
%@NL@%
%@4@%%@AB@%■  Description%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R232@%%@4@%The %@AB@%PutLine%@AE@% function is the principal means for writing text to a file%@EH@%
buffer.%@NL@%
%@NL@%
%@CR:MSE9R233@%%@4@%The function replaces a single line of text. The parameter %@AI@%buf%@AE@% points to the%@EH@%
string that contains the new line of text. This string should terminate with
a null value, but it should not contain a new-line character.%@NL@%
%@NL@%
%@CR:MSE9R234@%%@4@%The parameter %@AI@%line%@AE@% contains the line number at which the replacement is to%@EH@%
take place. Line numbers start at 0; if %@AI@%line%@AE@% has the value 0, the new line
of text is inserted at the beginning of the file.%@NL@%
%@NL@%
%@CR:MSE9R235@%%@4@%If %@AI@%line%@AE@% is greater than the number of lines in the file, %@AB@%PutLine%@AE@% inserts%@EH@%
empty lines at the end of the file.%@NL@%
%@NL@%
%@4@%%@AB@%■  Return value%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R236@%%@4@%The function does not return a value.%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  See also%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R237@%%@4@%%@AB@%CopyLine%@AE@%, %@AB@%GetLine%@AE@%, %@AB@%FileLength%@AE@%, %@AB@%FileNameToHandle%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Example%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R238@%%@4@%The following code replaces the first line of the current file with the%@EH@%
string pointed to by %@AS@%buf%@AE@%:%@NL@%
%@NL@%
     PutLine( 0, buf, cfile );%@NL@%
%@NL@%
%@NL@%
%@CR:MSE9R240@%%@3@%%@AB@%ReadChar%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Summary%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R241@%%@AB@%#include <ext.h>%@AE@%%@NL@%
%@NL@%
     %@AB@%long pascal ReadChar%@AE@%();%@NL@%
%@NL@%
%@4@%%@AB@%■  Description%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R242@%%@4@%The %@AB@%ReadChar%@AE@% function returns the next keystroke typed. The editor does not%@EH@%
echo the keystroke or invoke a function. Once intercepted, the keystroke
cannot be placed back into the keyboard buffer for execution. The function
returns a long integer composed of four bytes containing information about
the keystroke:%@NL@%
%@NL@%
%@CR:MSE9R243@%%@AB@%Byte                        Description%@AE@%%@NL@%
%@NL@%
0                           ASCII character%@NL@%
%@NL@%
1                           scan-code character%@NL@%
%@NL@%
2                           shift information, in xxNxACxS format described%@NL@%
                            below%@NL@%
%@NL@%
3                           null character (0), which is unused%@NL@%
%@NL@%
%@CR:MSE9R244@%%@4@%Byte 2 provides information about the shift-key conditions (N)UMLOCK, (A)LT,%@EH@%
(C)TRL, and (S)HIFT, in the format xxNxACxS. Each x indicates an unused bit.
The bits N, A, C, and S are each on or off, depending on the associated
condition.  For example, if the ALT, CTRL, and SHIFT conditions are all on,
but the NUMLOCK condition is off, byte 2 is returned as 00001101.  Note: the
N bit is 0 unless the key pressed is on the numeric keypad.%@NL@%
%@NL@%
%@4@%%@AB@%■  Return value%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R245@%%@4@%The function returns a long integer containing the keystroke information.%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  See also%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R246@%%@4@%%@AB@%ReadCmd%@AE@%, %@AB@%KbHook%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Example%@AE@%%@EH@%%@NL@%
%@NL@%
     #define ASCIIBYTE  0x000000FF%@NL@%
     #define SCANBYTE   0x0000FF00%@NL@%
     #define CTRLBIT    0x00040000%@NL@%
     #define SHIFTBIT   0x00010000%@NL@%
     #define NUMLKBIT   0x00200000%@NL@%
%@NL@%
     long keystroke;%@NL@%
     int  ascii_key, scan_byte;%@NL@%
     int  contrl_on, shift_on, numlk_on;%@NL@%
%@NL@%
          keystroke = ReadChar();%@NL@%
          ascii_key = keystroke & ASCIIBYTE;%@NL@%
          scan_byte = (keystroke & SCANBYTE) >>> 8;%@NL@%
          contrl_on = (keystroke & CTRLBIT) > 0;%@NL@%
          shift_on  = (keystroke & SHIFTBIT) > 0;%@NL@%
          numlk_on  = (keystroke & NUMLKBIT) > 0;%@NL@%
%@NL@%
%@NL@%
%@CR:MSE9R250@%%@3@%%@AB@%ReadCmd%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Summary%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R251@%%@AB@%#include <ext.h>%@AE@%%@NL@%
%@NL@%
     %@AB@%PCMD pascal ReadCmd%@AE@%(  );%@NL@%
%@NL@%
%@4@%%@AB@%■  Description%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R252@%%@4@%The %@AB@%ReadCmd%@AE@% function waits for input from the user. The next keystroke is%@EH@%
translated into a function reference (according to current assignments), but
the function is not executed. Instead, the editor passes information about
the function in the form of a structure of type %@AB@%cmdDesc%@AE@%. Once intercepted,
the keystroke cannot be placed back for execution.%@NL@%
%@NL@%
%@4@%%@AB@%■  Return value%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R253@%%@4@%The return value is a structure of type %@AB@%cmdDesc%@AE@%. The structure describes the%@EH@%
command corresponding to the keystroke pressed.%@NL@%
%@NL@%
%@4@%%@AB@%■  See also%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R254@%%@AB@%ReadChar%@AE@%%@NL@%
%@NL@%
%@NL@%
%@CR:MSE9R260@%%@3@%%@AB@%RemoveFile%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Summary%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R261@%%@AB@%#include <ext.h>%@AE@%%@NL@%
%@NL@%
     %@AB@%flagType pascal RemoveFile%@AE@% (%@AI@%pFileRem%@AE@%)%@NL@%
     %@AB@%PFILE%@AE@%%@AI@%pFileRem%@AE@%;%@NL@%
%@NL@%
%@4@%%@AB@%■  Description%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R262@%%@4@%The %@AB@%RemoveFile%@AE@% function removes a file handle from memory, along with the%@EH@%
file buffer and all other memory-resident information about the file.
Calling this function helps to free up main memory, but it has no effect on
the file as stored on disk.%@NL@%
%@NL@%
%@CR:MSE9R263@%%@4@%This function is the converse of the %@AB@%AddFile%@AE@% function. %@AB@%RemoveFile%@AE@% closes a%@EH@%
file. In other words, the file is no longer open for editing. However,
unlike the C function %@AB@%fclose%@AE@%, the %@AB@%RemoveFile%@AE@% function does not force the
writing of the file buffer to disk.%@NL@%
%@NL@%
%@CR:MSE9R264@%%@4@%The parameter %@AI@%pFileRem%@AE@% is the file handle of the file to be removed.%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Return value%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R265@%%@4@%The function does not return a value.%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  See also%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R266@%%@4@%%@AB@%AddFile%@AE@%, %@AB@%FileNameToHandle%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Example%@AE@%%@EH@%%@NL@%
%@NL@%
     RemoveFile( pNewFile );%@NL@%
%@NL@%
%@NL@%
%@CR:MSE9R270@%%@3@%%@AB@%Replace%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Summary%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R271@%%@AB@%#include <ext.h>%@AE@%%@NL@%
%@NL@%
     %@AB@%flagType pascal Replace%@AE@% (%@AI@%c%@AE@%, %@AI@%x%@AE@%, %@AI@%y%@AE@%, %@AI@%pFile%@AE@%, %@AI@%fInsert%@AE@%)%@NL@%
     %@AB@%char%@AE@% %@AI@%c%@AE@%;%@NL@%
     %@AB@%COL%@AE@% %@AI@%x%@AE@%;%@NL@%
     %@AB@%LINE%@AE@% %@AI@%y%@AE@%;%@NL@%
     %@AB@%PFILE%@AE@% %@AI@%pFile%@AE@%;%@NL@%
     %@AB@%flagType%@AE@% %@AI@%fInsert%@AE@%;%@NL@%
%@NL@%
%@4@%%@AB@%■  Description%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R272@%%@4@%The %@AB@%Replace%@AE@% function inserts or replaces characters one at a time. The %@AI@%c%@AE@%%@EH@%
parameter contains the new character. The %@AI@%x%@AE@% and %@AI@%y%@AE@% parameters indicate the
file position──by column and line──where the edit is to take place. Line
numbers are zero based.%@NL@%
%@NL@%
%@CR:MSE9R273@%%@4@%The %@AI@%pFile%@AE@% parameter is a file parameter handle returned by the%@EH@%
%@AB@%FileNameToHandle%@AE@% function. To specify insertion, set %@AI@%fInsert%@AE@% to TRUE
(nonzero). To specify replacement, set %@AI@%fInsert%@AE@% to FALSE (zero).%@NL@%
%@NL@%
%@4@%%@AB@%■  Return value%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R274@%%@4@%The function returns TRUE (nonzero) if the edit is successful and FALSE%@EH@%
(zero) otherwise.%@NL@%
%@NL@%
%@4@%%@AB@%■  See also%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R275@%%@AB@%PutLine%@AE@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Example%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R276@%%@4@%The following code inserts the word "Hello" at line %@AS@%y%@AE@% and column %@AS@%x%@AE@% of the%@EH@%
current file:%@NL@%
%@NL@%
     #define  TRUE  -1%@NL@%
     char    *p; PFILE   cfile;  /* handle to current file */%@NL@%
     .%@NL@%
     .%@NL@%
     .%@NL@%
     cfile = FileNameToHandle( "", NULL );  /* initialize cfile */%@NL@%
     for ( p = "Hello"; *p; p++, y++ )%@NL@%
         Replace( *p, x, y, cfile, TRUE );%@NL@%
%@NL@%
%@NL@%
%@CR:MSE9R280@%%@3@%%@AB@%SetKey%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Summary%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R281@%%@AB@%#include <ext.h>%@AE@%%@NL@%
%@NL@%
     %@AB@%flagType pascal SetKey%@AE@% (%@AI@%name%@AE@%, %@AI@%p%@AE@%)%@NL@%
     %@AB@%char far *%@AE@%%@AI@%name%@AE@%, %@AB@%far *%@AE@%%@AI@%p%@AE@%;%@NL@%
%@NL@%
%@4@%%@AB@%■  Description%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R282@%%@4@%The %@AB@%SetKey%@AE@% function assigns an editing function to a key.%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R283@%%@4@%The %@AI@%name%@AE@% parameter points to a string containing the name of the function,%@EH@%
and the %@AI@%p%@AE@% parameter points to a string that names the key.%@NL@%
%@NL@%
%@4@%%@AB@%■  Return value%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R284@%%@4@%The function returns TRUE (nonzero) if the assignment is successful and%@EH@%
FALSE (zero) otherwise.%@NL@%
%@NL@%
%@4@%%@AB@%■  See also%@AE@%%@EH@%%@NL@%
%@NL@%
     %@CR:MSE9R285@%%@4@%%@AB@%RemoveFile%@AE@%, %@AB@%Replace%@AE@%%@EH@%%@NL@%
%@NL@%
%@4@%%@AB@%■  Example%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSE9R286@%%@4@%The following code assigns the CTRL+X key to the newly defined function%@EH@%
%@AS@%NewFunc%@AE@%:%@NL@%
%@NL@%
     SetKey( "NewFunc", "ctrl+x" );%@NL@%
%@NL@%
%@NL@%
%@CR:MSEa0000@%%@1@%%@AB@%Appendix A  Reference Tables%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@NL@%
%@CR:MSEa1000@%%@2@%%@AB@%A.1  Categories of Editing Functions%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSEa1001@%%@4@%Table A.1 lists the editing functions by category and gives a brief%@EH@%
description of each function.%@NL@%
%@NL@%
%@CR:MSEaT100@%%@4@%%@AU@%Table A.1  Summary of Editing Functions by Category%@AE@%%@EH@%%@NL@%
%@NL@%
%@AB@%Command Manipulation      Description%@AE@%%@NL@%
%@NL@%
%@AI@%Arg%@AE@%                       Introduces an argument or function%@NL@%
%@AI@%Assign%@AE@%                    Assigns function to a keystroke%@NL@%
%@AI@%Boxstream%@AE@%                 Toggles between box and stream mode%@NL@%
%@AI@%Cancel%@AE@%                    Cancels current operation%@NL@%
%@AI@%Execute%@AE@%                   Executes an editor function or macro list%@NL@%
%@AI@%Graphic%@AE@%                   Inserts the ASCII value of the key into the file%@NL@%
%@AI@%Lastselect%@AE@%                Recalls the last cursor-movement argument%@NL@%
%@AI@%Lasttext%@AE@%                  Recalls the last %@AI@%textarg%@AE@% entered%@NL@%
%@AI@%Meta%@AE@%                      Turns on the %@AI@%Meta%@AE@% command prefix%@NL@%
%@AI@%Quote%@AE@%                     Treats next character literally%@NL@%
%@AI@%Repeat%@AE@%                    Repeats the previous command%@NL@%
%@AI@%Undo%@AE@%                      Reverses the effect of the last editing change%@NL@%
%@NL@%
%@AB@%File Operations%@AE@%           %@AB@%Description%@AE@%%@NL@%
%@NL@%
%@AI@%Exit%@AE@%                      Exits the editor, with or without saving%@NL@%
%@AI@%Noedit%@AE@%                    Toggles the no-edit restriction%@NL@%
%@AI@%Paste%@AE@%                     Merges file or program output%@NL@%
%@AI@%Refresh%@AE@%                   Rereads file, discarding edits%@NL@%
%@AI@%Saveall%@AE@%                   Saves all modified files%@NL@%
%@AI@%Setfile%@AE@%                   Saves current file or loads a new file%@NL@%
%@NL@%
%@AB@%Cursor Movement%@AE@%           %@AB@%Description%@AE@%%@NL@%
%@NL@%
%@AI@%Backtab%@AE@%                   Moves cursor left to previous tab stop%@NL@%
%@AI@%Begfile%@AE@%                   Moves cursor to beginning of file%@NL@%
%@AI@%Begline%@AE@%                   Moves cursor left to beginning of line%@NL@%
%@AI@%Down%@AE@%                      Moves cursor down one line%@NL@%
%@AI@%Endfile%@AE@%                   Moves cursor to end of file%@NL@%
%@AI@%Endline%@AE@%                   Moves cursor to right of last character of line%@NL@%
%@AI@%Home%@AE@%                      Moves cursor to upper-left corner of window%@NL@%
%@AI@%Left%@AE@%                      Moves cursor left one character%@NL@%
%@AI@%Mpage%@AE@%                     Moves cursor back by one page%@NL@%
%@AI@%Mpara%@AE@%                     Moves cursor back by paragraphs%@NL@%
%@AI@%Mword%@AE@%                     Moves cursor back by words%@NL@%
%@AI@%Newline%@AE@%                   Moves cursor down to next line%@NL@%
%@AI@%Ppage%@AE@%                     Moves cursor forward by one page%@NL@%
%@AI@%Ppara%@AE@%                     Moves cursor forward by paragraphs%@NL@%
%@AI@%Pword%@AE@%                     Moves cursor forward by words%@NL@%
%@AI@%Right%@AE@%                     Moves cursor right one character%@NL@%
%@AI@%Tab%@AE@%                       Moves cursor right to next tab stop%@NL@%
%@AI@%Up%@AE@%                        Moves cursor up one line%@NL@%
%@NL@%
%@AB@%Mark/Goto Position%@AE@%        %@AB@%Description%@AE@%%@NL@%
%@NL@%
%@AI@%Mark%@AE@%                      Moves cursor to specified position in file%@NL@%
%@AI@%Restcur%@AE@%                   Restores cursor position saved with %@AI@%Savecur%@AE@%%@NL@%
%@AI@%Savecur%@AE@%                   Saves cursor position for use with %@AI@%Restcur%@AE@%%@NL@%
%@AI@%Mlines%@AE@%                    Moves window back by lines%@NL@%
%@AI@%Plines%@AE@%                    Moves window forward by lines%@NL@%
%@AI@%Setwindow%@AE@%                 Redisplays window%@NL@%
%@AI@%Window%@AE@%                    Creates, removes, or moves between windows%@NL@%
%@NL@%
%@AB@%Searching/Replacing%@AE@%       %@AB@%Description%@AE@%%@NL@%
%@NL@%
%@AI@%Mgrep%@AE@%                     Searches a series of files%@NL@%
%@AI@%Mreplace%@AE@%                  Replaces throughout a series of files%@NL@%
%@AI@%Msearch%@AE@%                   Searches backward%@NL@%
%@AI@%Psearch%@AE@%                   Searches forward%@NL@%
%@AI@%Qreplace%@AE@%                  Replaces with confirmation%@NL@%
%@AI@%Replace%@AE@%                   Replaces without confirmation%@NL@%
%@AI@%Searchall%@AE@%                 Highlights all occurrences of a string%@NL@%
%@NL@%
%@AB@%Special Insert%@AE@%            %@AB@%Description%@AE@%%@NL@%
%@NL@%
%@AI@%Curdate%@AE@%                   Inserts current date (e.g., 28-Nov-1988)%@NL@%
%@AI@%Curday%@AE@%                    Inserts current day (Sun...Sat)%@NL@%
%@AI@%Curfile%@AE@%                   Inserts name of current file%@NL@%
%@AI@%Curfileext%@AE@%                Inserts extension of current file%@NL@%
%@AI@%Curfilenam%@AE@%                Inserts base name of current file%@NL@%
%@AI@%Curtime%@AE@%                   Inserts current time (e.g., 13:45:55)%@NL@%
%@NL@%
%@AB@%Inserting/Deleting Text%@AE@%   %@AB@%Description%@AE@%%@NL@%
%@NL@%
%@AI@%Cdelete%@AE@%                   Deletes character to left, excluding line breaks%@NL@%
%@AI@%Copy%@AE@%                      Copies lines to the Clipboard%@NL@%
%@AI@%Delete%@AE@%                    Deletes the highlighted area%@NL@%
%@AI@%Emacscdel%@AE@%                 Deletes character to left, including line breaks%@NL@%
%@AI@%Emacsnewl%@AE@%                 Starts new line, breaking current line%@NL@%
%@AI@%Insert%@AE@%                    Inserts spaces into the highlighted area%@NL@%
%@AI@%Ldelete%@AE@%                   Deletes lines into the Clipboard%@NL@%
%@AI@%Linsert%@AE@%                   Inserts blank lines%@NL@%
%@AI@%Paste%@AE@%                     Inserts text from the Clipboard%@NL@%
%@AI@%Sdelete%@AE@%                   Deletes stream of text, including line breaks%@NL@%
%@AI@%Sinsert%@AE@%                   Inserts blanks, breaking lines if necessary%@NL@%
%@NL@%
%@AB@%Programming%@AE@%               %@AB@%Description%@AE@%%@NL@%
%@NL@%
%@AI@%Argcompile%@AE@%                Performs the %@AI@%Arg Compile%@AE@% command%@NL@%
%@AI@%Compile%@AE@%                   Executes compile or build command%@NL@%
%@AI@%Nextmsg%@AE@%                   Moves cursor to next error message%@NL@%
%@AI@%Pbal%@AE@%                      Balances parentheses and brackets%@NL@%
%@NL@%
%@AB@%Macro Creation%@AE@%            %@AB@%Description%@AE@%%@NL@%
%@NL@%
%@AI@%Assign%@AE@%                    Defines a macro%@NL@%
%@AI@%Message%@AE@%                   Displays message on the dialog line%@NL@%
%@AI@%Record%@AE@%                    Turns macro recording on or off%@NL@%
%@AI@%Tell%@AE@%                      Displays assignment or macro definition%@NL@%
%@NL@%
%@AB@%Miscellaneous%@AE@%             %@AB@%Description%@AE@%%@NL@%
%@NL@%
%@AI@%Environment%@AE@%               Executes and views environment settings%@NL@%
%@AI@%Information%@AE@%               Displays list of previously edited files%@NL@%
%@AI@%Initialize%@AE@%                Rereads initialization file%@NL@%
%@AI@%Insertmode%@AE@%                Toggles insert mode on and off%@NL@%
%@AI@%Print%@AE@%                     Prints all or part of a file%@NL@%
%@AI@%Shell%@AE@%                     Spawns a system-level shell or command line%@NL@%
%@NL@%
%@NL@%
%@CR:MSEa2000@%%@2@%%@AB@%A.2  Key Assignments for Editing Functions%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSEa2001@%%@4@%Table A.2 lists the editing functions and the assigned keys for each of the%@EH@%
configurations provided with the setup program.%@NL@%
%@NL@%
%@CR:MSEaT200@%%@CR:MSEa2002@%%@CR:MSEa2003@%%@4@%%@AU@%Table A.2  Function Assignments%@AE@%%@EH@%%@NL@%
%@TH:  176   6744  3 17 13 13 12 21 @%
                              %@AB@%Quick/%@AE@%
%@AB@%Function         Default      WordStar     BRIEF       Epsilon%@AE@%

%@AI@%Arg%@AE@%              ALT+A        ALT+A        ALT+A       CTRL+U or CTRL+X

%@AI@%Argcompile%@AE@%       ---          F5           ALT+F10     F5

%@AI@%Assign%@AE@%           ALT+=        ALT+=        F7          F1

%@AI@%Backtab%@AE@%          SHIFT+TAB    SHIFT+TAB    SHIFT+TAB   SHIFT+TAB

%@AI@%Begfile%@AE@%          CTRL+PGUP ---             ---         ---

%@AI@%Begline%@AE@%          HOME         HOME or      HOME        CTRL+A
                              CTRL+QS

%@AI@%Boxstream%@AE@%        CTRL+B       ---          ---         ---

%@AI@%Cancel%@AE@%           ESC or       ESC          ESC         CTRL+C
                 CTRL+BREAK

%@AI@%Cdelete%@AE@%          CTRL+G       CTRL+G       BKSP        ---

%@AI@%Compile%@AE@%          CTRL+F3      SHIFT+F3     CTRL+N      SHIFT+F3

%@AI@%Copy%@AE@%             CTRL+INS     CTRL+INS     + (keypad)  ALT+W
                 or press +
                 (keypad)

%@AI@%Curdate%@AE@%          ---          ---          ---         ---

%@AI@%Curday%@AE@%           ---          ---          ---         ---

%@AI@%Curfile%@AE@%          ---          ---          ---         ---

%@AI@%Curfileext%@AE@%       ---          ---          ---         ---

%@AI@%Curfilenam%@AE@%       ---          ---          ---         ---

%@AI@%Curtime%@AE@%          ---          ---          ---         ---

%@AI@%Delete%@AE@%           DEL          ---          ---         ---

%@AI@%Down%@AE@%             DOWN or      DOWN or      DOWN        DOWN or CTRL+N
                 CTRL+X       CTRL+X

%@AI@%Emacscdel%@AE@%        BKSP         BKSP         ---         BKSP or CTRL+H

%@AI@%Emacsnewl%@AE@%        ENTEREND     END or       END         CTRL+E

%@AI@%Endfile%@AE@%          CTRL+PGDN    ---          CTRL+QD     ---

%@AI@%Endline%@AE@%          END          END or       END         CTRL+E
                              CTRL+QD

%@AI@%Environment%@AE@%      ---          ---          ---         ---

%@AI@%Execute%@AE@%          F7           F10          F10         ALT+X

%@AI@%Exit%@AE@%             F8           ALT+X        ALT+X       F8

%@AI@%Home%@AE@%             CTRL+HOME    CTRL+HOME    CTRL+HOME   HOME

%@AI@%Information%@AE@%      SHIFT+F10    SHIFT+F1     ALT+B       SHIFT+F1

%@AI@%Initialize%@AE@%       SHIFT+F8     ALT+F10      SHIFT+F10   ALT+F10

%@AI@%Insert%@AE@%           ---          ---          ---         ---

%@AI@%Insertmode%@AE@%       INS or       INS or       ALT+I       CTRL+V
                 CTRL+V       CTRL+V

%@AI@%Lastselect%@AE@%       CTRL+U       ---          ---         ---

%@AI@%Lasttext%@AE@%         CTRL+O       ALT+L        ALT+L       ALT+L

%@AI@%Ldelete%@AE@%          CTRL+Y       CTRL+Y       ALT+D       CTRL+K

%@AI@%Left%@AE@%             LEFT or      LEFT         LEFT        LEFT or CTRL+B
                 CTRL+S

%@AI@%Linsert%@AE@%          CTRL+N       CTRL+N       CTRL+ENTER  CTRL+O

%@AI@%Mark%@AE@%             CTRL+M       ALT+M        ALT+M       CTRL+@

%@AI@%Message%@AE@%          ---          ---          ---         ---

%@AI@%Meta%@AE@%             F9           F9           F9          F9

%@AI@%Mgrep%@AE@%            ---          ---          ---         ---

%@AI@%Mlines%@AE@%           CTRL+W       CTRL+W       ALT+U       CTRL+W

%@AI@%Mpage%@AE@%            PGUP         PGUP or      PGUP        PGUP or ALT+V
                 CTRL+R       CTRL+R

%@AI@%Mpara%@AE@%            ---          CTRL+PGUP    CTRL+PGUP   ALT+UP

%@AI@%Mreplace%@AE@%         ---          ---          ---         ---

%@AI@%Msearch%@AE@%          F4           F4           ALT+F5      CTRL+R

%@AI@%Mword%@AE@%            CTRL+LEFT    CTRL+LEFT    CTRL+LEFT   CTRL+LEFT or
                 or CTRL+A                             ALT+B

%@AI@%Newline%@AE@%          ---          ---          ENTER       ---

%@AI@%Nextmsg%@AE@%          SHIFT+F3     ---          ---         ---

%@AI@%Noedit%@AE@%           ---          ---          ---         ---

%@AI@%Paste%@AE@%            SHIFT+INS    SHIFT+INS    INS         CTRL+Y or INS

%@AI@%Pbal%@AE@%             CTRL+[       CTRL+[       CTRL+[      CTRL+[

%@AI@%Plines%@AE@%           CTRL+Z       CTRL+Z       CTRL+Z      CTRL+Z

%@AI@%Ppage%@AE@%            PGDN or      PGDN or      PDGN        PDGN
                 CTRL+C       CTRL+C

%@AI@%Ppara%@AE@%            ---          CTRL+PGDN    CTRL+PDGN   ALT+DOWN

%@AI@%Print%@AE@%            CTRL+F8      ---          ---         ---
                 or ALT+F2

%@AI@%Psearch%@AE@%          F3           F3           F5          F4 or CTRL+S

%@AI@%Pword%@AE@%            CTRL+RIGHT   CTRL+RIGHT   CTRL+RIGHT  CTRL+RIGHT
                 or CTRL+F                             or ALT+F

%@AI@%Qreplace%@AE@%         CTRL+\       ALT+F3       F6          ALT+F3 or ALT+5 or
                                                       ALT+8

%@AI@%Quote%@AE@%            CTRL+P       ALT+Q        ALT+Q       CTRL+Q

%@AI@%Record%@AE@%           ALT+R        ---          ---         ---

%@AI@%Refresh%@AE@%          SHIFT+F7     ALT+R        CTRL+]      ALT+R

%@AI@%Repeat%@AE@%           ---          ---          ---         ---

%@AI@%Replace%@AE@%          CTRL+L       CTRL+L       SHIFT+F6    ---

%@AI@%Restcur%@AE@%          ---          ---          ---         ---

%@AI@%Right%@AE@%            RIGHT or     RIGHT or     RIGHT       RIGHT or CTRL+F
                 CTRL+D       CTRL+D

%@AI@%Saveall%@AE@%          ---          ---          ---         ---

%@AI@%Savecur%@AE@%          ---          ---          ---         ---

%@AI@%Sdelete%@AE@%          ---          DEL          DEL or      DEL or
                                           press       CTRL+D
                                           - (keypad)

%@AI@%Searchall%@AE@%        SHIFT+F6     ---          ---         ---

%@AI@%Setfile%@AE@%          F2           F2           ALT+N       F2

%@AI@%Setwindow%@AE@%        CTRL+]       CTRL+]       F2          CTRL+]

%@AI@%Shell%@AE@%            SHIFT+F9     SHIFT+F9     ALT+Z       ALT+Z

%@AI@%Sinsert%@AE@%          CTRL+J       ALT+INS      CTRL+INS    ALT+INS

%@AI@%Tab%@AE@%              TAB          TAB          TAB         TAB or CTRL+I

%@AI@%Tell%@AE@%             CTRL+T       ---          ---         ---

%@AI@%Undo%@AE@%             ALT+BKSP     ALT+BKSP     * (keypad)  CTRL+BKSP

%@AI@%Up%@AE@%               UP or        UP or        UP          UP or CTRL+P
                 CTRL+E       CTRL+E

%@AI@%Window%@AE@%           F6           F6           F1          ALT+PGDN
%@TE:  176   6744  3 17 13 13 12 21 @%
%@NL@%
%@CR:MSEa3000@%%@2@%%@AB@%A.3  Comprehensive Listing of Editing Functions%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSEa3001@%%@4@%Table A.3 gives a comprehensive listing of the editing functions and syntax%@EH@%
for each command. Default keystrokes, if available, are given in
parentheses.%@NL@%
%@NL@%
%@CR:MSEaT300@%%@4@%%@AU@%Table A.3  Comprehensive List of Functions%@AE@%%@EH@%%@NL@%
%@TH:  915  62451  4 16 31 60 @%
Function
(and Default
Keysrokes)      Syntax                         Description

%@AI@%Arg             Arg%@AE@%                            Introduces a function or an argument for a
(ALT+A)                                        function.

%@AI@%Argcompile      Argcompile%@AE@%                     Performs the %@AI@%Arg Compile command%@AE@%. A macro for
                                               this function appears in the TOOLS.PRE file.

%@AI@%Assign          Assign%@AE@%                         Treats the entire line (except for the line
(ALT+=)                                        break) on which the cursor is positioned as a
                                               function assignment or macro definition.

                %@AI@%Arg Assign%@AE@%                     Treats the text from the initial cursor
                                               position to the end of the line (not including
                                               the line break) as a function assignment or
                                               macro definition.

                %@AI@%Arg boxarg Assign%@AE@%              Treats each line of the %@AI@%boxarg%@AE@% as an
                %@AI@%Arg markarg Assign%@AE@%             individual function assignment or macro
                %@AI@%Arg numarg Assign%@AE@%              definition.

                %@AI@%Arg linearg Assign%@AE@%             Treats each line as a separate function
                                               assignment or macro definition, ignoring blank
                                               lines.

                %@AI@%Arg textarg Assign%@AE@%             Treats %@AI@%textarg%@AE@% as a function assignment or
                                               macro definition.

                %@AI@%Arg%@AE@% %@AB@%?%@AE@% %@AI@%Assign%@AE@%                   Displays the current function assignments for
                                               all functions and macros.

%@AI@%Backtab         Backtab%@AE@%                        Moves the cursor to the previous tab stop. Tab
%@AI@%(SHIFT+TAB)%@AE@%                                    stops are defined to be every %@AI@%n%@AE@%th character,
                                               where %@AI@%n%@AE@% is defined by the %@AB@%tabstops%@AE@% switch.

%@AI@%Begfile         Begfile%@AE@%                        Places the cursor at the beginning of the
%@AI@%(CTRL+PGUP)%@AE@%                                    file.

%@AI@%Begline         Begline%@AE@%                        Places the cursor on the first nonblank
(HOME)                                         character on the line.

                %@AI@%Meta Begline%@AE@%                   Places the cursor in the first character
                                               position of the line.

%@AI@%Boxstream       Boxstream%@AE@%                      Toggles between box mode and stream mode. In
(CTRL+B)                                       box mode, each
                                               cursor-movement is interpreted as a
                                               rectangular-shaped %@AI@%linearg%@AE@% or
                                               %@AI@%boxarg%@AE@%. In stream mode, the editor highlights
                                               all file positions between initial and new
                                               cursor position.

%@AI@%Cancel          Cancel%@AE@%                         Cancels the current operation in
(ESC)                                          progress.

%@AI@%Cdelete         Cdelete%@AE@%                        Deletes the previous character, excluding line
(CTRL+G)                                       breaks. If the cursor is in column 1, %@AI@%Cdelete%@AE@%
                                               moves the cursor to the end of the previous
                                               line. If issued in insert mode, %@AI@%Cdelete%@AE@%
                                               deletes the previous character, reducing the
                                               length of the line by 1; otherwise, it deletes
                                               the previous character and replaces it with a
                                               blank. If the cursor is beyond the end of the
                                               line when the function is invoked, the cursor
                                               is moved to the immediate right of the last
                                               character on the line.

%@AI@%Compile         Compile%@AE@%                        Displays status of the current compilation (if
(CTRL+F3)                                      any) on the dialog line.

                %@AI@%Arg Compile%@AE@%                    Compiles the current file. Uses the %@AB@%extmake%@AE@%
                                               command line that matches the filename
                                               extension of the current file.

                %@AI@%Arg textarg Compile%@AE@%            Uses the command line specified by
                                               %@AB@%extmake:text%@AE@%. The %@AI@%textarg%@AE@% replaces %s in the
                                               command line. See Table A.5%@BO:   701fe@% for more
                                               information on
                                               %@AB@%extmake%@AE@%.

                %@AI@%Arg Arg textarg Compile%@AE@%        Invokes the specified text as a program. The
                                               program is assumed to display its errors in
                                               the following format: %@AI@%file row column message%@AE@%.

                %@AI@%Arg Meta Compile%@AE@%               OS/2 only. Kills a protected-mode compilation
                                               running in the background, after prompting for
                                               confirmation.

%@AI@%Copy            Copy%@AE@%                           Copies the current line into the
(CTRL+INS, or                                  Clipboard.
press + on
numeric keypad)

                %@AI@%Arg Copy%@AE@%                       Copies text from the initial cursor position
                                               to the end of the line and places it into the
                                               Clipboard. Note that the line break is not
                                               picked up.

                %@AI@%Arg boxarg Copy%@AE@%                Copies the highlighted text into the
                %@AI@%Arg linearg Copy%@AE@%               Clipboard.
                %@AI@%Arg streamarg Copy%@AE@%
                %@AI@%Arg textarg Copy%@AE@%

                %@AI@%Arg markarg Copy%@AE@%               Copies the range of text between the cursor
                                               and the location of the file marker into the
                                               Clipboard. In %@AI@%stream%@AE@% mode, a stream of text is
                                               selected. In %@AI@%box%@AE@% mode, the text is treated as
                                               a %@AI@%boxarg%@AE@% or %@AI@%linearg%@AE@% depending on the
                                               relative positions of the initial cursor position and
                                               the file marker.

                %@AI@%Arg numarg Copy%@AE@%                Copies the specified number
                                               of lines into the Clipboard, starting with the
                                               current line.

%@AI@%Curdate         Curdate%@AE@%                        Inserts the current date at the cursor in the
                                               format of 28-Nov-1988.

%@AI@%Curday          Curday%@AE@%                         Inserts the current day at the cursor in the
                                               format of Sun...Sat.

%@AI@%Curfile         Curfile%@AE@%                        Inserts the fully qualified path name of the
                                               current file at the cursor.

%@AI@%Curfileext      Curfileext%@AE@%                     Inserts the extension of the current file at
                                               the cursor.

%@AI@%Curfilenam      Curfilenam%@AE@%                     Inserts the base name of the current file at
                                               the cursor.

%@AI@%Curtime         Curtime%@AE@%                        Inserts the current time at the cursor in the
                                               format of 13:45:55.

%@AI@%Delete          Delete%@AE@%                         Deletes the single character under the cursor,
(DEL)                                          excluding line breaks. The deleted character
                                               is not placed into the Clipboard.

                %@AI@%Arg Delete%@AE@%                     Deletes all text from the current cursor
                                               position to the end of the line. The deleted
                                               text (including the line break) is placed into
                                               the Clipboard. This command has the effect of
                                               joining lines.

                %@AI@%Arg boxarg Delete%@AE@%              Deletes the highlighted text. The
                %@AI@%Arg linearg Delete%@AE@%             deleted text is placed into the Clipboard.
                %@AI@%Arg streamarg Delete%@AE@%

                %@AI@%Arg Meta Delete%@AE@%                Performs the deletions as described above,
                %@AI@%Arg boxarg Meta Delete%@AE@%         except the deleted text is not placed into the
                %@AI@%Arg linearg Meta Delete%@AE@%        Clipboard.
                %@AI@%Arg streamarg Meta Delete%@AE@%

%@AI@%Down            Down%@AE@%                           Moves the cursor down one line. If this would
(DOWN or                                       result in the cursor moving out of the window,
CTRL+X)                                        the window is adjusted downward by the number
                                               of lines specified by the %@AB@%vscroll%@AE@% switch or
                                               less if in a small window.

                %@AI@%Meta Down%@AE@%                      Moves the cursor to the bottom of the window
                                               without changing the column position.

%@AI@%Emacscdel       Emacscdel%@AE@%                      Performs similarly to %@AI@%Cdelete%@AE@%, except that at
(BKSP)                                         the beginning of a line while in insert mode,
                                               %@AI@%Emacscdel%@AE@% deletes the line break between the
                                               current line and the previous line, joining
                                               the two lines together.

%@AI@%Emacsnewl       Emacsnewl%@AE@%                      Performs similarly to %@AI@%Newline%@AE@%, except that
(ENTER)                                        when in insert mode, it breaks the current
                                               line at the cursor position.

%@AI@%Endfile         Endfile%@AE@%                        Places the cursor at the end of the file.
(CTRL+PGDN)

%@AI@%Endline         Endline%@AE@%                        Moves the cursor to the immediate right of the
(END)                                          last nonblank character on the line.

                %@AI@%Meta Endline%@AE@%                   Moves the cursor one character be-yond the
                                               column corresponding to the rightmost edge of
                                               the window.

%@AI@%Environment     Environment%@AE@%                    Executes the current line as an
                                               environment-variable setting. For example,
                                               assume the current line contains the following
                                               text:

                                               %@AS@%PATH=C:\BIN;C:\DOS%@AE@%

                                               The editor responds by adding this setting to
                                               the operating system environment space. This
                                               function is essentially the same as the
                                               system-level SET command. The editor
                                               recognizes the setting during the rest of the
                                               editing session, but the setting is lost when
                                               you exit the editor.

                %@AI@%Arg boxarg Environment%@AE@%         Executes each highlighted line or line
                %@AI@%Arg linearg Environment%@AE@%        fragment as an environment-
                                               variable setting.

                %@AI@%Arg textarg Environment%@AE@%        Executes the text argument as an
                                               environment-variable setting.

                %@AI@%Arg%@AE@% %@AB@%?%@AE@% %@AI@%Environment%@AE@%              Displays all current environment-variable
                                               settings.

                %@AI@%Meta Environment%@AE@%               Performs environment "mappings" for all
                                               environment variables found on the current
                                               line, whenever the variable appears in the
                                               following
                                               syntax:

                                               %@AB@%$(%@AE@%%@AI@%environment-variable%@AE@%%@AB@%)%@AE@%

                                               For each such environment variable appearing
                                               on the line, the editor replaces the variable
                                               with the corresponding setting. For
                                               example, if PATH is set to %@AS@%C:\BIN%@AE@%, the editor
                                               replaces each occurrence of the text %@AS@%$(PATH)%@AE@%
                                               with the text %@AS@%C:\BIN%@AE@%.

                %@AI@%Arg Meta Environment%@AE@%           Performs environment mappings (see description
                                               above) for all text from the cursor position
                                               to the end of line.

                %@AI@%Arg linearg Meta Environment%@AE@%   Performs environment mappings (see description
                %@AI@%Arg boxarg Meta Environment%@AE@%    above) for all highlighted text.
                %@AI@%Arg streamarg Meta Environment%@AE@%

%@AI@%Execute         Arg Execute%@AE@%                    Treats the line from the initial cursor
(F7)                                           position to the end as a series of
                                               Microsoft Editor commands and executes them.

                %@AI@%Arg linearg Execute%@AE@%            Treats the specified text as Microsoft Editor
                %@AI@%Arg textarg Execute%@AE@%            commands and executes them, following the
                                               standard rules of macro execution.

%@AI@%Exit            Exit%@AE@%                           Saves the current file. If multiple files were
(F8)                                           specified on the command line, the editor
                                               advances to the next file. Otherwise, the
                                               editor quits and returns control to the
                                               operating system.

                %@AI@%Meta Exit%@AE@%                      Performs similarly to %@AI@%Exit%@AE@%, except that the
                                               current file is not saved.

                %@AI@%Arg Exit%@AE@%                       Performs similarly to %@AI@%Exit%@AE@%, except that if
                                               multiple files are specified on the command
                                               line, the editor exits without advancing to
                                               the next file.

                %@AI@%Arg Meta Exit%@AE@%                  Performs similarly to %@AI@%Arg Exit%@AE@%, except that
                                               the editor does not save the current file.

%@AI@%Home            Home%@AE@%                           Places the cursor in the upper-left corner of
%@AI@%(CTRL+HOME)%@AE@%                                    the current window.

%@AI@%Information     Information%@AE@%                    Saves the current file and loads an
(F10)                                          information file that contains a list of all
                                               files in memory along with the current set of
                                               files that you have edited. The size of this
                                               list is con-trolled by the %@AB@%tmpsav switch%@AE@%,
                                               which has a default value of 20.

%@AI@%Initialize      Initialize%@AE@%                     Reads all the editor statements from the [M]
(SHIFT+F8)                                     section of TOOLS.INI.

                %@AI@%Arg Initialize%@AE@%                 Reads the editor statements from the TOOLS.INI
                                               file, using the continuous string of nonblank
                                               characters, starting with the initial cursor
                                               position, as the tag name.

                %@AI@%Arg textarg Initialize%@AE@%         Reads all the editor statements from the
                                               [M-%@AI@%textarg%@AE@%] section of TOOLS.INI.

%@AI@%Insert          Insert%@AE@%                         Inserts a single blank space at the current
                                               cursor position.

                %@AI@%Arg Insert%@AE@%                     Inserts a carriage return at the initial
                                               cursor position, splitting the line.

                %@AI@%Arg streamarg Insert%@AE@%           Inserts blank spaces into the highlighted
                %@AI@%Arg linearg Insert%@AE@%             area.
                %@AI@%Arg boxarg Insert%@AE@%

%@AI@%Insertmode      Insertmode%@AE@%                     Toggles between insert mode and overtype mode.
(INS or                                        If insert mode is on, %@AS@%insert%@AE@% appears on the
CTRL+V)                                        status line. While in insert mode, each
                                               character that is entered is inserted at the
                                               cursor position, shifting the remainder of the
                                               line one position to the right. Overtype mode
                                               replaces the character at the cursor position
                                               with the character you type.

%@AI@%Lastselect      Lastselect%@AE@%                     Recalls the last cursor-movement argument.
(CTRL+U)                                       This function produces the same result as
                                               returning to the last %@AI@%Arg%@AE@% position, invoking
                                               the %@AI@%Arg%@AE@% function, and then recreating the last
                                               cursor-movement argument.

%@AI@%Lasttext        Lasttext%@AE@%                       Recalls the last %@AI@%textarg%@AE@%. This function
(CTRL+O)                                       produces the same result as invoking the %@AI@%Arg%@AE@%
                                               function and then retyping the previous
                                               %@AI@%textarg%@AE@%.

%@AI@%Ldelete         Ldelete%@AE@%                        Deletes the current line and places it into
(CTRL+Y)                                       the Clipboard.

                %@AI@%Arg Ldelete%@AE@%                    Deletes text, starting with the initial cursor
                                               position through the end of the line, and
                                               places it into the Clipboard. Note that it
                                               does not join the current line with the next
                                               line.

                %@AI@%Arg boxarg Ldelete%@AE@%             Deletes the specified text from the file and
                %@AI@%Arg linearg Ldelete%@AE@%            places it into the Clipboard, treating the
                                               argument as a %@AI@%linearg%@AE@% or %@AI@%boxarg%@AE@% regardless of
                                               what mode the editor is in.

%@AI@%Left            Left%@AE@%                           Moves the cursor one character to the left. If
%@AI@%(LEFT or%@AE@%                                       this would result in the cursor moving out of
%@AI@%CTRL+S)%@AE@%                                        the window, the window is adjusted to the left
                                               by the number of columns specified by the
                                               %@AB@%hscroll%@AE@% switch or less if in a small window.

                %@AI@%Meta Left%@AE@%                      Moves the cursor to the left-most position in
                                               the window on the same line.

%@AI@%Linsert         Linsert%@AE@%                        Inserts one blank line above the current line.
(CTRL+N)

                %@AI@%Arg Linsert%@AE@%                    Inserts or deletes blanks at the beginning of
                                               a line to make the first nonblank character
                                               appear under the cursor.

                %@AI@%Arg boxarg Linsert%@AE@%             Fills the specified area with blanks, treating
                %@AI@%Arg linearg Linsert%@AE@%            the argument as a %@AI@%linearg%@AE@% or %@AI@%boxarg%@AE@% regardless
                                               of the editor's mode.

%@AI@%Mark            Mark%@AE@%                           Moves the window to the beginning of the file.
(CTRL+M)

                %@AI@%Arg Mark%@AE@%                       Restores the window to its previous location.
                                               The editor remembers only the location prior
                                               to the last scrolling operation.

                %@AI@%Arg numarg Mark%@AE@%                Moves the cursor to the beginning of the line,
                                               where %@AI@%numarg%@AE@% specifies the position of the
                                               line in the file.

                %@AI@%Arg textarg Mark%@AE@%               Moves the cursor to the specified file marker.
                                               If the file marker was not previously defined,
                                               the editor uses the %@AB@%markfile%@AE@% switch to find
                                               the file that contains file marker
                                               definitions.

                %@AI@%Arg Arg textarg Mark%@AE@%           Deletes a marker definition.

                %@AI@%Arg Arg textarg Meta Mark%@AE@%      Defines a file marker at the initial cursor
                                               position. This does not record the file marker
                                               in the file specified by the %@AB@%markfile%@AE@% switch,
                                               but allows you to refer to this position as
                                               %@AI@%textarg%@AE@%.

%@AI@%Message         Message%@AE@%                        Clears the dialog line.

                %@AI@%Arg textarg Message%@AE@%            Prints the text argument on the dialog line.

%@AI@%Meta            Meta%@AE@%                           Modifies the action of the function it is used
(F9)                                           with. Refer to the individual functions for
                                               specific information.

%@AI@%Mgrep           Mgrep%@AE@%                          Searches for the previously defined string or
                                               pattern. The editor searches all files listed
                                               in the %@AS@%mgreplist%@AE@% macro, which can contain DOS
                                               wildcards and environment variables, as in the
                                               following example:

                                               %@AS@%megreplist:="DATA.FIL *.FOR  $INCLUDE:*.H"%@AE@%

                                               The editor places all strings found in the
                                               <compile> pseudo file.

                %@AI@%Arg Mgrep%@AE@%                      Searches files for the string defined as the
                                               characters from the initial cursor position to
                                               the first blank character.

                %@AI@%Arg textarg Mgrep%@AE@%              Searches files for the specified text.

                %@AI@%Arg Arg Mgrep%@AE@%                  Searches files for the regular expression
                                               defined as the characters from the initial
                                               cursor position to the first blank character.

                %@AI@%Arg Arg textarg Mgrep%@AE@%          Searches files for a regular expression as
                                               defined by %@AI@%textarg%@AE@%.

                %@AI@%Meta Mgrep%@AE@%                     Performs similarly to command form above,
                %@AI@%Arg Meta Mgrep%@AE@%                 except that value of the %@AB@%case%@AE@% switch is
                %@AI@%Arg textarg Meta Mgrep%@AE@%         temporarily reversed.
                %@AI@%Arg Arg Meta Mgrep%@AE@%
                %@AI@%Arg Arg textarg Meta Mgrep%@AE@%

%@AI@%Mlines          Mlines%@AE@%                         Moves the window back by the number of lines
(CTRL+W)                                       specified by the %@AB@%vscroll%@AE@% switch or less if in
                                               a small window.

                %@AI@%Arg Mlines%@AE@%                     Moves the window until the line that the
                                               cursor is on is at the bottom of the window.

                %@AI@%Arg numarg Mlines%@AE@%              Moves the window back by the specified number
                                               of lines.

%@AI@%Mpage           Mpage%@AE@%                          Moves the window backward in the file by one
(PGUP or                                       window's worth of lines.
CTRL+R)

%@AI@%Mpara           Mpara%@AE@%                          Moves the cursor to the first blank line
                                               preceding the current paragraph, or if
                                               currently on a blank line, the cursor is
                                               positioned before the previous paragraph.

                %@AI@%Meta Mpara%@AE@%                     Moves the cursor to the first previous line
                                               that has text.

%@AI@%Mreplace        Mreplace%@AE@%                       Performs a simple search-and-
                                               replace operation, prompting you for the
                                               search and replacement strings, and prompting
                                               at each occurrence for confirmation. The
                                               function searches all the file listed in the
                                               %@AS@%mgreplist%@AE@% macro, which can contain DOS
                                               wildcards and environment variables, as in the
                                               following example:

                                               %@AS@%megreplist:="DATA.FIL *.FOR   $INCLUDE:*.H"%@AE@%

                %@AI@%Arg Arg Mreplace%@AE@%               Performs the same action as
                                               %@AI@%Mreplace%@AE@%, but uses regular-
                                               expression syntax.

%@AI@%Msearch         Msearch%@AE@%                        Searches backward for the previously defined
(F4)                                           string or pattern. If the string or pattern is
                                               found, the window is moved to display it and
                                               the matched string or pattern is high-lighted.
                                               If no match is found, no cursor movement takes
                                               place and a message is displayed.

                %@AI@%Arg Msearch%@AE@%                    Searches backward in the file for the string
                                               defined as the characters from the initial
                                               cursor position to the first blank character.

                %@AI@%Arg textarg Msearch%@AE@%            Searches backward for the specified text.

                %@AI@%Arg Arg Msearch%@AE@%                Searches backward in the file for the regular
                                               expression defined as the characters from the
                                               initial cursor position to the first blank
                                               character.

                %@AI@%Arg Arg textarg Msearch%@AE@%        Searches backward for a regular expression as
                                               defined by %@AI@%textarg%@AE@%.

                %@AI@%Meta Msearch%@AE@%                   Performs similarly to command form above,
                %@AI@%Arg Meta Msearch%@AE@%               except that value of the %@AB@%case%@AE@% switch is
                %@AI@%Arg textarg Meta Msearch%@AE@%       temporarily reversed.
                %@AI@%Arg Arg Meta Msearch%@AE@%
                %@AI@%Arg Arg textarg Meta Msearch%@AE@%

%@AI@%Mword           Mword%@AE@%                          Moves the cursor to the beginning of a word.
(CTRL+LEFT                                     If not in a word or at the first character,
or CTRL+A)                                     uses the previous word; otherwise, uses the
                                               current word.

                %@AI@%Meta Mword%@AE@%                     Moves the cursor to the immediate right of the
                                               previous word.

%@AI@%Newline         Newline%@AE@%                        Moves the cursor to a new line. If the %@AB@%softcr%@AE@%
                                               switch is set, the editor tries to place the
                                               cursor in an appropriate position based on the
                                               type of file. If the file is a C program, the
                                               editor tries to tab in based on continuation
                                               of lines and on open blocks. If the next line
                                               is blank, the editor places the cursor in the
                                               column corresponding to the first nonblank
                                               character of the previous line. If neither of
                                               the above is true, the editor places the
                                               cursor on the first nonblank character of the
                                               line.

                %@AI@%Meta Newline%@AE@%                   Moves the cursor to column 1 of the next line.

%@AI@%Nextmsg         Nextmsg%@AE@%                        Advances to next error message.
(SHIFT+F3)

                %@AI@%Arg numarg Nextmsg%@AE@%             Moves forward or backward %@AI@%numarg%@AE@% error
                                               messages. A %@AI@%numarg%@AE@% value of 1 moves to next
                                               message; a value of -1 moves to previous
                                               message.

                %@AI@%Arg Nextmsg%@AE@%                    Moves to the next error message (within
                                               current set of messages) that does not refer
                                               to current file.

                %@AI@%Arg Arg Nextmsg%@AE@%                Positions the text-file cursor at the line
                                               with the error described in the error message
                                               at the current cursor position in the
                                               <compile> pseudo file. This message becomes
                                               the current error message. The following
                                               %@AI@%Nextmsg%@AE@% command displays the next error
                                               message from the <compile> pseudo file.

                %@AI@%Meta Nextmsg%@AE@%                   OS/2 only. Advance to next "set" of error
                                               messages, in which a set corresponds to all
                                               the error messages for a single compilation.
                                               After executing this command, the previous set
                                               is deleted (though you can still view all
                                               subsequent sets of error messages in the
                                               <compile> pseudo file, until deleted).

%@AI@%Noedit          Noedit%@AE@%                         Reverses the no-edit condition, so that if the
                                               editor was started with the /R (read only)
                                               option, this command removes the no-edit
                                               limitation. If the editor is not in the
                                               no-edit state, this command disallows all
                                               editing commands that alter a file.

                %@AI@%Meta Noedit%@AE@%                    Reverses the no-edit condition for the current
                                               file.

%@AI@%Paste           Paste%@AE@%                          Inserts the contents of the Clipboard prior to
%@AI@%(SHIFT+INS)%@AE@%                                    the current line if the contents were placed
                                               there in a line-oriented way, such as with
                                               %@AI@%linearg%@AE@% or %@AI@%numarg%@AE@%. Otherwise, the contents of
                                               the Clipboard are inserted at the current
                                               cursor position.

                %@AI@%Arg Paste%@AE@%                      Inserts the text from the initial cursor
                                               position to the end of the line at the initial
                                               cursor position.

                %@AI@%Arg textarg Paste%@AE@%              Places the specified text into the Clipboard
                                               and inserts that text at the initial cursor
                                               position.

                %@AI@%Arg Arg textarg Paste%@AE@%          Interprets %@AI@%textarg%@AE@% as a file name
                                               and inserts the contents of that file into the
                                               current file above the current line.

                %@AI@%Arg Arg%@AE@% %@AB@%!%@AE@%%@AI@%textarg Paste%@AE@%         Treats the text as a DOS command and inserts
                                               its output to stdout into the current file at
                                               the initial cursor position. The exclamation
                                               mark must be entered as shown.

%@AI@%Pbal            Pbal%@AE@%                           Scans backward through the file, balancing
(CTRL+[)                                       parentheses and brackets. The first unbalanced
                                               one is highlighted when found. If it is found
                                               and is not visible, the editor displays the
                                               matching line on the dialog line, with the
                                               highlighted matching character. The
                                               corresponding character is placed into the
                                               file at the current cursor position.  Note
                                               that the search does not include the current
                                               cursor position and that the scan only looks
                                               for more left brackets or parentheses than
                                               right, not just an unequal amount.

                %@AI@%Arg Pbal%@AE@%                       Performs similarly to %@AI@%Pbal%@AE@% except that it
                                               scans forward in the file and looks for more
                                               right brackets or parentheses than left.

                %@AI@%Meta Pbal%@AE@%                      Performs similarly to %@AI@%Pbal%@AE@% except that the
                                               file is not updated.

                %@AI@%Arg Meta Pbal%@AE@%                  Performs similarly to %@AI@%Arg Pbal%@AE@% except that the
                                               file is not updated.

%@AI@%Plines          Plines%@AE@%                         Adjusts the window forward by the number of
(CTRL+Z)                                       lines specified by the %@AB@%vscroll%@AE@% switch or less
                                               if in a small window.

                %@AI@%Arg Plines%@AE@%                     Moves the window downward so the line that the
                                               cursor is on is at the top of the window.

                %@AI@%Arg numarg Plines%@AE@%              Moves the window forward the specified number
                                               of lines.

%@AI@%Ppage           Ppage%@AE@%                          Moves the window forward in the file by one
(PGDN or                                       window's worth of lines.
CTRL+C)

%@AI@%Ppara           Ppara%@AE@%                          Moves the cursor forward one paragraph and
                                               places the cursor on the first line of the new
                                               paragraph.

                %@AI@%Meta Ppara%@AE@%                     Moves the cursor to the first blank line
                                               following the current paragraph.

%@AI@%Print           Print%@AE@%                          Prints the current file. If the %@AB@%printcmd%@AE@%
(CTRL+F8)                                      switch is set, this function uses the
                                               system-level command given in the switch.
                                               Otherwise, the function copies output to LPT1.

                %@AI@%Arg textarg Print%@AE@%              Prints all the files listed in the text
                                               argument. File names should be sepa- rated
                                               with a space.

                %@AI@%Arg linearg Print%@AE@%              Prints the highlighted area.
                %@AI@%Arg boxarg Print%@AE@%
                %@AI@%Arg streamarg Print%@AE@%

%@AI@%Psearch         Psearch%@AE@%                        Searches forward for the previously defined
(F3)                                           string or pattern. If the string or pattern is
                                               found, the window is moved to display it and
                                               the matched string or pattern is highlighted.
                                               If it is not found, no cursor movement takes
                                               place and a message is displayed.

                %@AI@%Arg Psearch%@AE@%                    Searches forward in the file for the string
                                               defined as the characters from the initial
                                               cursor position to the first blank character.

                %@AI@%Arg textarg Psearch%@AE@%            Searches forward for the specified text.

                %@AI@%Arg Arg Psearch%@AE@%                Searches forward in the file for the regular
                                               expression defined as the characters from the
                                               initial cursor position to the first blank
                                               character.

                %@AI@%Arg Arg textarg Psearch%@AE@%        Searches forward for a regular expression as
                                               defined by %@AI@%textarg%@AE@%.

                %@AI@%Meta Psearch%@AE@%                   Performs similarly to command form above,
                %@AI@%Arg Meta Psearch%@AE@%               except that value of the %@AB@%case%@AE@% switch is
                %@AI@%Arg textarg Meta Psearch%@AE@%       temporarily reversed.
                %@AI@%Arg Arg Meta Psearch%@AE@%
                %@AI@%Arg Arg textarg Meta Psearch%@AE@%

%@AI@%Pword           Pword%@AE@%                          Moves the cursor forward one word and places
(CTRL+RIGHT                                    the cursor on the beginning of the new word.
or CTRL+F)

                %@AI@%Meta Pword%@AE@%                     Moves cursor to immediate right of current
                                               word or, if not in a word, to the right of the
                                               next word.

%@AI@%Qreplace        Qreplace%@AE@%                       Performs a simple search-and-
(CTRL+\)                                       replace operation, prompting you for the
                                               search and replacement strings, and prompting
                                               at each occurrence for confirmation. The
                                               search begins at the cursor position and
                                               continues through the end of the file.

                %@AI@%Arg boxarg Qreplace%@AE@%            Perform the search-and-replace operation over
                %@AI@%Arg linearg Qreplace%@AE@%           the highlighted area, prompting at each
                %@AI@%Arg streamarg Qreplace%@AE@%         occurrence for confirmation.

                %@AI@%Arg markarg Qreplace%@AE@%           Performs the search-and-replace operation
                                               between the initial cursor position and the
                                               specified file marker, prompting at each
                                               occurrence for confirmation.

                %@AI@%Arg numarg Qreplace%@AE@%            Performs the search-and-replace operation over
                                               the specified number of lines, starting with
                                               the current line, prompting at each occurrence
                                               for confirmation.

                %@AI@%Arg Arg Qreplace%@AE@%               Performs the same as the corresponding command
                %@AI@%Arg Arg boxarg Qreplace%@AE@%        listed above, except that the search pattern
                %@AI@%Arg Arg linearg Qreplace%@AE@%       is a regular expression and the replacement
                %@AI@%Arg Arg streamarg Qreplace%@AE@%     pattern can select special tagged sections of
                %@AI@%Arg Arg markarg Qreplace%@AE@%       the search for selective replacement. See
                %@AI@%Arg Arg numarg Qreplace%@AE@%        Chapter 5%@BO:   206bc@% for more information.


%@AI@%Quote           Quote%@AE@%                          Reads one keystroke from the keyboard and
(CTRL+P)                                       treats it literally. This is useful for
                                               inserting text into a file that happens to be
                                               assigned to an editor function.

%@AI@%Record          Record%@AE@%                         Turns on macro recording if off, and off if
(ALT+R)                                        on. When a recording is stopped, the editor
                                               assigns all the recorded commands to the
                                               default macro name recordvalue. During the
                                               recording, the name of each command is written
                                               to the <record> pseudo file, which can be
                                               placed in a window and viewed as it is
                                               dynamically updated.

                %@AI@%Arg textarg Record%@AE@%             Turns on macro recording if off and gives
                                               recording the name specified in the text
                                               argument or turns recording off if on.

                %@AI@%Meta Record%@AE@%                    Turns recording on if recording state is off,
                                               but no editing commands are executed until
                                               recording is turned off. Turns recording off
                                               if it is on.

                %@AI@%Arg Arg Record%@AE@%                 Performs identically to the corresponding
                %@AI@%Arg Arg textarg Record%@AE@%         command listed above, but if the target macro
                %@AI@%Arg Arg Meta Record%@AE@%            already exists, editing commands are appended
                                               to the end of the macro.

%@AI@%Refresh         Refresh%@AE@%                        Asks for confirmation and then rereads the
(SHIFT+F7)                                     file from disk, discarding all edits since the
                                               file was last saved.

                %@AI@%Arg Refresh%@AE@%                    Asks for confirmation and then discards the
                                               file from memory, loading the last file edited
                                               in its place.

%@AI@%Repeat          Repeat%@AE@%                         Repeats the last editing command, using
                                               precisely the same arguments and %@AI@%Meta%@AE@%
                                               condition used by the last command. However,
                                               the command is executed relative to the new
                                               cursor position. (Note: if the previous
                                               command had a cursor-movement argument, the
                                               text actually high-lighted is reused as the
                                               argument.)

%@AI@%Replace         Replace%@AE@%                        Performs a simple search-and-
(CTRL+L)                                       replace operation without confirmation,
                                               prompting you for the search string and
                                               replacement string. The search begins at
                                               the cursor position and continues through
                                               the end of the file.

                %@AI@%Arg boxarg Replace%@AE@%             Performs the search-and-replace operation over
                %@AI@%Arg linearg Replace%@AE@%            the highlighted area.
                %@AI@%Arg streamarg Replace%@AE@%

                %@AI@%Arg markarg Replace%@AE@%            Performs the search-and-replace operation
                                               between the cursor and the specified file
                                               marker.

                %@AI@%Arg numarg Replace%@AE@%             Performs the search-and-replace operation over
                                               the specified number of lines, starting with
                                               the current line.

                %@AI@%Arg Arg Replace%@AE@%                Performs the same as the corresponding command
                %@AI@%Arg Arg boxarg Replace%@AE@%         listed above except that the search pattern is
                %@AI@%Arg Arg linearg Replace%@AE@%        a regular expression and the replacement
                %@AI@%Arg Arg streamarg Replace%@AE@%      pattern can select special tagged sections of
                %@AI@%Arg Arg markarg Replace%@AE@%        the search for selective replacement. See
                %@AI@%Arg Arg numarg Replace%@AE@%         Chapter 5%@BO:   206bc@% for more information.


%@AI@%Restcur         Restcur%@AE@%                        Restores the cursor position saved with
                                               %@AI@%Savecur%@AE@%.

%@AI@%Right (RIGHT    Right%@AE@%                          Moves the cursor one character to the right.
%@AI@%or CTRL+D)%@AE@%                                     If this would result in the cursor moving out
                                               of the window,  the window is adjusted to the
                                               right the number of columns specified by the
                                               %@AB@%hscroll%@AE@% switch or less if in a small window.

                %@AI@%Meta Right%@AE@%                     Moves the cursor to the right-most position in
                                               the window.

%@AI@%Saveall         Saveall%@AE@%                        Saves all files that have been altered during
                                               the current editing session without being
                                               saved.

%@AI@%Savecur         Savecur%@AE@%                        Saves the current cursor position to be
                                               restored with %@AI@%Restcur%@AE@%.

%@AI@%Sdelete         Sdelete%@AE@%                        Deletes the single character under the cursor,
(DEL)                                          excluding line breaks. It does not place the
                                               deleted character into the Clipboard. This
                                               command has the effect of joining lines.

                %@AI@%Arg Sdelete%@AE@%                    Deletes from the current line at the point of
                                               the cursor position. The text deleted
                                               (including the line break) is placed into the
                                               Clipboard.

                %@AI@%Arg streamarg Sdelete%@AE@%          Deletes the stream of text from the initial
                                               cursor position up to the current cursor
                                               position and places it into the Clipboard.

%@AI@%Searchall       Searchall%@AE@%                      Highlights all occurrences of the previously
(SHIFT+F6)                                     defined string or pattern. If at least one
                                               occurrence is found, the cursor moves to the
                                               first occurrence in the file.

                %@AI@%Arg Searchall%@AE@%                  Highlights all occurrences of the string
                                               defined as the characters from the initial
                                               cursor position to the first blank character.

                %@AI@%Arg textarg Searchall%@AE@%          Highlights all occurrences of the specified
                                               text.

                %@AI@%Arg Arg Searchall%@AE@%              Highlights all occurrences of the regular
                                               expression defined as the char- acters from
                                               the initial cursor position to the first blank
                                               character.

                %@AI@%Arg Arg textarg Searchall%@AE@%      Highlights all occurrences of a regular
                                               expression as defined by %@AI@%textarg%@AE@%.

                %@AI@%Meta Searchall%@AE@%                 Performs similarly to command forms above,
                %@AI@%Arg Meta Searchall%@AE@%             except that the value of the %@AB@%case%@AE@% switch is
                %@AI@%Arg textarg Meta Searchall%@AE@%     temporarily reversed.
                %@AI@%Arg Arg Meta Searchall%@AE@%
                %@AI@%Arg Arg textarg Meta Searchall%@AE@%

%@AI@%Setfile         Setfile%@AE@%                        Switches to the most recently edited file,
(F2)                                           saving any changes made to the current file to
                                               disk.

                %@AI@%Arg Setfile%@AE@%                    Switches to the file name that begins at the
                                               initial cursor position and ends with the
                                               first blank.

                %@AI@%Arg textarg Setfile%@AE@%            Switches to the file specified by %@AI@%textarg%@AE@%. The
                                               text argument may be a drive or directory, in
                                               which case the editor changes the current
                                               drive or directory.

                %@AI@%Meta Setfile%@AE@%                   Performs similarly to the corresponding
                %@AI@%Arg Meta Setfile%@AE@%               command listed above, but disables the saving
                %@AI@%Arg textarg Meta Setfile%@AE@%       of changes for the current file.

                %@AI@%Arg Arg textarg Setfile%@AE@%        Saves the current file under the name
                                               specified by %@AI@%textarg%@AE@%.

                %@AI@%Arg Arg Setfile%@AE@%                Saves the current file.

%@AI@%Setwindow       Setwindow%@AE@%                      Redisplays the entire screen.
(CTRL+])

                %@AI@%Arg Setwindow%@AE@%                  Adjusts the window so that the initial cursor
                                               position becomes the home position (upper-left
                                               corner).

                %@AI@%Meta Setwindow%@AE@%                 Redisplays the current line.

%@AI@%Shell           Shell%@AE@%                          Saves the current file and runs the command
(SHIFT+F9)                                     shell.

                %@AI@%Meta Shell%@AE@%                     Runs the command shell without saving the
                                               current file.

                %@AI@%Arg Shell%@AE@%                      Uses the text on the screen from the cursor up
                                               to the end of line as a command to the shell.

                %@AI@%Arg boxarg Shell%@AE@%               Treats each line of either argument as a
                %@AI@%Arg linearg Shell%@AE@%              separate command to the shell

                %@AI@%Arg textarg Shell%@AE@%              Uses %@AI@%textarg%@AE@% as a command to the shell.

%@AI@%Sinsert         Sinsert%@AE@%                        Inserts a single blank space at the current
(CTRL+J)                                       cursor position.

                %@AI@%Arg Sinsert%@AE@%                    Inserts a carriage return at the initial
                                               cursor position, splitting the line.

                %@AI@%Arg streamarg Sinsert%@AE@%          Insert a stream of blanks between the initial
                                               cursor position and the current cursor
                                               position.

%@AI@%Tab             Tab%@AE@%                            Moves the cursor to the next tab stop. Tab
(TAB)                                          stops are defined to be every %@AI@%n%@AE@%th character,
                                               where %@AI@%n%@AE@% is defined by the %@AB@%tabstops%@AE@% switch.

%@AI@%Tell            Tell%@AE@%                           Prompts for a keystroke, then displays the
(CTRL+T)                                       name of the keystroke and the function
                                               assigned to it in the format %@AI@%function:keyname%@AE@%.

                %@AI@%Arg Tell%@AE@%                       Identical to %@AI@%Tell%@AE@%, but if the key has a macro
                                               attached, displays
                                               %@AI@%MacroName:=MacroValue%@AE@%.

                %@AI@%Arg Arg Tell%@AE@%                   Prompts for a keystroke, then displays the
                                               value of the macro attached to the key. If a
                                               function is assigned to the key, the editor
                                               displays the name of the function.

                %@AI@%Arg textarg Tell%@AE@%               Like %@AI@%Arg Tell%@AE@% but obtains the macro name from
                                               a %@AI@%textarg%@AE@% rather than a keystroke.

                %@AI@%Meta Tell%@AE@%                      Performs the same as the command listed above,
                %@AI@%Arg Meta Tell%@AE@%                  except the editor inserts the output into the
                %@AI@%Arg Arg Meta Tell%@AE@%              file rather than on the dialog line.
                %@AI@%Arg textarg Meta Tell%@AE@%

%@AI@%Undo            Undo%@AE@%                           Reverses the last editing change. The maximum
(ALT+BKSP)                                     number of times this can be performed is set
                                               by the %@AB@%undocount%@AE@% switch.

                %@AI@%Meta Undo%@AE@%                      Recalls a command previously canceled with
                                               %@AI@%Undo%@AE@%. This command is often called "redo."

%@AI@%Up              Up%@AE@%                             Moves the cursor up one line. If this would
%@AI@%(UP or%@AE@%                                         result in the cursor moving out of the window,
%@AI@%CTRL+E)%@AE@%                                        the window is adjusted upward by the number of
                                               lines specified by the %@AB@%vscroll%@AE@% switch or fewer
                                               if in a small window.

                %@AI@%Meta Up%@AE@%                        Moves the cursor to the top of the window
                                               without changing the column position.

%@AI@%Window          Window%@AE@%                         Moves the cursor to the next window. With
(F6)                                           multiple windows, the next window is defined
                                               as being to the right of or below the current
                                               window.

                %@AI@%Arg Window%@AE@%                     Splits the current window horizontally at the
                                               initial cursor position. Note that all windows
                                               must be at least five lines high.

                %@AI@%Arg Arg Window%@AE@%                 Splits the current window vertically at the
                                               initial cursor position. Note that all windows
                                               must be at least 10 columns wide.

                %@AI@%Meta Window%@AE@%                    Closes the window.
%@TE:  915  62451  4 16 31 60 @%
%@NL@%
%@CR:MSEa4000@%%@2@%%@AB@%A.4  Return Values of Editing Functions%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSEa4001@%%@4@%Table A.4 gives an alphabetical listing of editing functions along with the%@EH@%
conditions under which each function returns TRUE or FALSE. These return
values are useful in conditional macros.%@NL@%
%@NL@%
%@CR:MSEaT400@%%@CR:MSEaT500@%%@CR:MSEaT600@%%@4@%%@AU@%Table A.4  Editor Functions and Return Values%@AE@%%@EH@%%@NL@%
%@TH:  188   7800  2 18 28 30 @%
%@AB@%Function          Returns TRUE               Returns FALSE%@AE@%

%@AI@%Arg%@AE@%               Always                     Never

%@AI@%Argcompile%@AE@%        Compile successful         Bad argument/compiler not found

%@AI@%Assign%@AE@%            Assignment successful      Invalid assignment

%@AI@%Backtab%@AE@%           Cursor moved               Cursor at left margin

%@AI@%Begfile%@AE@%           Cursor moved               Cursor not moved

%@AI@%Begline%@AE@%           Cursor moved               Cursor not moved

%@AI@%Boxstream%@AE@%         New mode is box mode       New mode is stream mode

%@AI@%Cancel%@AE@%            Always                     Never

%@AI@%Cdelete%@AE@%           Cursor moved               Cursor not moved

%@AI@%Compile%@AE@%           Compilation                Compilation unsuccessfully
                  successfully initiated     initiated or background
                  or background              compilation not
                  compilation running        running

%@AI@%Copy%@AE@%              Always                     Never

%@AI@%Curdate%@AE@%           Date inserted              Insertion would make line
                                             too long

%@AI@%Curday%@AE@%            Day inserted               Insertion would make line
                                             too long

%@AI@%Curfile%@AE@%           File inserted              Insertion would make line
                                             too long

%@AI@%Curfileext%@AE@%        File extension inserted    Insertion would make line
                                             too long

%@AI@%Curfilenam%@AE@%        File name inserted         Insertion would make line
                                             too long

%@AI@%Curtime%@AE@%           Time inserted              Insertion would make line
                                             too long

%@AI@%Delete%@AE@%            Always                     Never

%@AI@%Down%@AE@%              Cursor moved               Cursor not moved

%@AI@%Emacscdel%@AE@%         Cursor moved               Cursor not moved

%@AI@%Emacsnewl%@AE@%         Always                     Never

%@AI@%Endfile%@AE@%           Cursor moved               Cursor not moved

%@AI@%Endline%@AE@%           Cursor moved               Cursor not moved

%@AI@%Environment%@AE@%       Successful set or map      Syntax error or line too long

%@AI@%Execute%@AE@%           Last command successful    Last command failed

%@AI@%Exit%@AE@%              No return condition        No return condition

%@AI@%Graphic%@AE@%           Character inserted         Insertion would make line
                                                         too long

%@AI@%Home%@AE@%              Cursor moved               Cursor not moved

%@AI@%Information%@AE@%       Always                     Never

%@AI@%Initialize%@AE@%        Found tagged section       Did not find tagged section in
                  in TOOLS.INI               TOOLS.INI

%@AI@%Insert%@AE@%            Always                     Never

%@AI@%Insertmode%@AE@%        Insert mode turned on      Insert mode turned off

%@AI@%Lastselect%@AE@%        Selection recreated        %@AI@%Arg%@AE@% already selected

%@AI@%Lasttext%@AE@%          Value of function          Bad argument
                  eventually executed

%@AI@%Ldelete%@AE@%           Always                     Never

%@AI@%Left%@AE@%              Cursor moved               Cursor not moved

%@AI@%Linsert%@AE@%           Always                     Never

%@AI@%Mark%@AE@%              Definition/move            Bad argument/not found
                  successful

%@AI@%Message%@AE@%           Always                     Never

%@AI@%Meta%@AE@%              %@AI@%Meta%@AE@% turned on             %@AI@%Meta%@AE@% turned off

%@AI@%Mgrep%@AE@%             String found               String not found or specified,
                                             or search terminated by
                                             CTRL+BREAK, or background
                                             compilation in progress

%@AI@%Mlines%@AE@%            Movement occurred          Bad argument

%@AI@%Mpage%@AE@%             Movement occurred          Bad argument

%@AI@%Mpara%@AE@%             String found               Bad argument/string not found

%@AI@%Mreplace%@AE@%          Replacement successful     Replacement failed or was
                                             aborted

%@AI@%Msearch%@AE@%

%@AI@%Mword%@AE@%             Cursor moved               Cursor not moved

%@AI@%Newline%@AE@%           Always                     Never

%@AI@%Nextmsg%@AE@%           Message found              No more messages

%@AI@%Noedit%@AE@%            File or editor in          File or editor is not in
                  no-edit state              no-edit state

%@AI@%Paste%@AE@%             Almost always              Tried %@AI@%Arg Arg filename Paste%@AE@%
                                             and file didn't exist

%@AI@%Pbal%@AE@%              Balance successful         Bad argument/not balanced

%@AI@%Plines%@AE@%            Movement occurred          Bad argument

%@AI@%Ppage%@AE@%             Cursor moved               Cursor not moved

%@AI@%Ppara%@AE@%             Cursor moved               Cursor not moved

%@AI@%Print%@AE@%             Print successfully         Could not start print job
                  submitted

%@AI@%Psearch%@AE@%           String found               Bad argument/string not found

%@AI@%Pword%@AE@%             Cursor moved               Cursor not moved

%@AI@%Qreplace%@AE@%          At least one               String not found/invalid
                  replacement                pattern

%@AI@%Quote%@AE@%             Almost always              Insertion would make line
                                             too long

%@AI@%Record%@AE@%            Recording turned on        Recording turned off

%@AI@%Refresh%@AE@%           File read in/deleted       Canceled, bad argument

%@AI@%Repeat%@AE@%            Function repeated and      Function repeated and returned
                  returned TRUE              FALSE, or no function to repeat

%@AI@%Replace%@AE@%           At least one               String not found/invalid
                  replacement                pattern

%@AI@%Restcur%@AE@%           Position previously        Position not saved with
                  saved with %@AI@%Savecur%@AE@%         %@AI@%Savecur%@AE@%

%@AI@%Right%@AE@%             Cursor over text of line   Cursor beyond end of line

%@AI@%Saveall%@AE@%           Always                     Never

%@AI@%Savecur%@AE@%           Always                     Never

%@AI@%Sdelete%@AE@%           Always                     Never

%@AI@%Searchall%@AE@%         Something found            Nothing found

%@AI@%Setfile%@AE@%           File-switch successful     No alternate file, or current
                                             file needs to be saved and
                                             can't be

%@AI@%Setwindow%@AE@%         Always                     Never

%@AI@%Shell%@AE@%             Shell successful           Bad argument/program not found

%@AI@%Sinsert%@AE@%           Always                     Never

%@AI@%Tab%@AE@%               Cursor moved               Cursor not moved

%@AI@%Tell%@AE@%              Key pressed has            Key pressed has no function
                  function assigned          assigned

%@AI@%Undo%@AE@%              Almost always              If nothing to undo

%@AI@%Up%@AE@%                Cursor moved               Cursor not moved

%@AI@%Window%@AE@%            Successful split,          Any error
                  join, or move
%@TE:  188   7800  2 18 28 30 @%
%@NL@%
%@CR:MSEa5000@%%@2@%%@AB@%A.5  Editor Switches%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSEa5001@%%@4@%Table A.5%@BO:   7225b@% gives an alphabetical listing of editor switches along with%@EH@%
descriptions and default values. The first word in each description
identifies the switch as a text, numeric, or Boolean switch.%@NL@%
%@NL@%
%@CR:MSEaT700@%%@4@%%@AU@%Table A.5  Editor Switches%@AE@%%@EH@%%@NL@%
%@TH:  304  17158  2 18 58 @%
%@AB@%Switch            Description (and Default Value)%@AE@%

%@AB@%askexit%@AE@%           Boolean. Prompts for confirmation when you exit from the
                  editor. (Default value: No)

%@AB@%askrtn%@AE@%            Boolean. Prompts you to press ENTER when returning from a
                  %@AI@%Shell%@AE@% command. (Default value: Yes)

%@AB@%autosave%@AE@%          Boolean. Saves the current file whenever you switch away
                  from it. If this switch is off, contents of file buffer
                  are maintained, but subsequent actions, such as exiting,
                  may lose edits. (Default value: Yes)

%@AB@%backup%@AE@%            Text. Determines what happens to the old copy of a file
                  when a new version is saved to disk. A value of none
                  specifies that no backup operation is to be performed; the
                  editor simply overwrites the old file. A value of %@AB@%undel%@AE@%
                  specifies that the old file is to be moved so that
                  UNDEL.EXE can retrieve it. A value of bak specifies that
                  the file name of the old version of the file will be
                  changed to .BAK. (Default value: bak)

%@AB@%case%@AE@%              Boolean. Considers case to be significant for search and
                  replace operations. For example if %@AB@%case%@AE@% is on, the string
                  %@AS@%Procedure%@AE@% is not found as a match for the string
                  %@AS@%procedure%@AE@%. (Default value: No)

%@AB@%displaycursor%@AE@%     Boolean. Shows a position on the status line in the
                  (%@AI@%row%@AE@%,%@AI@%column%@AE@%) format. When off, the position listed is that
                  of the upper-left corner. When on, the current cursor
                  position is given. (Default value: No)

%@AB@%editreadonly%@AE@%      Boolean. Allows read-only files to be edited. If off, a
                  read-only file is marked no-edit in the editor. (Default
                  value: Yes)

%@AB@%entab%@AE@%             Numeric. Controls the degree to which the Microsoft Editor
                  converts multiple spaces to tabs when reading or writing a
                  file. A value of 0 means tabs are not used to represent
                  white space; 1 means all multiple spaces outside of quoted
                  strings are converted; 2 means all multiple spaces are
                  converted to tabs. (Default value: 1)

%@AB@%enterinsmode%@AE@%      Boolean. Starts the editor up in insert mode instead of
                  overtype mode, or switches to insert mode in the middle of
                  an editing session. (Default value: No)

%@AB@%errcolor%@AE@%          Numeric, using hexadecimal radix. Controls the color used
                  for error messages. The default is red text on a black
                  background. (Default value: 04)

%@AB@%errprompt%@AE@%         Boolean. Controls the "Press any key" prompt. When On, the
                  editor stops at each error message and waits for a
                  keystroke. (Default value: Yes)

%@AB@%extmake%@AE@%           Text. Associates a command line with a particular file
                  extension for use by the %@AI@%Compile%@AE@% function. The text after
                  the switch has this form:

                  %@AB@%extmake:%@AE@%%@AI@%extension commandline%@AE@%

                  Here, %@AI@%extension%@AE@% is the extension of the file to match, and
                  %@AI@%commandline%@AE@% is a command line to be executed. If there is
                  a %@AB@%%s%@AE@% in the command line, it is replaced with the name of
                  the current file or with the %@AI@%textarg%@AE@% in the %@AI@%Arg textarg%@AE@%
                  %@AI@%Compile%@AE@% command. This switch may appear more than once in
                  the TOOLS.INI file.

                  For example, you could have the following lines in
                  TOOLS.INI:

                  %@AS@%extmake:bc /Z %s;%@AE@%
                  %@AS@%extmake:for fl /c %s%@AE@%
                  %@AS@%extmake:pas pl /c /h %s%@AE@%
                  %@AS@%extmake:asm masm -Mx %s;%@AE@%
                  %@AS@%extmake:c cl /c /Zep /D LINT_ARGS %s%@AE@%
                  %@AS@%extmake:text make %s     %@AE@%

                  The %@AI@%Arg Compile%@AE@% command spawns a system-level command line
                  based on extension of current file; the editor selects the
                  corresponding %@AB@%extmake%@AE@% setting. The %@AI@%Arg textarg Compile%@AE@%
                  command spawns the command line for %@AB@%text%@AE@% extension, in
                  which %@AI@%textarg%@AE@% replaces %@AB@%%s%@AE@%.

                  This switch can also use the %@AB@%%|F%@AE@% syntax described in
                  Section 7.3%@BO:   3a7a5@%.

%@AB@%fgcolor%@AE@%           Numeric. Controls the color used for the editing window.
                  The default is light gray text on a black background.
                  (Default value: 07)

%@AB@%filetab%@AE@%           Numeric. Determines how the editor translates tabs to
                  spaces when reading or writing a disk file. This switch
                  also determines how the editor translates spaces to tabs
                  for modified lines, when %@AB@%entab%@AE@% > 0. The value of the
                  switch gives the number of spaces associated with each tab
                  column. For example, the setting "filetab:4" assumes a tab
                  column every 4 positions on each line. Every time the
                  editor finds a tab character in a file, it loads the
                  buffer with the number of spaces necessary to get to the
                  next tab column. (Default value: 8)

%@AB@%height%@AE@%            Numeric. Controls the number of lines that the Microsoft
                  Editor uses in the editing window, not including the
                  dialog and status lines. This is useful with a nonstandard
                  display device. Enhanced Graphics Adapter (EGA) in 43-line
                  mode on the IBM PC uses a value of 41. Video Graphics
                  Array (VGA) in 50-line mode uses a value of 48. (Default
                  value: 23)

%@AB@%helpboldcolor%@AE@%     Numeric. Controls the color of text designated as
                  boldface. (Default value: 0F)

%@AB@%helpfiles%@AE@%         Text. Specifies which .HLP files should be used by on-line
                  Help.

%@AB@%helpitalcolor%@AE@%     Numeric. Controls the color of text designated as italic.
                  (Default value: 0A)

%@AB@%helpundcolor%@AE@%      Numeric. Controls the color of text designated as
                  underlined. (Default value: 0C)

%@AB@%helpwarncolor%@AE@%     Numeric. Controls the color of text used for a "warning"
                  note. Also controls the color of highlighted
                  cross-references. (Default value: 07)

%@AB@%helpwindow%@AE@%        Boolean. Controls split-screen behavior. When off, the
                  editor cannot split the screen to display Help
                  information. (Default value: Yes)

%@AB@%hgcolor%@AE@%           Numeric; hexadecimal value. Controls the color of text
                  highlighted by a search command. (See %@AB@%selcolor%@AE@%.) The
                  default is green. (Default value: 02)

%@AB@%hike%@AE@%              Numeric. Specifies the cursor's new-line position (from
                  the top of the screen) when the cursor is moved out of the
                  current window by more than %@AB@%vscroll%@AE@% lines. (Default value:
                  4)

%@AB@%hscroll%@AE@%           Numeric. Controls the number of columns shifted left or
                  right when the cursor is scrolled out of the editing
                  window. (Default value: 10)

%@AB@%infcolor%@AE@%          Numeric, using hexadecimal radix. Controls the color used
                  for informative text. The default is dark yellow text on a
                  black background. (On some monitors, this may appear
                  brown.) (Default value: 06)

%@AB@%keyboard%@AE@%          Text. Set to "compatible" if you have a 101-key enhanced
                  keyboard and wish to use keyboard-enhancer programs that
                  do not fully support the enhanced keyboard. Set to
                  "enhanced" to restore normal operation after using
                  "compatible." If no option is used, the editor makes its
                  own decision about type of keyboard in use. This switch
                  works only under DOS or real-mode OS/2.

%@AB@%load%@AE@%              Text. Specifies the name of a C-extension executable file
                  to be loaded. Whenever this switch is assigned a new
                  value, the extension file named is loaded into memory and
                  initialized by calling the %@AB@%WhenLoaded%@AE@% function. The file
                  named must be a full name, including base name and file
                  extension (unless extension module is for OS/2 protected
                  mode). See Chapter 8%@BO:   3fbeb@%, "Programming C Extensions," for
                  more information.

%@AB@%markfile%@AE@%          Text. Specifies the name of the file the Microsoft Editor
                  searches when looking for a marker that is not in the
                  in-memory set. This file can be created by entering lines
                  of the following form:

                  %@AI@%markername%@AE@% %@AI@%filename%@AE@% %@AI@%line%@AE@% %@AI@%column%@AE@%

                  Here, %@AI@%line%@AE@% and %@AI@%column%@AE@% specify the position in the file
                  %@AI@%filename%@AE@% where the marker %@AI@%markername%@AE@% appears.

%@AB@%noise%@AE@%             Numeric. Controls the number of lines counted at a time
                  when searching or loading a file. This value is displayed
                  in the lower-right corner of the screen and may be turned
                  off by setting %@AB@%noise%@AE@% to 0. (Default value: 50)

%@AB@%printcmd%@AE@%          Text. Specifies a system-level command that the editor
                  invokes when you issue the %@AI@%Print%@AE@% command. For example, the
                  following setting copies output to LPT2:

                  %@AS@%COPY %s LPT2%@AE@%

                  By default, the %@AI@%Print%@AE@% command sends output directly to
                  LPT1.

%@AB@%readonly%@AE@%          Text. Specifies the DOS command invoked when the Microsoft
                  Editor attempts to overwrite a read-only file. The current
                  file name is appended to the command, as shown in the
                  following example:

                  %@AS@%readonly:attrib -r %s%@AE@%

                  This command removes the read-only attribute from the
                  current file so the file can be overwritten. If no command
                  is specified, you are prompted to enter a new name under
                  which to save the file.

%@AB@%realtabs%@AE@%          Boolean. Preserves actual tab characters instead of
                  converting them to spaces. When this switch is on, the
                  editor preserves tab alignment as characters are added and
                  deleted, and cursor-movement functions treat each tab as a
                  single character. (Default value: Yes)

%@AB@%rmargin%@AE@%           Numeric. Controls the right column margin used in wordwrap
                  mode. A space typed to the right of this margin causes a
                  line break. Wordwrap mode is turned on and off with the
                  %@AB@%wordwrap%@AE@% switch. (Default value: 72)

%@AB@%savescreen%@AE@%        Boolean. Saves and restores the DOS screen (used with the
                  %@AI@%Shell%@AE@% and %@AI@%Exit%@AE@% functions). (Default value: Yes)

%@AB@%searchwrap%@AE@%        Boolean. Causes search and replace commands to wrap past
                  the end of the file and continue searching from the
                  beginning. Unsuccessful searches stop after the entire
                  file is searched once. When this switch is off, searches
                  stop at the end of the file. (Default value: No)

%@AB@%selcolor%@AE@%          Numeric. Controls the color of text highlighted by an
                  on-screen argument (%@AI@%linearg%@AE@%, %@AI@%boxarg%@AE@%, %@AI@%streamarg%@AE@%). The
                  default is black text on a white background. Do not
                  confuse with %@AB@%hgcolor%@AE@%. (Default value: 70)

%@AB@%shortnames%@AE@%        Boolean. Allows you to load a file by giving only the base
                  name, which the editor searches for in the
                  <information-file>. (Default value: Yes)

%@AB@%snow%@AE@%              Boolean. Eliminates snow on a CGA, at a penalty to speed.
                  Turn this switch off if you have a CGA-compatible that
                  doesn't generate snow. (Default value: Yes)

%@AB@%softcr%@AE@%            Boolean. Attempts to indent based upon the format of the
                  surrounding text when you invoke the %@AI@%Newline%@AE@% or %@AI@%Emacsnewl%@AE@%
                  function. (Default value: Yes)

%@AB@%stacolor%@AE@%          Numeric. Controls the color used for the status-line
                  information. The default is cyan text on a black
                  background. (Default value: 03)

%@AB@%tabalign%@AE@%          Boolean. Determines where the cursor may be placed in a
                  tab field. When off, the cursor may be placed anywhere in
                  a tab field. When on (and if %@AB@%realtabs%@AE@% is also on), the
                  cursor must align with the column position of the tab.
                  (Default value: No)

%@AB@%tabdisp%@AE@%           Numeric. Specifies the ASCII value of the character used
                  to display tabs. Normally, a space is used, but a graphic
                  character can be used to show which spaces correspond to
                  tabs. (Default value: 32)

%@AB@%tabstops%@AE@%          Numeric. Controls the number of spaces between each
                  logical tab stop for the %@AI@%Tab%@AE@% and %@AI@%Backtab%@AE@% movement
                  functions. Note that this switch has no relation to the
                  interpretation of actual tabs. (Default value: 4)

%@AB@%tmpsav%@AE@%            Numeric. Controls the maximum number of recently edited
                  files listed in the information file. If this switch is
                  set to 0, the editor lets the information file grow
                  without limit; all files ever edited appear in the
                  information file until M.TMP is altered or deleted.
                  (Default value: 20)

%@AB@%traildisp%@AE@%         Numeric. Specifies the ASCII value of the character to be
                  displayed as trailing spaces. Note that this switch has no
                  effect unless the %@AB@%trailspace%@AE@% switch is turned on. (Default
                  value: 0)

%@AB@%trailspace%@AE@%        Boolean. Preserves trailing spaces in each line you
                  modify. (Default value: No)

%@AB@%undelcount%@AE@%        Numeric. Controls the number of backup copies of a file
                  that are saved when the %@AB@%backup%@AE@% switch is set to %@AB@%undel%@AE@%.
                  When the limit is exceeded, the editor discards the oldest
                  backup. (Default value: no limit)

%@AB@%undocount%@AE@%         Numeric. Controls the number of edit functions that you
                  can undo. (Default value: 10)

%@AB@%unixre%@AE@%            Boolean. Specifies the use of UNIX regular-expression
                  syntax rather than the syntax used inVersion 1.0 of the
                  editor. (Default value: Yes)

%@AB@%viewonly%@AE@%          Boolean. Identical to the /r command-line switch and the
                  %@AI@%Noedit%@AE@% function. When set, no file can be edited. (Default
                  value: No)

%@AB@%vscroll%@AE@%           Numeric. Controls the number of lines shifted up or down
                  when the cursor is scrolled out of the editing window. The
                  %@AI@%Mlines%@AE@% and %@AI@%Plines%@AE@% functions also use this value. (Default
                  value: 7)

%@AB@%wdcolor%@AE@%           Numeric. Controls the color of the border line created
                  when you split a window. (Default value: 07).

%@AB@%width%@AE@%             Numeric. Controls the width of the display mode for
                  displays that are capable of showing more than 80 columns.
                  Values other than 80 are supported only for a limited
                  number of monitors. (Default value: 80)

%@AB@%wordwrap%@AE@%          Boolean. Breaks lines of text when you edit them beyond
                  the margin specified
%@TE:  304  17158  2 18 58 @%
%@NL@%
%@NL@%
%@CR:MSEb0000@%%@1@%%@AB@%Appendix B  Support Programs for the Microsoft Editor%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@CR:MSEb0001@%%@4@%This appendix discusses two programs that work in conjunction with the%@EH@%
Microsoft Editor:%@NL@%
%@NL@%
%@CR:MSEb0002@%  ■  UNDEL.EXE%@NL@%
%@NL@%
  ■  EXP.EXE%@NL@%
%@NL@%
%@CR:MSEb0003@%%@4@%Both programs work with backup files. When a file is updated and the %@AB@%backup%@AE@%%@EH@%
switch is set to %@AB@%undel%@AE@%, the old version of the file is copied to a hidden
subdirectory called DELETED. UNDEL.EXE and EXP.EXE manipulate the files in
the DELETED subdirectory.%@NL@%
%@NL@%
%@NL@%
%@CR:MSEb1000@%%@2@%%@AB@%B.1  UNDEL.EXE%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSEb1001@%%@4@%Use this program to move a file from the DELETED subdirectory to the parent%@EH@%
directory. Its command-line syntax is as follows:%@NL@%
%@NL@%
     undel «%@AI@%filename%@AE@%»%@NL@%
%@NL@%
%@CR:MSEb1002@%%@4@%If %@AI@%filename%@AE@% is not given, the contents of the DELETED subdirectory are%@EH@%
listed. If there is more than one version of the file, you are given a list
to choose from. If the file already exists in the parent directory, the two
files are swapped.%@NL@%
%@NL@%
%@NL@%
%@CR:MSEb2000@%%@2@%%@AB@%B.2  EXP.EXE%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSEb2001@%%@4@%Use this program to remove all of the files in the hidden DELETED%@EH@%
subdirectory of the specified directory. Use the following command-line
syntax:%@NL@%
%@NL@%
     exp «/r» «/q» «%@AI@%directory%@AE@%»%@NL@%
%@NL@%
%@CR:MSEb2002@%%@4@%If no %@AI@%directory%@AE@% is specified, the current directory's DELETED subdirectory%@EH@%
is used. If the /r option is given, EXP.EXE recursively operates on all
subdirectories. The /q option specifies quiet mode; the deleted file names
are not displayed on the screen.%@NL@%
%@NL@%
%@NL@%
%@CR:MSEc0000@%%@1@%%@AB@%Appendix C  Microsoft Editor Messages%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@CR:MSEc0001@%%@4@%This appendix lists the messages that the editor can report on the dialog%@EH@%
line, along with explanations. Some of these messages represent error
conditions; in that case, the explanation given describes what went wrong
and what action to take to correct the error. Other messages prompt you for
information or report what operation is taking place. For example, the
editor displays a message whenever it saves a file.%@NL@%
%@NL@%
%@CR:MSEc0002@%%@4@%The messages are listed in two sections. The first section consists of%@EH@%
messages that begin with a placeholder. A "placeholder" is a piece of
information──such as a number or a file name──that varies with the
situation. This section is organized alphabetically by the placeholder type.
The second section consists of messages that do not begin with a
placeholder. These messages are organized alphabetically by first symbol or
word.%@NL@%
%@NL@%
%@NL@%
%@CR:MSEc1000@%%@2@%%@AB@%C.1  Messages Starting with Placeholders%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSEcE001@%%@4@%%@AI@%driveletter%@AE@%%@AB@% is an invalid drive%@AE@%%@EH@%%@NL@%
%@NL@%
               You attempted to use %@AI@%Setfile%@AE@% to change the current drive to a%@NL@%
               drive not recognized by your system. Use a different drive%@NL@%
               letter.%@NL@%
%@NL@%
%@CR:MSEcE002@%%@4@%%@AI@%file%@AE@%%@AB@% does not exist%@AE@%%@EH@%%@NL@%
%@NL@%
               You gave the %@AI@%Arg Arg filename Paste%@AE@% command, but the file%@NL@%
               specified does not exist. Make sure you give the complete%@NL@%
               path name of the file if it is not in the current directory.%@NL@%
%@NL@%
%@CR:MSEcE003@%%@4@%%@AI@%file%@AE@%%@AB@% does not exist. Create?%@AE@%%@EH@%%@NL@%
%@NL@%
               When you started the editor, you specified a file that does%@NL@%
               not exist. Type Y to create the file or N to avoid creating%@NL@%
               the file, in which case the editor loads the most recently%@NL@%
               edited file.%@NL@%
%@NL@%
%@CR:MSEcE004@%%@4@%%@AI@%file%@AE@%%@AB@% has been changed.  Refresh?%@AE@%%@EH@%%@NL@%
%@NL@%
               One of the files opened for editing was altered by a program%@NL@%
               other than the editor. This change has not yet been reflected%@NL@%
               in the file buffer. You should either type Y to discard%@NL@%
               recent edits and have the editor reread the file from disk,%@NL@%
               or type N to preserve your edits. If you answer N, you should%@NL@%
               execute a save operation so that the file buffer is copied to%@NL@%
               the file stored on disk.%@NL@%
%@NL@%
%@CR:MSEcE005@%%@4@%%@AI@%file%@AE@%%@AB@% has changed. Save changes (Y/N)?%@AE@%%@EH@%%@NL@%
%@NL@%
               You have attempted to exit, and the file you are currently%@NL@%
               working on has been changed since it was last saved. If you%@NL@%
               respond Y, the changes will be saved; if N, they will be%@NL@%
               discarded.%@NL@%
%@NL@%
%@CR:MSEcE006@%%@4@%%@AI@%file%@AE@%%@AB@% is read-only%@AE@%%@EH@%%@NL@%
%@NL@%
               You attempted to overwrite a file that has the read-only%@NL@%
               attribute. After displaying this message, the editor prompts%@NL@%
               for a new file name under which to save the file. If you%@NL@%
               assigned a command line to the %@AB@%readonly%@AE@% switch, the editor%@NL@%
               asks if you want to execute this command.%@NL@%
%@NL@%
%@CR:MSEcE007@%%@4@%%@AB@%'%@AE@%%@AI@%keystroke%@AE@%%@AB@%' is an unknown key%@AE@%%@EH@%%@NL@%
%@NL@%
               You gave an unrecognized keystroke in an assignment. Some%@NL@%
               keyboards may support keystroke combinations that the editor%@NL@%
               does not accept.%@NL@%
%@NL@%
%@CR:MSEcE008@%%@4@%%@AI@%keystroke%@AE@%%@AB@% is not assigned to any editor function%@AE@%%@EH@%%@NL@%
%@NL@%
               The keystroke you pressed has no editing function assigned to%@NL@%
               it (not even the %@AI@%Graphic%@AE@% function, which makes keystrokes%@NL@%
               literal). You must assign a function to a keystroke before%@NL@%
               using it.%@NL@%
%@NL@%
%@CR:MSEcE009@%%@4@%%@AI@%name%@AE@%%@AB@% is not an editor function%@AE@%%@EH@%%@NL@%
%@NL@%
               You attempted to assign an undefined function to a keystroke.%@NL@%
               You may have mistyped the function name, or you may have used%@NL@%
               the colon (:) instead of the definition symbol (:=) to enter%@NL@%
               a macro definition.%@NL@%
%@NL@%
%@CR:MSEcE010@%%@4@%%@AI@%name%@AE@%%@AB@% is not an editor switch%@AE@%%@EH@%%@NL@%
%@NL@%
               You entered an assignment in which the left side did not%@NL@%
               contain a recognized function, macro, or switch name. You may%@NL@%
               have mistyped the name or used the wrong syntax.%@NL@%
%@NL@%
%@CR:MSEcE011@%%@4@%%@AI@%number%@AE@%%@AB@% occurrences found%@AE@%%@EH@%%@NL@%
%@NL@%
               The %@AI@%Searchall%@AE@% function found %@AI@%number%@AE@% occurrences of the search%@NL@%
               string.%@NL@%
%@NL@%
%@CR:MSEcE012@%%@4@%%@AI@%number%@AE@%%@AB@% occurrences replaced%@AE@%%@EH@%%@NL@%
%@NL@%
               The %@AI@%Replace%@AE@% or %@AI@%Qreplace%@AE@% function replaced %@AI@%number%@AE@% occurrences%@NL@%
               of the search string.%@NL@%
%@NL@%
%@CR:MSEcE013@%%@4@%%@AI@%number%@AE@%%@AB@%: Undefined opcode%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor detected an internal error in the way it analyzed%@NL@%
               a regular expression. Please note the circumstances of this%@NL@%
               error and notify Microsoft Corporation by following the%@NL@%
               directions in the Microsoft Product Assistance Request form%@NL@%
               at the back of one of your manuals.%@NL@%
%@NL@%
%@CR:MSEcE014@%%@4@%%@AB@%+'%@AE@%%@AI@%string%@AE@%%@AB@%' not found%@AE@%%@EH@%%@NL@%
%@NL@%
               The %@AI@%Psearch%@AE@% function failed to find an occurrence of %@AI@%string%@AE@%.%@NL@%
               This message may be reported for both ordinary and%@NL@%
               regular-expression searches.%@NL@%
%@NL@%
%@CR:MSEcE015@%%@4@%%@AI@%value%@AE@%%@AB@% is an illegal setting%@AE@%%@EH@%%@NL@%
%@NL@%
               You attempted to give an illegal value in a switch%@NL@%
               assignment.%@NL@%
%@NL@%
%@NL@%
%@CR:MSEc2000@%%@2@%%@AB@%C.2  Other Messages%@AE@%%@EH@%%@NL@%
%@NL@%
%@CR:MSEcE016@%%@4@%%@AB@%<ZFormat???>%@AE@%%@EH@%%@NL@%
%@NL@%
               You used the percent sign (%@AS@%%%@AE@%) in a text switch (such as%@NL@%
               %@AB@%extmake%@AE@%) without following it by correct syntax such as %@AS@%%s%@AE@% or%@NL@%
               %@AS@%|F%@AE@%. To include a literal use of the percent sign, enter two%@NL@%
               percent signs in a row (%@AS@%%%%@AE@%).%@NL@%
%@NL@%
%@CR:MSEcE017@%%@4@%%@AB@%**PANIC EXIT** Really exit and lose edits?%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor appeared to be "hung" (non-functioning) and you%@NL@%
               pressed CTRL+BREAK five times to exit. If you answer Y, the%@NL@%
               editing session will be terminated and any unsaved changes%@NL@%
               will be lost. The editor sometimes has so many operations to%@NL@%
               perform that it appears to be hung, but is actually%@NL@%
               functioning normally. If you think this is the case, answer N%@NL@%
               to return to the editing session.%@NL@%
%@NL@%
%@CR:MSEcE018@%%@4@%%@AB@%- floating point not loaded%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor encountered an internal error. Please note the%@NL@%
               circumstances of this error and notify Microsoft Corporation%@NL@%
               by following the directions in the Microsoft Product%@NL@%
               Assistance Request form at the back of one of your manuals.%@NL@%
%@NL@%
%@CR:MSEcE019@%%@4@%%@AB@%- integer divide by zero%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor encountered an internal error. Please note the%@NL@%
               circumstances of this error and notify Microsoft Corporation%@NL@%
               by following the directions in the Microsoft Product%@NL@%
               Assistance Request form at the back of one of your manuals.%@NL@%
%@NL@%
%@CR:MSEcE020@%%@4@%%@AB@%- not enough memory on exec%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor encountered an internal error. Please note the%@NL@%
               circumstances of this error and notify Microsoft Corporation%@NL@%
               by following the directions in the Microsoft Product%@NL@%
               Assistance Request form at the back of one of your manuals.%@NL@%
%@NL@%
%@CR:MSEcE021@%%@4@%%@AB@%- not enough space for arguments%@AE@%%@EH@%%@NL@%
%@NL@%
               You attempted to start the editor with more file names than%@NL@%
               can be stored in free memory. This error should be impossible%@NL@%
               to get unless you use a wildcard expression (such as %@AS@%*.c%@AE@%)%@NL@%
               with an extraordinarily large directory.%@NL@%
%@NL@%
%@CR:MSEcE022@%%@4@%%@AB@%- not enough space for environment%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor has insufficient free memory to store the%@NL@%
               environment variables for the current session. This error%@NL@%
               should be impossible to get unless you have severely%@NL@%
               restricted the amount of memory granted to the editor.%@NL@%
%@NL@%
%@CR:MSEcE023@%%@4@%%@AB@%- null pointer assignment%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor encountered an internal error. Please note the%@NL@%
               circumstances of this error and notify Microsoft Corporation%@NL@%
               by following the directions in the Microsoft Product%@NL@%
               Assistance Request form at the back of one of your manuals.%@NL@%
%@NL@%
%@CR:MSEcE024@%%@4@%%@AB@%-Search for '%@AE@%%@AI@%string%@AE@%%@AB@%'%@AE@%%@EH@%%@NL@%
%@NL@%
               The %@AI@%Msearch%@AE@% function is currently searching for %@AI@%string%@AE@%.%@NL@%
%@NL@%
%@CR:MSEcE025@%%@4@%%@AB@%- stack overflow%@AE@%%@EH@%%@NL@%
%@NL@%
               Internal function calls required a larger stack than is%@NL@%
               available to the editor. If you receive this error, it is%@NL@%
               most likely because you are using an extension that makes%@NL@%
               extensive use of local variables or function calls. Rewrite%@NL@%
               the extension so that it uses fewer or smaller local%@NL@%
               variables; then recompile and relink.%@NL@%
%@NL@%
%@CR:MSEcE026@%%@4@%%@AB@%-'%@AE@%%@AI@%string%@AE@%%@AB@%' not found%@AE@%%@EH@%%@NL@%
%@NL@%
               The %@AI@%Msearch%@AE@% function failed to find an occurrence of %@AI@%string%@AE@%.%@NL@%
               This message may be reported for both ordinary and%@NL@%
               regular-expression searches.%@NL@%
%@NL@%
%@CR:MSEcE027@%%@4@%%@AB@%+Search for '%@AE@%%@AI@%string%@AE@%%@AB@%'%@AE@%%@EH@%%@NL@%
%@NL@%
               The %@AI@%Psearch%@AE@% function is currently searching for %@AI@%string%@AE@%.%@NL@%
%@NL@%
%@CR:MSEcE028@%%@4@%%@AB@%All edits lost (Sorry)%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor lost information as a result of an internal error.%@NL@%
               Please note the circumstances of this error and notify%@NL@%
               Microsoft Corporation by following the directions in the%@NL@%
               Microsoft Product Assistance Request form at the back of one%@NL@%
               of your manuals.%@NL@%
%@NL@%
%@CR:MSEcE029@%%@4@%%@AB@%Are you sure you want to exit? (y/n):%@AE@%%@EH@%%@NL@%
%@NL@%
               You gave the %@AI@%Meta Exit%@AE@% command (exit without saving), or the%@NL@%
               %@AB@%autosave%@AE@% switch is not on and you tried to exit. Type Y to%@NL@%
               exit or N to continue the editing session.%@NL@%
%@NL@%
%@CR:MSEcE030@%%@4@%%@AB@%Arg [%@AE@%%@AI@%number%@AE@%%@AB@%]:%@AE@%%@EH@%%@NL@%
%@NL@%
               You invoked the %@AI@%Arg%@AE@% function, which is used to introduce an%@NL@%
               argument or modify a function. The %@AI@%number%@AE@% placeholder%@NL@%
               indicates the number of times you invoked %@AI@%Arg%@AE@%. Complete the%@NL@%
               command or type %@AI@%Cancel%@AE@% to escape. Any %@AI@%textarg%@AE@% s you type in%@NL@%
               are displayed after the colon.%@NL@%
%@NL@%
%@CR:MSEcE031@%%@4@%%@AB@%Arg list too long%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor encountered an internal error. Please note the%@NL@%
               circumstances of this error and notify Microsoft Corporation%@NL@%
               by following the directions in the Microsoft Product%@NL@%
               Assistance Request form at the back of one of your manuals.%@NL@%
%@NL@%
%@CR:MSEcE032@%%@4@%%@AB@%Argument cancelled%@AE@%%@EH@%%@NL@%
%@NL@%
               You invoked the %@AI@%Cancel%@AE@% function, which removes arguments. To%@NL@%
               clear this message from the dialog line, invoke %@AI@%Cancel%@AE@% again.%@NL@%
%@NL@%
%@CR:MSEcE033@%%@4@%%@AB@%Argument required%@AE@%%@EH@%%@NL@%
%@NL@%
               The function you just invoked requires an argument.%@NL@%
%@NL@%
%@CR:MSEcE034@%%@4@%%@AB@%Bad Assignment!%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor could not perform the assignment requested. You%@NL@%
               may have mistyped your entry or requested nonexistent%@NL@%
               functions.%@NL@%
%@NL@%
%@CR:MSEcE035@%%@4@%%@AB@%bad environment on exec%@AE@%%@EH@%%@NL@%
%@NL@%
               OS/2 only. You gave a %@AI@%Compile%@AE@% or %@AI@%Shell%@AE@% command that could not%@NL@%
               be executed.%@NL@%
%@NL@%
%@CR:MSEcE036@%%@4@%%@AB@%Bad file number%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor encountered an internal error. Please note the%@NL@%
               circumstances of this error and notify Microsoft Corporation%@NL@%
               by following the directions in the Microsoft Product%@NL@%
               Assistance Request form at the back of one of your manuals.%@NL@%
%@NL@%
%@CR:MSEcE037@%%@4@%%@AB@%bad format on exec%@AE@%%@EH@%%@NL@%
%@NL@%
               OS/2 only. You gave a %@AI@%Compile%@AE@% or %@AI@%Shell%@AE@% command that could not%@NL@%
               be executed.%@NL@%
%@NL@%
%@CR:MSEcE038@%%@4@%%@AB@%Bookmark not found%@AE@%%@EH@%%@NL@%
%@NL@%
               You attempted to go to a file marker that does not exist or%@NL@%
               mistyped the marker name.%@NL@%
%@NL@%
%@CR:MSEcE039@%%@4@%%@AB@%Can't delete%@AE@% %@AI@%file%@AE@%%@AB@% -%@AE@%%@AI@%messagetext%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor could not delete the given file, for the reason%@NL@%
               given in %@AI@%messagetext%@AE@%.%@NL@%
%@NL@%
%@CR:MSEcE040@%%@4@%%@AB@%Can't delete old version of%@AE@% %@AI@%file%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor attempted to write a file to disk during the UNDEL%@NL@%
               backup procedure (the old version of the file is stored in%@NL@%
               the DELETED subdirectory), but the editor could not do the%@NL@%
               necessary file deletion. Attempt saving to an alternate file.%@NL@%
%@NL@%
%@CR:MSEcE041@%%@4@%%@AB@%Can't rename%@AE@% %@AI@%srcfile%@AE@%%@AB@% to%@AE@% %@AI@%destfile%@AE@%%@AB@% -%@AE@% %@AI@%messagetext%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor attempted to write a file to disk during the BAK%@NL@%
               backup procedure (the old version of the file is stored as%@NL@%
               %@AI@%srcfile%@AE@%.BAK), but the editor could not do the necessary%@NL@%
               renaming. Attempt saving to an alternate file.%@NL@%
%@NL@%
%@CR:MSEcE042@%%@4@%%@AB@%Cannot access%@AE@% %@AI@%file%@AE@%%@AB@% -%@AE@% %@AI@%messagetext%@AE@%%@EH@%%@NL@%
%@NL@%
               You tried to load %@AI@%file%@AE@%, but were denied access by the system%@NL@%
               for the reason given in %@AI@%messagetext%@AE@%.%@NL@%
%@NL@%
%@CR:MSEcE043@%%@4@%%@AB@%Cannot allocate mpPnPage -%@AE@% %@AI@%number%@AE@%%@EH@%%@NL@%
%@NL@%
               OS/2 only. The editor encountered an internal error. Please%@NL@%
               note the circumstances of this error and notify Microsoft%@NL@%
               Corporation by following the directions in the Microsoft%@NL@%
               Product Assistance Request form at the back of one of your%@NL@%
               manuals.%@NL@%
%@NL@%
%@CR:MSEcE044@%%@4@%%@AB@%Cannot allocate pageTmp -%@AE@% %@AI@%number%@AE@%%@EH@%%@NL@%
%@NL@%
               OS/2 only. The editor encountered an internal error. Please%@NL@%
               note the circumstances of this error and notify Microsoft%@NL@%
               Corporation by following the directions in the Microsoft%@NL@%
               Product Assistance Request form at the back of one of your%@NL@%
               manuals.%@NL@%
%@NL@%
%@CR:MSEcE045@%%@4@%%@AB@%Cannot change screen parameters when windows present%@AE@%%@EH@%%@NL@%
%@NL@%
               You attempted to reset the %@AB@%height%@AE@% switch when multiple%@NL@%
               windows were present. Close all windows but one before%@NL@%
               attempting to set %@AB@%height%@AE@%. (The editor can give this message%@NL@%
               when attempting to read TOOLS.INI.)%@NL@%
%@NL@%
%@CR:MSEcE046@%%@4@%%@AB@%Cannot close this window%@AE@%%@EH@%%@NL@%
%@NL@%
               You attempted to close a window that cannot be merged with%@NL@%
               another window. Two windows can be merged only if the windows%@NL@%
               share one complete side. A window could not be merged with%@NL@%
               two smaller windows if each shared part of one side adjoining%@NL@%
               the larger window.%@NL@%
%@NL@%
               The editor closes the window if it can find at least one%@NL@%
               adjoining window that can be properly merged. If the editor%@NL@%
               cannot close the window, move to another window and close it%@NL@%
               first.%@NL@%
%@NL@%
%@CR:MSEcE047@%%@4@%%@AB@%Cannot create%@AE@% %@AI@%file%@AE@%%@AB@% -%@AE@% %@AI@%messagetext%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor was unable to create %@AI@%file%@AE@%, for the reason given in%@NL@%
               %@AI@%messagetext%@AE@%.%@NL@%
%@NL@%
%@CR:MSEcE048@%%@4@%%@AB@%Cannot create printer intermediate file%@AE@%%@EH@%%@NL@%
%@NL@%
               OS/2 only. The editor was unable to create the intermediate%@NL@%
               file needed for printer queuing.%@NL@%
%@NL@%
%@CR:MSEcE049@%%@4@%%@AB@%Cannot duplicate:%@AE@% %@AI@%errormessage%@AE@%%@EH@%%@NL@%
%@NL@%
               In attempting to perform a shell command or compile action,%@NL@%
               the editor was unable to redirect output. The C run-time%@NL@%
               error message indicates the nature of the problem.%@NL@%
%@NL@%
%@CR:MSEcE050@%%@4@%%@AB@%Cannot find label%@AE@% %@AI@%name%@AE@%%@EH@%%@NL@%
%@NL@%
               The given %@AI@%name%@AE@% was the target of a jump-to-label instruction%@NL@%
               (%@AS@%+>%@AE@%, %@AS@%->%@AE@%, or %@AS@%=>%@AE@%) within a macro, but the label was not%@NL@%
               defined. Place %@AS@%:>%@AE@% %@AI@%name%@AE@% in the macro to define the label.%@NL@%
%@NL@%
%@CR:MSEcE051@%%@4@%%@AB@%Cannot load%@AE@% %@AI@%file%@AE@%%@AB@% -%@AE@% %@AI@%messagetext%@AE@%%@EH@%%@NL@%
%@NL@%
               You attempted to load %@AI@%file%@AE@% as an extensions module, but it%@NL@%
               cannot be loaded for the reason given in %@AI@%messagetext%@AE@%.%@NL@%
%@NL@%
%@CR:MSEcE052@%%@4@%%@AB@%Cannot mgrep to <compile> during background compile%@AE@%%@EH@%%@NL@%
%@NL@%
               OS/2 only. You cannot start an %@AB@%mgrep%@AE@% during a background%@NL@%
               compile.%@NL@%
%@NL@%
%@CR:MSEcE053@%%@4@%%@AB@%Cannot open%@AE@% %@AI@%file%@AE@%%@EH@%%@NL@%
%@NL@%
               The %@AI@%file%@AE@% was specified as an argument to the %@AI@%Setfile%@AE@% or %@AI@%Paste%@AE@%%@NL@%
               command, but the %@AI@%file%@AE@% cannot be opened.%@NL@%
%@NL@%
%@CR:MSEcE054@%%@4@%%@AB@%Cannot open%@AE@% %@AI@%file%@AE@%%@AB@% -%@AE@% %@AI@%errormessage%@AE@%%@EH@%%@NL@%
%@NL@%
               The specified file could not be opened. The C run-time error%@NL@%
               message indicates the nature of the problem.%@NL@%
%@NL@%
%@CR:MSEcE055@%%@4@%%@AB@%Cannot open%@AE@% %@AI@%file%@AE@%%@AB@%:%@AE@% %@AI@%errormessage%@AE@%%@EH@%%@NL@%
%@NL@%
               The specified file could not be opened. The C run-time error%@NL@%
               message indicates the nature of the problem.%@NL@%
%@NL@%
%@CR:MSEcE056@%%@4@%%@AB@%Cannot open PRN:%@AE@% %@AI@%file%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor could not locate or access a printer port to print%@NL@%
               %@AI@%file%@AE@%.%@NL@%
%@NL@%
%@CR:MSEcE057@%%@4@%%@AB@%Cannot read%@AE@% %@AI@%file%@AE@%%@EH@%%@NL@%
%@NL@%
               A %@AI@%file%@AE@% to be read was located but could not be read.%@NL@%
%@NL@%
%@CR:MSEcE058@%%@4@%%@AB@%Cannot save to directory:%@AE@% %@AI@%directory%@AE@%%@EH@%%@NL@%
%@NL@%
               You attempted to save to a directory that has the read-only%@NL@%
               attribute.%@NL@%
%@NL@%
%@CR:MSEcE059@%%@4@%%@AB@%Cannot unlink file%@AE@% %@AI@%file%@AE@%%@AB@%:%@AE@% %@AI@%messagetext%@AE@%%@EH@%%@NL@%
%@NL@%
               The temporary file used for printing could not be deleted.%@NL@%
               The %@AI@%file%@AE@% placeholder is the name of the file, and %@AI@%messagetext%@AE@%%@NL@%
               is a C run-time error message.%@NL@%
%@NL@%
%@CR:MSEcE060@%%@4@%%@AB@%Cannot write on PRN:%@AE@% %@AI@%file%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor was unable to output the specified file to the%@NL@%
               printer.%@NL@%
%@NL@%
%@CR:MSEcE061@%%@4@%%@AB@%Cannot write printer intermediate file%@AE@%%@EH@%%@NL@%
%@NL@%
               OS/2 only. The editor was unable to write to the intermediate%@NL@%
               file used for printer queuing.%@NL@%
%@NL@%
%@CR:MSEcE062@%%@4@%%@AB@%Changed directory to%@AE@% %@AI@%file%@AE@%%@EH@%%@NL@%
%@NL@%
               The %@AI@%Setfile%@AE@% command successfully changed the current%@NL@%
               directory.%@NL@%
%@NL@%
%@CR:MSEcE063@%%@4@%%@AB@%Changed drive to%@AE@% %@AI@%file%@AE@%%@EH@%%@NL@%
%@NL@%
               The %@AI@%Setfile%@AE@% command successfully changed the current drive.%@NL@%
%@NL@%
%@CR:MSEcE064@%%@4@%%@AB@%Command could not be executed -%@AE@% %@AI@%command%@AE@%%@EH@%%@NL@%
%@NL@%
               You passed a system-level command line that could not be%@NL@%
               executed to the %@AI@%Shell%@AE@% or %@AI@%Compile%@AE@% command. This command line%@NL@%
               is displayed in the message as %@AI@%command%@AE@%.%@NL@%
%@NL@%
%@CR:MSEcE065@%%@4@%%@AB@%Command failed to begin,%@AE@% %@AI@%messagetext%@AE@%%@EH@%%@NL@%
%@NL@%
               OS/2 only. A background compilation could not begin for the%@NL@%
               reason stated in %@AI@%messagetext%@AE@%.%@NL@%
%@NL@%
%@CR:MSEcE066@%%@4@%%@AB@%Compilation complete - return code is%@AE@% %@AI@%number%@AE@%%@EH@%%@NL@%
%@NL@%
               DOS or real mode only. A compilation has completed with the%@NL@%
               return code shown. A nonzero return code usually indicates an%@NL@%
               error.%@NL@%
%@NL@%
%@CR:MSEcE067@%%@4@%%@AB@%Compile Action%@AE@% %@AI@%number%@AE@%%@AB@%: Internal Error%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor detected an internal error in the way it analyzed%@NL@%
               a regular expression. Please note the circumstances of this%@NL@%
               error and notify Microsoft Corporation by following the%@NL@%
               directions in the Microsoft Product Assistance Request form%@NL@%
               at the back of one of your manuals.%@NL@%
%@NL@%
%@CR:MSEcE068@%%@4@%%@AB@%Compile failed to begin,%@AE@% %@AI@%file%@AE@%%@AB@% -%@AE@% %@AI@%messagetext%@AE@%%@EH@%%@NL@%
%@NL@%
               OS/2 only. The %@AI@%Compile%@AE@% command could not execute the command%@NL@%
               line that it was given for the reason stated in %@AI@%messagetext%@AE@%.%@NL@%
%@NL@%
%@CR:MSEcE069@%%@4@%%@AB@%Compile list full, try later%@AE@%%@EH@%%@NL@%
%@NL@%
               OS/2 only. You tried to execute too many compilations at%@NL@%
               once. The limit to the number that can be queued (that is,%@NL@%
               waiting to execute) is 16.%@NL@%
%@NL@%
%@CR:MSEcE070@%%@4@%%@AB@%Cross-device link%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor encountered an internal error. Please note the%@NL@%
               circumstances of this error and notify Microsoft Corporation%@NL@%
               by following the directions in the Microsoft Product%@NL@%
               Assistance Request form at the back of one of your manuals.%@NL@%
%@NL@%
%@CR:MSEcE071@%%@4@%%@AB@%Delete current contents of compile log?%@AE@%%@EH@%%@NL@%
%@NL@%
               OS/2 only. The compile log still contains the results of a%@NL@%
               previous compilation. Type Y to delete the contents before%@NL@%
               starting another compilation.%@NL@%
%@NL@%
%@CR:MSEcE072@%%@4@%%@AB@%Do you want to delete this file from the current window?%@AE@%%@EH@%%@NL@%
%@NL@%
               You gave the %@AI@%Arg%@AE@% %@AI@%Refresh%@AE@% command, which removes the file from%@NL@%
               the current window. Type Y to remove the file, or N to%@NL@%
               continue editing the file.%@NL@%
%@NL@%
%@CR:MSEcE073@%%@4@%%@AB@%Do you want to replace this occurrence (Yes/No/All/Quit) :%@AE@%%@EH@%%@NL@%
%@NL@%
               The %@AI@%Qreplace%@AE@% function has found an occurrence of the search%@NL@%
               string and is prompting you for confirmation before%@NL@%
               substituting the replacement string. Type Y to make the%@NL@%
               replacement, N to avoid replacement, A to proceed with making%@NL@%
               replacements without confirmation, or Q to quit the %@AI@%Qreplace%@AE@%%@NL@%
               function.%@NL@%
%@NL@%
%@CR:MSEcE074@%%@4@%%@AB@%Do you want to reread this file?%@AE@%%@EH@%%@NL@%
%@NL@%
               You invoked the %@AI@%Refresh%@AE@% function. Type Y to discard the most%@NL@%
               recent edits and reread the file from disk. Type any other%@NL@%
               character to cancel the function.%@NL@%
%@NL@%
%@CR:MSEcE075@%%@4@%%@AB@%Do you want to save this file as%@AE@% %@AI@%filename%@AE@%%@AB@%?%@AE@%%@EH@%%@NL@%
%@NL@%
               You gave the %@AI@%Arg%@AE@% %@AI@%Arg%@AE@% %@AI@%textarg%@AE@% %@AI@%Setfile%@AE@% command, which saves the%@NL@%
               current file under a new file name. Type Y to proceed with%@NL@%
               the save or any other character to cancel the command.%@NL@%
%@NL@%
%@CR:MSEcE076@%%@4@%%@AB@%Empty replacement string, confirm:%@AE@%%@EH@%%@NL@%
%@NL@%
               The %@AI@%Replace%@AE@% or %@AI@%Qreplace%@AE@% function has been invoked with an%@NL@%
               empty replacement string. Type Y to confirm or any other%@NL@%
               character to cancel. Confirming an empty replacement string%@NL@%
               means that the editor simply deletes each occurrence of the%@NL@%
               search string that it finds.%@NL@%
%@NL@%
%@CR:MSEcE077@%%@4@%%@AB@%error on scratch file.%@AE@%%@EH@%%@NL@%
%@NL@%
               The drive on which the scratch (temporary) file resides is%@NL@%
               full. Exit the editor, change the setting of the TMP%@NL@%
               environment variable to a directory on a different drive, or%@NL@%
               free up space on the drive listed in TMP.%@NL@%
%@NL@%
%@CR:MSEcE078@%%@4@%%@AB@%EstimateAction%@AE@% %@AI@%number%@AE@%%@AB@%: Internal Error%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor detected an internal error in the way it analyzed%@NL@%
               a regular expression. Please note the circumstances of this%@NL@%
               error and notify Microsoft Corporation by following the%@NL@%
               directions in the Microsoft Product Assistance Request form%@NL@%
               at the back of one of your manuals.%@NL@%
%@NL@%
%@CR:MSEcE079@%%@4@%%@AB@%Exec format error%@AE@%%@EH@%%@NL@%
%@NL@%
               You attempted to load an extension module that does not have%@NL@%
               the correct format for this version of the editor. Rewrite%@NL@%
               the extension, relink, and recompile.%@NL@%
%@NL@%
%@CR:MSEcE080@%%@4@%%@AB@%File%@AE@% %@AI@%file%@AE@%%@AB@% is dirty, do you want to save it?%@AE@%%@EH@%%@NL@%
%@NL@%
               You are trying to exit without saving a file that has been%@NL@%
               altered since it was last saved. If you answer N, the changes%@NL@%
               will be lost.%@NL@%
%@NL@%
%@CR:MSEcE081@%%@4@%%@AB@%File has been deleted%@AE@%%@EH@%%@NL@%
%@NL@%
               The current file has been deleted by a program other than the%@NL@%
               editor, another process running under OS/2, another computer%@NL@%
               on the network, or a shelled or compiled program.%@NL@%
%@NL@%
%@CR:MSEcE082@%%@4@%%@AB@%File to edit:%@AE@%%@EH@%%@NL@%
%@NL@%
               You started the editor without specifying a file, and there%@NL@%
               is no previously edited file. Enter a file name or press%@NL@%
               ENTER to exit back to the operating-system level.%@NL@%
%@NL@%
%@CR:MSEcE083@%%@4@%%@AB@%Flushing%@AE@% %@AI@%file%@AE@%%@AB@% from memory%@AE@%%@EH@%%@NL@%
%@NL@%
               The specified %@AI@%file%@AE@% has been cleared from memory.%@NL@%
%@NL@%
%@CR:MSEcE084@%%@4@%%@AB@%Illegal Extension Interface Called%@AE@%%@EH@%%@NL@%
%@NL@%
               An extension function attempted to call a low-level function%@NL@%
               that is not supported by this version of the editor. Consult%@NL@%
               Chapters 8%@BO:   3fbeb@% and 9%@BO:   50fea@% for a list of low-level functions%@NL@%
               supported by the editor.%@NL@%
%@NL@%
%@CR:MSEcE085@%%@4@%%@AB@%Illegal setting%@AE@%%@EH@%%@NL@%
%@NL@%
               You attempted to set a switch to an invalid setting.%@NL@%
%@NL@%
%@CR:MSEcE086@%%@4@%%@AB@%Internal Error: RE error%@AE@% %@AI@%number%@AE@%%@AB@%, line%@AE@% %@AI@%number%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor detected an internal error in the way it analyzed%@NL@%
               a regular expression. Please note the circumstances of this%@NL@%
               error and notify Microsoft Corporation by following the%@NL@%
               directions in the Microsoft Product Assistance Request form%@NL@%
               at the back of one of your manuals.%@NL@%
%@NL@%
%@CR:MSEcE087@%%@4@%%@AB@%Invalid argument%@AE@%%@EH@%%@NL@%
%@NL@%
               The function just invoked does not accept the argument given.%@NL@%
               Try reentering the command using a valid argument.%@NL@%
%@NL@%
%@CR:MSEcE088@%%@4@%%@AB@%Invalid drive%@AE@%%@EH@%%@NL@%
%@NL@%
               You attempted to execute a command with a drive letter not%@NL@%
               recognized by your system. Use a different drive letter.%@NL@%
%@NL@%
%@CR:MSEcE089@%%@4@%%@AB@%Invalid pattern%@AE@%%@EH@%%@NL@%
%@NL@%
               You specified a regular-expression search command but gave a%@NL@%
               search string that is not a valid regular expression. Check%@NL@%
               the syntax rules for regular expressions and reenter.%@NL@%
%@NL@%
%@CR:MSEcE090@%%@4@%%@AB@%Invalid replacement pattern%@AE@%%@EH@%%@NL@%
%@NL@%
               You specified a regular-expression search and replace command%@NL@%
               but gave an invalid replacement string. Check the syntax%@NL@%
               rules for regular-expression replacement strings and reenter.%@NL@%
%@NL@%
%@CR:MSEcE091@%%@4@%%@AB@%Invoke: "%@AE@%%@AI@%command%@AE@%%@AB@%" (y/n)?%@AE@%%@EH@%%@NL@%
%@NL@%
               You attempted to overwrite a file on disk that has the%@NL@%
               read-only attribute set, and the %@AB@%readonly%@AE@% switch has been%@NL@%
               assigned a command. The editor asks you for confirmation%@NL@%
               before executing this command.%@NL@%
%@NL@%
%@CR:MSEcE092@%%@4@%%@AB@%Kill background compile?%@AE@%%@EH@%%@NL@%
%@NL@%
               OS/2 only. You gave the %@AI@%Arg Arg Meta Compile%@AE@% command, which%@NL@%
               kills a background compilation after prompting for%@NL@%
               confirmation. Type Y to terminate the compilation or any%@NL@%
               other key to cancel the command.%@NL@%
%@NL@%
%@CR:MSEcE093@%%@4@%%@AB@%Line%@AE@% %@AI@%linenumber%@AE@%%@AB@% too long%@AE@%%@EH@%%@NL@%
%@NL@%
               The indicated line exceeds the maximum of 251 characters. The%@NL@%
               editor ignores edits that exceed this limit.%@NL@%
%@NL@%
%@CR:MSEcE094@%%@4@%%@AB@%line%@AE@% %@AI@%linenumber%@AE@%%@AB@% too long; replacement skipped%@AE@%%@EH@%%@NL@%
%@NL@%
               The replacement requested would have caused the indicated%@NL@%
               line to be greater than the maximum line length, so the%@NL@%
               replacement was not performed.%@NL@%
%@NL@%
%@CR:MSEcE095@%%@4@%%@AB@%List Error: '%@AE@%%@AI@%listmacro%@AE@%%@AB@%' does not exist%@AE@%%@EH@%%@NL@%
%@NL@%
               The specified list macro did not exist. You may have mistyped%@NL@%
               its name or used the wrong syntax.%@NL@%
%@NL@%
%@CR:MSEcE096@%%@4@%%@AB@%List Error: Nested too deeply at '%@AE@%%@AI@%macroname%@AE@%%@AB@%'%@AE@%%@EH@%%@NL@%
%@NL@%
               Macros may be nested no more than 20 deep. You tried to%@NL@%
               execute a macro that has more than 20 nesting levels; the%@NL@%
               %@AI@%macroname%@AE@% placeholder indicates the macro which tried to call%@NL@%
               a macro at the 21st level.%@NL@%
%@NL@%
%@CR:MSEcE097@%%@4@%%@AB@%M internal error -%@AE@% %@AI@%file%@AE@%%@AB@%, continue?%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor encountered an internal error. Please note the%@NL@%
               circumstances of this error and notify Microsoft Corporation%@NL@%
               by following the directions in the Microsoft Product%@NL@%
               Assistance Request form at the back of one of your manuals.%@NL@%
%@NL@%
%@CR:MSEcE098@%%@4@%%@AB@%macro%@AE@% %@AI@%file%@AE@%%@AB@% is in use%@AE@%%@EH@%%@NL@%
%@NL@%
               A macro attempted to redefine itself during execution (by%@NL@%
               using the %@AI@%Assign%@AE@% command), or a macro called a second macro%@NL@%
               that attempted to redefine the first macro.%@NL@%
%@NL@%
%@CR:MSEcE099@%%@4@%%@AB@%Macros nested too deep%@AE@%%@EH@%%@NL@%
%@NL@%
               You created a macro that used too many levels of nesting. A%@NL@%
               macro is nested when it is executed inside another macro.%@NL@%
               Macros can be nested to 20 levels.%@NL@%
%@NL@%
%@CR:MSEcE100@%%@4@%%@AB@%Mapped line%@AE@% %@AI@%number%@AE@%%@AB@% too long%@AE@%%@EH@%%@NL@%
%@NL@%
               You used the %@AI@%Environment%@AE@% function to replace the names of%@NL@%
               environment variables in a text string with their actual%@NL@%
               values; the resulting string was greater than 251 characters.%@NL@%
%@NL@%
%@CR:MSEcE101@%%@4@%%@AB@%Math argument%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor encountered an internal error. Please note the%@NL@%
               circumstances of this error and notify Microsoft Corporation%@NL@%
               by following the directions in the Microsoft Product%@NL@%
               Assistance Request form at the back of one of your manuals.%@NL@%
%@NL@%
%@CR:MSEcE102@%%@4@%%@AB@%mGetCmd called with no macros in effect%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor encountered an internal error. Please note the%@NL@%
               circumstances of this error and notify Microsoft Corporation%@NL@%
               by following the directions in the Microsoft Product%@NL@%
               Assistance Request form at the back of one of your manuals.%@NL@%
%@NL@%
%@CR:MSEcE103@%%@4@%%@AB@%missing ':' in%@AE@% %@AI@%string%@AE@%%@EH@%%@NL@%
%@NL@%
               You gave an argument to the %@AI@%Assign%@AE@% command without including%@NL@%
               an assignment symbol (:).%@NL@%
%@NL@%
%@CR:MSEcE104@%%@4@%%@AB@%Missing key assignment for '%@AE@%%@AI@%function%@AE@%%@AB@%'%@AE@%%@EH@%%@NL@%
%@NL@%
               You attempted to assign the given %@AI@%function%@AE@% to a keystroke but%@NL@%
               did not enter a keystroke name.%@NL@%
%@NL@%
%@CR:MSEcE105@%%@4@%%@AB@%New file name:%@AE@%%@EH@%%@NL@%
%@NL@%
               You attempted to overwrite a file on disk that has the%@NL@%
               read-only attribute set, and the %@AB@%readonly%@AE@% switch has not been%@NL@%
               assigned a command. The editor asks for a new file name under%@NL@%
               which to save the file so your edits are not lost. Respond%@NL@%
               with the name of a file that can be overwritten.%@NL@%
%@NL@%
%@CR:MSEcE106@%%@4@%%@AB@%Next file is%@AE@% %@AI@%file%@AE@%%@AB@%...%@AE@%%@EH@%%@NL@%
%@NL@%
               You invoked the %@AI@%Setfile%@AE@% function, and the editor is now%@NL@%
               loading the given file.%@NL@%
%@NL@%
%@CR:MSEcE107@%%@4@%%@AB@%no alternate file%@AE@%%@EH@%%@NL@%
%@NL@%
               You gave the %@AI@%Setfile%@AE@% command file with no arguments, but%@NL@%
               there was no alternate file to load. The %@AI@%Setfile%@AE@% command with%@NL@%
               no arguments normally switches to the previous file.%@NL@%
%@NL@%
%@CR:MSEcE108@%%@4@%%@AB@%No command to repeat%@AE@%%@EH@%%@NL@%
%@NL@%
               You executed the %@AI@%Repeat%@AE@% function to repeat the previous%@NL@%
               function, but no previous function had been executed.%@NL@%
%@NL@%
%@CR:MSEcE109@%%@4@%%@AB@%No compile command known%@AE@%%@EH@%%@NL@%
%@NL@%
               You executed %@AI@%Arg textarg Compile%@AE@%, but there was no%@NL@%
               corresponding %@AB@%extmake:text%@AE@% definition.%@NL@%
%@NL@%
%@CR:MSEcE110@%%@4@%%@AB@%No compile command known for .%@AE@%%@AI@%ext%@AE@%%@EH@%%@NL@%
%@NL@%
               No %@AI@%extmake%@AE@% definition has been created for the extension of%@NL@%
               the file you are currently editing.%@NL@%
%@NL@%
%@CR:MSEcE111@%%@4@%%@AB@%No compile command known for extension%@AE@% %@AI@%file%@AE@%%@EH@%%@NL@%
%@NL@%
               You invoked the %@AI@%Arg Compile%@AE@% command, which uses the extension%@NL@%
               of the current file, but the %@AB@%extmake%@AE@% switch has no setting%@NL@%
               for this file extension. Before invoking %@AI@%Arg Compile%@AE@%, make%@NL@%
               the assignment%@NL@%
%@NL@%
               %@AB@%extmake:%@AE@% %@AI@%ext%@AE@% %@AI@%command-line%@AE@%%@NL@%
%@NL@%
               in which %@AI@%ext%@AE@% is the extension of the current file.%@NL@%
%@NL@%
%@CR:MSEcE112@%%@4@%%@AB@%No compile in progress%@AE@%%@EH@%%@NL@%
%@NL@%
               You executed a %@AI@%Compile%@AE@% command without arguments, which%@NL@%
               returns the current compilation status. No compilation was in%@NL@%
               progress.%@NL@%
%@NL@%
%@CR:MSEcE113@%%@4@%%@AB@%No-Edit file may not be modified%@AE@%%@EH@%%@NL@%
%@NL@%
               You attempted to execute an editing command that would change%@NL@%
               a No-Edit file. No-Edit files cannot be modified, even in%@NL@%
               memory.%@NL@%
%@NL@%
%@CR:MSEcE114@%%@4@%%@AB@%No matching files%@AE@%%@EH@%%@NL@%
%@NL@%
               You invoked the %@AI@%Setfile%@AE@% function with a string containing the%@NL@%
               wildcards ? or *, but no file names matched this string.%@NL@%
%@NL@%
%@CR:MSEcE115@%%@4@%%@AB@%No more compilation messages%@AE@%%@EH@%%@NL@%
%@NL@%
               The %@AI@%Compile%@AE@% function was given with no arguments. This%@NL@%
               function moves the cursor to the next error message. However,%@NL@%
               there are no further error messages.%@NL@%
%@NL@%
%@CR:MSEcE116@%%@4@%%@AB@%No search string specified%@AE@%%@EH@%%@NL@%
%@NL@%
               You invoked %@AI@%Psearch%@AE@% or %@AI@%Msearch%@AE@% without a search string, and%@NL@%
               there is no previously defined search string to use as a%@NL@%
               default. Use an argument the first time you use %@AI@%Psearch%@AE@% or%@NL@%
               %@AI@%Msearch%@AE@%.%@NL@%
%@NL@%
%@CR:MSEcE117@%%@4@%%@AB@%No space left on device%@AE@%%@EH@%%@NL@%
%@NL@%
               You attempted to save a file to a device (usually a disk%@NL@%
               drive) that has no room left. Execute a shell and make room%@NL@%
               on the drive, or else save to a different device.%@NL@%
%@NL@%
%@CR:MSEcE118@%%@4@%%@AB@%No such file or directory%@AE@%%@EH@%%@NL@%
%@NL@%
               You attempted to use the %@AI@%Setfile%@AE@% function to change to a file%@NL@%
               or directory that does not exist.%@NL@%
%@NL@%
%@CR:MSEcE119@%%@4@%%@AB@%No unbalanced characters found%@AE@%%@EH@%%@NL@%
%@NL@%
               You invoked the %@AI@%Pbal%@AE@% function, but there are no unbalanced%@NL@%
               braces, brackets, or parentheses.%@NL@%
%@NL@%
%@CR:MSEcE120@%%@4@%%@AB@%No-Execute Record Mode - Press%@AE@% %@AI@%keystroke%@AE@%%@AB@% to resume normal editing%@AE@%%@EH@%%@NL@%
%@NL@%
               You have completed the special macro recording function (%@AI@%Meta%@AE@%%@NL@%
               %@AI@%Record%@AE@%) that records the macro without executing the%@NL@%
               keystrokes. This message reminds you that the editor is not%@NL@%
               hung. You may continue normal editing after pressing the%@NL@%
               specified key.%@NL@%
%@NL@%
%@CR:MSEcE121@%%@4@%%@AB@%Not enough core%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor encountered an internal error. Please note the%@NL@%
               circumstances of this error and notify Microsoft Corporation%@NL@%
               by following the directions in the Microsoft Product%@NL@%
               Assistance Request form at the back of one of your manuals.%@NL@%
%@NL@%
%@CR:MSEcE122@%%@4@%%@AB@%Not enough free memory%@AE@%%@EH@%%@NL@%
%@NL@%
               DOS or real mode only. The editor was unable to allocate%@NL@%
               enough memory for all the files that were opened and was%@NL@%
               unable to recover. Normally, the editor recovers from lack of%@NL@%
               memory by closing files if it can. Terminate the editing%@NL@%
               session immediately.%@NL@%
%@NL@%
%@CR:MSEcE123@%%@4@%%@AB@%Not enough memory for pattern%@AE@%%@EH@%%@NL@%
%@NL@%
               You specified a regular-expression pattern too complicated%@NL@%
               for the editor to implement. Specify a simpler pattern.%@NL@%
%@NL@%
%@CR:MSEcE124@%%@4@%%@AB@%not enough memory on exec%@AE@%%@EH@%%@NL@%
%@NL@%
               OS/2 only. You gave a %@AI@%Compile%@AE@% or %@AI@%Shell%@AE@% command that could not%@NL@%
               be executed.%@NL@%
%@NL@%
%@CR:MSEcE125@%%@4@%%@AB@%Not enough room for macro%@AE@% %@AI@%macroname%@AE@%%@EH@%%@NL@%
%@NL@%
               You defined 1,024 macros and cannot add another. To reduce%@NL@%
               the number of macros, exit the editor and restart.%@NL@%
%@NL@%
%@CR:MSEcE126@%%@4@%%@AB@%Not supported by video display%@AE@%%@EH@%%@NL@%
%@NL@%
               You attempted to assign the %@AB@%height%@AE@% switch to a value not%@NL@%
               supported by the video adapter card. Only the following%@NL@%
               values are supported: 23 for CGA and monochrome; 23 and 41%@NL@%
               for EGA; and 23, 41, and 48 for VGA.%@NL@%
%@NL@%
%@CR:MSEcE127@%%@4@%%@AB@%Nothing to ReDo%@AE@%%@EH@%%@NL@%
%@NL@%
               You have repeated the last command in the editing command%@NL@%
               list; there are no more commands that can be repeated.%@NL@%
%@NL@%
%@CR:MSEcE128@%%@4@%%@AB@%Nothing to UnDo%@AE@%%@EH@%%@NL@%
%@NL@%
               You have reversed every editing command that remains in the%@NL@%
               UnDo list; there are no more editing commands to reverse.%@NL@%
%@NL@%
%@CR:MSEcE129@%%@4@%%@AB@%Out of disk space for VM swap file - recovering%@AE@%%@EH@%%@NL@%
%@NL@%
               DOS or real mode only. An insufficient amount of space was%@NL@%
               available for swapping. Exit the editor and reset the TMP%@NL@%
               environment variable to a disk drive with more space, if%@NL@%
               possible.%@NL@%
%@NL@%
%@CR:MSEcE130@%%@4@%%@AB@%Out of far memory - recovering%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor has insufficient memory to support all the files%@NL@%
               open and is now trying to recover memory so that no%@NL@%
               information is lost.%@NL@%
%@NL@%
%@CR:MSEcE131@%%@4@%%@AB@%Out of local heap - recovering%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor has insufficient memory to support all the files%@NL@%
               open and is now trying to recover memory so that no%@NL@%
               information is lost.%@NL@%
%@NL@%
%@CR:MSEcE132@%%@4@%%@AB@%Out of local memory%@AE@%%@EH@%%@NL@%
%@NL@%
               DOS or real mode only. The editor was unable to allocate%@NL@%
               enough memory for all the files that were opened and was%@NL@%
               unable to recover. Normally, the editor recovers from lack of%@NL@%
               memory by closing files if it can. Terminate the editing%@NL@%
               session and do not open as many files at the same time.%@NL@%
%@NL@%
%@CR:MSEcE133@%%@4@%%@AB@%Out of space on%@AE@% %@AI@%device%@AE@%%@EH@%%@NL@%
%@NL@%
               You attempted to save a file to a %@AI@%device%@AE@% (usually a disk%@NL@%
               drive) with no room left. Create free space on the drive, or%@NL@%
               else save to a different device.%@NL@%
%@NL@%
%@CR:MSEcE134@%%@4@%%@AB@%Packed file is corrupt%@AE@%%@EH@%%@NL@%
%@NL@%
               DOS or real mode only. You used the %@AI@%Shell%@AE@% or %@AI@%Compile%@AE@% function%@NL@%
               to execute a corrupted packed file.%@NL@%
%@NL@%
%@CR:MSEcE135@%%@4@%%@AB@%Permission denied%@AE@%%@EH@%%@NL@%
%@NL@%
               You attempted to write to a locked file.%@NL@%
%@NL@%
%@CR:MSEcE136@%%@4@%%@AB@%Please strike any key to continue%@AE@%%@EH@%%@NL@%
%@NL@%
               The %@AI@%Shell%@AE@% command has terminated, and the editor is ready to%@NL@%
               continue the normal editing session.%@NL@%
%@NL@%
%@CR:MSEcE137@%%@4@%%@AB@%Press any key...%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor has completed some operation and is waiting for%@NL@%
               you to press a key before resuming the editing session.%@NL@%
%@NL@%
%@CR:MSEcE138@%%@4@%%@AB@%Print list full, try later%@AE@%%@EH@%%@NL@%
%@NL@%
               OS/2 only. There is no space in the printing queue for%@NL@%
               another file. Wait, then submit your print request again.%@NL@%
%@NL@%
%@CR:MSEcE139@%%@4@%%@AB@%Printing%@AE@% %@AI@%file%@AE@%%@AB@%... Press Esc to abort%@AE@%%@EH@%%@NL@%
%@NL@%
               Your print request has been accepted. Press ESC to cancel the%@NL@%
               printing.%@NL@%
%@NL@%
%@CR:MSEcE140@%%@4@%%@AB@%Printing:%@AE@% %@AI@%file%@AE@%%@EH@%%@NL@%
%@NL@%
               The specified %@AI@%file%@AE@% will be printed.%@NL@%
%@NL@%
%@CR:MSEcE141@%%@4@%%@AB@%Query search string:%@AE@%%@EH@%%@NL@%
%@NL@%
               You invoked the %@AI@%Qreplace%@AE@% function. Enter a new search string,%@NL@%
               press ENTER (or invoke the %@AI@%Emacsnewl%@AE@% function) to accept the%@NL@%
               old search string, or invoke %@AI@%Cancel%@AE@% to exit.%@NL@%
%@NL@%
%@CR:MSEcE142@%%@4@%%@AB@%Queued: '%@AE@%%@AI@%file%@AE@%%@AB@%'%@AE@%%@EH@%%@NL@%
%@NL@%
               OS/2 only. You gave a new compile command before the last%@NL@%
               compilation was complete. The editor will not spawn more than%@NL@%
               one compilation at a time but can hold up to 16 compile%@NL@%
               commands to be executed sequentially.%@NL@%
%@NL@%
%@CR:MSEcE143@%%@4@%%@AB@%RE emulator stack overflow%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor encountered an internal error while evaluating a%@NL@%
               regular expression. Please note the circumstances of this%@NL@%
               error and notify Microsoft Corporation by following the%@NL@%
               directions in the Microsoft Product Assistance Request form%@NL@%
               at the back of one of your manuals.%@NL@%
%@NL@%
%@CR:MSEcE144@%%@4@%%@AB@%RemoveFile can't find file%@AE@%%@EH@%%@NL@%
%@NL@%
               An extension module passed a nonexistent file to the%@NL@%
               %@AB@%RemoveFile%@AE@% low-level function.%@NL@%
%@NL@%
%@CR:MSEcE145@%%@4@%%@AB@%Removing file%@AE@% %@AI@%filename%@AE@%%@EH@%%@NL@%
%@NL@%
               The %@AB@%RemoveFile%@AE@% low-level function has removed a file buffer%@NL@%
               from memory. This is not an error unless you need to have the%@NL@%
               file open for editing.%@NL@%
%@NL@%
%@CR:MSEcE146@%%@4@%%@AB@%Replace string:%@AE@%%@EH@%%@NL@%
%@NL@%
               You invoked the %@AI@%Replace%@AE@% function. Enter a new replacement%@NL@%
               string, press ENTER (or invoke the %@AI@%Emacsnewl%@AE@% function) to%@NL@%
               accept the old replacement string, or invoke %@AI@%Cancel%@AE@% to exit.%@NL@%
%@NL@%
%@CR:MSEcE147@%%@4@%%@AB@%Replace this occurrence (Yes/No/All/Quit):%@AE@%%@EH@%%@NL@%
%@NL@%
               You executed the %@AI@%Qreplace%@AE@% function, which prompts for the%@NL@%
               replacement rather than performing the replacement%@NL@%
               automatically. You can choose not to replace the text, to%@NL@%
               replace the text for this occurrence only, to replace all%@NL@%
               following occurrences, or to quit the %@AI@%Qreplace%@AE@% function.%@NL@%
%@NL@%
%@CR:MSEcE148@%%@4@%%@AB@%Resource deadlock would occur%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor encountered an internal error. Please note the%@NL@%
               circumstances of this error and notify Microsoft Corporation%@NL@%
               by following the directions in the Microsoft Product%@NL@%
               Assistance Request form at the back of one of your manuals.%@NL@%
%@NL@%
%@CR:MSEcE149@%%@4@%%@AB@%Result too large%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor encountered an internal error. Please note the%@NL@%
               circumstances of this error and notify Microsoft Corporation%@NL@%
               by following the directions in the Microsoft Product%@NL@%
               Assistance Request form at the back of one of your manuals.%@NL@%
%@NL@%
%@CR:MSEcE150@%%@4@%%@AB@%run-time error%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor encountered an internal error. Please note the%@NL@%
               circumstances of this error and notify Microsoft Corporation%@NL@%
               by following the directions in the Microsoft Product%@NL@%
               Assistance Request form at the back of one of your manuals.%@NL@%
%@NL@%
%@CR:MSEcE151@%%@4@%%@AB@%Save all remaining changed files (Y/N)?%@AE@%%@EH@%%@NL@%
%@NL@%
               This prompt appears when there are one or more changed files%@NL@%
               in addition to the file you were working on when you%@NL@%
               attempted to exit. If you respond Y, all the remaining%@NL@%
               changed files will be saved. If you respond N, you will be%@NL@%
               prompted about saving each file individually.%@NL@%
%@NL@%
%@CR:MSEcE152@%%@4@%%@AB@%Save file%@AE@% %@AI@%file%@AE@%%@AB@% before flushing (y/n/p)%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor is running low on memory and needs to remove file%@NL@%
               buffers. No saved files are available for removal, and the%@NL@%
               editor must remove unsaved files. Type Y to save changes to%@NL@%
               %@AI@%file%@AE@% before it is removed, or N to remove %@AI@%file%@AE@% without saving%@NL@%
               changes. Type P to save all files that have unsaved changes.%@NL@%
               Invoke the %@AI@%Cancel%@AE@% function to prevent %@AI@%file%@AE@% from being%@NL@%
               removed. This last option causes the editor to try to remove%@NL@%
               a different %@AI@%file%@AE@% if one is available.%@NL@%
%@NL@%
%@CR:MSEcE153@%%@4@%%@AB@%Saving%@AE@% %@AI@%file%@AE@%%@AB@% ...%@AE@%%@EH@%%@NL@%
%@NL@%
               You invoked the %@AI@%Setfile%@AE@% function, and the editor is now%@NL@%
               saving %@AI@%file%@AE@%.%@NL@%
%@NL@%
%@CR:MSEcE154@%%@4@%%@AB@%Search string:%@AE@%%@EH@%%@NL@%
%@NL@%
               You invoked the %@AI@%Replace%@AE@% function. Enter a new search string,%@NL@%
               press ENTER (or invoke the %@AI@%Emacsnewl%@AE@% function) to accept the%@NL@%
               old search string, or invoke %@AI@%Cancel%@AE@% to exit.%@NL@%
%@NL@%
%@CR:MSEcE155@%%@4@%%@AB@%Source file not found:%@AE@% %@AI@%file%@AE@%%@EH@%%@NL@%
%@NL@%
               The %@AI@%Arg%@AE@% %@AI@%Compile%@AE@% command was invoked but could not find one of%@NL@%
               the files specified. Reset the %@AB@%extmake%@AE@% switch so that%@NL@%
               compilations can run successfully.%@NL@%
%@NL@%
%@CR:MSEcE156@%%@4@%%@AB@%Spawn failed on%@AE@% %@AI@%command%@AE@%%@AB@% -%@AE@% %@AI@%messagetext%@AE@%%@EH@%%@NL@%
%@NL@%
               The %@AI@%Shell%@AE@% or %@AI@%Compile%@AE@% function was given a command that could%@NL@%
               not be executed for the reason given in %@AI@%messagetext%@AE@%.%@NL@%
%@NL@%
%@CR:MSEcE157@%%@4@%%@AB@%Swapping file%@AE@% %@AI@%file%@AE@%%@AB@% already exists.%@AE@%%@EH@%%@NL@%
%@NL@%
               DOS or real mode only. When you started the editor, the%@NL@%
               virtual-memory swapping file already existed. (On start-up,%@NL@%
               the editor assumes that this file has been deleted.) Delete%@NL@%
               %@AI@%file%@AE@% and restart the editor.%@NL@%
%@NL@%
%@CR:MSEcE158@%%@4@%%@AB@%Testing VM error at%@AE@% %@AI@%address%@AE@%%@AB@% error on scratch file. This usually indicates a%@AE@%%@EH@%%@NL@%
%@AB@%full-disk on the scratch file device. Please attempt to free some space on%@AE@%%@NL@%
%@AB@%it.%@AE@%%@NL@%
%@NL@%
               The editor encountered an internal error. Please note the%@NL@%
               circumstances of this error and notify Microsoft Corporation%@NL@%
               by following the directions in the Microsoft Product%@NL@%
               Assistance Request form at the back of one of your manuals.%@NL@%
%@NL@%
%@CR:MSEcE159@%%@4@%%@AB@%This program cannot be run in DOS mode.%@AE@%%@EH@%%@NL@%
%@NL@%
               OS/2 only. You invoked the %@AI@%Shell%@AE@% or %@AI@%Compile%@AE@% command, which%@NL@%
               can be run in real mode only (DOS or 3.%@AI@%x%@AE@% compatibility box).%@NL@%
%@NL@%
%@CR:MSEcE160@%%@4@%%@AB@%Too many open files%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor tried to open more files at the operating-system%@NL@%
               level, but the system cannot open any more files. Typically,%@NL@%
               this error occurs when an extension opens many files, or the%@NL@%
               FILES setting in CONFIG.SYS is too small. Increase the FILES%@NL@%
               setting in CONFIG.SYS if this setting is not already at the%@NL@%
               system maximum, then reboot. (This maximum is 20 in most%@NL@%
               versions of DOS.)%@NL@%
%@NL@%
%@CR:MSEcE161@%%@4@%%@AB@%Too many windows%@AE@%%@EH@%%@NL@%
%@NL@%
               You tried to open more than eight windows, which is the%@NL@%
               maximum number supported by the editor.%@NL@%
%@NL@%
%@CR:MSEcE162@%%@4@%%@AB@%Unable to create pipe:%@AE@%%@EH@%%@NL@%
%@NL@%
               OS/2 only. This message appears only on start-up. The editor%@NL@%
               cannot generate the pipes it needs for background compiling%@NL@%
               and printing. These features will not be available during the%@NL@%
               current editing session. This problem is probably the result%@NL@%
               of a lack of memory or file handles.%@NL@%
%@NL@%
%@CR:MSEcE163@%%@4@%%@AB@%Unable to open swapping file%@AE@% %@AI@%file%@AE@%%@AB@% -%@AE@% %@AI@%messagetext%@AE@%%@EH@%%@NL@%
%@NL@%
               DOS or real mode only. When you started the editor, it was%@NL@%
               unable to recreate the virtual-memory swapping file. Make%@NL@%
               sure your TMP environment variable lists an accessible%@NL@%
               location.%@NL@%
%@NL@%
%@CR:MSEcE164@%%@4@%%@AB@%Unable to read TOOLS.INI%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor could not read the TOOLS.INI file upon start-up.%@NL@%
               Make sure that the TOOLS.INI file read permission is in the%@NL@%
               proper format.%@NL@%
%@NL@%
%@CR:MSEcE165@%%@4@%%@AB@%Unable to recover - abort now?%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor has run out of memory and exhausted all possible%@NL@%
               roads to recovery. (The editor takes a number of measures to%@NL@%
               recover memory before it reports this error.) If you have%@NL@%
               files you need to save, type N to save them now before the%@NL@%
               editor terminates. Otherwise, type Y to terminate%@NL@%
               immediately.%@NL@%
%@NL@%
%@CR:MSEcE166@%%@4@%%@AB@%Unable to set up compile pipe%@AE@%%@EH@%%@NL@%
%@NL@%
               OS/2 only. The editor encountered an internal error. Please%@NL@%
               note the circumstances of this error and notify Microsoft%@NL@%
               Corporation by following the directions in the Microsoft%@NL@%
               Product Assistance Request form at the back of one of your%@NL@%
               manuals.%@NL@%
%@NL@%
%@CR:MSEcE167@%%@4@%%@AB@%Unable to start compile thread%@AE@%%@EH@%%@NL@%
%@NL@%
               OS/2 only. The editor encountered an internal error. Please%@NL@%
               note the circumstances of this error and notify Microsoft%@NL@%
               Corporation by following the directions in the Microsoft%@NL@%
               Product Assistance Request form at the back of one of your%@NL@%
               manuals.%@NL@%
%@NL@%
%@CR:MSEcE168@%%@4@%%@AB@%Unable to start Idle thread%@AE@%%@EH@%%@NL@%
%@NL@%
               OS/2 only. The editor encountered an internal error. Please%@NL@%
               note the circumstances of this error and notify Microsoft%@NL@%
               Corporation by following the directions in the Microsoft%@NL@%
               Product Assistance Request form at the back of one of your%@NL@%
               manuals.%@NL@%
%@NL@%
%@CR:MSEcE169@%%@4@%%@AB@%Unable to start printing thread%@AE@%%@EH@%%@NL@%
%@NL@%
               OS/2 only. The editor encountered an internal error. Please%@NL@%
               note the circumstances of this error and notify Microsoft%@NL@%
               Corporation by following the directions in the Microsoft%@NL@%
               Product Assistance Request form at the back of one of your%@NL@%
               manuals.%@NL@%
%@NL@%
%@CR:MSEcE170@%%@4@%%@AB@%Unknown error%@AE@%%@EH@%%@NL@%
%@NL@%
               The editor encountered an internal error. Please note the%@NL@%
               circumstances of this error and notify Microsoft Corporation%@NL@%
               by following the directions in the Microsoft Product%@NL@%
               Assistance Request form at the back of one of your manuals.%@NL@%
%@NL@%
%@CR:MSEcE171@%%@4@%%@AB@%unknown function%@AE@% %@AI@%name%@AE@%%@EH@%%@NL@%
%@NL@%
               You attempted to execute a macro-definition list containing%@NL@%
               an undefined function or macro name. Make sure that %@AI@%name%@AE@% is%@NL@%
               defined before appearing in a macro or as an argument to%@NL@%
               %@AI@%Execute%@AE@%.%@NL@%
%@NL@%
%@CR:MSEcE172@%%@4@%%@AB@%Unsupported video mode.  Please change modes and restart.%@AE@%%@EH@%%@NL@%
%@NL@%
               You started the editor in an unrecognized video mode. Please%@NL@%
               exit the editor and reset the operating system video mode.%@NL@%
%@NL@%
%@CR:MSEcE173@%%@4@%%@AB@%VM: Alloc  Free%@AE@%%@EH@%%@NL@%
%@NL@%
               OS/2 only. The editor encountered an internal error. Please%@NL@%
               note the circumstances of this error and notify Microsoft%@NL@%
               Corporation by following the directions in the Microsoft%@NL@%
               Product Assistance Request form at the back of one of your%@NL@%
               manuals.%@NL@%
%@NL@%
%@CR:MSEcE174@%%@4@%%@AB@%Warning: continuation character on last line!%@AE@%%@EH@%%@NL@%
%@NL@%
               The last line from the appropriate section of TOOLS.INI ended%@NL@%
               in a continuation character but there was no following line.%@NL@%
%@NL@%
%@CR:MSEcE175@%%@4@%%@AB@%Window too small to split%@AE@%%@EH@%%@NL@%
%@NL@%
               You attempted to create a window smaller than 5 lines or 5%@NL@%
               columns. Choose a different cursor position to split the%@NL@%
               window.%@NL@%
%@NL@%
%@CR:MSEcE176@%%@4@%%@AB@%You have more files to edit. Are you sure you want to exit? (y/n):%@AE@%%@EH@%%@NL@%
%@NL@%
               You specified more than one file when you started the editor,%@NL@%
               but you are quitting without having edited all of them. Type%@NL@%
               Y to exit or N to continue editing.%@NL@%
%@NL@%
%@CR:MSEcE177@%%@4@%%@AB@%You have unsaved files.  Are you sure you want to exit? (y/n):%@AE@%%@EH@%%@NL@%
%@NL@%
               You gave the %@AI@%Meta Exit%@AE@% command, and the editor has detected%@NL@%
               at least one file open with unsaved changes. Type Y to exit%@NL@%
               without saving, or any other key to continue editing.%@NL@%
%@NL@%
%@NL@%
%@NL@%
%@CR:MSEg0000@%%@1@%%@AB@%Glossary%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%@CR:MSEg0001@%%@4@%This glossary defines terms in this manual used in a technical or unique%@EH@%
way.%@NL@%
%@NL@%
%@CR:MSEgD001@%%@4@%%@AB@%Arg%@AE@%%@EH@%%@NL@%
  A function modifier that introduces an argument or an editing function.
  The argument may be of any type and is passed to the next function as
  input. For example, the command %@AI@%Arg textarg Copy%@AE@% passes the argument
  %@AI@%textarg%@AE@% to the function %@AI@%Copy%@AE@%.%@NL@%
%@NL@%
%@CR:MSEgD002@%%@4@%%@AB@%argument%@AE@%%@EH@%%@NL@%
  An input to a function. The Microsoft Editor uses two classes of
  arguments: cursor-movement arguments and text arguments. Cursor-movement
  arguments (%@AI@%boxarg%@AE@%, %@AI@%linearg%@AE@%, and %@AI@%streamarg%@AE@%) specify a range of characters
  on the screen. Text arguments (%@AI@%markarg%@AE@%, %@AI@%numarg%@AE@%, and %@AI@%textarg%@AE@%) are typed in
  directly. Arguments are introduced by using the %@AI@%Arg%@AE@% function.%@NL@%
%@NL@%
%@CR:MSEgD003@%%@4@%%@AB@%assignment%@AE@%%@EH@%%@NL@%
  %@AI@%See%@AE@% "function assignment."%@NL@%
%@NL@%
%@CR:MSEgD004@%%@4@%%@AB@%box mode%@AE@%%@EH@%%@NL@%
  The editing mode that lets you highlight cursor-movement arguments as
  rectangular areas of text.%@NL@%
%@NL@%
%@CR:MSEgD005@%%@4@%%@AB@%boxarg%@AE@%%@EH@%%@NL@%
  A rectangular area on the screen, defined by the two opposite corners: the
  initial cursor position and the current cursor position. The editor must
  be in box mode, and the two cursor positions must be on separate rows and
  separate columns. A %@AI@%boxarg%@AE@% is generated by invoking the %@AI@%Arg%@AE@% function and
  then moving the cursor to a new location.%@NL@%
%@NL@%
%@CR:MSEgD006@%%@4@%%@AB@%buffer%@AE@%%@EH@%%@NL@%
  An area in memory in which a copy of the file is kept and changed as you
  edit. This buffer is copied to disk when you do a save operation.%@NL@%
%@NL@%
%@CR:MSEgD007@%%@4@%%@AB@%C extension%@AE@%%@EH@%%@NL@%
  A C-language module that defines new editing functions and switches. %@AI@%See%@AE@%
  Chapter 8%@BO:   3fbeb@%.%@NL@%
%@NL@%
%@CR:MSEgD008@%%@4@%%@AB@%Clipboard%@AE@%%@EH@%%@NL@%
  A pseudo file that holds text selected with the %@AI@%Copy%@AE@%, %@AI@%Ldelete%@AE@%, or %@AI@%Sdelete%@AE@%
  functions. You can use the %@AI@%Paste%@AE@% function to insert text from the
  Clipboard into a file.%@NL@%
%@NL@%
%@CR:MSEgD009@%%@4@%%@AB@%configuration%@AE@%%@EH@%%@NL@%
  A description of the specific assignments of functions to keys. For
  example, a BRIEF configuration implies that the Microsoft Editor uses keys
  similar to those that the BRIEF editor uses to invoke similar functions.%@NL@%
%@NL@%
%@CR:MSEgD010@%%@4@%%@AB@%cursor%@AE@%%@EH@%%@NL@%
  The blinking white underline character that defines current position. When
  you type characters into the file, they appear at the cursor position.%@NL@%
%@NL@%
%@CR:MSEgD011@%%@4@%%@AB@%default%@AE@%%@EH@%%@NL@%
  A setting assumed by the editor until you specify otherwise. The Microsoft
  Editor uses two categories of default settings: function assignments and
  switches.%@NL@%
%@NL@%
%@CR:MSEgD012@%%@4@%%@AB@%dialog line%@AE@%%@EH@%%@NL@%
  The line just above the status line. The dialog line reports editor
  messages. You enter text arguments on this line.%@NL@%
%@NL@%
%@CR:MSEgD013@%%@4@%%@AB@%emacs%@AE@%%@EH@%%@NL@%
  A popular mainframe editor from which the functions %@AI@%Emacscdel%@AE@% and
  %@AI@%Emacsnewl%@AE@% were taken.%@NL@%
%@NL@%
%@CR:MSEgD014@%%@4@%%@AB@%file history%@AE@%%@EH@%%@NL@%
  A list of the most recently edited files, including any files currently
  open for editing. The file history is displayed in the <information-file>
  pseudo file.%@NL@%
%@NL@%
%@CR:MSEgD015@%%@4@%%@AB@%function assignment%@AE@%%@EH@%%@NL@%
  A method of assigning an editor function to a specific keystroke so that
  pressing the keystroke invokes the function. Use the %@AI@%Arg%@AE@%%@AI@%textarg Assign%@AE@%
  command to make an assignment for a single editing session, or you can
  enter the assignment in the TOOLS.INI file so that it may be used during
  any editing session. %@AI@%See%@AE@% Chapter 6%@BO:   28e3a@%.%@NL@%
%@NL@%
%@CR:MSEgD016@%%@4@%%@AB@%graphic%@AE@%%@EH@%%@NL@%
  %@AI@%See%@AE@% "literal."%@NL@%
%@NL@%
%@CR:MSEgD017@%%@4@%%@AB@%initial cursor position%@AE@%%@EH@%%@NL@%
  The position the cursor is in when the %@AI@%Arg%@AE@% function is invoked.%@NL@%
%@NL@%
%@CR:MSEgD018@%%@4@%%@AB@%insert mode%@AE@%%@EH@%%@NL@%
  An input mode that inserts rather than replaces characters in the file as
  they are entered.%@NL@%
%@NL@%
%@CR:MSEgD019@%%@4@%%@AB@%linearg%@AE@%%@EH@%%@NL@%
  A range of complete lines, including all the lines from the initial cursor
  position to the current cursor position. The editor must be in box mode.
  You define a %@AI@%linearg%@AE@% by invoking the %@AI@%Arg%@AE@% function (pressing ALT+A), then
  moving the cursor to a different line but same column as the initial
  cursor position.%@NL@%
%@NL@%
%@CR:MSEgD020@%%@4@%%@AB@%literal%@AE@%%@EH@%%@NL@%
  The corresponding ASCII value of a keystroke.  When a keystroke is
  considered literal or graphic, pressing the key causes the editor to place
  the corresponding value in a file.%@NL@%
%@NL@%
%@CR:MSEgD021@%%@4@%%@AB@%macro%@AE@%%@EH@%%@NL@%
  A function made up of arguments and previously defined functions. For
  example, you can create a macro that contains a set of repeatedly
  performed functions and assign the macro to a keystroke. Those functions
  can be carried out much more quickly and simply by invoking the macro. %@AI@%See%@AE@%
  Chapter 6%@BO:   28e3a@%.%@NL@%
%@NL@%
%@CR:MSEgD022@%%@4@%%@AB@%markarg%@AE@%%@EH@%%@NL@%
  A special type of %@AI@%textarg%@AE@% that has been previously defined to be a
  marker──that is, it is associated with a particular position in the file.%@NL@%
%@NL@%
%@CR:MSEgD023@%%@4@%%@AB@%marker%@AE@%%@EH@%%@NL@%
  A name assigned to a cursor position in a file so that this position can
  be referred to within a command by using this name. For example, the %@AI@%Arg%@AE@%
  %@AI@%markarg Copy%@AE@% command selects the text between the cursor position and the
  marker position. A marker is assigned using the %@AI@%Arg Arg textarg Mark%@AE@%
  command.%@NL@%
%@NL@%
%@CR:MSEgD024@%%@4@%%@AB@%Meta%@AE@%%@EH@%%@NL@%
  A function that modifies other functions so they perform differently. The
  effect of %@AI@%Meta%@AE@% varies with each function.%@NL@%
%@NL@%
%@CR:MSEgD025@%%@4@%%@AB@%nested macro%@AE@%%@EH@%%@NL@%
  A macro executed by another macro.%@NL@%
%@NL@%
%@CR:MSEgD026@%%@4@%%@AB@%numarg%@AE@%%@EH@%%@NL@%
  A numerical value you enter on the dialog line, which is passed to a
  function. A %@AI@%numarg%@AE@% is introduced by the %@AI@%Arg%@AE@% function.%@NL@%
%@NL@%
%@CR:MSEgD027@%%@4@%%@AB@%overtype mode%@AE@%%@EH@%%@NL@%
  The input mode that replaces characters at the cursor position instead of
  inserting them. Unlike insert mode, this mode does not preserve existing
  text at the cursor position.%@NL@%
%@NL@%
%@CR:MSEgD028@%%@4@%%@AB@%pseudo file%@AE@%%@EH@%%@NL@%
  A file kept in memory that does not correspond to a disk file. The name of
  a pseudo file is always enclosed in angle brackets (%@AB@%<>%@AE@%). You can create
  your pseudo files for fast saving of temporary information. In addition,
  the editor creates several pseudo files of its own and gives them special
  meaning. %@AI@%See%@AE@% Chapter 4%@BO:   120e2@%.%@NL@%
%@NL@%
%@CR:MSEgD029@%%@4@%%@AB@%recorded macro%@AE@%%@EH@%%@NL@%
  A macro you create with the %@AI@%Record%@AE@% function. The %@AI@%Record%@AE@% function turns
  record mode on and off. All actions you execute while in record mode are
  by default assigned to the RECORDVALUE macro. %@AI@%See%@AE@% Chapter 6%@BO:   28e3a@%.%@NL@%
%@NL@%
%@CR:MSEgD030@%%@4@%%@AB@%regular expression%@AE@%%@EH@%%@NL@%
  A pattern specifying a set of one or more character strings to search for.
  It may be a simple string or a more complex arrangement of characters and
  special symbols that specify a variety of strings to be matched. %@AI@%See%@AE@%
  Chapter 5%@BO:   206bc@%.%@NL@%
%@NL@%
%@CR:MSEgD031@%%@4@%%@AB@%return value%@AE@%%@EH@%%@NL@%
  A value returned by an editing function. The value may be true or false,
  depending on whether the function was successful. This value can be used
  to create complex macros that perform differently depending upon the
  results of individual functions within the macro. %@AI@%See%@AE@% Chapter 6%@BO:   28e3a@%.%@NL@%
%@NL@%
%@CR:MSEgD032@%%@4@%%@AB@%short name%@AE@%%@EH@%%@NL@%
  A file name without a path or file extension. The %@AI@%Setfile%@AE@% and %@AI@%Paste%@AE@%
  functions can take a short name as input and search for a full-length file
  name in the file history that contains the short name.%@NL@%
%@NL@%
%@CR:MSEgD033@%%@4@%%@AB@%status line%@AE@%%@EH@%%@NL@%
  The bottom line of the screen. This line contains useful information about
  the current editing session.%@NL@%
%@NL@%
%@CR:MSEgD034@%%@4@%%@AB@%stream mode%@AE@%%@EH@%%@NL@%
  The editing mode that lets you highlight cursor-movement arguments as
  continuous streams of text, rather than rectangular areas.%@NL@%
%@NL@%
%@CR:MSEgD035@%%@4@%%@AB@%streamarg%@AE@%%@EH@%%@NL@%
  The contiguous stream of characters between two positions──the initial
  cursor position and the new cursor position. The editor must be in stream
  mode. You define a %@AI@%streamarg%@AE@% by invoking %@AI@%Arg%@AE@%, moving the cursor to any new
  location, and then invoking %@AI@%Sinsert%@AE@% or %@AI@%Sdelete%@AE@%.%@NL@%
%@NL@%
%@CR:MSEgD036@%%@4@%%@AB@%switch%@AE@%%@EH@%%@NL@%
  A variable that modifies the way the editor performs. The Microsoft Editor
  uses three kinds of switches: Boolean switches, which turn a certain
  editor feature on or off; numeric switches, which specify numeric
  constants; and text switches, which specify a string of characters. %@AI@%See%@AE@%
  Chapter 7%@BO:   3396c@%.%@NL@%
%@NL@%
%@CR:MSEgD037@%%@4@%%@AB@%tag%@AE@%%@EH@%%@NL@%
  An identifier enclosed in brackets (%@AB@%[]%@AE@%) that marks the beginning of a
  section in the TOOLS.INI file. For example, unless you rename the editor,
  the principal section for editor settings starts at the [M] tag. %@AI@%See%@AE@%
  Chapter 7%@BO:   3396c@%.%@NL@%
%@NL@%
%@CR:MSEgD038@%%@4@%%@AB@%textarg%@AE@%%@EH@%%@NL@%
  A string of text that you enter on the dialog line after invoking the %@AI@%Arg%@AE@%
  function. The text that you enter is passed as input to the next function.%@NL@%
%@NL@%
%@CR:MSEgD039@%%@4@%%@AB@%TOOLS.INI%@AE@%%@EH@%%@NL@%
  A file that contains initialization information for the Microsoft Editor
  and other programs. The file is divided into sections with the use of
  tags. These sections can be loaded automatically when the editor is
  started or by command from within the editor. %@AI@%See%@AE@% Chapter 7%@BO:   3396c@%.%@NL@%
%@NL@%
%@CR:MSEgD040@%%@4@%%@AB@%window%@AE@%%@EH@%%@NL@%
  An area on the screen used to display part of a file. Unless a file is
  extremely small, it is impossible to see all of it on the screen at once.
  Therefore you see a portion of the file through the main editing window at
  any one time. It is possible to see any part of the file by moving or
  scrolling this window. The Microsoft Editor allows you to open multiple
  windows on the screen, using the %@AI@%Window%@AE@% function, for viewing different
  parts of the same file or different files.%@NL@%
%@NL@%
%@NL@%
%@CR:MSEINDEX@%%@1@%%@AB@%Index%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
%|F parameter%@BO:   3ab6d@%%@NL@%
%s parameter%@BO:   3ab6d@%%@NL@%
%@NL@%
%@2@%%@AB@%A%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
 %@NL@%
Abandoning edits%@BO:   128e1@%%@NL@%
AddFile function%@BO:   51608@%%@NL@%
Adding lines%@BO:   16a0d@%%@NL@%
Arg function%@BO:    9154@%%@BO:   60c4c@%%@NL@%
Argcompile function%@BO:   60c4c@%%@NL@%
Arguments%@NL@%
     canceling%@BO:    9512@%%@NL@%
     cmdTable flags%@BO:   435cc@%%@NL@%
     cursor-movement type%@NL@%
          boxarg%@BO:   115ce@%%@BO:   1698d@%%@NL@%
          defined%@BO:    e83e@%%@NL@%
          linearg%@BO:   11355@%%@NL@%
          streamarg%@BO:   11a23@%%@NL@%
     introducing%@BO:    9154@%%@BO:    d6ea@%%@NL@%
     text type%@NL@%
          defined%@BO:    e83e@%%@NL@%
          markarg%@BO:    fa9b@%%@NL@%
          numarg%@BO:    f671@%%@BO:   17134@%%@NL@%
          textarg%@BO:    fec9@%%@NL@%
Arrow keys%@BO:    6026@%%@NL@%
askexit switch%@BO:   7225b@%%@NL@%
askrtn switch%@BO:   7225b@%%@NL@%
Assign command%@BO:   3b6af@%%@NL@%
Assign function%@BO:   2a35a@%%@BO:   2ae71@%%@BO:   33a2a@%%@BO:   60c4c@%%@NL@%
Assign pseudo file%@BO:   1406a@%%@BO:   2b1a0@%%@NL@%
Assignments%@NL@%
     functions%@BO:   2a304@%%@NL@%
     keystrokes%@BO:   29ab0@%%@NL@%
     macros%@BO:   2e15e@%%@NL@%
     switches and functions contrasted%@BO:   34590@%%@NL@%
Automatic command execution at start-up%@BO:   3e9db@%%@NL@%
autosave switch%@BO:   7225b@%%@NL@%
Autostart macro%@BO:   3e9db@%%@NL@%
 %@NL@%
%@2@%%@AB@%B%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
 %@NL@%
backslash (\), regular expressions%@NL@%
     M 1.0 syntax%@BO:   24908@%%@NL@%
backslash, regular expressions%@BO:   21940@%%@NL@%
Backtab function%@BO:   60c4c@%%@NL@%
backup switch%@BO:   7225b@%%@NL@%
BadArg function%@BO:   51d7a@%%@NL@%
Base names, inserting into text%@BO:   17957@%%@NL@%
Begfile function%@BO:   15b0c@%%@BO:   60c4c@%%@NL@%
Beginning of file, moving to%@BO:   15b0c@%%@NL@%
Beginning of line, moving to%@BO:    88cf@%%@BO:   14d77@%%@NL@%
Begline function%@BO:   60c4c@%%@NL@%
Block operations%@NL@%
     moving%@BO:    a0da@%%@NL@%
     copying%@BO:   16fbc@%%@NL@%
     deleting%@BO:    9512@%%@BO:    a018@%%@BO:   16340@%%@NL@%
     inserting%@BO:    8b05@%%@BO:   16340@%%@NL@%
     merging%@BO:   13355@%%@BO:   17ec6@%%@NL@%
     moving%@BO:    9bb3@%%@NL@%
     multiple files%@BO:   1f605@%%@NL@%
     replacing%@BO:   19804@%%@NL@%
     searching%@BO:   19804@%%@NL@%
Blocks of text, large%@BO:   16b40@%%@NL@%
Boolean switches%@BO:   34391@%%@NL@%
Bottom of file, moving to%@BO:   15bca@%%@NL@%
Box mode%@BO:   10bc4@%%@NL@%
BOXARG argument type%@BO:   494fa@%%@NL@%
boxarg, argument type%@BO:   115ce@%%@NL@%
BOXARG, cmdTable flag%@BO:   435cc@%%@NL@%
BOXSTR, cmdTable flag%@BO:   435cc@%%@NL@%
Boxstream function%@BO:   10f81@%%@BO:   60c4c@%%@NL@%
Brackets (\lb\rb), finding%@BO:   5d2a3@%%@NL@%
 %@NL@%
%@2@%%@AB@%C%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
 %@NL@%
C extensions%@NL@%
     compiling and linking%@BO:   4a7bb@%%@NL@%
     defined%@BO:   3fc94@%%@NL@%
     editing functions, low level%@NL@%
          Addfile%@BO:   46852@%%@NL@%
          AddFile%@BO:   51608@%%@NL@%
          BadArg%@BO:   51d7a@%%@NL@%
          CopyBox%@BO:   5238e@%%@NL@%
          CopyLine%@BO:   52d82@%%@NL@%
          CopyStream%@BO:   5376c@%%@NL@%
          DelBox%@BO:   53fde@%%@NL@%
          DelFile%@BO:   546d9@%%@NL@%
          DelLine%@BO:   54cad@%%@NL@%
          DelStream%@BO:   55335@%%@NL@%
          Display%@BO:   55abb@%%@NL@%
          DoMessage%@BO:   55f94@%%@NL@%
          fExecute%@BO:   563e5@%%@NL@%
          FileLength%@BO:   56b4d@%%@NL@%
          FileNameToHandle%@BO:   4655f@%%@BO:   49f36@%%@BO:   57001@%%@NL@%
          FileRead%@BO:   577dc@%%@NL@%
          FileWrite%@BO:   57f2d@%%@NL@%
          GetCursor%@BO:   505ed@%%@BO:   58886@%%@NL@%
          GetLine%@BO:   49e97@%%@BO:   58d95@%%@NL@%
          KbHook%@BO:   595af@%%@NL@%
          KbUnHook%@BO:   598b1@%%@NL@%
          MoveCur%@BO:   59ead@%%@NL@%
          pFileToTop%@BO:   5a4d2@%%@NL@%
          PutLine%@BO:   4a1fe@%%@NL@%
          Putline%@BO:   505ed@%%@NL@%
          PutLine%@BO:   5a976@%%@NL@%
          ReadChar%@BO:   5b0be@%%@NL@%
          ReadCmd%@BO:   5ba9c@%%@NL@%
          RemoveFile%@BO:   5be9e@%%@NL@%
          Replace%@BO:   5c466@%%@NL@%
          SetKey%@BO:   5cc35@%%@NL@%
     editing%@BO:   44a45@%%@NL@%
     functions, declaring%@BO:   41b89@%%@BO:   42a57@%%@NL@%
     guidelines for creating%@BO:   415be@%%@NL@%
     loading%@BO:   40dcc@%%@BO:   4b8c3@%%@NL@%
     programming%@BO:   3fc94@%%@NL@%
     sample program%@BO:   4d33a@%%@NL@%
     steps for development%@BO:   409a9@%%@BO:   40dcc@%%@NL@%
     switches, declaring%@BO:   41b89@%%@BO:   41eff@%%@NL@%
     types, function%@BO:   4319b@%%@NL@%
C library functions%@BO:   4fad5@%%@NL@%
Cancel function%@BO:    94b9@%%@BO:   60c4c@%%@NL@%
Cancelling arguments%@BO:    9512@%%@NL@%
carat (^), regular expressions%@NL@%
     M 1.0 syntax%@BO:   24908@%%@NL@%
     UNIX syntax%@BO:   21940@%%@NL@%
Carriage return%@NL@%
     Emacsnewl function%@BO:   5d2a3@%%@NL@%
     Newline function%@BO:   5f038@%%@NL@%
case switch%@BO:   7225b@%%@NL@%
Cdelete function%@BO:   60c4c@%%@NL@%
Clipboard pseudo file%@BO:   1406a@%%@NL@%
Closing a window%@BO:   1f027@%%@NL@%
cmdTable flags%@NL@%
     (table)%@BO:   435cc@%%@NL@%
     arguments%@BO:   435cc@%%@NL@%
cmdTable, described%@BO:   42aa3@%%@NL@%
Color switches%@NL@%
     errcolor%@BO:   368ed@%%@NL@%
     fgcolor%@BO:   35acc@%%@BO:   35d72@%%@NL@%
     hgcolor%@BO:   368ed@%%@NL@%
     infcolor%@BO:   368ed@%%@NL@%
     selcolor%@BO:   368ed@%%@NL@%
     stacolor%@BO:   368ed@%%@NL@%
     wdcolor%@BO:   368ed@%%@NL@%
Colors. %@AI@%See%@AE@% Setting screen colors%@NL@%
Command line%@BO:    bc2e@%%@NL@%
Commands, Assign%@BO:   3b6af@%%@NL@%
Comments%@BO:   3dbb2@%%@NL@%
Compile function%@BO:   1bf47@%%@BO:   60c4c@%%@NL@%
Compile pseudo file%@BO:   1406a@%%@NL@%
Compilers supported%@BO:   1d97e@%%@NL@%
Compiling%@NL@%
     compilers, invoking%@BO:   1c335@%%@NL@%
     editor, with%@BO:   1bf47@%%@NL@%
     error output%@BO:   1d528@%%@NL@%
     extensions%@BO:   4ab20@%%@NL@%
     utilities, invoking%@BO:   1c564@%%@NL@%
Conditional macros%@BO:   320fc@%%@NL@%
Configuring the editor%@NL@%
     switches, with%@BO:   33a2a@%%@NL@%
     TOOLS.INI file, with%@BO:   3b535@%%@NL@%
Context-sensitive Help%@BO:    b59d@%%@NL@%
Copy function%@BO:   16fbc@%%@BO:   60c4c@%%@NL@%
CopyBox function%@BO:   5238e@%%@NL@%
Copying%@BO:   16f75@%%@NL@%
CopyLine function%@BO:   52d82@%%@NL@%
CopyStream function%@BO:   5376c@%%@NL@%
Curdate function%@BO:   17957@%%@BO:   60c4c@%%@NL@%
Curday function%@BO:   17957@%%@BO:   60c4c@%%@NL@%
Curfile function%@BO:   17957@%%@BO:   60c4c@%%@NL@%
Curfileext function%@BO:   17957@%%@BO:   60c4c@%%@NL@%
Curfilenam function%@BO:   17957@%%@BO:   60c4c@%%@NL@%
Cursor-movement type arguments%@NL@%
     boxarg%@BO:   115ce@%%@BO:   1698d@%%@NL@%
     defined%@BO:    e83e@%%@NL@%
     linearg%@BO:   11355@%%@NL@%
     streamarg%@BO:   11a23@%%@NL@%
Cursor%@NL@%
     displaying position of%@BO:   353da@%%@NL@%
     initial position%@BO:   10988@%%@NL@%
     movement%@NL@%
          backtab%@BO:   5d2a3@%%@BO:   60c4c@%%@NL@%
          down%@BO:   5d2a3@%%@BO:   60c4c@%%@NL@%
          left%@BO:   5d2a3@%%@BO:   60c4c@%%@NL@%
          macros, in%@BO:   2f78b@%%@NL@%
          right%@BO:   5d2a3@%%@BO:   60c4c@%%@NL@%
          tab%@BO:   5d2a3@%%@BO:   5f038@%%@NL@%
          up%@BO:   5d2a3@%%@BO:   60c4c@%%@NL@%
CURSORFUNC, cmdTable flag%@BO:   435cc@%%@NL@%
Curtime function%@BO:   17957@%%@BO:   60c4c@%%@NL@%
Customizing editor%@NL@%
     assignments%@BO:   29476@%%@NL@%
     %@AI@%See also%@AE@% C extensions%@NL@%
     described%@BO:   292f2@%%@NL@%
     macros%@BO:   2ccc4@%%@NL@%
     TOOLS.INI, using%@BO:   2b024@%%@NL@%
%@NL@%
%@2@%%@AB@%D%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
Date, inserting into text%@BO:   17957@%%@BO:   60c4c@%%@NL@%
Day, inserting into text%@BO:   17957@%%@BO:   60c4c@%%@NL@%
Default, TOOLS.INI, using to set%@BO:   3b535@%%@NL@%
DelBox function%@BO:   53fde@%%@NL@%
Delete function%@BO:    8e12@%%@BO:    9da7@%%@BO:   16414@%%@BO:   60c4c@%%@NL@%
Deleting%@NL@%
     canceling deletion%@BO:    9512@%%@NL@%
     lines%@BO:    9da7@%%@NL@%
     text%@BO:   162ea@%%@NL@%
     words%@BO:    8e12@%%@NL@%
DelFile function%@BO:   546d9@%%@NL@%
DelLine function%@BO:   54cad@%%@NL@%
DelStream function%@BO:   55335@%%@NL@%
Direction keys%@BO:    6026@%%@BO:   14957@%%@NL@%
Disabling keystrokes%@BO:   2bbd2@%%@NL@%
Discarding edits%@BO:   128e1@%%@NL@%
Display function%@BO:   55abb@%%@NL@%
displaycursor switch%@BO:   7225b@%%@NL@%
Displaying the cursor%@BO:   353da@%%@NL@%
Document conventions%@BO:    5f30@%%@NL@%
dollar sign ($), regular expressions%@NL@%
     M 1.0 syntax%@BO:   24908@%%@NL@%
     UNIX syntax%@BO:   21940@%%@NL@%
DoMessage function%@BO:   55f94@%%@NL@%
DOS environment variable. %@AI@%See%@AE@% Environment variable%@NL@%
DOS shell. %@AI@%See%@AE@% Shell function%@NL@%
DOS wildcards%@BO:    c693@%%@BO:   135c3@%%@NL@%
DOS-specific initialization%@BO:   3ce83@%%@NL@%
Down function%@BO:   15095@%%@BO:   60c4c@%%@NL@%
Drawing window borders, color%@BO:   368ed@%%@NL@%
Dynamic compile log%@BO:   1e543@%%@NL@%
%@NL@%
%@2@%%@AB@%E%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
Editing%@NL@%
     copying%@BO:   16fbc@%%@NL@%
     deleting%@NL@%
          cancelling deletion%@BO:    9512@%%@NL@%
          lines%@BO:    9da7@%%@NL@%
          text%@BO:   162ea@%%@NL@%
          words%@BO:    8e12@%%@NL@%
     exiting andsaving%@BO:    af34@%%@NL@%
     inserting%@BO:    8b05@%%@BO:   162ea@%%@BO:   16340@%%@NL@%
     merging%@BO:   13355@%%@NL@%
     moving%@NL@%
          text%@BO:    9bb3@%%@BO:    a0da@%%@BO:   16f75@%%@NL@%
          through files%@BO:   14909@%%@BO:   15d4c@%%@NL@%
     multiple files%@BO:   1f605@%%@NL@%
     overtype mode%@BO:    85e5@%%@NL@%
     pasting%@BO:    a0da@%%@BO:   17ec6@%%@NL@%
     replacing%@BO:    85e5@%%@BO:   197b4@%%@BO:   19804@%%@BO:   1b205@%%@NL@%
     scrolling%@NL@%
          control%@BO:   1527e@%%@NL@%
          edge of screen%@BO:   1503c@%%@NL@%
          page%@BO:   155e1@%%@NL@%
          switches%@BO:   356ce@%%@NL@%
          %@AI@%See also%@AE@% Switches
     search and replace%@BO:   197b4@%%@NL@%
     searching%@BO:    a3e8@%%@BO:   19804@%%@BO:   1a2e0@%%@BO:   26c13@%%@NL@%
     starting editor%@BO:    7746@%%@NL@%
     text arguments%@BO:    f20b@%%@NL@%
     windows%@BO:   1ec4c@%%@NL@%
editreadonly switch%@BO:   7225b@%%@NL@%
Edits, discarding%@BO:   128e1@%%@NL@%
Emacsdel function%@BO:   60c4c@%%@NL@%
Emacsnewl function%@BO:   60c4c@%%@NL@%
End of file, moving to%@BO:   15bca@%%@NL@%
End of line, moving to%@BO:   14957@%%@NL@%
Endfile function%@BO:   15bca@%%@BO:   60c4c@%%@NL@%
Endline function%@BO:   60c4c@%%@NL@%
entab switch%@BO:   38b68@%%@BO:   7225b@%%@NL@%
enterinsmode switch%@BO:   7225b@%%@NL@%
Environment function%@BO:   60c4c@%%@NL@%
Environment variable%@NL@%
     loading a file, used for%@BO:   138ea@%%@NL@%
     merging a file, used for%@BO:   13ab0@%%@NL@%
     switch settings, in%@BO:   3b101@%%@NL@%
     switches,used with%@BO:   3b262@%%@NL@%
errcolor switch%@BO:   35c03@%%@BO:   368ed@%%@BO:   7225b@%%@NL@%
Error messages%@BO:   76d41@%%@NL@%
Error output%@BO:   1d4d9@%%@NL@%
errprompt switch%@BO:   7225b@%%@NL@%
Execute function%@BO:   17c17@%%@BO:   2ffe3@%%@BO:   60c4c@%%@NL@%
Execution of commands at start-up%@BO:   3e9db@%%@NL@%
Exit function%@BO:   60c4c@%%@NL@%
Exiting and saving%@BO:    af34@%%@NL@%
Exiting without saving%@BO:   128e1@%%@NL@%
Exiting%@NL@%
     completely%@BO:   60c4c@%%@NL@%
     Help%@BO:    b9ae@%%@NL@%
     moving to next file, and%@BO:   128e1@%%@NL@%
EXP.EXE file%@BO:   76ad7@%%@NL@%
Expressions%@NL@%
     predefined regular%@BO:   2885d@%%@NL@%
     regular%@BO:   20760@%%@NL@%
     tagged%@BO:   231bc@%%@BO:   23b94@%%@BO:   27441@%%@BO:   27df8@%%@NL@%
EXT.H file%@BO:   4055d@%%@BO:   4162e@%%@NL@%
Extensions, file%@BO:   3d62e@%%@NL@%
Extensions. %@AI@%See%@AE@% C extensions%@NL@%
EXTHDR.OBJ file%@BO:   4055d@%%@BO:   40dcc@%%@NL@%
EXTHDRP.OBJ file%@BO:   4055d@%%@BO:   40dcc@%%@NL@%
extmake switch%@BO:   7225b@%%@NL@%
%@NL@%
%@2@%%@AB@%F%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
fExecute function%@BO:   563e5@%%@NL@%
fgcolor switch%@BO:   35acc@%%@BO:   7225b@%%@NL@%
File extensions%@NL@%
     inserting into text%@BO:   17957@%%@NL@%
     syntax%@BO:   3d62e@%%@NL@%
File history. %@AI@%See%@AE@% Information-file pseudo-file%@NL@%
File markers%@NL@%
     commands%@BO:   1839c@%%@NL@%
     defined%@BO:   1839c@%%@NL@%
     functions used with%@BO:   18cab@%%@NL@%
File name, inserting into text%@BO:   17957@%%@NL@%
File operations%@BO:   127d4@%%@NL@%
File position, displaying%@BO:   353da@%%@NL@%
File-list pseudo file%@BO:   1406a@%%@NL@%
FileLength function%@BO:   56b4d@%%@NL@%
FileNameToHandle function%@BO:   4655f@%%@BO:   57001@%%@NL@%
FileRead function%@BO:   577dc@%%@NL@%
Files%@NL@%
     EXTHDR.OBJ%@BO:   4055d@%%@NL@%
     EXP.EXE%@BO:   76ad7@%%@NL@%
     EXT.H%@BO:   4055d@%%@NL@%
     EXTHDR.OBJ%@BO:   40dcc@%%@NL@%
     EXTHDRP.OBJ%@BO:   4055d@%%@BO:   40dcc@%%@NL@%
     loading%@BO:    c38d@%%@NL@%
     M.EXE%@BO:    7792@%%@BO:    bc2e@%%@BO:   40a36@%%@NL@%
     M.TMP%@BO:   1f901@%%@NL@%
     MEP.EXE%@BO:    bc2e@%%@NL@%
     multiple%@BO:   1f30c@%%@NL@%
     SKEL.C%@BO:   4055d@%%@NL@%
     TOOLS.INI%@NL@%
          comments%@BO:   3dbb2@%%@NL@%
          defined%@BO:   33be7@%%@NL@%
          line continuation%@BO:   3dea7@%%@NL@%
          sample%@BO:   3b535@%%@NL@%
          structure%@BO:   3c086@%%@NL@%
     UNDEL.EXE%@BO:   76895@%%@NL@%
filetab switch%@BO:   38b68@%%@BO:   7225b@%%@NL@%
FileWrite function%@BO:   57f2d@%%@NL@%
Function assignments%@NL@%
     graphic%@BO:   2c0ab@%%@NL@%
     keys, numeric-keypad%@BO:    6026@%%@BO:   2a5d3@%%@NL@%
     making%@BO:   2a304@%%@NL@%
     removing%@BO:   2bbd2@%%@NL@%
     viewing%@BO:   2b13c@%%@NL@%
Functions, C library%@BO:   4fad5@%%@NL@%
Functions%@NL@%
     AddFile%@BO:   51608@%%@NL@%
     Arg%@BO:    9154@%%@BO:   60c4c@%%@NL@%
     Argcompile%@BO:   60c4c@%%@NL@%
     Assign%@BO:   2a35a@%%@BO:   2ae71@%%@BO:   33a2a@%%@BO:   60c4c@%%@NL@%
     assignment of%@BO:   2a304@%%@NL@%
     Backtab%@BO:   60c4c@%%@NL@%
     BadArg%@BO:   51d7a@%%@NL@%
     Begfile%@BO:   15b0c@%%@BO:   60c4c@%%@NL@%
     Begline%@BO:   60c4c@%%@NL@%
     Boxstream%@BO:   10f81@%%@BO:   60c4c@%%@NL@%
     Cancel%@BO:    94b9@%%@BO:   60c4c@%%@NL@%
     Cdelete%@BO:   60c4c@%%@NL@%
     Compile%@BO:   1c290@%%@BO:   60c4c@%%@NL@%
     Copy%@BO:   16f75@%%@NL@%
     copy%@BO:   16fbc@%%@NL@%
     Copy%@BO:   60c4c@%%@NL@%
     CopyBox%@BO:   5238e@%%@NL@%
     CopyLine%@BO:   52d82@%%@NL@%
     CopyStream%@BO:   5376c@%%@NL@%
     Curdate%@BO:   17957@%%@BO:   60c4c@%%@NL@%
     Curday%@BO:   17957@%%@BO:   60c4c@%%@NL@%
     Curfile%@BO:   17957@%%@BO:   60c4c@%%@NL@%
     Curfileext%@BO:   17957@%%@BO:   60c4c@%%@NL@%
     Curfilenam%@BO:   17957@%%@BO:   60c4c@%%@NL@%
     Curtime%@BO:   17957@%%@BO:   60c4c@%%@NL@%
     declaring%@BO:   44a45@%%@NL@%
     defined%@BO:    70bc@%%@NL@%
     DelBox%@BO:   53fde@%%@NL@%
     Delete%@BO:    8e12@%%@BO:    9da7@%%@BO:   16414@%%@BO:   60c4c@%%@NL@%
     DelFile%@BO:   546d9@%%@NL@%
     DelLine%@BO:   54cad@%%@NL@%
     DelStream%@BO:   55335@%%@NL@%
     Display%@BO:   55abb@%%@NL@%
     DoMessage%@BO:   55f94@%%@NL@%
     Down%@BO:   15095@%%@BO:   60c4c@%%@NL@%
     Emacscdel%@BO:   60c4c@%%@NL@%
     Emacsnewl%@BO:   60c4c@%%@NL@%
     Endfile%@BO:   15bca@%%@BO:   60c4c@%%@NL@%
     Endline%@BO:   60c4c@%%@NL@%
     Environment%@BO:   60c4c@%%@NL@%
     Execute%@BO:   60c4c@%%@NL@%
     Exit%@BO:   60c4c@%%@NL@%
     fExecute%@BO:   563e5@%%@NL@%
     FileLength%@BO:   56b4d@%%@NL@%
     FileNameToHandle%@BO:   4655f@%%@BO:   57001@%%@NL@%
     FileRead%@BO:   577dc@%%@NL@%
     FileWrite%@BO:   57f2d@%%@NL@%
     GetCursor%@BO:   58886@%%@NL@%
     GetLine%@BO:   49e97@%%@BO:   58d95@%%@NL@%
     Graphic%@BO:   2c71f@%%@NL@%
     Home%@BO:   60c4c@%%@NL@%
     Information%@BO:   1f605@%%@BO:   60c4c@%%@NL@%
     Initialize%@BO:   3e7ee@%%@BO:   60c4c@%%@NL@%
     Insert%@BO:   60c4c@%%@NL@%
     Insertmode%@BO:    8b05@%%@BO:   60c4c@%%@NL@%
     KbHook%@BO:   595af@%%@NL@%
     KbUnHook%@BO:   598b1@%%@NL@%
     Lastselect%@BO:   110d1@%%@BO:   60c4c@%%@NL@%
     Lasttext%@BO:    f570@%%@BO:   60c4c@%%@NL@%
     Ldelete%@BO:   16a0d@%%@BO:   2f8ae@%%@BO:   60c4c@%%@NL@%
     Left%@BO:   15095@%%@BO:   60c4c@%%@NL@%
     Linsert%@BO:   16a0d@%%@BO:   60c4c@%%@NL@%
     Mark%@BO:   15d4c@%%@BO:   185f6@%%@BO:   60c4c@%%@NL@%
     Message%@BO:   60c4c@%%@NL@%
     Meta%@BO:   60c4c@%%@NL@%
     Mgrep%@BO:   60c4c@%%@NL@%
     Mgreplist%@BO:   1ab64@%%@NL@%
     Mlines%@BO:   60c4c@%%@NL@%
     MoveCur%@BO:   59ead@%%@NL@%
     Mpage%@BO:   154eb@%%@BO:   60c4c@%%@NL@%
     Mpara%@BO:   60c4c@%%@NL@%
     Mreplace%@BO:   60c4c@%%@NL@%
     Msearch%@BO:   19d88@%%@BO:   60c4c@%%@NL@%
     Mword%@BO:   15d4c@%%@BO:   60c4c@%%@NL@%
     Newline%@BO:   60c4c@%%@NL@%
     Nextmsg%@BO:   60c4c@%%@NL@%
     Noedit%@BO:   60c4c@%%@NL@%
     Paste%@BO:    a0da@%%@BO:   174fa@%%@BO:   60c4c@%%@NL@%
     Pbal%@BO:   60c4c@%%@NL@%
     pFileToTop%@BO:   5a4d2@%%@NL@%
     Plines%@BO:   60c4c@%%@NL@%
     Ppage%@BO:   154eb@%%@BO:   60c4c@%%@NL@%
     Ppara%@BO:   60c4c@%%@NL@%
     Print%@BO:   1fcd8@%%@BO:   60c4c@%%@NL@%
     Psearch%@BO:   19804@%%@BO:   60c4c@%%@NL@%
     PutLine%@BO:   4a1fe@%%@BO:   5a976@%%@NL@%
     Pword%@BO:   15d4c@%%@BO:   60c4c@%%@NL@%
     Qreplace%@BO:   1ba49@%%@BO:   60c4c@%%@NL@%
     Quote%@BO:   2c5a6@%%@BO:   60c4c@%%@NL@%
     ReadChar%@BO:   5b0be@%%@NL@%
     ReadCmd%@BO:   5ba9c@%%@NL@%
     Record%@BO:   2d29c@%%@BO:   60c4c@%%@NL@%
     Refresh%@BO:   128e1@%%@BO:   60c4c@%%@NL@%
     RemoveFile%@BO:   5be9e@%%@NL@%
     Repeat%@BO:   60c4c@%%@NL@%
     Replace%@NL@%
          editing function%@BO:   1b205@%%@BO:   60c4c@%%@NL@%
          extension function%@BO:   5c466@%%@NL@%
     Restcur%@BO:   19402@%%@BO:   2f9b5@%%@BO:   60c4c@%%@NL@%
     Right%@BO:   15095@%%@BO:   60c4c@%%@NL@%
     Saveall%@BO:   60c4c@%%@NL@%
     Savecur%@BO:   19402@%%@BO:   2ade8@%%@BO:   2f9b5@%%@BO:   60c4c@%%@NL@%
     Sdelete%@BO:   2f5d4@%%@BO:   60c4c@%%@NL@%
     Searchall%@BO:   1a791@%%@BO:   60c4c@%%@NL@%
     Setfile%@BO:   1356e@%%@BO:   1f360@%%@BO:   60c4c@%%@NL@%
     SetKey%@BO:   5cc35@%%@NL@%
     Setwindow%@BO:   60c4c@%%@NL@%
     Shell%@BO:   60c4c@%%@NL@%
     Sinsert%@BO:   60c4c@%%@NL@%
     Tab%@BO:   5f038@%%@BO:   60c4c@%%@NL@%
     Tell%@BO:   2b9eb@%%@BO:   2d034@%%@BO:   60c4c@%%@NL@%
     Unassigned%@BO:   2bc22@%%@NL@%
     Undo%@BO:    964e@%%@BO:   60c4c@%%@NL@%
     Up%@BO:   15095@%%@BO:   60c4c@%%@NL@%
     Whenloaded%@BO:   40dcc@%%@BO:   41dbb@%%@BO:   44776@%%@NL@%
     Window%@BO:   1eea0@%%@BO:   60c4c@%%@NL@%
%@NL@%
%@2@%%@AB@%G%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
GetCursor function%@BO:   58886@%%@NL@%
GetLine function%@BO:   49e97@%%@BO:   58d95@%%@NL@%
Graphic function%@BO:   2c71f@%%@NL@%
%@NL@%
%@2@%%@AB@%H%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
Height of screen%@BO:   3a3f0@%%@NL@%
height switch%@BO:   3a3f0@%%@BO:   7225b@%%@NL@%
Help function%@BO:    b16a@%%@NL@%
Help, configuring%@BO:   3eb8b@%%@NL@%
helpboldcolor switch%@BO:   7225b@%%@NL@%
helpfiles switch%@BO:   7225b@%%@NL@%
helpitalcolor switch%@BO:   7225b@%%@NL@%
helpundcolor switch%@BO:   7225b@%%@NL@%
helpwarncolor switch%@BO:   7225b@%%@NL@%
helpwindow switch%@BO:   7225b@%%@NL@%
helpwindow switches%@BO:   3756d@%%@NL@%
hgcolor switch%@BO:   35c03@%%@BO:   368ed@%%@BO:   7225b@%%@NL@%
Highlighting%@BO:   10251@%%@BO:   10988@%%@NL@%
hike switch%@BO:   7225b@%%@NL@%
Home function%@BO:   60c4c@%%@NL@%
horizontal scrolling%@BO:   3596c@%%@NL@%
hscroll switch%@BO:   3596c@%%@BO:   7225b@%%@NL@%
%@NL@%
%@2@%%@AB@%I%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
infcolor switch%@BO:   35c03@%%@BO:   368ed@%%@BO:   7225b@%%@NL@%
Information function%@BO:   1f605@%%@BO:   60c4c@%%@NL@%
Information-file pseudo file%@BO:   1406a@%%@NL@%
Initial cursor position%@BO:   10988@%%@NL@%
Initialization file. %@AI@%See%@AE@% TOOLS.INI file%@NL@%
Initialize function%@BO:   3e7ee@%%@BO:   60c4c@%%@NL@%
Initializing editor%@BO:   3b535@%%@NL@%
Insert function%@BO:   60c4c@%%@NL@%
Insert mode%@BO:    85e5@%%@NL@%
Inserting%@NL@%
     another file%@BO:   128e1@%%@BO:   1f30c@%%@NL@%
     lines%@BO:    e090@%%@BO:   16a0d@%%@NL@%
     program output%@BO:   17f5c@%%@NL@%
     spaces%@BO:    e090@%%@NL@%
     text%@BO:    8b05@%%@BO:   162ea@%%@NL@%
Insertmode, setting on start-up%@BO:   7225b@%%@NL@%
Insertmode%@NL@%
     function%@BO:    8b05@%%@BO:   60c4c@%%@NL@%
     macro%@BO:   329d5@%%@NL@%
Installing editor%@BO:    7792@%%@NL@%
%@NL@%
%@2@%%@AB@%K%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
KbHook function%@BO:   595af@%%@NL@%
KbUnHook function%@BO:   598b1@%%@NL@%
KEEPMETA, cmdTable flag%@BO:   435cc@%%@NL@%
keyboard switch%@BO:   7225b@%%@NL@%
Keys, numeric-keypad%@BO:    6026@%%@BO:   2a5d3@%%@NL@%
Keystrokes%@NL@%
     default%@BO:   5f038@%%@NL@%
     disabling%@BO:   2bbd2@%%@NL@%
     function assignments%@BO:   29ab0@%%@NL@%
     macros%@BO:   2e15e@%%@NL@%
     making literal%@BO:   2c0ab@%%@NL@%
     recognized by editor%@BO:   2c100@%%@NL@%
%@NL@%
%@2@%%@AB@%L%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
Languages, customizing files for%@BO:   3d7b3@%%@NL@%
Large blocks of text, marking%@BO:   16b40@%%@NL@%
Lastselect function%@BO:   110d1@%%@BO:   60c4c@%%@NL@%
Lasttext function%@BO:    f570@%%@BO:   60c4c@%%@NL@%
Ldelete function%@BO:   16a0d@%%@BO:   2f8ae@%%@BO:   60c4c@%%@NL@%
Leaving Help%@BO:    b9ae@%%@NL@%
Left function%@BO:   15095@%%@BO:   60c4c@%%@NL@%
Library functions, C%@BO:   4fad5@%%@NL@%
Line continuation%@BO:   3dea7@%%@NL@%
Line number, moving to%@BO:   1884d@%%@NL@%
linearg, argument type%@BO:   11355@%%@NL@%
LINEARG, argument type%@BO:   4858c@%%@NL@%
LINEARG, cmdTable flag%@BO:   435cc@%%@NL@%
Linking extensions%@BO:   4ab20@%%@NL@%
Linsert function%@BO:   16a0d@%%@BO:   60c4c@%%@NL@%
List of assignments%@BO:   1406a@%%@NL@%
Literal keystrokes%@NL@%
     defined%@BO:   2c1d8@%%@NL@%
     defining keys as%@BO:   2c0ab@%%@NL@%
load switch%@BO:   40dcc@%%@BO:   7225b@%%@NL@%
Loading%@NL@%
     extensions%@BO:   40dcc@%%@BO:   4b8c3@%%@NL@%
     files%@BO:    c38d@%%@BO:   13355@%%@NL@%
%@NL@%
%@2@%%@AB@%M%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
M 1.0 syntax, regular expression%@BO:   24293@%%@NL@%
M 1.0 syntax%@NL@%
     regular expressions%@BO:   20eeb@%%@NL@%
M.EXE file%@BO:    7792@%%@BO:    bc2e@%%@BO:   40a36@%%@NL@%
M.TMP file%@BO:   1f901@%%@NL@%
Macros%@NL@%
     autostart%@BO:   3e9db@%%@NL@%
     conditional operations%@BO:   320fc@%%@NL@%
     defining%@BO:   2ccc4@%%@NL@%
     entering%@BO:   2def3@%%@NL@%
     handling prompts%@BO:   30928@%%@NL@%
     insertmode%@BO:   329d5@%%@NL@%
     lists%@BO:   2eac6@%%@NL@%
     mgreplist%@BO:   1ad57@%%@NL@%
     record and playback%@BO:   2d29c@%%@NL@%
     RECORDVALUE%@BO:   2d4c0@%%@NL@%
     references to other macros%@BO:   30352@%%@NL@%
Mark function%@BO:   15d4c@%%@BO:   185f6@%%@BO:   60c4c@%%@NL@%
markarg, argument type%@BO:    fa9b@%%@NL@%
MARKARG, cmdTable flag%@BO:   435cc@%%@NL@%
markfile switch%@BO:   192a8@%%@BO:   7225b@%%@NL@%
Marking large amounts of text%@BO:   16b40@%%@NL@%
Matching%@NL@%
     maximal%@BO:   26d87@%%@NL@%
     method%@BO:   26bc3@%%@NL@%
     minimal%@BO:   26d87@%%@NL@%
MEP.EXE file%@BO:    7792@%%@NL@%
Merging%@BO:   13355@%%@BO:   17ec6@%%@NL@%
Message function%@BO:   60c4c@%%@NL@%
Messages%@BO:   76d41@%%@NL@%
Meta function%@BO:   60c4c@%%@NL@%
Mgrep function%@BO:   60c4c@%%@NL@%
Mgreplist%@NL@%
     function%@BO:   1ab64@%%@NL@%
     macro%@BO:   1ad57@%%@NL@%
Mlines function%@BO:   60c4c@%%@NL@%
Mode%@NL@%
     box%@BO:   10bc4@%%@NL@%
     stream%@BO:   10bc4@%%@NL@%
MODIFIES, cmdTable flag%@BO:   435cc@%%@NL@%
MoveCur function%@BO:   59ead@%%@NL@%
Moving cursor. %@AI@%See%@AE@% Cursor movement%@NL@%
Moving%@NL@%
     backward one paragraph%@BO:   15d4c@%%@NL@%
     backward one word%@BO:   15d4c@%%@NL@%
     beginning of line, to%@BO:    88cf@%%@BO:   14d77@%%@NL@%
     between windows%@BO:   1eea0@%%@NL@%
     end of file, to%@BO:   15bca@%%@NL@%
     end of line, to%@BO:   14957@%%@NL@%
     file markers, using%@BO:   1839c@%%@NL@%
     files, through%@BO:   14909@%%@BO:   15d4c@%%@NL@%
     forward one paragraph%@BO:   15d4c@%%@NL@%
     Help, through%@BO:    b81a@%%@NL@%
     line numbers, to%@BO:   1884d@%%@NL@%
     text%@BO:    9bb3@%%@NL@%
     top of file, to%@BO:   15b0c@%%@NL@%
     window down%@BO:   60c4c@%%@NL@%
     window up%@BO:   60c4c@%%@NL@%
Mpage function%@BO:   154eb@%%@BO:   60c4c@%%@NL@%
Mpara function%@BO:   15d4c@%%@BO:   60c4c@%%@NL@%
Mreplace function%@BO:   60c4c@%%@NL@%
Msearch function%@BO:   19d88@%%@BO:   60c4c@%%@NL@%
Multiple files%@BO:   1f30c@%%@NL@%
Mword function%@BO:   15d4c@%%@BO:   60c4c@%%@NL@%
%@NL@%
%@2@%%@AB@%N%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
Newline function%@BO:   60c4c@%%@NL@%
     %@AI@%See Also%@AE@% Emacsnewl function%@NL@%
Nextmsg function%@BO:   1dc62@%%@BO:   60c4c@%%@NL@%
NOARG, cmdTable flag%@BO:   435cc@%%@NL@%
Noedit function%@BO:   60c4c@%%@NL@%
noise switch%@BO:   7225b@%%@NL@%
NULLARG, cmdTable flag%@BO:   435cc@%%@NL@%
NULLEOL, cmdTable flag%@BO:   435cc@%%@NL@%
NULLEOW, cmdTable flag%@BO:   435cc@%%@NL@%
numarg, argument type%@BO:    f671@%%@BO:   17134@%%@NL@%
NUMARG, cmdTable flag%@BO:   435cc@%%@NL@%
Numeric switches%@BO:   3421c@%%@NL@%
Numeric-keypad keys%@BO:    6026@%%@BO:   2a5d3@%%@NL@%
%@NL@%
%@2@%%@AB@%O%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
Options, command line%@BO:    bc2e@%%@NL@%
OS/2-specific initialization%@BO:   3ce83@%%@NL@%
OS/2. %@AI@%See%@AE@% Protected mode%@NL@%
Overtype mode%@BO:    85e5@%%@NL@%
%@NL@%
%@2@%%@AB@%P%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
Page%@NL@%
     moving down by%@BO:   154eb@%%@NL@%
     moving up by%@BO:   154eb@%%@NL@%
Paragraph%@NL@%
     moving backward by%@BO:   15d4c@%%@NL@%
     moving forward by%@BO:   15d4c@%%@NL@%
Paste function%@BO:    a0da@%%@BO:   17ec6@%%@BO:   60c4c@%%@NL@%
Pbal function%@BO:   60c4c@%%@NL@%
pFileToTop function%@BO:   5a4d2@%%@NL@%
Plines function%@BO:   60c4c@%%@NL@%
Position of cursor, displaying%@BO:   353da@%%@NL@%
Ppage function%@BO:   154eb@%%@BO:   60c4c@%%@NL@%
Ppara function%@BO:   15d4c@%%@BO:   60c4c@%%@NL@%
Predefined regular expressions%@BO:   2885d@%%@NL@%
Print function%@BO:   1fcd8@%%@BO:   60c4c@%%@NL@%
printcmd switch%@BO:   7225b@%%@NL@%
Programming languages. %@AI@%See%@AE@% Languages, customizing files for%@NL@%
Prompts, handling within macros%@BO:   30928@%%@NL@%
Protected mode%@NL@%
     creating extensions for%@BO:   4b1b6@%%@NL@%
     dynamic compile log%@BO:   1e917@%%@NL@%
Psearch function%@BO:   19804@%%@BO:   60c4c@%%@NL@%
Pseudo files%@BO:   13c6b@%%@NL@%
PutLine function%@BO:   4a1fe@%%@BO:   5a976@%%@NL@%
Pword function%@BO:   15d4c@%%@BO:   60c4c@%%@NL@%
%@NL@%
%@2@%%@AB@%Q%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
Qreplace function%@BO:   1b205@%%@BO:   60c4c@%%@NL@%
question mark (?), regular expressions%@NL@%
     M 1.0 syntax%@BO:   24908@%%@NL@%
Quitting. %@AI@%See%@AE@% Exiting%@NL@%
Quote function%@BO:   2c5a6@%%@BO:   60c4c@%%@NL@%
%@NL@%
%@2@%%@AB@%R%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
ReadChar function%@BO:   5b0be@%%@NL@%
ReadCmd function%@BO:   5ba9c@%%@NL@%
Reading from files%@BO:   17e67@%%@NL@%
readonly switch%@BO:   7225b@%%@NL@%
realtabs switch%@BO:   38064@%%@BO:   38b68@%%@BO:   7225b@%%@NL@%
Record function%@BO:   2d29c@%%@BO:   60c4c@%%@NL@%
Record pseudo file%@BO:   1406a@%%@NL@%
Recording a macro%@BO:   2d29c@%%@NL@%
RECORDVALUE macro%@BO:   2d4c0@%%@NL@%
Redoing a command%@BO:    9a45@%%@NL@%
Refresh function%@BO:   128e1@%%@BO:   60c4c@%%@NL@%
Regular expressions%@NL@%
     defined%@BO:   20760@%%@NL@%
     M 1.0 syntax%@BO:   20eeb@%%@BO:   24293@%%@NL@%
     predefined%@BO:   2885d@%%@NL@%
     searching%@BO:   1a2e0@%%@BO:   208bc@%%@NL@%
     special characters and%@BO:   21754@%%@BO:   2473c@%%@NL@%
     tagged%@BO:   231bc@%%@BO:   23b94@%%@BO:   27441@%%@BO:   27df8@%%@NL@%
     UNIX syntax%@BO:   20eeb@%%@NL@%
Reinitializing, TOOLS.INI%@BO:   3b6af@%%@NL@%
RemoveFile function%@BO:   5be9e@%%@NL@%
Repeat function%@BO:   60c4c@%%@NL@%
Repeating%@NL@%
     cursor-movement arguments%@BO:   110d1@%%@NL@%
     on-screen arguments%@BO:   110d1@%%@NL@%
     text arguments%@BO:    f570@%%@NL@%
Replace function%@BO:   1b205@%%@BO:   5c466@%%@BO:   60c4c@%%@NL@%
Replacing%@NL@%
     forward%@BO:   19804@%%@BO:   1b205@%%@NL@%
     overtype mode%@BO:    85e5@%%@NL@%
     repeated%@BO:   26c13@%%@NL@%
     search and replace%@BO:   197b4@%%@NL@%
Restcur function%@BO:   19402@%%@BO:   2f9b5@%%@BO:   60c4c@%%@NL@%
Right function%@BO:   15095@%%@BO:   60c4c@%%@NL@%
rmargin switch%@BO:   7225b@%%@NL@%
%@NL@%
%@2@%%@AB@%S%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
Saveall function%@BO:   60c4c@%%@NL@%
Savecur function%@BO:   19402@%%@BO:   2ade8@%%@BO:   2f9b5@%%@BO:   60c4c@%%@NL@%
savescreen switch%@BO:   7225b@%%@NL@%
Saving%@NL@%
     cursor position%@BO:   19402@%%@NL@%
     exiting, without%@BO:   128e1@%%@NL@%
Screen%@NL@%
     height%@BO:   3a3f0@%%@NL@%
     setting colors%@NL@%
          background and foreground%@BO:   35acc@%%@NL@%
          error messages%@BO:   368ed@%%@NL@%
          foreground and background%@BO:   35acc@%%@NL@%
          in TOOLS.INI file[TOOLS.INI]%@BO:   3ce83@%%@NL@%
          status line%@BO:   368ed@%%@NL@%
          text%@BO:   368ed@%%@NL@%
          user-selected text%@BO:   368ed@%%@NL@%
     windows%@BO:   1ebfe@%%@NL@%
Scrolling%@NL@%
     control%@BO:   1527e@%%@NL@%
     controlling with switches%@BO:   356ce@%%@NL@%
     %@AI@%See also%@AE@% Switches%@NL@%
     direction keys, using%@BO:   1503c@%%@NL@%
     horizontal%@BO:   1503c@%%@NL@%
     page%@BO:   155e1@%%@NL@%
     vertical%@BO:   1503c@%%@NL@%
     window down%@BO:   60c4c@%%@NL@%
     window up%@BO:   60c4c@%%@NL@%
Sdelete function%@BO:   2f5d4@%%@BO:   60c4c@%%@NL@%
Search-and-Replace functions%@BO:   197b4@%%@BO:   1b205@%%@NL@%
Searchall function%@BO:   1a791@%%@BO:   60c4c@%%@NL@%
Searching a series of files%@BO:   1ad57@%%@NL@%
Searching%@NL@%
     forward%@BO:    a3e8@%%@BO:   19804@%%@BO:   1a2e0@%%@NL@%
     patterns, for%@BO:   1a2e0@%%@NL@%
     regular expressions, with [regular expressions]%@BO:   208bc@%%@NL@%
     repeated%@BO:    aa58@%%@BO:   26c13@%%@NL@%
searchwrap switch%@BO:   7225b@%%@NL@%
selcolor switch%@BO:   368ed@%%@BO:   7225b@%%@NL@%
Setfile function%@BO:   1356e@%%@BO:   1f360@%%@BO:   60c4c@%%@NL@%
SetKey function%@BO:   5cc35@%%@NL@%
Setting screen colors%@NL@%
     background and foreground%@BO:   35acc@%%@NL@%
     error messages%@BO:   368ed@%%@NL@%
     foreground and background%@BO:   35a6f@%%@NL@%
     highlighted text%@BO:   368ed@%%@NL@%
     in TOOLS.INI file[TOOLS.INI]%@BO:   3ce83@%%@NL@%
     status line%@BO:   368ed@%%@NL@%
     text%@BO:   368ed@%%@NL@%
     user-selected text%@BO:   368ed@%%@NL@%
Setting up%@NL@%
     editor%@BO:    7792@%%@NL@%
     Help%@BO:   3eb8b@%%@NL@%
Setwindow function%@BO:   60c4c@%%@NL@%
Shell function%@BO:   135c3@%%@BO:   60c4c@%%@NL@%
Short name, in extensions%@BO:   13b58@%%@BO:   46722@%%@NL@%
shortnames switch%@BO:   7225b@%%@NL@%
Sinsert function%@BO:   60c4c@%%@NL@%
SKEL.C file%@BO:   4055d@%%@NL@%
SKEL.DEF file%@BO:   4b6c7@%%@NL@%
snow switch%@BO:   7225b@%%@NL@%
softcr switch%@BO:   7225b@%%@NL@%
stacolor switch%@BO:   35c03@%%@BO:   368ed@%%@BO:   7225b@%%@NL@%
Start-up, execution of commands at%@BO:   3e9db@%%@NL@%
Starting%@NL@%
     editor%@BO:    7746@%%@BO:    bc2e@%%@NL@%
     Help%@BO:    b45a@%%@NL@%
Status line, fields, described%@BO:    c7e2@%%@NL@%
Stream mode%@BO:   10bc4@%%@NL@%
STREAMARG, argument type%@BO:   48c88@%%@NL@%
STREAMARG, cmdTable flag%@BO:   435cc@%%@NL@%
streamarg%@NL@%
     argument type%@BO:   11a23@%%@NL@%
SwiDesc structure types%@BO:   421fa@%%@BO:   42880@%%@NL@%
swiTable%@BO:   41f4a@%%@NL@%
Switches%@NL@%
     askexit%@BO:   7225b@%%@NL@%
     askrtn%@BO:   7225b@%%@NL@%
     autosave%@BO:   7225b@%%@NL@%
     backup%@BO:   7225b@%%@NL@%
     case%@BO:   7225b@%%@NL@%
     defined%@BO:   33a2a@%%@NL@%
     displaycursor%@BO:   7225b@%%@NL@%
     editreadonly%@BO:   7225b@%%@NL@%
     entab%@BO:   38b68@%%@BO:   7225b@%%@NL@%
     enterinsmode%@BO:   7225b@%%@NL@%
     errcolor%@BO:   35c03@%%@BO:   368ed@%%@BO:   7225b@%%@NL@%
     errprompt%@BO:   7225b@%%@NL@%
     extmake%@BO:   7225b@%%@NL@%
     fgcolor%@BO:   35acc@%%@BO:   7225b@%%@NL@%
     filetab%@BO:   38b68@%%@BO:   7225b@%%@NL@%
     height%@BO:   7225b@%%@NL@%
     helpboldcolor%@BO:   7225b@%%@NL@%
     helpfiles%@BO:   7225b@%%@NL@%
     helpitalcolor%@BO:   7225b@%%@NL@%
     helpundcolor%@BO:   7225b@%%@NL@%
     helpwarncolor%@BO:   7225b@%%@NL@%
     helpwindow%@BO:   3756d@%%@BO:   7225b@%%@NL@%
     hgcolor%@BO:   35c03@%%@BO:   368ed@%%@BO:   7225b@%%@NL@%
     hike%@BO:   7225b@%%@NL@%
     hscroll%@BO:   3596c@%%@BO:   7225b@%%@NL@%
     in extensions%@BO:   41eff@%%@NL@%
     infcolor%@BO:   35c03@%%@BO:   368ed@%%@BO:   7225b@%%@NL@%
     keyboard%@BO:   7225b@%%@NL@%
     load%@BO:   40dcc@%%@BO:   7225b@%%@NL@%
     markfile%@BO:   192a8@%%@BO:   7225b@%%@NL@%
     noise%@BO:   7225b@%%@NL@%
     printcmd%@BO:   7225b@%%@NL@%
     readonly%@BO:   7225b@%%@NL@%
     realtabs%@BO:   38064@%%@BO:   38b68@%%@BO:   7225b@%%@NL@%
     rmargin%@BO:   7225b@%%@NL@%
     savescreen%@BO:   7225b@%%@NL@%
     scrolling and%@BO:   356ce@%%@NL@%
     searchwrap%@BO:   7225b@%%@NL@%
     selcolor%@BO:   368ed@%%@BO:   7225b@%%@NL@%
     setting screen color and%@BO:   35acc@%%@NL@%
     shortnames%@BO:   7225b@%%@NL@%
     snow%@BO:   7225b@%%@NL@%
     softcr%@BO:   7225b@%%@NL@%
     special syntax for%@BO:   3a7a5@%%@NL@%
     stacolor%@BO:   35c03@%%@BO:   368ed@%%@BO:   7225b@%%@NL@%
     tabalign%@BO:   38b68@%%@BO:   7225b@%%@NL@%
     tabdisp%@BO:   38718@%%@BO:   7225b@%%@NL@%
     tabstops%@BO:   38b68@%%@BO:   7225b@%%@NL@%
     tmpsav%@BO:   7225b@%%@NL@%
     traildisp%@BO:   3a1ab@%%@BO:   7225b@%%@NL@%
     trailspace%@BO:   39e2f@%%@BO:   7225b@%%@NL@%
     undelcount%@BO:   7225b@%%@NL@%
     undocount%@BO:    964e@%%@BO:   7225b@%%@NL@%
     unixre%@BO:   7225b@%%@NL@%
     viewonly%@BO:   7225b@%%@NL@%
     vscroll%@BO:   356ce@%%@BO:   7225b@%%@NL@%
     wdcolor%@BO:   368ed@%%@BO:   7225b@%%@NL@%
     width%@BO:   7225b@%%@NL@%
     wordwrap%@BO:   7225b@%%@NL@%
System requirements%@BO:    4be3@%%@NL@%
System-specific initialization%@BO:   3ce83@%%@NL@%
%@NL@%
%@2@%%@AB@%T%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
Tab function%@BO:   60c4c@%%@NL@%
tabalign switch%@BO:   38b68@%%@BO:   7225b@%%@NL@%
tabdisp switch%@BO:   38718@%%@BO:   7225b@%%@NL@%
Tables%@NL@%
     cmdTable%@BO:   40dcc@%%@BO:   42aa3@%%@NL@%
     swiTable%@BO:   41f4a@%%@NL@%
Tabs%@NL@%
     meaning within editor%@BO:   38b68@%%@NL@%
     reading from files%@BO:   38b68@%%@NL@%
     setting with switches%@BO:   38afc@%%@NL@%
     writing to disk%@BO:   38b68@%%@NL@%
tabstops switch%@BO:   38b68@%%@BO:   7225b@%%@NL@%
Tagged expressions%@BO:   231bc@%%@BO:   23b94@%%@BO:   27441@%%@BO:   27df8@%%@NL@%
Tags%@BO:   3c8ac@%%@NL@%
Tell function%@BO:   2b9eb@%%@BO:   2d034@%%@BO:   60c4c@%%@NL@%
Terminating sessions. %@AI@%See%@AE@% Exiting%@NL@%
Text arguments, editing%@BO:    f20b@%%@NL@%
Text switches%@BO:   3421c@%%@BO:   3a7a5@%%@NL@%
Text type arguments%@NL@%
     defined%@BO:    e83e@%%@NL@%
     markarg%@BO:    fa9b@%%@NL@%
     numarg%@BO:    e9d0@%%@BO:   17134@%%@NL@%
     textarg%@BO:    fec9@%%@NL@%
TEXTARG, argument type%@BO:   47d36@%%@NL@%
TEXTARG, cmdTable flag%@BO:   435cc@%%@NL@%
tmpsav switch%@BO:   7225b@%%@NL@%
TOOLS.INI file%@NL@%
     comments%@BO:   3dbb2@%%@NL@%
     defined%@BO:   33be7@%%@NL@%
     dividing into sections%@BO:   3c902@%%@NL@%
     line continuation%@BO:   3dea7@%%@NL@%
     reinitializing%@BO:   3b6af@%%@NL@%
     sample%@BO:   3b535@%%@NL@%
     structure%@BO:   3c086@%%@NL@%
     using tags in%@BO:   3c15b@%%@BO:   3c902@%%@NL@%
Top of file, moving to%@BO:   15b0c@%%@NL@%
traildisp switch%@BO:   3a1ab@%%@BO:   7225b@%%@NL@%
Trailing space%@BO:   39cc2@%%@NL@%
trailspace switch%@BO:   39e2f@%%@BO:   7225b@%%@NL@%
Translate. %@AI@%See%@AE@% Search-and-Replace functions%@NL@%
%@NL@%
%@2@%%@AB@%U%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
Unassigned function%@BO:   2bc22@%%@NL@%
UNDEL.EXE file%@BO:   76895@%%@NL@%
undelcount switch%@BO:   7225b@%%@NL@%
Undo function%@BO:    964e@%%@BO:   60c4c@%%@NL@%
undocount switch%@BO:    964e@%%@BO:   7225b@%%@NL@%
UNIX syntax, regular expression%@BO:   213b3@%%@NL@%
unixre switch%@BO:   7225b@%%@NL@%
Up function%@BO:   15095@%%@BO:   60c4c@%%@NL@%
%@NL@%
%@2@%%@AB@%V%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
Vertical scrolling%@BO:   356ce@%%@NL@%
Video modes supported%@BO:   3a514@%%@NL@%
Video-specific initialization%@BO:   3ce83@%%@NL@%
Viewing%@NL@%
     current assignments%@BO:   1406a@%%@NL@%
     function assignments%@BO:   2b13c@%%@NL@%
viewonly switch%@BO:   7225b@%%@NL@%
vscroll switch%@BO:   356ce@%%@BO:   7225b@%%@NL@%
%@NL@%
%@2@%%@AB@%W%@AE@%%@EH@%%@NL@%
───────────────────────────────────────────────────────────────────────────%@NL@%
%@NL@%
wdcolor switch%@BO:   368ed@%%@BO:   7225b@%%@NL@%
Whenloaded function%@BO:   40dcc@%%@BO:   44776@%%@NL@%
width switch%@BO:   7225b@%%@NL@%
Wildcards%@NL@%
     DOS%@BO:    c693@%%@BO:   135c3@%%@NL@%
     regular expressions%@BO:   21940@%%@BO:   24908@%%@NL@%
Window function%@BO:   1eea0@%%@BO:   60c4c@%%@NL@%
WINDOWFUNC, cmdTable flag%@BO:   435cc@%%@NL@%
Windows%@NL@%
     closing%@BO:   1f027@%%@NL@%
     creating%@BO:   1f027@%%@NL@%
     moving%@NL@%
          between%@BO:   1eea0@%%@NL@%
          down%@BO:   60c4c@%%@NL@%
          up%@BO:   60c4c@%%@NL@%
Word, moving forward by%@BO:   15d4c@%%@NL@%
Word%@NL@%
     moving backward by%@BO:   15d4c@%%@NL@%
wordwrap switch%@BO:   7225b@%%@NL@%
%@NL@%
%@NL@%