home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 17 / CD_ASCQ_17_101194.iso / vrac / stxt130.zip / STXT130.DOC < prev    next >
Text File  |  1994-08-19  |  58KB  |  1,264 lines
  1.             ┌─────────────────────────────────────────────────┐
  2.             │ ▄▀▀▀▀▄── ██── █─── █ █▀▀▀▀▀█▀▀▀ █▀▀▀ █── █▀▀█▀▀ │
  3.             │ █────── █─ █─ █─── █ █──── █─── █──── █ █── █── │
  4.             │ ─▀▀▄▄─ █─── █ █─── █ █▄▄── █─── █▄▄─── █─── █── │
  5.             │ ──── █ █▀▀▀▀█─ █  █─ █──── █─── █──── █ █── █── │
  6.             │ ▀▄▄▄▄▀ █─── █── ██── █▄▄▄─ █─── █▄▄▄ █── █─ █── │
  7.             │                                                 │
  8.             │      A   T E X T   F I L E   B R O W S E R      │
  9.             │    W I T H   S E L E C T A B L E   S A V E R    │
  10.             │                                                 │
  11.             │    Len A. Philpot  ■■  Pineville, Louisiana     │
  12.             │    Copyright (c) 1994,  All Rights Reserved     │
  13.             └─────────────────────────────────────────────────┘
  14.  
  15. Version 1.3, August 1994
  16.  
  17.  
  18.       TABLE OF CONTENTS
  19. ═══════════════════════════════════════════════════════════════════════════
  20.       1.0   Introduction
  21.  
  22.       2.0   Starting SaveText
  23.       2.1   Specifying input and output filespecs
  24.  
  25.       3.0   The view screen and key commands
  26.  
  27.       4.0   Details on selected key commands
  28.       4.1   Ctrl-Right arrow
  29.       4.2   Ctrl-Left arrow
  30.       4.3   Home, End
  31.       4.4   Ctrl-Home, Ctrl-End and Ctrl-PgUp, Ctrl-PgDn
  32.       4.5   G              - Go to line
  33.       4.6   I              - Invert tags
  34.       4.7   N and L        - Find the next / last tagged line
  35.       4.8   T, Space       - Tag / Untag
  36.       4.9   S              - Save and clear tags
  37.       4.10  Alt-B, Alt-F   - Tag all lines to/from current location
  38.       4.11  Ctrl-B, Ctrl-F - Clear all tags to/from current location
  39.       4.12  Ctrl-C         - Toggle clock display
  40.       4.13  Alt-D          - DOS shell
  41.       4.14  Alt-E          - Eject printer page
  42.       4.15  Alt-H          - Hide / show selector bar
  43.       4.16  Alt-P          - Print tagged lines
  44.       4.17  Alt-Q          - Toggle quiet mode
  45.       4.18  Alt-R          - Toggle ruler visibility
  46.       4.19  Alt-S, Alt-A   - Search & search-again for text
  47.       4.20  Alt-T          - Set tab expansion
  48.       4.21  Alt-V          - Video mode
  49.       4.22  Esc            - Load a new file or Quit
  50.       4.23  F1             - Help
  51.       4.24  Ctrl-F10       - About SaveText
  52.  
  53.       5.0   Status line display
  54.  
  55.       6.0   Other miscellaneous details
  56.       6.1   Command line parameters
  57.       6.1a  /N             (no low ASCII)
  58.       6.1b  /B             (B&W video)
  59.       6.1c  /Q             (quiet mode)
  60.       6.1d  /R             (ruler at startup)
  61.       6.1e  /C             (clock at startup)
  62.       6.1f  /I:infile      (input filespec)
  63.       6.1g  /O:outfile     (output filespec)
  64.       6.1h  /V:xx          (startup video mode)
  65.       6.1i  /T:x           (startup tab expansion)
  66.       6.1j  /PC:initstr    (printer codes)
  67.       6.1k  /PP:x          (parallel printer port)
  68.       6.1l  /?, /H, /HELP  (parameter help)
  69.       6.2   STCMD environment variable
  70.       6.3   Memory
  71.  
  72.       7.0   Legalities
  73.  
  74.       8.0   Revision history
  75.  
  76.       9.0   One final note
  77.  
  78.  
  79. 1.0   INTRODUCTION
  80. ═══════════════════════════════════════════════════════════════════════════
  81.  
  82.    This program was born out of necessity - as a frequent user of
  83.    computer bulletin boards (BBSs), I often download listings of the
  84.    files that are available for downloading. Since these files are
  85.    plain ASCII text files, I could view them in any editor, viewer
  86.    or word processor. However, to keep a record of the files I
  87.    wanted to download, I would have to either write the names down
  88.    manually or (if the program in use supported it), highlight and
  89.    print each individual line on my printer. Obviously, neither
  90.    method was ideal.
  91.  
  92.    SaveText makes this job easy, for example -
  93.  
  94.    ■  View text files and tag individual lines to be saved to
  95.       another text file.
  96.  
  97.    ■  Extensive tagging/untagging options.
  98.  
  99.    ■  Incrementally save lines out of order, if desired.
  100.  
  101.    ■  Print tagged lines.
  102.  
  103.    ■  Search for text within the file; case sensitivity can be
  104.       toggled on or off; you can find and tag all matching lines or
  105.       the next match only. A search-again facility is also provided.
  106.  
  107.    ■  Auto-Resume lets you pick up viewing a file at the position of
  108.       your last tagged line.
  109.  
  110.    ■  Instantly jump to any line in the file.
  111.  
  112.    ■  Variable tab expansion.
  113.  
  114.    ■  Pop-up help.
  115.  
  116.    ■  View files up to 32,766 lines (up to more than 8 megabytes,
  117.       depending on contents) and navigate around them very quickly.
  118.       A special utility is provided (InHalf) to split even larger
  119.       text files into two smaller files.
  120.  
  121.    ■  A special utility program (UNIX2DOS) is provided to translate
  122.       UNIX-style text files to the standard MS-DOS format readable
  123.       by SaveText.
  124.  
  125.    ■  Another special utility (ASC2TXT) is included to convert 'high
  126.       ASCII' characters to Epson printer compatible low order
  127.       characters.
  128.  
  129.    ■  25, 43 and 50 line modes (EGA & VGA video adapters only).
  130.  
  131.    ■  Extensive command-line control of program settings.
  132.  
  133.    ■  Customize SaveText through both command line parameters and the
  134.       STCMD environment variable.
  135.  
  136.    For information on what's been added/changed since the last
  137.    version, check the WHATS.NEW file. Throughout the text of this
  138.    document, keys to be pressed will be surrounded by [square
  139.    brackets] while letters to be entered at the keyboard will be
  140.    surrounded by "quotation marks".
  141.  
  142.    If you wish to print this file on an Epson or Epson-compatible
  143.    printer, it's recommended that you process it with ASC2TXT prior
  144.    to printing to convert the high-ASCII (line drawing) characters
  145.    into their printable counterparts. Otherwise, you'll see various
  146.    incorrect characters where the lines should be. See ASC2TXT.DOC
  147.    for further details.
  148.  
  149.  
  150. 2.0   STARTING SAVETEXT
  151. ═══════════════════════════════════════════════════════════════════════════
  152.  
  153.    To start SaveText, type "ST" and press [Enter]. If you intend to
  154.    view a text file that you think may contain some 'low-order'
  155.    ASCII characters such as tabs or any other characters below ASCII
  156.    32 (space), type "ST /n" instead (the case is unimportant; it can
  157.    be upper or lower). The /n parameter tells SaveText to mark those
  158.    lines that contain any low ASCII characters and filter them out
  159.    before displaying the line on the screen. More information on
  160.    command line parameters can be found below, under 6.1 Command
  161.    Line Parameters.
  162.  
  163.  
  164. 2.1   SPECIFYING INPUT AND OUTPUT FILESPECS
  165. ═══════════════════════════════════════════════════════════════════════════
  166.  
  167.    Input File
  168.    ──────────
  169.    The first thing you will see is the opening screen with an input
  170.    field for the filespec to be viewed. If you know where the file
  171.    you want to view is located, you can enter a fully-qualified
  172.    filespec (including path, if necessary) in the input field. All
  173.    of the usual editing keys work here. To change drives, just type
  174.    the drive letter followed by a colon (for example, "A:") and
  175.    press Enter. If you want to quit, simply press [Esc]. If SaveText
  176.    can't find the file or (for example) the drive was not ready, it
  177.    will give an error message. If you press [F10] (or [Enter] with
  178.    no file specified) an input file requestor will appear from which
  179.    you can pick the file.
  180.  
  181.    Use the [up] & [down] arrows, [PgUp], [PgDn], [Home] and [End]
  182.    keys to navigate around the requestor. As a shortcut, you can
  183.    press any letter key and the selector bar will move to the first
  184.    file or pathname starting with that letter. Pressing it again
  185.    will cycle through the remaining matches. If there isn't a match,
  186.    you will hear a beep. To the right is a display indicating your
  187.    current path, current highlighted file, it's size in bytes, it's
  188.    date and time. When you've highlighted the file you want, press
  189.    [Enter] to retrieve it. Pressing [Esc] while at the file
  190.    requestor will take you back to the previous screen.
  191.  
  192.  
  193.    Output File
  194.    ───────────
  195.    After you choose your input file, you will then be prompted to
  196.    provide an output filespec. Once again, if you wish to save the
  197.    output file on a different drive or even in a different
  198.    subdirectory of the same drive, you'll need to provide the full
  199.    path to it. There is no file requestor available here. SaveText
  200.    will suggest an output file name consisting of the input basename
  201.    plus an extension of SAV. If you wish to change this, you can;
  202.    if not, just press [Enter]. SaveText will let you know if you've
  203.    entered an illegal filespec through an 'Invalid output filespec -
  204.    please re-enter' message. This can include a non-existent
  205.    subdirectory or drive. You will also get this error message if
  206.    you try to use the same name for both the input and output files.
  207.  
  208.    If the filename is valid but already exists, SaveText will give
  209.    you the option of replacing it or appending to the end of it.
  210.    Press [R] for replace or [A] for append.
  211.  
  212.  
  213.    Auto-Resume
  214.    ───────────
  215.    If you choose Append, you will be given the opportunity to resume
  216.    viewing your input file at the point of the last tagged line
  217.    (Auto-Resume). This is very helpful if you had to stop your
  218.    previous session before you reached the end of the file. Press
  219.    [N] if you would rather start viewing again at the first line
  220.    or any other key to resume at the last tagged line. If you
  221.    choose to re-sync, SaveText will place the last tagged line at
  222.    the top of the screen. If it can't find the correct line (if,
  223.    for example, that particular line in the SAV file had been
  224.    altered or removed), it will return to the top of the file in the
  225.    normal manner.
  226.  
  227.    ┌───────────────────────────────────────────────────────────────┐
  228.    │  VERY IMPORTANT - If you choose to Replace an existing file,  │
  229.    │  IT IS REPLACED AT THAT VERY POINT IN TIME. Even if you later │
  230.    │  decide not to save any lines out to that file, it has still  │
  231.    │  already been replaced. In other words, you will have         │
  232.    │  effectively erased the original file, so if it's important,  │
  233.    │  make a backup copy first.                                    │
  234.    └───────────────────────────────────────────────────────────────┘
  235.  
  236.    Note  If you have a printer connected to either LPT1 or LPT2, you
  237.          can specify one of these ports as the output filename and
  238.          when you save the tagged lines, they will be printed. Just
  239.          be sure to type "LPT1" or "LPT2" exactly, or you will
  240.          create an output file on disk with a very similar name! Be
  241.          aware, however that SaveText does not actually test for the
  242.          presence nor status of a printer on either port and LPT1
  243.          and LPT2 are the only ports supported. If something isn't
  244.          right, things could get a bit interesting!
  245.  
  246.          Another option is to use the Alt-P (print tagged lines)
  247.          option described below. However, if you really want to get
  248.          a printout of the lines you save, a better way is to go
  249.          ahead and save them to a file and then print that file
  250.          either by loading it into your favorite editor/word
  251.          processor or by copying the file to the printer by typing
  252.          "COPY yourfile PRN" (without quotes) and pressing [Enter].
  253.  
  254.    After pressing [Enter] in response to the output file prompt,
  255.    SaveText will read in and index (as well as scan for low ASCII
  256.    characters if the /n parameter was specified) the input file.
  257.  
  258.    Note  If SaveText encounters an ASCII 26 character, it will abort
  259.          input at that point, since ASCII 26 is the DOS end-of-file
  260.          marker. All the lines up to that point will be viewable,
  261.          however. If you specify an input file longer than 32,766
  262.          lines, SaveText will only load that many lines and then
  263.          abort with a message on the screen as to what happened. You
  264.          can press a key to remove the message or wait a few seconds
  265.          and it will go away on it's own (most message boxes in
  266.          SaveText are like that - to remove them, press a key or
  267.          wait a few seconds and they will go away by themselves).
  268.  
  269.    The next thing to come up is the file viewing screen, with a
  270.    status line at the bottom. If the file you are viewing is larger
  271.    in either width or length than what will fit on the screen at one
  272.    time, a vertical and/or horizontal scroll bar will appear at
  273.    right or bottom of the screen. These provide an approximate
  274.    indicator of relative position within the file.
  275.  
  276.  
  277. 3.0   THE VIEW SCREEN AND KEY COMMANDS
  278. ═══════════════════════════════════════════════════════════════════════════
  279.  
  280.    Most of the commands in SaveText are available through a single
  281.    keystroke. In summary, they are -
  282.  
  283.    Navigation keys -
  284.    ──────────────────────────────────────────────────────────────────────
  285.    Up arrow......... Up 1 line         Down arrow........ Down 1 line
  286.    Home............. Top of screen     End............... Btm of screen
  287.    Left arrow....... Pan left          Right arrow....... Pan right
  288.    Ctrl-Left arrow.. Full left         Ctrl-Right arrow.. Full right
  289.    PageUp........... Up 1 screen       PageDn, Enter..... Down 1 screen
  290.    Ctrl-Home........ Top of file       Ctrl-End.......... Bottom of file
  291.    Ctrl-PgUp........ Beginning of file Ctrl-PgDn......... End of file
  292.    N................ Next tag          L................. Last tag
  293.    G................ Go to line
  294.  
  295.    Other keys -
  296.    ──────────────────────────────────────────────────────────────────────
  297.    C................ Clear all tags
  298.    I................ Invert all tags (tagged=untagged, untagged=tagged)
  299.    S................ Save all tagged lines and clear tags
  300.    T, Spacebar...... Tag/untag line
  301.    Alt-B............ Tag all lines up to current (backward)
  302.    Alt-F............ Tag all lines from current on (forward)
  303.    Ctrl-B........... Clear all tags up to current (backward)
  304.    Ctrl-F........... Clear all tags from current on (forward)
  305.    Ctrl-C........... Toggle clock display
  306.    Alt-D............ DOS shell (type EXIT to return)
  307.    Alt-E............ Eject page from printer
  308.    Alt-H............ Hide / show selector bar
  309.    Alt-P............ Print tagged lines
  310.    Alt-Q............ Toggle Quiet mode
  311.    Alt-R............ Toggle ruler visibility
  312.    Alt-S, Alt-A..... Search & search-again for a text string
  313.    Alt-T............ Set tab expansion value
  314.    Alt-V............ Cycle 25/43/50 line mode (EGA/VGA only)
  315.    Esc.............. Load a new file or quit SaveText
  316.  
  317.  
  318. 4.0   DETAILS ON SELECTED KEY COMMANDS
  319. ═══════════════════════════════════════════════════════════════════════════
  320.  
  321. 4.1   Ctrl-Right arrow : Full right
  322.       ─────────────────────────────
  323.       By pressing this, the display will pan to the right as far as
  324.       the longest line in the file. If you don't see a line this
  325.       long on the screen, just scroll up or down - it's there
  326.       somewhere!
  327.  
  328.  
  329. 4.2   Ctrl-Left arrow : Full left
  330.       ───────────────────────────
  331.       Although the left and right arrow keys will pan the display
  332.       left and right by one column at a time, it's sometimes handy
  333.       to be able to return to the far left column quickly - that's
  334.       what this keypress does.
  335.  
  336.  
  337. 4.3   Home, End
  338.       ─────────
  339.       These two keystrokes simply go to the top and bottom of the
  340.       view screen. If the file you are viewing is less than one full
  341.       screen deep, End will move the selector bar to the last line
  342.       in the file, not necessarily to the bottom of the view screen.
  343.  
  344.  
  345. 4.4   Ctrl-Home, Ctrl-End and Ctrl-PgUp, Ctrl-PgDn
  346.       ────────────────────────────────────────────
  347.       (to differentiate between top/bottom & beginning/end of file)
  348.  
  349.       Pressing [Ctrl-Home] will move the selector bar to the top
  350.       line of the file without changing your current left/right
  351.       column position and [Ctrl-End] will move the selector bar to
  352.       the bottom of the file, also without affecting column
  353.       position. However, pressing [Ctrl-PgUp] will move the selector
  354.       bar to the top line and also move back to the far left column,
  355.       while pressing [Ctrl-PgDn] will move the selector bar to the
  356.       last line and as far right as the longest line in the file.
  357.       This effectively moves from top left to bottom right of the
  358.       file.
  359.  
  360.       [Ctrl-PgUp] and [Ctrl-PgDn] are fully operative only when the
  361.       file is both wider and longer than one full screen display.
  362.       Otherwise, they will simply duplicate the functions of
  363.       [Ctrl-Home] and [Ctrl-End].
  364.  
  365.  
  366. 4.5   G : Go to line
  367.       ──────────────
  368.       You can jump to a specific line in the file you are viewing by
  369.       pressing [G], entering the line number and then pressing
  370.       [Enter]. If you enter an invalid number, nothing will happen.
  371.       To abort, press [Esc].
  372.  
  373.  
  374. 4.6   I : Invert tags
  375.       ───────────────
  376.       Pressing [I] will simply toggle the tagged state of all the
  377.       lines in the input file - lines that were not tagged will be
  378.       and vice-versa. This is very handy when, for example, you want
  379.       to save all *but* a few lines of a file.
  380.  
  381.  
  382. 4.7   N and L : Find the next / last tagged line
  383.       ──────────────────────────────────────────
  384.       Sometimes it's convenient to jump from one tagged line to
  385.       another and that's what these keys will do. This function has
  386.       been modified a bit to operate more intuitively from the
  387.       previous version of SaveText. Now, if the next or last tagged
  388.       line is currently on the screen, the selector bar will simply
  389.       move to and highlight it without scrolling the screen (if you
  390.       are running in black & white video mode or on a monochrome
  391.       system, the line will flash). If it's not, the next tagged
  392.       line will be at the bottom of the screen or the last tagged
  393.       line will be at the top of the screen, just like it would be
  394.       if you had been browsing for it. If there are no lines tagged,
  395.       nothing will happen at all, but if you have found the first or
  396.       last tagged line, an alert box will pop up to inform you.
  397.  
  398.  
  399. 4.8   T, Space : Tag / Untag
  400.       ──────────────────────
  401.       These keys tag a line to be saved. If not already at the end
  402.       of the file, the selector bar will also move down one line. If
  403.       the line is already tagged, pressing T or Space will clear the
  404.       tag. Tagged lines are displayed in a different color than
  405.       untagged lines. If you tag a line that has been previously
  406.       saved, it will be displayed as in a similar, but slightly
  407.       different color scheme.
  408.  
  409.       This and other references to color obviously won't apply if
  410.       you have a monochrome system or start SaveText with the black
  411.       & white video (/b) option. However, SaveText is designed to
  412.       supply all the same information in either color or monochrome;
  413.       it's just easier to identify in color since there are more
  414.       choices. For further details on the /b parameter, see Command
  415.       Line Parameters below.
  416.  
  417.       For convenience sake, the spacebar duplicates the [T] key
  418.       function.
  419.  
  420.  
  421. 4.9   S : Save and clear tags
  422.       ───────────────────────
  423.       Pressing [S] saves all tagged lines to the output file. This
  424.       command also clears all the tagged lines, but these lines are
  425.       then displayed with reduced intensity to indicate they have
  426.       been saved already. However, they may be again tagged,
  427.       untagged, saved, etc. You do not need to manually save any
  428.       tagged lines before quitting by using this command,
  429.       however. If there are unsaved tagged lines when you quit, you
  430.       will be asked if you want to save them. This command gives you
  431.       the ability to save lines out of order and serves to mark
  432.       those lines that have already been saved during the session.
  433.  
  434.  
  435. 4.10  Alt-B, Alt-F : Tag all lines to/from current location
  436.       ─────────────────────────────────────────────────────
  437.       These two options give you the ability to automatically tag
  438.       all lines from your current position, in either direction.
  439.       [Alt-B] tags all the lines up to and including the current
  440.       line (in a {B}ackward direction) and [Alt-F] tags all the
  441.       lines from your the current line to the end of the file (in a
  442.       {F}orward direction). If all lines are already tagged, nothing
  443.       will happen.
  444.  
  445.  
  446. 4.11  Ctrl-B, Ctrl-F : Clear all tags to/from current location
  447.       ────────────────────────────────────────────────────────
  448.       These two features are complementary to [Alt-B] and [Alt-F].
  449.       Whereas the two Alt-key combinations tag lines, these two
  450.       Ctrl-key combinations untag lines. Otherwise, they operate in
  451.       the same manner. If no lines are currently tagged, nothing
  452.       will happen.
  453.  
  454.  
  455. 4.12  Ctrl-C : Toggle clock display
  456.       ─────────────────────────────
  457.       By default, a prompt of "F1:Help" appears on the bottom line
  458.       of the display, to the far right. You can toggle this prompt
  459.       with a 12 hour, am/pm clock display by pressing [Ctrl-C].
  460.  
  461.       This feature can be pre-configured through the use of the /C
  462.       command line parameter and/or the STCMD environment variable
  463.       (see Section 6 below).
  464.  
  465.  
  466. 4.13  Alt-D : DOS shell
  467.       ─────────────────
  468.       By pressing [Alt-D], you open SaveText's DOS shell and can
  469.       perform whatever DOS functions you wish within the remaining
  470.       free memory available. You can return to SaveText by typing
  471.       "EXIT" and pressing [Enter].
  472.  
  473.       ┌───────────────────────────────────────────────────────────┐
  474.       │  VERY IMPORTANT - While in the DOS shell, DO NOT erase    │
  475.       │  either file that is currently in use. Doing so will      │
  476.       │  certainly cause unpredictable behavior upon your return, │
  477.       │  most likely causing the program to abort and possibly    │
  478.       │  locking up your system.                                  │
  479.       └───────────────────────────────────────────────────────────┘
  480.  
  481. 4.14  Alt-E : Eject page from printer
  482.       ───────────────────────────────
  483.       This key is just a convenience - it's easier to press Alt-E
  484.       after printing rather than reaching to the printer, taking it
  485.       offline, pressing the form-feed button and then returning it
  486.       online.
  487.  
  488.  
  489. 4.15  Alt-H : Hide / show selector bar
  490.       ────────────────────────────────
  491.       This function is simply a convenience - it doesn't actually
  492.       remove the selector bar, but rather makes it invisible for
  493.       those times when you're simply browsing through a file rather
  494.       than tagging lines. Pressing [Alt-H] will toggle the
  495.       visibility of the bar: press it once and it disappears, again
  496.       and it's visible.
  497.  
  498.       Keep in mind that although the bar is invisible, it's still
  499.       there and all the usual functions apply as normal. For
  500.       example, if you are on the top line of a screen with the bar
  501.       hidden and press the down arrow, it will take several presses
  502.       to make the screen scroll, since the bar is actually moving
  503.       down the screen. Check out the line number on the status line
  504.       and you'll see that it is indeed moving. You can still tag,
  505.       untag, search, etc., but there's little reason to do so with
  506.       the bar invisible. The bar is made visible again whenever you
  507.       load a new file.
  508.  
  509.  
  510. 4.16  Alt-P : Print tagged lines
  511.       ──────────────────────────
  512.       If you have a printer attached to either LPT1 or LPT2, you can
  513.       print the currently tagged lines by pressing [Alt-P]. The
  514.       lines will remain tagged after printing. Pressing the [Esc]
  515.       key will abort printing.
  516.  
  517.       There are a few points to note, however:
  518.  
  519.          Printed lines are not wrapped, i.e., all data on a line
  520.          past the righthand margin of the printer will not be
  521.          printed, but rather truncated. However, you do have the
  522.          ability to print longer lines than will fit on a standard
  523.          80 column video display if your printer supports a
  524.          condensed typeface. You can use the /PC: command line
  525.          parameter to send control codes to the printer before
  526.          starting SaveText (see below). In any case, the original
  527.          file is never affected, just the printed output.
  528.  
  529.          If you specified either LPT1 or LPT2 as an output filename,
  530.          this feature is disabled, since you will be saving to the
  531.          printer anyway. If you wish to print only a few lines at a
  532.          time, just tag the lines and then use the [S]ave command to
  533.          print them.
  534.  
  535.          SaveText will check and report if your printer is offline
  536.          or out of paper, but it does not check for the presence of
  537.          a printer at the port. If you try to print without having a
  538.          printer connected, there will be no harm done, however,
  539.          SaveText will go merrily about its way printing to a
  540.          non-existent printer. In this case, just press [Esc] to
  541.          abort the operation. In the event of a paper outage, the
  542.          print operation will abort; SaveText does not currently
  543.          support restarting the print job at the current line.
  544.  
  545.          As with the 'LPTx' output filename, SaveText currently
  546.          supports only LPT1 and LPT2. If your printer is attached to
  547.          LPT2, you can set this option by using the /PP:x command
  548.          line parameter and/or the STCMD environment variable (see
  549.          Section 6 below). The default value is LPT1. Also, if you
  550.          have specified any printer setup codes using the /PC:
  551.          command line parameter (see below), they will be applied
  552.          here.
  553.  
  554.          The Alt-E key combination can be used to eject a partially
  555.          full page after printing if desired.
  556.  
  557.  
  558. 4.17  Alt-Q : Toggle quiet mode
  559.       ─────────────────────────
  560.       It's possible to alternate between 'quiet' and normal mode
  561.       while the program is running. By pressing [Alt-Q], the
  562.       suppression of sounds is toggled on and off. You will hear a
  563.       short, distinctive low frequency sound when this key is
  564.       pressed, regardless of mode.
  565.  
  566.       This feature can be pre-configured through the use of the /Q
  567.       command line parameter and/or the STCMD environment variable
  568.       (see Section 6 below).
  569.  
  570.  
  571. 4.18  Alt-R : Toggle ruler visibility
  572.       ───────────────────────────────
  573.       A column ruler can at the bottom of the screen can be
  574.       displayed or removed by pressing [Alt-R]. Basically, this
  575.       keypress toggles the status line and ruler. The ruler/status
  576.       line state is preserved when loading a new file.
  577.  
  578.       This feature can be pre-configured through the use of the /R
  579.       command line parameter and/or the STCMD environment variable
  580.       (see Section 6 below).
  581.  
  582.  
  583. 4.19  Alt-S, Alt-A : Search, search-again for text
  584.       ────────────────────────────────────────────
  585.       You can perform either a case sensitive or insensitive search
  586.       for text within the file. Pressing [Alt-C] when the text
  587.       search input box is visible will toggle this sensitivity on or
  588.       off. Also available is an option to find and tag every match
  589.       or only the next match. Toggle this option by pressing
  590.       [Alt-T]. The default setting is a find-all, case-insensitive
  591.       search. That way, if the next match isn't what you are looking
  592.       for, just press [T] or [spacebar] to untag it and then [Alt-A]
  593.       to search again.
  594.  
  595.       Search again (Alt-A) is available only when performing a
  596.       find-next search. When the end of the file has been reached
  597.       and all matches have been found, a message box will appear
  598.       indicating that there are no more matches. If another
  599.       find-next search is initiated at this point (either by [Alt-A]
  600.       or by [Alt-S]/[Enter]), the search start-point will wrap
  601.       around to the top of the file and repeat the process.
  602.  
  603.       When a search is initiated, SaveText will find and tag either
  604.       all matches or the next match, depending on which option is
  605.       active. If you have chosen Find All, you will remain at the
  606.       same location within the file. If you have chosen Find Next
  607.       only, you will be moved to the point in the file where the
  608.       next match is found and the display will be panned to the
  609.       right or left if necessary to make the matched text
  610.       visible. The actual match will be displayed flashing within
  611.       the highlighted line containing it.
  612.  
  613.       With either option, a message box will alert you if there are
  614.       no (more) matches.
  615.  
  616.       Note  Keep in mind while find-all searches always start at the
  617.             beginning of the file, find-next searches start on the
  618.             line immediately following the last match and go
  619.             forward. For example, if you search for 'BAS' and
  620.             SaveText finds a match on line 35 and then on line 42,
  621.             moving the selector bar back to line 34 will not result
  622.             in the match on line 35 being found again, unless all
  623.             the tags are cleared or a find-all search is made. In
  624.             other words, the starting position for a find-next
  625.             search will not be reset to top-of-file until either the
  626.             end of the file has been reached or a find-all search
  627.             has been made. Also, it does not search for successive
  628.             matches on the same line, since that line is already
  629.             tagged.
  630.  
  631.       On each subsequent search (even when you load a new file),
  632.       your previous settings are retained.
  633.  
  634.  
  635. 4.20  Alt-T : Set tab expansion
  636.       ─────────────────────────
  637.       When SaveText encounters a tab in the input file, it will
  638.       convert it to a series of spaces before displaying it on the
  639.       screen. This option allows you to specify how many spaces are
  640.       to replace each tab, so that the file is displayed as
  641.       faithfully as possible. The minimum value is 1, the maximum 9
  642.       and the default 3. Any invalid values are ignored.
  643.  
  644.       Keep in mind however, that at the present time, SaveText does
  645.       not expand tabs to their actual location - rather, it
  646.       substitutes a specified number of spaces for each tab
  647.       character found. This may cause some inaccuracy of column
  648.       positions in respect to the ruler markings when viewing files
  649.       containing actual tab (ASCII 9) characters.
  650.  
  651.       This feature can be pre-configured through the use of the /T
  652.       command line parameter and/or the STCMD environment variable
  653.       (see Section 6 below).
  654.  
  655.  
  656. 4.21  Alt-V : Video mode
  657.       ──────────────────
  658.       If you have an EGA or better video system, you can display
  659.       more than 23 or 24 lines of the file at a time. Pressing
  660.       [Alt-V] will cycle through the options available to you with
  661.       your equipment. If you invoke a mode with more lines available
  662.       on screen than there are lines in the file, the vertical
  663.       scroll bar will not be displayed. This will occur even in the
  664.       default 25 line mode at startup if the file you are viewing
  665.       contains less than 25 lines. Also, if the file you are viewing
  666.       contains less lines than a particular video mode offers, they
  667.       will be displayed starting at the top of the screen, with a
  668.       blank area below.
  669.  
  670.       ■■ IMPORTANT - If you are using a laptop or notebook computer
  671.          with an LCD screen, it's possible that invoking the 43 or
  672.          50 line mode may result in a blank area at the bottom of
  673.          the screen. This is due to the way these display systems
  674.          implement the EGA/VGA extended-line modes and does not
  675.          indicate a problem.
  676.  
  677.       This feature can be pre-configured through the use of the
  678.       /V:xx command line parameter and/or the STCMD environment
  679.       variable (see Section 6 below).
  680.  
  681.  
  682. 4.22  Esc : Load a new file or quit
  683.       ─────────────────────────────
  684.       Pressing [Esc] will allow you to either load a new file or
  685.       quit SaveText entirely. If you press [Q], SaveText will quit,
  686.       returning you to your original drive and directory. To load
  687.       another file, press [L] and the file requestor will again
  688.       appear.
  689.  
  690.       If before either operation executes there are tagged lines
  691.       that have not yet been saved, you will be asked if you want to
  692.       save them. Press either [Y] or [Enter] to save the file, [N]
  693.       to discard all lines tagged since the last save.
  694.  
  695.  
  696. 4.23  F1 : Help (not shown above)
  697.       ───────────────────────────
  698.       Pressing the [F1] key will pop up a box displaying the major
  699.       functions that are available. Additionally, the status of
  700.       several of the command line parameters is displayed. Press any
  701.       key to remove the box from the screen.
  702.  
  703.  
  704. 4.24  Ctrl-F10 : About SaveText
  705.       ─────────────────────────
  706.       This keystroke will display a small box in the center of the
  707.       screen containing some information about SaveText and the
  708.       system on which it is running.
  709.  
  710.  
  711. 5.0   STATUS LINE DISPLAY
  712. ═══════════════════════════════════════════════════════════════════════════
  713.  
  714. README.TXT  Size:  23876 Lines: 416  │Col: 12 Line: 94   Tags: 17   F1:Help
  715.     │                │           │         │        │          │        │
  716.     │                │           │     Left column  │         Lines     │
  717.     │                │        Lines in              │        Selected   │
  718.     │                │          file           Current line             │
  719.     │              File size                    under the     Help reminder
  720.   Filename         in bytes                     selector bar   (or clock)
  721.  
  722.                                       ├───── Active display elements ─────┤
  723.  
  724.    At the far left of the status line, the name of the file being
  725.    viewed is displayed, without any path information. In addition,
  726.    the size is displayed to its right and then the total number of
  727.    lines in the file.
  728.  
  729.    To the right of a small vertical line are the active display
  730.    elements. First, the current left-most column of the display is
  731.    shown, followed by the currently highlighted line and the number
  732.    of tagged lines. These numbers are updated as position within the
  733.    file changes.
  734.  
  735.    To the far right is a reminder of the Help key, [F1], or the
  736.    clock display, depending on which has been toggled active through
  737.    the [Ctrl-C] key combination.
  738.  
  739.    The status line display can be toggled with a column ruler by
  740.    pressing [Alt-R].
  741.  
  742.  
  743. 6.0   OTHER MISCELLANEOUS DETAILS -
  744. ═══════════════════════════════════════════════════════════════════════════
  745.  
  746. 6.1   Command line parameters
  747.       ───────────────────────
  748.  
  749.       All command line parameters can be entered in either upper,
  750.       lower or mixed case.
  751.  
  752. 6.1a     /N                         (no low ASCII)
  753.          ────────────────────────────────────────────────────────────
  754.          SaveText is designed as a text, not hex file viewer; as a
  755.          result, unpredictable results may occur if you try to view
  756.          files that aren't ASCII text such as many database, word
  757.          processor or spreadsheet files; binary files such as EXE,
  758.          COM & DLL types can get particularly interesting! If you do
  759.          encounter problems with a particular file such as a
  760.          distorted or broken up display, it's likely there are low
  761.          ASCII characters in it and SaveText needs to be started
  762.          with the /N parameter to correctly view the file.  No
  763.          damage will occur, just press Esc and then Q to exit and
  764.          restart SaveText as "ST /N".
  765.  
  766.          The default setting is to not check for low ASCII
  767.          characters (other than ASCII 12 form-feeds and ASCII 9
  768.          tabs) in the interest of increased speed while indexing and
  769.          displaying the input file. However, if you find that a
  770.          majority of the files you view contain some low ASCII
  771.          characters, it may be to your benefit to either specify the
  772.          /N parameter in the STCMD environment variable (see 6.2
  773.          STCMD environment variable below) or create a batch (.BAT)
  774.          file that will automatically start SaveText with the
  775.          correct parameter.   For example:
  776.  
  777.          echo off          REM use "@echo off" with DOS version 3.3
  778.                            REM & later
  779.          c:\utils\st /n    REM use your actual path here
  780.          cd\
  781.  
  782.          This batch file can be named ST.BAT, but if it is, make
  783.          sure you don't have ST.EXE located anywhere in your PATH,
  784.          because if it is, it will be executed directly instead of
  785.          the batch file. Specifying the parameter in STCMD is the
  786.          simpler solution.
  787.  
  788.          For a mild example of the effect of low-ASCII characters in
  789.          a file, start SaveText without the /N parameter and load
  790.          LOWASCII.TXT (included in the STXT130.xxx archive). Then
  791.          look at it again after starting with the parameter.
  792.  
  793.          At any rate, SaveText handles most text files easily, so
  794.          this will probably be unnecessary. If /N has been stored in
  795.          the STCMD environment variable, it can be overridden on a
  796.          session by session basis using /-N.
  797.  
  798.  
  799. 6.1b     /B                         (black & white video)
  800.          ────────────────────────────────────────────────────────────
  801.          This parameter will force monochrome video for better
  802.          legibility when used on a LCD notebook computer or a
  803.          monochrome monitor attached to a color video card. If /B
  804.          has been stored in the STCMD environment variable, it can
  805.          be overridden on a session by session basis using /-B.
  806.  
  807.  
  808. 6.1c     /Q                         (quiet operation)
  809.          ────────────────────────────────────────────────────────────
  810.          Specifying /Q on the command line will suppress all the
  811.          regular beeps and other sounds SaveText normally makes. If
  812.          /Q has been stored in the STCMD environment variable, it
  813.          can be overridden on a session by session basis using /-Q.
  814.  
  815.  
  816. 6.1d     /R                         (ruler at startup)
  817.          ────────────────────────────────────────────────────────────
  818.          If you would prefer to have the ruler displayed when
  819.          SaveText starts, use this parameter.   If /R has been
  820.          stored in the STCMD environment variable, it can be
  821.          overridden on a session by session basis using /-R.
  822.  
  823.  
  824. 6.1e     /C                         (clock at startup)
  825.          ────────────────────────────────────────────────────────────
  826.          Specifying /C on the command line will cause the clock to
  827.          be displayed when SaveText starts, rather than the default
  828.          "F1:Help" prompt. If /C has been stored in the STCMD
  829.          environment variable, it can be overridden on a session by
  830.          session basis using /-C.
  831.  
  832.  
  833. 6.1f     /I:infile.ext              (input filespec)
  834.          (previously /F:)
  835.          ────────────────────────────────────────────────────────────
  836.          By using /I:, you can specify the input file to be loaded.
  837.          A full path is necessary if the file is not in the current
  838.          directory. If SaveText can't find the specified file, the
  839.          file requestor will pop up. If it does find the file, the
  840.          suggested output filename will be displayed normally,
  841.          unless the /O: parameter has been used (see
  842.          below). Unlike previous versions of SaveText, this
  843.          parameter no longer has to be the last one on the command
  844.          line.
  845.  
  846.          /I: is not a valid parameter for the STCMD environment
  847.          variable, and will cause SaveText to abort and display a
  848.          prompt screen illustrating the proper use of the command
  849.          line parameters.
  850.  
  851.          This parameter has been renamed from previous versions of
  852.          SaveText in an attempt to make it a bit more intuitive,
  853.          particularly when combined with the /O: parameter.
  854.  
  855.  
  856. 6.1g     /O:outfile.ext             (output filespec)
  857.          ────────────────────────────────────────────────────────────
  858.          Like /I:, /O: will let you specify a filename from the
  859.          command line; however, this parameter is for the output
  860.          file. If SaveText determines the specified filespec is
  861.          invalid, a box will pop up where you can edit it. If the
  862.          filespec appears to be valid, the input file will be
  863.          immediately loaded and the program will continue.  Also
  864.          like /I:, /O: does not have to be the last parameter on the
  865.          command line.
  866.  
  867.          /O: is not a valid parameter for the STCMD environment
  868.          variable, and will cause SaveText to abort and display a
  869.          prompt screen illustrating the proper use of the command
  870.          line parameters.
  871.  
  872.  
  873. 6.1h     /V:xx                      (startup video mode)
  874.          ────────────────────────────────────────────────────────────
  875.          If you have an EGA or better video system and like to use
  876.          the 43/50 line modes, you can specify them on the command
  877.          line. Replace the xx shown above with either 43 or 50 - if
  878.          you specify 50 with an EGA adapter, it will invoke 43 line
  879.          mode. This parameter has no effect on the [Alt-V] keystroke
  880.          from within the program - it only sets the startup video
  881.          mode. If a value for /V: has been stored in the STCMD
  882.          environment variable, it can be overridden on a session by
  883.          session basis with this parameter - this is really the only
  884.          reason for specifying a value of 25, which is the normal
  885.          default value. If an illegal value is specified, SaveText
  886.          will ignore it and use the default value.
  887.  
  888.  
  889. 6.1i     /T:x                       (startup tab expansion)
  890.          ────────────────────────────────────────────────────────────
  891.          It's possible to specify a startup tab expansion other than
  892.          the default 3 spaces with this parameter. Only one digit
  893.          after the colon is considered and if it's less than 1, then
  894.          the value is set to 1. If a value for /T: has been stored
  895.          in the STCMD environment variable, it can be overridden on a
  896.          session by session basis with this parameter simply be
  897.          specifying a new legal value.
  898.  
  899.  
  900. 6.1j     /PC:x                      (printer setup codes)
  901.          ────────────────────────────────────────────────────────────
  902.          Printers support the changing of their print parameters by
  903.          using a string of ASCII values and the /PC: parameter lets
  904.          you take advantage of this. For example, to specify a 16.66
  905.          cpi font pitch on an HP LaserJet Series II printer, the
  906.          codes are 27 (Esc), 38, 107, 50, 83. You can send these
  907.          codes to your printer through SaveText with this parameter:
  908.  
  909.             /PC:27, 38, 107, 50, 83
  910.  
  911.          It's OK to remove the spaces from between each code, but
  912.          the commas MUST be there in order for this to work
  913.          properly. Also, there can be no characters other than
  914.          commas and numerals in this string. Other than that, what's
  915.          specified here will be sent literally to your printer, so
  916.          make sure it's the correct code for what's desired. Also,
  917.          don't end the string with a comma, just put one between
  918.          each separate code.
  919.  
  920.          This parameter affects only the Alt-P (print tagged lines)
  921.          output feature.
  922.  
  923.  
  924. 6.1k     /PP:x                      (parallel printer port)
  925.          ────────────────────────────────────────────────────────────
  926.          SaveText assumes LPT1 as a default, but if you have a
  927.          printer connected to LPT2, you can specify /PP:2. SaveText
  928.          currently supports only LPT1 and LPT2. If a value for /PP:
  929.          has been stored in the STCMD environment variable, it can
  930.          be overridden on a session by session basis with this
  931.          parameter simply be specifying a new legal value.
  932.  
  933.  
  934. 6.1l     /? or /H or /HELP          (parameter help)
  935.          ────────────────────────────────────────────────────────────
  936.          If /?, /H or /HELP is found on the command line, regardless
  937.          of any other parameters that may also be present, SaveText
  938.          will abort and present a screen outlining all the parameter
  939.          options.
  940.  
  941.          SaveText will ignore all invalid parameters unless they are
  942.          the only ones on the command line. In this event, the
  943.          program will abort and display a screen illustrating
  944.          correct parameter usage.
  945.  
  946.  
  947. 6.2   STCMD Environment variable
  948.       ──────────────────────────
  949.       If you use the /Q, /N, /B, /C, /R, /T:, /PC:, /PP: or /V:
  950.       command line parameters on a regular basis, it's possible to
  951.       assign them to an environment variable, avoiding the necessity
  952.       of typing them manually every time you use SaveText. To do so,
  953.       place the line 'SET STCMD=parameterlist' (without the
  954.       apostrophes, where parameterlist is the parameter{s} you use)
  955.       in your AUTOEXEC.BAT file. If you receive an 'Out of
  956.       environment space' error from DOS after adding this line, you
  957.       probably need to increase your DOS environment size. Consult
  958.       your DOS manual for instructions on how to do this.
  959.  
  960.       Environment variables can be set from the command line, but be
  961.       aware that these settings only last as long as your current
  962.       session, i.e. until you turn off or reboot your computer. To
  963.       erase the STCMD environment variable, type "SET STCMD=" (once
  964.       again without the quotes) and press [Enter].
  965.  
  966.       Even if /Q, /N, /B, /C, /R, /T:, /PC:, /PP: or /V: have been
  967.       specified in STCMD, they can be overridden from the command
  968.       line by (in the case of /V:, /T:, /PC: and /PP:) either
  969.       replacing the value with a new value or (in the case of the
  970.       others) by prefacing the letter of the parameter with a
  971.       hyphen; for example, if /Q is set by STCMD, sound can
  972.       temporarily be re-enabled by using the parameter /-Q after ST
  973.       when the program is started.
  974.  
  975.       All parameters can be specified in either upper, lower or
  976.       mixed case.
  977.  
  978. 6.3   Memory
  979.       ──────
  980.       SaveText will abort if it determines there is insufficient
  981.       memory in which to run. When viewing a very large file, up to
  982.       about 260K of memory may be required, so to be safe, always
  983.       have at least that much memory free before using SaveText.
  984.  
  985.  
  986. 7.0   LEGALITIES
  987. ═══════════════════════════════════════════════════════════════════════════
  988.  
  989.    SaveText has been carefully designed and developed as well as
  990.    undergone exhaustive testing. However, since every possible
  991.    situation and/or use cannot be anticipated, the following legal
  992.    disclaimer is necessary.
  993.  
  994.       SaveText is provided as is, without any type of warranty,
  995.       implicit or otherwise. The author will not be held responsible
  996.       for nor subject to ANY CLAIMS OF ANY SORT arising out of any
  997.       damages resulting from the use of (or lack of ability to use)
  998.       this product. It is intended only for the uses as described in
  999.       its documentation and no other and it's operation is in no way
  1000.       warranted or guaranteed.
  1001.  
  1002.       No files in the SaveText package shall be modified, decompiled
  1003.       or reverse engineered in any way. All archives shall be
  1004.       distributed with all files fully intact and unmodified (a
  1005.       complete list of the files that should be present in the
  1006.       archive file can be found in the text file README.1ST).  Other
  1007.       than a small charge for disk duplication and/or distribution
  1008.       ($10 maximum), SaveText shall be distributed free of charge.
  1009.  
  1010.       SaveText v1.30 (including the program file and all collateral
  1011.       support files) is Copyright (c) 1994 by Len Philpot, 356 Gary
  1012.       K Street, Pineville, Louisiana   71360, All Rights Reserved.
  1013.  
  1014.    In a nutshell . . . use it at your own risk. If it turns your
  1015.    lawn brown, ruins your credit rating or makes your hair fall out,
  1016.    don't say I didn't warn you . . .  :)
  1017.  
  1018.    However, having said this, if you have any questions, suggestions
  1019.    or discover any bugs in this program, please contact the author
  1020.    as indicated in the final section of this document. Every
  1021.    reasonable effort will be made to address any concerns.
  1022.  
  1023.  
  1024. 8.0   REVISION HISTORY
  1025. ═══════════════════════════════════════════════════════════════════════════
  1026.  
  1027. Version 1.00   December 1993
  1028. ────────────────────────────
  1029.                Initial release of SaveText upon a defenseless world.
  1030.  
  1031.  
  1032. Version 1.01   December 1993
  1033. ────────────────────────────
  1034.       Bugs:    While running in black & white video, the screen
  1035.                background could turn white when loading a new file
  1036.                under certain circumstances - Fixed.
  1037.  
  1038.                When a printer port was specified as the output file
  1039.                and the file was to be saved, an 'insufficient disk
  1040.                space' message would erroneously appear - Fixed.
  1041.  
  1042.                Subdirectories with extensions were not being handled
  1043.                correctly in the file requestor - Fixed.
  1044.  
  1045.                When loading a file from a subdirectory with an
  1046.                extension, the output file was being erroneously sent
  1047.                to the root directory - Fixed.
  1048.  
  1049.  
  1050.       Added:   N, L        Next Tagged Line and Last Tagged Line
  1051.                            functions.
  1052.  
  1053.                Current left column and total line elements on status
  1054.                line display.
  1055.  
  1056.  
  1057. Version 1.10   January 1994
  1058. ───────────────────────────
  1059.      Bugs:     Various minor cosmetic inconsistencies - Fixed.
  1060.  
  1061.                Shadow under progress box drawn incorrectly - Fixed.
  1062.  
  1063.                Would sometimes crash when attempting to save a file
  1064.                greater than 32,767 bytes due to a variable
  1065.                misdeclaration - Fixed.
  1066.  
  1067.       Added:   Auto-Resume viewing option
  1068.  
  1069.                Progress indicator while searching
  1070.  
  1071.                Spacebar as well as T tags/untags
  1072.  
  1073.                Various minor cosmetic enhancements
  1074.  
  1075.                Better status reporting during file saves
  1076.  
  1077.                G           Go to line feature
  1078.  
  1079.                Alt-T       Set tab expansion
  1080.  
  1081.       Changed: Several of the filenames in the SaveText archive
  1082.                contained the letters STxxx where xxx was the version
  1083.                number. That pattern has now been changed to STXTxxx
  1084.                to avoid confusion with other packages using the ST
  1085.                abbreviation.
  1086.  
  1087.  
  1088. Version 1.20   March 1994
  1089. ─────────────────────────
  1090.       Bugs:    Fixed some *very* minor cosmetic bugs dealing with
  1091.                colors.
  1092.  
  1093.                An extra backslash would be placed in the output
  1094.                filespec path if logged onto a different drive than
  1095.                the one ST was executing from and a path wasn't
  1096.                specified - Fixed.
  1097.  
  1098.       Added:   Added cosmetic filler to the blank area under the
  1099.                file status box when retrieving a file in 43/50 line
  1100.                mode (fancy, eh? :)
  1101.  
  1102.                I           Invert tags feature
  1103.  
  1104.                /Q          Quiet mode line parameter
  1105.  
  1106.                /F:         Input filename parameter
  1107.  
  1108.                InHalf was added to the SaveText package
  1109.  
  1110.       Changed: New color scheme! This one is much easier on the
  1111.                eyes!
  1112.  
  1113.                Revised the placement of the selector bar after a
  1114.                Goto Line, Search, Next/Last Tag and Auto-Resume to
  1115.                be a bit more naturally placed
  1116.  
  1117.                Made Ctrl-Home and Ctrl-End duplicate Home-End when a
  1118.                'narrow' file is loaded instead of simply disabling
  1119.                them
  1120.  
  1121.  
  1122. Version 1.3    July 1994
  1123. ────────────────────────
  1124.       Bugs:    On large drives, freespace was not being reported
  1125.                correctly; Thanks to Ed Tobin for pointing this
  1126.                out - Fixed.
  1127.  
  1128.                When viewing a file less than one screen deep, the
  1129.                bottom unused portion of the screen would remain
  1130.                black after a DOS shell - Fixed.
  1131.  
  1132.                After performing a find-all search, the selector bar
  1133.                would be visible on screen even when it should have
  1134.                been hidden (Alt-H) - Fixed.
  1135.  
  1136.                Known bug:  On some (not all) files with a last
  1137.                            modification time falling between 12:00
  1138.                            midnight and 1:00 am, the time may not be
  1139.                            interpreted correctly in the file
  1140.                            requestor display. This is a display bug
  1141.                            only and does not affect operation or the
  1142.                            file in question.
  1143.  
  1144.                The "not-really-a-bug-but-it's-fixed" department:
  1145.                   If a program executed previously to SaveText had
  1146.                   enabled high-intensity background colors and had
  1147.                   not reset them back to low-intensity/blinking
  1148.                   foreground colors (the DOS default), SaveText would
  1149.                   display these high-intensity colors under certain
  1150.                   circumstances (a bit ugly in places). This is now
  1151.                   anticipated by SaveText and corrected if necessary.
  1152.  
  1153.       Added:   Alt-A       Search-again
  1154.  
  1155.                Alt-B, F    Tag all lines up to/from current line
  1156.  
  1157.                Ctrl-B, F   Clear all lines up to/from current line
  1158.  
  1159.                Ctrl-C      Screen clock (toggle)
  1160.  
  1161.                Alt-E       Eject page from printer
  1162.  
  1163.                Alt-R       Screen ruler display (toggle)
  1164.  
  1165.                Alt-H       Hide selector bar (toggle)
  1166.  
  1167.                Alt-P       Print tagged lines
  1168.  
  1169.                Alt-Q       Quiet mode (toggle)
  1170.  
  1171.                /O:         Output filespec parameter
  1172.  
  1173.                /V:         Startup video mode parameter
  1174.  
  1175.                /T:         Startup tab expansion parameter
  1176.  
  1177.                /PC:        Printer setup codes parameter
  1178.  
  1179.                /PP:        Parallel printer port parameter
  1180.  
  1181.                /R          Startup ruler toggle parameter
  1182.  
  1183.                /C          Startup clock toggle parameter
  1184.  
  1185.                /? /H /HELP Help (on) parameters
  1186.  
  1187.                Ctrl/F10    About box
  1188.  
  1189.                Enter key now duplicates PgDn key function
  1190.  
  1191.                Support for the STCMD environment variable and
  1192.                disable option (/-X) for suspending STCMD settings
  1193.  
  1194.                (Command line parameter) status reporting on Help
  1195.                screen
  1196.  
  1197.                File date and time display to file requestor
  1198.  
  1199.                UNIX2DOS was added to the SaveText package
  1200.  
  1201.                ASC2TXT was added to the SaveText package
  1202.  
  1203.       Changed: /F: renamed to /I: (input filespec parameter)
  1204.  
  1205.                Remapped Home, End, Ctrl-PgUp, Ctrl-PgDn keys (see
  1206.                above)
  1207.  
  1208.                The default settings for a search are now case
  1209.                insensitive, find all. Also, any changes made to
  1210.                these settings are now retained across subsequent
  1211.                searches and files, until reset.
  1212.  
  1213.                The maximum number of lines in the input file has now
  1214.                been doubled, raised from 16,384 to 32,766.
  1215.  
  1216.  
  1217. 9.0   ONE FINAL NOTE
  1218. ═══════════════════════════════════════════════════════════════════════════
  1219.  
  1220.    Writing SaveText has been great learning experience for me, since
  1221.    it's my first real program to any degree. In view of this, I'm
  1222.    not going to require any registration, cripple or add nag screens
  1223.    to the program for at least this major version (1.x). However, a
  1224.    $15 donation would be appreciated if you find it useful and
  1225.    continue to use it.
  1226.  
  1227.    Registration is only needed once, since whatever upgrades that come
  1228.    down the pike will be free. A registration form is provided for
  1229.    your convenience in the file REGISTER.DOC. If you desire, I can
  1230.    be contacted on the RIME Q-Basic Conference or at the PUMA
  1231.    Wildcat BBS, RIME Site 1026, (318) 443-1065. I also maintain an
  1232.    InterNet address - lphilpot@pumabbs.com
  1233.  
  1234.    The latest version of SaveText can always be found on these fine
  1235.    Bulletin Board Systems:
  1236.  
  1237.    Puma Wildcat! BBS                         (318) 443-1065
  1238.       Chuck McMillin, Sysop
  1239.  
  1240.    LAVET Louisiana Veteran's Sound Off BBS   (318) 449-1012
  1241.       Bob Wieters, Sysop
  1242.  
  1243.    The Programmer's Mark BBS                 (718) 921-9267
  1244.       Joe Negron, Sysop
  1245.       Note hours: Every night                10pm to 6am (ET)
  1246.                   also Saturday & Sunday     6am to 1pm (ET)
  1247.  
  1248.    Special thanks go to Jim Woodruff for all his help in writing
  1249.    this and many other educational things as well. Also thanks to
  1250.    the participants of the RIME Q-Basic conference for all the
  1251.    useful advice available there.
  1252.  
  1253.    And a big Thanks to my wife, Annette, for putting up with me and
  1254.    my lack of attention to her during the process of writing and
  1255.    improving SaveText!
  1256.  
  1257.    Thanks for trying SaveText and have fun!
  1258.  
  1259.  
  1260.    Len A. Philpot
  1261.    356 Gary K. Street
  1262.    Pineville, LA   71360
  1263.    (318) 445-1704 after 6 p.m.
  1264.