PCjs Machines

Home of the original IBM PC emulator for browsers.


PC-SIG Diskette Library (Disk #181)

[PCjs Machine "ibm5170"]

Waiting for machine "ibm5170" to load....

Information about “NEWKEY”

NEWKEY keyboard enhancer simplifies the entry of common keystroke
sequences by letting you assign these sequences to any key desired.
Once assigned to a particular key, whenever that key is struck the
predefined sequence of keystrokes are returned.  For example, the Alt-C
key combination might be defined as ``copy'' and whenever you strike
Alt-C, the string ``copy'' is displayed.

NEWKEY lets you customize software packages, readily create boiler plate
passages, redefine your keyboard, and perform other useful tasks. You
can even redefine your keyboard to the DVORAK keyboard if you wish.
Several sample key definition files are included.

NEWKEY provides many features, including:

~ Ability to define almost any key

~ Menu macros

~ Display macros

~ Fixed-length pauses during key translation

~ Nested key translation

~ Translation bypass for native entry of defined key

~ Dynamic display of the macro directory

~ Dynamic display of macros

~ Full-featured macro editor

~ Easy change of any macro

~ Ability to copy/move one macro to another

~ Ability to move keyboard buffer into macro

~ Ability to load, merge, and save macro files from within other

~ Screen blanker

~ Dynamic modification of the control keys

~ Dynamic clear macros from memory

~ User-defined dynamic define area length

~ Time delay pauses during key translation

~ Ability to toggle NEWKEY on/off

~ Slow typing mode

~ 128 keystroke type-ahead buffer

~ Ability to speed up keyboard repetition rate

~ Improved macro definition facilities

~ And much more.


║                    <<<<  Disk #181 NEWKEY  >>>>                         ║
║ To print the documentation, type:                                       ║
║                    COPY NEWKEY.DOC PRN   (press enter)                  ║
║                    COPY README PRN       (press enter)                  ║
║                                                                         ║
║ To start the program, type: NEWKEY (press enter)                        ║
║                                                                         ║
║ To start the program demo, type: DEMO (press enter)                     ║
(c)Copyright 1990, PC-SIG Inc.


                              EVALUATION GUIDE
                          A Keyboard Enhancer for
                         The IBM Personal Computer
                                Version 5.4
                   (C)Copyright Frank A. Bell, 1984-1990
                            All rights reserved.
                                 Frank Bell
                          Compuserve id 75206,1366
    FAB Software
    P.O. Box 336
    Wayland, MA 01778

    Copyright (C) 1984-1990 by Frank A. Bell.  All rights reserved.  
    The Newkey 5.4 programs may be copied subject to the restrictions 
    listed in 'Permission to Copy'.  
    This documentation is designed to accompany the Newkey evaluation disk 
    and does not fully document Newkey and its features.  The latest 
    version of Newkey, a printed manual, plus other benefits come with 
    Newkey when ordered.  For further information refer to the section on 
    registration later in this documentation.  
    If any portion of the evaluation disk is missing, a complete 
    evaluation disk is available for $10.  Use the order form at the end 
    of this documentation.  Please do not send disks.  

                                TABLE OF CONTENTS
    NEWKEY INTRODUCTION.......................................... 1
    PRINTING THE NEWKEY MANUAL................................... 2
    TAKING A GUIDED TOUR OF NEWKEY............................... 3
    THE USER-SUPPORTED CONCEPT................................... 3
    RESTRICTED PERMISSION TO COPY................................ 4
    FILES ON THE NEWKEY DISK..................................... 5
    LIMITED WARRANTY............................................. 6
    REGISTRATION................................................. 7
    ORDER FORM................................................... 8

                              NEWKEY INTRODUCTION
    We believe that at $43.00, $20 - $250 below comparable commercial 
    programs, Newkey is one of the great bargains on the market today.  
    How many high quality, useful software programs can be purchased for 
    $43?  We hope that after you have had a chance to try out Newkey for 
    yourself you agree and decide to become a reqistered user.  
    The Newkey keyboard enhancer simplifies the entry of common keystroke 
    sequences by allowing these sequences to be assigned to any key 
    desired.  Once assigned to a particular key, whenever that key is 
    struck the predefined sequence of keystrokes will be returned in place 
    of the struck key.  For example, the alt c key might be defined as 
    'copy' and whenever alt c is struck the string 'copy' will be 
    Newkey allows customization of software packages, ready creation of 
    boiler plate passages, help menus, keyboard redefinition, cursor speed 
    up, screen blanker, extended keyboard buffer, and other useful 
    purposes.  Several sample key definition files are included with 
    Newkey and will be described later.  
    Newkey 5.4 provides many features including:
    - Ability to define almost any key
    - Menu macros
    - Display macros
    - Fixed length pauses during key translation
    - Nested key translation
    - Translation bypass for native entry of defined key
    - Dynamic display of the macro directory
    - Dynamic display of macros
    - Full featured macro editor
      - Easily change any macro
      - Copy/Move one macro to another
      - Move keyboard buffer into macro
    - Load, merge and save macro files from within other applications
    - Shorthand mode, Newkey watches your keystrokes and when they
    match a macro name, automatically plays back the macro.  No
    special hot key to enter, no wasted keystrokes.
     - Date/time macro function, define your own date & time templates
    and let Newkey fill them in for you
    - Fast key option allows fast cursor movement and key repetition
    - Use Newkey's pop-up features in graphics mode
    - Compatible with new IBM's new 'enhanced keyboard'
    - Guard macros from accidental deletion
    - Inactivate macros
    - Save/load file overwrite warning messages
    - Disk wait during macro playback
    - Screen on/off macro function
    - Enhanced compatibility with other programs
    - Suppress Newkey created keycodes which collide with other program
    - Keyboard click
    - Beep during macro definition
    - Cursor change during macro definition/playback made optional

    - Customize Newkey's menu colors
    - Screen blanker works with EGA
    - Dynamic modification of the control keys
    - Dynamic clear macros from memory
    - User defined dynamic define area length
    - Time delay pauses during key translation
    - Toggle Newkey on/off
    - Slow typing mode
    - Cancel Newkey processing at any time during playback or definition
    - Macro may call itself
    - Screen saver feature to blank screen after period of inactivity
    - Ability to define a macro within a macro
    - Multi-character macro names
    - Improved screen saver that works with most hardware and software
    - Macro descriptions
    - 128 keystroke typeahead buffer
    - Speed up keyboard repetition rate
    - Improved macro definition facilities, including
       - Defining status line
       - Macro already defined warning message
       - Defining alphabetic character warning message
       - Display/execute macro commands from menus as well as
         from control keys
       - Macro definition window
    - Call Newkey from its own macros
    - Cut & paste
    - Support for DOS 2.0 path names
    - and many more
    Newkeysp 5.4, the Newkey support program, provides many functions 
    - Saving macros to disk from memory
    - Loading macros from disk to memory
    - Merging macros from disk to memory
    - Directory display of keys with translations
    - Individual display of key translations
    - Easy modification of Newkey control keys
    - Clear macros from memory
    - Toggle Newkey on/off
    - Execute macros from a batch file
    - Unload and reclaim memory under DOS 2.0
    - Be called from Newkey macros
    - Display macros and their descriptions
                     PRINTING THE NEWKEY MANUAL
    If you wish you may print the full Newkey manual (assuming it's on 
    your disk, which it may not be) by issuing the following command: 
          copy newkey.man lpt1
    The manual is about 100 pages long.

                     TAKING A GUIDED TOUR OF NEWKEY
    The guided tour demonstrates many of Newkey 5.4's major features and 
    uses Newkey macros extensively.  To start the guided tour type 'demo' 
    at the DOS command prompt and press enter.  The demo will load Newkey, 
    load the demo.key macro file, and start the tour.  
                         THE USER-SUPPORTED CONCEPT
                         User-supported Software
    User-supported software (also known as "shareware") is an experiment 
    in distributing computer programs based on these beliefs: 
    1.  That the value and utility of software is best assessed by the 
        user on his/her own system.  
    2.  That the creation of personal computer software can and should be 
        supported by the computing community.  
    3.  That copying of programs should be encouraged, rather than 
    Anyone may legally obtain an evaluation copy of the program from a 
    friend or computer club.  After you have had a chance to use and 
    evaluate the program in your own environment, you are trusted to 
    either forward a payment to FAB Software or to discontinue use of the 
    Free distribution of software eliminates costs for advertising and 
    copy protection schemes.  Users obtain quality software at greatly 
    reduced cost.  They can try it out before buying, and do so at their 
    own pace and in the comfort of their own home or office.  The best 
    programs will survive, based purely on their quality and usefulness.  
    With an acknowledgement to Eric Isaacson, author of A86, on whose 
    documentation this next question and answer is based, we offer this to 
    those of you who have purchased Newkey from a disk vendor.  
    QUESTION:  "I bought this macro processor from XYZ software House, 
    that advertised great software for $5 per disk.  What's going on here?  
    Have I already bought a macro processor, or what?" 
    ANSWER:  Well, no, not exactly.  You've bought a disk that has great 
    software on it; you haven't bought the software yet.  Newkey, like the 
    vast majority of software offered by the $5 per disk distribution 
    houses, is free-distribution software, also known as "shareware", or 
    "user-supported software".  That means I retain the right to Newkey, 
    but I choose to let people pass it around.  I have no business 
    relationship with any distribution houses.  I don't get a penny of the 
    $5 (or whatever) you paid them for the disk containing Newkey.  So I 
    need and expect to be paid by you, because I'm trying to make a living 
    out of making and supporting shareware products.  

    Many distribution houses do a poor job of revealing the shareware 
    nature of the software they sell.  If you thought you had purchased 
    the software free and clear, you might feel justified in being angry 
    with them for having misled you.  And you might look around for houses 
    that do a better job of informing the public.  But I hope you'll take 
    the time to consider everybody's role in the shareware marketing 
    scheme.  If you do, I think you'll conclude that although you may have 
    been misled, you haven't really been cheated out of anything.  
    Shareware is great for authors like me who haven't got the resources 
    to run expensive ad campaigns.  We simply cast our programs to the 
    winds.  They are distributed at pracically no cost to us.  That's why 
    we can charge a lot less than the cost of "commercial" software.  
    Shareware is also great for customers like you.  You can try out the 
    software before paying for it.  You'll know that a successful 
    shareware product is good, because only satisfied customers pay for 
    it.  The existence of shareware infuses healthy competition in the 
    entire software market, for both price and quality.  
    Finally, let's consider the distribution houses.  They provide a 
    legitimate service, for which they charge a reasonable price. The best 
    houses act as librarians, evaluating and cataloguing software.  Most 
    pay thousands of dollars for advertising. Their cut is far less than 
    the distributor's cut for "commercial" software (they prosper because 
    their volume is bigger).  Most customers for the distribution houses 
    are repeat customers, who are aware of, and happy with, what they are 
    getting.  If it weren't for your XYZ House, you might never have heard 
    of Newkey, or might never have figured out where to obtain it.  
    So I hope you'll be happy with shareware, and actively desire to 
    support it.  You'll feel good about promoting a healthy situation for 
    everybody.  And you'll encourage the best programmers in the world to 
    keep writing for you, instead of for the big corporations.  
    What May be Copied
    All files on the Newkey disk may be copied.
    Rules For Copying 
    Individuals are granted permission to freely copy the Newkey disk for 
    their own evaluation or for others to evaluate, so long as no price or 
    other consideration is charged.  
    Computer clubs and other non-profit organizations are granted 
    permission to freely copy the Newkey disk and share it with their 
    members for the purposes of evaluation, so long as: 
    1.  No price or other consideration is charged.  However, a 
    distribution cost may be charged for the  cost of the diskette, so 
    long as it is not more than US $10 total.  This includes shipping, 
    handling, and all other charges.  

    2.  Club members who receive the programs are informed in writing of 
    the user-supported concept and encouraged to support it with their 
    3.  The programs and documentation are not modified in any way and are 
    distributed together.  
    4.  The Newkey disk may not be packaged together with any other 
    programs or materials.  It may not be bundled and sold as part of some 
    other more inclusive package.  
    5.  The programs may not be "rented" to others.
    6.  The printed manual is not copied or reproduced in any way.
    Companies, schools, universities, government, and other organizations 
    are granted permission to copy the Newkey programs for use on other 
    computers and at other locations in the company, so long as: 
    1.  The full registration fee of $43 has been paid for each and every 
    system on which the program will be used.  
    2.  The printed manual is not copied or reproduced in any way.
    Corporate licenses and volume discounts are available upon request.  
                       FILES ON THE NEWKEY DISK
    The following files should be on the Newkey evaluation disk.  If any 
    are missing on the copy you have, a complete evaluation copy may be 
    obtained from FAB Software for $10.  Use the order form at the end of 
    this documentation.  Please do not send disks.  
    DEMO.BAT - This is a batch file which will give you a demonstration of 
    Newkey.  It requires 192k of memory.  
    DEMO.KEY - Macro file containing Newkey tour.
    DVORAK.KEY - Macro file to redefine keyboard under Dvorak layout.
    EXAMPLE.BAT - Examples of NEWKEYSP usage.
    EXAMPLE.KEY - Examples of newkey macros.
    NEWKEY.DOC - Documentation which will introduce unregistered users to 
    Newkey.  To print it, "copy Newkey.doc lpt1".  
    NEWKEY.EXE - This is the program which actually replaces IBM's 
    keyboard interrupts (x'9' and x'16').  This program remains resident 
    while other programs execute and unless called upon to translate will 
    be transparent.  
    NEWKEY.MAN - This is the complete Newkey manual.  It is approximately 
    100 pages long and may be printed by issuing the following command: 
     copy newkey.man lpt1
    *** NOTE, due to space considerations, the manual is not on the disk 

    registered user's receive, thus it may not be on your disk if you 
    received it from a registered user.  
    NEWKEYSM.EXE - This is the small version of Newkey.exe.  It is 
    identical to the regular version, except that it lacks the pop-up 
    features and takes about 25K less memory.  *** NOTE, due to space 
    considerations this version may not be on your distribution disk.  It 
    is supported and will be on the disk you receive when you register.  
    NEWKEYSP.EXE - This program provides several functions necessary to 
    effectively use Newkey.  
    NEWKEYVS.EXE - This is the very small version of Newkey.exe.  It is 
    identical to the regular version, except that it lacks the pop-up 
    features and several other features.  It takes substantially less 
    memory.  *** NOTE, due to space considerations this version may not be 
    on your distribution disk.  It is supported and will be on the disk 
    you receive when you register.  
    README - Latest information on Newkey
    VENDOR.DOC - Distribution information for disk vendors.
                             LIMITED WARRANTY
    These programs are provided "as is" without warranty of any kind, 
    either expressed or implied, including, but not limited to the implied 
    warranties of merchantability and fitness for a particular purpose.  
    The entire risk as to the quality and performance fo the program is 
    with you.  Should the program prove defective, you (and not FAB 
    Software or its dealers) assume the entire cost of all necessary 
    servicing, repair or correction.  
    In no event will the FAB Software be liable to you for any damages, 
    including any lost profits, lost savings or other incidental or 
    consequential damages arising out of the use of or inability to use 
    these programs, even if the FAB Software has been advised of the 
    possibility of such damages, or for any claim by any other party.  

    To register as an official Newkey user complete the order form on the 
    next page and send to FAB Software.  As a registered user you will 
       - The latest version of Newkey
       - A version which does not display the evaluation notice screen.
       - A printed manual (92 pages, tips on use, index)
       - Telephone and written support
       - Notification of new versions
    As a FAB Software customer you will be entitled to a free introductory 
    membership to CompuServe!  Upon registration you will receive 
    information on how to order your free membership which includes: 
    - A private User ID number and password
    - $15.00 Introductory usage credit (over 1 hr of connect time on a 
      1200-baud modem)
    - A complimentary subscription to ONLINE TODAY, Compuserve's computing 
      magazine, published monthly 
    Best of all there is no annual fee or minimum monthly charge, you pay 
    only for the time you use.  Discontinue at any time.  
    As a member of CompuServe Information Service you will be able to tap 
    into hundreds of information resources, including personal computer 
    forums, electronic mail service with CompuServe subscribers around the 
    world, financial data, and much, much more.  
    Use CompuServe to get in touch with the author of DvorakKB via 
    electronic mail (CIS ID:  75206,1366) with your questions, comments, 
    and suggestions.  
    This offer is limited to first time CompuServe subscribers.  One per 
    customer.  This is a limited-time offer and may be withdrawn at any 
    time without prior notice.  

                                ORDER FORM
    FAB Software                     FED ID# 04-2861400
    P.O. Box 336                     (508) 358-6357
    Wayland, MA 01778
                                             PRICE       PRICE
    PRODUCT                         QTY      EACH       EXTENDED
    -----------------------------   ---      -----      --------
    Newkey 5.4
      Quantity   1 to  5            ___      $43.00     $_______
      Quantity   6 to  9            ___      $34.40     $_______
      Quantity  10 to 49            ___      $32.25     $_______
      Quantity  50 to 99            ___      $30.10     $_______
      Quantity 100+                 ___      $27.95     $_______
    Newkey Labels (see next page for description, must 
      be accompanied by purchase of full registered version)
      Quantity  10 to  24           ___      $14.00     $_______
      Quantity  25 to  99           ___      $12.50     $_______
      Quantity 100 to 249           ___      $11.00     $_______
      Quantity 250 to 499           ___      $ 9.00     $_______
      Quantity 500 to 999           ___      $ 7.00     $_______
      Quantity 1000+                ___      $ 5.00     $_______
    Newkey Evaluation disk          ___      $10.00     $_______
    Purchase Order (invoice required)         $7.00     $_______
    Foreign orders, except Canada, add(*)     $7.00     $_______
                                            SUBTOTAL    $_______
    Massachusetts sales tax (5%) (MA residents only)    $_______
                                             TOTAL      $_______
    Name: _________________________________Phone:________________
    Address: ____________________________________________________
    City, State, Zip: ___________________________________________
    Where did you learn about Newkey?____________________________
    Visa [ ]  MasterCard [ ]  Check [ ] (U. S. funds)
    Card# ______________________________________
    Expiration Date ____________________________
    Signature __________________________________
    Prices subject to change without notice.
    * Foreign orders paid by check must be in US $ and drawn through a US 
    bank or through the US branch of a foreign bank.  

                               NEWKEY LABELS
    Newkey labels are the disk labels that normally come on the Newkey 
    disk.  Each label confers the same rights to use the Newkey program 
    that purchasing the full Newkey package does subject to the following 
    - Labels do NOT confer the right to copy the Newkey manual or other 
    printed documentation that may be distributed with the registered 
    - All support for users of the labeled versions must be made through 
    users of the fully registered version.  Users of the labeled versions 
    are not entitled to support from FAB Software.  
    The minimum order quantity for labels is 10.  
    The purchaser is responsible for making his own Newkey disk and 
    attaching the label to it.  If the purchaser does not wish to 
    physically attach the label to the disk on which Newkey is 
    distributed, then it may be placed on any accompanying documentation 
    (perhaps on the rear cover of the DOS manual, for example).  Any 
    reasonable method which effectively uses a Newkey label for each copy 
    distributed may be used.  
    Labels are intended to be used in a value added manner.  Usually this 
    means that it is not even necessary that the user realize that Newkey 
    is present.  The user just knows that when a certain key is pressed, a 
    certain action will occur.  In this manner, Newkey can be used to 
    automate command sequences, build help menus, and in general to build 
    a more friendly, easy-to-use interface to the underlying software 
    system being provided to the user.  

Directory of PC-SIG Library Disk #0181

 Volume in drive A has no label
 Directory of A:\

NEWKEY   MAN    152208   1-15-89   4:04p
DEMO     BAT       526  11-09-88   8:55p
DEMO     KEY     18181  11-27-88   9:29p
DVORAK   KEY      1930  11-09-88   8:58p
EXAMPLE  KEY     12701  10-27-90   7:17p
EXAMPLE  BAT      1445   1-24-89  10:58p
LOADNEW  BAT       312   7-01-90   4:05p
NEWKEY   EXE     64862  12-08-90   3:43p
NEWKEY   DOC     24739  10-27-90   8:13p
NEWKEYSP EXE     44206  12-08-90   3:44p
ORDER    FRM      4355  10-27-90   8:14p
README           16729  10-27-90   7:12p
MENU     KEY       928   8-30-88   9:40a
GO       BAT        38   8-03-87   2:24p
GO       TXT       882   1-01-80   3:18a
       15 file(s)     344042 bytes
                       10240 bytes free