home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 19 / CD_ASCQ_19_010295.iso / vrac / ram10.zip / RAM.DOC < prev    next >
Text File  |  1994-10-21  |  18KB  |  425 lines
  1.     
  2.     
  3.     
  4.     
  5.     
  6.     
  7.     
  8.     
  9.     
  10.     
  11.     
  12.     
  13.     
  14.     
  15.     
  16.     
  17.     
  18.     
  19.                               Read-A-Matic v1.0
  20.     
  21.     
  22.                Copyright 1994, M.L. Wester  All rights reserved.
  23.     
  24.                                Route #6 Box 34
  25.                            Fuquay-Varina, NC 26527
  26.                                  919-552-0767
  27.     
  28.     
  29.     
  30.     
  31.      INTRODUCTION
  32.     
  33.           Read-A-Matic is being distributed as Shareware.  Be sure to read
  34.     the license agreement at the end of this document or in the ORDER.FRM
  35.     file.
  36.     
  37.           Read-A-Matic is an easy to use utility that turns ordinary ASCII
  38.     text files into powerful EXE files.  The EXE's text can be scrolled,
  39.     searched or printed to any port or files.  You can also embed simple
  40.     codes in the text that change colors, attach jumps to the 12 function
  41.     keys or "stuff" the keyboard buffer with commands that execute
  42.     programs or batch files when the README.EXE is exited.
  43.      The Association of Shareware Professionals
  44.     
  45.                            _______
  46.                       ____|__     |               (R)
  47.                    --|       |    |-------------------
  48.                      |   ____|__  |  Association of
  49.                      |  |       |_|  Shareware
  50.                      |__|   o   |    Professionals
  51.                    -----|   |   |---------------------
  52.                         |___|___|    MEMBER
  53.     
  54.     
  55.           Michael L. Wester is a member of the Association of Shareware
  56.     Professionals (ASP).  The ASP wants to make sure that the shareware
  57.     principle works for you.  If you are unable to resolve a shareware-
  58.     related problem with an ASP member by contacting the member directly,
  59.     ASP may be able to help. The ASP Ombudsman can help you resolve a
  60.     dispute or problem with an ASP member, but does not provide technical
  61.     support for members' products.  Please write to the ASP Ombudsman at
  62.     545 Grover Road, Muskegon, MI 49442-9427 USA, FAX 616-788-2765 or
  63.     send a CompuServe message via CompuServe Mail to ASP Ombudsman
  64.     70007,3536.
  65.     
  66.     
  67.     SHAREWARE
  68.     
  69.           The Read-A-Matic program is being marketed using the shareware
  70.     method.  This means you are encouraged to share copies of the
  71.     unregistered version for evaluation purposes.  If you wish to use the
  72.     Read-A-Matic EXE file you are required to register with the author.
  73.     Please read the futher explanation of shareware and the copyright
  74.     notice near the end of this document.
  75.     
  76.      VENDOR INFORMATION
  77.     
  78.     One Line Description
  79.     
  80.           Read-A-Matic - Turn text into powerful EXE programs.
  81.     
  82.     Long Description
  83.     
  84.           Read-A-Matic is an easy to use utility that turns ordinary ASCII
  85.     text files into powerful README.EXE files. (You can name them
  86.     whatever you like.)  The executable text can be scrolled, searched
  87.     and printed. Text colors can be changed throughout the file and a
  88.     range of text can be displayed whenever any of the 12 function keys
  89.     are pressed.  Function keys can also "stuff" the keyboard buffer
  90.     allowing your README to automatically execute a batch file or
  91.     program.  The README.EXE can also be called with parameters that
  92.     cause it to display only selected text.  Creating the EXE is
  93.     extremely easy and completely menu driven with full mouse support.
  94.     
  95.           Registration includes a royalty-free license to create
  96.     README.EXEs that display YOUR copyright... and it's only $15.00.
  97.     
  98.     
  99.     
  100.     DISTRIBUTION POLICY
  101.     
  102.           ASP vendor members in good standing are automatically given
  103.     permission to distribute Read-A-Matic.  Non-ASP vendors are asked to
  104.     send notification that you are including my program in your
  105.     collection.  I do not require Non-ASP vendors to send copies of their
  106.     catalogs or meet any specific standards but as I spot check vendors
  107.     to examine their distribution methods, I do reserve the right to
  108.     prohibit distribution.
  109.      PROGRAM FEATURES
  110.     
  111.     *     The setup program is extremely easy to use, requiring only a
  112.           filename.
  113.     
  114.     *     Turns standard ASCII text into powerful EXE files.
  115.     
  116.     *     Can handle text files up to approximately 200k.
  117.     
  118.     *     Text EXE files can be searched for multiple occurances of a word
  119.           or phrase.
  120.     
  121.     *     Text can be printed to any printer port or to a DOS file.
  122.     
  123.     *     Text can contain multiple colors.
  124.     
  125.     *     Actions can be assigned to the 12 function keys.  Either a range
  126.           of text can be displayed or printed or, a function key can be
  127.           used to "stuff" the keyboard buffer with a command that executes
  128.           immediately as the README.EXE is exited.
  129.     
  130.     *     Using command line parameters the README.EXE can be called to
  131.           display a range of text.
  132.      INSTALLATION
  133.     
  134.           Installing Read-A-Matic is as simple as copying all the files to
  135.     a subdirectory on your hard drive.  A simple INSTALL program has been
  136.     included to perform this task.  (Note: Read-A-Matic must be executed
  137.     from the directory it is installed in so it can find it's files.)
  138.     
  139.     
  140.     CREATING A READ-A-MATIC README.EXE
  141.     
  142.     Step 1.     Start Read-A-Matic by typing RAM then pressing ENTER.
  143.     
  144.     Step 2.     Enter the name of the text file to make an EXE.  The
  145.                 existing text file will not be changed. (Note: The text
  146.                 file must reside in the same directory as Read-A-Matic or
  147.                 you must supply a path to it's location.
  148.     
  149.     Step 3.     If you wish to accept the defaults, click Make EXE then
  150.                 exit Read-A-Matic.
  151.     
  152.     Step 5.     Type README then press ENTER.
  153.     
  154.           This will make a README.EXE using the README's current path as
  155.     the heading.
  156.     
  157.     
  158.     READ-A-MATIC OPTIONS
  159.     
  160.     File To Convert:        This is the field in which you enter the name of
  161.                             the ASCII (plain) text file you wish to make and
  162.                             EXE file.  You may optionally include a drive and
  163.                             path.
  164.     
  165.     EXE Filename:           This field contains the name for the new
  166.                             README.EXE.  You can name your executable text
  167.                             file anything you like.  You can even rename it
  168.                             after it has been created.
  169.     
  170.     Title:                  The text entered in this field will be displayed
  171.                             as the header on the top line of the README.EXE.
  172.                             If you leave this field blank the README.EXE will
  173.                             display it's current path and filename when it is
  174.                             run.
  175.     
  176.     Make EXE:               This button starts the EXE creation process.
  177.     
  178.     Exit:                   Exit will exit Read-A-Matic and return to DOS.
  179.     
  180.     Help:                   The Help button displays a simple help screen
  181.                             that explains each option.
  182.     
  183.      ADDING COLORS AND FUNCTION KEY OPERATIONS
  184.     
  185.           Using very simple "flags" you can add colors and function key
  186.     jumps to your text files.  These flags will not be displayed or
  187.     printed when the EXE is run.
  188.     
  189.     Adding Colors
  190.     
  191.           Colors are added by turning on a color.  Once a color is "turned
  192.     on" it will continue until it is changed.  Colors are added by
  193.     placing the ~ character as the first character on a line, followed by
  194.     a color code.
  195.     
  196.     For example: ~31 would make the text white on a blue background.
  197.     
  198.           Colors are determined by using the following color codes to set
  199.     the screens background and foreground colors.  You can even set
  200.     flashing colors although it is not recommended.  (Most people find
  201.     continuously flashing text annoying.)
  202.     
  203.           To select a color you must first choose the background color
  204.     code then add the foreground color code to it.  For example: The
  205.     color code for a blue background ranges from 16 to 31.  To create a
  206.     blue back-ground with white text you would add 15 (The foreground
  207.     code for white) to 16 (The background code for blue) making a color
  208.     code of 31. If you wanted a blue background with yellow text you
  209.     would add 16 (The color code for blue.) and 14 (The color code for
  210.     yellow.) for a total of 30.
  211.     
  212.     BACKGROUND COLOR with FOREGROUND...      FOREGROUND COLOR...
  213.     
  214.     CODE           COLOR        ATTRIBUTE    CODE          COLOR
  215.     ----           -----        ---------    ----          -----
  216.       0 ---------- Black ------ Normal        0 ---------- Black
  217.      16 ---------- Blue ------- Normal        1 ---------- Blue
  218.      32 ---------- Green ------ Normal        2 ---------- Green
  219.      48 ---------- Cyan ------- Normal        3 ---------- Cyan
  220.      64 ---------- Red -------- Normal        4 ---------- Red
  221.      80 ---------- Magenta ---- Normal        5 ---------- Magenta
  222.      96 ---------- Brown ------ Normal        6 ---------- Brown
  223.     112 ---------- Light Grey - Normal        7 ---------- Light Grey
  224.     128 ---------- Black ------ Flashing      8 ---------- Dark Grey
  225.     144 ---------- Blue ------- Flashing      9 ---------- Light Blue
  226.     160 ---------- Green ------ Flashing     10 ---------- Light Green
  227.     176 ---------- Cyan ------- Flashing     11 ---------- Light Cyan
  228.     192 ---------- Red -------- Flashing     12 ---------- Light Red
  229.     208 ---------- Magenta ---- Flashing     13 ---------- Light Magenta
  230.     224 ---------- Brown ------ Flashing     14 ---------- Yellow
  231.     240 ---------- Light Grey - Flashing     15 ---------- White
  232.     
  233.           A color change will affect the entire line and will continue for
  234.     all following lines until it is changed.
  235.     
  236.     
  237.     Jumping To Topics Using Function Keys
  238.     
  239.           You can assign the 12 function keys to display certain areas of
  240.     text.  This allows you to create a menu on your opening screen making
  241.     it easy for the user to "jump" to a topic of interest.
  242.     
  243.           Assignment is made by using the ~ character followed by a
  244.     function key.  You have the option of displaying a heading specific
  245.     to the text.  The ~F1 should mark the beginning and ending of the
  246.     text.  The ~ character must be the first character on the line.
  247.     
  248.     For Example:      ~F1
  249.                             Your text would follow here...
  250.     
  251.     
  252.                       ~F1
  253.     
  254.           In this example any text between the two F1s would be displayed
  255.     when the F1 key was pressed.  If the user chooses to print it will
  256.     print only the text between the two F1s.
  257.     
  258.           To add a header simply follow the first ~F1 with a /Header.
  259.     
  260.     For Example:      ~F1/This is The Topic Title
  261.                             Your text would follow here...
  262.     
  263.     
  264.                       ~F1
  265.     
  266.           In this example the header "This is The Topic Title", would be
  267.     displayed on the top line of the screen.  Any text between the two
  268.     F1s would be displayed.
  269.     
  270.           You can use any of the 12 function keys for this purpose.
  271.     
  272.     
  273.     Executing a program from the README.EXE
  274.     
  275.           Function keys can also be used to execute external batch files
  276.     or programs.  The README.EXE can be used to "stuff" the keyboard
  277.     buffer with a command that will execute as the README is exited.
  278.     
  279.           To assign a command to a function key simply enter the ~
  280.     character followed by two forward slash characters and the command.
  281.     
  282.     For Example: ~F5//YOURPROG   (Yourprog being the program to execute.)
  283.     
  284.           In this example the F5 key would exit the README.EXE and
  285.     immediately start the YOURPROG program.  You can enter up to 16
  286.     characters including filenames, paths and command line parameters.
  287.      COMMAND LINE PARAMETERS
  288.     
  289.           The created README.EXE can be called using command line
  290.     parameters to cause it to display only a selected portion of text.
  291.     This can be used to create a kind of "context sensitive help" file.
  292.     By using batch files or other programs you can specify only the
  293.     portion of text related to your current operation to be displayed.
  294.     
  295.           This operation is accomplished by specifying the Start and
  296.     Finish lines to display.
  297.     
  298.     /S100 -     The /S specifies which line the README should display as
  299.                 the first line.
  300.     
  301.     /F200 -     The /F specifies which line will be the last line
  302.                 displayed.
  303.     
  304.           When using this feature the README will exit to DOS immediately
  305.     after the ESC key is pressed instead of returning to the top of the
  306.     file.
  307.     
  308.      SHAREWARE
  309.     
  310.           Shareware is software marketed on a "Try before you buy" basis.
  311.     
  312.           The price per disk that Shareware distributors charge is a
  313.     distribution fee and not the price of the software.  Shareware
  314.     authors have agreed to allow vendors to recover expenses for copying,
  315.     packaging, and maintaining a shareware library.  This allows you to
  316.     obtain software programs at incredibly low prices to try, then pay
  317.     the registration price for them only if they suit your needs. The
  318.     idea is that after a reasonable trial period, if you find the
  319.     programs to be of use, you are expected to send the author the
  320.     registration fee.
  321.     
  322.           Registration entitles you to various rights and benefits.  These
  323.     range from the legal (and moral) right to continue using the
  324.     software.  In addition many shareware authors offer printed
  325.     documentation and/or higher levels of service and support. Unlike
  326.     Public Domain software, which is free to everyone with no fees asked
  327.     for or expected, shareware programs exist because the authors expect
  328.     and deserve the registration support from people who use their
  329.     programs.
  330.     
  331.             So that's Shareware.  If you like it, support it!
  332.     
  333.     
  334.     REGISTRATION
  335.     
  336.           The shareware message will not be displayed on any registered
  337.     version of Read-A-Matic.  Registered users will receive the latest
  338.     version of Read-A-Matic and a license to create and distribute
  339.     README.EXE files that display your copyright notice.
  340.     
  341.     
  342.     DISCLAIMER
  343.     
  344.           Under no circumstances shall Michael L. Wester be liable for any
  345.     damages, including lost profits, savings, or any other incidental or
  346.     consequential damages arising out of the use of or inability to use
  347.     this program even if Michael L. Wester has been notified of the
  348.     possibility of such damages, or for any claims by any other party.
  349.     
  350.     
  351.     COPYRIGHT NOTICE
  352.     
  353.           Read-A-Matic is copyrighted 1994 by Michael L. Wester.  All rights
  354.     reserved.  The Read-A-Matic program may not be sold under any
  355.     circumstances.  The shareware version of Read-A-Matic may be
  356.     distributed for evaluation purposes only.  It cannot be distributed as
  357.     part of a promotional offer or bundled with hardware, software, or
  358.     printed material without the written permission of Michael L. Wester.
  359.     
  360.      REGISTRATION
  361.     
  362.           The shareware message will be removed on any registered version of
  363.     Read-A-Matic.  Registered users of Read-A-Matic will receive a version
  364.     of the program that creates READMEs that display their copyrights, a
  365.     license to create such READMEs and a printed copy of the manual. (Laser
  366.     printed booklet.)
  367.     
  368.           Registration entitles you to distribute as many copies of the
  369.     README.EXEs you wish.  You may not use Read-A-MAtic to create READMEs
  370.     for any other party either for sale or as a free "give-away".  The
  371.     license is for distribution by only the company it is licensed to.
  372.     There are no royalties for distribution.
  373.     
  374.                                DISCLAIMER
  375.     
  376.           Under no circumstances shall MIchael L. Wester be liable for
  377.     any damages, including lost profits, savings, or any other
  378.     incidental or consequential damages arising out of the use of or
  379.     inability to use this program even if MIchael L. Wester has
  380.     been notified of the possibility of such damages, or for any claims
  381.     by any other party.
  382.     
  383.      ORDER FORM  -  Read-A-Matic   Copyright 1994 Michael L. Wester
  384.     
  385.     Michael L. Wester                                         (919)-552-0767
  386.     Route #6 Box 34
  387.     Fuquay-Varina, NC 27526
  388.     
  389.     
  390.     Name_______________________________________________
  391.     Address____________________________________________
  392.     City/State__________________________ZIP____________
  393.     Phone #____________________________________________
  394.     
  395.     
  396.     ********************************************************************
  397.     Registration .................................................$15.00
  398.     ********************************************************************
  399.     Please sign and date your order form:
  400.     
  401.     Date:_________________ Signature:___________________________________
  402.     
  403.     
  404.     Single program license - single copy ........................ $15.00
  405.     
  406.     6% N.C. tax ............................................. $_________
  407.     Mailing and handling cost ..................................... Free
  408.     
  409.     TOTAL ................................................... $_________
  410.     
  411.     
  412.     [ ] Check enclosed  [ ] Money order enclosed  [ ] VISA/MC  [ ] C.O.D
  413.     Foreign user, please send Check or Money order in U.S. dollar only.
  414.     
  415.     Expire date: _______________                 Visa / MC
  416.     
  417.     Card number: _________________________________________
  418.     
  419.     
  420.     CALL 919-552-0767 for credit card and C.O.D phone orders or mail to
  421.     the address at the top of the order form.  You may also register by
  422.     credit card and recieve your registered copy of Read-A-Matic via
  423.     modem within 24 hours (Sometimes quicker).  Call the preceding number
  424.     to register.
  425.