home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / progpas / pas_ed.arj / PAS-ED.MAN < prev   
Text File  |  1989-10-25  |  87KB  |  2,421 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                             Pas-Ed (TM) version 1.0
  13.                         Programmer's Editor for Pascal
  14.  
  15.  
  16.                                ┌───────────────┐
  17.                                │ USER'S MANUAL │
  18.                                └───────────────┘
  19.  
  20.  
  21.                        Copyright (C) 1989 by Hedco, Inc.
  22.                              All rights reserved.
  23.  
  24.                                  October, 1989
  25.  
  26.  
  27.                            ────────────────────────
  28.  
  29.  
  30.                                   Hedco, Inc.
  31.                                  P.O. Box 606
  32.                            Tehachapi, CA 93581   USA
  33.  
  34.                            Telephone: (805) 821-0167
  35.                 Monday through Friday, 9am to 5pm Pacific time
  36.  
  37.                            On CompuServe: 76137,1656
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59. Title Page                                                         Pas-Ed Manual
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.                            Copyrights and Trademarks
  67.                            ─────────────────────────
  68.  
  69.  
  70. Pas-Ed version 1.0 is copyrighted (C) 1989 by Hedco, Inc.
  71.  
  72. Pas-Ed and HEDCO are trademarks of Hedco, Inc.
  73.  
  74. Turbo Pascal, Turbo Debugger, Turbo Assembler, and Sidekick are registered
  75. trademarks of Borland International, Inc.
  76.  
  77. TurboPower Software is a trademark of TurboPower Software, Inc.
  78.  
  79. WordStar is a registered trademark of WordStar International, Inc.
  80.  
  81. IBM is a registered trademark of International Business Machines Corporation.
  82.  
  83.  
  84.  
  85.  
  86.  
  87. Acknowledgments
  88. ───────────────
  89.  
  90. The EMS/Disk swapping routine is based on the public domain unit EXECSWAP
  91. written by Kim Kokkonen of TurboPower Software.
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118. Preface                                                   Pas-Ed Manual - Page i
  119.  
  120.  
  121.  
  122.                            Pas-Ed License Agreement
  123.                            ────────────────────────
  124.  
  125.  
  126. DEFINITIONS
  127. ───────────
  128.  
  129. Hedco - Hedco, Inc.
  130. Pas-Ed - The Pas-Ed software and documentation.
  131.  
  132.  
  133. LICENSE
  134. ───────
  135.  
  136. Pas-Ed is a copyrighted, proprietary program of Hedco.  A single-user limited
  137. license is granted to you to use Pas-Ed for your personal use for a fifteen (15)
  138. day trial period.  If you would like to purchase a single-user license to
  139. continue to use Pas-Ed after the trial period, you may do so by making a $40
  140. payment to Hedco at the address shown on the Title Page of this manual.  To
  141. purchase a group license, contact Hedco for fees and instructions.  If you do
  142. not purchase a license from Hedco to use Pas-Ed, you must discontinue use of
  143. Pas-Ed after the 15 day trial period.
  144.  
  145.  
  146. LIMITED, EXCLUSIVE WARRANTY
  147. ───────────────────────────
  148.  
  149. Hedco warrants that the software will perform substantially as described in the
  150. documentation for a period of 30 days from the date of purchase.  Hedco makes no
  151. other warranty or representation, either express or implied, with respect to the
  152. software or its documentation, their quality, performance, merchantability, or
  153. fitness for a particular purpose.  This Limited Warranty is void if the software
  154. or documentation has been abused, misapplied, or altered.
  155.  
  156.  
  157. LIABILITY DISCLAIMER AND REMEDIES
  158. ─────────────────────────────────
  159.  
  160. In no event will Hedco be liable for direct, indirect, special, incidental or
  161. consequential damages arising out of the use or inability to use Pas-Ed even if
  162. Hedco has been advised of the possibility of such damages, and the entire and
  163. exclusive liability and remedy shall be to return Pas-Ed to Hedco within the
  164. warranty period for replacement or refund.
  165.  
  166.  
  167. GOVERNING LAW
  168. ─────────────
  169.  
  170. This License Agreement shall be governed by the laws of the State of California,
  171. and any action filed hereunder shall only be brought in Kern County, California.
  172.  
  173.  
  174.  
  175.  
  176.  
  177. Preface                                                  Pas-Ed Manual - Page ii
  178.  
  179.  
  180.  
  181.  
  182.                                Table of Contents
  183.                                ─────────────────
  184.  
  185.  
  186.  
  187.          Preface                                               Page  i
  188.          Copyrights and Trademarks ............................      i
  189.          Pas-Ed License Agreement .............................     ii
  190.  
  191.  
  192.          Chapter 1   Introduction To Pas-Ed                    Page  1
  193.          About This Manual ....................................      1
  194.          About Pas-Ed .........................................      1
  195.          System Requirements ..................................      2
  196.          Contacting Hedco .....................................      3
  197.  
  198.  
  199.          Chapter 2   Setting Up Pas-Ed                         Page  4
  200.          Pas-Ed Files .........................................      4
  201.          Getting Pas-Ed Ready .................................      4
  202.          Starting Pas-Ed ......................................      5
  203.          The Opening Screen ...................................      6
  204.          Navigating The Menu System ...........................      6
  205.          The Options Menu .....................................      7
  206.          The Color Chart ......................................      9
  207.          Setting Up The Macros ................................     10
  208.          Setting Up Turbo Pascal ..............................     10
  209.          Ready To Go ..........................................     11
  210.  
  211.  
  212.          Chapter 3   A Tour Of Pas-Ed                          Page 12
  213.          Getting Ready ........................................     12
  214.          Restoring Your Setup .................................     12
  215.          The Editor ...........................................     13
  216.          The Window Menu ......................................     14
  217.          The Search Menu ......................................     14
  218.          The Macro Menu .......................................     15
  219.          The Other Menus ......................................     16
  220.          The Pop-up Tables ....................................     16
  221.  
  222.  
  223.          Chapter 4   The Pas-Ed Menu System                    Page 17
  224.          About The Menus ......................................     17
  225.          The Menu Selections ..................................     17
  226.          File Menu ............................................     17
  227.          Window Menu ..........................................     18
  228.          Edit Menu ............................................     19
  229.          Search Menu ..........................................     20
  230.          Macros Menu ..........................................     21
  231.  
  232.  
  233.  
  234.  
  235.  
  236. Table of Contents                                                  Pas-Ed Manual
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.          Chapter 4   The Pas-Ed Menu System (continued)
  244.          Compile Menu .........................................     22
  245.          Run Menu .............................................     23
  246.          Debug Menu ...........................................     23
  247.          Language Menu ........................................     23
  248.          Options Menu .........................................     27
  249.  
  250.  
  251.          Chapter 5   The Pas-Ed Editor                         Page 31
  252.          About The Editor .....................................     31
  253.          The Editor Message Line ..............................     31
  254.          The Editor Status Line ...............................     32
  255.          The Function Keys ....................................     32
  256.          Entering Text ........................................     33
  257.  
  258.  
  259.          Chapter 6   Hints On Using Pas-Ed                     Page 34
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295. Table of Contents                                                  Pas-Ed Manual
  296.  
  297.  
  298.  
  299.  
  300.                       Chapter 1 - Introduction To Pas-Ed
  301.                       ──────────────────────────────────
  302.  
  303.  
  304.  
  305. About This Manual
  306. ─────────────────
  307.  
  308. This manual is organized into six chapters:
  309.  
  310.      Chapter 1 - Introduction To Pas-Ed (this chapter)
  311.      Chapter 2 - Setting Up Pas-Ed
  312.      Chapter 3 - A Tour of Pas-Ed
  313.      Chapter 4 - The Pas-Ed Menu System
  314.      Chapter 5 - The Pas-Ed Editor
  315.      Chapter 6 - Hints on Using Pas-Ed
  316.  
  317. It's assumed in this manual that you're familiar with Turbo Pascal and the Turbo
  318. integrated development environment (IDE).  The Pas-Ed editor is identical to the
  319. editor in the Turbo IDE.  This manual doesn't attempt to explain the intricacies
  320. of Turbo Pascal or of WordStar-type editors.  These subjects are covered in
  321. detail in the Turbo Pascal manuals, which you're assumed to have.
  322.  
  323. This manual strives to get you, the programmer, up and running with Pas-Ed in as
  324. little time as possible.  This is accomplished via a hands-on, setup tutorial in
  325. Chapter 2, Setting Up Pas-Ed.  Completing this tutorial should take about 15-20
  326. minutes, by which time you should have Pas-Ed set up to your liking.
  327.  
  328. Users familiar with the Turbo IDE or Sidekick should have no trouble running
  329. Pas-Ed at that point.  Those who would like a more complete introduction are
  330. encouraged to read Chapter 3, A Tour of Pas-Ed, which steps you through some of
  331. the more important features of Pas-Ed as they're explained.
  332.  
  333. We also recommend browsing through Chapter 6 - Hints on Using Pas-Ed.
  334.  
  335.  
  336.  
  337. About Pas-Ed
  338. ────────────
  339.  
  340. Pas-Ed is an ASCII file programmer's editor created to streamline the process of
  341. editing, compiling, debugging, and running programs written in Turbo Pascal.
  342. Since it's an ASCII file editor, Pas-Ed can also be used to edit programs for
  343. other compilers, but it will be clear when you run Pas-Ed that it's main forte
  344. is Turbo Pascal.  Pas-Ed's support for Turbo Pascal is unmatched by any other
  345. programmer's editor.  Pas-Ed combines the ease of use of the Turbo IDE with
  346. sophisticated multi-file and memory handling abilities.  Some of Pas-Ed's
  347. features include:
  348.  
  349.      - An integrated development environment for ease of use.
  350.  
  351.  
  352.  
  353.  
  354. Chapter 1 - Introduction To Pas-Ed                        Pas-Ed Manual - Page 1
  355.  
  356.  
  357.  
  358.      - Edit up to 21 files in a combination of DOS and EMS memory.
  359.  
  360.      - Windows that can be individually opened and closed, zoomed and unzoomed,
  361.        hidden and unhidden, and recolored.
  362.  
  363.      - 43/50 line screen modes on EGA/VGA systems.
  364.  
  365.      - Direct menu support for all Turbo Pascal compiler and linker switches.
  366.  
  367.      - Automatic TPC.CFG compiler configuration file generation based on menu
  368.        selections.
  369.  
  370.      - EMS or disk swapping during DOS shells and compile, debug and run
  371.        sessions, which frees up all but 6.4k of DOS memory.
  372.  
  373.      - Automatic error locating including /F Find Error.
  374.  
  375.      - Debug programs from within Pas-Ed by using Turbo Debugger.
  376.  
  377.      - Automatic restoration of the previous setup at startup.
  378.  
  379.      - Keyboard macros with adjustable playback delay.
  380.  
  381.      - Inter-file block copy and move of text.
  382.  
  383.      - Find and replace using text from a marked block.
  384.  
  385.      - Jump to a specific file or line number.
  386.  
  387.      - 10 placemarkers that operate within and between files.
  388.  
  389.      - Pop-up ASCII character table (shows the ASCII character and its decimal,
  390.        hex, and binary values, plus, if the ASCII value is under 32, the control
  391.        code).
  392.  
  393.      - Pop-up extended key code table (shows the extended key codes of the
  394.        function keys, <Alt> + keys, arrow keys, etc.).
  395.  
  396.  
  397.  
  398. System Requirements
  399. ───────────────────
  400.  
  401. Hedco recommends that you run Pas-Ed on a computer system with at least 512k of
  402. DOS memory and a hard disk.  EMS memory is not required.  Pas-Ed will run on a
  403. high-capacity floppy disk system, but you should realize that DOS memory swaps
  404. will necessarily be slow if they must be made to disk.  Also, because Pas-Ed
  405. leaves such a small kernel in memory, swap sizes will approach the amount of
  406. free DOS memory as reported by CHKDSK.  This could be a problem on some floppy
  407. disk systems.  In the following example, CHKDSK reports 451,328 bytes of free
  408. memory, which gives a good approximation of the size of the swap file:
  409.  
  410.  
  411.  
  412.  
  413. Chapter 1 - Introduction To Pas-Ed                        Pas-Ed Manual - Page 2
  414.  
  415.  
  416.  
  417.      A:\>chkdsk
  418.  
  419.         730112 bytes total disk space
  420.          45056 bytes in 2 hidden files
  421.         214016 bytes in 7 user files
  422.         471040 bytes available on disk
  423.  
  424.         655360 bytes total memory
  425.         451328 bytes free
  426.  
  427. In the above example, with only 471,040 bytes available on disk and a swap file
  428. size of close to 451,328 bytes, there will be almost no room left on the disk
  429. for the compiled program and/or for using a disk link buffer after the swap file
  430. has been written to disk.  Systems with dual 720k floppy drives will necessarily
  431. have to use both drives.  If you have a floppy disk system, no EMS memory, and
  432. only one or two edit window open, try turning EMS/Disk swapping off during DOS
  433. shells or when compiling very small programs.  Pas-Ed compresses the heap when
  434. EMS/Disk swapping is disabled, and exec sessions requiring minimal amounts of
  435. memory should operate without problem.  If you get insufficient memory messages,
  436. turn EMS/Disk swapping back on.
  437.  
  438.  
  439.  
  440. Contacting Hedco
  441. ────────────────
  442.  
  443. Pas-Ed is continually evolving to meet the needs of Pascal programmers.  As you
  444. use Pas-Ed, you'll undoubtedly think of additional features which Pas-Ed should
  445. have or changes that might enhance the program.  Please write Hedco with your
  446. suggestions or comments.  Our address is:
  447.  
  448.      Hedco, Inc.
  449.      P.O. Box 606
  450.      Tehachapi, CA 93581
  451.      USA
  452.  
  453.      Telephone: (805) 821-0167
  454.                 Monday through Friday, 9am to 5pm Pacific time
  455.  
  456.      On CompuServe: 76137,1656
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472. Chapter 1 - Introduction To Pas-Ed                        Pas-Ed Manual - Page 3
  473.  
  474.  
  475.  
  476.  
  477.                          Chapter 2 - Setting Up Pas-Ed
  478.                          ─────────────────────────────
  479.  
  480.  
  481.  
  482. Pas-Ed Files
  483. ────────────
  484.  
  485. If you haven't already done so, make backup copies of the Pas-Ed files.  The
  486. complete Pas-Ed package includes the following files:
  487.  
  488.      PAS-ED.EXE    The Pas-Ed program.  This is the only file needed to run
  489.                    Pas-Ed.
  490.  
  491.      PAS-ED.MAC    Sample macro file.
  492.  
  493.      PAS-ED.MAN    The complete, on-disk manual (this file).
  494.  
  495.      PAS-ED.CFG    The Pas-Ed configuration file.  This file is NOT included in
  496.                    the Pas-Ed package, but is listed here for completeness.  It
  497.                    is created by Pas-Ed every time you exit the program, and
  498.                    contains data representing the state of Pas-Ed upon exit.
  499.                    It's used to restore your last setup when you restart Pas-Ed.
  500.  
  501. By default, Pas-Ed uses the following programs from Borland International to
  502. compile and debug Turbo Pascal programs, although any compiler or debugger can
  503. be used:
  504.  
  505.      TPC.EXE       The Turbo Pascal compiler and library files.  These files are
  506.      TURBO.TPL     used to compile your source code files.
  507.  
  508.      TD.EXE        Turbo Debugger.
  509.  
  510.  
  511.  
  512. Getting Pas-Ed Ready
  513. ────────────────────
  514.  
  515. Those unfamiliar with setting up directories and paths and copying files should
  516. refer to your DOS or Turbo Pascal user's manuals.
  517.  
  518. The easiest way to set up Pas-Ed on your computer is to copy all the necessary
  519. Pas-Ed, compiler, and debugger files into the same directory.  If this isn't
  520. feasible, another method is to have the Pas-Ed, compiler, and debugger files in
  521. different directories and use DOS' PATH command to tell DOS where to look for
  522. them.  For example, if the compiler files were located on your hard disk drive C
  523. in the directory \TP, the command would be:
  524.  
  525.      PATH = C:\TP
  526.  
  527.  
  528.  
  529.  
  530.  
  531. Chapter 2 - Setting Up Pas-Ed                             Pas-Ed Manual - Page 4
  532.  
  533.  
  534.  
  535. This command is best entered into your AUTOEXEC.BAT file, and you can specify
  536. several paths separated by ";", such as:
  537.  
  538.      PATH = C:\TP;C:\TD;D:\PAS-ED
  539.  
  540.  
  541.  
  542. Starting Pas-Ed
  543. ───────────────
  544.  
  545. With Pas-Ed in the current directory, type "Pas-Ed".  The program will load and
  546. the Pas-Ed license menu will appear.  It will be necessary to accept the Pas-Ed
  547. License Agreement for the program to continue.  The Pas-Ed License Agreement is
  548. located in the preface of this manual.  This menu appears the first time Pas-Ed
  549. is started, and thereafter the program is entered directly.
  550.  
  551. Since this is the first time the program has been run, there's no PAS-ED.CFG
  552. configuration file for Pas-Ed to read to restore the prior setup.  A message to
  553. this effect appears, which, if you had previously used Pas-Ed and had created a
  554. configuration file, would alert you to possible corruption of that file so you
  555. could recheck your configuration settings.  Press <Esc> to clear the message and
  556. bring up the File Name window.
  557.  
  558. The File Name window is used whenever Pas-Ed needs the name of a file to edit,
  559. load, save, write to, etc.  The operation of this window is explained in detail
  560. in Chapter 3 - A Tour of Pas-Ed.  For now, press <Esc> to tell Pas-Ed you don't
  561. want to open a particular file.  Pas-Ed has to have at least one window open
  562. (after all, there's no point in using an editor if you don't want to edit any
  563. files), so Pas-Ed opens the file NONAME.1.  If this file exists in the current
  564. directory, Pas-Ed will open NONAME.2, and if NONAME.2 exists, Pas-Ed will open
  565. NONAME.3, etc.  After opening the window, Pas-Ed presents you with the opening
  566. screen.
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590. Chapter 2 - Setting Up Pas-Ed                             Pas-Ed Manual - Page 5
  591.  
  592.  
  593.  
  594. The Opening Screen
  595. ──────────────────
  596.  
  597. ────────────────────────────────────────────────────────────────────────────────
  598.  
  599.    File  Window  Edit  Search  Macros  Compile  Run  Debug  Language  Options
  600. ππππππππππππππππππππππππππππππππππππππππππππππππππππππππππππππππππππππππππππππππ
  601. ππππππππππππππ┌──────────────────────────────────────────────────┐ππππππππππππππ
  602. ππππππππππππππ│                                                  │ππππππππππππππ
  603. ππππππππππππππ│             Pas-Ed (TM) version 1.0              │ππππππππππππππ
  604. ππππππππππππππ│          Programmer's Editor for Pascal          │ππππππππππππππ
  605. ππππππππππππππ│        Copyright (C) 1989 by Hedco, Inc.         │ππππππππππππππ
  606. ππππππππππππππ│               All rights reserved.               │ππππππππππππππ
  607. ππππππππππππππ│             ────────────────────────             │ππππππππππππππ
  608. ππππππππππππππ│              Registration fee: $40               │ππππππππππππππ
  609. ππππππππππππππ│                 Please send to:                  │ππππππππππππππ
  610. ππππππππππππππ│                   Hedco, Inc.                    │ππππππππππππππ
  611. ππππππππππππππ│                   P.O. Box 606                   │ππππππππππππππ
  612. ππππππππππππππ│            Tehachapi, CA 93581   USA             │ππππππππππππππ
  613. ππππππππππππππ│            Telephone: (805) 821-0167             │ππππππππππππππ
  614. ππππππππππππππ│           (indicate 3½" or 5¼" disks)            │ππππππππππππππ
  615. ππππππππππππππ│             ────────────────────────             │ππππππππππππππ
  616. ππππππππππππππ│      Use of this software is subject to the      │ππππππππππππππ
  617. ππππππππππππππ│            Pas-Ed License Agreement.             │ππππππππππππππ
  618. ππππππππππππππ│  HEDCO and Pas-Ed are trademarks of Hedco, Inc.  │ππππππππππππππ
  619. ππππππππππππππ│                                                  │ππππππππππππππ
  620. ππππππππππππππ└──────────────────────────────────────────────────┘ππππππππππππππ
  621. ππππππππππππππππππππππππππππππππππππππππππππππππππππππππππππππππππππππππππππππππ
  622. ππππππππππππππππππππππππππππππππππππππππππππππππππππππππππππππππππππππππππππππππ
  623. 1                Load/save files █ DOS commands █ Exit program               DOS
  624.  
  625. ────────────────────────────────────────────────────────────────────────────────
  626.  
  627.  
  628. The opening screen contains Pas-Ed's copyright, trademark, and registration
  629. information.  The top line of the screen is Pas-Ed's main menu, and the bottom
  630. line is the status line, which contains prompt or status information.  Since
  631. "File" is highlighted, the status line briefly explains the File selection.  The
  632. "1" in the far left column of the status line indicates that the number 1 window
  633. is active.  If you had two windows open and the second window was active, a "2"
  634. would be displayed.  The "DOS" to the far right of the status line indicates
  635. where the edit buffer has been allocated, in this case DOS memory.  If the
  636. buffer had been allocated in EMS memory, "EMS" would appear here.
  637.  
  638.  
  639.  
  640. Navigating The Menu System
  641. ──────────────────────────
  642.  
  643. The menu system is navigated by using either the dedicated movement keys, such
  644. as the arrow, Home, and End keys, or WordStar commands, such as <Ctrl-S> for
  645.  
  646.  
  647.  
  648.  
  649. Chapter 2 - Setting Up Pas-Ed                             Pas-Ed Manual - Page 6
  650.  
  651.  
  652.  
  653. left, <Ctrl-D> for right, etc.  Pressing <Enter> when the light bar is over a
  654. selection or pressing its highlighted letter selects it, and <Esc> deselects or
  655. closes a menu.
  656.  
  657. Open the Options menu at this time by pressing <Alt-O>.  All the main menu
  658. selections, such as File, Window, Edit, Search, etc., are "hot-keyed", meaning
  659. they can be selected from anywhere in Pas-Ed, including from the editor, by
  660. pressing the Alt key and the first letter of the selection.  For example, go
  661. ahead and enter the editor now by pressing <Alt-E> and then reopen the Options
  662. menu by pressing <Alt-O>.
  663.  
  664.  
  665.  
  666. The Options Menu
  667. ────────────────
  668.  
  669. You will notice that, when you entered the editor, the opening screen was
  670. cleared.  The opening screen appears only at startup.
  671.  
  672. At the top of the Options menu is "Config auto save."  If this selection is on,
  673. the PAS-ED.CFG configuration file is saved to disk whenever you exit the
  674. program.  This file allows Pas-Ed to restore your previous setup when you
  675. restart the program.  It's a good idea to leave this option on unless you have
  676. reason not to.
  677.  
  678. The next selection is "Edit file save."  This selection brings up a submenu with
  679. the choices "Auto", "Prompt", and "Off."  These choices indicate how the file in
  680. the active window will be saved.  If Auto is selected and the file has been
  681. changed during the editing session, the file will automatically be saved prior
  682. to a DOS shell or a debug or run session or before exiting the program.  Prompt
  683. means you'll be prompted whether or not to save the file, and Off means the file
  684. won't be saved and you won't be prompted.  After you've made a selection, a
  685. submenu appears asking whether you want the change to be effective for just the
  686. current window or for all windows.  Each window can have its own setting.
  687. Pressing <Esc> cancels the change.
  688.  
  689. In most cases, Auto is the best choice, although Off is quite useful if you're
  690. cutting and pasting from one of your library files and don't want any accidental
  691. changes to the file to be saved (remember to reset this setting once you resume
  692. normal editing in the window).
  693.  
  694. You may be wondering why changed files are saved prior to DOS shells and debug
  695. and run sessions.  The reason is that these are the types of sessions where
  696. there's a good chance of a system crash, such as when debugging or running a new
  697. program with a fatal bug, thus losing all unsaved editing changes.
  698.  
  699. Next is "Backup file," which determines whether a ".BAK" file is created when
  700. the current file is saved.  This option is usually best left on unless speed
  701. and/or disk space are factors, and here too each window can have its own
  702. setting.
  703.  
  704.  
  705.  
  706.  
  707.  
  708. Chapter 2 - Setting Up Pas-Ed                             Pas-Ed Manual - Page 7
  709.  
  710.  
  711.  
  712. Next is "Macro auto save," which determines whether the in-memory macros are
  713. automatically saved to disk prior to exiting the program.  This option is also
  714. usually best left on.
  715.  
  716. Now press <U> for "memory Usage," which opens the Memory Usage submenu that
  717. determines how Pas-Ed will use the available DOS and EMS memory.  The first
  718. selection on the submenu is "Swap to EMS/disk," which determines whether Pas-Ed
  719. will swap a DOS memory image to EMS memory or disk prior to a DOS shell or a
  720. compile, debug, or run session.  If enabled, a DOS memory swap is made and all
  721. but 6.4k of DOS memory is freed up for the session.  If off, the heap is
  722. compressed and a standard DOS exec session is initiated with whatever DOS memory
  723. is available (the amount of available DOS memory depends on the number of
  724. windows you've opened).
  725.  
  726. The second selection on the Memory Usage submenu, "Reserve EMS for swap,"
  727. determines whether enough EMS memory will be reserved to hold a DOS memory swap.
  728. If your system doesn't have EMS memory or if there's not enough EMS memory
  729. available for the swap, then Pas-Ed will prevent you from enabling this option
  730. and the reason for this will be displayed in a pop-up window.
  731.  
  732. The third selection on the Memory Usage submenu, "Working memory", allows you to
  733. specify the amount of DOS memory, in bytes, that Pas-Ed sets aside for internal
  734. program use.  The default is 16,384 bytes (16k), which is the minimum amount of
  735. memory Pas-Ed will reserve.  This should prove sufficient for most situations.
  736. This figure may have to be adjusted upward if your setup of Pas-Ed uses a
  737. significant amount of working memory, such as if you've defined numerous macros
  738. or are making large EMS-to-EMS block copies and moves, etc.  (Since only one
  739. EMS-based file can be mapped into DOS memory at once, EMS-to-EMS block transfers
  740. are temporarily stored in working memory.)  If you get insufficient memory
  741. messages, raise the amount of working memory.
  742.  
  743. Press <Esc> to return to the Options menu, then <S> for "Screen colors."  The
  744. Screen Colors submenu appears, displaying all the program color types.  An arrow
  745. is displayed next to the Screen Colors submenu, showing which color type is
  746. currently selected.  Use the arrow, Home, and End keys to choose a color type to
  747. change, then press <Enter>.
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767. Chapter 2 - Setting Up Pas-Ed                             Pas-Ed Manual - Page 8
  768.  
  769.  
  770.  
  771. The Color Chart
  772. ───────────────
  773.  
  774. ────────────────────────────────────────────────────────────────────────────────
  775.  
  776.    File  Window  Edit  Search  Macros  Compile  Run  Debug  Language  Options
  777. ┌───────────────────────┐           ╔════════════════════════════════════════╗─┐
  778. │ Normal text color     │<════════  ║   ┌─ New Value ─┐     ┌─ Old Value ─┐  ║ │
  779. │ Highlighted text      │           ║   │       7     │     │       7     │  ║ │
  780. │ Marked text block     │           ║   └─────────────┘     └─────────────┘  ║ │
  781. │ Text error message    │           ║   ┌────────── Color Chart ──────────┐  ║ │
  782. │ Normal background     │           ║   │   0   1   2   3   4   5   6   7 │  ║ │
  783. │ Status line color     │           ║   │   8   9  10  11  12  13  14  15 │  ║ │
  784. │ Normal menu color     │           ║   │  16  17  18  19  20  21  22  23 │  ║ │
  785. │ Highlighted menu      │           ║   │  24  25  26  27  28  29  30  31 │  ║ │
  786. │ Selected menu item    │           ║   │  32  33  34  35  36  37  38  39 │  ║ │
  787. │ Menu border color     │           ║   │  40  41  42  43  44  45  46  47 │  ║ │
  788. │ Menu title color      │           ║   │  48  49  50  51  52  53  54  55 │  ║─┘
  789. │ Normal message color  │           ║   │  56  57  58  59  60  61  62  63 │  ║
  790. │ Highlighted message   │           ║   │  64  65  66  67  68  69  70  71 │  ║
  791. │ Selected message item │           ║   │  72  73  74  75  76  77  78  79 │  ║
  792. │ Message border color  │           ║   │  80  81  82  83  84  85  86  87 │  ║
  793. │ Message title color   │           ║   │  88  89  90  91  92  93  94  95 │  ║
  794. │ Normal help color     │           ║   │  96  97  98  99 100 101 102 103 │  ║
  795. │ Highlighted help      │           ║   │ 104 105 106 107 108 109 110 111 │  ║
  796. │ Selected help item    │           ║   │ 112 113 114 115 116 117 118 119 │  ║
  797. │ Help border color     │           ║   │ 120 121 122 123 124 125 126 127 │  ║
  798. │ Help title color      │           ║   └─────────────────────────────────┘  ║
  799. └───────────────────────┘           ╚════════════════════════════════════════╝
  800.  
  801. ────────────────────────────────────────────────────────────────────────────────
  802.  
  803.  
  804. The color chart appears showing all possible color combinations and their byte
  805. values.  At the top of the color chart are two boxes showing the old and new
  806. byte values of the selected color type.  Use the arrow, Home, and End keys to
  807. change the color value, noticing that the change is reflected in both the new
  808. color value box and the Screen Colors submenu.  The status line gives a brief
  809. explanation of how the new color value is incremented or decremented depending
  810. on which key is pressed. Pressing <Enter> selects the new color, while <Esc>
  811. restores the old color.
  812.  
  813. When all the program color types are changed to your liking, press <Esc> to exit
  814. the Screen Colors submenu.  The menu and message colors are changed immediately.
  815. A submenu appears asking whether you want the color changes to be effective for
  816. just the current window or for all windows.  Each window can have its own color
  817. settings.  Pressing <Esc> cancels any edit window color changes.
  818.  
  819. Return to the Options menu and press <T> to bring up the "Type of monitor"
  820. submenu.  The first selection, "Color monitor," forces Pas-Ed to treat your
  821. video system as either color or monochrome.  Most of the time, Pas-Ed will
  822.  
  823.  
  824.  
  825.  
  826. Chapter 2 - Setting Up Pas-Ed                             Pas-Ed Manual - Page 9
  827.  
  828.  
  829.  
  830. accurately detect the type of video system in use and adjust for it.  Some video
  831. systems are not what they appear to Pas-Ed, however, such as a monochrome LCD
  832. display running as a CGA.  Under such circumstances, you may find it necessary
  833. to reset this option.
  834.  
  835. The second selection, "Suppress snow," is important only if you have an older
  836. CGA system.  Early model CGAs display "snow" during untimed direct screen
  837. writes, which is how Pas-Ed writes to the screen by default.  If you notice snow
  838. on your screen, set this option on.  The resulting screen writes will be
  839. slightly slower but free of snow.
  840.  
  841. The third selection, "43/50 rows," resets the video mode to 43 screen lines if
  842. you have an EGA system or 50 screen lines for a VGA.  If you don't have one of
  843. these systems, a message to that effect appears and this option can't be
  844. enabled.
  845.  
  846.  
  847.  
  848. Setting Up The Macros
  849. ─────────────────────
  850.  
  851. Press <Alt-M> to open the Macros menu.  Macros are on by default.  If you don't
  852. want to use the macros, you can turn macro processing off by pressing <T> for
  853. "Turn on/off."  If you use macros, you may wish to reset the macro playback
  854. delay, which controls the number of milliseconds between keystrokes when a macro
  855. playback is in progress.  The default is 0.
  856.  
  857.  
  858.  
  859. Setting Up The Files
  860. ────────────────────
  861.  
  862. Press <Alt-L> to open the Language menu.  Press <F> to open the "Files" submenu.
  863. The "Files" submenu contains the names of the files Pas-Ed will use during DOS
  864. shells and compile and debug sessions.  You may enter any compiler,
  865. configuration, or debugger file names (of course, they should correctly name an
  866. appropriate program or file), and, as with all menu options, they're saved in
  867. the PAS-ED.CFG configuration file and restored upon startup.  The complete path
  868. name to COMMAND.COM is needed to operate the DOS shell.  Check each of these
  869. options to make sure they're correct, and change them if necessary.
  870.  
  871.  
  872.  
  873. Setting Up Turbo Pascal
  874. ───────────────────────
  875.  
  876. Press <Esc> to return to the Language menu.  The first selection on the Language
  877. menu, "Compiler," sets the Turbo Pascal compiler switches.  The second
  878. selection, "Linker," sets the Turbo Pascal linker switches.  The "Directories"
  879. selection determines the directories where Turbo Pascal will look for the
  880. various files it needs during compilation and where the resulting compiled files
  881.  
  882.  
  883.  
  884.  
  885. Chapter 2 - Setting Up Pas-Ed                            Pas-Ed Manual - Page 10
  886.  
  887.  
  888.  
  889. will be placed.  These options are the same as those in the Turbo IDE, and you
  890. should refer to your Turbo Pascal manuals and Chapter 4 - The Pas-Ed Menu System
  891. if you need further information.
  892.  
  893.  
  894.  
  895. Ready To Go
  896. ───────────
  897.  
  898. Pas-Ed is now ready to run.  If you're familiar with the Turbo IDE, you should
  899. be able to run Pas-Ed with little problem.  For an overview of running Pas-Ed,
  900. please read the next chapter, Chapter 3 - A Tour of  Pas-Ed.
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944. Chapter 2 - Setting Up Pas-Ed                            Pas-Ed Manual - Page 11
  945.  
  946.  
  947.  
  948.  
  949.                          Chapter 3 - A Tour of Pas-Ed
  950.                          ────────────────────────────
  951.  
  952.  
  953.  
  954. Getting Ready
  955. ─────────────
  956.  
  957. This chapter illustrates most of Pas-Ed's main features in tutorial fashion.
  958.  
  959. If you're in Pas-Ed, make sure the Options/Config Auto Save menu option is on,
  960. then exit Pas-Ed by pressing <Alt-X>.  <Alt-X> works from anywhere in Pas-Ed
  961. except the message windows, which require a specific response such as "Y" or "N"
  962. or <Esc>.  At the DOS prompt, type "Pas-Ed" to restart Pas-Ed.
  963.  
  964.  
  965.  
  966. Restoring Your Setup
  967. ────────────────────
  968.  
  969. Since you've created a PAS-ED.CFG configuration file, Pas-Ed asks whether you
  970. want to restore the previous setup.  Press <Y>, and the File Name window appears
  971. with the name of the first file from your previous setup in it.  You have four
  972. options:
  973.  
  974. 1.   Press <Enter> to load the file.
  975.  
  976. 2.   Press <Esc> to tell Pas-Ed you don't want to load the file.
  977.  
  978. 3.   Edit the name in the File Name window, pressing <Enter> when finished.
  979.  
  980. 4.   Use DOS wildcards (such as "*") to bring up a directory.  ".PAS" is the
  981.      default extension.  You can maneuver around the directory by using either
  982.      the dedicated movement keys or WordStar commands.   If you have a directory
  983.      hierarchy, you can maneuver through the various directories by highlighting
  984.      the appropriate directory and pressing <Enter>.  "..\" indicates the parent
  985.      directory of the current directory.  If a file is highlighted, pressing
  986.      <Enter> opens the highlighted file.  <Esc> clears the Directory window and
  987.      calls the File Name window again.
  988.  
  989. For now, press <Esc> to tell Pas-Ed you don't want to load the file.  After
  990. you've dealt with the first file, the rest of the files from your previous setup
  991. cycle through the File Name window one by one.  Press <Esc> as each file name
  992. appears so Pas-Ed won't load any of them.  Pas-Ed has to have at least one
  993. window open, so Pas-Ed opens a NONAME file.
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003. Chapter 3 - A Tour of Pas-Ed                             Pas-Ed Manual - Page 12
  1004.  
  1005.  
  1006.  
  1007. The Editor
  1008. ──────────
  1009.  
  1010. Press <Esc> to enter the editor.  The editor uses the WordStar command set and
  1011. is virtually identical to the editor in the Turbo IDE.  Try typing a few lines.
  1012. If you forget an editing command, press <F1> to bring up the help window.
  1013.  
  1014. One of the most useful and overlooked editing commands is the undo line change
  1015. command.  Return to the first line, type some changes, then type <Ctrl-Q><L>
  1016. (for Quick-Line).  The line is restored to its original form.  This command
  1017. works as long as you haven't erased or moved off the line.
  1018.  
  1019. The top line of the edit window shows the state of the editor and is explained
  1020. in detail in Chapter 5 - The Pas-Ed Editor.  For now, try pressing the Caps
  1021. Lock, Num Lock, and Scroll Lock keys and note how they affect this line.
  1022.  
  1023. The status (or bottom) line shows, from left to right, the window number, the
  1024. commands associated with the function keys, and the location of the edit buffer
  1025. for the active window ("DOS" or "EMS").
  1026.  
  1027. Now press <F2> to save the file.  <F2> saves the file regardless of the setting
  1028. of the Options/Edit File Save menu option.
  1029.  
  1030. Press <F3> to load a new file, and the File Name window appears.  Enter a file
  1031. name, and that file is loaded into the current window.  If it's a new file,
  1032. Pas-Ed verifies that you actually wanted to create a new file and didn't just
  1033. make a typing mistake.
  1034.  
  1035. Press <F4> to open a new window.  The File Name window reappears, only this time
  1036. the file you specify will be loaded into a new window.  The new window number is
  1037. visible in the lower left corner of the screen.  This number always shows the
  1038. window number of the file being acted upon.  Enter a file name and the window
  1039. will be created and the file loaded.
  1040.  
  1041. Press <F5> and the active window is reduced to half screen (unzoomed).  Now
  1042. press <F6> several times to rotate between the two windows.  While in the full
  1043. screen (zoomed) window, press <F5> to unzoom this window.  One window must
  1044. always be zoomed to provide a background for the unzoomed windows, and Pas-Ed
  1045. prevents the full screen window from being unzoomed.
  1046.  
  1047. Type something and mark a block in each window.  <Ctrl-K><B> marks the beginning
  1048. of a block and <Ctrl-K><K> marks the end.  Using the F5 and F6 keys, switch the
  1049. windows until both windows and blocks are visible on the screen.  Press
  1050. <Ctrl-K><C> to copy the block in the active window to the cursor position.  Now
  1051. press <F7> and copy the block from the other window to the cursor position.
  1052. Move the cursor a little and press <Ctrl-K><V> to move the block in the active
  1053. window to the cursor position.  Now press <F8> and move the block from the other
  1054. window to the cursor position.  Note that both <F7> and <F8> work within the
  1055. current window as well.  If your printer is connected to the LPT1 parallel
  1056. printer port 1 and turned on, use <Ctrl-K><P> to print the block.
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062. Chapter 3 - A Tour of Pas-Ed                             Pas-Ed Manual - Page 13
  1063.  
  1064.  
  1065.  
  1066. Type a nonsense word to ensure that the file in the active window can't be
  1067. compiled properly.  Press <F9> to make (compile) the file.  Pas-Ed will either
  1068. swap a DOS memory image to EMS/disk or compresses the heap depending on the
  1069. setting of the Options/Memory Usage submenu, and then call the TPC.EXE compiler
  1070. to compile the file.  If you get an out of memory message, change the
  1071. Options/Memory Usage/Swap To EMS/Disk setting to on, then recompile the file.
  1072. The compiler will find the error, and Pas-Ed will automatically locate the
  1073. error, highlight it, and display the error message.  Press <Esc> to clear the
  1074. error message.
  1075.  
  1076.  
  1077.  
  1078. The Window Menu
  1079. ────────────────
  1080.  
  1081. Press <Alt-W> to open the Window menu.  Press <H> to hide the active window.
  1082. Now press <Alt-E> to return to the editor, then <F6> several times to rotate to
  1083. the next active window.  As you can see, the window has indeed been hidden.
  1084. Press <Alt-W> to reopen the Window menu, then <U> for Unhide.  A menu appears
  1085. with a list of all the hidden windows, and you can either pick one to unhide or
  1086. press <Esc> to cancel.  Press <Esc>, then <P> for Pick.  A pick list of all
  1087. files appears, with the hidden windows clearly marked as such and the active
  1088. window prefaced by "√".  The pick list selects a new active window.  Select the
  1089. hidden window as the new active window, and it is immediately unhidden and
  1090. becomes the active window.
  1091.  
  1092. Press <C> for Close, and the active window is closed and removed from memory.
  1093. Now try to close the remaining window and Pas-Ed will prevent this.  At least
  1094. one window must always be open.  Press <O> and reopen the closed window.
  1095.  
  1096. The remaining entries on the Window menu rotate forward and backward through the
  1097. file rotation and zoom and unzoom the windows, similarly to the F5 and F6 keys
  1098. in the editor.
  1099.  
  1100.  
  1101.  
  1102. The Search Menu
  1103. ───────────────
  1104.  
  1105. Press <Alt-S> to open the Search menu.  This menu enables you to search and move
  1106. quickly through the files.  The Find and Replace menu selections are the same as
  1107. the <Ctrl-Q><F> (Quick Find) and <Ctrl-Q><A> (Quick Find and Replace) WordStar
  1108. commands.  The fiNd next and rePlace next menu selections are the same as
  1109. Wordstar's <Ctrl-L>.  The fInd block and rEplace block menu selections load the
  1110. search string with up to 30 characters from the marked block in the active
  1111. window, although not across line breaks.  Since there's a marked block in the
  1112. active window, press <I>, then <E> from the Search menu to try these selections.
  1113.  
  1114. From the Search menu, press <G> for Goto line.  Enter a line number and Pas-Ed
  1115. jumps to the specified line.  If the line number is greater than the number of
  1116. lines in the file, Pas-Ed jumps to the end of the file.
  1117.  
  1118.  
  1119.  
  1120.  
  1121. Chapter 3 - A Tour of Pas-Ed                             Pas-Ed Manual - Page 14
  1122.  
  1123.  
  1124.  
  1125. Press <Alt-S><S> to set a placemarker.  You have ten placemarkers to chose from,
  1126. 0-9.  Press <5> to set placemarker 5 (the placemarkers don't have to be set in
  1127. any particular order).  Press <Alt-W> to open the Window menu and <N> to rotate
  1128. to the next window.  Then press <Alt-S> to open to the Search menu, <J> for Jump
  1129. To Placemarker, and then enter <5>.  Pas-Ed will jump to the proper file and
  1130. line number.  These commands are also available from the editor.  Press <F6> to
  1131. rotate to the other file.  Press <Ctrl-K><1> to set placemarker 1, then jump
  1132. back and forth between the two files by pressing <Ctrl-Q><5> and <Ctrl-Q><1>.
  1133.  
  1134.  
  1135.  
  1136. The Macro Menu
  1137. ──────────────
  1138.  
  1139. Press <Alt-M> to open the Macro menu.  Through this menu, Pas-Ed can record and
  1140. playback keystrokes.  The macro menu is fairly self-explanatory, and you should
  1141. have no trouble using the macros.  For good measure, we'll record, edit, and
  1142. delete a macro.
  1143.  
  1144. Press <R> to record a macro.  A message appears reminding you how to turn macro
  1145. recording off.  Press <Esc> to clear the message, then <Alt-E> to enter the
  1146. editor.  Notice the "M" next to the window number in the lower left corner of
  1147. the screen, indicating that macro recording is on.  Typing carefully (trust us),
  1148. type the letter "c", no more, no less, then press <Alt-F10> to turn macro
  1149. recording off.   Pas-Ed asks for a key to associate the macro with.  Enter
  1150. <Alt-B>, then enter "Bad Macro" as the name for the macro.
  1151.  
  1152. Try out the macro by pressing <Alt-B>.  Instead of inserting "c" into the
  1153. window, the Compile menu opens.  To see why, press <Alt-M> to open the Macro
  1154. menu, then <E> to edit a macro, and choose "Bad Macro" as the macro to edit.
  1155. Press <Enter> to accept the macro name and the Edit Macro window appears with
  1156. Bad Macro displayed.  The macro should be shown as "<AltE>c."  As you can see,
  1157. all keystrokes after macro recording was turned on were faithfully recorded,
  1158. including keystrokes that perhaps we didn't want, such as <Alt-E>.  When we
  1159. pressed <Alt-B>, Bad Macro first selected Edit from the main menu with <Alt-E>,
  1160. then selected the Compile menu with <c>.  You should edit all macros after
  1161. they've been recorded to remove unwanted keystrokes.
  1162.  
  1163. While in the Edit Macro window, press the Home and End keys.  Instead of moving
  1164. the cursor to the beginning and end of the line, <Home> and <End> are inserted
  1165. into the macro.  In order to use these keys to maneuver around the Edit Macro
  1166. window, you must use the <Scroll Lock> key to toggle between command and literal
  1167. interpretation.  Try out the macro editor, in particular noticing how the
  1168. extended keys, such as Home, End, Insert, Delete, Backspace, etc., are handled
  1169. depending on whether the editor is in Command or Literal mode.
  1170.  
  1171. Be sure you're in Command mode, then either press <Enter> to accept the edited
  1172. macro or <Esc> to restore the original macro.  Then press <D> for Delete, and
  1173. delete Bad Macro.
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180. Chapter 3 - A Tour of Pas-Ed                             Pas-Ed Manual - Page 15
  1181.  
  1182.  
  1183.  
  1184. The Other Menus
  1185. ───────────────
  1186.  
  1187. The other menus are concerned mostly with setting up and running Pas-Ed and
  1188. Turbo Pascal.  The selections are either easily understood by programmers
  1189. familiar with Turbo Pascal or are explained in Chapter 2 - Setting Up Pas-Ed,
  1190. Chapter 4 - The Pas-Ed Menu System, or in your Turbo Pascal manuals.
  1191.  
  1192. One useful option that should be pointed out is the Options/View Last DOS Screen
  1193. menu selection.  Press <Alt-O><V>, and the last DOS screen appears.  Pressing
  1194. any key clears the screen.  This is especially useful for locating errors when a
  1195. compiler other than Turbo Pascal is being used with Pas-Ed, such as when
  1196. compiling assembler routines.
  1197.  
  1198.  
  1199.  
  1200. The Pop-up Tables
  1201. ─────────────────
  1202.  
  1203. Two of Pas-Ed's handiest features are the pop-up ASCII and extended key code
  1204. tables.  Press <Alt-E> to return to the editor.  <Alt-A> brings up the ASCII
  1205. table, and <Alt-K> bring up the extended key code tables.
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239. Chapter 3 - A Tour of Pas-Ed                             Pas-Ed Manual - Page 16
  1240.  
  1241.  
  1242.  
  1243.  
  1244.                       Chapter 4 - The Pas-Ed Menu System
  1245.                       ──────────────────────────────────
  1246.  
  1247.  
  1248.  
  1249. About the Menus
  1250. ───────────────
  1251.  
  1252. Pas-Ed's menus are similar in style to those in the Turbo IDE.  The main menu
  1253. displays horizontally across the top row of the screen, with pull-down submenus
  1254. opening vertically below.  All selections on the main menu are "hot keyed" and
  1255. can be selected from anywhere in Pas-Ed (except from the pop-up message windows)
  1256. by holding down the <Alt> key and pressing the first letter of the selection.
  1257. For example, to open the File menu, press <Alt-F>, and to select Run, press
  1258. <Alt-R>.
  1259.  
  1260. Moving around the menu system is accomplished by using either the dedicated
  1261. movement keys, such as the arrow, Home, and End keys, or WordStar commands, such
  1262. as <Ctrl-S> for left, <Ctrl-D> for right, <Ctrl-E> for up, <Ctrl-X> for down,
  1263. etc.  Pressing <Enter> when the light bar is over a selection or pressing its
  1264. highlighted letter selects it.  Pressing <Esc> deselects or closes a menu.
  1265.  
  1266. To assist you in choosing the proper menu options, each individual selection has
  1267. a brief descriptive prompt displayed in the status line.
  1268.  
  1269.  
  1270.  
  1271. The Menu Selections
  1272. ───────────────────
  1273.  
  1274. This section describes the operation and function of each menu selection.  The
  1275. menu selections are:
  1276.  
  1277. File
  1278. ────
  1279. Displays the File menu.  The File menu selections are:
  1280.  
  1281.      Load
  1282.      ────
  1283.      Loads a file into the active window.  If the requested file is already
  1284.      loaded in another window, you're given the choice of either switching to
  1285.      that window or going ahead and loading the file into the active window.
  1286.      The file which was already in the window is saved according to the setting
  1287.      of its "Edit File Save" toggle (see the Options menu).  This option can be
  1288.      selected from within the editor by pressing <F3>.
  1289.  
  1290.      Pick
  1291.      ────
  1292.      Displays a list of all files loaded in all windows and allows you to select
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298. Chapter 4 - The Pas-Ed Menu System                       Pas-Ed Manual - Page 17
  1299.  
  1300.  
  1301.  
  1302.      one as the active window.  This option is identical to the Pick selection
  1303.      in the Window menu.
  1304.  
  1305.      Clear
  1306.      ─────
  1307.      Deletes all data from the active window.  You're asked to confirm this
  1308.      action before the data is deleted.
  1309.  
  1310.      Save
  1311.      ────
  1312.      Saves the file in the active window to disk regardless of the setting of
  1313.      its Edit File Save toggle.
  1314.  
  1315.      save All
  1316.      ────────
  1317.      Saves all changed files to disk according to the setting of their Edit File
  1318.      Save toggles.
  1319.  
  1320.      Write to
  1321.      ────────
  1322.      Writes the file in the active window to a file you specify.
  1323.  
  1324.      Dir
  1325.      ───
  1326.      Display a directory based on a directory mask you specify.
  1327.  
  1328.      OS shell
  1329.      ────────
  1330.      Runs the DOS command you specify.  If no command is given, the screen is
  1331.      cleared and the DOS prompt appears.  Pas-Ed is re-entered by typing "EXIT"
  1332.      at the DOS prompt.  If EMS/disk swapping is enabled, the contents of memory
  1333.      are swapped out to EMS or disk prior to the DOS shell; otherwise, the heap
  1334.      is compressed.
  1335.  
  1336.      Exit
  1337.      ────
  1338.      Exits Pas-Ed and returns to DOS.  The files being edited are saved
  1339.      according to their Edit File Save toggles.  If the Config Auto Save and/or
  1340.      Macro Auto Save toggles are on, the configuration and/or macro files are
  1341.      saved.  See the Options menu for an explanation of these toggles.
  1342.  
  1343.  
  1344. Window
  1345. ──────
  1346. Displays the Window menu.  The Window menu selections are:
  1347.  
  1348.      Open
  1349.      ────
  1350.      Opens a new edit window if sufficient memory is available.  Windows are
  1351.      allocated first in DOS memory, then in EMS memory.  Up to 21 windows may be
  1352.      opened.
  1353.  
  1354.  
  1355.  
  1356.  
  1357. Chapter 4 - The Pas-Ed Menu System                       Pas-Ed Manual - Page 18
  1358.  
  1359.  
  1360.  
  1361.      Close
  1362.      ─────
  1363.      Closes the active window and deallocates it memory.  If the file in the
  1364.      active window has been changed during the editing session, it's saved
  1365.      according to the setting of its Edit File Save toggle (see the Options
  1366.      menu).
  1367.  
  1368.      Pick
  1369.      ────
  1370.      Displays a list of all files loaded in the windows and allows you to select
  1371.      one as the active window.  This option is identical to the Pick selection
  1372.      in the File menu.
  1373.  
  1374.  
  1375.      Next
  1376.      ────
  1377.      Selects the next unhidden window as the active window.
  1378.  
  1379.      Back
  1380.      ────
  1381.      Selects the previous unhidden window as the active window.
  1382.  
  1383.      Zoom
  1384.      ────
  1385.      Resizes the active window to either full or half screen.  Note that at
  1386.      least one window must always be full screen to provide a background for the
  1387.      unzoomed windows.
  1388.  
  1389.      Hide
  1390.      ────
  1391.      Hides the active window.  The data in a hidden window remains intact and
  1392.      the file save routines aren't affected.  The window is simply removed from
  1393.      the window rotation.  This enables you to avoid rotating between an
  1394.      excessive number of windows.  For example, you might have 21 windows open
  1395.      but only 3 files actively being edited; this options allows you to hide the
  1396.      other 18 windows.  Hidden windows may be unhidden with either the Unhide or
  1397.      Pick commands.  Note that at least one window must be unhidden.
  1398.  
  1399.      Unhide
  1400.      ──────
  1401.      Displays a list of all hidden windows and allows you to select one to
  1402.      unhide.
  1403.  
  1404.  
  1405. Edit
  1406. ────
  1407. Erases the menus, displays the active window, and calls the editor.
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416. Chapter 4 - The Pas-Ed Menu System                       Pas-Ed Manual - Page 19
  1417.  
  1418.  
  1419.  
  1420. Search
  1421. ──────
  1422. Displays the Search menu.  The Search menu selections are:
  1423.  
  1424.      Find
  1425.      ────
  1426.      Finds the search string using the search options you specify.
  1427.  
  1428.      fInd block
  1429.      ──────────
  1430.      Loads the search string with up to 30 characters from the marked block in
  1431.      the active window.  Characters are not loaded across line breaks.
  1432.  
  1433.      fiNd next
  1434.      ─────────
  1435.      Finds the next occurrence of the search string using the previous search
  1436.      options.
  1437.  
  1438.      Replace
  1439.      ───────
  1440.      Finds the search string and replaces it with the replacement string using
  1441.      the replace options you specify.
  1442.  
  1443.      rEplace block
  1444.      ─────────────
  1445.      Loads the search string with up to 30 characters from the marked block in
  1446.      the active window.  Characters are not loaded across line breaks.
  1447.  
  1448.      rePlace next
  1449.      ────────────
  1450.      Finds the next occurrence of the search string and replaces it with the
  1451.      replacement string using the previous replace options.
  1452.  
  1453.      Goto line
  1454.      ─────────
  1455.      Moves the cursor to the line number you specify.
  1456.  
  1457.      Set marker
  1458.      ──────────
  1459.      Sets the placemarker you specify (0 to 9) to the current cursor position in
  1460.      the current file.
  1461.  
  1462.      Jump to marker
  1463.      ──────────────
  1464.      Jumps to the placemarker you specify (0 to 9) as long as the file
  1465.      containing the placemarker is in memory.  The jump will be made even if the
  1466.      file is in a different window from the window where the placemarker was set
  1467.      and even if the window containing the file is hidden.  Jumping into a
  1468.      hidden window doesn't unhide it; as soon as you exit the window, it's
  1469.      removed again from the window rotation.  If there are 2 windows containing
  1470.      the same file, Pas-Ed jumps to the first one.
  1471.  
  1472.  
  1473.  
  1474.  
  1475. Chapter 4 - The Pas-Ed Menu System                       Pas-Ed Manual - Page 20
  1476.  
  1477.  
  1478.  
  1479. Macros
  1480. ──────
  1481. Displays the Macro menu.  The Macro menu selections are;
  1482.  
  1483.      Playback
  1484.      ────────
  1485.      Plays back the macro you specify.
  1486.  
  1487.      Record
  1488.      ──────
  1489.      Begins recording keystrokes into a macro.
  1490.  
  1491.      record Off
  1492.      ──────────
  1493.      Stops recording keystrokes and asks for a key to associate the macro with
  1494.      as well as a name for the macro.  This is the same as pressing <Alt-F10>
  1495.      from within the editor.  After a macro has been recorded, you should edit
  1496.      the macro to remove any keystrokes associated with setting up the macro.
  1497.      Pas-Ed automatically removes the keystrokes that turned macro recording
  1498.      on and off.
  1499.  
  1500.      Load
  1501.      ────
  1502.      Loads a macro file, replacing the macros in memory with the macros from the
  1503.      file.
  1504.  
  1505.      Merge
  1506.      ─────
  1507.      Merges the macros from a macro file with the macros in memory.  If the
  1508.      current macro file is then saved after the merge, it will include the
  1509.      merged macros.
  1510.  
  1511.      Save
  1512.      ────
  1513.      Writes the macros in memory to the current macro file.
  1514.  
  1515.      list
  1516.      ────
  1517.      Lists the macros in memory.
  1518.  
  1519.      Edit
  1520.      ────
  1521.      Edits an in-memory macro.
  1522.  
  1523.      Delete
  1524.      ──────
  1525.      Deletes an in-memory macro and deallocate its memory.
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534. Chapter 4 - The Pas-Ed Menu System                       Pas-Ed Manual - Page 21
  1535.  
  1536.  
  1537.  
  1538.      delete All
  1539.      ──────────
  1540.      Deletes all in-memory macros and deallocates their memory.  You're asked to
  1541.      confirm this action.
  1542.  
  1543.      macro delaY
  1544.      ───────────
  1545.      Adjust the delay between keystrokes when a macro is played back.  The delay
  1546.      is in milliseconds, and can be any number between 0 and 255.
  1547.  
  1548.      Turn on/off
  1549.      ───────────
  1550.      Enables and disables macro processing.  Macro processing is on by default.
  1551.      When disabled, all macros are deleted and their memory deallocated.  When
  1552.      enabled, the macros in the current macro file are reloaded into memory.
  1553.  
  1554.  
  1555. Compile
  1556. ───────
  1557. Displays the Compile menu.  The Compile menu selections are:
  1558.  
  1559.      Compile
  1560.      ───────
  1561.      The selected file is compiled.  No other used units with existing TPU files
  1562.      are compiled even if their source code has changed since they were last
  1563.      compiled.
  1564.  
  1565.      Make
  1566.      ────
  1567.      The selected file is compiled along with all units used by the program
  1568.      whose source code has changed since they were last compiled.
  1569.  
  1570.      Build
  1571.      ─────
  1572.      The selected file and all units used by the program are compiled.  This
  1573.      option ensures that all TPU files are up to date.
  1574.  
  1575.      Production build
  1576.      ────────────────
  1577.      The selected file and all units used by the program are compiled using your
  1578.      regular compiler settings, except no debug information is generated and
  1579.      stack and range checking are turned off.  This option ensures that all TPU
  1580.      files are up to date.
  1581.  
  1582.      Auto config file
  1583.      ────────────────
  1584.      Enables and disables the automatic creation of a compiler configuration
  1585.      file.  When enabled, an updated compiler configuration file is written to
  1586.      disk prior to every compile; if disabled, no configuration file is written.
  1587.      The default name for the configuration file is TPC.CFG, which can be
  1588.      changed using the Language/Files submenu.
  1589.  
  1590.  
  1591.  
  1592.  
  1593. Chapter 4 - The Pas-Ed Menu System                       Pas-Ed Manual - Page 22
  1594.  
  1595.  
  1596.  
  1597.      Find error
  1598.      ──────────
  1599.      Locate the source code location of a run-time error if you have its hex
  1600.      location.  For example, a runtime range error might result in the message
  1601.      "Runtime error 201 at 3C08:023B."  By entering the hex number "3C08:023B"
  1602.      as the error location, Pas-Ed will automatically locate and display the
  1603.      line in the source code that caused the error.
  1604.  
  1605.  
  1606. Run
  1607. ───
  1608. Run a program from within Pas-Ed.  If EMS/disk swapping is enabled, a DOS memory
  1609. image is swapped out to EMS or disk prior to the program run.
  1610.  
  1611.  
  1612. Debug
  1613. ─────
  1614. Debug a program from within Pas-Ed.  If EMS/disk swapping is enabled, a DOS
  1615. memory image is swapped out to EMS or disk prior to the debug session.
  1616.  
  1617.  
  1618. Language
  1619. ────────
  1620. Displays the Language menu.  The Language menu selections are:
  1621.  
  1622.      Compiler
  1623.      ────────
  1624.      Displays the Compiler submenu, which contains the options for the Turbo
  1625.      Pascal compiler.  The Compiler submenu selections are:
  1626.  
  1627.           Align data
  1628.           ──────────
  1629.           Align variables and typed constants on byte or word boundaries.
  1630.           Generally, byte alignment takes less space while word alignment is
  1631.           faster.
  1632.  
  1633.           Boolean evaluation
  1634.           ──────────────────
  1635.           Switch between complete and short circuit boolean evaluation, which
  1636.           determines whether boolean expressions are evaluated completely or
  1637.           terminated as soon as possible.
  1638.  
  1639.           Conditional defines
  1640.           ───────────────────
  1641.           Enter conditional compilation directives which can be referenced in
  1642.           the source code.
  1643.  
  1644.           Debug information
  1645.           ─────────────────
  1646.           Displays the Debug menu.  The Debug menu selections are:
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652. Chapter 4 - The Pas-Ed Menu System                       Pas-Ed Manual - Page 23
  1653.  
  1654.  
  1655.  
  1656.                Append debug info to EXE
  1657.                ────────────────────────
  1658.                Enables and disables the appending of debug information to the
  1659.                compiled EXE file.  This information is necessary to use Turbo
  1660.                Debugger on your program.  The extent of the debugging
  1661.                information appended depends on the following two settings:
  1662.  
  1663.                Make line-number table
  1664.                ──────────────────────
  1665.                Enables and disables the generation of a source code line-number
  1666.                table.  This table allows Turbo Debugger to step through the
  1667.                source code line by line during a debug session.  Unless this
  1668.                option is enabled, Turbo Debugger steps through your program at
  1669.                the CPU (assembly) level.
  1670.  
  1671.                Include local symbols
  1672.                ─────────────────────
  1673.                Enables and disables the generation of debug information for
  1674.                local symbols, which are the names and types of all local (as
  1675.                opposed to global) variables and constants.
  1676.  
  1677.           Force far calls
  1678.           ───────────────
  1679.           Enables and disables the use of the FAR code model by all procedures
  1680.           and functions.
  1681.  
  1682.           I/O Checking
  1683.           ────────────
  1684.           Enables and disables the generation of code to check for input/output
  1685.           errors.
  1686.  
  1687.           Memory sizes
  1688.           ────────────
  1689.           Displays the Memory Size submenu.  The selections on the Memory Size
  1690.           submenu are:
  1691.  
  1692.                Stack size
  1693.                ──────────
  1694.                Set the stack size in decimal bytes.
  1695.  
  1696.                Low heap limit
  1697.                ──────────────
  1698.                Set the minimum required heap size in decimal bytes.
  1699.  
  1700.                High heap limit
  1701.                ───────────────
  1702.                Set the maximum heap size in decimal bytes.
  1703.  
  1704.           Numeric processing
  1705.           ──────────────────
  1706.           Displays the Numeric Processing submenu.  The selections are:
  1707.  
  1708.  
  1709.  
  1710.  
  1711. Chapter 4 - The Pas-Ed Menu System                       Pas-Ed Manual - Page 24
  1712.  
  1713.  
  1714.  
  1715.                Emulation
  1716.                ─────────
  1717.                Enables and disables linking of the 8087 emulation library.  This
  1718.                library uses the 8087 math coprocessor if present and emulates it
  1719.                if not.
  1720.  
  1721.                Numeric processing
  1722.                ──────────────────
  1723.                Switches between inline 8087 code, which allows the use of
  1724.                single, double, extended, and comp real types, or the use of
  1725.                software-only (6 byte) reals.
  1726.  
  1727.           Overlays allowed
  1728.           ────────────────
  1729.           Enables and disables the generation of overlay code.  Units compiled
  1730.           with this option do not have to be overlayed.
  1731.  
  1732.           Range checking
  1733.           ──────────────
  1734.           Enables and disables the generation of code to check the bounds on
  1735.           arrays, strings, and scalar-type variables.
  1736.  
  1737.           Stack checking
  1738.           ──────────────
  1739.           Enables and disables the generation of code to check for stack
  1740.           overflow.
  1741.  
  1742.           Var-string checking
  1743.           ───────────────────
  1744.           Enables and disables checking of declared string parameters against
  1745.           the actual passed parameter.  If this option is on and the declared
  1746.           and actual string parameters are not identical, a compiler error
  1747.           occurs.
  1748.  
  1749.      Linker
  1750.      ──────
  1751.      Displays the Linker submenu.  The selections are:
  1752.  
  1753.           Link buffer
  1754.           ───────────
  1755.           Switch between using a disk or memory link buffer.  Linking to memory
  1756.           is faster but the linker may run out of memory on larger programs.
  1757.           Linking to disk is slower but larger programs can be linked.
  1758.  
  1759.           Map file
  1760.           ────────
  1761.           Sets the amount of information that goes into the map file (typically
  1762.           used by 3rd party debuggers).  The selections are:
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770. Chapter 4 - The Pas-Ed Menu System                       Pas-Ed Manual - Page 25
  1771.  
  1772.  
  1773.  
  1774.                None
  1775.                ────
  1776.                No map file is generated.
  1777.  
  1778.                Segments
  1779.                ────────
  1780.                Only segment information is generated.
  1781.  
  1782.                Publics
  1783.                ───────
  1784.                Segment information plus all symbol names and addresses and the
  1785.                location of the program's entry point are generated.
  1786.  
  1787.                Detailed
  1788.                ────────
  1789.                Publics information plus line-number and module tables are
  1790.                generated.
  1791.  
  1792.      Directories
  1793.      ───────────
  1794.      Displays the Directories submenu, which contains the paths to the various
  1795.      files needed by the Turbo pascal compiler.  The Directory submenu
  1796.      selections are:
  1797.  
  1798.           Turbo directory
  1799.           ───────────────
  1800.           The compiler will search the current directory and the directory
  1801.           specified here for the compiler configuration file and the library
  1802.           file.
  1803.  
  1804.           EXE & TPU directory
  1805.           ───────────────────
  1806.           The compiler will put the compiled EXE and TPU files in the directory
  1807.           specified here.  If no directory is specified, the compiled files will
  1808.           go in the directory with the source code file.
  1809.  
  1810.           Include directories
  1811.           ───────────────────
  1812.           The compiler will search the current directory and the directories
  1813.           specified here for the files listed with the Include {$I Filename}
  1814.           compiler directive.
  1815.  
  1816.           Unit directories
  1817.           ────────────────
  1818.           The compiler will search the current directory and the directories
  1819.           specified here for units used by the files being compiled.
  1820.  
  1821.           Object directories
  1822.           ──────────────────
  1823.           The compiler will search the current directory and the directories
  1824.  
  1825.  
  1826.  
  1827.  
  1828.  
  1829. Chapter 4 - The Pas-Ed Menu System                       Pas-Ed Manual - Page 26
  1830.  
  1831.  
  1832.  
  1833.           specified here for the object files listed with the {$L Filename}
  1834.           compiler directive.
  1835.  
  1836.      Files
  1837.      ─────
  1838.      Displays the Files submenu, which contains the names of the various files
  1839.      called by Pas-Ed during operation.  The Files submenu selections are:
  1840.  
  1841.           Compiler file name
  1842.           ──────────────────
  1843.           The file Pas-Ed will call to compile files.  ".EXE" is the default
  1844.           extension.
  1845.  
  1846.           conFigure file name
  1847.           ───────────────────
  1848.           The compiler configuration file.  This is the file Pas-Ed will write
  1849.           the Turbo Pascal compiler and linker switches to if the Auto Config
  1850.           File option is enabled (see the Compile menu).  ".CFG" is the default
  1851.           extension.
  1852.  
  1853.           Debugger file name
  1854.           ──────────────────
  1855.           The file Pas-Ed will call to debug files.  ".EXE" is the default
  1856.           extension.
  1857.  
  1858.           COMMAND.COM
  1859.           ───────────
  1860.           The complete path to COMMAND.COM, which is necessary for proper
  1861.           operation of the DOS shell.
  1862.  
  1863.  
  1864. Options
  1865. ───────
  1866. Displays the Options menu.  The Options menu selections are:
  1867.  
  1868.      Config auto save
  1869.      ────────────────
  1870.      Enables and disables automatic saving of the PAS-ED.CFG configuration file
  1871.      upon exit.  At startup, Pas-Ed looks in the current directory for the
  1872.      configuration file, which contains a description of Pas-Ed's last setup.
  1873.      Using this information, Pas-Ed can restore the last setup.
  1874.  
  1875.      Edit file save
  1876.      ──────────────
  1877.      Switches between automatic, prompted, and no file saves.  If set to Auto,
  1878.      the file will be automatically saved if it has been changed during the
  1879.      editing session.  If set to Prompt, you're prompted whether or not to save
  1880.      the file.  If set to Off, the file is not saved and you're not prompted.
  1881.      You're given the choice of applying the new setting to just the active
  1882.      window or to all windows.
  1883.  
  1884.  
  1885.  
  1886.  
  1887.  
  1888. Chapter 4 - The Pas-Ed Menu System                       Pas-Ed Manual - Page 27
  1889.  
  1890.  
  1891.  
  1892.      Backup files
  1893.      ────────────
  1894.      Enables and disables the creation of backup files.  You're given the choice
  1895.      of applying the new setting to just the active window or to all windows.
  1896.  
  1897.      Macro auto save
  1898.      ───────────────
  1899.      Enables and disables automatic saving of the macro file before exit.
  1900.  
  1901.      Write config file
  1902.      ─────────────────
  1903.      Writes the Pas-Ed configuration file PAS-ED.CFG to disk using the current
  1904.      settings.
  1905.  
  1906.      memory Usage
  1907.      ────────────
  1908.      Displays the Memory Usage submenu.  The selections are:
  1909.  
  1910.           Swap to EMS/Disk
  1911.           ────────────────
  1912.           Enables and disables the swapping of a DOS memory image to expanded
  1913.           memory (EMS) or disk prior to a DOS shell or compile, debug, or run
  1914.           session.  If enabled, more memory is freed up than would otherwise be
  1915.           available; however, this must be balanced against the time penalty
  1916.           imposed by the swap.  On systems with EMS memory, the time penalty is
  1917.           minimal and this option can be left enabled.  Systems requiring disk
  1918.           swaps, and in particular swaps to a floppy disk,  might want to
  1919.           disable this option during simple DOS shells, providing enough DOS
  1920.           memory is available for the exec session.
  1921.  
  1922.           Reserve EMS for swap
  1923.           ────────────────────
  1924.           Enables and disables the reservation of enough EMS memory to hold a
  1925.           DOS memory swap.  If enabled, enough 16k (16,384 byte) blocks of EMS
  1926.           memory are set aside for the swap.
  1927.  
  1928.           Working memory
  1929.           ──────────────
  1930.           Sets the amount of DOS memory reserved by Pas-Ed for internal purposes
  1931.           such as screen saves, macros, EMS-to-EMS block moves, etc.  By
  1932.           adjusting this value, sufficient memory can be reserved to allow
  1933.           proper functioning of the program while leaving as much memory as
  1934.           possible for the edit buffers.  The default value is 16,384 bytes
  1935.           (16k), and may be changed to any value between 16384 and 65535.  The
  1936.           default value reserves enough memory to run the program under most
  1937.           circumstances.
  1938.  
  1939.           If you encounter out of memory messages, simply increase this number.
  1940.           Since there's no painless way for the program to recover memory
  1941.           already allocated, the program should be exited and restarted if reset
  1942.           to a higher value.
  1943.  
  1944.  
  1945.  
  1946.  
  1947. Chapter 4 - The Pas-Ed Menu System                       Pas-Ed Manual - Page 28
  1948.  
  1949.  
  1950.  
  1951.           DOS buffers open
  1952.           ────────────────
  1953.           Displays the number of edit windows opened in DOS memory.
  1954.  
  1955.           EMS buffers open
  1956.           ────────────────
  1957.           Displays the number of edit windows opened in EMS memory.
  1958.  
  1959.           Total buffers open
  1960.           ──────────────────
  1961.           Displays the total number of open windows.
  1962.  
  1963.           EMS/Disk Swap Size
  1964.           ──────────────────
  1965.           Displays the exact size in bytes of the DOS memory swap.
  1966.  
  1967.           EMS reserved for swap
  1968.           ─────────────────────
  1969.           Displays the amount of expanded memory (EMS) reserved for the DOS
  1970.           memory swap.  Since EMS memory is allocated in 16k (16,384 byte)
  1971.           blocks, this figure is almost always larger than the exact size of the
  1972.           DOS memory swap file.
  1973.  
  1974.           Edit buffer size
  1975.           ────────────────
  1976.           Displays the size in bytes of the edit buffers (all buffers are the
  1977.           same size).
  1978.  
  1979.      Screen colors
  1980.      ─────────────
  1981.      Displays the Screen Colors submenu, which allows you to change the screen
  1982.      colors.  The functioning of the Screen Colors submenu is explained in
  1983.      detail in Chapter 2 - Setting Up Pas-Ed.
  1984.  
  1985.      The types of screen colors fall into 5 general categories:
  1986.  
  1987.           Text colors
  1988.           ───────────
  1989.           There are four text color types: Normal, Highlighted, Marked Block,
  1990.           and Error, which are the colors used when displaying the editing
  1991.           windows.  Normal is the regular text color, Highlighted is for the
  1992.           message line, Marked Block for marked blocks, and Error for error
  1993.           messages.
  1994.  
  1995.           General screen colors
  1996.           ─────────────────────
  1997.           There are two general screen color types: Screen Background and Status
  1998.           Line.  Screen Background is used when not in the editor or menu
  1999.           system, such as during DOS shells, compiles, etc.  Status Line is used
  2000.           for the bottom row of the screen.
  2001.  
  2002.  
  2003.  
  2004.  
  2005.  
  2006. Chapter 4 - The Pas-Ed Menu System                       Pas-Ed Manual - Page 29
  2007.  
  2008.  
  2009.  
  2010.           Menu colors
  2011.           ───────────
  2012.           There are five menu color types: Normal, Highlighted, Selected,
  2013.           Border, and Title.  Normal is the regular menu color, Highlighted is
  2014.           for selection letters, Selected for the moving light bar, Border for
  2015.           the menu border, and Title for menu headers.
  2016.  
  2017.           Message colors
  2018.           ──────────────
  2019.           The five message color types are essentially the same as the five menu
  2020.           colors types except they're used to display general messages.
  2021.  
  2022.           Help colors
  2023.           ───────────
  2024.           The five help color types are basically the same as the five menu
  2025.           colors types except they're used to display help messages.
  2026.  
  2027.      Default screen colors
  2028.      ─────────────────────
  2029.      Resets the screen colors to their default values.  You're asked to confirm
  2030.      this selection.  You have the choice of restoring the default colors in
  2031.      just the active window or in all windows.  No window colors are changed if
  2032.      <Esc> is pressed.
  2033.  
  2034.      Type of monitor
  2035.      ───────────────
  2036.      Displays the Monitor submenu.  The selections are:
  2037.  
  2038.           Color monitor
  2039.           ─────────────
  2040.           Forces Pas-Ed to treat your video display as either color or
  2041.           monochrome.
  2042.  
  2043.           Suppress snow
  2044.           ────────────
  2045.           Suppresses snow on older CGA displays at the expense of somewhat
  2046.           slower screen writes.
  2047.  
  2048.           43/50 rows
  2049.           ──────────
  2050.           Allows EGA/VGA systems to display 43/50 screen rows respectively.  The
  2051.           default is 25 rows.
  2052.  
  2053.  
  2054.  
  2055.  
  2056.  
  2057.  
  2058.  
  2059.  
  2060.  
  2061.  
  2062.  
  2063.  
  2064.  
  2065. Chapter 4 - The Pas-Ed Menu System                       Pas-Ed Manual - Page 30
  2066.  
  2067.  
  2068.  
  2069.  
  2070.                          Chapter 5 - The Pas-Ed Editor
  2071.                          ─────────────────────────────
  2072.  
  2073.  
  2074.  
  2075. About the Editor
  2076. ────────────────
  2077.  
  2078. Turbo Pascal programmers should have little trouble adapting to Pas-Ed's editor,
  2079. as it uses the same command set as the Turbo IDE.  Pas-Ed's windows operate much
  2080. like Sidekick's, and on-line help is available through the <F1> key.
  2081.  
  2082. Because of the editor's similarity to the Turbo IDE editor and since Pas-Ed
  2083. users are assumed to be familiar with Turbo Pascal and to have the Turbo Pascal
  2084. manuals, the description of the editor is brief.
  2085.  
  2086.  
  2087.  
  2088. The Editor Message Line
  2089. ───────────────────────
  2090.  
  2091. ────────────────────────────────────────────────────────────────────────────────
  2092.  
  2093.       Line 1    Col 1   Insert Indent Tab D:TESTFILE.PAS  Scr Num CAP BAK Auto
  2094.  
  2095. ────────────────────────────────────────────────────────────────────────────────
  2096.  
  2097.  
  2098. Above is an example of the editor message line, which appears at the top of each
  2099. text window and shows the status of the editor for that particular window.  Each
  2100. window can have different settings except for the keyboard status toggles, which
  2101. are the same in all windows.  The message line entries are:
  2102.  
  2103.      Line             The line number on which the cursor is located.
  2104.  
  2105.      Col              The column number in which the cursor is located.
  2106.  
  2107.      Insert           If visible, indicates that characters are being inserted
  2108.                       into the text buffer.  If off, characters are overwriting
  2109.                       the existing text.  This option is toggled by <Ctrl-V> or
  2110.                       <Insert>.
  2111.  
  2112.      Indent           If visible, indicates that new lines are indented to the
  2113.                       level of the line above.  If off, new lines start at
  2114.                       Column 1.  This option is toggled by <Ctrl-Q><I>.
  2115.  
  2116.      Tab              If visible, indicates that fixed, 8-column tabs are
  2117.                       enabled.  If off, tabs are set at the first letter of the
  2118.                       words on the line above.  This option is toggled by
  2119.                       <Ctrl-O><T>.
  2120.  
  2121.  
  2122.  
  2123.  
  2124. Chapter 5 - The Pas-Ed Editor                            Pas-Ed Manual - Page 31
  2125.  
  2126.  
  2127.  
  2128.      D:TESTFILE.PAS   The name of the file being edited.  Note that the full
  2129.                       path name is not displayed.
  2130.  
  2131.      Scr              If visible, indicates that the Scroll Lock key is on.
  2132.  
  2133.      Num              If visible, indicates that the Num Lock key is on.
  2134.  
  2135.      CAP              If visible, indicates that the Caps Lock key is on.
  2136.  
  2137.      BAK              If visible, indicates that a backup file will be made when
  2138.                       the file in the active window is saved.
  2139.  
  2140.      Auto             Displays the status of the Options/Edit File Save menu
  2141.                       option.  If "Auto" is displayed, then the file in the
  2142.                       active window will automatically be saved.  "Prompt" means
  2143.                       you'll be prompted whether or not to save the file, and no
  2144.                       display means the file won't be saved and you won't be
  2145.                       prompted.
  2146.  
  2147.  
  2148.  
  2149. The Editor Status Line
  2150. ──────────────────────
  2151.  
  2152. ────────────────────────────────────────────────────────────────────────────────
  2153.  
  2154. 2M   F1Help F2Save F3Load F4Open F5Zoom F6Next F7Copy F8Move F9Make F10Menu  DOS
  2155.  
  2156. ────────────────────────────────────────────────────────────────────────────────
  2157.  
  2158.  
  2159. Above is an example of the editor status line.  From left to right, the "2"
  2160. indicates that the number 2 edit window is active.  The "M" next to the "2"
  2161. means that macro recording is on.  In the middle are the function keys along
  2162. with a keyword description of their function.  The "DOS" on the far right
  2163. indicates that the active window has been allocated in DOS memory.  If the
  2164. active window had been allocated in EMS memory, "EMS" would be displayed.
  2165.  
  2166.  
  2167.  
  2168. The Function Keys
  2169. ─────────────────
  2170.  
  2171. The functions assigned to the function keys are:
  2172.  
  2173.      <F1> - Help.
  2174.             Displays a help menu, from which various help windows can be
  2175.             displayed showing the various editing commands.
  2176.  
  2177.      <F2> - Save.
  2178.             Saves the file in the active window to disk.
  2179.  
  2180.  
  2181.  
  2182.  
  2183. Chapter 5 - The Pas-Ed Editor                            Pas-Ed Manual - Page 32
  2184.  
  2185.  
  2186.  
  2187.      <F3> - Load.
  2188.             Loads a new file into the active window.
  2189.  
  2190.      <F4> - Open.
  2191.             Opens a new edit window if enough memory is available.
  2192.  
  2193.      <F5> - Zoom.
  2194.             Resizes the active window to full or half screen.
  2195.  
  2196.      <F6> - Next.
  2197.             Selects the next open window as the active window.
  2198.  
  2199.      <F7> - Copy.
  2200.             Displays a pop-up menu showing the files with marked blocks.  The
  2201.             block from the selected file is copied into the active window at the
  2202.             cursor location.  This option is identical to the <Ctrl-K><C> block
  2203.             copy command except that it can also copy between files.
  2204.  
  2205.      <F8> - Move.
  2206.             Displays a pop-up menu showing the files with marked blocks.  The
  2207.             block from the selected file is moved into the active window at the
  2208.             cursor location.  This option is identical to the <Ctrl-K><V> block
  2209.             move command except that it can also move between files.
  2210.  
  2211.      <F9> - Make.
  2212.             Makes (compiles) the file in the active window.
  2213.  
  2214.      <F10> - Menu.
  2215.              Opens the menu system.  This option is the same as <Alt-E>.
  2216.  
  2217.  
  2218. Entering Text
  2219. ─────────────
  2220.  
  2221. Text is entered into the Pas-Ed editor in a fashion similar to the Turbo IDE.
  2222. Like the IDE, Pas-Ed doesn't wrap lines, and lines must be terminated with
  2223. <Enter>.  As long as the cursor hasn't been moved from the line being edited and
  2224. the line hasn't been erased, the original line can be restored with <Ctrl-Q><L>.
  2225. If the Insert toggle is on, characters are inserted into the text buffer;
  2226. otherwise, characters overwrite the existing text.
  2227.  
  2228. The Pas-Ed editor is a WordStar command editor, and is virtually identical to
  2229. the editor in the Turbo IDE.  The Turbo Pascal manuals have a good explanation
  2230. of the editing commands.  If you need a quick reference of the commands, press
  2231. <F1> from within the editor to bring up the help menu.  If you need a quick
  2232. reference of ASCII or extended key codes, press <Alt-A> for a pop-up ASCII table
  2233. and <Alt-K> for an extended key code table.
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242. Chapter 5 - The Pas-Ed Editor                            Pas-Ed Manual - Page 33
  2243.  
  2244.  
  2245.  
  2246.  
  2247.                        Chapter 6 - Hints On Using Pas-Ed
  2248.                        ─────────────────────────────────
  2249.  
  2250.  
  2251.  
  2252. Hint:   Pas-Ed's text buffers are completely independent of one another.  If
  2253.         you've loaded the same file into two windows, remember that you aren't
  2254.         editing the same text in two windows but rather are editing two separate
  2255.         text buffers. Changes made to the text in one window aren't being made
  2256.         to the text in the other window.  If you make different changes in each
  2257.         window and save both windows, the file on disk will contain the changes
  2258.         made in the last window saved.
  2259.  
  2260.  
  2261. Hint:   When working on multi-file programs, always load the main program into
  2262.         the same window in the file rotation.  That way, you can compile the
  2263.         program from any window by using a macro which switches to that window
  2264.         and compiles the file.  For example, we always load the main program in
  2265.         the first (number 1) window, which is then always selection "A" on the
  2266.         Window/Pick submenu.  We use the following macro to make (compile) the
  2267.         file:
  2268.  
  2269.         <AltW>pa<AltC>m<Enter>
  2270.  
  2271.         This macro opens the Window menu, selects the Pick option, selects the A
  2272.         window (Window 1), opens the Compile menu, selects Make, and starts the
  2273.         compile.
  2274.  
  2275.  
  2276. Hint:   Although you can write macros which operate across DOS shells and
  2277.         compile, debug, and run sessions, it's usually best not to write these
  2278.         macros unless you're absolutely sure in advance of the results of the
  2279.         session.  For example, at the end of a compile, Pas-Ed always displays a
  2280.         message indicating the results of the compile.  If you write a macro
  2281.         that automatically clears this message, you'll lose any error messages
  2282.         should an error occur, and you'll have to manually examine the error
  2283.         message using the Options/View Last DOS Screen menu option
  2284.  
  2285.  
  2286. Hint:   If you're using a compiler other than Turbo Pascal, use the Options/View
  2287.         Last DOS Screen menu option to view compiler messages.
  2288.  
  2289.  
  2290. Hint:   Be careful when running the DOS shell.  After shelling to DOS and
  2291.         running another program or two and/or several DOS commands, it's easy to
  2292.         forget that you're still running DOS from within Pas-Ed's DOS shell.
  2293.         Starting or unloading a TSR or certain other programs at this point can
  2294.         crash your system.
  2295.  
  2296.         This is also a common way source, macro, and configuration files get
  2297.  
  2298.  
  2299.  
  2300.  
  2301. Chapter 6 - Hints On Using Pas-Ed                        Pas-Ed Manual - Page 34
  2302.  
  2303.  
  2304.  
  2305.         jumbled.  Say you've shelled to DOS, then forgotten you're in the DOS
  2306.         shell and restarted Pas-Ed.  You then edit files, change macros and menu
  2307.         settings, and exit Pas-Ed.  You later realize you're still in the
  2308.         original DOS shell and type "EXIT" at the DOS prompt and re-enter the
  2309.         original Pas-Ed, which then swaps back into memory ALL THE OLD FILES,
  2310.         MACROS, AND MENU SETTINGS.  If you exit Pas-Ed at this point without
  2311.         making sure the edit, macro, and configuration file auto save options
  2312.         are turned off, your new changes will be overwritten by the old files
  2313.         and settings.  Plus if the backup file option is turned off, there's no
  2314.         backup copy of your source files to restore your new editing changes.
  2315.         This is one good reason to leave the backup file option on.
  2316.  
  2317.  
  2318. Hint:   If your keyboard locks up, try holding down the <Ctrl> key and
  2319.         alternately pressing the left and right shift keys several times.  This
  2320.         will sometimes (not often) unlock the keyboard.  When trying to trace
  2321.         the source of the problem, first check to be sure it wasn't caused by
  2322.         the program you're writing.  If the problem persists, it may be a
  2323.         conflict between Pas-Ed's macro processor and another program, such as a
  2324.         TSR.  To check this, turn macro processing off using the Macros/Turn
  2325.         On/Off menu selection.  Pas-Ed is otherwise a plain vanilla program, so
  2326.         if the problem continues after macro processing has been turned off,
  2327.         it's probably somewhere else.  Try unloading your TSRs one by one to see
  2328.         if you can find the problem program.
  2329.  
  2330.         If your keyboard locks up during a DOS shell or a compile, debug, or run
  2331.         session, then the problem isn't Pas-Ed's macro processor, as it's
  2332.         disabled during these sessions.  As an aside, we regularly use Pas-Ed
  2333.         with SidekickPlus and have had no problems.
  2334.  
  2335.  
  2336. Hint:   If you run out of memory when doing an EMS-to-EMS block copy or move,
  2337.         first write the block to a nonsense file, such as TEMP.PAS, using
  2338.         <Ctrl-K><W>, then read TEMP.PAS into the destination file using
  2339.         <Ctrl-K><R>.  Since only one EMS-based file can be mapped into DOS
  2340.         memory at once, EMS-to-EMS block transfers are temporarily allocated in
  2341.         working memory.  Failure of these transfers may indicate that the amount
  2342.         of working DOS memory reserved by Pas-Ed needs to be increased using the
  2343.         Options/Memory Usage/Working Memory menu option.
  2344.  
  2345.  
  2346. Hint:   On a related note, remember if you encounter out of memory messages to
  2347.         raise the amount of working memory reserved for Pas-Ed using the
  2348.         Options/Memory Usage/Working Memory menu option.
  2349.  
  2350.  
  2351. Hint:   If your computer doesn't have EMS memory and you have only one or two
  2352.         windows open, turn the Options/Swap To EMS/Disk menu option off for
  2353.         simple DOS shells or when compiling very small programs, etc.  When
  2354.         EMS/Disk swapping is disabled, the heap is compressed for the exec
  2355.         session, and enough DOS memory for simple operations should be available
  2356.  
  2357.  
  2358.  
  2359.  
  2360. Chapter 6 - Hints On Using Pas-Ed                        Pas-Ed Manual - Page 35
  2361.  
  2362.  
  2363.  
  2364.         providing you have only one or, at most, two windows open.  This is very
  2365.         much faster than a disk-based DOS memory swap.  If you receive out of
  2366.         memory messages, then turn this option off, or, if you have two windows
  2367.         open, close one window.
  2368.  
  2369.  
  2370. Hint:   The ability to reset colors to their default values can be a lifesaver
  2371.         if some jokester in your office has changed all the colors to, for
  2372.         example, black on black, making the screen appear completely blank.
  2373.         Simply type <N> and then <Esc> a few times in case you've been left
  2374.         buried somewhere in the menu system in a pop-up message window, such as
  2375.         the message window asking if you want to exit the program.  Then type
  2376.         <Alt-O><D><Y> to reset the colors to their defaults.
  2377.  
  2378.  
  2379. Hint:   If you want to return to your current setup next time Pas-Ed is started
  2380.         but you have another project to work on before exiting Pas-Ed, use the
  2381.         Options/Write Config File menu option to immediately write the
  2382.         PAS-ED.CFG configuration file to disk.  Then turn the Config Auto Save
  2383.         option off to ensure that Pas-Ed won't save your new setup upon exit.
  2384.         When you restart Pas-Ed, your current setup will be restored.
  2385.  
  2386.  
  2387. Hint:   Remember that <Alt-A> calls up the pop-up ASCII table, and <Alt-K> calls
  2388.         up the extended key code table.
  2389.  
  2390.  
  2391. Hint:   If you have a hint that others might find useful and you wouldn't mind
  2392.         sharing, please sent it to Hedco so it can be included in the next
  2393.         version of the manual.
  2394.  
  2395.  
  2396.  
  2397.  
  2398.  
  2399.  
  2400.  
  2401.  
  2402.  
  2403.  
  2404.  
  2405.  
  2406.  
  2407.  
  2408.  
  2409.  
  2410.  
  2411.  
  2412.  
  2413.  
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419. Chapter 6 - Hints On Using Pas-Ed                        Pas-Ed Manual - Page 36
  2420.  
  2421.